From bb90521afa836ca2f71630cb75b423146201984e Mon Sep 17 00:00:00 2001 From: Yoshi Automation Date: Tue, 20 Oct 2026 07:23:58 +0000 Subject: [PATCH 01/34] feat(agentregistry): update the api #### agentregistry:v1 The following keys were added: - resources.projects.resources.locations.resources.skills.methods.getIamPolicy (Total Keys: 14) - resources.projects.resources.locations.resources.skills.methods.setIamPolicy (Total Keys: 12) - resources.projects.resources.locations.resources.skills.methods.testIamPermissions (Total Keys: 12) #### agentregistry:v1alpha The following keys were added: - schemas.SearchSkillsRequest (Total Keys: 8) --- .../agentregistry_v1.projects.locations.html | 5 + ...registry_v1.projects.locations.skills.html | 258 ++++++++++++++++++ .../documents/agentregistry.v1.json | 100 ++++++- .../documents/agentregistry.v1alpha.json | 40 ++- 4 files changed, 401 insertions(+), 2 deletions(-) create mode 100644 docs/dyn/agentregistry_v1.projects.locations.skills.html diff --git a/docs/dyn/agentregistry_v1.projects.locations.html b/docs/dyn/agentregistry_v1.projects.locations.html index 30764f03ff..6425b567a7 100644 --- a/docs/dyn/agentregistry_v1.projects.locations.html +++ b/docs/dyn/agentregistry_v1.projects.locations.html @@ -109,6 +109,11 @@

Instance Methods

Returns the services Resource.

+

+ skills() +

+

Returns the skills Resource.

+

close()

Close httplib2 connections.

diff --git a/docs/dyn/agentregistry_v1.projects.locations.skills.html b/docs/dyn/agentregistry_v1.projects.locations.skills.html new file mode 100644 index 0000000000..52931437c8 --- /dev/null +++ b/docs/dyn/agentregistry_v1.projects.locations.skills.html @@ -0,0 +1,258 @@ + + + +

Agent Registry API . projects . locations . skills

+

Instance Methods

+

+ close()

+

Close httplib2 connections.

+

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

+

Gets the access control policy for a resource. Returns an empty policy if the resource exists and does not have a policy set.

+

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

+

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

+

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

+

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

+

Method Details

+
+ close() + 
Close httplib2 connections.
+
+ +
+ getIamPolicy(resource, options_requestedPolicyVersion=None, x__xgafv=None) + 
Gets the access control policy for a resource. Returns an empty policy if the resource exists and does not have a policy set.
+
+Args:
+  resource: string, REQUIRED: The resource for which the policy is being requested. See [Resource names](https://cloud.google.com/apis/design/resource_names) for the appropriate value for this field. (required)
+  options_requestedPolicyVersion: integer, Optional. The maximum policy version that will be used to format the policy. Valid values are 0, 1, and 3. Requests specifying an invalid value will be rejected. Requests for policies with any conditional role bindings must specify version 3. Policies with no conditional role bindings may specify any valid value or leave the field unset. The policy in the response might use the policy version that you specified, or it might use a lower policy version. For example, if you specify version 3, but the policy has no conditional role bindings, the response uses version 1. To learn which resources support conditions in their IAM policies, see the [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-policies).
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # An Identity and Access Management (IAM) policy, which specifies access controls for Google Cloud resources. A `Policy` is a collection of `bindings`. A `binding` binds one or more `members`, or principals, to a single `role`. Principals can be user accounts, service accounts, Google groups, and domains (such as G Suite). A `role` is a named list of permissions; each `role` can be an IAM predefined role or a user-created custom role. For some types of Google Cloud resources, a `binding` can also specify a `condition`, which is a logical expression that allows access to a resource only if the expression evaluates to `true`. A condition can add constraints based on attributes of the request, the resource, or both. To learn which resources support conditions in their IAM policies, see the [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-policies). **JSON example:** ``` { "bindings": [ { "role": "roles/resourcemanager.organizationAdmin", "members": [ "user:mike@example.com", "group:admins@example.com", "domain:google.com", "serviceAccount:my-project-id@appspot.gserviceaccount.com" ] }, { "role": "roles/resourcemanager.organizationViewer", "members": [ "user:eve@example.com" ], "condition": { "title": "expirable access", "description": "Does not grant access after Sep 2020", "expression": "request.time < timestamp('2020-10-01T00:00:00.000Z')", } } ], "etag": "BwWWja0YfJA=", "version": 3 } ``` **YAML example:** ``` bindings: - members: - user:mike@example.com - group:admins@example.com - domain:google.com - serviceAccount:my-project-id@appspot.gserviceaccount.com role: roles/resourcemanager.organizationAdmin - members: - user:eve@example.com role: roles/resourcemanager.organizationViewer condition: title: expirable access description: Does not grant access after Sep 2020 expression: request.time < timestamp('2020-10-01T00:00:00.000Z') etag: BwWWja0YfJA= version: 3 ``` For a description of IAM and its features, see the [IAM documentation](https://cloud.google.com/iam/docs/).
+  "auditConfigs": [ # Specifies cloud audit logging configuration for this policy.
+    { # Specifies the audit configuration for a service. The configuration determines which permission types are logged, and what identities, if any, are exempted from logging. An AuditConfig must have one or more AuditLogConfigs. If there are AuditConfigs for both `allServices` and a specific service, the union of the two AuditConfigs is used for that service: the log_types specified in each AuditConfig are enabled, and the exempted_members in each AuditLogConfig are exempted. Example Policy with multiple AuditConfigs: { "audit_configs": [ { "service": "allServices", "audit_log_configs": [ { "log_type": "DATA_READ", "exempted_members": [ "user:jose@example.com" ] }, { "log_type": "DATA_WRITE" }, { "log_type": "ADMIN_READ" } ] }, { "service": "sampleservice.googleapis.com", "audit_log_configs": [ { "log_type": "DATA_READ" }, { "log_type": "DATA_WRITE", "exempted_members": [ "user:aliya@example.com" ] } ] } ] } For sampleservice, this policy enables DATA_READ, DATA_WRITE and ADMIN_READ logging. It also exempts `jose@example.com` from DATA_READ logging, and `aliya@example.com` from DATA_WRITE logging.
+      "auditLogConfigs": [ # The configuration for logging of each type of permission.
+        { # Provides the configuration for logging a type of permissions. Example: { "audit_log_configs": [ { "log_type": "DATA_READ", "exempted_members": [ "user:jose@example.com" ] }, { "log_type": "DATA_WRITE" } ] } This enables 'DATA_READ' and 'DATA_WRITE' logging, while exempting jose@example.com from DATA_READ logging.
+          "exemptedMembers": [ # Specifies the identities that do not cause logging for this type of permission. Follows the same format of Binding.members.
+            "A String",
+          ],
+          "logType": "A String", # The log type that this config enables.
+        },
+      ],
+      "service": "A String", # Specifies a service that will be enabled for audit logging. For example, `storage.googleapis.com`, `cloudsql.googleapis.com`. `allServices` is a special value that covers all services.
+    },
+  ],
+  "bindings": [ # Associates a list of `members`, or principals, with a `role`. Optionally, may specify a `condition` that determines how and when the `bindings` are applied. Each of the `bindings` must contain at least one principal. The `bindings` in a `Policy` can refer to up to 1,500 principals; up to 250 of these principals can be Google groups. Each occurrence of a principal counts towards these limits. For example, if the `bindings` grant 50 different roles to `user:alice@example.com`, and not to any other principal, then you can add another 1,450 principals to the `bindings` in the `Policy`.
+    { # Associates `members`, or principals, with a `role`.
+      "condition": { # Represents a textual expression in the Common Expression Language (CEL) syntax. CEL is a C-like expression language. The syntax and semantics of CEL are documented at https://github.com/google/cel-spec. Example (Comparison): title: "Summary size limit" description: "Determines if a summary is less than 100 chars" expression: "document.summary.size() < 100" Example (Equality): title: "Requestor is owner" description: "Determines if requestor is the document owner" expression: "document.owner == request.auth.claims.email" Example (Logic): title: "Public documents" description: "Determine whether the document should be publicly visible" expression: "document.type != 'private' && document.type != 'internal'" Example (Data Manipulation): title: "Notification string" description: "Create a notification string with a timestamp." expression: "'New message received at ' + string(document.create_time)" The exact variables and functions that may be referenced within an expression are determined by the service that evaluates it. See the service documentation for additional information. # The condition that is associated with this binding. If the condition evaluates to `true`, then this binding applies to the current request. If the condition evaluates to `false`, then this binding does not apply to the current request. However, a different role binding might grant the same role to one or more of the principals in this binding. To learn which resources support conditions in their IAM policies, see the [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-policies).
+        "description": "A String", # Optional. Description of the expression. This is a longer text which describes the expression, e.g. when hovered over it in a UI.
+        "expression": "A String", # Textual representation of an expression in Common Expression Language syntax.
+        "location": "A String", # Optional. String indicating the location of the expression for error reporting, e.g. a file name and a position in the file.
+        "title": "A String", # Optional. Title for the expression, i.e. a short string describing its purpose. This can be used e.g. in UIs which allow to enter the expression.
+      },
+      "members": [ # Specifies the principals requesting access for a Google Cloud resource. `members` can have the following values: * `allUsers`: A special identifier that represents anyone who is on the internet; with or without a Google account. * `allAuthenticatedUsers`: A special identifier that represents anyone who is authenticated with a Google account or a service account. Does not include identities that come from external identity providers (IdPs) through identity federation. * `user:{emailid}`: An email address that represents a specific Google account. For example, `alice@example.com` . * `serviceAccount:{emailid}`: An email address that represents a Google service account. For example, `my-other-app@appspot.gserviceaccount.com`. * `serviceAccount:{projectid}.svc.id.goog[{namespace}/{kubernetes-sa}]`: An identifier for a [Kubernetes service account](https://cloud.google.com/kubernetes-engine/docs/how-to/kubernetes-service-accounts). For example, `my-project.svc.id.goog[my-namespace/my-kubernetes-sa]`. * `group:{emailid}`: An email address that represents a Google group. For example, `admins@example.com`. * `domain:{domain}`: The G Suite domain (primary) that represents all the users of that domain. For example, `google.com` or `example.com`. * `principal://iam.googleapis.com/locations/global/workforcePools/{pool_id}/subject/{subject_attribute_value}`: A single identity in a workforce identity pool. * `principalSet://iam.googleapis.com/locations/global/workforcePools/{pool_id}/group/{group_id}`: All workforce identities in a group. * `principalSet://iam.googleapis.com/locations/global/workforcePools/{pool_id}/attribute.{attribute_name}/{attribute_value}`: All workforce identities with a specific attribute value. * `principalSet://iam.googleapis.com/locations/global/workforcePools/{pool_id}/*`: All identities in a workforce identity pool. * `principal://iam.googleapis.com/projects/{project_number}/locations/global/workloadIdentityPools/{pool_id}/subject/{subject_attribute_value}`: A single identity in a workload identity pool. * `principalSet://iam.googleapis.com/projects/{project_number}/locations/global/workloadIdentityPools/{pool_id}/group/{group_id}`: A workload identity pool group. * `principalSet://iam.googleapis.com/projects/{project_number}/locations/global/workloadIdentityPools/{pool_id}/attribute.{attribute_name}/{attribute_value}`: All identities in a workload identity pool with a certain attribute. * `principalSet://iam.googleapis.com/projects/{project_number}/locations/global/workloadIdentityPools/{pool_id}/*`: All identities in a workload identity pool. * `deleted:user:{emailid}?uid={uniqueid}`: An email address (plus unique identifier) representing a user that has been recently deleted. For example, `alice@example.com?uid=123456789012345678901`. If the user is recovered, this value reverts to `user:{emailid}` and the recovered user retains the role in the binding. * `deleted:serviceAccount:{emailid}?uid={uniqueid}`: An email address (plus unique identifier) representing a service account that has been recently deleted. For example, `my-other-app@appspot.gserviceaccount.com?uid=123456789012345678901`. If the service account is undeleted, this value reverts to `serviceAccount:{emailid}` and the undeleted service account retains the role in the binding. * `deleted:group:{emailid}?uid={uniqueid}`: An email address (plus unique identifier) representing a Google group that has been recently deleted. For example, `admins@example.com?uid=123456789012345678901`. If the group is recovered, this value reverts to `group:{emailid}` and the recovered group retains the role in the binding. * `deleted:principal://iam.googleapis.com/locations/global/workforcePools/{pool_id}/subject/{subject_attribute_value}`: Deleted single identity in a workforce identity pool. For example, `deleted:principal://iam.googleapis.com/locations/global/workforcePools/my-pool-id/subject/my-subject-attribute-value`.
+        "A String",
+      ],
+      "role": "A String", # Role that is assigned to the list of `members`, or principals. For example, `roles/viewer`, `roles/editor`, or `roles/owner`. For an overview of the IAM roles and permissions, see the [IAM documentation](https://cloud.google.com/iam/docs/roles-overview). For a list of the available pre-defined roles, see [here](https://cloud.google.com/iam/docs/understanding-roles).
+    },
+  ],
+  "etag": "A String", # `etag` is used for optimistic concurrency control as a way to help prevent simultaneous updates of a policy from overwriting each other. It is strongly suggested that systems make use of the `etag` in the read-modify-write cycle to perform policy updates in order to avoid race conditions: An `etag` is returned in the response to `getIamPolicy`, and systems are expected to put that etag in the request to `setIamPolicy` to ensure that their change will be applied to the same version of the policy. **Important:** If you use IAM Conditions, you must include the `etag` field whenever you call `setIamPolicy`. If you omit this field, then IAM allows you to overwrite a version `3` policy with a version `1` policy, and all of the conditions in the version `3` policy are lost.
+  "version": 42, # Specifies the format of the policy. Valid values are `0`, `1`, and `3`. Requests that specify an invalid value are rejected. Any operation that affects conditional role bindings must specify version `3`. This requirement applies to the following operations: * Getting a policy that includes a conditional role binding * Adding a conditional role binding to a policy * Changing a conditional role binding in a policy * Removing any role binding, with or without a condition, from a policy that includes conditions **Important:** If you use IAM Conditions, you must include the `etag` field whenever you call `setIamPolicy`. If you omit this field, then IAM allows you to overwrite a version `3` policy with a version `1` policy, and all of the conditions in the version `3` policy are lost. If a policy does not include any conditions, operations on that policy may specify any valid version or leave the field unset. To learn which resources support conditions in their IAM policies, see the [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-policies).
+}
+
+ +
+ setIamPolicy(resource, body=None, x__xgafv=None) + 
Sets the access control policy on the specified resource. Replaces any existing policy. Can return `NOT_FOUND`, `INVALID_ARGUMENT`, and `PERMISSION_DENIED` errors.
+
+Args:
+  resource: string, REQUIRED: The resource for which the policy is being specified. See [Resource names](https://cloud.google.com/apis/design/resource_names) for the appropriate value for this field. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # Request message for `SetIamPolicy` method.
+  "policy": { # An Identity and Access Management (IAM) policy, which specifies access controls for Google Cloud resources. A `Policy` is a collection of `bindings`. A `binding` binds one or more `members`, or principals, to a single `role`. Principals can be user accounts, service accounts, Google groups, and domains (such as G Suite). A `role` is a named list of permissions; each `role` can be an IAM predefined role or a user-created custom role. For some types of Google Cloud resources, a `binding` can also specify a `condition`, which is a logical expression that allows access to a resource only if the expression evaluates to `true`. A condition can add constraints based on attributes of the request, the resource, or both. To learn which resources support conditions in their IAM policies, see the [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-policies). **JSON example:** ``` { "bindings": [ { "role": "roles/resourcemanager.organizationAdmin", "members": [ "user:mike@example.com", "group:admins@example.com", "domain:google.com", "serviceAccount:my-project-id@appspot.gserviceaccount.com" ] }, { "role": "roles/resourcemanager.organizationViewer", "members": [ "user:eve@example.com" ], "condition": { "title": "expirable access", "description": "Does not grant access after Sep 2020", "expression": "request.time < timestamp('2020-10-01T00:00:00.000Z')", } } ], "etag": "BwWWja0YfJA=", "version": 3 } ``` **YAML example:** ``` bindings: - members: - user:mike@example.com - group:admins@example.com - domain:google.com - serviceAccount:my-project-id@appspot.gserviceaccount.com role: roles/resourcemanager.organizationAdmin - members: - user:eve@example.com role: roles/resourcemanager.organizationViewer condition: title: expirable access description: Does not grant access after Sep 2020 expression: request.time < timestamp('2020-10-01T00:00:00.000Z') etag: BwWWja0YfJA= version: 3 ``` For a description of IAM and its features, see the [IAM documentation](https://cloud.google.com/iam/docs/). # REQUIRED: The complete policy to be applied to the `resource`. The size of the policy is limited to a few 10s of KB. An empty policy is a valid policy but certain Google Cloud services (such as Projects) might reject them.
+    "auditConfigs": [ # Specifies cloud audit logging configuration for this policy.
+      { # Specifies the audit configuration for a service. The configuration determines which permission types are logged, and what identities, if any, are exempted from logging. An AuditConfig must have one or more AuditLogConfigs. If there are AuditConfigs for both `allServices` and a specific service, the union of the two AuditConfigs is used for that service: the log_types specified in each AuditConfig are enabled, and the exempted_members in each AuditLogConfig are exempted. Example Policy with multiple AuditConfigs: { "audit_configs": [ { "service": "allServices", "audit_log_configs": [ { "log_type": "DATA_READ", "exempted_members": [ "user:jose@example.com" ] }, { "log_type": "DATA_WRITE" }, { "log_type": "ADMIN_READ" } ] }, { "service": "sampleservice.googleapis.com", "audit_log_configs": [ { "log_type": "DATA_READ" }, { "log_type": "DATA_WRITE", "exempted_members": [ "user:aliya@example.com" ] } ] } ] } For sampleservice, this policy enables DATA_READ, DATA_WRITE and ADMIN_READ logging. It also exempts `jose@example.com` from DATA_READ logging, and `aliya@example.com` from DATA_WRITE logging.
+        "auditLogConfigs": [ # The configuration for logging of each type of permission.
+          { # Provides the configuration for logging a type of permissions. Example: { "audit_log_configs": [ { "log_type": "DATA_READ", "exempted_members": [ "user:jose@example.com" ] }, { "log_type": "DATA_WRITE" } ] } This enables 'DATA_READ' and 'DATA_WRITE' logging, while exempting jose@example.com from DATA_READ logging.
+            "exemptedMembers": [ # Specifies the identities that do not cause logging for this type of permission. Follows the same format of Binding.members.
+              "A String",
+            ],
+            "logType": "A String", # The log type that this config enables.
+          },
+        ],
+        "service": "A String", # Specifies a service that will be enabled for audit logging. For example, `storage.googleapis.com`, `cloudsql.googleapis.com`. `allServices` is a special value that covers all services.
+      },
+    ],
+    "bindings": [ # Associates a list of `members`, or principals, with a `role`. Optionally, may specify a `condition` that determines how and when the `bindings` are applied. Each of the `bindings` must contain at least one principal. The `bindings` in a `Policy` can refer to up to 1,500 principals; up to 250 of these principals can be Google groups. Each occurrence of a principal counts towards these limits. For example, if the `bindings` grant 50 different roles to `user:alice@example.com`, and not to any other principal, then you can add another 1,450 principals to the `bindings` in the `Policy`.
+      { # Associates `members`, or principals, with a `role`.
+        "condition": { # Represents a textual expression in the Common Expression Language (CEL) syntax. CEL is a C-like expression language. The syntax and semantics of CEL are documented at https://github.com/google/cel-spec. Example (Comparison): title: "Summary size limit" description: "Determines if a summary is less than 100 chars" expression: "document.summary.size() < 100" Example (Equality): title: "Requestor is owner" description: "Determines if requestor is the document owner" expression: "document.owner == request.auth.claims.email" Example (Logic): title: "Public documents" description: "Determine whether the document should be publicly visible" expression: "document.type != 'private' && document.type != 'internal'" Example (Data Manipulation): title: "Notification string" description: "Create a notification string with a timestamp." expression: "'New message received at ' + string(document.create_time)" The exact variables and functions that may be referenced within an expression are determined by the service that evaluates it. See the service documentation for additional information. # The condition that is associated with this binding. If the condition evaluates to `true`, then this binding applies to the current request. If the condition evaluates to `false`, then this binding does not apply to the current request. However, a different role binding might grant the same role to one or more of the principals in this binding. To learn which resources support conditions in their IAM policies, see the [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-policies).
+          "description": "A String", # Optional. Description of the expression. This is a longer text which describes the expression, e.g. when hovered over it in a UI.
+          "expression": "A String", # Textual representation of an expression in Common Expression Language syntax.
+          "location": "A String", # Optional. String indicating the location of the expression for error reporting, e.g. a file name and a position in the file.
+          "title": "A String", # Optional. Title for the expression, i.e. a short string describing its purpose. This can be used e.g. in UIs which allow to enter the expression.
+        },
+        "members": [ # Specifies the principals requesting access for a Google Cloud resource. `members` can have the following values: * `allUsers`: A special identifier that represents anyone who is on the internet; with or without a Google account. * `allAuthenticatedUsers`: A special identifier that represents anyone who is authenticated with a Google account or a service account. Does not include identities that come from external identity providers (IdPs) through identity federation. * `user:{emailid}`: An email address that represents a specific Google account. For example, `alice@example.com` . * `serviceAccount:{emailid}`: An email address that represents a Google service account. For example, `my-other-app@appspot.gserviceaccount.com`. * `serviceAccount:{projectid}.svc.id.goog[{namespace}/{kubernetes-sa}]`: An identifier for a [Kubernetes service account](https://cloud.google.com/kubernetes-engine/docs/how-to/kubernetes-service-accounts). For example, `my-project.svc.id.goog[my-namespace/my-kubernetes-sa]`. * `group:{emailid}`: An email address that represents a Google group. For example, `admins@example.com`. * `domain:{domain}`: The G Suite domain (primary) that represents all the users of that domain. For example, `google.com` or `example.com`. * `principal://iam.googleapis.com/locations/global/workforcePools/{pool_id}/subject/{subject_attribute_value}`: A single identity in a workforce identity pool. * `principalSet://iam.googleapis.com/locations/global/workforcePools/{pool_id}/group/{group_id}`: All workforce identities in a group. * `principalSet://iam.googleapis.com/locations/global/workforcePools/{pool_id}/attribute.{attribute_name}/{attribute_value}`: All workforce identities with a specific attribute value. * `principalSet://iam.googleapis.com/locations/global/workforcePools/{pool_id}/*`: All identities in a workforce identity pool. * `principal://iam.googleapis.com/projects/{project_number}/locations/global/workloadIdentityPools/{pool_id}/subject/{subject_attribute_value}`: A single identity in a workload identity pool. * `principalSet://iam.googleapis.com/projects/{project_number}/locations/global/workloadIdentityPools/{pool_id}/group/{group_id}`: A workload identity pool group. * `principalSet://iam.googleapis.com/projects/{project_number}/locations/global/workloadIdentityPools/{pool_id}/attribute.{attribute_name}/{attribute_value}`: All identities in a workload identity pool with a certain attribute. * `principalSet://iam.googleapis.com/projects/{project_number}/locations/global/workloadIdentityPools/{pool_id}/*`: All identities in a workload identity pool. * `deleted:user:{emailid}?uid={uniqueid}`: An email address (plus unique identifier) representing a user that has been recently deleted. For example, `alice@example.com?uid=123456789012345678901`. If the user is recovered, this value reverts to `user:{emailid}` and the recovered user retains the role in the binding. * `deleted:serviceAccount:{emailid}?uid={uniqueid}`: An email address (plus unique identifier) representing a service account that has been recently deleted. For example, `my-other-app@appspot.gserviceaccount.com?uid=123456789012345678901`. If the service account is undeleted, this value reverts to `serviceAccount:{emailid}` and the undeleted service account retains the role in the binding. * `deleted:group:{emailid}?uid={uniqueid}`: An email address (plus unique identifier) representing a Google group that has been recently deleted. For example, `admins@example.com?uid=123456789012345678901`. If the group is recovered, this value reverts to `group:{emailid}` and the recovered group retains the role in the binding. * `deleted:principal://iam.googleapis.com/locations/global/workforcePools/{pool_id}/subject/{subject_attribute_value}`: Deleted single identity in a workforce identity pool. For example, `deleted:principal://iam.googleapis.com/locations/global/workforcePools/my-pool-id/subject/my-subject-attribute-value`.
+          "A String",
+        ],
+        "role": "A String", # Role that is assigned to the list of `members`, or principals. For example, `roles/viewer`, `roles/editor`, or `roles/owner`. For an overview of the IAM roles and permissions, see the [IAM documentation](https://cloud.google.com/iam/docs/roles-overview). For a list of the available pre-defined roles, see [here](https://cloud.google.com/iam/docs/understanding-roles).
+      },
+    ],
+    "etag": "A String", # `etag` is used for optimistic concurrency control as a way to help prevent simultaneous updates of a policy from overwriting each other. It is strongly suggested that systems make use of the `etag` in the read-modify-write cycle to perform policy updates in order to avoid race conditions: An `etag` is returned in the response to `getIamPolicy`, and systems are expected to put that etag in the request to `setIamPolicy` to ensure that their change will be applied to the same version of the policy. **Important:** If you use IAM Conditions, you must include the `etag` field whenever you call `setIamPolicy`. If you omit this field, then IAM allows you to overwrite a version `3` policy with a version `1` policy, and all of the conditions in the version `3` policy are lost.
+    "version": 42, # Specifies the format of the policy. Valid values are `0`, `1`, and `3`. Requests that specify an invalid value are rejected. Any operation that affects conditional role bindings must specify version `3`. This requirement applies to the following operations: * Getting a policy that includes a conditional role binding * Adding a conditional role binding to a policy * Changing a conditional role binding in a policy * Removing any role binding, with or without a condition, from a policy that includes conditions **Important:** If you use IAM Conditions, you must include the `etag` field whenever you call `setIamPolicy`. If you omit this field, then IAM allows you to overwrite a version `3` policy with a version `1` policy, and all of the conditions in the version `3` policy are lost. If a policy does not include any conditions, operations on that policy may specify any valid version or leave the field unset. To learn which resources support conditions in their IAM policies, see the [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-policies).
+  },
+  "updateMask": "A String", # OPTIONAL: A FieldMask specifying which fields of the policy to modify. Only the fields in the mask will be modified. If no mask is provided, the following default mask is used: `paths: "bindings, etag"`
+}
+
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # An Identity and Access Management (IAM) policy, which specifies access controls for Google Cloud resources. A `Policy` is a collection of `bindings`. A `binding` binds one or more `members`, or principals, to a single `role`. Principals can be user accounts, service accounts, Google groups, and domains (such as G Suite). A `role` is a named list of permissions; each `role` can be an IAM predefined role or a user-created custom role. For some types of Google Cloud resources, a `binding` can also specify a `condition`, which is a logical expression that allows access to a resource only if the expression evaluates to `true`. A condition can add constraints based on attributes of the request, the resource, or both. To learn which resources support conditions in their IAM policies, see the [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-policies). **JSON example:** ``` { "bindings": [ { "role": "roles/resourcemanager.organizationAdmin", "members": [ "user:mike@example.com", "group:admins@example.com", "domain:google.com", "serviceAccount:my-project-id@appspot.gserviceaccount.com" ] }, { "role": "roles/resourcemanager.organizationViewer", "members": [ "user:eve@example.com" ], "condition": { "title": "expirable access", "description": "Does not grant access after Sep 2020", "expression": "request.time < timestamp('2020-10-01T00:00:00.000Z')", } } ], "etag": "BwWWja0YfJA=", "version": 3 } ``` **YAML example:** ``` bindings: - members: - user:mike@example.com - group:admins@example.com - domain:google.com - serviceAccount:my-project-id@appspot.gserviceaccount.com role: roles/resourcemanager.organizationAdmin - members: - user:eve@example.com role: roles/resourcemanager.organizationViewer condition: title: expirable access description: Does not grant access after Sep 2020 expression: request.time < timestamp('2020-10-01T00:00:00.000Z') etag: BwWWja0YfJA= version: 3 ``` For a description of IAM and its features, see the [IAM documentation](https://cloud.google.com/iam/docs/).
+  "auditConfigs": [ # Specifies cloud audit logging configuration for this policy.
+    { # Specifies the audit configuration for a service. The configuration determines which permission types are logged, and what identities, if any, are exempted from logging. An AuditConfig must have one or more AuditLogConfigs. If there are AuditConfigs for both `allServices` and a specific service, the union of the two AuditConfigs is used for that service: the log_types specified in each AuditConfig are enabled, and the exempted_members in each AuditLogConfig are exempted. Example Policy with multiple AuditConfigs: { "audit_configs": [ { "service": "allServices", "audit_log_configs": [ { "log_type": "DATA_READ", "exempted_members": [ "user:jose@example.com" ] }, { "log_type": "DATA_WRITE" }, { "log_type": "ADMIN_READ" } ] }, { "service": "sampleservice.googleapis.com", "audit_log_configs": [ { "log_type": "DATA_READ" }, { "log_type": "DATA_WRITE", "exempted_members": [ "user:aliya@example.com" ] } ] } ] } For sampleservice, this policy enables DATA_READ, DATA_WRITE and ADMIN_READ logging. It also exempts `jose@example.com` from DATA_READ logging, and `aliya@example.com` from DATA_WRITE logging.
+      "auditLogConfigs": [ # The configuration for logging of each type of permission.
+        { # Provides the configuration for logging a type of permissions. Example: { "audit_log_configs": [ { "log_type": "DATA_READ", "exempted_members": [ "user:jose@example.com" ] }, { "log_type": "DATA_WRITE" } ] } This enables 'DATA_READ' and 'DATA_WRITE' logging, while exempting jose@example.com from DATA_READ logging.
+          "exemptedMembers": [ # Specifies the identities that do not cause logging for this type of permission. Follows the same format of Binding.members.
+            "A String",
+          ],
+          "logType": "A String", # The log type that this config enables.
+        },
+      ],
+      "service": "A String", # Specifies a service that will be enabled for audit logging. For example, `storage.googleapis.com`, `cloudsql.googleapis.com`. `allServices` is a special value that covers all services.
+    },
+  ],
+  "bindings": [ # Associates a list of `members`, or principals, with a `role`. Optionally, may specify a `condition` that determines how and when the `bindings` are applied. Each of the `bindings` must contain at least one principal. The `bindings` in a `Policy` can refer to up to 1,500 principals; up to 250 of these principals can be Google groups. Each occurrence of a principal counts towards these limits. For example, if the `bindings` grant 50 different roles to `user:alice@example.com`, and not to any other principal, then you can add another 1,450 principals to the `bindings` in the `Policy`.
+    { # Associates `members`, or principals, with a `role`.
+      "condition": { # Represents a textual expression in the Common Expression Language (CEL) syntax. CEL is a C-like expression language. The syntax and semantics of CEL are documented at https://github.com/google/cel-spec. Example (Comparison): title: "Summary size limit" description: "Determines if a summary is less than 100 chars" expression: "document.summary.size() < 100" Example (Equality): title: "Requestor is owner" description: "Determines if requestor is the document owner" expression: "document.owner == request.auth.claims.email" Example (Logic): title: "Public documents" description: "Determine whether the document should be publicly visible" expression: "document.type != 'private' && document.type != 'internal'" Example (Data Manipulation): title: "Notification string" description: "Create a notification string with a timestamp." expression: "'New message received at ' + string(document.create_time)" The exact variables and functions that may be referenced within an expression are determined by the service that evaluates it. See the service documentation for additional information. # The condition that is associated with this binding. If the condition evaluates to `true`, then this binding applies to the current request. If the condition evaluates to `false`, then this binding does not apply to the current request. However, a different role binding might grant the same role to one or more of the principals in this binding. To learn which resources support conditions in their IAM policies, see the [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-policies).
+        "description": "A String", # Optional. Description of the expression. This is a longer text which describes the expression, e.g. when hovered over it in a UI.
+        "expression": "A String", # Textual representation of an expression in Common Expression Language syntax.
+        "location": "A String", # Optional. String indicating the location of the expression for error reporting, e.g. a file name and a position in the file.
+        "title": "A String", # Optional. Title for the expression, i.e. a short string describing its purpose. This can be used e.g. in UIs which allow to enter the expression.
+      },
+      "members": [ # Specifies the principals requesting access for a Google Cloud resource. `members` can have the following values: * `allUsers`: A special identifier that represents anyone who is on the internet; with or without a Google account. * `allAuthenticatedUsers`: A special identifier that represents anyone who is authenticated with a Google account or a service account. Does not include identities that come from external identity providers (IdPs) through identity federation. * `user:{emailid}`: An email address that represents a specific Google account. For example, `alice@example.com` . * `serviceAccount:{emailid}`: An email address that represents a Google service account. For example, `my-other-app@appspot.gserviceaccount.com`. * `serviceAccount:{projectid}.svc.id.goog[{namespace}/{kubernetes-sa}]`: An identifier for a [Kubernetes service account](https://cloud.google.com/kubernetes-engine/docs/how-to/kubernetes-service-accounts). For example, `my-project.svc.id.goog[my-namespace/my-kubernetes-sa]`. * `group:{emailid}`: An email address that represents a Google group. For example, `admins@example.com`. * `domain:{domain}`: The G Suite domain (primary) that represents all the users of that domain. For example, `google.com` or `example.com`. * `principal://iam.googleapis.com/locations/global/workforcePools/{pool_id}/subject/{subject_attribute_value}`: A single identity in a workforce identity pool. * `principalSet://iam.googleapis.com/locations/global/workforcePools/{pool_id}/group/{group_id}`: All workforce identities in a group. * `principalSet://iam.googleapis.com/locations/global/workforcePools/{pool_id}/attribute.{attribute_name}/{attribute_value}`: All workforce identities with a specific attribute value. * `principalSet://iam.googleapis.com/locations/global/workforcePools/{pool_id}/*`: All identities in a workforce identity pool. * `principal://iam.googleapis.com/projects/{project_number}/locations/global/workloadIdentityPools/{pool_id}/subject/{subject_attribute_value}`: A single identity in a workload identity pool. * `principalSet://iam.googleapis.com/projects/{project_number}/locations/global/workloadIdentityPools/{pool_id}/group/{group_id}`: A workload identity pool group. * `principalSet://iam.googleapis.com/projects/{project_number}/locations/global/workloadIdentityPools/{pool_id}/attribute.{attribute_name}/{attribute_value}`: All identities in a workload identity pool with a certain attribute. * `principalSet://iam.googleapis.com/projects/{project_number}/locations/global/workloadIdentityPools/{pool_id}/*`: All identities in a workload identity pool. * `deleted:user:{emailid}?uid={uniqueid}`: An email address (plus unique identifier) representing a user that has been recently deleted. For example, `alice@example.com?uid=123456789012345678901`. If the user is recovered, this value reverts to `user:{emailid}` and the recovered user retains the role in the binding. * `deleted:serviceAccount:{emailid}?uid={uniqueid}`: An email address (plus unique identifier) representing a service account that has been recently deleted. For example, `my-other-app@appspot.gserviceaccount.com?uid=123456789012345678901`. If the service account is undeleted, this value reverts to `serviceAccount:{emailid}` and the undeleted service account retains the role in the binding. * `deleted:group:{emailid}?uid={uniqueid}`: An email address (plus unique identifier) representing a Google group that has been recently deleted. For example, `admins@example.com?uid=123456789012345678901`. If the group is recovered, this value reverts to `group:{emailid}` and the recovered group retains the role in the binding. * `deleted:principal://iam.googleapis.com/locations/global/workforcePools/{pool_id}/subject/{subject_attribute_value}`: Deleted single identity in a workforce identity pool. For example, `deleted:principal://iam.googleapis.com/locations/global/workforcePools/my-pool-id/subject/my-subject-attribute-value`.
+        "A String",
+      ],
+      "role": "A String", # Role that is assigned to the list of `members`, or principals. For example, `roles/viewer`, `roles/editor`, or `roles/owner`. For an overview of the IAM roles and permissions, see the [IAM documentation](https://cloud.google.com/iam/docs/roles-overview). For a list of the available pre-defined roles, see [here](https://cloud.google.com/iam/docs/understanding-roles).
+    },
+  ],
+  "etag": "A String", # `etag` is used for optimistic concurrency control as a way to help prevent simultaneous updates of a policy from overwriting each other. It is strongly suggested that systems make use of the `etag` in the read-modify-write cycle to perform policy updates in order to avoid race conditions: An `etag` is returned in the response to `getIamPolicy`, and systems are expected to put that etag in the request to `setIamPolicy` to ensure that their change will be applied to the same version of the policy. **Important:** If you use IAM Conditions, you must include the `etag` field whenever you call `setIamPolicy`. If you omit this field, then IAM allows you to overwrite a version `3` policy with a version `1` policy, and all of the conditions in the version `3` policy are lost.
+  "version": 42, # Specifies the format of the policy. Valid values are `0`, `1`, and `3`. Requests that specify an invalid value are rejected. Any operation that affects conditional role bindings must specify version `3`. This requirement applies to the following operations: * Getting a policy that includes a conditional role binding * Adding a conditional role binding to a policy * Changing a conditional role binding in a policy * Removing any role binding, with or without a condition, from a policy that includes conditions **Important:** If you use IAM Conditions, you must include the `etag` field whenever you call `setIamPolicy`. If you omit this field, then IAM allows you to overwrite a version `3` policy with a version `1` policy, and all of the conditions in the version `3` policy are lost. If a policy does not include any conditions, operations on that policy may specify any valid version or leave the field unset. To learn which resources support conditions in their IAM policies, see the [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-policies).
+}
+
+ +
+ testIamPermissions(resource, body=None, x__xgafv=None) + 
Returns permissions that a caller has on the specified resource. If the resource does not exist, this will return an empty set of permissions, not a `NOT_FOUND` error. Note: This operation is designed to be used for building permission-aware UIs and command-line tools, not for authorization checking. This operation may "fail open" without warning.
+
+Args:
+  resource: string, REQUIRED: The resource for which the policy detail is being requested. See [Resource names](https://cloud.google.com/apis/design/resource_names) for the appropriate value for this field. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # Request message for `TestIamPermissions` method.
+  "permissions": [ # The set of permissions to check for the `resource`. Permissions with wildcards (such as `*` or `storage.*`) are not allowed. For more information see [IAM Overview](https://cloud.google.com/iam/docs/overview#permissions).
+    "A String",
+  ],
+}
+
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # Response message for `TestIamPermissions` method.
+  "permissions": [ # A subset of `TestPermissionsRequest.permissions` that the caller is allowed.
+    "A String",
+  ],
+}
+
+ + \ No newline at end of file diff --git a/googleapiclient/discovery_cache/documents/agentregistry.v1.json b/googleapiclient/discovery_cache/documents/agentregistry.v1.json index fdc7111ba6..682c97b7a5 100644 --- a/googleapiclient/discovery_cache/documents/agentregistry.v1.json +++ b/googleapiclient/discovery_cache/documents/agentregistry.v1.json @@ -1461,13 +1461,111 @@ ] } } +}, +"skills": { +"methods": { +"getIamPolicy": { +"description": "Gets the access control policy for a resource. Returns an empty policy if the resource exists and does not have a policy set.", +"flatPath": "v1/projects/{projectsId}/locations/{locationsId}/skills/{skillsId}:getIamPolicy", +"httpMethod": "GET", +"id": "agentregistry.projects.locations.skills.getIamPolicy", +"parameterOrder": [ +"resource" +], +"parameters": { +"options.requestedPolicyVersion": { +"description": "Optional. The maximum policy version that will be used to format the policy. Valid values are 0, 1, and 3. Requests specifying an invalid value will be rejected. Requests for policies with any conditional role bindings must specify version 3. Policies with no conditional role bindings may specify any valid value or leave the field unset. The policy in the response might use the policy version that you specified, or it might use a lower policy version. For example, if you specify version 3, but the policy has no conditional role bindings, the response uses version 1. To learn which resources support conditions in their IAM policies, see the [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-policies).", +"format": "int32", +"location": "query", +"type": "integer" +}, +"resource": { +"description": "REQUIRED: The resource for which the policy is being requested. See [Resource names](https://cloud.google.com/apis/design/resource_names) for the appropriate value for this field.", +"location": "path", +"pattern": "^projects/[^/]+/locations/[^/]+/skills/[^/]+$", +"required": true, +"type": "string" +} +}, +"path": "v1/{+resource}:getIamPolicy", +"response": { +"$ref": "GoogleIamV1Policy" +}, +"scopes": [ +"https://www.googleapis.com/auth/agentregistry.read-only", +"https://www.googleapis.com/auth/agentregistry.read-write", +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/cloud-platform.read-only" +] +}, +"setIamPolicy": { +"description": "Sets the access control policy on the specified resource. Replaces any existing policy. Can return `NOT_FOUND`, `INVALID_ARGUMENT`, and `PERMISSION_DENIED` errors.", +"flatPath": "v1/projects/{projectsId}/locations/{locationsId}/skills/{skillsId}:setIamPolicy", +"httpMethod": "POST", +"id": "agentregistry.projects.locations.skills.setIamPolicy", +"parameterOrder": [ +"resource" +], +"parameters": { +"resource": { +"description": "REQUIRED: The resource for which the policy is being specified. See [Resource names](https://cloud.google.com/apis/design/resource_names) for the appropriate value for this field.", +"location": "path", +"pattern": "^projects/[^/]+/locations/[^/]+/skills/[^/]+$", +"required": true, +"type": "string" +} +}, +"path": "v1/{+resource}:setIamPolicy", +"request": { +"$ref": "GoogleIamV1SetIamPolicyRequest" +}, +"response": { +"$ref": "GoogleIamV1Policy" +}, +"scopes": [ +"https://www.googleapis.com/auth/agentregistry.read-write", +"https://www.googleapis.com/auth/cloud-platform" +] +}, +"testIamPermissions": { +"description": "Returns permissions that a caller has on the specified resource. If the resource does not exist, this will return an empty set of permissions, not a `NOT_FOUND` error. Note: This operation is designed to be used for building permission-aware UIs and command-line tools, not for authorization checking. This operation may \"fail open\" without warning.", +"flatPath": "v1/projects/{projectsId}/locations/{locationsId}/skills/{skillsId}:testIamPermissions", +"httpMethod": "POST", +"id": "agentregistry.projects.locations.skills.testIamPermissions", +"parameterOrder": [ +"resource" +], +"parameters": { +"resource": { +"description": "REQUIRED: The resource for which the policy detail is being requested. See [Resource names](https://cloud.google.com/apis/design/resource_names) for the appropriate value for this field.", +"location": "path", +"pattern": "^projects/[^/]+/locations/[^/]+/skills/[^/]+$", +"required": true, +"type": "string" +} +}, +"path": "v1/{+resource}:testIamPermissions", +"request": { +"$ref": "GoogleIamV1TestIamPermissionsRequest" +}, +"response": { +"$ref": "GoogleIamV1TestIamPermissionsResponse" +}, +"scopes": [ +"https://www.googleapis.com/auth/agentregistry.read-only", +"https://www.googleapis.com/auth/agentregistry.read-write", +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/cloud-platform.read-only" +] +} +} } } } } } }, -"revision": "20261003", +"revision": "20261014", "rootUrl": "https://agentregistry.googleapis.com/", "schemas": { "A2ASkill": { diff --git a/googleapiclient/discovery_cache/documents/agentregistry.v1alpha.json b/googleapiclient/discovery_cache/documents/agentregistry.v1alpha.json index 3f536f471f..1dae8c4a73 100644 --- a/googleapiclient/discovery_cache/documents/agentregistry.v1alpha.json +++ b/googleapiclient/discovery_cache/documents/agentregistry.v1alpha.json @@ -2049,7 +2049,7 @@ } } }, -"revision": "20261003", +"revision": "20261014", "rootUrl": "https://agentregistry.googleapis.com/", "schemas": { "A2ASkill": { @@ -3558,6 +3558,44 @@ }, "type": "object" }, +"SearchSkillsRequest": { +"description": "Requesting a deep search of Skills.", +"id": "SearchSkillsRequest", +"properties": { +"filter": { +"description": "Optional. Use this field to specify additional filter criteria on search results. Filter expressions can be used to restrict results based upon filterable fields, where equality operators can be used. See [instructions](https://docs.cloud.google.com/agent-registry/search-agents-and-tools) for more details. Allowed operators: `=`, `<`, `>`, `NOT`, `AND`, `OR`, and `()`. | Field | `=` | `<`, `>` | |--------------|-----|----------| | state | Yes | No | | targetState | Yes | No | | createTime | Yes | Yes | | updateTime | Yes | Yes | Examples: * `state=ACTIVE` to restrict results to skills in the `ACTIVE` state.", +"type": "string" +}, +"pageSize": { +"description": "Optional. The maximum number of search results to return per page. The page size is capped at `100`, even if a larger value is specified. A negative value will result in an `INVALID_ARGUMENT` error. If unspecified or set to `0`, a default value of `20` will be used. The server may return fewer results than requested.", +"format": "int32", +"type": "integer" +}, +"pageToken": { +"description": "Optional. If present, retrieve the next batch of results from the preceding call to this method. `page_token` must be the value of `next_page_token` from the previous response. The values of all other method parameters, must be identical to those in the previous call.", +"type": "string" +}, +"searchString": { +"description": "Optional. Search criteria used to select the Skills to return. If no search criteria is specified then all accessible Skills will be returned. Search expressions can be used to restrict results based upon searchable fields, where the operators can be used along with the suffix wildcard symbol `*`. See [instructions](https://docs.cloud.google.com/agent-registry/search-agents-and-tools) for more details. Allowed operators: `=`, `:`, `NOT`, `AND`, `OR`, and `()`. Searchable fields: | Field | `=` | `:` | `*` | Keyword Search | |---------------------------|-----|-----|-----|----------------| | skillId | Yes | Yes | Yes | Included | | name | No | Yes | Yes | Included | | displayName | No | Yes | Yes | Included | | description | No | Yes | No | Included | | frontmatter.name | No | Yes | No | Included | | frontmatter.description | No | Yes | No | Included | | frontmatter.compatibility | No | Yes | No | Included | | frontmatter.license | No | Yes | No | Included | Examples: * `skillId=\"urn:skill:projects-1234:locations:global:private-important-skill\"` to find the skill with the specified skill ID. * `name:important` to find skills whose name contains `important` as a word. * `displayName:works*` to find skills whose display name contains words that start with `works`.", +"type": "string" +}, +"searchType": { +"description": "Optional. The type of search.", +"enum": [ +"SEARCH_TYPE_UNSPECIFIED", +"KEYWORD", +"SEMANTIC" +], +"enumDescriptions": [ +"Invalid search type.", +"Search for a keyword across all searchable fields.", +"Search based on the meaning and intent of a natural language query." +], +"type": "string" +} +}, +"type": "object" +}, "SearchSkillsResponse": { "description": "Response listing searched Skills.", "id": "SearchSkillsResponse", From b0b99458c2f5aa75cc3b8cde15187aa0de2d8bdb Mon Sep 17 00:00:00 2001 From: Yoshi Automation Date: Tue, 20 Oct 2026 07:23:59 +0000 Subject: [PATCH 02/34] feat(aiplatform): update the api #### aiplatform:v1 The following keys were added: - resources.interactions.methods.cancel (Total Keys: 11) - resources.interactions.methods.getPoll (Total Keys: 15) - resources.interactions.methods.getStream (Total Keys: 15) - resources.projects.resources.locations.resources.interactions.methods.create (Total Keys: 28) - resources.projects.resources.locations.resources.interactions.methods.delete (Total Keys: 12) - resources.projects.resources.locations.resources.interactionsHttp.methods.cancel (Total Keys: 11) - resources.projects.resources.locations.resources.interactionsHttp.methods.create (Total Keys: 12) - resources.projects.resources.locations.resources.interactionsHttp.methods.get (Total Keys: 15) - schemas.CloudAiLargeModelsVisionGenerateVideoExperimentsSuperResConfig.properties.tileSmoothing.type (Total Keys: 1) - schemas.GenaiVertexV1AgentInteraction (Total Keys: 7) - schemas.GenaiVertexV1AllowedTools (Total Keys: 5) - schemas.GenaiVertexV1AntigravityAgentConfig (Total Keys: 5) - schemas.GenaiVertexV1ArgumentsDelta (Total Keys: 3) - schemas.GenaiVertexV1AudioContent (Total Keys: 10) - schemas.GenaiVertexV1AudioDelta (Total Keys: 10) - schemas.GenaiVertexV1AudioResponseFormat (Total Keys: 8) - schemas.GenaiVertexV1CodeExecution (Total Keys: 24) - schemas.GenaiVertexV1CodeMenderAgentConfig (Total Keys: 26) - schemas.GenaiVertexV1ComputerUse (Total Keys: 8) - schemas.GenaiVertexV1Content (Total Keys: 11) - schemas.GenaiVertexV1CreateInteractionHttpRequest (Total Keys: 3) - schemas.GenaiVertexV1CreateInteractionRequest (Total Keys: 6) - schemas.GenaiVertexV1DeepResearchAgentConfig (Total Keys: 6) - schemas.GenaiVertexV1DeleteInteractionResponse (Total Keys: 2) - schemas.GenaiVertexV1DocumentContent (Total Keys: 6) - schemas.GenaiVertexV1DocumentDelta (Total Keys: 6) - schemas.GenaiVertexV1DynamicAgentConfig (Total Keys: 3) - schemas.GenaiVertexV1Error (Total Keys: 7) - schemas.GenaiVertexV1ExaAISearchConfig (Total Keys: 5) - schemas.GenaiVertexV1Field (Total Keys: 4) - schemas.GenaiVertexV1FileCitation (Total Keys: 8) - schemas.GenaiVertexV1FileSearch (Total Keys: 19) - schemas.GenaiVertexV1Function (Total Keys: 18) - schemas.GenaiVertexV1GenerationConfig (Total Keys: 21) - schemas.GenaiVertexV1GoogleMaps (Total Keys: 51) - schemas.GenaiVertexV1GoogleSearch (Total Keys: 35) - schemas.GenaiVertexV1ImageContent (Total Keys: 7) - schemas.GenaiVertexV1ImageDelta (Total Keys: 7) - schemas.GenaiVertexV1ImageResponseFormat (Total Keys: 6) - schemas.GenaiVertexV1Interaction (Total Keys: 92) - schemas.GenaiVertexV1ListValue (Total Keys: 4) - schemas.GenaiVertexV1McpServer (Total Keys: 7) - schemas.GenaiVertexV1ModelInteraction (Total Keys: 4) - schemas.GenaiVertexV1ModelOutputStep (Total Keys: 6) - schemas.GenaiVertexV1ParallelAISearchConfig (Total Keys: 5) - schemas.GenaiVertexV1PlaceCitation (Total Keys: 6) - schemas.GenaiVertexV1ProcessingCallDelta (Total Keys: 2) - schemas.GenaiVertexV1ProcessingCallStep (Total Keys: 2) - schemas.GenaiVertexV1ProcessingResultDelta (Total Keys: 2) - schemas.GenaiVertexV1ProcessingResultStep (Total Keys: 2) - schemas.GenaiVertexV1RagStoreConfig (Total Keys: 34) - schemas.GenaiVertexV1ResponseFormat (Total Keys: 11) - schemas.GenaiVertexV1Retrieval (Total Keys: 26) - schemas.GenaiVertexV1ReviewSnippet (Total Keys: 3) - schemas.GenaiVertexV1SafetySetting (Total Keys: 5) - schemas.GenaiVertexV1ServerToolCallDelta (Total Keys: 10) - schemas.GenaiVertexV1ServerToolResultDelta (Total Keys: 10) - schemas.GenaiVertexV1SpeakerConfig (Total Keys: 4) - schemas.GenaiVertexV1SpeechAnnotation (Total Keys: 4) - schemas.GenaiVertexV1SpeechConfig (Total Keys: 5) - schemas.GenaiVertexV1Step (Total Keys: 41) - schemas.GenaiVertexV1Struct (Total Keys: 4) - schemas.GenaiVertexV1TextAnnotationDelta (Total Keys: 4) - schemas.GenaiVertexV1TextContent (Total Keys: 15) - schemas.GenaiVertexV1TextDelta (Total Keys: 3) - schemas.GenaiVertexV1TextResponseFormat (Total Keys: 4) - schemas.GenaiVertexV1ThoughtSignatureDelta (Total Keys: 4) - schemas.GenaiVertexV1ThoughtStep (Total Keys: 6) - schemas.GenaiVertexV1ThoughtSummaryDelta (Total Keys: 3) - schemas.GenaiVertexV1Tool (Total Keys: 37) - schemas.GenaiVertexV1TranscriptionConfig (Total Keys: 14) - schemas.GenaiVertexV1UserInputStep (Total Keys: 4) - schemas.GenaiVertexV1Value (Total Keys: 10) - schemas.GenaiVertexV1VertexAISearchConfig (Total Keys: 5) - schemas.GenaiVertexV1VideoConfig (Total Keys: 3) - schemas.GenaiVertexV1VideoContent (Total Keys: 21) - schemas.GenaiVertexV1VideoDelta (Total Keys: 7) - schemas.GenaiVertexV1VideoResponseFormat (Total Keys: 8) - schemas.GenaiVertexV1WordInfo (Total Keys: 8) - schemas.GoogleCloudAiplatformV1Agent.properties.effectiveIdentity (Total Keys: 2) - schemas.GoogleCloudAiplatformV1Candidate.properties.continuationToken (Total Keys: 3) - schemas.GoogleCloudAiplatformV1EvaluationInstance.properties.agentEvalData.$ref (Total Keys: 1) - schemas.GoogleCloudAiplatformV1OnlineEvaluatorCloudObservabilitySessionScopePredicate.properties.serviceVersion.$ref (Total Keys: 1) - schemas.GoogleCloudAiplatformV1OnlineEvaluatorCloudObservabilityStringPredicate (Total Keys: 4) - schemas.GoogleCloudAiplatformV1OnlineEvaluatorCloudObservabilityTraceScopePredicate.properties.serviceVersion.$ref (Total Keys: 1) - schemas.GoogleCloudAiplatformV1SchemaPromptSpecContentMetadata (Total Keys: 4) - schemas.GoogleCloudAiplatformV1SchemaPromptSpecStructuredPrompt.properties.contentMetadata (Total Keys: 2) #### aiplatform:v1beta1 The following keys were deleted: - schemas.GenaiVertexV1beta1FileCitation.properties.customMetadata.$ref (Total Keys: 1) The following keys were added: - schemas.CloudAiLargeModelsVisionGenerateVideoExperimentsSuperResConfig.properties.tileSmoothing.type (Total Keys: 1) - schemas.GenaiVertexV1beta1EnvironmentConfigEgressRule.properties.mode.type (Total Keys: 1) - schemas.GenaiVertexV1beta1FileCitation.properties.customMetadata.additionalProperties.type (Total Keys: 1) - schemas.GenaiVertexV1beta1FileCitation.properties.customMetadata.type (Total Keys: 1) - schemas.GenaiVertexV1beta1Interaction.properties.continuationToken (Total Keys: 2) - schemas.GenaiVertexV1beta1InteractionStatusUpdate.properties.continuationToken (Total Keys: 2) - schemas.GenaiVertexV1beta1InteractionStatusUpdate.properties.usage.$ref (Total Keys: 1) - schemas.GoogleCloudAiplatformV1beta1Agent.properties.effectiveIdentity (Total Keys: 2) - schemas.GoogleCloudAiplatformV1beta1AgentAnomalyDetectionScope.properties.encryptionSpec.$ref (Total Keys: 1) - schemas.GoogleCloudAiplatformV1beta1Candidate.properties.continuationToken (Total Keys: 3) - schemas.GoogleCloudAiplatformV1beta1GenerateContentRequest.properties.continuationToken (Total Keys: 2) - schemas.GoogleCloudAiplatformV1beta1OnlineEvaluatorCloudObservabilitySessionScopePredicate.properties.serviceVersion.$ref (Total Keys: 1) - schemas.GoogleCloudAiplatformV1beta1OnlineEvaluatorCloudObservabilityStringPredicate (Total Keys: 4) - schemas.GoogleCloudAiplatformV1beta1OnlineEvaluatorCloudObservabilityTraceScopePredicate.properties.serviceVersion.$ref (Total Keys: 1) - schemas.GoogleCloudAiplatformV1beta1SchemaPromptSpecContentMetadata (Total Keys: 4) - schemas.GoogleCloudAiplatformV1beta1SchemaPromptSpecStructuredPrompt.properties.contentMetadata (Total Keys: 2) --- .../aiplatform_v1.batchPredictionJobs.html | 8 +- docs/dyn/aiplatform_v1.endpoints.html | 20 +- docs/dyn/aiplatform_v1.html | 5 + docs/dyn/aiplatform_v1.interactions.html | 9648 +++++++++++++ ...platform_v1.projects.locations.agents.html | 4 + ...rojects.locations.batchPredictionJobs.html | 8 +- ..._v1.projects.locations.cachedContents.html | 24 +- ...tform_v1.projects.locations.endpoints.html | 20 +- ...v1.projects.locations.evaluationItems.html | 64 +- .../dyn/aiplatform_v1.projects.locations.html | 647 +- ...rm_v1.projects.locations.interactions.html | 11777 ++++++++++++++++ ...1.projects.locations.interactionsHttp.html | 187 + ...orm_v1.projects.locations.memoryBanks.html | 2 +- ...ojects.locations.memoryBanks.memories.html | 2 +- ...platform_v1.projects.locations.models.html | 14 +- ...1.projects.locations.onlineEvaluators.html | 40 + ....projects.locations.publishers.models.html | 22 +- ...1.projects.locations.reasoningEngines.html | 8 +- ...s.locations.reasoningEngines.memories.html | 4 +- ...ions.reasoningEngines.sessions.events.html | 2 +- ...s.locations.reasoningEngines.sessions.html | 2 +- ....projects.locations.trainingPipelines.html | 8 +- ...form_v1.projects.locations.tuningJobs.html | 30 +- docs/dyn/aiplatform_v1.publishers.models.html | 24 +- docs/dyn/aiplatform_v1.reasoningEngines.html | 8 +- docs/dyn/aiplatform_v1.v1.html | 617 +- ...iplatform_v1beta1.batchPredictionJobs.html | 8 +- docs/dyn/aiplatform_v1beta1.endpoints.html | 22 +- docs/dyn/aiplatform_v1beta1.interactions.html | 439 +- docs/dyn/aiplatform_v1beta1.memoryBanks.html | 2 +- ...platform_v1beta1.memoryBanks.memories.html | 2 +- ...locations.agentAnomalyDetectionScopes.html | 9 + ...orm_v1beta1.projects.locations.agents.html | 4 + ...rojects.locations.batchPredictionJobs.html | 8 +- ...ta1.projects.locations.cachedContents.html | 24 +- ...m_v1beta1.projects.locations.datasets.html | 8 +- ..._v1beta1.projects.locations.endpoints.html | 22 +- ...a1.projects.locations.evaluationItems.html | 96 +- ...ta1.projects.locations.evaluationRuns.html | 56 +- ...eta1.projects.locations.exampleStores.html | 18 +- ...v1beta1.projects.locations.extensions.html | 4 +- ...aiplatform_v1beta1.projects.locations.html | 56 +- ...beta1.projects.locations.interactions.html | 527 +- ...1beta1.projects.locations.memoryBanks.html | 2 +- ...ojects.locations.memoryBanks.memories.html | 2 +- ...orm_v1beta1.projects.locations.models.html | 14 +- ...1.projects.locations.onlineEvaluators.html | 40 + ....projects.locations.publishers.models.html | 24 +- ...ions.reasoningEngines.a2aTasks.events.html | 6 +- ...s.locations.reasoningEngines.a2aTasks.html | 22 +- ...ions.reasoningEngines.feedbackEntries.html | 4 +- ...1.projects.locations.reasoningEngines.html | 8 +- ...s.locations.reasoningEngines.memories.html | 4 +- ...ions.reasoningEngines.sessions.events.html | 2 +- ...s.locations.reasoningEngines.sessions.html | 2 +- ....projects.locations.trainingPipelines.html | 8 +- ...v1beta1.projects.locations.tuningJobs.html | 100 +- .../aiplatform_v1beta1.publishers.models.html | 30 +- .../aiplatform_v1beta1.reasoningEngines.html | 8 +- ...orm_v1beta1.reasoningEngines.memories.html | 4 +- ...eta1.reasoningEngines.sessions.events.html | 2 +- ...orm_v1beta1.reasoningEngines.sessions.html | 2 +- docs/dyn/aiplatform_v1beta1.v1beta1.html | 28 +- .../documents/aiplatform.v1.json | 4147 +++++- .../documents/aiplatform.v1beta1.json | 118 +- 65 files changed, 28227 insertions(+), 850 deletions(-) create mode 100644 docs/dyn/aiplatform_v1.interactions.html create mode 100644 docs/dyn/aiplatform_v1.projects.locations.interactions.html create mode 100644 docs/dyn/aiplatform_v1.projects.locations.interactionsHttp.html diff --git a/docs/dyn/aiplatform_v1.batchPredictionJobs.html b/docs/dyn/aiplatform_v1.batchPredictionJobs.html index 9346e51cad..6e47e54ec7 100644 --- a/docs/dyn/aiplatform_v1.batchPredictionJobs.html +++ b/docs/dyn/aiplatform_v1.batchPredictionJobs.html @@ -337,7 +337,7 @@

Method Details

"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). + "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). At most 200 environment variables can be specified. Each variable (`NAME=value`) must be smaller than 128 KiB, and the total size of all variables must not exceed 512 KiB. { # 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. @@ -707,7 +707,7 @@

Method Details

"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). + "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). At most 200 environment variables can be specified. Each variable (`NAME=value`) must be smaller than 128 KiB, and the total size of all variables must not exceed 512 KiB. { # 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. @@ -1083,7 +1083,7 @@

Method Details

"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). + "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). At most 200 environment variables can be specified. Each variable (`NAME=value`) must be smaller than 128 KiB, and the total size of all variables must not exceed 512 KiB. { # 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. @@ -1465,7 +1465,7 @@

Method Details

"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). + "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). At most 200 environment variables can be specified. Each variable (`NAME=value`) must be smaller than 128 KiB, and the total size of all variables must not exceed 512 KiB. { # 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. diff --git a/docs/dyn/aiplatform_v1.endpoints.html b/docs/dyn/aiplatform_v1.endpoints.html index dd523e512c..81815d433f 100644 --- a/docs/dyn/aiplatform_v1.endpoints.html +++ b/docs/dyn/aiplatform_v1.endpoints.html @@ -127,7 +127,7 @@

Method Details

"contents": [ # Optional. Input content. { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -261,7 +261,7 @@

Method Details

"contents": [ # Optional. Input content. { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -526,7 +526,7 @@

Method Details

"model": "A String", # Optional. The name of the publisher model requested to serve the prediction. Format: `projects/{project}/locations/{location}/publishers/*/models/*` "systemInstruction": { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. # Optional. The user provided system instructions for the model. Note: only text should be used in parts and content in each part will be in a separate paragraph. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -930,7 +930,7 @@

Method Details

"contents": [ # Required. The content of the current conversation with the model. For single-turn queries, this is a single instance. For multi-turn queries, this is a repeated field that contains conversation history + latest request. { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -1205,7 +1205,7 @@

Method Details

], "systemInstruction": { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. # Optional. The user provided system instructions for the model. Note: only text should be used in parts and content in each part will be in a separate paragraph. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -1579,7 +1579,7 @@

Method Details

}, "content": { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. # Output only. The content of the candidate. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -1670,6 +1670,7 @@

Method Details

], "role": "A String", # Optional. The producer of the content. Must be either 'user' or 'model'. If not set, the service will default to 'user'. }, + "continuationToken": "A String", # Output only. An optional opaque continuation token returned when `finish_reason` is `CONTINUATION`. Clients can pass this token in a subsequent `GenerateContentRequest` to continue generation. "finishMessage": "A String", # Output only. Describes the reason the model stopped generating tokens in more detail. This field is returned only when `finish_reason` is set. "finishReason": "A String", # Output only. The reason why the model stopped generating tokens. If empty, the model has not stopped generating. "groundingMetadata": { # Information about the sources that support the content of a response. When grounding is enabled, the model returns citations for claims in the response. This object contains the retrieved sources. # Output only. Metadata returned when grounding is enabled. It contains the sources used to ground the generated content. @@ -1963,7 +1964,7 @@

Method Details

"contents": [ # Required. The content of the current conversation with the model. For single-turn queries, this is a single instance. For multi-turn queries, this is a repeated field that contains conversation history + latest request. { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -2238,7 +2239,7 @@

Method Details

], "systemInstruction": { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. # Optional. The user provided system instructions for the model. Note: only text should be used in parts and content in each part will be in a separate paragraph. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -2612,7 +2613,7 @@

Method Details

}, "content": { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. # Output only. The content of the candidate. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -2703,6 +2704,7 @@

Method Details

], "role": "A String", # Optional. The producer of the content. Must be either 'user' or 'model'. If not set, the service will default to 'user'. }, + "continuationToken": "A String", # Output only. An optional opaque continuation token returned when `finish_reason` is `CONTINUATION`. Clients can pass this token in a subsequent `GenerateContentRequest` to continue generation. "finishMessage": "A String", # Output only. Describes the reason the model stopped generating tokens in more detail. This field is returned only when `finish_reason` is set. "finishReason": "A String", # Output only. The reason why the model stopped generating tokens. If empty, the model has not stopped generating. "groundingMetadata": { # Information about the sources that support the content of a response. When grounding is enabled, the model returns citations for claims in the response. This object contains the retrieved sources. # Output only. Metadata returned when grounding is enabled. It contains the sources used to ground the generated content. diff --git a/docs/dyn/aiplatform_v1.html b/docs/dyn/aiplatform_v1.html index 0d30919da5..cd8f0b9240 100644 --- a/docs/dyn/aiplatform_v1.html +++ b/docs/dyn/aiplatform_v1.html @@ -134,6 +134,11 @@

Instance Methods

Returns the indexes Resource.

+

+ interactions() +

+

Returns the interactions Resource.

+

media()

diff --git a/docs/dyn/aiplatform_v1.interactions.html b/docs/dyn/aiplatform_v1.interactions.html new file mode 100644 index 0000000000..358ac2c67a --- /dev/null +++ b/docs/dyn/aiplatform_v1.interactions.html @@ -0,0 +1,9648 @@ + + + +

Agent Platform API . interactions

+

Instance Methods

+

+ cancel(name, x__xgafv=None)

+

Cancels an interaction.

+

+ close()

+

Close httplib2 connections.

+

+ getPoll(name, lastEventId=None, stream=None, x__xgafv=None)

+

Fully typed proto, unary version of GetInteraction that returns Interaction proto.

+

+ getStream(name, lastEventId=None, stream=None, x__xgafv=None)

+

Fully typed proto, streaming version of GetInteraction that returns Interaction proto.

+

Method Details

+
+ cancel(name, x__xgafv=None) + 
Cancels an interaction.
+
+Args:
+  name: string, Required. The name of the interaction to cancel. Format: `interactions/{interaction}`. (required)
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # Response for InteractionService.CreateInteraction.
+  "agentInteraction": { # Interaction for generating the completion using agents. # Interaction for generating the completion using agents.
+    "agent": "A String", # The name of the `Agent` used for generating the completion.
+    "antigravityConfig": { # Configuration for the Antigravity agent runtime. Provides server-side control over the agent's execution environment and tool configuration. # Antigravity agent configuration. This configuration is session-level settings that are passed to the agent runtime on a per-request basis.
+      "maxTotalTokens": "A String", # Max total tokens for the agent run.
+      "model": "A String", # The model to use for agent reasoning.
+    },
+    "codeMenderConfig": { # Configuration for the CodeMender agent.
+      "findRequest": { # Request parameters specific to FIND sessions, used for discovering vulnerabilities in a codebase. # Parameters for finding vulnerabilities.
+        "description": "A String", # Additional context or custom instructions provided by the user to guide the vulnerability analysis.
+        "findingId": "A String", # The identifier of a specific finding to verify. This is primarily used in VERIFY mode to focus the agent's execution-based validation on a single vulnerability.
+        "mode": "A String", # The mode of the find session.
+        "sourceFiles": [ # A list of source files to provide as context for the scan.
+          { # Content of a single file in the codebase.
+            "content": "A String", # The UTF-8 encoded text content of the file.
+            "path": "A String", # The relative path of the file from the project root.
+          },
+        ],
+      },
+      "fixRequest": { # Request parameters specific to FIX sessions, used for generating and validating security patches. # Parameters for fixing vulnerabilities.
+        "description": "A String", # Additional context or custom instructions provided by the user to guide the patch generation process.
+        "findingId": "A String", # The identifier of the specific security finding to be remediated. This ID maps to a previously discovered vulnerability.
+        "sourceFiles": [ # A list of source files providing context for the remediation. These files are typically the ones containing the identified vulnerability.
+          { # Content of a single file in the codebase.
+            "content": "A String", # The UTF-8 encoded text content of the file.
+            "path": "A String", # The relative path of the file from the project root.
+          },
+        ],
+      },
+      "model": "A String", # The name of the model to use for the CodeMender agent. One CodeMender session will only use one model.
+      "sessionConfig": { # The configuration of CodeMender sessions. # Optional session-specific configurations to override default agent behavior.
+        "maxRounds": 42, # The maximum number of interaction rounds the agent is allowed to perform before reaching a timeout.
+      },
+      "sessionId": "A String", # Parameter for grouping multiple interactions that belong to the same CodeMender session.
+    },
+    "deepResearchConfig": { # Configuration for the Deep Research agent.
+      "collaborativePlanning": True or False, # Enables human-in-the-loop planning for the Deep Research agent. If set to true, the Deep Research agent will provide a research plan in its response. The agent will then proceed only if the user confirms the plan in the next turn.
+      "enableBigqueryTool": True or False, # Enables bigquery tool for the Deep Research agent.
+      "thinkingSummaries": "A String", # Whether to include thought summaries in the response.
+      "visualization": "A String", # Whether to include visualizations in the response.
+    },
+    "dynamicConfig": { # Configuration for dynamic agents.
+      "config": { # `Struct` represents a structured data value, consisting of fields which map to dynamically typed values. # For agents that are not supported statically in the API definition.
+        "fields": [ # Dynamically typed fields. List instead of map because LLMs are sensitive to ordering, and we want to give users full control.
+          { # Represents a single field in a struct.
+            "name": "A String",
+            "value": { # `Value` represents a dynamically typed value which can be either null, a number, a string, a boolean, a recursive struct value, or a list of values. A producer of value is expected to set one of these variants. Absence of any variant indicates an error.
+              "boolValue": True or False, # Represents a boolean value.
+              "contentValue": { # The content of the response. # Represents rich content (text, image, etc.).
+                "audio": { # An audio content block.
+                  "channels": 42, # The number of audio channels.
+                  "data": "A String", # The audio content.
+                  "mimeTypeString": "A String", # Flexible MIME type string of the audio, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                  "sampleRate": 42, # The sample rate of the audio.
+                  "uri": "A String", # The URI of the audio.
+                },
+                "document": { # A document content block.
+                  "data": "A String", # The document content.
+                  "mimeTypeString": "A String", # Flexible MIME type string of the document, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                  "uri": "A String", # The URI of the document.
+                },
+                "image": { # An image content block.
+                  "data": "A String", # The image content.
+                  "mimeTypeString": "A String", # Flexible MIME type string of the image, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                  "resolution": "A String", # The resolution of the media.
+                  "uri": "A String", # The URI of the image.
+                },
+                "text": { # A text content block.
+                  "annotations": [ # Citation information for model-generated content.
+                    { # Citation information for model-generated content.
+                      "endIndex": 42, # End of the attributed segment, exclusive.
+                      "fileCitation": { # A file citation annotation. # A file citation annotation.
+                        "customMetadata": { # User provided metadata about the retrieved context.
+                          "a_key": "", # Properties of the object.
+                        },
+                        "documentUri": "A String", # The URI of the file.
+                        "fileName": "A String", # The name of the file.
+                        "mediaId": "A String", # Media ID in-case of image citations, if applicable.
+                        "pageNumber": 42, # Page number of the cited document, if applicable.
+                        "source": "A String", # Source attributed for a portion of the text.
+                      },
+                      "placeCitation": { # A place citation annotation. # A place citation annotation.
+                        "name": "A String", # Title of the place.
+                        "placeId": "A String", # The ID of the place, in `places/{place_id}` format.
+                        "reviewSnippets": [ # Snippets of reviews that are used to generate answers about the features of a given place in Google Maps.
+                          { # Encapsulates a snippet of a user review that answers a question about the features of a specific place in Google Maps.
+                            "reviewId": "A String", # The ID of the review snippet.
+                            "title": "A String", # Title of the review.
+                            "url": "A String", # A link that corresponds to the user review on Google Maps.
+                          },
+                        ],
+                        "url": "A String", # URI reference of the place.
+                      },
+                      "speechMetadata": { # Speech annotation for text content. # Speech annotation for text content.
+                        "speaker": "A String", # The speaker to associate with this turn.
+                        "style": "A String", # Style instruction for the speech synthesis.
+                      },
+                      "startIndex": 42, # Start of segment of the response that is attributed to this source. Index indicates the start of the segment, measured in bytes.
+                      "urlCitation": { # A URL citation annotation. # NOTE: We use these instead of the Citation message for historical reasons. A URL citation annotation.
+                        "title": "A String", # The title of the URL.
+                        "url": "A String", # The URL.
+                      },
+                      "wordInfo": { # Word-level ASR annotation for transcription output. Carries the word text, optional timing, and optional speaker attribution. # Word-level ASR annotation with timing and speaker info.
+                        "endOffset": "A String", # End offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                        "speaker": "A String", # Optional. Speaker label for this word (e.g. "spk_1", "spk_2"). Present when diarization_mode is set in TranscriptionConfig.
+                        "startOffset": "A String", # Start offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                        "text": "A String", # The transcribed word.
+                      },
+                    },
+                  ],
+                  "text": "A String", # Required. The text content.
+                },
+                "video": { # A video content block.
+                  "data": "A String", # The video content.
+                  "mimeTypeString": "A String", # Flexible MIME type string of the video, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                  "name": "A String", # A user-defined name for this content block. Can be referenced by the model in the final response.
+                  "processingConfig": {
+                    "static": {
+                      "endOffset": "A String", # Optional. Segment end time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "30s". Must be non-negative and greater than `start_offset` if `start_offset` is set.
+                      "fps": 3.14, # Optional. Video frame-rate sampling density.
+                      "startOffset": "A String", # Optional. Segment start time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "10.5s". Must be non-negative.
+                    },
+                  },
+                  "processingType": "A String",
+                  "resolution": "A String", # The resolution of the media.
+                  "uri": "A String", # The URI of the video.
+                },
+              },
+              "listValue": { # `ListValue` is a wrapper around a repeated field of values. # Represents a repeated `Value`.
+                "values": [ # Repeated field of dynamically typed values.
+                  # Object with schema name: GenaiVertexV1Value
+                ],
+              },
+              "nullValue": "A String", # Represents a null value.
+              "numberValue": 3.14, # Represents a double value.
+              "stringValue": "A String", # Represents a string value.
+              "structValue": # Object with schema name: GenaiVertexV1Struct # Represents a structured value.
+            },
+          },
+        ],
+      },
+    },
+  },
+  "content": { # The content of the response. # The content for the interaction.
+    "audio": { # An audio content block.
+      "channels": 42, # The number of audio channels.
+      "data": "A String", # The audio content.
+      "mimeTypeString": "A String", # Flexible MIME type string of the audio, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+      "sampleRate": 42, # The sample rate of the audio.
+      "uri": "A String", # The URI of the audio.
+    },
+    "document": { # A document content block.
+      "data": "A String", # The document content.
+      "mimeTypeString": "A String", # Flexible MIME type string of the document, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+      "uri": "A String", # The URI of the document.
+    },
+    "image": { # An image content block.
+      "data": "A String", # The image content.
+      "mimeTypeString": "A String", # Flexible MIME type string of the image, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+      "resolution": "A String", # The resolution of the media.
+      "uri": "A String", # The URI of the image.
+    },
+    "text": { # A text content block.
+      "annotations": [ # Citation information for model-generated content.
+        { # Citation information for model-generated content.
+          "endIndex": 42, # End of the attributed segment, exclusive.
+          "fileCitation": { # A file citation annotation. # A file citation annotation.
+            "customMetadata": { # User provided metadata about the retrieved context.
+              "a_key": "", # Properties of the object.
+            },
+            "documentUri": "A String", # The URI of the file.
+            "fileName": "A String", # The name of the file.
+            "mediaId": "A String", # Media ID in-case of image citations, if applicable.
+            "pageNumber": 42, # Page number of the cited document, if applicable.
+            "source": "A String", # Source attributed for a portion of the text.
+          },
+          "placeCitation": { # A place citation annotation. # A place citation annotation.
+            "name": "A String", # Title of the place.
+            "placeId": "A String", # The ID of the place, in `places/{place_id}` format.
+            "reviewSnippets": [ # Snippets of reviews that are used to generate answers about the features of a given place in Google Maps.
+              { # Encapsulates a snippet of a user review that answers a question about the features of a specific place in Google Maps.
+                "reviewId": "A String", # The ID of the review snippet.
+                "title": "A String", # Title of the review.
+                "url": "A String", # A link that corresponds to the user review on Google Maps.
+              },
+            ],
+            "url": "A String", # URI reference of the place.
+          },
+          "speechMetadata": { # Speech annotation for text content. # Speech annotation for text content.
+            "speaker": "A String", # The speaker to associate with this turn.
+            "style": "A String", # Style instruction for the speech synthesis.
+          },
+          "startIndex": 42, # Start of segment of the response that is attributed to this source. Index indicates the start of the segment, measured in bytes.
+          "urlCitation": { # A URL citation annotation. # NOTE: We use these instead of the Citation message for historical reasons. A URL citation annotation.
+            "title": "A String", # The title of the URL.
+            "url": "A String", # The URL.
+          },
+          "wordInfo": { # Word-level ASR annotation for transcription output. Carries the word text, optional timing, and optional speaker attribution. # Word-level ASR annotation with timing and speaker info.
+            "endOffset": "A String", # End offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+            "speaker": "A String", # Optional. Speaker label for this word (e.g. "spk_1", "spk_2"). Present when diarization_mode is set in TranscriptionConfig.
+            "startOffset": "A String", # Start offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+            "text": "A String", # The transcribed word.
+          },
+        },
+      ],
+      "text": "A String", # Required. The text content.
+    },
+    "video": { # A video content block.
+      "data": "A String", # The video content.
+      "mimeTypeString": "A String", # Flexible MIME type string of the video, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+      "name": "A String", # A user-defined name for this content block. Can be referenced by the model in the final response.
+      "processingConfig": {
+        "static": {
+          "endOffset": "A String", # Optional. Segment end time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "30s". Must be non-negative and greater than `start_offset` if `start_offset` is set.
+          "fps": 3.14, # Optional. Video frame-rate sampling density.
+          "startOffset": "A String", # Optional. Segment start time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "10.5s". Must be non-negative.
+        },
+      },
+      "processingType": "A String",
+      "resolution": "A String", # The resolution of the media.
+      "uri": "A String", # The URI of the video.
+    },
+  },
+  "created": "A String", # Required. Output only. The time at which the response was created in ISO 8601 format (YYYY-MM-DDThh:mm:ssZ).
+  "envId": "A String", # The environment ID for the interaction. Can be 'remote' for default environment.
+  "environmentId": "A String", # Output only. The environment ID for the interaction. Only populated if environment config is set in the request.
+  "errors": [ # Output only. Diagnostic faults / platform errors recorded on the interaction.
+    { # Error message from an interaction.
+      "code": "A String", # A URI that identifies the error type.
+      "message": "A String", # A human-readable error message.
+    },
+  ],
+  "id": "A String", # Required. Output only. A unique identifier for the interaction completion.
+  "labels": { # The labels with user-defined metadata for the request. 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",
+  },
+  "modelInteraction": { # Interaction for generating the completion using models. # Interaction for generating the completion using models.
+    "generationConfig": { # Configuration parameters for model interactions. # Input only. Configuration parameters for the model interaction.
+      "maxOutputTokens": 42, # The maximum number of tokens to include in the response.
+      "seed": 42, # Seed used in decoding for reproducibility.
+      "stopSequences": [ # A list of character sequences that will stop output interaction.
+        "A String",
+      ],
+      "structuredSpeechConfig": { # Configuration for multi-speaker and speech generation. # Speech and multi-speaker configuration.
+        "speakers": [ # Individual speaker configurations.
+          { # The configuration for speech interaction.
+            "language": "A String", # The language of the speech.
+            "speaker": "A String", # The speaker's name, it should match the speaker name given in the prompt.
+            "voice": "A String", # The voice of the speaker.
+          },
+        ],
+      },
+      "temperature": 3.14, # Controls the randomness of the output.
+      "thinkingLevel": "A String", # The level of thought tokens that the model should generate.
+      "thinkingSummaries": "A String", # Whether to include thought summaries in the response.
+      "toolChoiceConfig": { # The tool choice configuration containing allowed tools. # The config for the tool choice.
+        "allowedTools": { # The configuration for allowed tools. # The allowed tools.
+          "mode": "A String", # The mode of the tool choice.
+          "tools": [ # The names of the allowed tools.
+            "A String",
+          ],
+        },
+      },
+      "toolChoiceMode": "A String", # The mode of the tool choice.
+      "topP": 3.14, # The maximum cumulative probability of tokens to consider when sampling.
+      "transcriptionConfig": { # Configuration for speech recognition (transcription). # Optional. Configuration for speech recognition (transcription). If present, ASR is enabled.
+        "adaptationPhrases": [ # Optional. A list of phrases to bias the ASR model towards.
+          "A String",
+        ],
+        "customVocabulary": [ # Optional. A list of custom vocabulary phrases to bias the speech recognition model toward recognizing specific terms.
+          "A String",
+        ],
+        "diarizationMode": "A String", # Optional. Configures speaker diarization. Supported values: "speaker".
+        "languageCodes": [ # Optional. BCP-47 language codes providing hints about the languages present in the audio. If omitted or empty, defaults to automatic language detection.
+          "A String",
+        ],
+        "timestampGranularities": [ # Optional. The granularity of timestamps to include in the transcription output. Supported values: "word". If empty, no timestamps are generated.
+          "A String",
+        ],
+      },
+      "videoConfig": { # Configuration options for video generation. # Configuration for video generation.
+        "task": "A String", # Optional task mode for video generation. If not specified, the model automatically determines the appropriate mode based on the provided text prompt and input media.
+      },
+    },
+    "model": "A String", # The name of the `Model` used for generating the completion.
+  },
+  "previousInteractionId": "A String", # The ID of the previous interaction, if any.
+  "responseFormatList": {
+    "responseFormats": [
+      {
+        "audio": { # Configuration for audio output format.
+          "bitRate": 42, # Bit rate in bits per second (bps). Only applicable for compressed formats (MP3, Opus).
+          "delivery": "A String", # The delivery mode for the audio output.
+          "mimeType": "A String", # The MIME type of the audio output.
+          "sampleRate": 42, # Sample rate in Hz.
+        },
+        "image": { # Configuration for image output format.
+          "aspectRatio": "A String", # The aspect ratio for the image output.
+          "delivery": "A String", # The delivery mode for the image output.
+          "imageSize": "A String", # The size of the image output.
+          "mimeType": "A String", # The MIME type of the image output.
+        },
+        "structValue": { # `Struct` represents a structured data value, consisting of fields which map to dynamically typed values. # Multi-discriminator values is already enabled in GAOS
+          "fields": [ # Dynamically typed fields. List instead of map because LLMs are sensitive to ordering, and we want to give users full control.
+            { # Represents a single field in a struct.
+              "name": "A String",
+              "value": { # `Value` represents a dynamically typed value which can be either null, a number, a string, a boolean, a recursive struct value, or a list of values. A producer of value is expected to set one of these variants. Absence of any variant indicates an error.
+                "boolValue": True or False, # Represents a boolean value.
+                "contentValue": { # The content of the response. # Represents rich content (text, image, etc.).
+                  "audio": { # An audio content block.
+                    "channels": 42, # The number of audio channels.
+                    "data": "A String", # The audio content.
+                    "mimeTypeString": "A String", # Flexible MIME type string of the audio, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                    "sampleRate": 42, # The sample rate of the audio.
+                    "uri": "A String", # The URI of the audio.
+                  },
+                  "document": { # A document content block.
+                    "data": "A String", # The document content.
+                    "mimeTypeString": "A String", # Flexible MIME type string of the document, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                    "uri": "A String", # The URI of the document.
+                  },
+                  "image": { # An image content block.
+                    "data": "A String", # The image content.
+                    "mimeTypeString": "A String", # Flexible MIME type string of the image, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                    "resolution": "A String", # The resolution of the media.
+                    "uri": "A String", # The URI of the image.
+                  },
+                  "text": { # A text content block.
+                    "annotations": [ # Citation information for model-generated content.
+                      { # Citation information for model-generated content.
+                        "endIndex": 42, # End of the attributed segment, exclusive.
+                        "fileCitation": { # A file citation annotation. # A file citation annotation.
+                          "customMetadata": { # User provided metadata about the retrieved context.
+                            "a_key": "", # Properties of the object.
+                          },
+                          "documentUri": "A String", # The URI of the file.
+                          "fileName": "A String", # The name of the file.
+                          "mediaId": "A String", # Media ID in-case of image citations, if applicable.
+                          "pageNumber": 42, # Page number of the cited document, if applicable.
+                          "source": "A String", # Source attributed for a portion of the text.
+                        },
+                        "placeCitation": { # A place citation annotation. # A place citation annotation.
+                          "name": "A String", # Title of the place.
+                          "placeId": "A String", # The ID of the place, in `places/{place_id}` format.
+                          "reviewSnippets": [ # Snippets of reviews that are used to generate answers about the features of a given place in Google Maps.
+                            { # Encapsulates a snippet of a user review that answers a question about the features of a specific place in Google Maps.
+                              "reviewId": "A String", # The ID of the review snippet.
+                              "title": "A String", # Title of the review.
+                              "url": "A String", # A link that corresponds to the user review on Google Maps.
+                            },
+                          ],
+                          "url": "A String", # URI reference of the place.
+                        },
+                        "speechMetadata": { # Speech annotation for text content. # Speech annotation for text content.
+                          "speaker": "A String", # The speaker to associate with this turn.
+                          "style": "A String", # Style instruction for the speech synthesis.
+                        },
+                        "startIndex": 42, # Start of segment of the response that is attributed to this source. Index indicates the start of the segment, measured in bytes.
+                        "urlCitation": { # A URL citation annotation. # NOTE: We use these instead of the Citation message for historical reasons. A URL citation annotation.
+                          "title": "A String", # The title of the URL.
+                          "url": "A String", # The URL.
+                        },
+                        "wordInfo": { # Word-level ASR annotation for transcription output. Carries the word text, optional timing, and optional speaker attribution. # Word-level ASR annotation with timing and speaker info.
+                          "endOffset": "A String", # End offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                          "speaker": "A String", # Optional. Speaker label for this word (e.g. "spk_1", "spk_2"). Present when diarization_mode is set in TranscriptionConfig.
+                          "startOffset": "A String", # Start offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                          "text": "A String", # The transcribed word.
+                        },
+                      },
+                    ],
+                    "text": "A String", # Required. The text content.
+                  },
+                  "video": { # A video content block.
+                    "data": "A String", # The video content.
+                    "mimeTypeString": "A String", # Flexible MIME type string of the video, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                    "name": "A String", # A user-defined name for this content block. Can be referenced by the model in the final response.
+                    "processingConfig": {
+                      "static": {
+                        "endOffset": "A String", # Optional. Segment end time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "30s". Must be non-negative and greater than `start_offset` if `start_offset` is set.
+                        "fps": 3.14, # Optional. Video frame-rate sampling density.
+                        "startOffset": "A String", # Optional. Segment start time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "10.5s". Must be non-negative.
+                      },
+                    },
+                    "processingType": "A String",
+                    "resolution": "A String", # The resolution of the media.
+                    "uri": "A String", # The URI of the video.
+                  },
+                },
+                "listValue": { # `ListValue` is a wrapper around a repeated field of values. # Represents a repeated `Value`.
+                  "values": [ # Repeated field of dynamically typed values.
+                    # Object with schema name: GenaiVertexV1Value
+                  ],
+                },
+                "nullValue": "A String", # Represents a null value.
+                "numberValue": 3.14, # Represents a double value.
+                "stringValue": "A String", # Represents a string value.
+                "structValue": # Object with schema name: GenaiVertexV1Struct # Represents a structured value.
+              },
+            },
+          ],
+        },
+        "text": { # Configuration for text output format.
+          "mimeType": "A String", # The MIME type of the text output.
+          "schema": { # `Struct` represents a structured data value, consisting of fields which map to dynamically typed values. # The JSON schema that the output should conform to. Only applicable when mime_type is application/json.
+            "fields": [ # Dynamically typed fields. List instead of map because LLMs are sensitive to ordering, and we want to give users full control.
+              { # Represents a single field in a struct.
+                "name": "A String",
+                "value": { # `Value` represents a dynamically typed value which can be either null, a number, a string, a boolean, a recursive struct value, or a list of values. A producer of value is expected to set one of these variants. Absence of any variant indicates an error.
+                  "boolValue": True or False, # Represents a boolean value.
+                  "contentValue": { # The content of the response. # Represents rich content (text, image, etc.).
+                    "audio": { # An audio content block.
+                      "channels": 42, # The number of audio channels.
+                      "data": "A String", # The audio content.
+                      "mimeTypeString": "A String", # Flexible MIME type string of the audio, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                      "sampleRate": 42, # The sample rate of the audio.
+                      "uri": "A String", # The URI of the audio.
+                    },
+                    "document": { # A document content block.
+                      "data": "A String", # The document content.
+                      "mimeTypeString": "A String", # Flexible MIME type string of the document, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                      "uri": "A String", # The URI of the document.
+                    },
+                    "image": { # An image content block.
+                      "data": "A String", # The image content.
+                      "mimeTypeString": "A String", # Flexible MIME type string of the image, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                      "resolution": "A String", # The resolution of the media.
+                      "uri": "A String", # The URI of the image.
+                    },
+                    "text": { # A text content block.
+                      "annotations": [ # Citation information for model-generated content.
+                        { # Citation information for model-generated content.
+                          "endIndex": 42, # End of the attributed segment, exclusive.
+                          "fileCitation": { # A file citation annotation. # A file citation annotation.
+                            "customMetadata": { # User provided metadata about the retrieved context.
+                              "a_key": "", # Properties of the object.
+                            },
+                            "documentUri": "A String", # The URI of the file.
+                            "fileName": "A String", # The name of the file.
+                            "mediaId": "A String", # Media ID in-case of image citations, if applicable.
+                            "pageNumber": 42, # Page number of the cited document, if applicable.
+                            "source": "A String", # Source attributed for a portion of the text.
+                          },
+                          "placeCitation": { # A place citation annotation. # A place citation annotation.
+                            "name": "A String", # Title of the place.
+                            "placeId": "A String", # The ID of the place, in `places/{place_id}` format.
+                            "reviewSnippets": [ # Snippets of reviews that are used to generate answers about the features of a given place in Google Maps.
+                              { # Encapsulates a snippet of a user review that answers a question about the features of a specific place in Google Maps.
+                                "reviewId": "A String", # The ID of the review snippet.
+                                "title": "A String", # Title of the review.
+                                "url": "A String", # A link that corresponds to the user review on Google Maps.
+                              },
+                            ],
+                            "url": "A String", # URI reference of the place.
+                          },
+                          "speechMetadata": { # Speech annotation for text content. # Speech annotation for text content.
+                            "speaker": "A String", # The speaker to associate with this turn.
+                            "style": "A String", # Style instruction for the speech synthesis.
+                          },
+                          "startIndex": 42, # Start of segment of the response that is attributed to this source. Index indicates the start of the segment, measured in bytes.
+                          "urlCitation": { # A URL citation annotation. # NOTE: We use these instead of the Citation message for historical reasons. A URL citation annotation.
+                            "title": "A String", # The title of the URL.
+                            "url": "A String", # The URL.
+                          },
+                          "wordInfo": { # Word-level ASR annotation for transcription output. Carries the word text, optional timing, and optional speaker attribution. # Word-level ASR annotation with timing and speaker info.
+                            "endOffset": "A String", # End offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                            "speaker": "A String", # Optional. Speaker label for this word (e.g. "spk_1", "spk_2"). Present when diarization_mode is set in TranscriptionConfig.
+                            "startOffset": "A String", # Start offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                            "text": "A String", # The transcribed word.
+                          },
+                        },
+                      ],
+                      "text": "A String", # Required. The text content.
+                    },
+                    "video": { # A video content block.
+                      "data": "A String", # The video content.
+                      "mimeTypeString": "A String", # Flexible MIME type string of the video, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                      "name": "A String", # A user-defined name for this content block. Can be referenced by the model in the final response.
+                      "processingConfig": {
+                        "static": {
+                          "endOffset": "A String", # Optional. Segment end time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "30s". Must be non-negative and greater than `start_offset` if `start_offset` is set.
+                          "fps": 3.14, # Optional. Video frame-rate sampling density.
+                          "startOffset": "A String", # Optional. Segment start time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "10.5s". Must be non-negative.
+                        },
+                      },
+                      "processingType": "A String",
+                      "resolution": "A String", # The resolution of the media.
+                      "uri": "A String", # The URI of the video.
+                    },
+                  },
+                  "listValue": { # `ListValue` is a wrapper around a repeated field of values. # Represents a repeated `Value`.
+                    "values": [ # Repeated field of dynamically typed values.
+                      # Object with schema name: GenaiVertexV1Value
+                    ],
+                  },
+                  "nullValue": "A String", # Represents a null value.
+                  "numberValue": 3.14, # Represents a double value.
+                  "stringValue": "A String", # Represents a string value.
+                  "structValue": # Object with schema name: GenaiVertexV1Struct # Represents a structured value.
+                },
+              },
+            ],
+          },
+        },
+        "video": { # Configuration for video output format.
+          "aspectRatio": "A String", # The aspect ratio for the video output.
+          "delivery": "A String", # The delivery mode for the video output.
+          "duration": "A String", # The duration for the video output.
+          "gcsUri": "A String", # The Cloud Storage URI to store the video output. Required for Vertex if delivery mode is URI.
+          "resolution": "A String", # The video output resolution. Defaults to 720p.
+        },
+      },
+    ],
+  },
+  "responseFormatSingleton": {
+    "audio": { # Configuration for audio output format.
+      "bitRate": 42, # Bit rate in bits per second (bps). Only applicable for compressed formats (MP3, Opus).
+      "delivery": "A String", # The delivery mode for the audio output.
+      "mimeType": "A String", # The MIME type of the audio output.
+      "sampleRate": 42, # Sample rate in Hz.
+    },
+    "image": { # Configuration for image output format.
+      "aspectRatio": "A String", # The aspect ratio for the image output.
+      "delivery": "A String", # The delivery mode for the image output.
+      "imageSize": "A String", # The size of the image output.
+      "mimeType": "A String", # The MIME type of the image output.
+    },
+    "structValue": { # `Struct` represents a structured data value, consisting of fields which map to dynamically typed values. # Multi-discriminator values is already enabled in GAOS
+      "fields": [ # Dynamically typed fields. List instead of map because LLMs are sensitive to ordering, and we want to give users full control.
+        { # Represents a single field in a struct.
+          "name": "A String",
+          "value": { # `Value` represents a dynamically typed value which can be either null, a number, a string, a boolean, a recursive struct value, or a list of values. A producer of value is expected to set one of these variants. Absence of any variant indicates an error.
+            "boolValue": True or False, # Represents a boolean value.
+            "contentValue": { # The content of the response. # Represents rich content (text, image, etc.).
+              "audio": { # An audio content block.
+                "channels": 42, # The number of audio channels.
+                "data": "A String", # The audio content.
+                "mimeTypeString": "A String", # Flexible MIME type string of the audio, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                "sampleRate": 42, # The sample rate of the audio.
+                "uri": "A String", # The URI of the audio.
+              },
+              "document": { # A document content block.
+                "data": "A String", # The document content.
+                "mimeTypeString": "A String", # Flexible MIME type string of the document, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                "uri": "A String", # The URI of the document.
+              },
+              "image": { # An image content block.
+                "data": "A String", # The image content.
+                "mimeTypeString": "A String", # Flexible MIME type string of the image, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                "resolution": "A String", # The resolution of the media.
+                "uri": "A String", # The URI of the image.
+              },
+              "text": { # A text content block.
+                "annotations": [ # Citation information for model-generated content.
+                  { # Citation information for model-generated content.
+                    "endIndex": 42, # End of the attributed segment, exclusive.
+                    "fileCitation": { # A file citation annotation. # A file citation annotation.
+                      "customMetadata": { # User provided metadata about the retrieved context.
+                        "a_key": "", # Properties of the object.
+                      },
+                      "documentUri": "A String", # The URI of the file.
+                      "fileName": "A String", # The name of the file.
+                      "mediaId": "A String", # Media ID in-case of image citations, if applicable.
+                      "pageNumber": 42, # Page number of the cited document, if applicable.
+                      "source": "A String", # Source attributed for a portion of the text.
+                    },
+                    "placeCitation": { # A place citation annotation. # A place citation annotation.
+                      "name": "A String", # Title of the place.
+                      "placeId": "A String", # The ID of the place, in `places/{place_id}` format.
+                      "reviewSnippets": [ # Snippets of reviews that are used to generate answers about the features of a given place in Google Maps.
+                        { # Encapsulates a snippet of a user review that answers a question about the features of a specific place in Google Maps.
+                          "reviewId": "A String", # The ID of the review snippet.
+                          "title": "A String", # Title of the review.
+                          "url": "A String", # A link that corresponds to the user review on Google Maps.
+                        },
+                      ],
+                      "url": "A String", # URI reference of the place.
+                    },
+                    "speechMetadata": { # Speech annotation for text content. # Speech annotation for text content.
+                      "speaker": "A String", # The speaker to associate with this turn.
+                      "style": "A String", # Style instruction for the speech synthesis.
+                    },
+                    "startIndex": 42, # Start of segment of the response that is attributed to this source. Index indicates the start of the segment, measured in bytes.
+                    "urlCitation": { # A URL citation annotation. # NOTE: We use these instead of the Citation message for historical reasons. A URL citation annotation.
+                      "title": "A String", # The title of the URL.
+                      "url": "A String", # The URL.
+                    },
+                    "wordInfo": { # Word-level ASR annotation for transcription output. Carries the word text, optional timing, and optional speaker attribution. # Word-level ASR annotation with timing and speaker info.
+                      "endOffset": "A String", # End offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                      "speaker": "A String", # Optional. Speaker label for this word (e.g. "spk_1", "spk_2"). Present when diarization_mode is set in TranscriptionConfig.
+                      "startOffset": "A String", # Start offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                      "text": "A String", # The transcribed word.
+                    },
+                  },
+                ],
+                "text": "A String", # Required. The text content.
+              },
+              "video": { # A video content block.
+                "data": "A String", # The video content.
+                "mimeTypeString": "A String", # Flexible MIME type string of the video, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                "name": "A String", # A user-defined name for this content block. Can be referenced by the model in the final response.
+                "processingConfig": {
+                  "static": {
+                    "endOffset": "A String", # Optional. Segment end time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "30s". Must be non-negative and greater than `start_offset` if `start_offset` is set.
+                    "fps": 3.14, # Optional. Video frame-rate sampling density.
+                    "startOffset": "A String", # Optional. Segment start time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "10.5s". Must be non-negative.
+                  },
+                },
+                "processingType": "A String",
+                "resolution": "A String", # The resolution of the media.
+                "uri": "A String", # The URI of the video.
+              },
+            },
+            "listValue": { # `ListValue` is a wrapper around a repeated field of values. # Represents a repeated `Value`.
+              "values": [ # Repeated field of dynamically typed values.
+                # Object with schema name: GenaiVertexV1Value
+              ],
+            },
+            "nullValue": "A String", # Represents a null value.
+            "numberValue": 3.14, # Represents a double value.
+            "stringValue": "A String", # Represents a string value.
+            "structValue": # Object with schema name: GenaiVertexV1Struct # Represents a structured value.
+          },
+        },
+      ],
+    },
+    "text": { # Configuration for text output format.
+      "mimeType": "A String", # The MIME type of the text output.
+      "schema": { # `Struct` represents a structured data value, consisting of fields which map to dynamically typed values. # The JSON schema that the output should conform to. Only applicable when mime_type is application/json.
+        "fields": [ # Dynamically typed fields. List instead of map because LLMs are sensitive to ordering, and we want to give users full control.
+          { # Represents a single field in a struct.
+            "name": "A String",
+            "value": { # `Value` represents a dynamically typed value which can be either null, a number, a string, a boolean, a recursive struct value, or a list of values. A producer of value is expected to set one of these variants. Absence of any variant indicates an error.
+              "boolValue": True or False, # Represents a boolean value.
+              "contentValue": { # The content of the response. # Represents rich content (text, image, etc.).
+                "audio": { # An audio content block.
+                  "channels": 42, # The number of audio channels.
+                  "data": "A String", # The audio content.
+                  "mimeTypeString": "A String", # Flexible MIME type string of the audio, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                  "sampleRate": 42, # The sample rate of the audio.
+                  "uri": "A String", # The URI of the audio.
+                },
+                "document": { # A document content block.
+                  "data": "A String", # The document content.
+                  "mimeTypeString": "A String", # Flexible MIME type string of the document, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                  "uri": "A String", # The URI of the document.
+                },
+                "image": { # An image content block.
+                  "data": "A String", # The image content.
+                  "mimeTypeString": "A String", # Flexible MIME type string of the image, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                  "resolution": "A String", # The resolution of the media.
+                  "uri": "A String", # The URI of the image.
+                },
+                "text": { # A text content block.
+                  "annotations": [ # Citation information for model-generated content.
+                    { # Citation information for model-generated content.
+                      "endIndex": 42, # End of the attributed segment, exclusive.
+                      "fileCitation": { # A file citation annotation. # A file citation annotation.
+                        "customMetadata": { # User provided metadata about the retrieved context.
+                          "a_key": "", # Properties of the object.
+                        },
+                        "documentUri": "A String", # The URI of the file.
+                        "fileName": "A String", # The name of the file.
+                        "mediaId": "A String", # Media ID in-case of image citations, if applicable.
+                        "pageNumber": 42, # Page number of the cited document, if applicable.
+                        "source": "A String", # Source attributed for a portion of the text.
+                      },
+                      "placeCitation": { # A place citation annotation. # A place citation annotation.
+                        "name": "A String", # Title of the place.
+                        "placeId": "A String", # The ID of the place, in `places/{place_id}` format.
+                        "reviewSnippets": [ # Snippets of reviews that are used to generate answers about the features of a given place in Google Maps.
+                          { # Encapsulates a snippet of a user review that answers a question about the features of a specific place in Google Maps.
+                            "reviewId": "A String", # The ID of the review snippet.
+                            "title": "A String", # Title of the review.
+                            "url": "A String", # A link that corresponds to the user review on Google Maps.
+                          },
+                        ],
+                        "url": "A String", # URI reference of the place.
+                      },
+                      "speechMetadata": { # Speech annotation for text content. # Speech annotation for text content.
+                        "speaker": "A String", # The speaker to associate with this turn.
+                        "style": "A String", # Style instruction for the speech synthesis.
+                      },
+                      "startIndex": 42, # Start of segment of the response that is attributed to this source. Index indicates the start of the segment, measured in bytes.
+                      "urlCitation": { # A URL citation annotation. # NOTE: We use these instead of the Citation message for historical reasons. A URL citation annotation.
+                        "title": "A String", # The title of the URL.
+                        "url": "A String", # The URL.
+                      },
+                      "wordInfo": { # Word-level ASR annotation for transcription output. Carries the word text, optional timing, and optional speaker attribution. # Word-level ASR annotation with timing and speaker info.
+                        "endOffset": "A String", # End offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                        "speaker": "A String", # Optional. Speaker label for this word (e.g. "spk_1", "spk_2"). Present when diarization_mode is set in TranscriptionConfig.
+                        "startOffset": "A String", # Start offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                        "text": "A String", # The transcribed word.
+                      },
+                    },
+                  ],
+                  "text": "A String", # Required. The text content.
+                },
+                "video": { # A video content block.
+                  "data": "A String", # The video content.
+                  "mimeTypeString": "A String", # Flexible MIME type string of the video, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                  "name": "A String", # A user-defined name for this content block. Can be referenced by the model in the final response.
+                  "processingConfig": {
+                    "static": {
+                      "endOffset": "A String", # Optional. Segment end time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "30s". Must be non-negative and greater than `start_offset` if `start_offset` is set.
+                      "fps": 3.14, # Optional. Video frame-rate sampling density.
+                      "startOffset": "A String", # Optional. Segment start time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "10.5s". Must be non-negative.
+                    },
+                  },
+                  "processingType": "A String",
+                  "resolution": "A String", # The resolution of the media.
+                  "uri": "A String", # The URI of the video.
+                },
+              },
+              "listValue": { # `ListValue` is a wrapper around a repeated field of values. # Represents a repeated `Value`.
+                "values": [ # Repeated field of dynamically typed values.
+                  # Object with schema name: GenaiVertexV1Value
+                ],
+              },
+              "nullValue": "A String", # Represents a null value.
+              "numberValue": 3.14, # Represents a double value.
+              "stringValue": "A String", # Represents a string value.
+              "structValue": # Object with schema name: GenaiVertexV1Struct # Represents a structured value.
+            },
+          },
+        ],
+      },
+    },
+    "video": { # Configuration for video output format.
+      "aspectRatio": "A String", # The aspect ratio for the video output.
+      "delivery": "A String", # The delivery mode for the video output.
+      "duration": "A String", # The duration for the video output.
+      "gcsUri": "A String", # The Cloud Storage URI to store the video output. Required for Vertex if delivery mode is URI.
+      "resolution": "A String", # The video output resolution. Defaults to 720p.
+    },
+  },
+  "safetySettings": [ # Safety settings for the interaction.
+    { # A safety setting that affects the safety-blocking behavior. A SafetySetting consists of a harm category and a threshold for that category.
+      "method": "A String", # Optional. The method for blocking content. If not specified, the default behavior is to use the probability score.
+      "threshold": "A String", # Required. The threshold for blocking content. If the harm probability exceeds this threshold, the content will be blocked.
+      "type": "A String", # Required. The type of harm category to be blocked.
+    },
+  ],
+  "serviceTier": "A String", # The service tier for the interaction.
+  "status": "A String", # Required. Output only. The status of the interaction.
+  "stepList": { # A list of Steps. # Input only. The steps for the interaction.
+    "steps": [ # The steps of the list.
+      { # A step in the interaction.
+        "modelOutput": { # Output generated by the model.
+          "content": [
+            { # The content of the response.
+              "audio": { # An audio content block.
+                "channels": 42, # The number of audio channels.
+                "data": "A String", # The audio content.
+                "mimeTypeString": "A String", # Flexible MIME type string of the audio, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                "sampleRate": 42, # The sample rate of the audio.
+                "uri": "A String", # The URI of the audio.
+              },
+              "document": { # A document content block.
+                "data": "A String", # The document content.
+                "mimeTypeString": "A String", # Flexible MIME type string of the document, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                "uri": "A String", # The URI of the document.
+              },
+              "image": { # An image content block.
+                "data": "A String", # The image content.
+                "mimeTypeString": "A String", # Flexible MIME type string of the image, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                "resolution": "A String", # The resolution of the media.
+                "uri": "A String", # The URI of the image.
+              },
+              "text": { # A text content block.
+                "annotations": [ # Citation information for model-generated content.
+                  { # Citation information for model-generated content.
+                    "endIndex": 42, # End of the attributed segment, exclusive.
+                    "fileCitation": { # A file citation annotation. # A file citation annotation.
+                      "customMetadata": { # User provided metadata about the retrieved context.
+                        "a_key": "", # Properties of the object.
+                      },
+                      "documentUri": "A String", # The URI of the file.
+                      "fileName": "A String", # The name of the file.
+                      "mediaId": "A String", # Media ID in-case of image citations, if applicable.
+                      "pageNumber": 42, # Page number of the cited document, if applicable.
+                      "source": "A String", # Source attributed for a portion of the text.
+                    },
+                    "placeCitation": { # A place citation annotation. # A place citation annotation.
+                      "name": "A String", # Title of the place.
+                      "placeId": "A String", # The ID of the place, in `places/{place_id}` format.
+                      "reviewSnippets": [ # Snippets of reviews that are used to generate answers about the features of a given place in Google Maps.
+                        { # Encapsulates a snippet of a user review that answers a question about the features of a specific place in Google Maps.
+                          "reviewId": "A String", # The ID of the review snippet.
+                          "title": "A String", # Title of the review.
+                          "url": "A String", # A link that corresponds to the user review on Google Maps.
+                        },
+                      ],
+                      "url": "A String", # URI reference of the place.
+                    },
+                    "speechMetadata": { # Speech annotation for text content. # Speech annotation for text content.
+                      "speaker": "A String", # The speaker to associate with this turn.
+                      "style": "A String", # Style instruction for the speech synthesis.
+                    },
+                    "startIndex": 42, # Start of segment of the response that is attributed to this source. Index indicates the start of the segment, measured in bytes.
+                    "urlCitation": { # A URL citation annotation. # NOTE: We use these instead of the Citation message for historical reasons. A URL citation annotation.
+                      "title": "A String", # The title of the URL.
+                      "url": "A String", # The URL.
+                    },
+                    "wordInfo": { # Word-level ASR annotation for transcription output. Carries the word text, optional timing, and optional speaker attribution. # Word-level ASR annotation with timing and speaker info.
+                      "endOffset": "A String", # End offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                      "speaker": "A String", # Optional. Speaker label for this word (e.g. "spk_1", "spk_2"). Present when diarization_mode is set in TranscriptionConfig.
+                      "startOffset": "A String", # Start offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                      "text": "A String", # The transcribed word.
+                    },
+                  },
+                ],
+                "text": "A String", # Required. The text content.
+              },
+              "video": { # A video content block.
+                "data": "A String", # The video content.
+                "mimeTypeString": "A String", # Flexible MIME type string of the video, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                "name": "A String", # A user-defined name for this content block. Can be referenced by the model in the final response.
+                "processingConfig": {
+                  "static": {
+                    "endOffset": "A String", # Optional. Segment end time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "30s". Must be non-negative and greater than `start_offset` if `start_offset` is set.
+                    "fps": 3.14, # Optional. Video frame-rate sampling density.
+                    "startOffset": "A String", # Optional. Segment start time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "10.5s". Must be non-negative.
+                  },
+                },
+                "processingType": "A String",
+                "resolution": "A String", # The resolution of the media.
+                "uri": "A String", # The URI of the video.
+              },
+            },
+          ],
+          "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.
+          },
+        },
+        "thought": { # A thought step.
+          "signature": "A String", # A signature hash for backend validation.
+          "summary": [ # A summary of the thought.
+            { # The content of the response.
+              "audio": { # An audio content block.
+                "channels": 42, # The number of audio channels.
+                "data": "A String", # The audio content.
+                "mimeTypeString": "A String", # Flexible MIME type string of the audio, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                "sampleRate": 42, # The sample rate of the audio.
+                "uri": "A String", # The URI of the audio.
+              },
+              "document": { # A document content block.
+                "data": "A String", # The document content.
+                "mimeTypeString": "A String", # Flexible MIME type string of the document, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                "uri": "A String", # The URI of the document.
+              },
+              "image": { # An image content block.
+                "data": "A String", # The image content.
+                "mimeTypeString": "A String", # Flexible MIME type string of the image, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                "resolution": "A String", # The resolution of the media.
+                "uri": "A String", # The URI of the image.
+              },
+              "text": { # A text content block.
+                "annotations": [ # Citation information for model-generated content.
+                  { # Citation information for model-generated content.
+                    "endIndex": 42, # End of the attributed segment, exclusive.
+                    "fileCitation": { # A file citation annotation. # A file citation annotation.
+                      "customMetadata": { # User provided metadata about the retrieved context.
+                        "a_key": "", # Properties of the object.
+                      },
+                      "documentUri": "A String", # The URI of the file.
+                      "fileName": "A String", # The name of the file.
+                      "mediaId": "A String", # Media ID in-case of image citations, if applicable.
+                      "pageNumber": 42, # Page number of the cited document, if applicable.
+                      "source": "A String", # Source attributed for a portion of the text.
+                    },
+                    "placeCitation": { # A place citation annotation. # A place citation annotation.
+                      "name": "A String", # Title of the place.
+                      "placeId": "A String", # The ID of the place, in `places/{place_id}` format.
+                      "reviewSnippets": [ # Snippets of reviews that are used to generate answers about the features of a given place in Google Maps.
+                        { # Encapsulates a snippet of a user review that answers a question about the features of a specific place in Google Maps.
+                          "reviewId": "A String", # The ID of the review snippet.
+                          "title": "A String", # Title of the review.
+                          "url": "A String", # A link that corresponds to the user review on Google Maps.
+                        },
+                      ],
+                      "url": "A String", # URI reference of the place.
+                    },
+                    "speechMetadata": { # Speech annotation for text content. # Speech annotation for text content.
+                      "speaker": "A String", # The speaker to associate with this turn.
+                      "style": "A String", # Style instruction for the speech synthesis.
+                    },
+                    "startIndex": 42, # Start of segment of the response that is attributed to this source. Index indicates the start of the segment, measured in bytes.
+                    "urlCitation": { # A URL citation annotation. # NOTE: We use these instead of the Citation message for historical reasons. A URL citation annotation.
+                      "title": "A String", # The title of the URL.
+                      "url": "A String", # The URL.
+                    },
+                    "wordInfo": { # Word-level ASR annotation for transcription output. Carries the word text, optional timing, and optional speaker attribution. # Word-level ASR annotation with timing and speaker info.
+                      "endOffset": "A String", # End offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                      "speaker": "A String", # Optional. Speaker label for this word (e.g. "spk_1", "spk_2"). Present when diarization_mode is set in TranscriptionConfig.
+                      "startOffset": "A String", # Start offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                      "text": "A String", # The transcribed word.
+                    },
+                  },
+                ],
+                "text": "A String", # Required. The text content.
+              },
+              "video": { # A video content block.
+                "data": "A String", # The video content.
+                "mimeTypeString": "A String", # Flexible MIME type string of the video, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                "name": "A String", # A user-defined name for this content block. Can be referenced by the model in the final response.
+                "processingConfig": {
+                  "static": {
+                    "endOffset": "A String", # Optional. Segment end time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "30s". Must be non-negative and greater than `start_offset` if `start_offset` is set.
+                    "fps": 3.14, # Optional. Video frame-rate sampling density.
+                    "startOffset": "A String", # Optional. Segment start time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "10.5s". Must be non-negative.
+                  },
+                },
+                "processingType": "A String",
+                "resolution": "A String", # The resolution of the media.
+                "uri": "A String", # The URI of the video.
+              },
+            },
+          ],
+        },
+        "toolCall": { # Tool call step.
+          "codeExecutionCall": { # Code execution call step.
+            "arguments": { # The arguments to pass to the code execution. # Required. The arguments to pass to the code execution.
+              "code": "A String", # The code to be executed.
+              "language": "A String", # Programming language of the `code`.
+            },
+          },
+          "fileSearchCall": { # File Search call step.
+          },
+          "functionCall": { # A function tool call step.
+            "arguments": { # `Struct` represents a structured data value, consisting of fields which map to dynamically typed values. # Required. The arguments to pass to the function.
+              "fields": [ # Dynamically typed fields. List instead of map because LLMs are sensitive to ordering, and we want to give users full control.
+                { # Represents a single field in a struct.
+                  "name": "A String",
+                  "value": { # `Value` represents a dynamically typed value which can be either null, a number, a string, a boolean, a recursive struct value, or a list of values. A producer of value is expected to set one of these variants. Absence of any variant indicates an error.
+                    "boolValue": True or False, # Represents a boolean value.
+                    "contentValue": { # The content of the response. # Represents rich content (text, image, etc.).
+                      "audio": { # An audio content block.
+                        "channels": 42, # The number of audio channels.
+                        "data": "A String", # The audio content.
+                        "mimeTypeString": "A String", # Flexible MIME type string of the audio, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                        "sampleRate": 42, # The sample rate of the audio.
+                        "uri": "A String", # The URI of the audio.
+                      },
+                      "document": { # A document content block.
+                        "data": "A String", # The document content.
+                        "mimeTypeString": "A String", # Flexible MIME type string of the document, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                        "uri": "A String", # The URI of the document.
+                      },
+                      "image": { # An image content block.
+                        "data": "A String", # The image content.
+                        "mimeTypeString": "A String", # Flexible MIME type string of the image, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                        "resolution": "A String", # The resolution of the media.
+                        "uri": "A String", # The URI of the image.
+                      },
+                      "text": { # A text content block.
+                        "annotations": [ # Citation information for model-generated content.
+                          { # Citation information for model-generated content.
+                            "endIndex": 42, # End of the attributed segment, exclusive.
+                            "fileCitation": { # A file citation annotation. # A file citation annotation.
+                              "customMetadata": { # User provided metadata about the retrieved context.
+                                "a_key": "", # Properties of the object.
+                              },
+                              "documentUri": "A String", # The URI of the file.
+                              "fileName": "A String", # The name of the file.
+                              "mediaId": "A String", # Media ID in-case of image citations, if applicable.
+                              "pageNumber": 42, # Page number of the cited document, if applicable.
+                              "source": "A String", # Source attributed for a portion of the text.
+                            },
+                            "placeCitation": { # A place citation annotation. # A place citation annotation.
+                              "name": "A String", # Title of the place.
+                              "placeId": "A String", # The ID of the place, in `places/{place_id}` format.
+                              "reviewSnippets": [ # Snippets of reviews that are used to generate answers about the features of a given place in Google Maps.
+                                { # Encapsulates a snippet of a user review that answers a question about the features of a specific place in Google Maps.
+                                  "reviewId": "A String", # The ID of the review snippet.
+                                  "title": "A String", # Title of the review.
+                                  "url": "A String", # A link that corresponds to the user review on Google Maps.
+                                },
+                              ],
+                              "url": "A String", # URI reference of the place.
+                            },
+                            "speechMetadata": { # Speech annotation for text content. # Speech annotation for text content.
+                              "speaker": "A String", # The speaker to associate with this turn.
+                              "style": "A String", # Style instruction for the speech synthesis.
+                            },
+                            "startIndex": 42, # Start of segment of the response that is attributed to this source. Index indicates the start of the segment, measured in bytes.
+                            "urlCitation": { # A URL citation annotation. # NOTE: We use these instead of the Citation message for historical reasons. A URL citation annotation.
+                              "title": "A String", # The title of the URL.
+                              "url": "A String", # The URL.
+                            },
+                            "wordInfo": { # Word-level ASR annotation for transcription output. Carries the word text, optional timing, and optional speaker attribution. # Word-level ASR annotation with timing and speaker info.
+                              "endOffset": "A String", # End offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                              "speaker": "A String", # Optional. Speaker label for this word (e.g. "spk_1", "spk_2"). Present when diarization_mode is set in TranscriptionConfig.
+                              "startOffset": "A String", # Start offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                              "text": "A String", # The transcribed word.
+                            },
+                          },
+                        ],
+                        "text": "A String", # Required. The text content.
+                      },
+                      "video": { # A video content block.
+                        "data": "A String", # The video content.
+                        "mimeTypeString": "A String", # Flexible MIME type string of the video, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                        "name": "A String", # A user-defined name for this content block. Can be referenced by the model in the final response.
+                        "processingConfig": {
+                          "static": {
+                            "endOffset": "A String", # Optional. Segment end time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "30s". Must be non-negative and greater than `start_offset` if `start_offset` is set.
+                            "fps": 3.14, # Optional. Video frame-rate sampling density.
+                            "startOffset": "A String", # Optional. Segment start time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "10.5s". Must be non-negative.
+                          },
+                        },
+                        "processingType": "A String",
+                        "resolution": "A String", # The resolution of the media.
+                        "uri": "A String", # The URI of the video.
+                      },
+                    },
+                    "listValue": { # `ListValue` is a wrapper around a repeated field of values. # Represents a repeated `Value`.
+                      "values": [ # Repeated field of dynamically typed values.
+                        # Object with schema name: GenaiVertexV1Value
+                      ],
+                    },
+                    "nullValue": "A String", # Represents a null value.
+                    "numberValue": 3.14, # Represents a double value.
+                    "stringValue": "A String", # Represents a string value.
+                    "structValue": # Object with schema name: GenaiVertexV1Struct # Represents a structured value.
+                  },
+                },
+              ],
+            },
+            "name": "A String", # Required. The name of the tool to call.
+          },
+          "googleMapsCall": { # Google Maps call step.
+            "arguments": { # The arguments to pass to the Google Maps tool. # The arguments to pass to the Google Maps tool.
+              "queries": [ # The queries to be executed.
+                "A String",
+              ],
+            },
+          },
+          "googleSearchCall": { # Google Search call step.
+            "arguments": { # The arguments to pass to Google Search. # Required. The arguments to pass to Google Search.
+              "queries": [ # Web search queries for the following-up web search.
+                "A String",
+              ],
+            },
+            "searchType": "A String", # The type of search grounding enabled.
+          },
+          "id": "A String", # Required. A unique ID for this specific tool call.
+          "processingCall": { # A server-initiated processing step for media analysis (e.g. video understanding).
+          },
+          "retrievalCall": { # Retrieval call step. Used by Vertex Retrieval tools such as Parallel AI, Exa AI, Vertex AI Search, etc. RetrievalType decides which tool is used.
+            "arguments": { # The arguments to pass to Retrieval tools. # Required. The arguments to pass to the retrieval tool.
+              "queries": [ # Queries for Retrieval information.
+                "A String",
+              ],
+            },
+            "retrievalType": "A String", # The type of retrieval tools.
+          },
+          "signature": "A String", # A signature hash for backend validation.
+          "urlContextCall": { # URL context call step.
+            "arguments": { # The arguments to pass to the URL context. # Required. The arguments to pass to the URL context.
+              "urls": [ # The URLs to fetch.
+                "A String",
+              ],
+            },
+          },
+        },
+        "toolResult": { # Tool result step.
+          "callId": "A String", # Required. ID to match the ID from the function call block.
+          "codeExecutionResult": { # Code execution result step.
+            "isError": True or False, # Whether the code execution resulted in an error.
+            "result": "A String", # Required. The output of the code execution.
+          },
+          "fileSearchResult": { # File Search result step.
+          },
+          "functionResult": { # Result of a function tool call.
+            "isError": True or False, # Whether the tool call resulted in an error.
+            "name": "A String", # The name of the tool that was called.
+            "result": { # `Value` represents a dynamically typed value which can be either null, a number, a string, a boolean, a recursive struct value, or a list of values. A producer of value is expected to set one of these variants. Absence of any variant indicates an error. # Required. The result of the tool call.
+              "boolValue": True or False, # Represents a boolean value.
+              "contentValue": { # The content of the response. # Represents rich content (text, image, etc.).
+                "audio": { # An audio content block.
+                  "channels": 42, # The number of audio channels.
+                  "data": "A String", # The audio content.
+                  "mimeTypeString": "A String", # Flexible MIME type string of the audio, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                  "sampleRate": 42, # The sample rate of the audio.
+                  "uri": "A String", # The URI of the audio.
+                },
+                "document": { # A document content block.
+                  "data": "A String", # The document content.
+                  "mimeTypeString": "A String", # Flexible MIME type string of the document, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                  "uri": "A String", # The URI of the document.
+                },
+                "image": { # An image content block.
+                  "data": "A String", # The image content.
+                  "mimeTypeString": "A String", # Flexible MIME type string of the image, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                  "resolution": "A String", # The resolution of the media.
+                  "uri": "A String", # The URI of the image.
+                },
+                "text": { # A text content block.
+                  "annotations": [ # Citation information for model-generated content.
+                    { # Citation information for model-generated content.
+                      "endIndex": 42, # End of the attributed segment, exclusive.
+                      "fileCitation": { # A file citation annotation. # A file citation annotation.
+                        "customMetadata": { # User provided metadata about the retrieved context.
+                          "a_key": "", # Properties of the object.
+                        },
+                        "documentUri": "A String", # The URI of the file.
+                        "fileName": "A String", # The name of the file.
+                        "mediaId": "A String", # Media ID in-case of image citations, if applicable.
+                        "pageNumber": 42, # Page number of the cited document, if applicable.
+                        "source": "A String", # Source attributed for a portion of the text.
+                      },
+                      "placeCitation": { # A place citation annotation. # A place citation annotation.
+                        "name": "A String", # Title of the place.
+                        "placeId": "A String", # The ID of the place, in `places/{place_id}` format.
+                        "reviewSnippets": [ # Snippets of reviews that are used to generate answers about the features of a given place in Google Maps.
+                          { # Encapsulates a snippet of a user review that answers a question about the features of a specific place in Google Maps.
+                            "reviewId": "A String", # The ID of the review snippet.
+                            "title": "A String", # Title of the review.
+                            "url": "A String", # A link that corresponds to the user review on Google Maps.
+                          },
+                        ],
+                        "url": "A String", # URI reference of the place.
+                      },
+                      "speechMetadata": { # Speech annotation for text content. # Speech annotation for text content.
+                        "speaker": "A String", # The speaker to associate with this turn.
+                        "style": "A String", # Style instruction for the speech synthesis.
+                      },
+                      "startIndex": 42, # Start of segment of the response that is attributed to this source. Index indicates the start of the segment, measured in bytes.
+                      "urlCitation": { # A URL citation annotation. # NOTE: We use these instead of the Citation message for historical reasons. A URL citation annotation.
+                        "title": "A String", # The title of the URL.
+                        "url": "A String", # The URL.
+                      },
+                      "wordInfo": { # Word-level ASR annotation for transcription output. Carries the word text, optional timing, and optional speaker attribution. # Word-level ASR annotation with timing and speaker info.
+                        "endOffset": "A String", # End offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                        "speaker": "A String", # Optional. Speaker label for this word (e.g. "spk_1", "spk_2"). Present when diarization_mode is set in TranscriptionConfig.
+                        "startOffset": "A String", # Start offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                        "text": "A String", # The transcribed word.
+                      },
+                    },
+                  ],
+                  "text": "A String", # Required. The text content.
+                },
+                "video": { # A video content block.
+                  "data": "A String", # The video content.
+                  "mimeTypeString": "A String", # Flexible MIME type string of the video, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                  "name": "A String", # A user-defined name for this content block. Can be referenced by the model in the final response.
+                  "processingConfig": {
+                    "static": {
+                      "endOffset": "A String", # Optional. Segment end time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "30s". Must be non-negative and greater than `start_offset` if `start_offset` is set.
+                      "fps": 3.14, # Optional. Video frame-rate sampling density.
+                      "startOffset": "A String", # Optional. Segment start time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "10.5s". Must be non-negative.
+                    },
+                  },
+                  "processingType": "A String",
+                  "resolution": "A String", # The resolution of the media.
+                  "uri": "A String", # The URI of the video.
+                },
+              },
+              "listValue": { # `ListValue` is a wrapper around a repeated field of values. # Represents a repeated `Value`.
+                "values": [ # Repeated field of dynamically typed values.
+                  # Object with schema name: GenaiVertexV1Value
+                ],
+              },
+              "nullValue": "A String", # Represents a null value.
+              "numberValue": 3.14, # Represents a double value.
+              "stringValue": "A String", # Represents a string value.
+              "structValue": # Object with schema name: GenaiVertexV1Struct # Represents a structured value.
+            },
+          },
+          "googleMapsResult": { # Google Maps result step.
+            "result": [
+              { # The result of the Google Maps.
+                "places": [
+                  {
+                    "name": "A String",
+                    "placeId": "A String",
+                    "reviewSnippets": [
+                      { # Encapsulates a snippet of a user review that answers a question about the features of a specific place in Google Maps.
+                        "reviewId": "A String", # The ID of the review snippet.
+                        "title": "A String", # Title of the review.
+                        "url": "A String", # A link that corresponds to the user review on Google Maps.
+                      },
+                    ],
+                    "url": "A String",
+                  },
+                ],
+                "widgetContextToken": "A String",
+              },
+            ],
+          },
+          "googleSearchResult": { # Google Search result step.
+            "isError": True or False, # Whether the Google Search resulted in an error.
+            "result": [ # Required. The results of the Google Search.
+              { # The result of the Google Search.
+                "searchSuggestions": "A String", # Web content snippet that can be embedded in a web page or an app webview.
+              },
+            ],
+          },
+          "processingResult": { # The result of a server-initiated media processing step.
+          },
+          "retrievalResult": { # Vertex Retrieval result step. Used by Vertex Retrieval tools such as Parallel AI, Exa AI, Vertex AI Search, etc.
+            "isError": True or False, # Whether the retrieval resulted in an error.
+          },
+          "signature": "A String", # A signature hash for backend validation.
+          "urlContextResult": { # URL context result step.
+            "isError": True or False, # Whether the URL context resulted in an error.
+            "result": [ # Required. The results of the URL context.
+              { # The result of the URL context.
+                "status": "A String", # The status of the URL retrieval.
+                "url": "A String", # The URL that was fetched.
+              },
+            ],
+          },
+        },
+        "userInput": { # Input provided by the user. # DO NOT USE -- These are for 3P JSON only
+          "contentList": { # A list of Content. # The content of the step. An array of Content objects.
+            "contents": [ # The contents of the list.
+              { # The content of the response.
+                "audio": { # An audio content block.
+                  "channels": 42, # The number of audio channels.
+                  "data": "A String", # The audio content.
+                  "mimeTypeString": "A String", # Flexible MIME type string of the audio, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                  "sampleRate": 42, # The sample rate of the audio.
+                  "uri": "A String", # The URI of the audio.
+                },
+                "document": { # A document content block.
+                  "data": "A String", # The document content.
+                  "mimeTypeString": "A String", # Flexible MIME type string of the document, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                  "uri": "A String", # The URI of the document.
+                },
+                "image": { # An image content block.
+                  "data": "A String", # The image content.
+                  "mimeTypeString": "A String", # Flexible MIME type string of the image, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                  "resolution": "A String", # The resolution of the media.
+                  "uri": "A String", # The URI of the image.
+                },
+                "text": { # A text content block.
+                  "annotations": [ # Citation information for model-generated content.
+                    { # Citation information for model-generated content.
+                      "endIndex": 42, # End of the attributed segment, exclusive.
+                      "fileCitation": { # A file citation annotation. # A file citation annotation.
+                        "customMetadata": { # User provided metadata about the retrieved context.
+                          "a_key": "", # Properties of the object.
+                        },
+                        "documentUri": "A String", # The URI of the file.
+                        "fileName": "A String", # The name of the file.
+                        "mediaId": "A String", # Media ID in-case of image citations, if applicable.
+                        "pageNumber": 42, # Page number of the cited document, if applicable.
+                        "source": "A String", # Source attributed for a portion of the text.
+                      },
+                      "placeCitation": { # A place citation annotation. # A place citation annotation.
+                        "name": "A String", # Title of the place.
+                        "placeId": "A String", # The ID of the place, in `places/{place_id}` format.
+                        "reviewSnippets": [ # Snippets of reviews that are used to generate answers about the features of a given place in Google Maps.
+                          { # Encapsulates a snippet of a user review that answers a question about the features of a specific place in Google Maps.
+                            "reviewId": "A String", # The ID of the review snippet.
+                            "title": "A String", # Title of the review.
+                            "url": "A String", # A link that corresponds to the user review on Google Maps.
+                          },
+                        ],
+                        "url": "A String", # URI reference of the place.
+                      },
+                      "speechMetadata": { # Speech annotation for text content. # Speech annotation for text content.
+                        "speaker": "A String", # The speaker to associate with this turn.
+                        "style": "A String", # Style instruction for the speech synthesis.
+                      },
+                      "startIndex": 42, # Start of segment of the response that is attributed to this source. Index indicates the start of the segment, measured in bytes.
+                      "urlCitation": { # A URL citation annotation. # NOTE: We use these instead of the Citation message for historical reasons. A URL citation annotation.
+                        "title": "A String", # The title of the URL.
+                        "url": "A String", # The URL.
+                      },
+                      "wordInfo": { # Word-level ASR annotation for transcription output. Carries the word text, optional timing, and optional speaker attribution. # Word-level ASR annotation with timing and speaker info.
+                        "endOffset": "A String", # End offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                        "speaker": "A String", # Optional. Speaker label for this word (e.g. "spk_1", "spk_2"). Present when diarization_mode is set in TranscriptionConfig.
+                        "startOffset": "A String", # Start offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                        "text": "A String", # The transcribed word.
+                      },
+                    },
+                  ],
+                  "text": "A String", # Required. The text content.
+                },
+                "video": { # A video content block.
+                  "data": "A String", # The video content.
+                  "mimeTypeString": "A String", # Flexible MIME type string of the video, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                  "name": "A String", # A user-defined name for this content block. Can be referenced by the model in the final response.
+                  "processingConfig": {
+                    "static": {
+                      "endOffset": "A String", # Optional. Segment end time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "30s". Must be non-negative and greater than `start_offset` if `start_offset` is set.
+                      "fps": 3.14, # Optional. Video frame-rate sampling density.
+                      "startOffset": "A String", # Optional. Segment start time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "10.5s". Must be non-negative.
+                    },
+                  },
+                  "processingType": "A String",
+                  "resolution": "A String", # The resolution of the media.
+                  "uri": "A String", # The URI of the video.
+                },
+              },
+            ],
+          },
+          "contentString": "A String", # The content of the step. A single string.
+        },
+      },
+    ],
+  },
+  "steps": [ # Required. Output only. The steps that make up the interaction, when included in the response.
+    { # A step in the interaction.
+      "modelOutput": { # Output generated by the model.
+        "content": [
+          { # The content of the response.
+            "audio": { # An audio content block.
+              "channels": 42, # The number of audio channels.
+              "data": "A String", # The audio content.
+              "mimeTypeString": "A String", # Flexible MIME type string of the audio, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+              "sampleRate": 42, # The sample rate of the audio.
+              "uri": "A String", # The URI of the audio.
+            },
+            "document": { # A document content block.
+              "data": "A String", # The document content.
+              "mimeTypeString": "A String", # Flexible MIME type string of the document, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+              "uri": "A String", # The URI of the document.
+            },
+            "image": { # An image content block.
+              "data": "A String", # The image content.
+              "mimeTypeString": "A String", # Flexible MIME type string of the image, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+              "resolution": "A String", # The resolution of the media.
+              "uri": "A String", # The URI of the image.
+            },
+            "text": { # A text content block.
+              "annotations": [ # Citation information for model-generated content.
+                { # Citation information for model-generated content.
+                  "endIndex": 42, # End of the attributed segment, exclusive.
+                  "fileCitation": { # A file citation annotation. # A file citation annotation.
+                    "customMetadata": { # User provided metadata about the retrieved context.
+                      "a_key": "", # Properties of the object.
+                    },
+                    "documentUri": "A String", # The URI of the file.
+                    "fileName": "A String", # The name of the file.
+                    "mediaId": "A String", # Media ID in-case of image citations, if applicable.
+                    "pageNumber": 42, # Page number of the cited document, if applicable.
+                    "source": "A String", # Source attributed for a portion of the text.
+                  },
+                  "placeCitation": { # A place citation annotation. # A place citation annotation.
+                    "name": "A String", # Title of the place.
+                    "placeId": "A String", # The ID of the place, in `places/{place_id}` format.
+                    "reviewSnippets": [ # Snippets of reviews that are used to generate answers about the features of a given place in Google Maps.
+                      { # Encapsulates a snippet of a user review that answers a question about the features of a specific place in Google Maps.
+                        "reviewId": "A String", # The ID of the review snippet.
+                        "title": "A String", # Title of the review.
+                        "url": "A String", # A link that corresponds to the user review on Google Maps.
+                      },
+                    ],
+                    "url": "A String", # URI reference of the place.
+                  },
+                  "speechMetadata": { # Speech annotation for text content. # Speech annotation for text content.
+                    "speaker": "A String", # The speaker to associate with this turn.
+                    "style": "A String", # Style instruction for the speech synthesis.
+                  },
+                  "startIndex": 42, # Start of segment of the response that is attributed to this source. Index indicates the start of the segment, measured in bytes.
+                  "urlCitation": { # A URL citation annotation. # NOTE: We use these instead of the Citation message for historical reasons. A URL citation annotation.
+                    "title": "A String", # The title of the URL.
+                    "url": "A String", # The URL.
+                  },
+                  "wordInfo": { # Word-level ASR annotation for transcription output. Carries the word text, optional timing, and optional speaker attribution. # Word-level ASR annotation with timing and speaker info.
+                    "endOffset": "A String", # End offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                    "speaker": "A String", # Optional. Speaker label for this word (e.g. "spk_1", "spk_2"). Present when diarization_mode is set in TranscriptionConfig.
+                    "startOffset": "A String", # Start offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                    "text": "A String", # The transcribed word.
+                  },
+                },
+              ],
+              "text": "A String", # Required. The text content.
+            },
+            "video": { # A video content block.
+              "data": "A String", # The video content.
+              "mimeTypeString": "A String", # Flexible MIME type string of the video, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+              "name": "A String", # A user-defined name for this content block. Can be referenced by the model in the final response.
+              "processingConfig": {
+                "static": {
+                  "endOffset": "A String", # Optional. Segment end time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "30s". Must be non-negative and greater than `start_offset` if `start_offset` is set.
+                  "fps": 3.14, # Optional. Video frame-rate sampling density.
+                  "startOffset": "A String", # Optional. Segment start time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "10.5s". Must be non-negative.
+                },
+              },
+              "processingType": "A String",
+              "resolution": "A String", # The resolution of the media.
+              "uri": "A String", # The URI of the video.
+            },
+          },
+        ],
+        "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.
+        },
+      },
+      "thought": { # A thought step.
+        "signature": "A String", # A signature hash for backend validation.
+        "summary": [ # A summary of the thought.
+          { # The content of the response.
+            "audio": { # An audio content block.
+              "channels": 42, # The number of audio channels.
+              "data": "A String", # The audio content.
+              "mimeTypeString": "A String", # Flexible MIME type string of the audio, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+              "sampleRate": 42, # The sample rate of the audio.
+              "uri": "A String", # The URI of the audio.
+            },
+            "document": { # A document content block.
+              "data": "A String", # The document content.
+              "mimeTypeString": "A String", # Flexible MIME type string of the document, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+              "uri": "A String", # The URI of the document.
+            },
+            "image": { # An image content block.
+              "data": "A String", # The image content.
+              "mimeTypeString": "A String", # Flexible MIME type string of the image, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+              "resolution": "A String", # The resolution of the media.
+              "uri": "A String", # The URI of the image.
+            },
+            "text": { # A text content block.
+              "annotations": [ # Citation information for model-generated content.
+                { # Citation information for model-generated content.
+                  "endIndex": 42, # End of the attributed segment, exclusive.
+                  "fileCitation": { # A file citation annotation. # A file citation annotation.
+                    "customMetadata": { # User provided metadata about the retrieved context.
+                      "a_key": "", # Properties of the object.
+                    },
+                    "documentUri": "A String", # The URI of the file.
+                    "fileName": "A String", # The name of the file.
+                    "mediaId": "A String", # Media ID in-case of image citations, if applicable.
+                    "pageNumber": 42, # Page number of the cited document, if applicable.
+                    "source": "A String", # Source attributed for a portion of the text.
+                  },
+                  "placeCitation": { # A place citation annotation. # A place citation annotation.
+                    "name": "A String", # Title of the place.
+                    "placeId": "A String", # The ID of the place, in `places/{place_id}` format.
+                    "reviewSnippets": [ # Snippets of reviews that are used to generate answers about the features of a given place in Google Maps.
+                      { # Encapsulates a snippet of a user review that answers a question about the features of a specific place in Google Maps.
+                        "reviewId": "A String", # The ID of the review snippet.
+                        "title": "A String", # Title of the review.
+                        "url": "A String", # A link that corresponds to the user review on Google Maps.
+                      },
+                    ],
+                    "url": "A String", # URI reference of the place.
+                  },
+                  "speechMetadata": { # Speech annotation for text content. # Speech annotation for text content.
+                    "speaker": "A String", # The speaker to associate with this turn.
+                    "style": "A String", # Style instruction for the speech synthesis.
+                  },
+                  "startIndex": 42, # Start of segment of the response that is attributed to this source. Index indicates the start of the segment, measured in bytes.
+                  "urlCitation": { # A URL citation annotation. # NOTE: We use these instead of the Citation message for historical reasons. A URL citation annotation.
+                    "title": "A String", # The title of the URL.
+                    "url": "A String", # The URL.
+                  },
+                  "wordInfo": { # Word-level ASR annotation for transcription output. Carries the word text, optional timing, and optional speaker attribution. # Word-level ASR annotation with timing and speaker info.
+                    "endOffset": "A String", # End offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                    "speaker": "A String", # Optional. Speaker label for this word (e.g. "spk_1", "spk_2"). Present when diarization_mode is set in TranscriptionConfig.
+                    "startOffset": "A String", # Start offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                    "text": "A String", # The transcribed word.
+                  },
+                },
+              ],
+              "text": "A String", # Required. The text content.
+            },
+            "video": { # A video content block.
+              "data": "A String", # The video content.
+              "mimeTypeString": "A String", # Flexible MIME type string of the video, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+              "name": "A String", # A user-defined name for this content block. Can be referenced by the model in the final response.
+              "processingConfig": {
+                "static": {
+                  "endOffset": "A String", # Optional. Segment end time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "30s". Must be non-negative and greater than `start_offset` if `start_offset` is set.
+                  "fps": 3.14, # Optional. Video frame-rate sampling density.
+                  "startOffset": "A String", # Optional. Segment start time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "10.5s". Must be non-negative.
+                },
+              },
+              "processingType": "A String",
+              "resolution": "A String", # The resolution of the media.
+              "uri": "A String", # The URI of the video.
+            },
+          },
+        ],
+      },
+      "toolCall": { # Tool call step.
+        "codeExecutionCall": { # Code execution call step.
+          "arguments": { # The arguments to pass to the code execution. # Required. The arguments to pass to the code execution.
+            "code": "A String", # The code to be executed.
+            "language": "A String", # Programming language of the `code`.
+          },
+        },
+        "fileSearchCall": { # File Search call step.
+        },
+        "functionCall": { # A function tool call step.
+          "arguments": { # `Struct` represents a structured data value, consisting of fields which map to dynamically typed values. # Required. The arguments to pass to the function.
+            "fields": [ # Dynamically typed fields. List instead of map because LLMs are sensitive to ordering, and we want to give users full control.
+              { # Represents a single field in a struct.
+                "name": "A String",
+                "value": { # `Value` represents a dynamically typed value which can be either null, a number, a string, a boolean, a recursive struct value, or a list of values. A producer of value is expected to set one of these variants. Absence of any variant indicates an error.
+                  "boolValue": True or False, # Represents a boolean value.
+                  "contentValue": { # The content of the response. # Represents rich content (text, image, etc.).
+                    "audio": { # An audio content block.
+                      "channels": 42, # The number of audio channels.
+                      "data": "A String", # The audio content.
+                      "mimeTypeString": "A String", # Flexible MIME type string of the audio, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                      "sampleRate": 42, # The sample rate of the audio.
+                      "uri": "A String", # The URI of the audio.
+                    },
+                    "document": { # A document content block.
+                      "data": "A String", # The document content.
+                      "mimeTypeString": "A String", # Flexible MIME type string of the document, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                      "uri": "A String", # The URI of the document.
+                    },
+                    "image": { # An image content block.
+                      "data": "A String", # The image content.
+                      "mimeTypeString": "A String", # Flexible MIME type string of the image, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                      "resolution": "A String", # The resolution of the media.
+                      "uri": "A String", # The URI of the image.
+                    },
+                    "text": { # A text content block.
+                      "annotations": [ # Citation information for model-generated content.
+                        { # Citation information for model-generated content.
+                          "endIndex": 42, # End of the attributed segment, exclusive.
+                          "fileCitation": { # A file citation annotation. # A file citation annotation.
+                            "customMetadata": { # User provided metadata about the retrieved context.
+                              "a_key": "", # Properties of the object.
+                            },
+                            "documentUri": "A String", # The URI of the file.
+                            "fileName": "A String", # The name of the file.
+                            "mediaId": "A String", # Media ID in-case of image citations, if applicable.
+                            "pageNumber": 42, # Page number of the cited document, if applicable.
+                            "source": "A String", # Source attributed for a portion of the text.
+                          },
+                          "placeCitation": { # A place citation annotation. # A place citation annotation.
+                            "name": "A String", # Title of the place.
+                            "placeId": "A String", # The ID of the place, in `places/{place_id}` format.
+                            "reviewSnippets": [ # Snippets of reviews that are used to generate answers about the features of a given place in Google Maps.
+                              { # Encapsulates a snippet of a user review that answers a question about the features of a specific place in Google Maps.
+                                "reviewId": "A String", # The ID of the review snippet.
+                                "title": "A String", # Title of the review.
+                                "url": "A String", # A link that corresponds to the user review on Google Maps.
+                              },
+                            ],
+                            "url": "A String", # URI reference of the place.
+                          },
+                          "speechMetadata": { # Speech annotation for text content. # Speech annotation for text content.
+                            "speaker": "A String", # The speaker to associate with this turn.
+                            "style": "A String", # Style instruction for the speech synthesis.
+                          },
+                          "startIndex": 42, # Start of segment of the response that is attributed to this source. Index indicates the start of the segment, measured in bytes.
+                          "urlCitation": { # A URL citation annotation. # NOTE: We use these instead of the Citation message for historical reasons. A URL citation annotation.
+                            "title": "A String", # The title of the URL.
+                            "url": "A String", # The URL.
+                          },
+                          "wordInfo": { # Word-level ASR annotation for transcription output. Carries the word text, optional timing, and optional speaker attribution. # Word-level ASR annotation with timing and speaker info.
+                            "endOffset": "A String", # End offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                            "speaker": "A String", # Optional. Speaker label for this word (e.g. "spk_1", "spk_2"). Present when diarization_mode is set in TranscriptionConfig.
+                            "startOffset": "A String", # Start offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                            "text": "A String", # The transcribed word.
+                          },
+                        },
+                      ],
+                      "text": "A String", # Required. The text content.
+                    },
+                    "video": { # A video content block.
+                      "data": "A String", # The video content.
+                      "mimeTypeString": "A String", # Flexible MIME type string of the video, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                      "name": "A String", # A user-defined name for this content block. Can be referenced by the model in the final response.
+                      "processingConfig": {
+                        "static": {
+                          "endOffset": "A String", # Optional. Segment end time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "30s". Must be non-negative and greater than `start_offset` if `start_offset` is set.
+                          "fps": 3.14, # Optional. Video frame-rate sampling density.
+                          "startOffset": "A String", # Optional. Segment start time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "10.5s". Must be non-negative.
+                        },
+                      },
+                      "processingType": "A String",
+                      "resolution": "A String", # The resolution of the media.
+                      "uri": "A String", # The URI of the video.
+                    },
+                  },
+                  "listValue": { # `ListValue` is a wrapper around a repeated field of values. # Represents a repeated `Value`.
+                    "values": [ # Repeated field of dynamically typed values.
+                      # Object with schema name: GenaiVertexV1Value
+                    ],
+                  },
+                  "nullValue": "A String", # Represents a null value.
+                  "numberValue": 3.14, # Represents a double value.
+                  "stringValue": "A String", # Represents a string value.
+                  "structValue": # Object with schema name: GenaiVertexV1Struct # Represents a structured value.
+                },
+              },
+            ],
+          },
+          "name": "A String", # Required. The name of the tool to call.
+        },
+        "googleMapsCall": { # Google Maps call step.
+          "arguments": { # The arguments to pass to the Google Maps tool. # The arguments to pass to the Google Maps tool.
+            "queries": [ # The queries to be executed.
+              "A String",
+            ],
+          },
+        },
+        "googleSearchCall": { # Google Search call step.
+          "arguments": { # The arguments to pass to Google Search. # Required. The arguments to pass to Google Search.
+            "queries": [ # Web search queries for the following-up web search.
+              "A String",
+            ],
+          },
+          "searchType": "A String", # The type of search grounding enabled.
+        },
+        "id": "A String", # Required. A unique ID for this specific tool call.
+        "processingCall": { # A server-initiated processing step for media analysis (e.g. video understanding).
+        },
+        "retrievalCall": { # Retrieval call step. Used by Vertex Retrieval tools such as Parallel AI, Exa AI, Vertex AI Search, etc. RetrievalType decides which tool is used.
+          "arguments": { # The arguments to pass to Retrieval tools. # Required. The arguments to pass to the retrieval tool.
+            "queries": [ # Queries for Retrieval information.
+              "A String",
+            ],
+          },
+          "retrievalType": "A String", # The type of retrieval tools.
+        },
+        "signature": "A String", # A signature hash for backend validation.
+        "urlContextCall": { # URL context call step.
+          "arguments": { # The arguments to pass to the URL context. # Required. The arguments to pass to the URL context.
+            "urls": [ # The URLs to fetch.
+              "A String",
+            ],
+          },
+        },
+      },
+      "toolResult": { # Tool result step.
+        "callId": "A String", # Required. ID to match the ID from the function call block.
+        "codeExecutionResult": { # Code execution result step.
+          "isError": True or False, # Whether the code execution resulted in an error.
+          "result": "A String", # Required. The output of the code execution.
+        },
+        "fileSearchResult": { # File Search result step.
+        },
+        "functionResult": { # Result of a function tool call.
+          "isError": True or False, # Whether the tool call resulted in an error.
+          "name": "A String", # The name of the tool that was called.
+          "result": { # `Value` represents a dynamically typed value which can be either null, a number, a string, a boolean, a recursive struct value, or a list of values. A producer of value is expected to set one of these variants. Absence of any variant indicates an error. # Required. The result of the tool call.
+            "boolValue": True or False, # Represents a boolean value.
+            "contentValue": { # The content of the response. # Represents rich content (text, image, etc.).
+              "audio": { # An audio content block.
+                "channels": 42, # The number of audio channels.
+                "data": "A String", # The audio content.
+                "mimeTypeString": "A String", # Flexible MIME type string of the audio, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                "sampleRate": 42, # The sample rate of the audio.
+                "uri": "A String", # The URI of the audio.
+              },
+              "document": { # A document content block.
+                "data": "A String", # The document content.
+                "mimeTypeString": "A String", # Flexible MIME type string of the document, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                "uri": "A String", # The URI of the document.
+              },
+              "image": { # An image content block.
+                "data": "A String", # The image content.
+                "mimeTypeString": "A String", # Flexible MIME type string of the image, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                "resolution": "A String", # The resolution of the media.
+                "uri": "A String", # The URI of the image.
+              },
+              "text": { # A text content block.
+                "annotations": [ # Citation information for model-generated content.
+                  { # Citation information for model-generated content.
+                    "endIndex": 42, # End of the attributed segment, exclusive.
+                    "fileCitation": { # A file citation annotation. # A file citation annotation.
+                      "customMetadata": { # User provided metadata about the retrieved context.
+                        "a_key": "", # Properties of the object.
+                      },
+                      "documentUri": "A String", # The URI of the file.
+                      "fileName": "A String", # The name of the file.
+                      "mediaId": "A String", # Media ID in-case of image citations, if applicable.
+                      "pageNumber": 42, # Page number of the cited document, if applicable.
+                      "source": "A String", # Source attributed for a portion of the text.
+                    },
+                    "placeCitation": { # A place citation annotation. # A place citation annotation.
+                      "name": "A String", # Title of the place.
+                      "placeId": "A String", # The ID of the place, in `places/{place_id}` format.
+                      "reviewSnippets": [ # Snippets of reviews that are used to generate answers about the features of a given place in Google Maps.
+                        { # Encapsulates a snippet of a user review that answers a question about the features of a specific place in Google Maps.
+                          "reviewId": "A String", # The ID of the review snippet.
+                          "title": "A String", # Title of the review.
+                          "url": "A String", # A link that corresponds to the user review on Google Maps.
+                        },
+                      ],
+                      "url": "A String", # URI reference of the place.
+                    },
+                    "speechMetadata": { # Speech annotation for text content. # Speech annotation for text content.
+                      "speaker": "A String", # The speaker to associate with this turn.
+                      "style": "A String", # Style instruction for the speech synthesis.
+                    },
+                    "startIndex": 42, # Start of segment of the response that is attributed to this source. Index indicates the start of the segment, measured in bytes.
+                    "urlCitation": { # A URL citation annotation. # NOTE: We use these instead of the Citation message for historical reasons. A URL citation annotation.
+                      "title": "A String", # The title of the URL.
+                      "url": "A String", # The URL.
+                    },
+                    "wordInfo": { # Word-level ASR annotation for transcription output. Carries the word text, optional timing, and optional speaker attribution. # Word-level ASR annotation with timing and speaker info.
+                      "endOffset": "A String", # End offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                      "speaker": "A String", # Optional. Speaker label for this word (e.g. "spk_1", "spk_2"). Present when diarization_mode is set in TranscriptionConfig.
+                      "startOffset": "A String", # Start offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                      "text": "A String", # The transcribed word.
+                    },
+                  },
+                ],
+                "text": "A String", # Required. The text content.
+              },
+              "video": { # A video content block.
+                "data": "A String", # The video content.
+                "mimeTypeString": "A String", # Flexible MIME type string of the video, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                "name": "A String", # A user-defined name for this content block. Can be referenced by the model in the final response.
+                "processingConfig": {
+                  "static": {
+                    "endOffset": "A String", # Optional. Segment end time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "30s". Must be non-negative and greater than `start_offset` if `start_offset` is set.
+                    "fps": 3.14, # Optional. Video frame-rate sampling density.
+                    "startOffset": "A String", # Optional. Segment start time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "10.5s". Must be non-negative.
+                  },
+                },
+                "processingType": "A String",
+                "resolution": "A String", # The resolution of the media.
+                "uri": "A String", # The URI of the video.
+              },
+            },
+            "listValue": { # `ListValue` is a wrapper around a repeated field of values. # Represents a repeated `Value`.
+              "values": [ # Repeated field of dynamically typed values.
+                # Object with schema name: GenaiVertexV1Value
+              ],
+            },
+            "nullValue": "A String", # Represents a null value.
+            "numberValue": 3.14, # Represents a double value.
+            "stringValue": "A String", # Represents a string value.
+            "structValue": # Object with schema name: GenaiVertexV1Struct # Represents a structured value.
+          },
+        },
+        "googleMapsResult": { # Google Maps result step.
+          "result": [
+            { # The result of the Google Maps.
+              "places": [
+                {
+                  "name": "A String",
+                  "placeId": "A String",
+                  "reviewSnippets": [
+                    { # Encapsulates a snippet of a user review that answers a question about the features of a specific place in Google Maps.
+                      "reviewId": "A String", # The ID of the review snippet.
+                      "title": "A String", # Title of the review.
+                      "url": "A String", # A link that corresponds to the user review on Google Maps.
+                    },
+                  ],
+                  "url": "A String",
+                },
+              ],
+              "widgetContextToken": "A String",
+            },
+          ],
+        },
+        "googleSearchResult": { # Google Search result step.
+          "isError": True or False, # Whether the Google Search resulted in an error.
+          "result": [ # Required. The results of the Google Search.
+            { # The result of the Google Search.
+              "searchSuggestions": "A String", # Web content snippet that can be embedded in a web page or an app webview.
+            },
+          ],
+        },
+        "processingResult": { # The result of a server-initiated media processing step.
+        },
+        "retrievalResult": { # Vertex Retrieval result step. Used by Vertex Retrieval tools such as Parallel AI, Exa AI, Vertex AI Search, etc.
+          "isError": True or False, # Whether the retrieval resulted in an error.
+        },
+        "signature": "A String", # A signature hash for backend validation.
+        "urlContextResult": { # URL context result step.
+          "isError": True or False, # Whether the URL context resulted in an error.
+          "result": [ # Required. The results of the URL context.
+            { # The result of the URL context.
+              "status": "A String", # The status of the URL retrieval.
+              "url": "A String", # The URL that was fetched.
+            },
+          ],
+        },
+      },
+      "userInput": { # Input provided by the user. # DO NOT USE -- These are for 3P JSON only
+        "contentList": { # A list of Content. # The content of the step. An array of Content objects.
+          "contents": [ # The contents of the list.
+            { # The content of the response.
+              "audio": { # An audio content block.
+                "channels": 42, # The number of audio channels.
+                "data": "A String", # The audio content.
+                "mimeTypeString": "A String", # Flexible MIME type string of the audio, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                "sampleRate": 42, # The sample rate of the audio.
+                "uri": "A String", # The URI of the audio.
+              },
+              "document": { # A document content block.
+                "data": "A String", # The document content.
+                "mimeTypeString": "A String", # Flexible MIME type string of the document, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                "uri": "A String", # The URI of the document.
+              },
+              "image": { # An image content block.
+                "data": "A String", # The image content.
+                "mimeTypeString": "A String", # Flexible MIME type string of the image, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                "resolution": "A String", # The resolution of the media.
+                "uri": "A String", # The URI of the image.
+              },
+              "text": { # A text content block.
+                "annotations": [ # Citation information for model-generated content.
+                  { # Citation information for model-generated content.
+                    "endIndex": 42, # End of the attributed segment, exclusive.
+                    "fileCitation": { # A file citation annotation. # A file citation annotation.
+                      "customMetadata": { # User provided metadata about the retrieved context.
+                        "a_key": "", # Properties of the object.
+                      },
+                      "documentUri": "A String", # The URI of the file.
+                      "fileName": "A String", # The name of the file.
+                      "mediaId": "A String", # Media ID in-case of image citations, if applicable.
+                      "pageNumber": 42, # Page number of the cited document, if applicable.
+                      "source": "A String", # Source attributed for a portion of the text.
+                    },
+                    "placeCitation": { # A place citation annotation. # A place citation annotation.
+                      "name": "A String", # Title of the place.
+                      "placeId": "A String", # The ID of the place, in `places/{place_id}` format.
+                      "reviewSnippets": [ # Snippets of reviews that are used to generate answers about the features of a given place in Google Maps.
+                        { # Encapsulates a snippet of a user review that answers a question about the features of a specific place in Google Maps.
+                          "reviewId": "A String", # The ID of the review snippet.
+                          "title": "A String", # Title of the review.
+                          "url": "A String", # A link that corresponds to the user review on Google Maps.
+                        },
+                      ],
+                      "url": "A String", # URI reference of the place.
+                    },
+                    "speechMetadata": { # Speech annotation for text content. # Speech annotation for text content.
+                      "speaker": "A String", # The speaker to associate with this turn.
+                      "style": "A String", # Style instruction for the speech synthesis.
+                    },
+                    "startIndex": 42, # Start of segment of the response that is attributed to this source. Index indicates the start of the segment, measured in bytes.
+                    "urlCitation": { # A URL citation annotation. # NOTE: We use these instead of the Citation message for historical reasons. A URL citation annotation.
+                      "title": "A String", # The title of the URL.
+                      "url": "A String", # The URL.
+                    },
+                    "wordInfo": { # Word-level ASR annotation for transcription output. Carries the word text, optional timing, and optional speaker attribution. # Word-level ASR annotation with timing and speaker info.
+                      "endOffset": "A String", # End offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                      "speaker": "A String", # Optional. Speaker label for this word (e.g. "spk_1", "spk_2"). Present when diarization_mode is set in TranscriptionConfig.
+                      "startOffset": "A String", # Start offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                      "text": "A String", # The transcribed word.
+                    },
+                  },
+                ],
+                "text": "A String", # Required. The text content.
+              },
+              "video": { # A video content block.
+                "data": "A String", # The video content.
+                "mimeTypeString": "A String", # Flexible MIME type string of the video, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                "name": "A String", # A user-defined name for this content block. Can be referenced by the model in the final response.
+                "processingConfig": {
+                  "static": {
+                    "endOffset": "A String", # Optional. Segment end time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "30s". Must be non-negative and greater than `start_offset` if `start_offset` is set.
+                    "fps": 3.14, # Optional. Video frame-rate sampling density.
+                    "startOffset": "A String", # Optional. Segment start time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "10.5s". Must be non-negative.
+                  },
+                },
+                "processingType": "A String",
+                "resolution": "A String", # The resolution of the media.
+                "uri": "A String", # The URI of the video.
+              },
+            },
+          ],
+        },
+        "contentString": "A String", # The content of the step. A single string.
+      },
+    },
+  ],
+  "stringContent": "A String", # A string input for the interaction, it will be processed as a single text input.
+  "systemInstruction": "A String", # System instruction for the interaction.
+  "tools": [ # A list of tool declarations the model may call during interaction.
+    { # A tool that can be used by the model.
+      "codeExecution": { # A tool that can be used by the model to execute code. # A tool that can be used by the model to execute code.
+      },
+      "computerUse": { # A tool that can be used by the model to interact with the computer. # Tool to support the model interacting directly with the computer.
+        "disabledSafetyPolicies": [ # Optional. Disabled safety policies for computer use.
+          "A String",
+        ],
+        "enablePromptInjectionDetection": True or False, # Whether enable the prompt injection detection check on computer-use request.
+        "environment": "A String", # The environment being operated.
+        "excludedPredefinedFunctions": [ # The list of predefined functions that are excluded from the model call.
+          "A String",
+        ],
+      },
+      "fileSearch": { # A tool that can be used by the model to search files. # A tool that can be used by the model to search files.
+        "fileSearchStoreNames": [ # The file search store names to search.
+          "A String",
+        ],
+        "metadataFilter": "A String", # Metadata filter to apply to the semantic retrieval documents and chunks.
+        "topK": 42, # The number of semantic retrieval chunks to retrieve.
+      },
+      "function": { # A tool that can be used by the model. # A function that can be used by the model.
+        "description": "A String", # A description of the function.
+        "name": "A String", # The name of the function.
+        "parameters": { # `Value` represents a dynamically typed value which can be either null, a number, a string, a boolean, a recursive struct value, or a list of values. A producer of value is expected to set one of these variants. Absence of any variant indicates an error. # The JSON Schema for the function's parameters.
+          "boolValue": True or False, # Represents a boolean value.
+          "contentValue": { # The content of the response. # Represents rich content (text, image, etc.).
+            "audio": { # An audio content block.
+              "channels": 42, # The number of audio channels.
+              "data": "A String", # The audio content.
+              "mimeTypeString": "A String", # Flexible MIME type string of the audio, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+              "sampleRate": 42, # The sample rate of the audio.
+              "uri": "A String", # The URI of the audio.
+            },
+            "document": { # A document content block.
+              "data": "A String", # The document content.
+              "mimeTypeString": "A String", # Flexible MIME type string of the document, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+              "uri": "A String", # The URI of the document.
+            },
+            "image": { # An image content block.
+              "data": "A String", # The image content.
+              "mimeTypeString": "A String", # Flexible MIME type string of the image, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+              "resolution": "A String", # The resolution of the media.
+              "uri": "A String", # The URI of the image.
+            },
+            "text": { # A text content block.
+              "annotations": [ # Citation information for model-generated content.
+                { # Citation information for model-generated content.
+                  "endIndex": 42, # End of the attributed segment, exclusive.
+                  "fileCitation": { # A file citation annotation. # A file citation annotation.
+                    "customMetadata": { # User provided metadata about the retrieved context.
+                      "a_key": "", # Properties of the object.
+                    },
+                    "documentUri": "A String", # The URI of the file.
+                    "fileName": "A String", # The name of the file.
+                    "mediaId": "A String", # Media ID in-case of image citations, if applicable.
+                    "pageNumber": 42, # Page number of the cited document, if applicable.
+                    "source": "A String", # Source attributed for a portion of the text.
+                  },
+                  "placeCitation": { # A place citation annotation. # A place citation annotation.
+                    "name": "A String", # Title of the place.
+                    "placeId": "A String", # The ID of the place, in `places/{place_id}` format.
+                    "reviewSnippets": [ # Snippets of reviews that are used to generate answers about the features of a given place in Google Maps.
+                      { # Encapsulates a snippet of a user review that answers a question about the features of a specific place in Google Maps.
+                        "reviewId": "A String", # The ID of the review snippet.
+                        "title": "A String", # Title of the review.
+                        "url": "A String", # A link that corresponds to the user review on Google Maps.
+                      },
+                    ],
+                    "url": "A String", # URI reference of the place.
+                  },
+                  "speechMetadata": { # Speech annotation for text content. # Speech annotation for text content.
+                    "speaker": "A String", # The speaker to associate with this turn.
+                    "style": "A String", # Style instruction for the speech synthesis.
+                  },
+                  "startIndex": 42, # Start of segment of the response that is attributed to this source. Index indicates the start of the segment, measured in bytes.
+                  "urlCitation": { # A URL citation annotation. # NOTE: We use these instead of the Citation message for historical reasons. A URL citation annotation.
+                    "title": "A String", # The title of the URL.
+                    "url": "A String", # The URL.
+                  },
+                  "wordInfo": { # Word-level ASR annotation for transcription output. Carries the word text, optional timing, and optional speaker attribution. # Word-level ASR annotation with timing and speaker info.
+                    "endOffset": "A String", # End offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                    "speaker": "A String", # Optional. Speaker label for this word (e.g. "spk_1", "spk_2"). Present when diarization_mode is set in TranscriptionConfig.
+                    "startOffset": "A String", # Start offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                    "text": "A String", # The transcribed word.
+                  },
+                },
+              ],
+              "text": "A String", # Required. The text content.
+            },
+            "video": { # A video content block.
+              "data": "A String", # The video content.
+              "mimeTypeString": "A String", # Flexible MIME type string of the video, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+              "name": "A String", # A user-defined name for this content block. Can be referenced by the model in the final response.
+              "processingConfig": {
+                "static": {
+                  "endOffset": "A String", # Optional. Segment end time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "30s". Must be non-negative and greater than `start_offset` if `start_offset` is set.
+                  "fps": 3.14, # Optional. Video frame-rate sampling density.
+                  "startOffset": "A String", # Optional. Segment start time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "10.5s". Must be non-negative.
+                },
+              },
+              "processingType": "A String",
+              "resolution": "A String", # The resolution of the media.
+              "uri": "A String", # The URI of the video.
+            },
+          },
+          "listValue": { # `ListValue` is a wrapper around a repeated field of values. # Represents a repeated `Value`.
+            "values": [ # Repeated field of dynamically typed values.
+              # Object with schema name: GenaiVertexV1Value
+            ],
+          },
+          "nullValue": "A String", # Represents a null value.
+          "numberValue": 3.14, # Represents a double value.
+          "stringValue": "A String", # Represents a string value.
+          "structValue": # Object with schema name: GenaiVertexV1Struct # Represents a structured value.
+        },
+      },
+      "googleMaps": { # A tool that can be used by the model to call Google Maps. # A tool that can be used by the model to search Google Maps.
+        "enableWidget": True or False, # Whether to return a widget context token in the tool call result of the response.
+        "latitude": 3.14, # The latitude of the user's location.
+        "longitude": 3.14, # The longitude of the user's location.
+      },
+      "googleSearch": { # A tool that can be used by the model to search Google. # A tool that can be used by the model to search Google.
+        "searchTypes": [ # The types of search grounding to enable.
+          "A String",
+        ],
+      },
+      "mcpServer": { # A MCPServer is a server that can be called by the model to perform actions. # A MCPServer is a server that can be called by the model to perform actions.
+        "allowedTools": [ # The allowed tools.
+          { # The configuration for allowed tools.
+            "mode": "A String", # The mode of the tool choice.
+            "tools": [ # The names of the allowed tools.
+              "A String",
+            ],
+          },
+        ],
+        "headers": { # Optional: Fields for authentication headers, timeouts, etc., if needed.
+          "a_key": "A String",
+        },
+        "name": "A String", # The name of the MCPServer.
+        "url": "A String", # The full URL for the MCPServer endpoint. Example: "https://api.example.com/mcp"
+      },
+      "retrieval": { # A tool that can be used by the model to retrieve files. # A tool that can be used by the model to retrieve files.
+        "exaAiSearchConfig": { # Used to specify configuration for ExaAISearch. # Used to specify configuration for ExaAISearch.
+          "apiKey": "A String", # Required. The API key for ExaAiSearch.
+          "customConfig": { # Optional. This field can be used to pass any parameter from the Exa.ai Search API.
+            "a_key": "", # Properties of the object.
+          },
+        },
+        "parallelAiSearchConfig": { # Used to specify configuration for ParallelAISearch. # Used to specify configuration for ParallelAISearch.
+          "apiKey": "A String", # Optional. The API key for ParallelAiSearch.
+          "customConfig": { # Optional. Custom configs for ParallelAiSearch.
+            "a_key": "", # Properties of the object.
+          },
+        },
+        "ragStoreConfig": { # Use to specify configuration for RAG Store. # Used to specify configuration for RagStore.
+          "ragResources": [ # Optional. The representation of the rag source.
+            { # The definition of the Rag resource.
+              "ragCorpus": "A String", # Optional. RagCorpora resource name.
+              "ragFileIds": [ # Optional. rag_file_id. The files should be in the same rag_corpus set in rag_corpus field.
+                "A String",
+              ],
+            },
+          ],
+          "ragRetrievalConfig": { # Specifies the context retrieval config. # Optional. The retrieval config for the Rag query.
+            "filter": { # Config for filters. # Optional. Config for filters.
+              "metadataFilter": "A String", # Optional. String for metadata filtering.
+              "vectorDistanceThreshold": 3.14, # Optional. Only returns contexts with vector distance smaller than the threshold.
+              "vectorSimilarityThreshold": 3.14, # Optional. Only returns contexts with vector similarity larger than the threshold.
+            },
+            "hybridSearch": { # Config for Hybrid Search. # Optional. Config for Hybrid Search.
+              "alpha": 3.14, # Optional. Alpha value controls the weight between dense and sparse vector search results.
+            },
+            "ranking": { # Config for ranking and reranking. # Optional. Config for ranking and reranking.
+              "rankService": { # Config for Rank Service. # Config for Rank Service.
+                "modelName": "A String", # Optional. The model name of the rank service.
+              },
+            },
+            "topK": 42, # Optional. The number of contexts to retrieve.
+          },
+        },
+        "retrievalTypes": [ # The types of file retrieval to enable.
+          "A String",
+        ],
+        "vertexAiSearchConfig": { # Used to specify configuration for VertexAISearch. # Used to specify configuration for VertexAISearch.
+          "datastores": [ # Optional. Used to specify Vertex AI Search datastores.
+            "A String",
+          ],
+          "engine": "A String", # Optional. Used to specify Vertex AI Search engine.
+        },
+      },
+      "urlContext": { # A tool that can be used by the model to fetch URL context. # A tool that can be used by the model to fetch URL context.
+      },
+    },
+  ],
+  "updated": "A String", # Required. Output only. The time at which the response was last updated in ISO 8601 format (YYYY-MM-DDThh:mm:ssZ).
+  "usage": { # Statistics on the interaction request's token usage. # Output only. Statistics on the interaction request's token usage.
+    "cachedTokensByModality": [ # A breakdown of cached token usage by modality.
+      { # The token count for a single response modality.
+        "modality": "A String", # The modality associated with the token count.
+        "tokens": 42, # Number of tokens for the modality.
+      },
+    ],
+    "groundingToolCount": [ # Grounding tool count.
+      { # The number of grounding tool counts.
+        "count": 42, # The number of grounding tool counts.
+        "type": "A String", # The grounding tool type associated with the count.
+      },
+    ],
+    "inputTokensByModality": [ # A breakdown of input token usage by modality.
+      { # The token count for a single response modality.
+        "modality": "A String", # The modality associated with the token count.
+        "tokens": 42, # Number of tokens for the modality.
+      },
+    ],
+    "outputTokensByModality": [ # A breakdown of output token usage by modality.
+      { # The token count for a single response modality.
+        "modality": "A String", # The modality associated with the token count.
+        "tokens": 42, # Number of tokens for the modality.
+      },
+    ],
+    "toolUseTokensByModality": [ # A breakdown of tool-use token usage by modality.
+      { # The token count for a single response modality.
+        "modality": "A String", # The modality associated with the token count.
+        "tokens": 42, # Number of tokens for the modality.
+      },
+    ],
+    "totalCachedTokens": 42, # Number of tokens in the cached part of the prompt (the cached content).
+    "totalInputTokens": 42, # Number of tokens in the prompt (context).
+    "totalOutputTokens": 42, # Total number of tokens across all the generated responses.
+    "totalThoughtTokens": 42, # Number of tokens of thoughts for thinking models.
+    "totalTokens": 42, # Total token count for the interaction request (prompt + responses + other internal tokens).
+    "totalToolUseTokens": 42, # Number of tokens present in tool-use prompt(s).
+  },
+}
+
+ +
+ close() + 
Close httplib2 connections.
+
+ +
+ getPoll(name, lastEventId=None, stream=None, x__xgafv=None) + 
Fully typed proto, unary version of GetInteraction that returns Interaction proto.
+
+Args:
+  name: string, Required. The name of the interaction to retrieve. Format: interactions/{interaction} (required)
+  lastEventId: string, If set, resumes the interaction stream from the chunk after the event marked by the event id. Can only be used if `stream` is true.
+  stream: boolean, If true, streams the interaction events as Server-Sent Events.
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # Response for InteractionService.CreateInteraction.
+  "agentInteraction": { # Interaction for generating the completion using agents. # Interaction for generating the completion using agents.
+    "agent": "A String", # The name of the `Agent` used for generating the completion.
+    "antigravityConfig": { # Configuration for the Antigravity agent runtime. Provides server-side control over the agent's execution environment and tool configuration. # Antigravity agent configuration. This configuration is session-level settings that are passed to the agent runtime on a per-request basis.
+      "maxTotalTokens": "A String", # Max total tokens for the agent run.
+      "model": "A String", # The model to use for agent reasoning.
+    },
+    "codeMenderConfig": { # Configuration for the CodeMender agent.
+      "findRequest": { # Request parameters specific to FIND sessions, used for discovering vulnerabilities in a codebase. # Parameters for finding vulnerabilities.
+        "description": "A String", # Additional context or custom instructions provided by the user to guide the vulnerability analysis.
+        "findingId": "A String", # The identifier of a specific finding to verify. This is primarily used in VERIFY mode to focus the agent's execution-based validation on a single vulnerability.
+        "mode": "A String", # The mode of the find session.
+        "sourceFiles": [ # A list of source files to provide as context for the scan.
+          { # Content of a single file in the codebase.
+            "content": "A String", # The UTF-8 encoded text content of the file.
+            "path": "A String", # The relative path of the file from the project root.
+          },
+        ],
+      },
+      "fixRequest": { # Request parameters specific to FIX sessions, used for generating and validating security patches. # Parameters for fixing vulnerabilities.
+        "description": "A String", # Additional context or custom instructions provided by the user to guide the patch generation process.
+        "findingId": "A String", # The identifier of the specific security finding to be remediated. This ID maps to a previously discovered vulnerability.
+        "sourceFiles": [ # A list of source files providing context for the remediation. These files are typically the ones containing the identified vulnerability.
+          { # Content of a single file in the codebase.
+            "content": "A String", # The UTF-8 encoded text content of the file.
+            "path": "A String", # The relative path of the file from the project root.
+          },
+        ],
+      },
+      "model": "A String", # The name of the model to use for the CodeMender agent. One CodeMender session will only use one model.
+      "sessionConfig": { # The configuration of CodeMender sessions. # Optional session-specific configurations to override default agent behavior.
+        "maxRounds": 42, # The maximum number of interaction rounds the agent is allowed to perform before reaching a timeout.
+      },
+      "sessionId": "A String", # Parameter for grouping multiple interactions that belong to the same CodeMender session.
+    },
+    "deepResearchConfig": { # Configuration for the Deep Research agent.
+      "collaborativePlanning": True or False, # Enables human-in-the-loop planning for the Deep Research agent. If set to true, the Deep Research agent will provide a research plan in its response. The agent will then proceed only if the user confirms the plan in the next turn.
+      "enableBigqueryTool": True or False, # Enables bigquery tool for the Deep Research agent.
+      "thinkingSummaries": "A String", # Whether to include thought summaries in the response.
+      "visualization": "A String", # Whether to include visualizations in the response.
+    },
+    "dynamicConfig": { # Configuration for dynamic agents.
+      "config": { # `Struct` represents a structured data value, consisting of fields which map to dynamically typed values. # For agents that are not supported statically in the API definition.
+        "fields": [ # Dynamically typed fields. List instead of map because LLMs are sensitive to ordering, and we want to give users full control.
+          { # Represents a single field in a struct.
+            "name": "A String",
+            "value": { # `Value` represents a dynamically typed value which can be either null, a number, a string, a boolean, a recursive struct value, or a list of values. A producer of value is expected to set one of these variants. Absence of any variant indicates an error.
+              "boolValue": True or False, # Represents a boolean value.
+              "contentValue": { # The content of the response. # Represents rich content (text, image, etc.).
+                "audio": { # An audio content block.
+                  "channels": 42, # The number of audio channels.
+                  "data": "A String", # The audio content.
+                  "mimeTypeString": "A String", # Flexible MIME type string of the audio, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                  "sampleRate": 42, # The sample rate of the audio.
+                  "uri": "A String", # The URI of the audio.
+                },
+                "document": { # A document content block.
+                  "data": "A String", # The document content.
+                  "mimeTypeString": "A String", # Flexible MIME type string of the document, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                  "uri": "A String", # The URI of the document.
+                },
+                "image": { # An image content block.
+                  "data": "A String", # The image content.
+                  "mimeTypeString": "A String", # Flexible MIME type string of the image, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                  "resolution": "A String", # The resolution of the media.
+                  "uri": "A String", # The URI of the image.
+                },
+                "text": { # A text content block.
+                  "annotations": [ # Citation information for model-generated content.
+                    { # Citation information for model-generated content.
+                      "endIndex": 42, # End of the attributed segment, exclusive.
+                      "fileCitation": { # A file citation annotation. # A file citation annotation.
+                        "customMetadata": { # User provided metadata about the retrieved context.
+                          "a_key": "", # Properties of the object.
+                        },
+                        "documentUri": "A String", # The URI of the file.
+                        "fileName": "A String", # The name of the file.
+                        "mediaId": "A String", # Media ID in-case of image citations, if applicable.
+                        "pageNumber": 42, # Page number of the cited document, if applicable.
+                        "source": "A String", # Source attributed for a portion of the text.
+                      },
+                      "placeCitation": { # A place citation annotation. # A place citation annotation.
+                        "name": "A String", # Title of the place.
+                        "placeId": "A String", # The ID of the place, in `places/{place_id}` format.
+                        "reviewSnippets": [ # Snippets of reviews that are used to generate answers about the features of a given place in Google Maps.
+                          { # Encapsulates a snippet of a user review that answers a question about the features of a specific place in Google Maps.
+                            "reviewId": "A String", # The ID of the review snippet.
+                            "title": "A String", # Title of the review.
+                            "url": "A String", # A link that corresponds to the user review on Google Maps.
+                          },
+                        ],
+                        "url": "A String", # URI reference of the place.
+                      },
+                      "speechMetadata": { # Speech annotation for text content. # Speech annotation for text content.
+                        "speaker": "A String", # The speaker to associate with this turn.
+                        "style": "A String", # Style instruction for the speech synthesis.
+                      },
+                      "startIndex": 42, # Start of segment of the response that is attributed to this source. Index indicates the start of the segment, measured in bytes.
+                      "urlCitation": { # A URL citation annotation. # NOTE: We use these instead of the Citation message for historical reasons. A URL citation annotation.
+                        "title": "A String", # The title of the URL.
+                        "url": "A String", # The URL.
+                      },
+                      "wordInfo": { # Word-level ASR annotation for transcription output. Carries the word text, optional timing, and optional speaker attribution. # Word-level ASR annotation with timing and speaker info.
+                        "endOffset": "A String", # End offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                        "speaker": "A String", # Optional. Speaker label for this word (e.g. "spk_1", "spk_2"). Present when diarization_mode is set in TranscriptionConfig.
+                        "startOffset": "A String", # Start offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                        "text": "A String", # The transcribed word.
+                      },
+                    },
+                  ],
+                  "text": "A String", # Required. The text content.
+                },
+                "video": { # A video content block.
+                  "data": "A String", # The video content.
+                  "mimeTypeString": "A String", # Flexible MIME type string of the video, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                  "name": "A String", # A user-defined name for this content block. Can be referenced by the model in the final response.
+                  "processingConfig": {
+                    "static": {
+                      "endOffset": "A String", # Optional. Segment end time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "30s". Must be non-negative and greater than `start_offset` if `start_offset` is set.
+                      "fps": 3.14, # Optional. Video frame-rate sampling density.
+                      "startOffset": "A String", # Optional. Segment start time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "10.5s". Must be non-negative.
+                    },
+                  },
+                  "processingType": "A String",
+                  "resolution": "A String", # The resolution of the media.
+                  "uri": "A String", # The URI of the video.
+                },
+              },
+              "listValue": { # `ListValue` is a wrapper around a repeated field of values. # Represents a repeated `Value`.
+                "values": [ # Repeated field of dynamically typed values.
+                  # Object with schema name: GenaiVertexV1Value
+                ],
+              },
+              "nullValue": "A String", # Represents a null value.
+              "numberValue": 3.14, # Represents a double value.
+              "stringValue": "A String", # Represents a string value.
+              "structValue": # Object with schema name: GenaiVertexV1Struct # Represents a structured value.
+            },
+          },
+        ],
+      },
+    },
+  },
+  "content": { # The content of the response. # The content for the interaction.
+    "audio": { # An audio content block.
+      "channels": 42, # The number of audio channels.
+      "data": "A String", # The audio content.
+      "mimeTypeString": "A String", # Flexible MIME type string of the audio, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+      "sampleRate": 42, # The sample rate of the audio.
+      "uri": "A String", # The URI of the audio.
+    },
+    "document": { # A document content block.
+      "data": "A String", # The document content.
+      "mimeTypeString": "A String", # Flexible MIME type string of the document, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+      "uri": "A String", # The URI of the document.
+    },
+    "image": { # An image content block.
+      "data": "A String", # The image content.
+      "mimeTypeString": "A String", # Flexible MIME type string of the image, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+      "resolution": "A String", # The resolution of the media.
+      "uri": "A String", # The URI of the image.
+    },
+    "text": { # A text content block.
+      "annotations": [ # Citation information for model-generated content.
+        { # Citation information for model-generated content.
+          "endIndex": 42, # End of the attributed segment, exclusive.
+          "fileCitation": { # A file citation annotation. # A file citation annotation.
+            "customMetadata": { # User provided metadata about the retrieved context.
+              "a_key": "", # Properties of the object.
+            },
+            "documentUri": "A String", # The URI of the file.
+            "fileName": "A String", # The name of the file.
+            "mediaId": "A String", # Media ID in-case of image citations, if applicable.
+            "pageNumber": 42, # Page number of the cited document, if applicable.
+            "source": "A String", # Source attributed for a portion of the text.
+          },
+          "placeCitation": { # A place citation annotation. # A place citation annotation.
+            "name": "A String", # Title of the place.
+            "placeId": "A String", # The ID of the place, in `places/{place_id}` format.
+            "reviewSnippets": [ # Snippets of reviews that are used to generate answers about the features of a given place in Google Maps.
+              { # Encapsulates a snippet of a user review that answers a question about the features of a specific place in Google Maps.
+                "reviewId": "A String", # The ID of the review snippet.
+                "title": "A String", # Title of the review.
+                "url": "A String", # A link that corresponds to the user review on Google Maps.
+              },
+            ],
+            "url": "A String", # URI reference of the place.
+          },
+          "speechMetadata": { # Speech annotation for text content. # Speech annotation for text content.
+            "speaker": "A String", # The speaker to associate with this turn.
+            "style": "A String", # Style instruction for the speech synthesis.
+          },
+          "startIndex": 42, # Start of segment of the response that is attributed to this source. Index indicates the start of the segment, measured in bytes.
+          "urlCitation": { # A URL citation annotation. # NOTE: We use these instead of the Citation message for historical reasons. A URL citation annotation.
+            "title": "A String", # The title of the URL.
+            "url": "A String", # The URL.
+          },
+          "wordInfo": { # Word-level ASR annotation for transcription output. Carries the word text, optional timing, and optional speaker attribution. # Word-level ASR annotation with timing and speaker info.
+            "endOffset": "A String", # End offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+            "speaker": "A String", # Optional. Speaker label for this word (e.g. "spk_1", "spk_2"). Present when diarization_mode is set in TranscriptionConfig.
+            "startOffset": "A String", # Start offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+            "text": "A String", # The transcribed word.
+          },
+        },
+      ],
+      "text": "A String", # Required. The text content.
+    },
+    "video": { # A video content block.
+      "data": "A String", # The video content.
+      "mimeTypeString": "A String", # Flexible MIME type string of the video, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+      "name": "A String", # A user-defined name for this content block. Can be referenced by the model in the final response.
+      "processingConfig": {
+        "static": {
+          "endOffset": "A String", # Optional. Segment end time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "30s". Must be non-negative and greater than `start_offset` if `start_offset` is set.
+          "fps": 3.14, # Optional. Video frame-rate sampling density.
+          "startOffset": "A String", # Optional. Segment start time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "10.5s". Must be non-negative.
+        },
+      },
+      "processingType": "A String",
+      "resolution": "A String", # The resolution of the media.
+      "uri": "A String", # The URI of the video.
+    },
+  },
+  "created": "A String", # Required. Output only. The time at which the response was created in ISO 8601 format (YYYY-MM-DDThh:mm:ssZ).
+  "envId": "A String", # The environment ID for the interaction. Can be 'remote' for default environment.
+  "environmentId": "A String", # Output only. The environment ID for the interaction. Only populated if environment config is set in the request.
+  "errors": [ # Output only. Diagnostic faults / platform errors recorded on the interaction.
+    { # Error message from an interaction.
+      "code": "A String", # A URI that identifies the error type.
+      "message": "A String", # A human-readable error message.
+    },
+  ],
+  "id": "A String", # Required. Output only. A unique identifier for the interaction completion.
+  "labels": { # The labels with user-defined metadata for the request. 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",
+  },
+  "modelInteraction": { # Interaction for generating the completion using models. # Interaction for generating the completion using models.
+    "generationConfig": { # Configuration parameters for model interactions. # Input only. Configuration parameters for the model interaction.
+      "maxOutputTokens": 42, # The maximum number of tokens to include in the response.
+      "seed": 42, # Seed used in decoding for reproducibility.
+      "stopSequences": [ # A list of character sequences that will stop output interaction.
+        "A String",
+      ],
+      "structuredSpeechConfig": { # Configuration for multi-speaker and speech generation. # Speech and multi-speaker configuration.
+        "speakers": [ # Individual speaker configurations.
+          { # The configuration for speech interaction.
+            "language": "A String", # The language of the speech.
+            "speaker": "A String", # The speaker's name, it should match the speaker name given in the prompt.
+            "voice": "A String", # The voice of the speaker.
+          },
+        ],
+      },
+      "temperature": 3.14, # Controls the randomness of the output.
+      "thinkingLevel": "A String", # The level of thought tokens that the model should generate.
+      "thinkingSummaries": "A String", # Whether to include thought summaries in the response.
+      "toolChoiceConfig": { # The tool choice configuration containing allowed tools. # The config for the tool choice.
+        "allowedTools": { # The configuration for allowed tools. # The allowed tools.
+          "mode": "A String", # The mode of the tool choice.
+          "tools": [ # The names of the allowed tools.
+            "A String",
+          ],
+        },
+      },
+      "toolChoiceMode": "A String", # The mode of the tool choice.
+      "topP": 3.14, # The maximum cumulative probability of tokens to consider when sampling.
+      "transcriptionConfig": { # Configuration for speech recognition (transcription). # Optional. Configuration for speech recognition (transcription). If present, ASR is enabled.
+        "adaptationPhrases": [ # Optional. A list of phrases to bias the ASR model towards.
+          "A String",
+        ],
+        "customVocabulary": [ # Optional. A list of custom vocabulary phrases to bias the speech recognition model toward recognizing specific terms.
+          "A String",
+        ],
+        "diarizationMode": "A String", # Optional. Configures speaker diarization. Supported values: "speaker".
+        "languageCodes": [ # Optional. BCP-47 language codes providing hints about the languages present in the audio. If omitted or empty, defaults to automatic language detection.
+          "A String",
+        ],
+        "timestampGranularities": [ # Optional. The granularity of timestamps to include in the transcription output. Supported values: "word". If empty, no timestamps are generated.
+          "A String",
+        ],
+      },
+      "videoConfig": { # Configuration options for video generation. # Configuration for video generation.
+        "task": "A String", # Optional task mode for video generation. If not specified, the model automatically determines the appropriate mode based on the provided text prompt and input media.
+      },
+    },
+    "model": "A String", # The name of the `Model` used for generating the completion.
+  },
+  "previousInteractionId": "A String", # The ID of the previous interaction, if any.
+  "responseFormatList": {
+    "responseFormats": [
+      {
+        "audio": { # Configuration for audio output format.
+          "bitRate": 42, # Bit rate in bits per second (bps). Only applicable for compressed formats (MP3, Opus).
+          "delivery": "A String", # The delivery mode for the audio output.
+          "mimeType": "A String", # The MIME type of the audio output.
+          "sampleRate": 42, # Sample rate in Hz.
+        },
+        "image": { # Configuration for image output format.
+          "aspectRatio": "A String", # The aspect ratio for the image output.
+          "delivery": "A String", # The delivery mode for the image output.
+          "imageSize": "A String", # The size of the image output.
+          "mimeType": "A String", # The MIME type of the image output.
+        },
+        "structValue": { # `Struct` represents a structured data value, consisting of fields which map to dynamically typed values. # Multi-discriminator values is already enabled in GAOS
+          "fields": [ # Dynamically typed fields. List instead of map because LLMs are sensitive to ordering, and we want to give users full control.
+            { # Represents a single field in a struct.
+              "name": "A String",
+              "value": { # `Value` represents a dynamically typed value which can be either null, a number, a string, a boolean, a recursive struct value, or a list of values. A producer of value is expected to set one of these variants. Absence of any variant indicates an error.
+                "boolValue": True or False, # Represents a boolean value.
+                "contentValue": { # The content of the response. # Represents rich content (text, image, etc.).
+                  "audio": { # An audio content block.
+                    "channels": 42, # The number of audio channels.
+                    "data": "A String", # The audio content.
+                    "mimeTypeString": "A String", # Flexible MIME type string of the audio, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                    "sampleRate": 42, # The sample rate of the audio.
+                    "uri": "A String", # The URI of the audio.
+                  },
+                  "document": { # A document content block.
+                    "data": "A String", # The document content.
+                    "mimeTypeString": "A String", # Flexible MIME type string of the document, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                    "uri": "A String", # The URI of the document.
+                  },
+                  "image": { # An image content block.
+                    "data": "A String", # The image content.
+                    "mimeTypeString": "A String", # Flexible MIME type string of the image, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                    "resolution": "A String", # The resolution of the media.
+                    "uri": "A String", # The URI of the image.
+                  },
+                  "text": { # A text content block.
+                    "annotations": [ # Citation information for model-generated content.
+                      { # Citation information for model-generated content.
+                        "endIndex": 42, # End of the attributed segment, exclusive.
+                        "fileCitation": { # A file citation annotation. # A file citation annotation.
+                          "customMetadata": { # User provided metadata about the retrieved context.
+                            "a_key": "", # Properties of the object.
+                          },
+                          "documentUri": "A String", # The URI of the file.
+                          "fileName": "A String", # The name of the file.
+                          "mediaId": "A String", # Media ID in-case of image citations, if applicable.
+                          "pageNumber": 42, # Page number of the cited document, if applicable.
+                          "source": "A String", # Source attributed for a portion of the text.
+                        },
+                        "placeCitation": { # A place citation annotation. # A place citation annotation.
+                          "name": "A String", # Title of the place.
+                          "placeId": "A String", # The ID of the place, in `places/{place_id}` format.
+                          "reviewSnippets": [ # Snippets of reviews that are used to generate answers about the features of a given place in Google Maps.
+                            { # Encapsulates a snippet of a user review that answers a question about the features of a specific place in Google Maps.
+                              "reviewId": "A String", # The ID of the review snippet.
+                              "title": "A String", # Title of the review.
+                              "url": "A String", # A link that corresponds to the user review on Google Maps.
+                            },
+                          ],
+                          "url": "A String", # URI reference of the place.
+                        },
+                        "speechMetadata": { # Speech annotation for text content. # Speech annotation for text content.
+                          "speaker": "A String", # The speaker to associate with this turn.
+                          "style": "A String", # Style instruction for the speech synthesis.
+                        },
+                        "startIndex": 42, # Start of segment of the response that is attributed to this source. Index indicates the start of the segment, measured in bytes.
+                        "urlCitation": { # A URL citation annotation. # NOTE: We use these instead of the Citation message for historical reasons. A URL citation annotation.
+                          "title": "A String", # The title of the URL.
+                          "url": "A String", # The URL.
+                        },
+                        "wordInfo": { # Word-level ASR annotation for transcription output. Carries the word text, optional timing, and optional speaker attribution. # Word-level ASR annotation with timing and speaker info.
+                          "endOffset": "A String", # End offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                          "speaker": "A String", # Optional. Speaker label for this word (e.g. "spk_1", "spk_2"). Present when diarization_mode is set in TranscriptionConfig.
+                          "startOffset": "A String", # Start offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                          "text": "A String", # The transcribed word.
+                        },
+                      },
+                    ],
+                    "text": "A String", # Required. The text content.
+                  },
+                  "video": { # A video content block.
+                    "data": "A String", # The video content.
+                    "mimeTypeString": "A String", # Flexible MIME type string of the video, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                    "name": "A String", # A user-defined name for this content block. Can be referenced by the model in the final response.
+                    "processingConfig": {
+                      "static": {
+                        "endOffset": "A String", # Optional. Segment end time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "30s". Must be non-negative and greater than `start_offset` if `start_offset` is set.
+                        "fps": 3.14, # Optional. Video frame-rate sampling density.
+                        "startOffset": "A String", # Optional. Segment start time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "10.5s". Must be non-negative.
+                      },
+                    },
+                    "processingType": "A String",
+                    "resolution": "A String", # The resolution of the media.
+                    "uri": "A String", # The URI of the video.
+                  },
+                },
+                "listValue": { # `ListValue` is a wrapper around a repeated field of values. # Represents a repeated `Value`.
+                  "values": [ # Repeated field of dynamically typed values.
+                    # Object with schema name: GenaiVertexV1Value
+                  ],
+                },
+                "nullValue": "A String", # Represents a null value.
+                "numberValue": 3.14, # Represents a double value.
+                "stringValue": "A String", # Represents a string value.
+                "structValue": # Object with schema name: GenaiVertexV1Struct # Represents a structured value.
+              },
+            },
+          ],
+        },
+        "text": { # Configuration for text output format.
+          "mimeType": "A String", # The MIME type of the text output.
+          "schema": { # `Struct` represents a structured data value, consisting of fields which map to dynamically typed values. # The JSON schema that the output should conform to. Only applicable when mime_type is application/json.
+            "fields": [ # Dynamically typed fields. List instead of map because LLMs are sensitive to ordering, and we want to give users full control.
+              { # Represents a single field in a struct.
+                "name": "A String",
+                "value": { # `Value` represents a dynamically typed value which can be either null, a number, a string, a boolean, a recursive struct value, or a list of values. A producer of value is expected to set one of these variants. Absence of any variant indicates an error.
+                  "boolValue": True or False, # Represents a boolean value.
+                  "contentValue": { # The content of the response. # Represents rich content (text, image, etc.).
+                    "audio": { # An audio content block.
+                      "channels": 42, # The number of audio channels.
+                      "data": "A String", # The audio content.
+                      "mimeTypeString": "A String", # Flexible MIME type string of the audio, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                      "sampleRate": 42, # The sample rate of the audio.
+                      "uri": "A String", # The URI of the audio.
+                    },
+                    "document": { # A document content block.
+                      "data": "A String", # The document content.
+                      "mimeTypeString": "A String", # Flexible MIME type string of the document, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                      "uri": "A String", # The URI of the document.
+                    },
+                    "image": { # An image content block.
+                      "data": "A String", # The image content.
+                      "mimeTypeString": "A String", # Flexible MIME type string of the image, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                      "resolution": "A String", # The resolution of the media.
+                      "uri": "A String", # The URI of the image.
+                    },
+                    "text": { # A text content block.
+                      "annotations": [ # Citation information for model-generated content.
+                        { # Citation information for model-generated content.
+                          "endIndex": 42, # End of the attributed segment, exclusive.
+                          "fileCitation": { # A file citation annotation. # A file citation annotation.
+                            "customMetadata": { # User provided metadata about the retrieved context.
+                              "a_key": "", # Properties of the object.
+                            },
+                            "documentUri": "A String", # The URI of the file.
+                            "fileName": "A String", # The name of the file.
+                            "mediaId": "A String", # Media ID in-case of image citations, if applicable.
+                            "pageNumber": 42, # Page number of the cited document, if applicable.
+                            "source": "A String", # Source attributed for a portion of the text.
+                          },
+                          "placeCitation": { # A place citation annotation. # A place citation annotation.
+                            "name": "A String", # Title of the place.
+                            "placeId": "A String", # The ID of the place, in `places/{place_id}` format.
+                            "reviewSnippets": [ # Snippets of reviews that are used to generate answers about the features of a given place in Google Maps.
+                              { # Encapsulates a snippet of a user review that answers a question about the features of a specific place in Google Maps.
+                                "reviewId": "A String", # The ID of the review snippet.
+                                "title": "A String", # Title of the review.
+                                "url": "A String", # A link that corresponds to the user review on Google Maps.
+                              },
+                            ],
+                            "url": "A String", # URI reference of the place.
+                          },
+                          "speechMetadata": { # Speech annotation for text content. # Speech annotation for text content.
+                            "speaker": "A String", # The speaker to associate with this turn.
+                            "style": "A String", # Style instruction for the speech synthesis.
+                          },
+                          "startIndex": 42, # Start of segment of the response that is attributed to this source. Index indicates the start of the segment, measured in bytes.
+                          "urlCitation": { # A URL citation annotation. # NOTE: We use these instead of the Citation message for historical reasons. A URL citation annotation.
+                            "title": "A String", # The title of the URL.
+                            "url": "A String", # The URL.
+                          },
+                          "wordInfo": { # Word-level ASR annotation for transcription output. Carries the word text, optional timing, and optional speaker attribution. # Word-level ASR annotation with timing and speaker info.
+                            "endOffset": "A String", # End offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                            "speaker": "A String", # Optional. Speaker label for this word (e.g. "spk_1", "spk_2"). Present when diarization_mode is set in TranscriptionConfig.
+                            "startOffset": "A String", # Start offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                            "text": "A String", # The transcribed word.
+                          },
+                        },
+                      ],
+                      "text": "A String", # Required. The text content.
+                    },
+                    "video": { # A video content block.
+                      "data": "A String", # The video content.
+                      "mimeTypeString": "A String", # Flexible MIME type string of the video, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                      "name": "A String", # A user-defined name for this content block. Can be referenced by the model in the final response.
+                      "processingConfig": {
+                        "static": {
+                          "endOffset": "A String", # Optional. Segment end time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "30s". Must be non-negative and greater than `start_offset` if `start_offset` is set.
+                          "fps": 3.14, # Optional. Video frame-rate sampling density.
+                          "startOffset": "A String", # Optional. Segment start time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "10.5s". Must be non-negative.
+                        },
+                      },
+                      "processingType": "A String",
+                      "resolution": "A String", # The resolution of the media.
+                      "uri": "A String", # The URI of the video.
+                    },
+                  },
+                  "listValue": { # `ListValue` is a wrapper around a repeated field of values. # Represents a repeated `Value`.
+                    "values": [ # Repeated field of dynamically typed values.
+                      # Object with schema name: GenaiVertexV1Value
+                    ],
+                  },
+                  "nullValue": "A String", # Represents a null value.
+                  "numberValue": 3.14, # Represents a double value.
+                  "stringValue": "A String", # Represents a string value.
+                  "structValue": # Object with schema name: GenaiVertexV1Struct # Represents a structured value.
+                },
+              },
+            ],
+          },
+        },
+        "video": { # Configuration for video output format.
+          "aspectRatio": "A String", # The aspect ratio for the video output.
+          "delivery": "A String", # The delivery mode for the video output.
+          "duration": "A String", # The duration for the video output.
+          "gcsUri": "A String", # The Cloud Storage URI to store the video output. Required for Vertex if delivery mode is URI.
+          "resolution": "A String", # The video output resolution. Defaults to 720p.
+        },
+      },
+    ],
+  },
+  "responseFormatSingleton": {
+    "audio": { # Configuration for audio output format.
+      "bitRate": 42, # Bit rate in bits per second (bps). Only applicable for compressed formats (MP3, Opus).
+      "delivery": "A String", # The delivery mode for the audio output.
+      "mimeType": "A String", # The MIME type of the audio output.
+      "sampleRate": 42, # Sample rate in Hz.
+    },
+    "image": { # Configuration for image output format.
+      "aspectRatio": "A String", # The aspect ratio for the image output.
+      "delivery": "A String", # The delivery mode for the image output.
+      "imageSize": "A String", # The size of the image output.
+      "mimeType": "A String", # The MIME type of the image output.
+    },
+    "structValue": { # `Struct` represents a structured data value, consisting of fields which map to dynamically typed values. # Multi-discriminator values is already enabled in GAOS
+      "fields": [ # Dynamically typed fields. List instead of map because LLMs are sensitive to ordering, and we want to give users full control.
+        { # Represents a single field in a struct.
+          "name": "A String",
+          "value": { # `Value` represents a dynamically typed value which can be either null, a number, a string, a boolean, a recursive struct value, or a list of values. A producer of value is expected to set one of these variants. Absence of any variant indicates an error.
+            "boolValue": True or False, # Represents a boolean value.
+            "contentValue": { # The content of the response. # Represents rich content (text, image, etc.).
+              "audio": { # An audio content block.
+                "channels": 42, # The number of audio channels.
+                "data": "A String", # The audio content.
+                "mimeTypeString": "A String", # Flexible MIME type string of the audio, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                "sampleRate": 42, # The sample rate of the audio.
+                "uri": "A String", # The URI of the audio.
+              },
+              "document": { # A document content block.
+                "data": "A String", # The document content.
+                "mimeTypeString": "A String", # Flexible MIME type string of the document, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                "uri": "A String", # The URI of the document.
+              },
+              "image": { # An image content block.
+                "data": "A String", # The image content.
+                "mimeTypeString": "A String", # Flexible MIME type string of the image, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                "resolution": "A String", # The resolution of the media.
+                "uri": "A String", # The URI of the image.
+              },
+              "text": { # A text content block.
+                "annotations": [ # Citation information for model-generated content.
+                  { # Citation information for model-generated content.
+                    "endIndex": 42, # End of the attributed segment, exclusive.
+                    "fileCitation": { # A file citation annotation. # A file citation annotation.
+                      "customMetadata": { # User provided metadata about the retrieved context.
+                        "a_key": "", # Properties of the object.
+                      },
+                      "documentUri": "A String", # The URI of the file.
+                      "fileName": "A String", # The name of the file.
+                      "mediaId": "A String", # Media ID in-case of image citations, if applicable.
+                      "pageNumber": 42, # Page number of the cited document, if applicable.
+                      "source": "A String", # Source attributed for a portion of the text.
+                    },
+                    "placeCitation": { # A place citation annotation. # A place citation annotation.
+                      "name": "A String", # Title of the place.
+                      "placeId": "A String", # The ID of the place, in `places/{place_id}` format.
+                      "reviewSnippets": [ # Snippets of reviews that are used to generate answers about the features of a given place in Google Maps.
+                        { # Encapsulates a snippet of a user review that answers a question about the features of a specific place in Google Maps.
+                          "reviewId": "A String", # The ID of the review snippet.
+                          "title": "A String", # Title of the review.
+                          "url": "A String", # A link that corresponds to the user review on Google Maps.
+                        },
+                      ],
+                      "url": "A String", # URI reference of the place.
+                    },
+                    "speechMetadata": { # Speech annotation for text content. # Speech annotation for text content.
+                      "speaker": "A String", # The speaker to associate with this turn.
+                      "style": "A String", # Style instruction for the speech synthesis.
+                    },
+                    "startIndex": 42, # Start of segment of the response that is attributed to this source. Index indicates the start of the segment, measured in bytes.
+                    "urlCitation": { # A URL citation annotation. # NOTE: We use these instead of the Citation message for historical reasons. A URL citation annotation.
+                      "title": "A String", # The title of the URL.
+                      "url": "A String", # The URL.
+                    },
+                    "wordInfo": { # Word-level ASR annotation for transcription output. Carries the word text, optional timing, and optional speaker attribution. # Word-level ASR annotation with timing and speaker info.
+                      "endOffset": "A String", # End offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                      "speaker": "A String", # Optional. Speaker label for this word (e.g. "spk_1", "spk_2"). Present when diarization_mode is set in TranscriptionConfig.
+                      "startOffset": "A String", # Start offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                      "text": "A String", # The transcribed word.
+                    },
+                  },
+                ],
+                "text": "A String", # Required. The text content.
+              },
+              "video": { # A video content block.
+                "data": "A String", # The video content.
+                "mimeTypeString": "A String", # Flexible MIME type string of the video, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                "name": "A String", # A user-defined name for this content block. Can be referenced by the model in the final response.
+                "processingConfig": {
+                  "static": {
+                    "endOffset": "A String", # Optional. Segment end time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "30s". Must be non-negative and greater than `start_offset` if `start_offset` is set.
+                    "fps": 3.14, # Optional. Video frame-rate sampling density.
+                    "startOffset": "A String", # Optional. Segment start time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "10.5s". Must be non-negative.
+                  },
+                },
+                "processingType": "A String",
+                "resolution": "A String", # The resolution of the media.
+                "uri": "A String", # The URI of the video.
+              },
+            },
+            "listValue": { # `ListValue` is a wrapper around a repeated field of values. # Represents a repeated `Value`.
+              "values": [ # Repeated field of dynamically typed values.
+                # Object with schema name: GenaiVertexV1Value
+              ],
+            },
+            "nullValue": "A String", # Represents a null value.
+            "numberValue": 3.14, # Represents a double value.
+            "stringValue": "A String", # Represents a string value.
+            "structValue": # Object with schema name: GenaiVertexV1Struct # Represents a structured value.
+          },
+        },
+      ],
+    },
+    "text": { # Configuration for text output format.
+      "mimeType": "A String", # The MIME type of the text output.
+      "schema": { # `Struct` represents a structured data value, consisting of fields which map to dynamically typed values. # The JSON schema that the output should conform to. Only applicable when mime_type is application/json.
+        "fields": [ # Dynamically typed fields. List instead of map because LLMs are sensitive to ordering, and we want to give users full control.
+          { # Represents a single field in a struct.
+            "name": "A String",
+            "value": { # `Value` represents a dynamically typed value which can be either null, a number, a string, a boolean, a recursive struct value, or a list of values. A producer of value is expected to set one of these variants. Absence of any variant indicates an error.
+              "boolValue": True or False, # Represents a boolean value.
+              "contentValue": { # The content of the response. # Represents rich content (text, image, etc.).
+                "audio": { # An audio content block.
+                  "channels": 42, # The number of audio channels.
+                  "data": "A String", # The audio content.
+                  "mimeTypeString": "A String", # Flexible MIME type string of the audio, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                  "sampleRate": 42, # The sample rate of the audio.
+                  "uri": "A String", # The URI of the audio.
+                },
+                "document": { # A document content block.
+                  "data": "A String", # The document content.
+                  "mimeTypeString": "A String", # Flexible MIME type string of the document, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                  "uri": "A String", # The URI of the document.
+                },
+                "image": { # An image content block.
+                  "data": "A String", # The image content.
+                  "mimeTypeString": "A String", # Flexible MIME type string of the image, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                  "resolution": "A String", # The resolution of the media.
+                  "uri": "A String", # The URI of the image.
+                },
+                "text": { # A text content block.
+                  "annotations": [ # Citation information for model-generated content.
+                    { # Citation information for model-generated content.
+                      "endIndex": 42, # End of the attributed segment, exclusive.
+                      "fileCitation": { # A file citation annotation. # A file citation annotation.
+                        "customMetadata": { # User provided metadata about the retrieved context.
+                          "a_key": "", # Properties of the object.
+                        },
+                        "documentUri": "A String", # The URI of the file.
+                        "fileName": "A String", # The name of the file.
+                        "mediaId": "A String", # Media ID in-case of image citations, if applicable.
+                        "pageNumber": 42, # Page number of the cited document, if applicable.
+                        "source": "A String", # Source attributed for a portion of the text.
+                      },
+                      "placeCitation": { # A place citation annotation. # A place citation annotation.
+                        "name": "A String", # Title of the place.
+                        "placeId": "A String", # The ID of the place, in `places/{place_id}` format.
+                        "reviewSnippets": [ # Snippets of reviews that are used to generate answers about the features of a given place in Google Maps.
+                          { # Encapsulates a snippet of a user review that answers a question about the features of a specific place in Google Maps.
+                            "reviewId": "A String", # The ID of the review snippet.
+                            "title": "A String", # Title of the review.
+                            "url": "A String", # A link that corresponds to the user review on Google Maps.
+                          },
+                        ],
+                        "url": "A String", # URI reference of the place.
+                      },
+                      "speechMetadata": { # Speech annotation for text content. # Speech annotation for text content.
+                        "speaker": "A String", # The speaker to associate with this turn.
+                        "style": "A String", # Style instruction for the speech synthesis.
+                      },
+                      "startIndex": 42, # Start of segment of the response that is attributed to this source. Index indicates the start of the segment, measured in bytes.
+                      "urlCitation": { # A URL citation annotation. # NOTE: We use these instead of the Citation message for historical reasons. A URL citation annotation.
+                        "title": "A String", # The title of the URL.
+                        "url": "A String", # The URL.
+                      },
+                      "wordInfo": { # Word-level ASR annotation for transcription output. Carries the word text, optional timing, and optional speaker attribution. # Word-level ASR annotation with timing and speaker info.
+                        "endOffset": "A String", # End offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                        "speaker": "A String", # Optional. Speaker label for this word (e.g. "spk_1", "spk_2"). Present when diarization_mode is set in TranscriptionConfig.
+                        "startOffset": "A String", # Start offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                        "text": "A String", # The transcribed word.
+                      },
+                    },
+                  ],
+                  "text": "A String", # Required. The text content.
+                },
+                "video": { # A video content block.
+                  "data": "A String", # The video content.
+                  "mimeTypeString": "A String", # Flexible MIME type string of the video, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                  "name": "A String", # A user-defined name for this content block. Can be referenced by the model in the final response.
+                  "processingConfig": {
+                    "static": {
+                      "endOffset": "A String", # Optional. Segment end time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "30s". Must be non-negative and greater than `start_offset` if `start_offset` is set.
+                      "fps": 3.14, # Optional. Video frame-rate sampling density.
+                      "startOffset": "A String", # Optional. Segment start time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "10.5s". Must be non-negative.
+                    },
+                  },
+                  "processingType": "A String",
+                  "resolution": "A String", # The resolution of the media.
+                  "uri": "A String", # The URI of the video.
+                },
+              },
+              "listValue": { # `ListValue` is a wrapper around a repeated field of values. # Represents a repeated `Value`.
+                "values": [ # Repeated field of dynamically typed values.
+                  # Object with schema name: GenaiVertexV1Value
+                ],
+              },
+              "nullValue": "A String", # Represents a null value.
+              "numberValue": 3.14, # Represents a double value.
+              "stringValue": "A String", # Represents a string value.
+              "structValue": # Object with schema name: GenaiVertexV1Struct # Represents a structured value.
+            },
+          },
+        ],
+      },
+    },
+    "video": { # Configuration for video output format.
+      "aspectRatio": "A String", # The aspect ratio for the video output.
+      "delivery": "A String", # The delivery mode for the video output.
+      "duration": "A String", # The duration for the video output.
+      "gcsUri": "A String", # The Cloud Storage URI to store the video output. Required for Vertex if delivery mode is URI.
+      "resolution": "A String", # The video output resolution. Defaults to 720p.
+    },
+  },
+  "safetySettings": [ # Safety settings for the interaction.
+    { # A safety setting that affects the safety-blocking behavior. A SafetySetting consists of a harm category and a threshold for that category.
+      "method": "A String", # Optional. The method for blocking content. If not specified, the default behavior is to use the probability score.
+      "threshold": "A String", # Required. The threshold for blocking content. If the harm probability exceeds this threshold, the content will be blocked.
+      "type": "A String", # Required. The type of harm category to be blocked.
+    },
+  ],
+  "serviceTier": "A String", # The service tier for the interaction.
+  "status": "A String", # Required. Output only. The status of the interaction.
+  "stepList": { # A list of Steps. # Input only. The steps for the interaction.
+    "steps": [ # The steps of the list.
+      { # A step in the interaction.
+        "modelOutput": { # Output generated by the model.
+          "content": [
+            { # The content of the response.
+              "audio": { # An audio content block.
+                "channels": 42, # The number of audio channels.
+                "data": "A String", # The audio content.
+                "mimeTypeString": "A String", # Flexible MIME type string of the audio, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                "sampleRate": 42, # The sample rate of the audio.
+                "uri": "A String", # The URI of the audio.
+              },
+              "document": { # A document content block.
+                "data": "A String", # The document content.
+                "mimeTypeString": "A String", # Flexible MIME type string of the document, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                "uri": "A String", # The URI of the document.
+              },
+              "image": { # An image content block.
+                "data": "A String", # The image content.
+                "mimeTypeString": "A String", # Flexible MIME type string of the image, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                "resolution": "A String", # The resolution of the media.
+                "uri": "A String", # The URI of the image.
+              },
+              "text": { # A text content block.
+                "annotations": [ # Citation information for model-generated content.
+                  { # Citation information for model-generated content.
+                    "endIndex": 42, # End of the attributed segment, exclusive.
+                    "fileCitation": { # A file citation annotation. # A file citation annotation.
+                      "customMetadata": { # User provided metadata about the retrieved context.
+                        "a_key": "", # Properties of the object.
+                      },
+                      "documentUri": "A String", # The URI of the file.
+                      "fileName": "A String", # The name of the file.
+                      "mediaId": "A String", # Media ID in-case of image citations, if applicable.
+                      "pageNumber": 42, # Page number of the cited document, if applicable.
+                      "source": "A String", # Source attributed for a portion of the text.
+                    },
+                    "placeCitation": { # A place citation annotation. # A place citation annotation.
+                      "name": "A String", # Title of the place.
+                      "placeId": "A String", # The ID of the place, in `places/{place_id}` format.
+                      "reviewSnippets": [ # Snippets of reviews that are used to generate answers about the features of a given place in Google Maps.
+                        { # Encapsulates a snippet of a user review that answers a question about the features of a specific place in Google Maps.
+                          "reviewId": "A String", # The ID of the review snippet.
+                          "title": "A String", # Title of the review.
+                          "url": "A String", # A link that corresponds to the user review on Google Maps.
+                        },
+                      ],
+                      "url": "A String", # URI reference of the place.
+                    },
+                    "speechMetadata": { # Speech annotation for text content. # Speech annotation for text content.
+                      "speaker": "A String", # The speaker to associate with this turn.
+                      "style": "A String", # Style instruction for the speech synthesis.
+                    },
+                    "startIndex": 42, # Start of segment of the response that is attributed to this source. Index indicates the start of the segment, measured in bytes.
+                    "urlCitation": { # A URL citation annotation. # NOTE: We use these instead of the Citation message for historical reasons. A URL citation annotation.
+                      "title": "A String", # The title of the URL.
+                      "url": "A String", # The URL.
+                    },
+                    "wordInfo": { # Word-level ASR annotation for transcription output. Carries the word text, optional timing, and optional speaker attribution. # Word-level ASR annotation with timing and speaker info.
+                      "endOffset": "A String", # End offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                      "speaker": "A String", # Optional. Speaker label for this word (e.g. "spk_1", "spk_2"). Present when diarization_mode is set in TranscriptionConfig.
+                      "startOffset": "A String", # Start offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                      "text": "A String", # The transcribed word.
+                    },
+                  },
+                ],
+                "text": "A String", # Required. The text content.
+              },
+              "video": { # A video content block.
+                "data": "A String", # The video content.
+                "mimeTypeString": "A String", # Flexible MIME type string of the video, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                "name": "A String", # A user-defined name for this content block. Can be referenced by the model in the final response.
+                "processingConfig": {
+                  "static": {
+                    "endOffset": "A String", # Optional. Segment end time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "30s". Must be non-negative and greater than `start_offset` if `start_offset` is set.
+                    "fps": 3.14, # Optional. Video frame-rate sampling density.
+                    "startOffset": "A String", # Optional. Segment start time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "10.5s". Must be non-negative.
+                  },
+                },
+                "processingType": "A String",
+                "resolution": "A String", # The resolution of the media.
+                "uri": "A String", # The URI of the video.
+              },
+            },
+          ],
+          "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.
+          },
+        },
+        "thought": { # A thought step.
+          "signature": "A String", # A signature hash for backend validation.
+          "summary": [ # A summary of the thought.
+            { # The content of the response.
+              "audio": { # An audio content block.
+                "channels": 42, # The number of audio channels.
+                "data": "A String", # The audio content.
+                "mimeTypeString": "A String", # Flexible MIME type string of the audio, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                "sampleRate": 42, # The sample rate of the audio.
+                "uri": "A String", # The URI of the audio.
+              },
+              "document": { # A document content block.
+                "data": "A String", # The document content.
+                "mimeTypeString": "A String", # Flexible MIME type string of the document, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                "uri": "A String", # The URI of the document.
+              },
+              "image": { # An image content block.
+                "data": "A String", # The image content.
+                "mimeTypeString": "A String", # Flexible MIME type string of the image, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                "resolution": "A String", # The resolution of the media.
+                "uri": "A String", # The URI of the image.
+              },
+              "text": { # A text content block.
+                "annotations": [ # Citation information for model-generated content.
+                  { # Citation information for model-generated content.
+                    "endIndex": 42, # End of the attributed segment, exclusive.
+                    "fileCitation": { # A file citation annotation. # A file citation annotation.
+                      "customMetadata": { # User provided metadata about the retrieved context.
+                        "a_key": "", # Properties of the object.
+                      },
+                      "documentUri": "A String", # The URI of the file.
+                      "fileName": "A String", # The name of the file.
+                      "mediaId": "A String", # Media ID in-case of image citations, if applicable.
+                      "pageNumber": 42, # Page number of the cited document, if applicable.
+                      "source": "A String", # Source attributed for a portion of the text.
+                    },
+                    "placeCitation": { # A place citation annotation. # A place citation annotation.
+                      "name": "A String", # Title of the place.
+                      "placeId": "A String", # The ID of the place, in `places/{place_id}` format.
+                      "reviewSnippets": [ # Snippets of reviews that are used to generate answers about the features of a given place in Google Maps.
+                        { # Encapsulates a snippet of a user review that answers a question about the features of a specific place in Google Maps.
+                          "reviewId": "A String", # The ID of the review snippet.
+                          "title": "A String", # Title of the review.
+                          "url": "A String", # A link that corresponds to the user review on Google Maps.
+                        },
+                      ],
+                      "url": "A String", # URI reference of the place.
+                    },
+                    "speechMetadata": { # Speech annotation for text content. # Speech annotation for text content.
+                      "speaker": "A String", # The speaker to associate with this turn.
+                      "style": "A String", # Style instruction for the speech synthesis.
+                    },
+                    "startIndex": 42, # Start of segment of the response that is attributed to this source. Index indicates the start of the segment, measured in bytes.
+                    "urlCitation": { # A URL citation annotation. # NOTE: We use these instead of the Citation message for historical reasons. A URL citation annotation.
+                      "title": "A String", # The title of the URL.
+                      "url": "A String", # The URL.
+                    },
+                    "wordInfo": { # Word-level ASR annotation for transcription output. Carries the word text, optional timing, and optional speaker attribution. # Word-level ASR annotation with timing and speaker info.
+                      "endOffset": "A String", # End offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                      "speaker": "A String", # Optional. Speaker label for this word (e.g. "spk_1", "spk_2"). Present when diarization_mode is set in TranscriptionConfig.
+                      "startOffset": "A String", # Start offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                      "text": "A String", # The transcribed word.
+                    },
+                  },
+                ],
+                "text": "A String", # Required. The text content.
+              },
+              "video": { # A video content block.
+                "data": "A String", # The video content.
+                "mimeTypeString": "A String", # Flexible MIME type string of the video, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                "name": "A String", # A user-defined name for this content block. Can be referenced by the model in the final response.
+                "processingConfig": {
+                  "static": {
+                    "endOffset": "A String", # Optional. Segment end time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "30s". Must be non-negative and greater than `start_offset` if `start_offset` is set.
+                    "fps": 3.14, # Optional. Video frame-rate sampling density.
+                    "startOffset": "A String", # Optional. Segment start time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "10.5s". Must be non-negative.
+                  },
+                },
+                "processingType": "A String",
+                "resolution": "A String", # The resolution of the media.
+                "uri": "A String", # The URI of the video.
+              },
+            },
+          ],
+        },
+        "toolCall": { # Tool call step.
+          "codeExecutionCall": { # Code execution call step.
+            "arguments": { # The arguments to pass to the code execution. # Required. The arguments to pass to the code execution.
+              "code": "A String", # The code to be executed.
+              "language": "A String", # Programming language of the `code`.
+            },
+          },
+          "fileSearchCall": { # File Search call step.
+          },
+          "functionCall": { # A function tool call step.
+            "arguments": { # `Struct` represents a structured data value, consisting of fields which map to dynamically typed values. # Required. The arguments to pass to the function.
+              "fields": [ # Dynamically typed fields. List instead of map because LLMs are sensitive to ordering, and we want to give users full control.
+                { # Represents a single field in a struct.
+                  "name": "A String",
+                  "value": { # `Value` represents a dynamically typed value which can be either null, a number, a string, a boolean, a recursive struct value, or a list of values. A producer of value is expected to set one of these variants. Absence of any variant indicates an error.
+                    "boolValue": True or False, # Represents a boolean value.
+                    "contentValue": { # The content of the response. # Represents rich content (text, image, etc.).
+                      "audio": { # An audio content block.
+                        "channels": 42, # The number of audio channels.
+                        "data": "A String", # The audio content.
+                        "mimeTypeString": "A String", # Flexible MIME type string of the audio, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                        "sampleRate": 42, # The sample rate of the audio.
+                        "uri": "A String", # The URI of the audio.
+                      },
+                      "document": { # A document content block.
+                        "data": "A String", # The document content.
+                        "mimeTypeString": "A String", # Flexible MIME type string of the document, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                        "uri": "A String", # The URI of the document.
+                      },
+                      "image": { # An image content block.
+                        "data": "A String", # The image content.
+                        "mimeTypeString": "A String", # Flexible MIME type string of the image, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                        "resolution": "A String", # The resolution of the media.
+                        "uri": "A String", # The URI of the image.
+                      },
+                      "text": { # A text content block.
+                        "annotations": [ # Citation information for model-generated content.
+                          { # Citation information for model-generated content.
+                            "endIndex": 42, # End of the attributed segment, exclusive.
+                            "fileCitation": { # A file citation annotation. # A file citation annotation.
+                              "customMetadata": { # User provided metadata about the retrieved context.
+                                "a_key": "", # Properties of the object.
+                              },
+                              "documentUri": "A String", # The URI of the file.
+                              "fileName": "A String", # The name of the file.
+                              "mediaId": "A String", # Media ID in-case of image citations, if applicable.
+                              "pageNumber": 42, # Page number of the cited document, if applicable.
+                              "source": "A String", # Source attributed for a portion of the text.
+                            },
+                            "placeCitation": { # A place citation annotation. # A place citation annotation.
+                              "name": "A String", # Title of the place.
+                              "placeId": "A String", # The ID of the place, in `places/{place_id}` format.
+                              "reviewSnippets": [ # Snippets of reviews that are used to generate answers about the features of a given place in Google Maps.
+                                { # Encapsulates a snippet of a user review that answers a question about the features of a specific place in Google Maps.
+                                  "reviewId": "A String", # The ID of the review snippet.
+                                  "title": "A String", # Title of the review.
+                                  "url": "A String", # A link that corresponds to the user review on Google Maps.
+                                },
+                              ],
+                              "url": "A String", # URI reference of the place.
+                            },
+                            "speechMetadata": { # Speech annotation for text content. # Speech annotation for text content.
+                              "speaker": "A String", # The speaker to associate with this turn.
+                              "style": "A String", # Style instruction for the speech synthesis.
+                            },
+                            "startIndex": 42, # Start of segment of the response that is attributed to this source. Index indicates the start of the segment, measured in bytes.
+                            "urlCitation": { # A URL citation annotation. # NOTE: We use these instead of the Citation message for historical reasons. A URL citation annotation.
+                              "title": "A String", # The title of the URL.
+                              "url": "A String", # The URL.
+                            },
+                            "wordInfo": { # Word-level ASR annotation for transcription output. Carries the word text, optional timing, and optional speaker attribution. # Word-level ASR annotation with timing and speaker info.
+                              "endOffset": "A String", # End offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                              "speaker": "A String", # Optional. Speaker label for this word (e.g. "spk_1", "spk_2"). Present when diarization_mode is set in TranscriptionConfig.
+                              "startOffset": "A String", # Start offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                              "text": "A String", # The transcribed word.
+                            },
+                          },
+                        ],
+                        "text": "A String", # Required. The text content.
+                      },
+                      "video": { # A video content block.
+                        "data": "A String", # The video content.
+                        "mimeTypeString": "A String", # Flexible MIME type string of the video, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                        "name": "A String", # A user-defined name for this content block. Can be referenced by the model in the final response.
+                        "processingConfig": {
+                          "static": {
+                            "endOffset": "A String", # Optional. Segment end time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "30s". Must be non-negative and greater than `start_offset` if `start_offset` is set.
+                            "fps": 3.14, # Optional. Video frame-rate sampling density.
+                            "startOffset": "A String", # Optional. Segment start time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "10.5s". Must be non-negative.
+                          },
+                        },
+                        "processingType": "A String",
+                        "resolution": "A String", # The resolution of the media.
+                        "uri": "A String", # The URI of the video.
+                      },
+                    },
+                    "listValue": { # `ListValue` is a wrapper around a repeated field of values. # Represents a repeated `Value`.
+                      "values": [ # Repeated field of dynamically typed values.
+                        # Object with schema name: GenaiVertexV1Value
+                      ],
+                    },
+                    "nullValue": "A String", # Represents a null value.
+                    "numberValue": 3.14, # Represents a double value.
+                    "stringValue": "A String", # Represents a string value.
+                    "structValue": # Object with schema name: GenaiVertexV1Struct # Represents a structured value.
+                  },
+                },
+              ],
+            },
+            "name": "A String", # Required. The name of the tool to call.
+          },
+          "googleMapsCall": { # Google Maps call step.
+            "arguments": { # The arguments to pass to the Google Maps tool. # The arguments to pass to the Google Maps tool.
+              "queries": [ # The queries to be executed.
+                "A String",
+              ],
+            },
+          },
+          "googleSearchCall": { # Google Search call step.
+            "arguments": { # The arguments to pass to Google Search. # Required. The arguments to pass to Google Search.
+              "queries": [ # Web search queries for the following-up web search.
+                "A String",
+              ],
+            },
+            "searchType": "A String", # The type of search grounding enabled.
+          },
+          "id": "A String", # Required. A unique ID for this specific tool call.
+          "processingCall": { # A server-initiated processing step for media analysis (e.g. video understanding).
+          },
+          "retrievalCall": { # Retrieval call step. Used by Vertex Retrieval tools such as Parallel AI, Exa AI, Vertex AI Search, etc. RetrievalType decides which tool is used.
+            "arguments": { # The arguments to pass to Retrieval tools. # Required. The arguments to pass to the retrieval tool.
+              "queries": [ # Queries for Retrieval information.
+                "A String",
+              ],
+            },
+            "retrievalType": "A String", # The type of retrieval tools.
+          },
+          "signature": "A String", # A signature hash for backend validation.
+          "urlContextCall": { # URL context call step.
+            "arguments": { # The arguments to pass to the URL context. # Required. The arguments to pass to the URL context.
+              "urls": [ # The URLs to fetch.
+                "A String",
+              ],
+            },
+          },
+        },
+        "toolResult": { # Tool result step.
+          "callId": "A String", # Required. ID to match the ID from the function call block.
+          "codeExecutionResult": { # Code execution result step.
+            "isError": True or False, # Whether the code execution resulted in an error.
+            "result": "A String", # Required. The output of the code execution.
+          },
+          "fileSearchResult": { # File Search result step.
+          },
+          "functionResult": { # Result of a function tool call.
+            "isError": True or False, # Whether the tool call resulted in an error.
+            "name": "A String", # The name of the tool that was called.
+            "result": { # `Value` represents a dynamically typed value which can be either null, a number, a string, a boolean, a recursive struct value, or a list of values. A producer of value is expected to set one of these variants. Absence of any variant indicates an error. # Required. The result of the tool call.
+              "boolValue": True or False, # Represents a boolean value.
+              "contentValue": { # The content of the response. # Represents rich content (text, image, etc.).
+                "audio": { # An audio content block.
+                  "channels": 42, # The number of audio channels.
+                  "data": "A String", # The audio content.
+                  "mimeTypeString": "A String", # Flexible MIME type string of the audio, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                  "sampleRate": 42, # The sample rate of the audio.
+                  "uri": "A String", # The URI of the audio.
+                },
+                "document": { # A document content block.
+                  "data": "A String", # The document content.
+                  "mimeTypeString": "A String", # Flexible MIME type string of the document, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                  "uri": "A String", # The URI of the document.
+                },
+                "image": { # An image content block.
+                  "data": "A String", # The image content.
+                  "mimeTypeString": "A String", # Flexible MIME type string of the image, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                  "resolution": "A String", # The resolution of the media.
+                  "uri": "A String", # The URI of the image.
+                },
+                "text": { # A text content block.
+                  "annotations": [ # Citation information for model-generated content.
+                    { # Citation information for model-generated content.
+                      "endIndex": 42, # End of the attributed segment, exclusive.
+                      "fileCitation": { # A file citation annotation. # A file citation annotation.
+                        "customMetadata": { # User provided metadata about the retrieved context.
+                          "a_key": "", # Properties of the object.
+                        },
+                        "documentUri": "A String", # The URI of the file.
+                        "fileName": "A String", # The name of the file.
+                        "mediaId": "A String", # Media ID in-case of image citations, if applicable.
+                        "pageNumber": 42, # Page number of the cited document, if applicable.
+                        "source": "A String", # Source attributed for a portion of the text.
+                      },
+                      "placeCitation": { # A place citation annotation. # A place citation annotation.
+                        "name": "A String", # Title of the place.
+                        "placeId": "A String", # The ID of the place, in `places/{place_id}` format.
+                        "reviewSnippets": [ # Snippets of reviews that are used to generate answers about the features of a given place in Google Maps.
+                          { # Encapsulates a snippet of a user review that answers a question about the features of a specific place in Google Maps.
+                            "reviewId": "A String", # The ID of the review snippet.
+                            "title": "A String", # Title of the review.
+                            "url": "A String", # A link that corresponds to the user review on Google Maps.
+                          },
+                        ],
+                        "url": "A String", # URI reference of the place.
+                      },
+                      "speechMetadata": { # Speech annotation for text content. # Speech annotation for text content.
+                        "speaker": "A String", # The speaker to associate with this turn.
+                        "style": "A String", # Style instruction for the speech synthesis.
+                      },
+                      "startIndex": 42, # Start of segment of the response that is attributed to this source. Index indicates the start of the segment, measured in bytes.
+                      "urlCitation": { # A URL citation annotation. # NOTE: We use these instead of the Citation message for historical reasons. A URL citation annotation.
+                        "title": "A String", # The title of the URL.
+                        "url": "A String", # The URL.
+                      },
+                      "wordInfo": { # Word-level ASR annotation for transcription output. Carries the word text, optional timing, and optional speaker attribution. # Word-level ASR annotation with timing and speaker info.
+                        "endOffset": "A String", # End offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                        "speaker": "A String", # Optional. Speaker label for this word (e.g. "spk_1", "spk_2"). Present when diarization_mode is set in TranscriptionConfig.
+                        "startOffset": "A String", # Start offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                        "text": "A String", # The transcribed word.
+                      },
+                    },
+                  ],
+                  "text": "A String", # Required. The text content.
+                },
+                "video": { # A video content block.
+                  "data": "A String", # The video content.
+                  "mimeTypeString": "A String", # Flexible MIME type string of the video, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                  "name": "A String", # A user-defined name for this content block. Can be referenced by the model in the final response.
+                  "processingConfig": {
+                    "static": {
+                      "endOffset": "A String", # Optional. Segment end time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "30s". Must be non-negative and greater than `start_offset` if `start_offset` is set.
+                      "fps": 3.14, # Optional. Video frame-rate sampling density.
+                      "startOffset": "A String", # Optional. Segment start time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "10.5s". Must be non-negative.
+                    },
+                  },
+                  "processingType": "A String",
+                  "resolution": "A String", # The resolution of the media.
+                  "uri": "A String", # The URI of the video.
+                },
+              },
+              "listValue": { # `ListValue` is a wrapper around a repeated field of values. # Represents a repeated `Value`.
+                "values": [ # Repeated field of dynamically typed values.
+                  # Object with schema name: GenaiVertexV1Value
+                ],
+              },
+              "nullValue": "A String", # Represents a null value.
+              "numberValue": 3.14, # Represents a double value.
+              "stringValue": "A String", # Represents a string value.
+              "structValue": # Object with schema name: GenaiVertexV1Struct # Represents a structured value.
+            },
+          },
+          "googleMapsResult": { # Google Maps result step.
+            "result": [
+              { # The result of the Google Maps.
+                "places": [
+                  {
+                    "name": "A String",
+                    "placeId": "A String",
+                    "reviewSnippets": [
+                      { # Encapsulates a snippet of a user review that answers a question about the features of a specific place in Google Maps.
+                        "reviewId": "A String", # The ID of the review snippet.
+                        "title": "A String", # Title of the review.
+                        "url": "A String", # A link that corresponds to the user review on Google Maps.
+                      },
+                    ],
+                    "url": "A String",
+                  },
+                ],
+                "widgetContextToken": "A String",
+              },
+            ],
+          },
+          "googleSearchResult": { # Google Search result step.
+            "isError": True or False, # Whether the Google Search resulted in an error.
+            "result": [ # Required. The results of the Google Search.
+              { # The result of the Google Search.
+                "searchSuggestions": "A String", # Web content snippet that can be embedded in a web page or an app webview.
+              },
+            ],
+          },
+          "processingResult": { # The result of a server-initiated media processing step.
+          },
+          "retrievalResult": { # Vertex Retrieval result step. Used by Vertex Retrieval tools such as Parallel AI, Exa AI, Vertex AI Search, etc.
+            "isError": True or False, # Whether the retrieval resulted in an error.
+          },
+          "signature": "A String", # A signature hash for backend validation.
+          "urlContextResult": { # URL context result step.
+            "isError": True or False, # Whether the URL context resulted in an error.
+            "result": [ # Required. The results of the URL context.
+              { # The result of the URL context.
+                "status": "A String", # The status of the URL retrieval.
+                "url": "A String", # The URL that was fetched.
+              },
+            ],
+          },
+        },
+        "userInput": { # Input provided by the user. # DO NOT USE -- These are for 3P JSON only
+          "contentList": { # A list of Content. # The content of the step. An array of Content objects.
+            "contents": [ # The contents of the list.
+              { # The content of the response.
+                "audio": { # An audio content block.
+                  "channels": 42, # The number of audio channels.
+                  "data": "A String", # The audio content.
+                  "mimeTypeString": "A String", # Flexible MIME type string of the audio, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                  "sampleRate": 42, # The sample rate of the audio.
+                  "uri": "A String", # The URI of the audio.
+                },
+                "document": { # A document content block.
+                  "data": "A String", # The document content.
+                  "mimeTypeString": "A String", # Flexible MIME type string of the document, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                  "uri": "A String", # The URI of the document.
+                },
+                "image": { # An image content block.
+                  "data": "A String", # The image content.
+                  "mimeTypeString": "A String", # Flexible MIME type string of the image, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                  "resolution": "A String", # The resolution of the media.
+                  "uri": "A String", # The URI of the image.
+                },
+                "text": { # A text content block.
+                  "annotations": [ # Citation information for model-generated content.
+                    { # Citation information for model-generated content.
+                      "endIndex": 42, # End of the attributed segment, exclusive.
+                      "fileCitation": { # A file citation annotation. # A file citation annotation.
+                        "customMetadata": { # User provided metadata about the retrieved context.
+                          "a_key": "", # Properties of the object.
+                        },
+                        "documentUri": "A String", # The URI of the file.
+                        "fileName": "A String", # The name of the file.
+                        "mediaId": "A String", # Media ID in-case of image citations, if applicable.
+                        "pageNumber": 42, # Page number of the cited document, if applicable.
+                        "source": "A String", # Source attributed for a portion of the text.
+                      },
+                      "placeCitation": { # A place citation annotation. # A place citation annotation.
+                        "name": "A String", # Title of the place.
+                        "placeId": "A String", # The ID of the place, in `places/{place_id}` format.
+                        "reviewSnippets": [ # Snippets of reviews that are used to generate answers about the features of a given place in Google Maps.
+                          { # Encapsulates a snippet of a user review that answers a question about the features of a specific place in Google Maps.
+                            "reviewId": "A String", # The ID of the review snippet.
+                            "title": "A String", # Title of the review.
+                            "url": "A String", # A link that corresponds to the user review on Google Maps.
+                          },
+                        ],
+                        "url": "A String", # URI reference of the place.
+                      },
+                      "speechMetadata": { # Speech annotation for text content. # Speech annotation for text content.
+                        "speaker": "A String", # The speaker to associate with this turn.
+                        "style": "A String", # Style instruction for the speech synthesis.
+                      },
+                      "startIndex": 42, # Start of segment of the response that is attributed to this source. Index indicates the start of the segment, measured in bytes.
+                      "urlCitation": { # A URL citation annotation. # NOTE: We use these instead of the Citation message for historical reasons. A URL citation annotation.
+                        "title": "A String", # The title of the URL.
+                        "url": "A String", # The URL.
+                      },
+                      "wordInfo": { # Word-level ASR annotation for transcription output. Carries the word text, optional timing, and optional speaker attribution. # Word-level ASR annotation with timing and speaker info.
+                        "endOffset": "A String", # End offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                        "speaker": "A String", # Optional. Speaker label for this word (e.g. "spk_1", "spk_2"). Present when diarization_mode is set in TranscriptionConfig.
+                        "startOffset": "A String", # Start offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                        "text": "A String", # The transcribed word.
+                      },
+                    },
+                  ],
+                  "text": "A String", # Required. The text content.
+                },
+                "video": { # A video content block.
+                  "data": "A String", # The video content.
+                  "mimeTypeString": "A String", # Flexible MIME type string of the video, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                  "name": "A String", # A user-defined name for this content block. Can be referenced by the model in the final response.
+                  "processingConfig": {
+                    "static": {
+                      "endOffset": "A String", # Optional. Segment end time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "30s". Must be non-negative and greater than `start_offset` if `start_offset` is set.
+                      "fps": 3.14, # Optional. Video frame-rate sampling density.
+                      "startOffset": "A String", # Optional. Segment start time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "10.5s". Must be non-negative.
+                    },
+                  },
+                  "processingType": "A String",
+                  "resolution": "A String", # The resolution of the media.
+                  "uri": "A String", # The URI of the video.
+                },
+              },
+            ],
+          },
+          "contentString": "A String", # The content of the step. A single string.
+        },
+      },
+    ],
+  },
+  "steps": [ # Required. Output only. The steps that make up the interaction, when included in the response.
+    { # A step in the interaction.
+      "modelOutput": { # Output generated by the model.
+        "content": [
+          { # The content of the response.
+            "audio": { # An audio content block.
+              "channels": 42, # The number of audio channels.
+              "data": "A String", # The audio content.
+              "mimeTypeString": "A String", # Flexible MIME type string of the audio, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+              "sampleRate": 42, # The sample rate of the audio.
+              "uri": "A String", # The URI of the audio.
+            },
+            "document": { # A document content block.
+              "data": "A String", # The document content.
+              "mimeTypeString": "A String", # Flexible MIME type string of the document, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+              "uri": "A String", # The URI of the document.
+            },
+            "image": { # An image content block.
+              "data": "A String", # The image content.
+              "mimeTypeString": "A String", # Flexible MIME type string of the image, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+              "resolution": "A String", # The resolution of the media.
+              "uri": "A String", # The URI of the image.
+            },
+            "text": { # A text content block.
+              "annotations": [ # Citation information for model-generated content.
+                { # Citation information for model-generated content.
+                  "endIndex": 42, # End of the attributed segment, exclusive.
+                  "fileCitation": { # A file citation annotation. # A file citation annotation.
+                    "customMetadata": { # User provided metadata about the retrieved context.
+                      "a_key": "", # Properties of the object.
+                    },
+                    "documentUri": "A String", # The URI of the file.
+                    "fileName": "A String", # The name of the file.
+                    "mediaId": "A String", # Media ID in-case of image citations, if applicable.
+                    "pageNumber": 42, # Page number of the cited document, if applicable.
+                    "source": "A String", # Source attributed for a portion of the text.
+                  },
+                  "placeCitation": { # A place citation annotation. # A place citation annotation.
+                    "name": "A String", # Title of the place.
+                    "placeId": "A String", # The ID of the place, in `places/{place_id}` format.
+                    "reviewSnippets": [ # Snippets of reviews that are used to generate answers about the features of a given place in Google Maps.
+                      { # Encapsulates a snippet of a user review that answers a question about the features of a specific place in Google Maps.
+                        "reviewId": "A String", # The ID of the review snippet.
+                        "title": "A String", # Title of the review.
+                        "url": "A String", # A link that corresponds to the user review on Google Maps.
+                      },
+                    ],
+                    "url": "A String", # URI reference of the place.
+                  },
+                  "speechMetadata": { # Speech annotation for text content. # Speech annotation for text content.
+                    "speaker": "A String", # The speaker to associate with this turn.
+                    "style": "A String", # Style instruction for the speech synthesis.
+                  },
+                  "startIndex": 42, # Start of segment of the response that is attributed to this source. Index indicates the start of the segment, measured in bytes.
+                  "urlCitation": { # A URL citation annotation. # NOTE: We use these instead of the Citation message for historical reasons. A URL citation annotation.
+                    "title": "A String", # The title of the URL.
+                    "url": "A String", # The URL.
+                  },
+                  "wordInfo": { # Word-level ASR annotation for transcription output. Carries the word text, optional timing, and optional speaker attribution. # Word-level ASR annotation with timing and speaker info.
+                    "endOffset": "A String", # End offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                    "speaker": "A String", # Optional. Speaker label for this word (e.g. "spk_1", "spk_2"). Present when diarization_mode is set in TranscriptionConfig.
+                    "startOffset": "A String", # Start offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                    "text": "A String", # The transcribed word.
+                  },
+                },
+              ],
+              "text": "A String", # Required. The text content.
+            },
+            "video": { # A video content block.
+              "data": "A String", # The video content.
+              "mimeTypeString": "A String", # Flexible MIME type string of the video, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+              "name": "A String", # A user-defined name for this content block. Can be referenced by the model in the final response.
+              "processingConfig": {
+                "static": {
+                  "endOffset": "A String", # Optional. Segment end time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "30s". Must be non-negative and greater than `start_offset` if `start_offset` is set.
+                  "fps": 3.14, # Optional. Video frame-rate sampling density.
+                  "startOffset": "A String", # Optional. Segment start time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "10.5s". Must be non-negative.
+                },
+              },
+              "processingType": "A String",
+              "resolution": "A String", # The resolution of the media.
+              "uri": "A String", # The URI of the video.
+            },
+          },
+        ],
+        "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.
+        },
+      },
+      "thought": { # A thought step.
+        "signature": "A String", # A signature hash for backend validation.
+        "summary": [ # A summary of the thought.
+          { # The content of the response.
+            "audio": { # An audio content block.
+              "channels": 42, # The number of audio channels.
+              "data": "A String", # The audio content.
+              "mimeTypeString": "A String", # Flexible MIME type string of the audio, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+              "sampleRate": 42, # The sample rate of the audio.
+              "uri": "A String", # The URI of the audio.
+            },
+            "document": { # A document content block.
+              "data": "A String", # The document content.
+              "mimeTypeString": "A String", # Flexible MIME type string of the document, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+              "uri": "A String", # The URI of the document.
+            },
+            "image": { # An image content block.
+              "data": "A String", # The image content.
+              "mimeTypeString": "A String", # Flexible MIME type string of the image, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+              "resolution": "A String", # The resolution of the media.
+              "uri": "A String", # The URI of the image.
+            },
+            "text": { # A text content block.
+              "annotations": [ # Citation information for model-generated content.
+                { # Citation information for model-generated content.
+                  "endIndex": 42, # End of the attributed segment, exclusive.
+                  "fileCitation": { # A file citation annotation. # A file citation annotation.
+                    "customMetadata": { # User provided metadata about the retrieved context.
+                      "a_key": "", # Properties of the object.
+                    },
+                    "documentUri": "A String", # The URI of the file.
+                    "fileName": "A String", # The name of the file.
+                    "mediaId": "A String", # Media ID in-case of image citations, if applicable.
+                    "pageNumber": 42, # Page number of the cited document, if applicable.
+                    "source": "A String", # Source attributed for a portion of the text.
+                  },
+                  "placeCitation": { # A place citation annotation. # A place citation annotation.
+                    "name": "A String", # Title of the place.
+                    "placeId": "A String", # The ID of the place, in `places/{place_id}` format.
+                    "reviewSnippets": [ # Snippets of reviews that are used to generate answers about the features of a given place in Google Maps.
+                      { # Encapsulates a snippet of a user review that answers a question about the features of a specific place in Google Maps.
+                        "reviewId": "A String", # The ID of the review snippet.
+                        "title": "A String", # Title of the review.
+                        "url": "A String", # A link that corresponds to the user review on Google Maps.
+                      },
+                    ],
+                    "url": "A String", # URI reference of the place.
+                  },
+                  "speechMetadata": { # Speech annotation for text content. # Speech annotation for text content.
+                    "speaker": "A String", # The speaker to associate with this turn.
+                    "style": "A String", # Style instruction for the speech synthesis.
+                  },
+                  "startIndex": 42, # Start of segment of the response that is attributed to this source. Index indicates the start of the segment, measured in bytes.
+                  "urlCitation": { # A URL citation annotation. # NOTE: We use these instead of the Citation message for historical reasons. A URL citation annotation.
+                    "title": "A String", # The title of the URL.
+                    "url": "A String", # The URL.
+                  },
+                  "wordInfo": { # Word-level ASR annotation for transcription output. Carries the word text, optional timing, and optional speaker attribution. # Word-level ASR annotation with timing and speaker info.
+                    "endOffset": "A String", # End offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                    "speaker": "A String", # Optional. Speaker label for this word (e.g. "spk_1", "spk_2"). Present when diarization_mode is set in TranscriptionConfig.
+                    "startOffset": "A String", # Start offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                    "text": "A String", # The transcribed word.
+                  },
+                },
+              ],
+              "text": "A String", # Required. The text content.
+            },
+            "video": { # A video content block.
+              "data": "A String", # The video content.
+              "mimeTypeString": "A String", # Flexible MIME type string of the video, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+              "name": "A String", # A user-defined name for this content block. Can be referenced by the model in the final response.
+              "processingConfig": {
+                "static": {
+                  "endOffset": "A String", # Optional. Segment end time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "30s". Must be non-negative and greater than `start_offset` if `start_offset` is set.
+                  "fps": 3.14, # Optional. Video frame-rate sampling density.
+                  "startOffset": "A String", # Optional. Segment start time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "10.5s". Must be non-negative.
+                },
+              },
+              "processingType": "A String",
+              "resolution": "A String", # The resolution of the media.
+              "uri": "A String", # The URI of the video.
+            },
+          },
+        ],
+      },
+      "toolCall": { # Tool call step.
+        "codeExecutionCall": { # Code execution call step.
+          "arguments": { # The arguments to pass to the code execution. # Required. The arguments to pass to the code execution.
+            "code": "A String", # The code to be executed.
+            "language": "A String", # Programming language of the `code`.
+          },
+        },
+        "fileSearchCall": { # File Search call step.
+        },
+        "functionCall": { # A function tool call step.
+          "arguments": { # `Struct` represents a structured data value, consisting of fields which map to dynamically typed values. # Required. The arguments to pass to the function.
+            "fields": [ # Dynamically typed fields. List instead of map because LLMs are sensitive to ordering, and we want to give users full control.
+              { # Represents a single field in a struct.
+                "name": "A String",
+                "value": { # `Value` represents a dynamically typed value which can be either null, a number, a string, a boolean, a recursive struct value, or a list of values. A producer of value is expected to set one of these variants. Absence of any variant indicates an error.
+                  "boolValue": True or False, # Represents a boolean value.
+                  "contentValue": { # The content of the response. # Represents rich content (text, image, etc.).
+                    "audio": { # An audio content block.
+                      "channels": 42, # The number of audio channels.
+                      "data": "A String", # The audio content.
+                      "mimeTypeString": "A String", # Flexible MIME type string of the audio, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                      "sampleRate": 42, # The sample rate of the audio.
+                      "uri": "A String", # The URI of the audio.
+                    },
+                    "document": { # A document content block.
+                      "data": "A String", # The document content.
+                      "mimeTypeString": "A String", # Flexible MIME type string of the document, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                      "uri": "A String", # The URI of the document.
+                    },
+                    "image": { # An image content block.
+                      "data": "A String", # The image content.
+                      "mimeTypeString": "A String", # Flexible MIME type string of the image, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                      "resolution": "A String", # The resolution of the media.
+                      "uri": "A String", # The URI of the image.
+                    },
+                    "text": { # A text content block.
+                      "annotations": [ # Citation information for model-generated content.
+                        { # Citation information for model-generated content.
+                          "endIndex": 42, # End of the attributed segment, exclusive.
+                          "fileCitation": { # A file citation annotation. # A file citation annotation.
+                            "customMetadata": { # User provided metadata about the retrieved context.
+                              "a_key": "", # Properties of the object.
+                            },
+                            "documentUri": "A String", # The URI of the file.
+                            "fileName": "A String", # The name of the file.
+                            "mediaId": "A String", # Media ID in-case of image citations, if applicable.
+                            "pageNumber": 42, # Page number of the cited document, if applicable.
+                            "source": "A String", # Source attributed for a portion of the text.
+                          },
+                          "placeCitation": { # A place citation annotation. # A place citation annotation.
+                            "name": "A String", # Title of the place.
+                            "placeId": "A String", # The ID of the place, in `places/{place_id}` format.
+                            "reviewSnippets": [ # Snippets of reviews that are used to generate answers about the features of a given place in Google Maps.
+                              { # Encapsulates a snippet of a user review that answers a question about the features of a specific place in Google Maps.
+                                "reviewId": "A String", # The ID of the review snippet.
+                                "title": "A String", # Title of the review.
+                                "url": "A String", # A link that corresponds to the user review on Google Maps.
+                              },
+                            ],
+                            "url": "A String", # URI reference of the place.
+                          },
+                          "speechMetadata": { # Speech annotation for text content. # Speech annotation for text content.
+                            "speaker": "A String", # The speaker to associate with this turn.
+                            "style": "A String", # Style instruction for the speech synthesis.
+                          },
+                          "startIndex": 42, # Start of segment of the response that is attributed to this source. Index indicates the start of the segment, measured in bytes.
+                          "urlCitation": { # A URL citation annotation. # NOTE: We use these instead of the Citation message for historical reasons. A URL citation annotation.
+                            "title": "A String", # The title of the URL.
+                            "url": "A String", # The URL.
+                          },
+                          "wordInfo": { # Word-level ASR annotation for transcription output. Carries the word text, optional timing, and optional speaker attribution. # Word-level ASR annotation with timing and speaker info.
+                            "endOffset": "A String", # End offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                            "speaker": "A String", # Optional. Speaker label for this word (e.g. "spk_1", "spk_2"). Present when diarization_mode is set in TranscriptionConfig.
+                            "startOffset": "A String", # Start offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                            "text": "A String", # The transcribed word.
+                          },
+                        },
+                      ],
+                      "text": "A String", # Required. The text content.
+                    },
+                    "video": { # A video content block.
+                      "data": "A String", # The video content.
+                      "mimeTypeString": "A String", # Flexible MIME type string of the video, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                      "name": "A String", # A user-defined name for this content block. Can be referenced by the model in the final response.
+                      "processingConfig": {
+                        "static": {
+                          "endOffset": "A String", # Optional. Segment end time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "30s". Must be non-negative and greater than `start_offset` if `start_offset` is set.
+                          "fps": 3.14, # Optional. Video frame-rate sampling density.
+                          "startOffset": "A String", # Optional. Segment start time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "10.5s". Must be non-negative.
+                        },
+                      },
+                      "processingType": "A String",
+                      "resolution": "A String", # The resolution of the media.
+                      "uri": "A String", # The URI of the video.
+                    },
+                  },
+                  "listValue": { # `ListValue` is a wrapper around a repeated field of values. # Represents a repeated `Value`.
+                    "values": [ # Repeated field of dynamically typed values.
+                      # Object with schema name: GenaiVertexV1Value
+                    ],
+                  },
+                  "nullValue": "A String", # Represents a null value.
+                  "numberValue": 3.14, # Represents a double value.
+                  "stringValue": "A String", # Represents a string value.
+                  "structValue": # Object with schema name: GenaiVertexV1Struct # Represents a structured value.
+                },
+              },
+            ],
+          },
+          "name": "A String", # Required. The name of the tool to call.
+        },
+        "googleMapsCall": { # Google Maps call step.
+          "arguments": { # The arguments to pass to the Google Maps tool. # The arguments to pass to the Google Maps tool.
+            "queries": [ # The queries to be executed.
+              "A String",
+            ],
+          },
+        },
+        "googleSearchCall": { # Google Search call step.
+          "arguments": { # The arguments to pass to Google Search. # Required. The arguments to pass to Google Search.
+            "queries": [ # Web search queries for the following-up web search.
+              "A String",
+            ],
+          },
+          "searchType": "A String", # The type of search grounding enabled.
+        },
+        "id": "A String", # Required. A unique ID for this specific tool call.
+        "processingCall": { # A server-initiated processing step for media analysis (e.g. video understanding).
+        },
+        "retrievalCall": { # Retrieval call step. Used by Vertex Retrieval tools such as Parallel AI, Exa AI, Vertex AI Search, etc. RetrievalType decides which tool is used.
+          "arguments": { # The arguments to pass to Retrieval tools. # Required. The arguments to pass to the retrieval tool.
+            "queries": [ # Queries for Retrieval information.
+              "A String",
+            ],
+          },
+          "retrievalType": "A String", # The type of retrieval tools.
+        },
+        "signature": "A String", # A signature hash for backend validation.
+        "urlContextCall": { # URL context call step.
+          "arguments": { # The arguments to pass to the URL context. # Required. The arguments to pass to the URL context.
+            "urls": [ # The URLs to fetch.
+              "A String",
+            ],
+          },
+        },
+      },
+      "toolResult": { # Tool result step.
+        "callId": "A String", # Required. ID to match the ID from the function call block.
+        "codeExecutionResult": { # Code execution result step.
+          "isError": True or False, # Whether the code execution resulted in an error.
+          "result": "A String", # Required. The output of the code execution.
+        },
+        "fileSearchResult": { # File Search result step.
+        },
+        "functionResult": { # Result of a function tool call.
+          "isError": True or False, # Whether the tool call resulted in an error.
+          "name": "A String", # The name of the tool that was called.
+          "result": { # `Value` represents a dynamically typed value which can be either null, a number, a string, a boolean, a recursive struct value, or a list of values. A producer of value is expected to set one of these variants. Absence of any variant indicates an error. # Required. The result of the tool call.
+            "boolValue": True or False, # Represents a boolean value.
+            "contentValue": { # The content of the response. # Represents rich content (text, image, etc.).
+              "audio": { # An audio content block.
+                "channels": 42, # The number of audio channels.
+                "data": "A String", # The audio content.
+                "mimeTypeString": "A String", # Flexible MIME type string of the audio, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                "sampleRate": 42, # The sample rate of the audio.
+                "uri": "A String", # The URI of the audio.
+              },
+              "document": { # A document content block.
+                "data": "A String", # The document content.
+                "mimeTypeString": "A String", # Flexible MIME type string of the document, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                "uri": "A String", # The URI of the document.
+              },
+              "image": { # An image content block.
+                "data": "A String", # The image content.
+                "mimeTypeString": "A String", # Flexible MIME type string of the image, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                "resolution": "A String", # The resolution of the media.
+                "uri": "A String", # The URI of the image.
+              },
+              "text": { # A text content block.
+                "annotations": [ # Citation information for model-generated content.
+                  { # Citation information for model-generated content.
+                    "endIndex": 42, # End of the attributed segment, exclusive.
+                    "fileCitation": { # A file citation annotation. # A file citation annotation.
+                      "customMetadata": { # User provided metadata about the retrieved context.
+                        "a_key": "", # Properties of the object.
+                      },
+                      "documentUri": "A String", # The URI of the file.
+                      "fileName": "A String", # The name of the file.
+                      "mediaId": "A String", # Media ID in-case of image citations, if applicable.
+                      "pageNumber": 42, # Page number of the cited document, if applicable.
+                      "source": "A String", # Source attributed for a portion of the text.
+                    },
+                    "placeCitation": { # A place citation annotation. # A place citation annotation.
+                      "name": "A String", # Title of the place.
+                      "placeId": "A String", # The ID of the place, in `places/{place_id}` format.
+                      "reviewSnippets": [ # Snippets of reviews that are used to generate answers about the features of a given place in Google Maps.
+                        { # Encapsulates a snippet of a user review that answers a question about the features of a specific place in Google Maps.
+                          "reviewId": "A String", # The ID of the review snippet.
+                          "title": "A String", # Title of the review.
+                          "url": "A String", # A link that corresponds to the user review on Google Maps.
+                        },
+                      ],
+                      "url": "A String", # URI reference of the place.
+                    },
+                    "speechMetadata": { # Speech annotation for text content. # Speech annotation for text content.
+                      "speaker": "A String", # The speaker to associate with this turn.
+                      "style": "A String", # Style instruction for the speech synthesis.
+                    },
+                    "startIndex": 42, # Start of segment of the response that is attributed to this source. Index indicates the start of the segment, measured in bytes.
+                    "urlCitation": { # A URL citation annotation. # NOTE: We use these instead of the Citation message for historical reasons. A URL citation annotation.
+                      "title": "A String", # The title of the URL.
+                      "url": "A String", # The URL.
+                    },
+                    "wordInfo": { # Word-level ASR annotation for transcription output. Carries the word text, optional timing, and optional speaker attribution. # Word-level ASR annotation with timing and speaker info.
+                      "endOffset": "A String", # End offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                      "speaker": "A String", # Optional. Speaker label for this word (e.g. "spk_1", "spk_2"). Present when diarization_mode is set in TranscriptionConfig.
+                      "startOffset": "A String", # Start offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                      "text": "A String", # The transcribed word.
+                    },
+                  },
+                ],
+                "text": "A String", # Required. The text content.
+              },
+              "video": { # A video content block.
+                "data": "A String", # The video content.
+                "mimeTypeString": "A String", # Flexible MIME type string of the video, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                "name": "A String", # A user-defined name for this content block. Can be referenced by the model in the final response.
+                "processingConfig": {
+                  "static": {
+                    "endOffset": "A String", # Optional. Segment end time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "30s". Must be non-negative and greater than `start_offset` if `start_offset` is set.
+                    "fps": 3.14, # Optional. Video frame-rate sampling density.
+                    "startOffset": "A String", # Optional. Segment start time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "10.5s". Must be non-negative.
+                  },
+                },
+                "processingType": "A String",
+                "resolution": "A String", # The resolution of the media.
+                "uri": "A String", # The URI of the video.
+              },
+            },
+            "listValue": { # `ListValue` is a wrapper around a repeated field of values. # Represents a repeated `Value`.
+              "values": [ # Repeated field of dynamically typed values.
+                # Object with schema name: GenaiVertexV1Value
+              ],
+            },
+            "nullValue": "A String", # Represents a null value.
+            "numberValue": 3.14, # Represents a double value.
+            "stringValue": "A String", # Represents a string value.
+            "structValue": # Object with schema name: GenaiVertexV1Struct # Represents a structured value.
+          },
+        },
+        "googleMapsResult": { # Google Maps result step.
+          "result": [
+            { # The result of the Google Maps.
+              "places": [
+                {
+                  "name": "A String",
+                  "placeId": "A String",
+                  "reviewSnippets": [
+                    { # Encapsulates a snippet of a user review that answers a question about the features of a specific place in Google Maps.
+                      "reviewId": "A String", # The ID of the review snippet.
+                      "title": "A String", # Title of the review.
+                      "url": "A String", # A link that corresponds to the user review on Google Maps.
+                    },
+                  ],
+                  "url": "A String",
+                },
+              ],
+              "widgetContextToken": "A String",
+            },
+          ],
+        },
+        "googleSearchResult": { # Google Search result step.
+          "isError": True or False, # Whether the Google Search resulted in an error.
+          "result": [ # Required. The results of the Google Search.
+            { # The result of the Google Search.
+              "searchSuggestions": "A String", # Web content snippet that can be embedded in a web page or an app webview.
+            },
+          ],
+        },
+        "processingResult": { # The result of a server-initiated media processing step.
+        },
+        "retrievalResult": { # Vertex Retrieval result step. Used by Vertex Retrieval tools such as Parallel AI, Exa AI, Vertex AI Search, etc.
+          "isError": True or False, # Whether the retrieval resulted in an error.
+        },
+        "signature": "A String", # A signature hash for backend validation.
+        "urlContextResult": { # URL context result step.
+          "isError": True or False, # Whether the URL context resulted in an error.
+          "result": [ # Required. The results of the URL context.
+            { # The result of the URL context.
+              "status": "A String", # The status of the URL retrieval.
+              "url": "A String", # The URL that was fetched.
+            },
+          ],
+        },
+      },
+      "userInput": { # Input provided by the user. # DO NOT USE -- These are for 3P JSON only
+        "contentList": { # A list of Content. # The content of the step. An array of Content objects.
+          "contents": [ # The contents of the list.
+            { # The content of the response.
+              "audio": { # An audio content block.
+                "channels": 42, # The number of audio channels.
+                "data": "A String", # The audio content.
+                "mimeTypeString": "A String", # Flexible MIME type string of the audio, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                "sampleRate": 42, # The sample rate of the audio.
+                "uri": "A String", # The URI of the audio.
+              },
+              "document": { # A document content block.
+                "data": "A String", # The document content.
+                "mimeTypeString": "A String", # Flexible MIME type string of the document, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                "uri": "A String", # The URI of the document.
+              },
+              "image": { # An image content block.
+                "data": "A String", # The image content.
+                "mimeTypeString": "A String", # Flexible MIME type string of the image, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                "resolution": "A String", # The resolution of the media.
+                "uri": "A String", # The URI of the image.
+              },
+              "text": { # A text content block.
+                "annotations": [ # Citation information for model-generated content.
+                  { # Citation information for model-generated content.
+                    "endIndex": 42, # End of the attributed segment, exclusive.
+                    "fileCitation": { # A file citation annotation. # A file citation annotation.
+                      "customMetadata": { # User provided metadata about the retrieved context.
+                        "a_key": "", # Properties of the object.
+                      },
+                      "documentUri": "A String", # The URI of the file.
+                      "fileName": "A String", # The name of the file.
+                      "mediaId": "A String", # Media ID in-case of image citations, if applicable.
+                      "pageNumber": 42, # Page number of the cited document, if applicable.
+                      "source": "A String", # Source attributed for a portion of the text.
+                    },
+                    "placeCitation": { # A place citation annotation. # A place citation annotation.
+                      "name": "A String", # Title of the place.
+                      "placeId": "A String", # The ID of the place, in `places/{place_id}` format.
+                      "reviewSnippets": [ # Snippets of reviews that are used to generate answers about the features of a given place in Google Maps.
+                        { # Encapsulates a snippet of a user review that answers a question about the features of a specific place in Google Maps.
+                          "reviewId": "A String", # The ID of the review snippet.
+                          "title": "A String", # Title of the review.
+                          "url": "A String", # A link that corresponds to the user review on Google Maps.
+                        },
+                      ],
+                      "url": "A String", # URI reference of the place.
+                    },
+                    "speechMetadata": { # Speech annotation for text content. # Speech annotation for text content.
+                      "speaker": "A String", # The speaker to associate with this turn.
+                      "style": "A String", # Style instruction for the speech synthesis.
+                    },
+                    "startIndex": 42, # Start of segment of the response that is attributed to this source. Index indicates the start of the segment, measured in bytes.
+                    "urlCitation": { # A URL citation annotation. # NOTE: We use these instead of the Citation message for historical reasons. A URL citation annotation.
+                      "title": "A String", # The title of the URL.
+                      "url": "A String", # The URL.
+                    },
+                    "wordInfo": { # Word-level ASR annotation for transcription output. Carries the word text, optional timing, and optional speaker attribution. # Word-level ASR annotation with timing and speaker info.
+                      "endOffset": "A String", # End offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                      "speaker": "A String", # Optional. Speaker label for this word (e.g. "spk_1", "spk_2"). Present when diarization_mode is set in TranscriptionConfig.
+                      "startOffset": "A String", # Start offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                      "text": "A String", # The transcribed word.
+                    },
+                  },
+                ],
+                "text": "A String", # Required. The text content.
+              },
+              "video": { # A video content block.
+                "data": "A String", # The video content.
+                "mimeTypeString": "A String", # Flexible MIME type string of the video, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                "name": "A String", # A user-defined name for this content block. Can be referenced by the model in the final response.
+                "processingConfig": {
+                  "static": {
+                    "endOffset": "A String", # Optional. Segment end time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "30s". Must be non-negative and greater than `start_offset` if `start_offset` is set.
+                    "fps": 3.14, # Optional. Video frame-rate sampling density.
+                    "startOffset": "A String", # Optional. Segment start time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "10.5s". Must be non-negative.
+                  },
+                },
+                "processingType": "A String",
+                "resolution": "A String", # The resolution of the media.
+                "uri": "A String", # The URI of the video.
+              },
+            },
+          ],
+        },
+        "contentString": "A String", # The content of the step. A single string.
+      },
+    },
+  ],
+  "stringContent": "A String", # A string input for the interaction, it will be processed as a single text input.
+  "systemInstruction": "A String", # System instruction for the interaction.
+  "tools": [ # A list of tool declarations the model may call during interaction.
+    { # A tool that can be used by the model.
+      "codeExecution": { # A tool that can be used by the model to execute code. # A tool that can be used by the model to execute code.
+      },
+      "computerUse": { # A tool that can be used by the model to interact with the computer. # Tool to support the model interacting directly with the computer.
+        "disabledSafetyPolicies": [ # Optional. Disabled safety policies for computer use.
+          "A String",
+        ],
+        "enablePromptInjectionDetection": True or False, # Whether enable the prompt injection detection check on computer-use request.
+        "environment": "A String", # The environment being operated.
+        "excludedPredefinedFunctions": [ # The list of predefined functions that are excluded from the model call.
+          "A String",
+        ],
+      },
+      "fileSearch": { # A tool that can be used by the model to search files. # A tool that can be used by the model to search files.
+        "fileSearchStoreNames": [ # The file search store names to search.
+          "A String",
+        ],
+        "metadataFilter": "A String", # Metadata filter to apply to the semantic retrieval documents and chunks.
+        "topK": 42, # The number of semantic retrieval chunks to retrieve.
+      },
+      "function": { # A tool that can be used by the model. # A function that can be used by the model.
+        "description": "A String", # A description of the function.
+        "name": "A String", # The name of the function.
+        "parameters": { # `Value` represents a dynamically typed value which can be either null, a number, a string, a boolean, a recursive struct value, or a list of values. A producer of value is expected to set one of these variants. Absence of any variant indicates an error. # The JSON Schema for the function's parameters.
+          "boolValue": True or False, # Represents a boolean value.
+          "contentValue": { # The content of the response. # Represents rich content (text, image, etc.).
+            "audio": { # An audio content block.
+              "channels": 42, # The number of audio channels.
+              "data": "A String", # The audio content.
+              "mimeTypeString": "A String", # Flexible MIME type string of the audio, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+              "sampleRate": 42, # The sample rate of the audio.
+              "uri": "A String", # The URI of the audio.
+            },
+            "document": { # A document content block.
+              "data": "A String", # The document content.
+              "mimeTypeString": "A String", # Flexible MIME type string of the document, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+              "uri": "A String", # The URI of the document.
+            },
+            "image": { # An image content block.
+              "data": "A String", # The image content.
+              "mimeTypeString": "A String", # Flexible MIME type string of the image, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+              "resolution": "A String", # The resolution of the media.
+              "uri": "A String", # The URI of the image.
+            },
+            "text": { # A text content block.
+              "annotations": [ # Citation information for model-generated content.
+                { # Citation information for model-generated content.
+                  "endIndex": 42, # End of the attributed segment, exclusive.
+                  "fileCitation": { # A file citation annotation. # A file citation annotation.
+                    "customMetadata": { # User provided metadata about the retrieved context.
+                      "a_key": "", # Properties of the object.
+                    },
+                    "documentUri": "A String", # The URI of the file.
+                    "fileName": "A String", # The name of the file.
+                    "mediaId": "A String", # Media ID in-case of image citations, if applicable.
+                    "pageNumber": 42, # Page number of the cited document, if applicable.
+                    "source": "A String", # Source attributed for a portion of the text.
+                  },
+                  "placeCitation": { # A place citation annotation. # A place citation annotation.
+                    "name": "A String", # Title of the place.
+                    "placeId": "A String", # The ID of the place, in `places/{place_id}` format.
+                    "reviewSnippets": [ # Snippets of reviews that are used to generate answers about the features of a given place in Google Maps.
+                      { # Encapsulates a snippet of a user review that answers a question about the features of a specific place in Google Maps.
+                        "reviewId": "A String", # The ID of the review snippet.
+                        "title": "A String", # Title of the review.
+                        "url": "A String", # A link that corresponds to the user review on Google Maps.
+                      },
+                    ],
+                    "url": "A String", # URI reference of the place.
+                  },
+                  "speechMetadata": { # Speech annotation for text content. # Speech annotation for text content.
+                    "speaker": "A String", # The speaker to associate with this turn.
+                    "style": "A String", # Style instruction for the speech synthesis.
+                  },
+                  "startIndex": 42, # Start of segment of the response that is attributed to this source. Index indicates the start of the segment, measured in bytes.
+                  "urlCitation": { # A URL citation annotation. # NOTE: We use these instead of the Citation message for historical reasons. A URL citation annotation.
+                    "title": "A String", # The title of the URL.
+                    "url": "A String", # The URL.
+                  },
+                  "wordInfo": { # Word-level ASR annotation for transcription output. Carries the word text, optional timing, and optional speaker attribution. # Word-level ASR annotation with timing and speaker info.
+                    "endOffset": "A String", # End offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                    "speaker": "A String", # Optional. Speaker label for this word (e.g. "spk_1", "spk_2"). Present when diarization_mode is set in TranscriptionConfig.
+                    "startOffset": "A String", # Start offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                    "text": "A String", # The transcribed word.
+                  },
+                },
+              ],
+              "text": "A String", # Required. The text content.
+            },
+            "video": { # A video content block.
+              "data": "A String", # The video content.
+              "mimeTypeString": "A String", # Flexible MIME type string of the video, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+              "name": "A String", # A user-defined name for this content block. Can be referenced by the model in the final response.
+              "processingConfig": {
+                "static": {
+                  "endOffset": "A String", # Optional. Segment end time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "30s". Must be non-negative and greater than `start_offset` if `start_offset` is set.
+                  "fps": 3.14, # Optional. Video frame-rate sampling density.
+                  "startOffset": "A String", # Optional. Segment start time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "10.5s". Must be non-negative.
+                },
+              },
+              "processingType": "A String",
+              "resolution": "A String", # The resolution of the media.
+              "uri": "A String", # The URI of the video.
+            },
+          },
+          "listValue": { # `ListValue` is a wrapper around a repeated field of values. # Represents a repeated `Value`.
+            "values": [ # Repeated field of dynamically typed values.
+              # Object with schema name: GenaiVertexV1Value
+            ],
+          },
+          "nullValue": "A String", # Represents a null value.
+          "numberValue": 3.14, # Represents a double value.
+          "stringValue": "A String", # Represents a string value.
+          "structValue": # Object with schema name: GenaiVertexV1Struct # Represents a structured value.
+        },
+      },
+      "googleMaps": { # A tool that can be used by the model to call Google Maps. # A tool that can be used by the model to search Google Maps.
+        "enableWidget": True or False, # Whether to return a widget context token in the tool call result of the response.
+        "latitude": 3.14, # The latitude of the user's location.
+        "longitude": 3.14, # The longitude of the user's location.
+      },
+      "googleSearch": { # A tool that can be used by the model to search Google. # A tool that can be used by the model to search Google.
+        "searchTypes": [ # The types of search grounding to enable.
+          "A String",
+        ],
+      },
+      "mcpServer": { # A MCPServer is a server that can be called by the model to perform actions. # A MCPServer is a server that can be called by the model to perform actions.
+        "allowedTools": [ # The allowed tools.
+          { # The configuration for allowed tools.
+            "mode": "A String", # The mode of the tool choice.
+            "tools": [ # The names of the allowed tools.
+              "A String",
+            ],
+          },
+        ],
+        "headers": { # Optional: Fields for authentication headers, timeouts, etc., if needed.
+          "a_key": "A String",
+        },
+        "name": "A String", # The name of the MCPServer.
+        "url": "A String", # The full URL for the MCPServer endpoint. Example: "https://api.example.com/mcp"
+      },
+      "retrieval": { # A tool that can be used by the model to retrieve files. # A tool that can be used by the model to retrieve files.
+        "exaAiSearchConfig": { # Used to specify configuration for ExaAISearch. # Used to specify configuration for ExaAISearch.
+          "apiKey": "A String", # Required. The API key for ExaAiSearch.
+          "customConfig": { # Optional. This field can be used to pass any parameter from the Exa.ai Search API.
+            "a_key": "", # Properties of the object.
+          },
+        },
+        "parallelAiSearchConfig": { # Used to specify configuration for ParallelAISearch. # Used to specify configuration for ParallelAISearch.
+          "apiKey": "A String", # Optional. The API key for ParallelAiSearch.
+          "customConfig": { # Optional. Custom configs for ParallelAiSearch.
+            "a_key": "", # Properties of the object.
+          },
+        },
+        "ragStoreConfig": { # Use to specify configuration for RAG Store. # Used to specify configuration for RagStore.
+          "ragResources": [ # Optional. The representation of the rag source.
+            { # The definition of the Rag resource.
+              "ragCorpus": "A String", # Optional. RagCorpora resource name.
+              "ragFileIds": [ # Optional. rag_file_id. The files should be in the same rag_corpus set in rag_corpus field.
+                "A String",
+              ],
+            },
+          ],
+          "ragRetrievalConfig": { # Specifies the context retrieval config. # Optional. The retrieval config for the Rag query.
+            "filter": { # Config for filters. # Optional. Config for filters.
+              "metadataFilter": "A String", # Optional. String for metadata filtering.
+              "vectorDistanceThreshold": 3.14, # Optional. Only returns contexts with vector distance smaller than the threshold.
+              "vectorSimilarityThreshold": 3.14, # Optional. Only returns contexts with vector similarity larger than the threshold.
+            },
+            "hybridSearch": { # Config for Hybrid Search. # Optional. Config for Hybrid Search.
+              "alpha": 3.14, # Optional. Alpha value controls the weight between dense and sparse vector search results.
+            },
+            "ranking": { # Config for ranking and reranking. # Optional. Config for ranking and reranking.
+              "rankService": { # Config for Rank Service. # Config for Rank Service.
+                "modelName": "A String", # Optional. The model name of the rank service.
+              },
+            },
+            "topK": 42, # Optional. The number of contexts to retrieve.
+          },
+        },
+        "retrievalTypes": [ # The types of file retrieval to enable.
+          "A String",
+        ],
+        "vertexAiSearchConfig": { # Used to specify configuration for VertexAISearch. # Used to specify configuration for VertexAISearch.
+          "datastores": [ # Optional. Used to specify Vertex AI Search datastores.
+            "A String",
+          ],
+          "engine": "A String", # Optional. Used to specify Vertex AI Search engine.
+        },
+      },
+      "urlContext": { # A tool that can be used by the model to fetch URL context. # A tool that can be used by the model to fetch URL context.
+      },
+    },
+  ],
+  "updated": "A String", # Required. Output only. The time at which the response was last updated in ISO 8601 format (YYYY-MM-DDThh:mm:ssZ).
+  "usage": { # Statistics on the interaction request's token usage. # Output only. Statistics on the interaction request's token usage.
+    "cachedTokensByModality": [ # A breakdown of cached token usage by modality.
+      { # The token count for a single response modality.
+        "modality": "A String", # The modality associated with the token count.
+        "tokens": 42, # Number of tokens for the modality.
+      },
+    ],
+    "groundingToolCount": [ # Grounding tool count.
+      { # The number of grounding tool counts.
+        "count": 42, # The number of grounding tool counts.
+        "type": "A String", # The grounding tool type associated with the count.
+      },
+    ],
+    "inputTokensByModality": [ # A breakdown of input token usage by modality.
+      { # The token count for a single response modality.
+        "modality": "A String", # The modality associated with the token count.
+        "tokens": 42, # Number of tokens for the modality.
+      },
+    ],
+    "outputTokensByModality": [ # A breakdown of output token usage by modality.
+      { # The token count for a single response modality.
+        "modality": "A String", # The modality associated with the token count.
+        "tokens": 42, # Number of tokens for the modality.
+      },
+    ],
+    "toolUseTokensByModality": [ # A breakdown of tool-use token usage by modality.
+      { # The token count for a single response modality.
+        "modality": "A String", # The modality associated with the token count.
+        "tokens": 42, # Number of tokens for the modality.
+      },
+    ],
+    "totalCachedTokens": 42, # Number of tokens in the cached part of the prompt (the cached content).
+    "totalInputTokens": 42, # Number of tokens in the prompt (context).
+    "totalOutputTokens": 42, # Total number of tokens across all the generated responses.
+    "totalThoughtTokens": 42, # Number of tokens of thoughts for thinking models.
+    "totalTokens": 42, # Total token count for the interaction request (prompt + responses + other internal tokens).
+    "totalToolUseTokens": 42, # Number of tokens present in tool-use prompt(s).
+  },
+}
+
+ +
+ getStream(name, lastEventId=None, stream=None, x__xgafv=None) + 
Fully typed proto, streaming version of GetInteraction that returns Interaction proto.
+
+Args:
+  name: string, Required. The name of the interaction to retrieve. Format: interactions/{interaction} (required)
+  lastEventId: string, If set, resumes the interaction stream from the chunk after the event marked by the event id. Can only be used if `stream` is true.
+  stream: boolean, If true, streams the interaction events as Server-Sent Events.
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    {
+  "errorEvent": { # The error event data, used for error events.
+    "error": { # Error message from an interaction.
+      "code": "A String", # A URI that identifies the error type.
+      "message": "A String", # A human-readable error message.
+    },
+  },
+  "eventId": "A String", # The event_id token to be used to resume the interaction stream, from this event.
+  "interactionCompletedEvent": { # Signals that the Interaction completed. Sent when the Interaction receives Complete/Cancel or naturally terminates. No more input can be sent to the Interaction after this. # The interaction data, used for interaction.completed events. Used when steps are enabled.
+    "interaction": { # Response for InteractionService.CreateInteraction. # Required. Partial completed interaction resource emitted at the end of the stream.
+      "agentInteraction": { # Interaction for generating the completion using agents. # Interaction for generating the completion using agents.
+        "agent": "A String", # The name of the `Agent` used for generating the completion.
+        "antigravityConfig": { # Configuration for the Antigravity agent runtime. Provides server-side control over the agent's execution environment and tool configuration. # Antigravity agent configuration. This configuration is session-level settings that are passed to the agent runtime on a per-request basis.
+          "maxTotalTokens": "A String", # Max total tokens for the agent run.
+          "model": "A String", # The model to use for agent reasoning.
+        },
+        "codeMenderConfig": { # Configuration for the CodeMender agent.
+          "findRequest": { # Request parameters specific to FIND sessions, used for discovering vulnerabilities in a codebase. # Parameters for finding vulnerabilities.
+            "description": "A String", # Additional context or custom instructions provided by the user to guide the vulnerability analysis.
+            "findingId": "A String", # The identifier of a specific finding to verify. This is primarily used in VERIFY mode to focus the agent's execution-based validation on a single vulnerability.
+            "mode": "A String", # The mode of the find session.
+            "sourceFiles": [ # A list of source files to provide as context for the scan.
+              { # Content of a single file in the codebase.
+                "content": "A String", # The UTF-8 encoded text content of the file.
+                "path": "A String", # The relative path of the file from the project root.
+              },
+            ],
+          },
+          "fixRequest": { # Request parameters specific to FIX sessions, used for generating and validating security patches. # Parameters for fixing vulnerabilities.
+            "description": "A String", # Additional context or custom instructions provided by the user to guide the patch generation process.
+            "findingId": "A String", # The identifier of the specific security finding to be remediated. This ID maps to a previously discovered vulnerability.
+            "sourceFiles": [ # A list of source files providing context for the remediation. These files are typically the ones containing the identified vulnerability.
+              { # Content of a single file in the codebase.
+                "content": "A String", # The UTF-8 encoded text content of the file.
+                "path": "A String", # The relative path of the file from the project root.
+              },
+            ],
+          },
+          "model": "A String", # The name of the model to use for the CodeMender agent. One CodeMender session will only use one model.
+          "sessionConfig": { # The configuration of CodeMender sessions. # Optional session-specific configurations to override default agent behavior.
+            "maxRounds": 42, # The maximum number of interaction rounds the agent is allowed to perform before reaching a timeout.
+          },
+          "sessionId": "A String", # Parameter for grouping multiple interactions that belong to the same CodeMender session.
+        },
+        "deepResearchConfig": { # Configuration for the Deep Research agent.
+          "collaborativePlanning": True or False, # Enables human-in-the-loop planning for the Deep Research agent. If set to true, the Deep Research agent will provide a research plan in its response. The agent will then proceed only if the user confirms the plan in the next turn.
+          "enableBigqueryTool": True or False, # Enables bigquery tool for the Deep Research agent.
+          "thinkingSummaries": "A String", # Whether to include thought summaries in the response.
+          "visualization": "A String", # Whether to include visualizations in the response.
+        },
+        "dynamicConfig": { # Configuration for dynamic agents.
+          "config": { # `Struct` represents a structured data value, consisting of fields which map to dynamically typed values. # For agents that are not supported statically in the API definition.
+            "fields": [ # Dynamically typed fields. List instead of map because LLMs are sensitive to ordering, and we want to give users full control.
+              { # Represents a single field in a struct.
+                "name": "A String",
+                "value": { # `Value` represents a dynamically typed value which can be either null, a number, a string, a boolean, a recursive struct value, or a list of values. A producer of value is expected to set one of these variants. Absence of any variant indicates an error.
+                  "boolValue": True or False, # Represents a boolean value.
+                  "contentValue": { # The content of the response. # Represents rich content (text, image, etc.).
+                    "audio": { # An audio content block.
+                      "channels": 42, # The number of audio channels.
+                      "data": "A String", # The audio content.
+                      "mimeTypeString": "A String", # Flexible MIME type string of the audio, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                      "sampleRate": 42, # The sample rate of the audio.
+                      "uri": "A String", # The URI of the audio.
+                    },
+                    "document": { # A document content block.
+                      "data": "A String", # The document content.
+                      "mimeTypeString": "A String", # Flexible MIME type string of the document, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                      "uri": "A String", # The URI of the document.
+                    },
+                    "image": { # An image content block.
+                      "data": "A String", # The image content.
+                      "mimeTypeString": "A String", # Flexible MIME type string of the image, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                      "resolution": "A String", # The resolution of the media.
+                      "uri": "A String", # The URI of the image.
+                    },
+                    "text": { # A text content block.
+                      "annotations": [ # Citation information for model-generated content.
+                        { # Citation information for model-generated content.
+                          "endIndex": 42, # End of the attributed segment, exclusive.
+                          "fileCitation": { # A file citation annotation. # A file citation annotation.
+                            "customMetadata": { # User provided metadata about the retrieved context.
+                              "a_key": "", # Properties of the object.
+                            },
+                            "documentUri": "A String", # The URI of the file.
+                            "fileName": "A String", # The name of the file.
+                            "mediaId": "A String", # Media ID in-case of image citations, if applicable.
+                            "pageNumber": 42, # Page number of the cited document, if applicable.
+                            "source": "A String", # Source attributed for a portion of the text.
+                          },
+                          "placeCitation": { # A place citation annotation. # A place citation annotation.
+                            "name": "A String", # Title of the place.
+                            "placeId": "A String", # The ID of the place, in `places/{place_id}` format.
+                            "reviewSnippets": [ # Snippets of reviews that are used to generate answers about the features of a given place in Google Maps.
+                              { # Encapsulates a snippet of a user review that answers a question about the features of a specific place in Google Maps.
+                                "reviewId": "A String", # The ID of the review snippet.
+                                "title": "A String", # Title of the review.
+                                "url": "A String", # A link that corresponds to the user review on Google Maps.
+                              },
+                            ],
+                            "url": "A String", # URI reference of the place.
+                          },
+                          "speechMetadata": { # Speech annotation for text content. # Speech annotation for text content.
+                            "speaker": "A String", # The speaker to associate with this turn.
+                            "style": "A String", # Style instruction for the speech synthesis.
+                          },
+                          "startIndex": 42, # Start of segment of the response that is attributed to this source. Index indicates the start of the segment, measured in bytes.
+                          "urlCitation": { # A URL citation annotation. # NOTE: We use these instead of the Citation message for historical reasons. A URL citation annotation.
+                            "title": "A String", # The title of the URL.
+                            "url": "A String", # The URL.
+                          },
+                          "wordInfo": { # Word-level ASR annotation for transcription output. Carries the word text, optional timing, and optional speaker attribution. # Word-level ASR annotation with timing and speaker info.
+                            "endOffset": "A String", # End offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                            "speaker": "A String", # Optional. Speaker label for this word (e.g. "spk_1", "spk_2"). Present when diarization_mode is set in TranscriptionConfig.
+                            "startOffset": "A String", # Start offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                            "text": "A String", # The transcribed word.
+                          },
+                        },
+                      ],
+                      "text": "A String", # Required. The text content.
+                    },
+                    "video": { # A video content block.
+                      "data": "A String", # The video content.
+                      "mimeTypeString": "A String", # Flexible MIME type string of the video, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                      "name": "A String", # A user-defined name for this content block. Can be referenced by the model in the final response.
+                      "processingConfig": {
+                        "static": {
+                          "endOffset": "A String", # Optional. Segment end time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "30s". Must be non-negative and greater than `start_offset` if `start_offset` is set.
+                          "fps": 3.14, # Optional. Video frame-rate sampling density.
+                          "startOffset": "A String", # Optional. Segment start time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "10.5s". Must be non-negative.
+                        },
+                      },
+                      "processingType": "A String",
+                      "resolution": "A String", # The resolution of the media.
+                      "uri": "A String", # The URI of the video.
+                    },
+                  },
+                  "listValue": { # `ListValue` is a wrapper around a repeated field of values. # Represents a repeated `Value`.
+                    "values": [ # Repeated field of dynamically typed values.
+                      # Object with schema name: GenaiVertexV1Value
+                    ],
+                  },
+                  "nullValue": "A String", # Represents a null value.
+                  "numberValue": 3.14, # Represents a double value.
+                  "stringValue": "A String", # Represents a string value.
+                  "structValue": # Object with schema name: GenaiVertexV1Struct # Represents a structured value.
+                },
+              },
+            ],
+          },
+        },
+      },
+      "content": { # The content of the response. # The content for the interaction.
+        "audio": { # An audio content block.
+          "channels": 42, # The number of audio channels.
+          "data": "A String", # The audio content.
+          "mimeTypeString": "A String", # Flexible MIME type string of the audio, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+          "sampleRate": 42, # The sample rate of the audio.
+          "uri": "A String", # The URI of the audio.
+        },
+        "document": { # A document content block.
+          "data": "A String", # The document content.
+          "mimeTypeString": "A String", # Flexible MIME type string of the document, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+          "uri": "A String", # The URI of the document.
+        },
+        "image": { # An image content block.
+          "data": "A String", # The image content.
+          "mimeTypeString": "A String", # Flexible MIME type string of the image, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+          "resolution": "A String", # The resolution of the media.
+          "uri": "A String", # The URI of the image.
+        },
+        "text": { # A text content block.
+          "annotations": [ # Citation information for model-generated content.
+            { # Citation information for model-generated content.
+              "endIndex": 42, # End of the attributed segment, exclusive.
+              "fileCitation": { # A file citation annotation. # A file citation annotation.
+                "customMetadata": { # User provided metadata about the retrieved context.
+                  "a_key": "", # Properties of the object.
+                },
+                "documentUri": "A String", # The URI of the file.
+                "fileName": "A String", # The name of the file.
+                "mediaId": "A String", # Media ID in-case of image citations, if applicable.
+                "pageNumber": 42, # Page number of the cited document, if applicable.
+                "source": "A String", # Source attributed for a portion of the text.
+              },
+              "placeCitation": { # A place citation annotation. # A place citation annotation.
+                "name": "A String", # Title of the place.
+                "placeId": "A String", # The ID of the place, in `places/{place_id}` format.
+                "reviewSnippets": [ # Snippets of reviews that are used to generate answers about the features of a given place in Google Maps.
+                  { # Encapsulates a snippet of a user review that answers a question about the features of a specific place in Google Maps.
+                    "reviewId": "A String", # The ID of the review snippet.
+                    "title": "A String", # Title of the review.
+                    "url": "A String", # A link that corresponds to the user review on Google Maps.
+                  },
+                ],
+                "url": "A String", # URI reference of the place.
+              },
+              "speechMetadata": { # Speech annotation for text content. # Speech annotation for text content.
+                "speaker": "A String", # The speaker to associate with this turn.
+                "style": "A String", # Style instruction for the speech synthesis.
+              },
+              "startIndex": 42, # Start of segment of the response that is attributed to this source. Index indicates the start of the segment, measured in bytes.
+              "urlCitation": { # A URL citation annotation. # NOTE: We use these instead of the Citation message for historical reasons. A URL citation annotation.
+                "title": "A String", # The title of the URL.
+                "url": "A String", # The URL.
+              },
+              "wordInfo": { # Word-level ASR annotation for transcription output. Carries the word text, optional timing, and optional speaker attribution. # Word-level ASR annotation with timing and speaker info.
+                "endOffset": "A String", # End offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                "speaker": "A String", # Optional. Speaker label for this word (e.g. "spk_1", "spk_2"). Present when diarization_mode is set in TranscriptionConfig.
+                "startOffset": "A String", # Start offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                "text": "A String", # The transcribed word.
+              },
+            },
+          ],
+          "text": "A String", # Required. The text content.
+        },
+        "video": { # A video content block.
+          "data": "A String", # The video content.
+          "mimeTypeString": "A String", # Flexible MIME type string of the video, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+          "name": "A String", # A user-defined name for this content block. Can be referenced by the model in the final response.
+          "processingConfig": {
+            "static": {
+              "endOffset": "A String", # Optional. Segment end time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "30s". Must be non-negative and greater than `start_offset` if `start_offset` is set.
+              "fps": 3.14, # Optional. Video frame-rate sampling density.
+              "startOffset": "A String", # Optional. Segment start time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "10.5s". Must be non-negative.
+            },
+          },
+          "processingType": "A String",
+          "resolution": "A String", # The resolution of the media.
+          "uri": "A String", # The URI of the video.
+        },
+      },
+      "created": "A String", # Required. Output only. The time at which the response was created in ISO 8601 format (YYYY-MM-DDThh:mm:ssZ).
+      "envId": "A String", # The environment ID for the interaction. Can be 'remote' for default environment.
+      "environmentId": "A String", # Output only. The environment ID for the interaction. Only populated if environment config is set in the request.
+      "errors": [ # Output only. Diagnostic faults / platform errors recorded on the interaction.
+        { # Error message from an interaction.
+          "code": "A String", # A URI that identifies the error type.
+          "message": "A String", # A human-readable error message.
+        },
+      ],
+      "id": "A String", # Required. Output only. A unique identifier for the interaction completion.
+      "labels": { # The labels with user-defined metadata for the request. 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",
+      },
+      "modelInteraction": { # Interaction for generating the completion using models. # Interaction for generating the completion using models.
+        "generationConfig": { # Configuration parameters for model interactions. # Input only. Configuration parameters for the model interaction.
+          "maxOutputTokens": 42, # The maximum number of tokens to include in the response.
+          "seed": 42, # Seed used in decoding for reproducibility.
+          "stopSequences": [ # A list of character sequences that will stop output interaction.
+            "A String",
+          ],
+          "structuredSpeechConfig": { # Configuration for multi-speaker and speech generation. # Speech and multi-speaker configuration.
+            "speakers": [ # Individual speaker configurations.
+              { # The configuration for speech interaction.
+                "language": "A String", # The language of the speech.
+                "speaker": "A String", # The speaker's name, it should match the speaker name given in the prompt.
+                "voice": "A String", # The voice of the speaker.
+              },
+            ],
+          },
+          "temperature": 3.14, # Controls the randomness of the output.
+          "thinkingLevel": "A String", # The level of thought tokens that the model should generate.
+          "thinkingSummaries": "A String", # Whether to include thought summaries in the response.
+          "toolChoiceConfig": { # The tool choice configuration containing allowed tools. # The config for the tool choice.
+            "allowedTools": { # The configuration for allowed tools. # The allowed tools.
+              "mode": "A String", # The mode of the tool choice.
+              "tools": [ # The names of the allowed tools.
+                "A String",
+              ],
+            },
+          },
+          "toolChoiceMode": "A String", # The mode of the tool choice.
+          "topP": 3.14, # The maximum cumulative probability of tokens to consider when sampling.
+          "transcriptionConfig": { # Configuration for speech recognition (transcription). # Optional. Configuration for speech recognition (transcription). If present, ASR is enabled.
+            "adaptationPhrases": [ # Optional. A list of phrases to bias the ASR model towards.
+              "A String",
+            ],
+            "customVocabulary": [ # Optional. A list of custom vocabulary phrases to bias the speech recognition model toward recognizing specific terms.
+              "A String",
+            ],
+            "diarizationMode": "A String", # Optional. Configures speaker diarization. Supported values: "speaker".
+            "languageCodes": [ # Optional. BCP-47 language codes providing hints about the languages present in the audio. If omitted or empty, defaults to automatic language detection.
+              "A String",
+            ],
+            "timestampGranularities": [ # Optional. The granularity of timestamps to include in the transcription output. Supported values: "word". If empty, no timestamps are generated.
+              "A String",
+            ],
+          },
+          "videoConfig": { # Configuration options for video generation. # Configuration for video generation.
+            "task": "A String", # Optional task mode for video generation. If not specified, the model automatically determines the appropriate mode based on the provided text prompt and input media.
+          },
+        },
+        "model": "A String", # The name of the `Model` used for generating the completion.
+      },
+      "previousInteractionId": "A String", # The ID of the previous interaction, if any.
+      "responseFormatList": {
+        "responseFormats": [
+          {
+            "audio": { # Configuration for audio output format.
+              "bitRate": 42, # Bit rate in bits per second (bps). Only applicable for compressed formats (MP3, Opus).
+              "delivery": "A String", # The delivery mode for the audio output.
+              "mimeType": "A String", # The MIME type of the audio output.
+              "sampleRate": 42, # Sample rate in Hz.
+            },
+            "image": { # Configuration for image output format.
+              "aspectRatio": "A String", # The aspect ratio for the image output.
+              "delivery": "A String", # The delivery mode for the image output.
+              "imageSize": "A String", # The size of the image output.
+              "mimeType": "A String", # The MIME type of the image output.
+            },
+            "structValue": { # `Struct` represents a structured data value, consisting of fields which map to dynamically typed values. # Multi-discriminator values is already enabled in GAOS
+              "fields": [ # Dynamically typed fields. List instead of map because LLMs are sensitive to ordering, and we want to give users full control.
+                { # Represents a single field in a struct.
+                  "name": "A String",
+                  "value": { # `Value` represents a dynamically typed value which can be either null, a number, a string, a boolean, a recursive struct value, or a list of values. A producer of value is expected to set one of these variants. Absence of any variant indicates an error.
+                    "boolValue": True or False, # Represents a boolean value.
+                    "contentValue": { # The content of the response. # Represents rich content (text, image, etc.).
+                      "audio": { # An audio content block.
+                        "channels": 42, # The number of audio channels.
+                        "data": "A String", # The audio content.
+                        "mimeTypeString": "A String", # Flexible MIME type string of the audio, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                        "sampleRate": 42, # The sample rate of the audio.
+                        "uri": "A String", # The URI of the audio.
+                      },
+                      "document": { # A document content block.
+                        "data": "A String", # The document content.
+                        "mimeTypeString": "A String", # Flexible MIME type string of the document, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                        "uri": "A String", # The URI of the document.
+                      },
+                      "image": { # An image content block.
+                        "data": "A String", # The image content.
+                        "mimeTypeString": "A String", # Flexible MIME type string of the image, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                        "resolution": "A String", # The resolution of the media.
+                        "uri": "A String", # The URI of the image.
+                      },
+                      "text": { # A text content block.
+                        "annotations": [ # Citation information for model-generated content.
+                          { # Citation information for model-generated content.
+                            "endIndex": 42, # End of the attributed segment, exclusive.
+                            "fileCitation": { # A file citation annotation. # A file citation annotation.
+                              "customMetadata": { # User provided metadata about the retrieved context.
+                                "a_key": "", # Properties of the object.
+                              },
+                              "documentUri": "A String", # The URI of the file.
+                              "fileName": "A String", # The name of the file.
+                              "mediaId": "A String", # Media ID in-case of image citations, if applicable.
+                              "pageNumber": 42, # Page number of the cited document, if applicable.
+                              "source": "A String", # Source attributed for a portion of the text.
+                            },
+                            "placeCitation": { # A place citation annotation. # A place citation annotation.
+                              "name": "A String", # Title of the place.
+                              "placeId": "A String", # The ID of the place, in `places/{place_id}` format.
+                              "reviewSnippets": [ # Snippets of reviews that are used to generate answers about the features of a given place in Google Maps.
+                                { # Encapsulates a snippet of a user review that answers a question about the features of a specific place in Google Maps.
+                                  "reviewId": "A String", # The ID of the review snippet.
+                                  "title": "A String", # Title of the review.
+                                  "url": "A String", # A link that corresponds to the user review on Google Maps.
+                                },
+                              ],
+                              "url": "A String", # URI reference of the place.
+                            },
+                            "speechMetadata": { # Speech annotation for text content. # Speech annotation for text content.
+                              "speaker": "A String", # The speaker to associate with this turn.
+                              "style": "A String", # Style instruction for the speech synthesis.
+                            },
+                            "startIndex": 42, # Start of segment of the response that is attributed to this source. Index indicates the start of the segment, measured in bytes.
+                            "urlCitation": { # A URL citation annotation. # NOTE: We use these instead of the Citation message for historical reasons. A URL citation annotation.
+                              "title": "A String", # The title of the URL.
+                              "url": "A String", # The URL.
+                            },
+                            "wordInfo": { # Word-level ASR annotation for transcription output. Carries the word text, optional timing, and optional speaker attribution. # Word-level ASR annotation with timing and speaker info.
+                              "endOffset": "A String", # End offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                              "speaker": "A String", # Optional. Speaker label for this word (e.g. "spk_1", "spk_2"). Present when diarization_mode is set in TranscriptionConfig.
+                              "startOffset": "A String", # Start offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                              "text": "A String", # The transcribed word.
+                            },
+                          },
+                        ],
+                        "text": "A String", # Required. The text content.
+                      },
+                      "video": { # A video content block.
+                        "data": "A String", # The video content.
+                        "mimeTypeString": "A String", # Flexible MIME type string of the video, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                        "name": "A String", # A user-defined name for this content block. Can be referenced by the model in the final response.
+                        "processingConfig": {
+                          "static": {
+                            "endOffset": "A String", # Optional. Segment end time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "30s". Must be non-negative and greater than `start_offset` if `start_offset` is set.
+                            "fps": 3.14, # Optional. Video frame-rate sampling density.
+                            "startOffset": "A String", # Optional. Segment start time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "10.5s". Must be non-negative.
+                          },
+                        },
+                        "processingType": "A String",
+                        "resolution": "A String", # The resolution of the media.
+                        "uri": "A String", # The URI of the video.
+                      },
+                    },
+                    "listValue": { # `ListValue` is a wrapper around a repeated field of values. # Represents a repeated `Value`.
+                      "values": [ # Repeated field of dynamically typed values.
+                        # Object with schema name: GenaiVertexV1Value
+                      ],
+                    },
+                    "nullValue": "A String", # Represents a null value.
+                    "numberValue": 3.14, # Represents a double value.
+                    "stringValue": "A String", # Represents a string value.
+                    "structValue": # Object with schema name: GenaiVertexV1Struct # Represents a structured value.
+                  },
+                },
+              ],
+            },
+            "text": { # Configuration for text output format.
+              "mimeType": "A String", # The MIME type of the text output.
+              "schema": { # `Struct` represents a structured data value, consisting of fields which map to dynamically typed values. # The JSON schema that the output should conform to. Only applicable when mime_type is application/json.
+                "fields": [ # Dynamically typed fields. List instead of map because LLMs are sensitive to ordering, and we want to give users full control.
+                  { # Represents a single field in a struct.
+                    "name": "A String",
+                    "value": { # `Value` represents a dynamically typed value which can be either null, a number, a string, a boolean, a recursive struct value, or a list of values. A producer of value is expected to set one of these variants. Absence of any variant indicates an error.
+                      "boolValue": True or False, # Represents a boolean value.
+                      "contentValue": { # The content of the response. # Represents rich content (text, image, etc.).
+                        "audio": { # An audio content block.
+                          "channels": 42, # The number of audio channels.
+                          "data": "A String", # The audio content.
+                          "mimeTypeString": "A String", # Flexible MIME type string of the audio, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                          "sampleRate": 42, # The sample rate of the audio.
+                          "uri": "A String", # The URI of the audio.
+                        },
+                        "document": { # A document content block.
+                          "data": "A String", # The document content.
+                          "mimeTypeString": "A String", # Flexible MIME type string of the document, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                          "uri": "A String", # The URI of the document.
+                        },
+                        "image": { # An image content block.
+                          "data": "A String", # The image content.
+                          "mimeTypeString": "A String", # Flexible MIME type string of the image, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                          "resolution": "A String", # The resolution of the media.
+                          "uri": "A String", # The URI of the image.
+                        },
+                        "text": { # A text content block.
+                          "annotations": [ # Citation information for model-generated content.
+                            { # Citation information for model-generated content.
+                              "endIndex": 42, # End of the attributed segment, exclusive.
+                              "fileCitation": { # A file citation annotation. # A file citation annotation.
+                                "customMetadata": { # User provided metadata about the retrieved context.
+                                  "a_key": "", # Properties of the object.
+                                },
+                                "documentUri": "A String", # The URI of the file.
+                                "fileName": "A String", # The name of the file.
+                                "mediaId": "A String", # Media ID in-case of image citations, if applicable.
+                                "pageNumber": 42, # Page number of the cited document, if applicable.
+                                "source": "A String", # Source attributed for a portion of the text.
+                              },
+                              "placeCitation": { # A place citation annotation. # A place citation annotation.
+                                "name": "A String", # Title of the place.
+                                "placeId": "A String", # The ID of the place, in `places/{place_id}` format.
+                                "reviewSnippets": [ # Snippets of reviews that are used to generate answers about the features of a given place in Google Maps.
+                                  { # Encapsulates a snippet of a user review that answers a question about the features of a specific place in Google Maps.
+                                    "reviewId": "A String", # The ID of the review snippet.
+                                    "title": "A String", # Title of the review.
+                                    "url": "A String", # A link that corresponds to the user review on Google Maps.
+                                  },
+                                ],
+                                "url": "A String", # URI reference of the place.
+                              },
+                              "speechMetadata": { # Speech annotation for text content. # Speech annotation for text content.
+                                "speaker": "A String", # The speaker to associate with this turn.
+                                "style": "A String", # Style instruction for the speech synthesis.
+                              },
+                              "startIndex": 42, # Start of segment of the response that is attributed to this source. Index indicates the start of the segment, measured in bytes.
+                              "urlCitation": { # A URL citation annotation. # NOTE: We use these instead of the Citation message for historical reasons. A URL citation annotation.
+                                "title": "A String", # The title of the URL.
+                                "url": "A String", # The URL.
+                              },
+                              "wordInfo": { # Word-level ASR annotation for transcription output. Carries the word text, optional timing, and optional speaker attribution. # Word-level ASR annotation with timing and speaker info.
+                                "endOffset": "A String", # End offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                                "speaker": "A String", # Optional. Speaker label for this word (e.g. "spk_1", "spk_2"). Present when diarization_mode is set in TranscriptionConfig.
+                                "startOffset": "A String", # Start offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                                "text": "A String", # The transcribed word.
+                              },
+                            },
+                          ],
+                          "text": "A String", # Required. The text content.
+                        },
+                        "video": { # A video content block.
+                          "data": "A String", # The video content.
+                          "mimeTypeString": "A String", # Flexible MIME type string of the video, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                          "name": "A String", # A user-defined name for this content block. Can be referenced by the model in the final response.
+                          "processingConfig": {
+                            "static": {
+                              "endOffset": "A String", # Optional. Segment end time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "30s". Must be non-negative and greater than `start_offset` if `start_offset` is set.
+                              "fps": 3.14, # Optional. Video frame-rate sampling density.
+                              "startOffset": "A String", # Optional. Segment start time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "10.5s". Must be non-negative.
+                            },
+                          },
+                          "processingType": "A String",
+                          "resolution": "A String", # The resolution of the media.
+                          "uri": "A String", # The URI of the video.
+                        },
+                      },
+                      "listValue": { # `ListValue` is a wrapper around a repeated field of values. # Represents a repeated `Value`.
+                        "values": [ # Repeated field of dynamically typed values.
+                          # Object with schema name: GenaiVertexV1Value
+                        ],
+                      },
+                      "nullValue": "A String", # Represents a null value.
+                      "numberValue": 3.14, # Represents a double value.
+                      "stringValue": "A String", # Represents a string value.
+                      "structValue": # Object with schema name: GenaiVertexV1Struct # Represents a structured value.
+                    },
+                  },
+                ],
+              },
+            },
+            "video": { # Configuration for video output format.
+              "aspectRatio": "A String", # The aspect ratio for the video output.
+              "delivery": "A String", # The delivery mode for the video output.
+              "duration": "A String", # The duration for the video output.
+              "gcsUri": "A String", # The Cloud Storage URI to store the video output. Required for Vertex if delivery mode is URI.
+              "resolution": "A String", # The video output resolution. Defaults to 720p.
+            },
+          },
+        ],
+      },
+      "responseFormatSingleton": {
+        "audio": { # Configuration for audio output format.
+          "bitRate": 42, # Bit rate in bits per second (bps). Only applicable for compressed formats (MP3, Opus).
+          "delivery": "A String", # The delivery mode for the audio output.
+          "mimeType": "A String", # The MIME type of the audio output.
+          "sampleRate": 42, # Sample rate in Hz.
+        },
+        "image": { # Configuration for image output format.
+          "aspectRatio": "A String", # The aspect ratio for the image output.
+          "delivery": "A String", # The delivery mode for the image output.
+          "imageSize": "A String", # The size of the image output.
+          "mimeType": "A String", # The MIME type of the image output.
+        },
+        "structValue": { # `Struct` represents a structured data value, consisting of fields which map to dynamically typed values. # Multi-discriminator values is already enabled in GAOS
+          "fields": [ # Dynamically typed fields. List instead of map because LLMs are sensitive to ordering, and we want to give users full control.
+            { # Represents a single field in a struct.
+              "name": "A String",
+              "value": { # `Value` represents a dynamically typed value which can be either null, a number, a string, a boolean, a recursive struct value, or a list of values. A producer of value is expected to set one of these variants. Absence of any variant indicates an error.
+                "boolValue": True or False, # Represents a boolean value.
+                "contentValue": { # The content of the response. # Represents rich content (text, image, etc.).
+                  "audio": { # An audio content block.
+                    "channels": 42, # The number of audio channels.
+                    "data": "A String", # The audio content.
+                    "mimeTypeString": "A String", # Flexible MIME type string of the audio, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                    "sampleRate": 42, # The sample rate of the audio.
+                    "uri": "A String", # The URI of the audio.
+                  },
+                  "document": { # A document content block.
+                    "data": "A String", # The document content.
+                    "mimeTypeString": "A String", # Flexible MIME type string of the document, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                    "uri": "A String", # The URI of the document.
+                  },
+                  "image": { # An image content block.
+                    "data": "A String", # The image content.
+                    "mimeTypeString": "A String", # Flexible MIME type string of the image, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                    "resolution": "A String", # The resolution of the media.
+                    "uri": "A String", # The URI of the image.
+                  },
+                  "text": { # A text content block.
+                    "annotations": [ # Citation information for model-generated content.
+                      { # Citation information for model-generated content.
+                        "endIndex": 42, # End of the attributed segment, exclusive.
+                        "fileCitation": { # A file citation annotation. # A file citation annotation.
+                          "customMetadata": { # User provided metadata about the retrieved context.
+                            "a_key": "", # Properties of the object.
+                          },
+                          "documentUri": "A String", # The URI of the file.
+                          "fileName": "A String", # The name of the file.
+                          "mediaId": "A String", # Media ID in-case of image citations, if applicable.
+                          "pageNumber": 42, # Page number of the cited document, if applicable.
+                          "source": "A String", # Source attributed for a portion of the text.
+                        },
+                        "placeCitation": { # A place citation annotation. # A place citation annotation.
+                          "name": "A String", # Title of the place.
+                          "placeId": "A String", # The ID of the place, in `places/{place_id}` format.
+                          "reviewSnippets": [ # Snippets of reviews that are used to generate answers about the features of a given place in Google Maps.
+                            { # Encapsulates a snippet of a user review that answers a question about the features of a specific place in Google Maps.
+                              "reviewId": "A String", # The ID of the review snippet.
+                              "title": "A String", # Title of the review.
+                              "url": "A String", # A link that corresponds to the user review on Google Maps.
+                            },
+                          ],
+                          "url": "A String", # URI reference of the place.
+                        },
+                        "speechMetadata": { # Speech annotation for text content. # Speech annotation for text content.
+                          "speaker": "A String", # The speaker to associate with this turn.
+                          "style": "A String", # Style instruction for the speech synthesis.
+                        },
+                        "startIndex": 42, # Start of segment of the response that is attributed to this source. Index indicates the start of the segment, measured in bytes.
+                        "urlCitation": { # A URL citation annotation. # NOTE: We use these instead of the Citation message for historical reasons. A URL citation annotation.
+                          "title": "A String", # The title of the URL.
+                          "url": "A String", # The URL.
+                        },
+                        "wordInfo": { # Word-level ASR annotation for transcription output. Carries the word text, optional timing, and optional speaker attribution. # Word-level ASR annotation with timing and speaker info.
+                          "endOffset": "A String", # End offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                          "speaker": "A String", # Optional. Speaker label for this word (e.g. "spk_1", "spk_2"). Present when diarization_mode is set in TranscriptionConfig.
+                          "startOffset": "A String", # Start offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                          "text": "A String", # The transcribed word.
+                        },
+                      },
+                    ],
+                    "text": "A String", # Required. The text content.
+                  },
+                  "video": { # A video content block.
+                    "data": "A String", # The video content.
+                    "mimeTypeString": "A String", # Flexible MIME type string of the video, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                    "name": "A String", # A user-defined name for this content block. Can be referenced by the model in the final response.
+                    "processingConfig": {
+                      "static": {
+                        "endOffset": "A String", # Optional. Segment end time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "30s". Must be non-negative and greater than `start_offset` if `start_offset` is set.
+                        "fps": 3.14, # Optional. Video frame-rate sampling density.
+                        "startOffset": "A String", # Optional. Segment start time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "10.5s". Must be non-negative.
+                      },
+                    },
+                    "processingType": "A String",
+                    "resolution": "A String", # The resolution of the media.
+                    "uri": "A String", # The URI of the video.
+                  },
+                },
+                "listValue": { # `ListValue` is a wrapper around a repeated field of values. # Represents a repeated `Value`.
+                  "values": [ # Repeated field of dynamically typed values.
+                    # Object with schema name: GenaiVertexV1Value
+                  ],
+                },
+                "nullValue": "A String", # Represents a null value.
+                "numberValue": 3.14, # Represents a double value.
+                "stringValue": "A String", # Represents a string value.
+                "structValue": # Object with schema name: GenaiVertexV1Struct # Represents a structured value.
+              },
+            },
+          ],
+        },
+        "text": { # Configuration for text output format.
+          "mimeType": "A String", # The MIME type of the text output.
+          "schema": { # `Struct` represents a structured data value, consisting of fields which map to dynamically typed values. # The JSON schema that the output should conform to. Only applicable when mime_type is application/json.
+            "fields": [ # Dynamically typed fields. List instead of map because LLMs are sensitive to ordering, and we want to give users full control.
+              { # Represents a single field in a struct.
+                "name": "A String",
+                "value": { # `Value` represents a dynamically typed value which can be either null, a number, a string, a boolean, a recursive struct value, or a list of values. A producer of value is expected to set one of these variants. Absence of any variant indicates an error.
+                  "boolValue": True or False, # Represents a boolean value.
+                  "contentValue": { # The content of the response. # Represents rich content (text, image, etc.).
+                    "audio": { # An audio content block.
+                      "channels": 42, # The number of audio channels.
+                      "data": "A String", # The audio content.
+                      "mimeTypeString": "A String", # Flexible MIME type string of the audio, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                      "sampleRate": 42, # The sample rate of the audio.
+                      "uri": "A String", # The URI of the audio.
+                    },
+                    "document": { # A document content block.
+                      "data": "A String", # The document content.
+                      "mimeTypeString": "A String", # Flexible MIME type string of the document, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                      "uri": "A String", # The URI of the document.
+                    },
+                    "image": { # An image content block.
+                      "data": "A String", # The image content.
+                      "mimeTypeString": "A String", # Flexible MIME type string of the image, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                      "resolution": "A String", # The resolution of the media.
+                      "uri": "A String", # The URI of the image.
+                    },
+                    "text": { # A text content block.
+                      "annotations": [ # Citation information for model-generated content.
+                        { # Citation information for model-generated content.
+                          "endIndex": 42, # End of the attributed segment, exclusive.
+                          "fileCitation": { # A file citation annotation. # A file citation annotation.
+                            "customMetadata": { # User provided metadata about the retrieved context.
+                              "a_key": "", # Properties of the object.
+                            },
+                            "documentUri": "A String", # The URI of the file.
+                            "fileName": "A String", # The name of the file.
+                            "mediaId": "A String", # Media ID in-case of image citations, if applicable.
+                            "pageNumber": 42, # Page number of the cited document, if applicable.
+                            "source": "A String", # Source attributed for a portion of the text.
+                          },
+                          "placeCitation": { # A place citation annotation. # A place citation annotation.
+                            "name": "A String", # Title of the place.
+                            "placeId": "A String", # The ID of the place, in `places/{place_id}` format.
+                            "reviewSnippets": [ # Snippets of reviews that are used to generate answers about the features of a given place in Google Maps.
+                              { # Encapsulates a snippet of a user review that answers a question about the features of a specific place in Google Maps.
+                                "reviewId": "A String", # The ID of the review snippet.
+                                "title": "A String", # Title of the review.
+                                "url": "A String", # A link that corresponds to the user review on Google Maps.
+                              },
+                            ],
+                            "url": "A String", # URI reference of the place.
+                          },
+                          "speechMetadata": { # Speech annotation for text content. # Speech annotation for text content.
+                            "speaker": "A String", # The speaker to associate with this turn.
+                            "style": "A String", # Style instruction for the speech synthesis.
+                          },
+                          "startIndex": 42, # Start of segment of the response that is attributed to this source. Index indicates the start of the segment, measured in bytes.
+                          "urlCitation": { # A URL citation annotation. # NOTE: We use these instead of the Citation message for historical reasons. A URL citation annotation.
+                            "title": "A String", # The title of the URL.
+                            "url": "A String", # The URL.
+                          },
+                          "wordInfo": { # Word-level ASR annotation for transcription output. Carries the word text, optional timing, and optional speaker attribution. # Word-level ASR annotation with timing and speaker info.
+                            "endOffset": "A String", # End offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                            "speaker": "A String", # Optional. Speaker label for this word (e.g. "spk_1", "spk_2"). Present when diarization_mode is set in TranscriptionConfig.
+                            "startOffset": "A String", # Start offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                            "text": "A String", # The transcribed word.
+                          },
+                        },
+                      ],
+                      "text": "A String", # Required. The text content.
+                    },
+                    "video": { # A video content block.
+                      "data": "A String", # The video content.
+                      "mimeTypeString": "A String", # Flexible MIME type string of the video, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                      "name": "A String", # A user-defined name for this content block. Can be referenced by the model in the final response.
+                      "processingConfig": {
+                        "static": {
+                          "endOffset": "A String", # Optional. Segment end time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "30s". Must be non-negative and greater than `start_offset` if `start_offset` is set.
+                          "fps": 3.14, # Optional. Video frame-rate sampling density.
+                          "startOffset": "A String", # Optional. Segment start time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "10.5s". Must be non-negative.
+                        },
+                      },
+                      "processingType": "A String",
+                      "resolution": "A String", # The resolution of the media.
+                      "uri": "A String", # The URI of the video.
+                    },
+                  },
+                  "listValue": { # `ListValue` is a wrapper around a repeated field of values. # Represents a repeated `Value`.
+                    "values": [ # Repeated field of dynamically typed values.
+                      # Object with schema name: GenaiVertexV1Value
+                    ],
+                  },
+                  "nullValue": "A String", # Represents a null value.
+                  "numberValue": 3.14, # Represents a double value.
+                  "stringValue": "A String", # Represents a string value.
+                  "structValue": # Object with schema name: GenaiVertexV1Struct # Represents a structured value.
+                },
+              },
+            ],
+          },
+        },
+        "video": { # Configuration for video output format.
+          "aspectRatio": "A String", # The aspect ratio for the video output.
+          "delivery": "A String", # The delivery mode for the video output.
+          "duration": "A String", # The duration for the video output.
+          "gcsUri": "A String", # The Cloud Storage URI to store the video output. Required for Vertex if delivery mode is URI.
+          "resolution": "A String", # The video output resolution. Defaults to 720p.
+        },
+      },
+      "safetySettings": [ # Safety settings for the interaction.
+        { # A safety setting that affects the safety-blocking behavior. A SafetySetting consists of a harm category and a threshold for that category.
+          "method": "A String", # Optional. The method for blocking content. If not specified, the default behavior is to use the probability score.
+          "threshold": "A String", # Required. The threshold for blocking content. If the harm probability exceeds this threshold, the content will be blocked.
+          "type": "A String", # Required. The type of harm category to be blocked.
+        },
+      ],
+      "serviceTier": "A String", # The service tier for the interaction.
+      "status": "A String", # Required. Output only. The status of the interaction.
+      "stepList": { # A list of Steps. # Input only. The steps for the interaction.
+        "steps": [ # The steps of the list.
+          { # A step in the interaction.
+            "modelOutput": { # Output generated by the model.
+              "content": [
+                { # The content of the response.
+                  "audio": { # An audio content block.
+                    "channels": 42, # The number of audio channels.
+                    "data": "A String", # The audio content.
+                    "mimeTypeString": "A String", # Flexible MIME type string of the audio, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                    "sampleRate": 42, # The sample rate of the audio.
+                    "uri": "A String", # The URI of the audio.
+                  },
+                  "document": { # A document content block.
+                    "data": "A String", # The document content.
+                    "mimeTypeString": "A String", # Flexible MIME type string of the document, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                    "uri": "A String", # The URI of the document.
+                  },
+                  "image": { # An image content block.
+                    "data": "A String", # The image content.
+                    "mimeTypeString": "A String", # Flexible MIME type string of the image, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                    "resolution": "A String", # The resolution of the media.
+                    "uri": "A String", # The URI of the image.
+                  },
+                  "text": { # A text content block.
+                    "annotations": [ # Citation information for model-generated content.
+                      { # Citation information for model-generated content.
+                        "endIndex": 42, # End of the attributed segment, exclusive.
+                        "fileCitation": { # A file citation annotation. # A file citation annotation.
+                          "customMetadata": { # User provided metadata about the retrieved context.
+                            "a_key": "", # Properties of the object.
+                          },
+                          "documentUri": "A String", # The URI of the file.
+                          "fileName": "A String", # The name of the file.
+                          "mediaId": "A String", # Media ID in-case of image citations, if applicable.
+                          "pageNumber": 42, # Page number of the cited document, if applicable.
+                          "source": "A String", # Source attributed for a portion of the text.
+                        },
+                        "placeCitation": { # A place citation annotation. # A place citation annotation.
+                          "name": "A String", # Title of the place.
+                          "placeId": "A String", # The ID of the place, in `places/{place_id}` format.
+                          "reviewSnippets": [ # Snippets of reviews that are used to generate answers about the features of a given place in Google Maps.
+                            { # Encapsulates a snippet of a user review that answers a question about the features of a specific place in Google Maps.
+                              "reviewId": "A String", # The ID of the review snippet.
+                              "title": "A String", # Title of the review.
+                              "url": "A String", # A link that corresponds to the user review on Google Maps.
+                            },
+                          ],
+                          "url": "A String", # URI reference of the place.
+                        },
+                        "speechMetadata": { # Speech annotation for text content. # Speech annotation for text content.
+                          "speaker": "A String", # The speaker to associate with this turn.
+                          "style": "A String", # Style instruction for the speech synthesis.
+                        },
+                        "startIndex": 42, # Start of segment of the response that is attributed to this source. Index indicates the start of the segment, measured in bytes.
+                        "urlCitation": { # A URL citation annotation. # NOTE: We use these instead of the Citation message for historical reasons. A URL citation annotation.
+                          "title": "A String", # The title of the URL.
+                          "url": "A String", # The URL.
+                        },
+                        "wordInfo": { # Word-level ASR annotation for transcription output. Carries the word text, optional timing, and optional speaker attribution. # Word-level ASR annotation with timing and speaker info.
+                          "endOffset": "A String", # End offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                          "speaker": "A String", # Optional. Speaker label for this word (e.g. "spk_1", "spk_2"). Present when diarization_mode is set in TranscriptionConfig.
+                          "startOffset": "A String", # Start offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                          "text": "A String", # The transcribed word.
+                        },
+                      },
+                    ],
+                    "text": "A String", # Required. The text content.
+                  },
+                  "video": { # A video content block.
+                    "data": "A String", # The video content.
+                    "mimeTypeString": "A String", # Flexible MIME type string of the video, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                    "name": "A String", # A user-defined name for this content block. Can be referenced by the model in the final response.
+                    "processingConfig": {
+                      "static": {
+                        "endOffset": "A String", # Optional. Segment end time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "30s". Must be non-negative and greater than `start_offset` if `start_offset` is set.
+                        "fps": 3.14, # Optional. Video frame-rate sampling density.
+                        "startOffset": "A String", # Optional. Segment start time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "10.5s". Must be non-negative.
+                      },
+                    },
+                    "processingType": "A String",
+                    "resolution": "A String", # The resolution of the media.
+                    "uri": "A String", # The URI of the video.
+                  },
+                },
+              ],
+              "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.
+              },
+            },
+            "thought": { # A thought step.
+              "signature": "A String", # A signature hash for backend validation.
+              "summary": [ # A summary of the thought.
+                { # The content of the response.
+                  "audio": { # An audio content block.
+                    "channels": 42, # The number of audio channels.
+                    "data": "A String", # The audio content.
+                    "mimeTypeString": "A String", # Flexible MIME type string of the audio, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                    "sampleRate": 42, # The sample rate of the audio.
+                    "uri": "A String", # The URI of the audio.
+                  },
+                  "document": { # A document content block.
+                    "data": "A String", # The document content.
+                    "mimeTypeString": "A String", # Flexible MIME type string of the document, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                    "uri": "A String", # The URI of the document.
+                  },
+                  "image": { # An image content block.
+                    "data": "A String", # The image content.
+                    "mimeTypeString": "A String", # Flexible MIME type string of the image, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                    "resolution": "A String", # The resolution of the media.
+                    "uri": "A String", # The URI of the image.
+                  },
+                  "text": { # A text content block.
+                    "annotations": [ # Citation information for model-generated content.
+                      { # Citation information for model-generated content.
+                        "endIndex": 42, # End of the attributed segment, exclusive.
+                        "fileCitation": { # A file citation annotation. # A file citation annotation.
+                          "customMetadata": { # User provided metadata about the retrieved context.
+                            "a_key": "", # Properties of the object.
+                          },
+                          "documentUri": "A String", # The URI of the file.
+                          "fileName": "A String", # The name of the file.
+                          "mediaId": "A String", # Media ID in-case of image citations, if applicable.
+                          "pageNumber": 42, # Page number of the cited document, if applicable.
+                          "source": "A String", # Source attributed for a portion of the text.
+                        },
+                        "placeCitation": { # A place citation annotation. # A place citation annotation.
+                          "name": "A String", # Title of the place.
+                          "placeId": "A String", # The ID of the place, in `places/{place_id}` format.
+                          "reviewSnippets": [ # Snippets of reviews that are used to generate answers about the features of a given place in Google Maps.
+                            { # Encapsulates a snippet of a user review that answers a question about the features of a specific place in Google Maps.
+                              "reviewId": "A String", # The ID of the review snippet.
+                              "title": "A String", # Title of the review.
+                              "url": "A String", # A link that corresponds to the user review on Google Maps.
+                            },
+                          ],
+                          "url": "A String", # URI reference of the place.
+                        },
+                        "speechMetadata": { # Speech annotation for text content. # Speech annotation for text content.
+                          "speaker": "A String", # The speaker to associate with this turn.
+                          "style": "A String", # Style instruction for the speech synthesis.
+                        },
+                        "startIndex": 42, # Start of segment of the response that is attributed to this source. Index indicates the start of the segment, measured in bytes.
+                        "urlCitation": { # A URL citation annotation. # NOTE: We use these instead of the Citation message for historical reasons. A URL citation annotation.
+                          "title": "A String", # The title of the URL.
+                          "url": "A String", # The URL.
+                        },
+                        "wordInfo": { # Word-level ASR annotation for transcription output. Carries the word text, optional timing, and optional speaker attribution. # Word-level ASR annotation with timing and speaker info.
+                          "endOffset": "A String", # End offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                          "speaker": "A String", # Optional. Speaker label for this word (e.g. "spk_1", "spk_2"). Present when diarization_mode is set in TranscriptionConfig.
+                          "startOffset": "A String", # Start offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                          "text": "A String", # The transcribed word.
+                        },
+                      },
+                    ],
+                    "text": "A String", # Required. The text content.
+                  },
+                  "video": { # A video content block.
+                    "data": "A String", # The video content.
+                    "mimeTypeString": "A String", # Flexible MIME type string of the video, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                    "name": "A String", # A user-defined name for this content block. Can be referenced by the model in the final response.
+                    "processingConfig": {
+                      "static": {
+                        "endOffset": "A String", # Optional. Segment end time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "30s". Must be non-negative and greater than `start_offset` if `start_offset` is set.
+                        "fps": 3.14, # Optional. Video frame-rate sampling density.
+                        "startOffset": "A String", # Optional. Segment start time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "10.5s". Must be non-negative.
+                      },
+                    },
+                    "processingType": "A String",
+                    "resolution": "A String", # The resolution of the media.
+                    "uri": "A String", # The URI of the video.
+                  },
+                },
+              ],
+            },
+            "toolCall": { # Tool call step.
+              "codeExecutionCall": { # Code execution call step.
+                "arguments": { # The arguments to pass to the code execution. # Required. The arguments to pass to the code execution.
+                  "code": "A String", # The code to be executed.
+                  "language": "A String", # Programming language of the `code`.
+                },
+              },
+              "fileSearchCall": { # File Search call step.
+              },
+              "functionCall": { # A function tool call step.
+                "arguments": { # `Struct` represents a structured data value, consisting of fields which map to dynamically typed values. # Required. The arguments to pass to the function.
+                  "fields": [ # Dynamically typed fields. List instead of map because LLMs are sensitive to ordering, and we want to give users full control.
+                    { # Represents a single field in a struct.
+                      "name": "A String",
+                      "value": { # `Value` represents a dynamically typed value which can be either null, a number, a string, a boolean, a recursive struct value, or a list of values. A producer of value is expected to set one of these variants. Absence of any variant indicates an error.
+                        "boolValue": True or False, # Represents a boolean value.
+                        "contentValue": { # The content of the response. # Represents rich content (text, image, etc.).
+                          "audio": { # An audio content block.
+                            "channels": 42, # The number of audio channels.
+                            "data": "A String", # The audio content.
+                            "mimeTypeString": "A String", # Flexible MIME type string of the audio, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                            "sampleRate": 42, # The sample rate of the audio.
+                            "uri": "A String", # The URI of the audio.
+                          },
+                          "document": { # A document content block.
+                            "data": "A String", # The document content.
+                            "mimeTypeString": "A String", # Flexible MIME type string of the document, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                            "uri": "A String", # The URI of the document.
+                          },
+                          "image": { # An image content block.
+                            "data": "A String", # The image content.
+                            "mimeTypeString": "A String", # Flexible MIME type string of the image, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                            "resolution": "A String", # The resolution of the media.
+                            "uri": "A String", # The URI of the image.
+                          },
+                          "text": { # A text content block.
+                            "annotations": [ # Citation information for model-generated content.
+                              { # Citation information for model-generated content.
+                                "endIndex": 42, # End of the attributed segment, exclusive.
+                                "fileCitation": { # A file citation annotation. # A file citation annotation.
+                                  "customMetadata": { # User provided metadata about the retrieved context.
+                                    "a_key": "", # Properties of the object.
+                                  },
+                                  "documentUri": "A String", # The URI of the file.
+                                  "fileName": "A String", # The name of the file.
+                                  "mediaId": "A String", # Media ID in-case of image citations, if applicable.
+                                  "pageNumber": 42, # Page number of the cited document, if applicable.
+                                  "source": "A String", # Source attributed for a portion of the text.
+                                },
+                                "placeCitation": { # A place citation annotation. # A place citation annotation.
+                                  "name": "A String", # Title of the place.
+                                  "placeId": "A String", # The ID of the place, in `places/{place_id}` format.
+                                  "reviewSnippets": [ # Snippets of reviews that are used to generate answers about the features of a given place in Google Maps.
+                                    { # Encapsulates a snippet of a user review that answers a question about the features of a specific place in Google Maps.
+                                      "reviewId": "A String", # The ID of the review snippet.
+                                      "title": "A String", # Title of the review.
+                                      "url": "A String", # A link that corresponds to the user review on Google Maps.
+                                    },
+                                  ],
+                                  "url": "A String", # URI reference of the place.
+                                },
+                                "speechMetadata": { # Speech annotation for text content. # Speech annotation for text content.
+                                  "speaker": "A String", # The speaker to associate with this turn.
+                                  "style": "A String", # Style instruction for the speech synthesis.
+                                },
+                                "startIndex": 42, # Start of segment of the response that is attributed to this source. Index indicates the start of the segment, measured in bytes.
+                                "urlCitation": { # A URL citation annotation. # NOTE: We use these instead of the Citation message for historical reasons. A URL citation annotation.
+                                  "title": "A String", # The title of the URL.
+                                  "url": "A String", # The URL.
+                                },
+                                "wordInfo": { # Word-level ASR annotation for transcription output. Carries the word text, optional timing, and optional speaker attribution. # Word-level ASR annotation with timing and speaker info.
+                                  "endOffset": "A String", # End offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                                  "speaker": "A String", # Optional. Speaker label for this word (e.g. "spk_1", "spk_2"). Present when diarization_mode is set in TranscriptionConfig.
+                                  "startOffset": "A String", # Start offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                                  "text": "A String", # The transcribed word.
+                                },
+                              },
+                            ],
+                            "text": "A String", # Required. The text content.
+                          },
+                          "video": { # A video content block.
+                            "data": "A String", # The video content.
+                            "mimeTypeString": "A String", # Flexible MIME type string of the video, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                            "name": "A String", # A user-defined name for this content block. Can be referenced by the model in the final response.
+                            "processingConfig": {
+                              "static": {
+                                "endOffset": "A String", # Optional. Segment end time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "30s". Must be non-negative and greater than `start_offset` if `start_offset` is set.
+                                "fps": 3.14, # Optional. Video frame-rate sampling density.
+                                "startOffset": "A String", # Optional. Segment start time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "10.5s". Must be non-negative.
+                              },
+                            },
+                            "processingType": "A String",
+                            "resolution": "A String", # The resolution of the media.
+                            "uri": "A String", # The URI of the video.
+                          },
+                        },
+                        "listValue": { # `ListValue` is a wrapper around a repeated field of values. # Represents a repeated `Value`.
+                          "values": [ # Repeated field of dynamically typed values.
+                            # Object with schema name: GenaiVertexV1Value
+                          ],
+                        },
+                        "nullValue": "A String", # Represents a null value.
+                        "numberValue": 3.14, # Represents a double value.
+                        "stringValue": "A String", # Represents a string value.
+                        "structValue": # Object with schema name: GenaiVertexV1Struct # Represents a structured value.
+                      },
+                    },
+                  ],
+                },
+                "name": "A String", # Required. The name of the tool to call.
+              },
+              "googleMapsCall": { # Google Maps call step.
+                "arguments": { # The arguments to pass to the Google Maps tool. # The arguments to pass to the Google Maps tool.
+                  "queries": [ # The queries to be executed.
+                    "A String",
+                  ],
+                },
+              },
+              "googleSearchCall": { # Google Search call step.
+                "arguments": { # The arguments to pass to Google Search. # Required. The arguments to pass to Google Search.
+                  "queries": [ # Web search queries for the following-up web search.
+                    "A String",
+                  ],
+                },
+                "searchType": "A String", # The type of search grounding enabled.
+              },
+              "id": "A String", # Required. A unique ID for this specific tool call.
+              "processingCall": { # A server-initiated processing step for media analysis (e.g. video understanding).
+              },
+              "retrievalCall": { # Retrieval call step. Used by Vertex Retrieval tools such as Parallel AI, Exa AI, Vertex AI Search, etc. RetrievalType decides which tool is used.
+                "arguments": { # The arguments to pass to Retrieval tools. # Required. The arguments to pass to the retrieval tool.
+                  "queries": [ # Queries for Retrieval information.
+                    "A String",
+                  ],
+                },
+                "retrievalType": "A String", # The type of retrieval tools.
+              },
+              "signature": "A String", # A signature hash for backend validation.
+              "urlContextCall": { # URL context call step.
+                "arguments": { # The arguments to pass to the URL context. # Required. The arguments to pass to the URL context.
+                  "urls": [ # The URLs to fetch.
+                    "A String",
+                  ],
+                },
+              },
+            },
+            "toolResult": { # Tool result step.
+              "callId": "A String", # Required. ID to match the ID from the function call block.
+              "codeExecutionResult": { # Code execution result step.
+                "isError": True or False, # Whether the code execution resulted in an error.
+                "result": "A String", # Required. The output of the code execution.
+              },
+              "fileSearchResult": { # File Search result step.
+              },
+              "functionResult": { # Result of a function tool call.
+                "isError": True or False, # Whether the tool call resulted in an error.
+                "name": "A String", # The name of the tool that was called.
+                "result": { # `Value` represents a dynamically typed value which can be either null, a number, a string, a boolean, a recursive struct value, or a list of values. A producer of value is expected to set one of these variants. Absence of any variant indicates an error. # Required. The result of the tool call.
+                  "boolValue": True or False, # Represents a boolean value.
+                  "contentValue": { # The content of the response. # Represents rich content (text, image, etc.).
+                    "audio": { # An audio content block.
+                      "channels": 42, # The number of audio channels.
+                      "data": "A String", # The audio content.
+                      "mimeTypeString": "A String", # Flexible MIME type string of the audio, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                      "sampleRate": 42, # The sample rate of the audio.
+                      "uri": "A String", # The URI of the audio.
+                    },
+                    "document": { # A document content block.
+                      "data": "A String", # The document content.
+                      "mimeTypeString": "A String", # Flexible MIME type string of the document, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                      "uri": "A String", # The URI of the document.
+                    },
+                    "image": { # An image content block.
+                      "data": "A String", # The image content.
+                      "mimeTypeString": "A String", # Flexible MIME type string of the image, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                      "resolution": "A String", # The resolution of the media.
+                      "uri": "A String", # The URI of the image.
+                    },
+                    "text": { # A text content block.
+                      "annotations": [ # Citation information for model-generated content.
+                        { # Citation information for model-generated content.
+                          "endIndex": 42, # End of the attributed segment, exclusive.
+                          "fileCitation": { # A file citation annotation. # A file citation annotation.
+                            "customMetadata": { # User provided metadata about the retrieved context.
+                              "a_key": "", # Properties of the object.
+                            },
+                            "documentUri": "A String", # The URI of the file.
+                            "fileName": "A String", # The name of the file.
+                            "mediaId": "A String", # Media ID in-case of image citations, if applicable.
+                            "pageNumber": 42, # Page number of the cited document, if applicable.
+                            "source": "A String", # Source attributed for a portion of the text.
+                          },
+                          "placeCitation": { # A place citation annotation. # A place citation annotation.
+                            "name": "A String", # Title of the place.
+                            "placeId": "A String", # The ID of the place, in `places/{place_id}` format.
+                            "reviewSnippets": [ # Snippets of reviews that are used to generate answers about the features of a given place in Google Maps.
+                              { # Encapsulates a snippet of a user review that answers a question about the features of a specific place in Google Maps.
+                                "reviewId": "A String", # The ID of the review snippet.
+                                "title": "A String", # Title of the review.
+                                "url": "A String", # A link that corresponds to the user review on Google Maps.
+                              },
+                            ],
+                            "url": "A String", # URI reference of the place.
+                          },
+                          "speechMetadata": { # Speech annotation for text content. # Speech annotation for text content.
+                            "speaker": "A String", # The speaker to associate with this turn.
+                            "style": "A String", # Style instruction for the speech synthesis.
+                          },
+                          "startIndex": 42, # Start of segment of the response that is attributed to this source. Index indicates the start of the segment, measured in bytes.
+                          "urlCitation": { # A URL citation annotation. # NOTE: We use these instead of the Citation message for historical reasons. A URL citation annotation.
+                            "title": "A String", # The title of the URL.
+                            "url": "A String", # The URL.
+                          },
+                          "wordInfo": { # Word-level ASR annotation for transcription output. Carries the word text, optional timing, and optional speaker attribution. # Word-level ASR annotation with timing and speaker info.
+                            "endOffset": "A String", # End offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                            "speaker": "A String", # Optional. Speaker label for this word (e.g. "spk_1", "spk_2"). Present when diarization_mode is set in TranscriptionConfig.
+                            "startOffset": "A String", # Start offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                            "text": "A String", # The transcribed word.
+                          },
+                        },
+                      ],
+                      "text": "A String", # Required. The text content.
+                    },
+                    "video": { # A video content block.
+                      "data": "A String", # The video content.
+                      "mimeTypeString": "A String", # Flexible MIME type string of the video, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                      "name": "A String", # A user-defined name for this content block. Can be referenced by the model in the final response.
+                      "processingConfig": {
+                        "static": {
+                          "endOffset": "A String", # Optional. Segment end time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "30s". Must be non-negative and greater than `start_offset` if `start_offset` is set.
+                          "fps": 3.14, # Optional. Video frame-rate sampling density.
+                          "startOffset": "A String", # Optional. Segment start time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "10.5s". Must be non-negative.
+                        },
+                      },
+                      "processingType": "A String",
+                      "resolution": "A String", # The resolution of the media.
+                      "uri": "A String", # The URI of the video.
+                    },
+                  },
+                  "listValue": { # `ListValue` is a wrapper around a repeated field of values. # Represents a repeated `Value`.
+                    "values": [ # Repeated field of dynamically typed values.
+                      # Object with schema name: GenaiVertexV1Value
+                    ],
+                  },
+                  "nullValue": "A String", # Represents a null value.
+                  "numberValue": 3.14, # Represents a double value.
+                  "stringValue": "A String", # Represents a string value.
+                  "structValue": # Object with schema name: GenaiVertexV1Struct # Represents a structured value.
+                },
+              },
+              "googleMapsResult": { # Google Maps result step.
+                "result": [
+                  { # The result of the Google Maps.
+                    "places": [
+                      {
+                        "name": "A String",
+                        "placeId": "A String",
+                        "reviewSnippets": [
+                          { # Encapsulates a snippet of a user review that answers a question about the features of a specific place in Google Maps.
+                            "reviewId": "A String", # The ID of the review snippet.
+                            "title": "A String", # Title of the review.
+                            "url": "A String", # A link that corresponds to the user review on Google Maps.
+                          },
+                        ],
+                        "url": "A String",
+                      },
+                    ],
+                    "widgetContextToken": "A String",
+                  },
+                ],
+              },
+              "googleSearchResult": { # Google Search result step.
+                "isError": True or False, # Whether the Google Search resulted in an error.
+                "result": [ # Required. The results of the Google Search.
+                  { # The result of the Google Search.
+                    "searchSuggestions": "A String", # Web content snippet that can be embedded in a web page or an app webview.
+                  },
+                ],
+              },
+              "processingResult": { # The result of a server-initiated media processing step.
+              },
+              "retrievalResult": { # Vertex Retrieval result step. Used by Vertex Retrieval tools such as Parallel AI, Exa AI, Vertex AI Search, etc.
+                "isError": True or False, # Whether the retrieval resulted in an error.
+              },
+              "signature": "A String", # A signature hash for backend validation.
+              "urlContextResult": { # URL context result step.
+                "isError": True or False, # Whether the URL context resulted in an error.
+                "result": [ # Required. The results of the URL context.
+                  { # The result of the URL context.
+                    "status": "A String", # The status of the URL retrieval.
+                    "url": "A String", # The URL that was fetched.
+                  },
+                ],
+              },
+            },
+            "userInput": { # Input provided by the user. # DO NOT USE -- These are for 3P JSON only
+              "contentList": { # A list of Content. # The content of the step. An array of Content objects.
+                "contents": [ # The contents of the list.
+                  { # The content of the response.
+                    "audio": { # An audio content block.
+                      "channels": 42, # The number of audio channels.
+                      "data": "A String", # The audio content.
+                      "mimeTypeString": "A String", # Flexible MIME type string of the audio, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                      "sampleRate": 42, # The sample rate of the audio.
+                      "uri": "A String", # The URI of the audio.
+                    },
+                    "document": { # A document content block.
+                      "data": "A String", # The document content.
+                      "mimeTypeString": "A String", # Flexible MIME type string of the document, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                      "uri": "A String", # The URI of the document.
+                    },
+                    "image": { # An image content block.
+                      "data": "A String", # The image content.
+                      "mimeTypeString": "A String", # Flexible MIME type string of the image, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                      "resolution": "A String", # The resolution of the media.
+                      "uri": "A String", # The URI of the image.
+                    },
+                    "text": { # A text content block.
+                      "annotations": [ # Citation information for model-generated content.
+                        { # Citation information for model-generated content.
+                          "endIndex": 42, # End of the attributed segment, exclusive.
+                          "fileCitation": { # A file citation annotation. # A file citation annotation.
+                            "customMetadata": { # User provided metadata about the retrieved context.
+                              "a_key": "", # Properties of the object.
+                            },
+                            "documentUri": "A String", # The URI of the file.
+                            "fileName": "A String", # The name of the file.
+                            "mediaId": "A String", # Media ID in-case of image citations, if applicable.
+                            "pageNumber": 42, # Page number of the cited document, if applicable.
+                            "source": "A String", # Source attributed for a portion of the text.
+                          },
+                          "placeCitation": { # A place citation annotation. # A place citation annotation.
+                            "name": "A String", # Title of the place.
+                            "placeId": "A String", # The ID of the place, in `places/{place_id}` format.
+                            "reviewSnippets": [ # Snippets of reviews that are used to generate answers about the features of a given place in Google Maps.
+                              { # Encapsulates a snippet of a user review that answers a question about the features of a specific place in Google Maps.
+                                "reviewId": "A String", # The ID of the review snippet.
+                                "title": "A String", # Title of the review.
+                                "url": "A String", # A link that corresponds to the user review on Google Maps.
+                              },
+                            ],
+                            "url": "A String", # URI reference of the place.
+                          },
+                          "speechMetadata": { # Speech annotation for text content. # Speech annotation for text content.
+                            "speaker": "A String", # The speaker to associate with this turn.
+                            "style": "A String", # Style instruction for the speech synthesis.
+                          },
+                          "startIndex": 42, # Start of segment of the response that is attributed to this source. Index indicates the start of the segment, measured in bytes.
+                          "urlCitation": { # A URL citation annotation. # NOTE: We use these instead of the Citation message for historical reasons. A URL citation annotation.
+                            "title": "A String", # The title of the URL.
+                            "url": "A String", # The URL.
+                          },
+                          "wordInfo": { # Word-level ASR annotation for transcription output. Carries the word text, optional timing, and optional speaker attribution. # Word-level ASR annotation with timing and speaker info.
+                            "endOffset": "A String", # End offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                            "speaker": "A String", # Optional. Speaker label for this word (e.g. "spk_1", "spk_2"). Present when diarization_mode is set in TranscriptionConfig.
+                            "startOffset": "A String", # Start offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                            "text": "A String", # The transcribed word.
+                          },
+                        },
+                      ],
+                      "text": "A String", # Required. The text content.
+                    },
+                    "video": { # A video content block.
+                      "data": "A String", # The video content.
+                      "mimeTypeString": "A String", # Flexible MIME type string of the video, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                      "name": "A String", # A user-defined name for this content block. Can be referenced by the model in the final response.
+                      "processingConfig": {
+                        "static": {
+                          "endOffset": "A String", # Optional. Segment end time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "30s". Must be non-negative and greater than `start_offset` if `start_offset` is set.
+                          "fps": 3.14, # Optional. Video frame-rate sampling density.
+                          "startOffset": "A String", # Optional. Segment start time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "10.5s". Must be non-negative.
+                        },
+                      },
+                      "processingType": "A String",
+                      "resolution": "A String", # The resolution of the media.
+                      "uri": "A String", # The URI of the video.
+                    },
+                  },
+                ],
+              },
+              "contentString": "A String", # The content of the step. A single string.
+            },
+          },
+        ],
+      },
+      "steps": [ # Required. Output only. The steps that make up the interaction, when included in the response.
+        { # A step in the interaction.
+          "modelOutput": { # Output generated by the model.
+            "content": [
+              { # The content of the response.
+                "audio": { # An audio content block.
+                  "channels": 42, # The number of audio channels.
+                  "data": "A String", # The audio content.
+                  "mimeTypeString": "A String", # Flexible MIME type string of the audio, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                  "sampleRate": 42, # The sample rate of the audio.
+                  "uri": "A String", # The URI of the audio.
+                },
+                "document": { # A document content block.
+                  "data": "A String", # The document content.
+                  "mimeTypeString": "A String", # Flexible MIME type string of the document, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                  "uri": "A String", # The URI of the document.
+                },
+                "image": { # An image content block.
+                  "data": "A String", # The image content.
+                  "mimeTypeString": "A String", # Flexible MIME type string of the image, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                  "resolution": "A String", # The resolution of the media.
+                  "uri": "A String", # The URI of the image.
+                },
+                "text": { # A text content block.
+                  "annotations": [ # Citation information for model-generated content.
+                    { # Citation information for model-generated content.
+                      "endIndex": 42, # End of the attributed segment, exclusive.
+                      "fileCitation": { # A file citation annotation. # A file citation annotation.
+                        "customMetadata": { # User provided metadata about the retrieved context.
+                          "a_key": "", # Properties of the object.
+                        },
+                        "documentUri": "A String", # The URI of the file.
+                        "fileName": "A String", # The name of the file.
+                        "mediaId": "A String", # Media ID in-case of image citations, if applicable.
+                        "pageNumber": 42, # Page number of the cited document, if applicable.
+                        "source": "A String", # Source attributed for a portion of the text.
+                      },
+                      "placeCitation": { # A place citation annotation. # A place citation annotation.
+                        "name": "A String", # Title of the place.
+                        "placeId": "A String", # The ID of the place, in `places/{place_id}` format.
+                        "reviewSnippets": [ # Snippets of reviews that are used to generate answers about the features of a given place in Google Maps.
+                          { # Encapsulates a snippet of a user review that answers a question about the features of a specific place in Google Maps.
+                            "reviewId": "A String", # The ID of the review snippet.
+                            "title": "A String", # Title of the review.
+                            "url": "A String", # A link that corresponds to the user review on Google Maps.
+                          },
+                        ],
+                        "url": "A String", # URI reference of the place.
+                      },
+                      "speechMetadata": { # Speech annotation for text content. # Speech annotation for text content.
+                        "speaker": "A String", # The speaker to associate with this turn.
+                        "style": "A String", # Style instruction for the speech synthesis.
+                      },
+                      "startIndex": 42, # Start of segment of the response that is attributed to this source. Index indicates the start of the segment, measured in bytes.
+                      "urlCitation": { # A URL citation annotation. # NOTE: We use these instead of the Citation message for historical reasons. A URL citation annotation.
+                        "title": "A String", # The title of the URL.
+                        "url": "A String", # The URL.
+                      },
+                      "wordInfo": { # Word-level ASR annotation for transcription output. Carries the word text, optional timing, and optional speaker attribution. # Word-level ASR annotation with timing and speaker info.
+                        "endOffset": "A String", # End offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                        "speaker": "A String", # Optional. Speaker label for this word (e.g. "spk_1", "spk_2"). Present when diarization_mode is set in TranscriptionConfig.
+                        "startOffset": "A String", # Start offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                        "text": "A String", # The transcribed word.
+                      },
+                    },
+                  ],
+                  "text": "A String", # Required. The text content.
+                },
+                "video": { # A video content block.
+                  "data": "A String", # The video content.
+                  "mimeTypeString": "A String", # Flexible MIME type string of the video, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                  "name": "A String", # A user-defined name for this content block. Can be referenced by the model in the final response.
+                  "processingConfig": {
+                    "static": {
+                      "endOffset": "A String", # Optional. Segment end time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "30s". Must be non-negative and greater than `start_offset` if `start_offset` is set.
+                      "fps": 3.14, # Optional. Video frame-rate sampling density.
+                      "startOffset": "A String", # Optional. Segment start time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "10.5s". Must be non-negative.
+                    },
+                  },
+                  "processingType": "A String",
+                  "resolution": "A String", # The resolution of the media.
+                  "uri": "A String", # The URI of the video.
+                },
+              },
+            ],
+            "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.
+            },
+          },
+          "thought": { # A thought step.
+            "signature": "A String", # A signature hash for backend validation.
+            "summary": [ # A summary of the thought.
+              { # The content of the response.
+                "audio": { # An audio content block.
+                  "channels": 42, # The number of audio channels.
+                  "data": "A String", # The audio content.
+                  "mimeTypeString": "A String", # Flexible MIME type string of the audio, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                  "sampleRate": 42, # The sample rate of the audio.
+                  "uri": "A String", # The URI of the audio.
+                },
+                "document": { # A document content block.
+                  "data": "A String", # The document content.
+                  "mimeTypeString": "A String", # Flexible MIME type string of the document, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                  "uri": "A String", # The URI of the document.
+                },
+                "image": { # An image content block.
+                  "data": "A String", # The image content.
+                  "mimeTypeString": "A String", # Flexible MIME type string of the image, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                  "resolution": "A String", # The resolution of the media.
+                  "uri": "A String", # The URI of the image.
+                },
+                "text": { # A text content block.
+                  "annotations": [ # Citation information for model-generated content.
+                    { # Citation information for model-generated content.
+                      "endIndex": 42, # End of the attributed segment, exclusive.
+                      "fileCitation": { # A file citation annotation. # A file citation annotation.
+                        "customMetadata": { # User provided metadata about the retrieved context.
+                          "a_key": "", # Properties of the object.
+                        },
+                        "documentUri": "A String", # The URI of the file.
+                        "fileName": "A String", # The name of the file.
+                        "mediaId": "A String", # Media ID in-case of image citations, if applicable.
+                        "pageNumber": 42, # Page number of the cited document, if applicable.
+                        "source": "A String", # Source attributed for a portion of the text.
+                      },
+                      "placeCitation": { # A place citation annotation. # A place citation annotation.
+                        "name": "A String", # Title of the place.
+                        "placeId": "A String", # The ID of the place, in `places/{place_id}` format.
+                        "reviewSnippets": [ # Snippets of reviews that are used to generate answers about the features of a given place in Google Maps.
+                          { # Encapsulates a snippet of a user review that answers a question about the features of a specific place in Google Maps.
+                            "reviewId": "A String", # The ID of the review snippet.
+                            "title": "A String", # Title of the review.
+                            "url": "A String", # A link that corresponds to the user review on Google Maps.
+                          },
+                        ],
+                        "url": "A String", # URI reference of the place.
+                      },
+                      "speechMetadata": { # Speech annotation for text content. # Speech annotation for text content.
+                        "speaker": "A String", # The speaker to associate with this turn.
+                        "style": "A String", # Style instruction for the speech synthesis.
+                      },
+                      "startIndex": 42, # Start of segment of the response that is attributed to this source. Index indicates the start of the segment, measured in bytes.
+                      "urlCitation": { # A URL citation annotation. # NOTE: We use these instead of the Citation message for historical reasons. A URL citation annotation.
+                        "title": "A String", # The title of the URL.
+                        "url": "A String", # The URL.
+                      },
+                      "wordInfo": { # Word-level ASR annotation for transcription output. Carries the word text, optional timing, and optional speaker attribution. # Word-level ASR annotation with timing and speaker info.
+                        "endOffset": "A String", # End offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                        "speaker": "A String", # Optional. Speaker label for this word (e.g. "spk_1", "spk_2"). Present when diarization_mode is set in TranscriptionConfig.
+                        "startOffset": "A String", # Start offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                        "text": "A String", # The transcribed word.
+                      },
+                    },
+                  ],
+                  "text": "A String", # Required. The text content.
+                },
+                "video": { # A video content block.
+                  "data": "A String", # The video content.
+                  "mimeTypeString": "A String", # Flexible MIME type string of the video, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                  "name": "A String", # A user-defined name for this content block. Can be referenced by the model in the final response.
+                  "processingConfig": {
+                    "static": {
+                      "endOffset": "A String", # Optional. Segment end time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "30s". Must be non-negative and greater than `start_offset` if `start_offset` is set.
+                      "fps": 3.14, # Optional. Video frame-rate sampling density.
+                      "startOffset": "A String", # Optional. Segment start time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "10.5s". Must be non-negative.
+                    },
+                  },
+                  "processingType": "A String",
+                  "resolution": "A String", # The resolution of the media.
+                  "uri": "A String", # The URI of the video.
+                },
+              },
+            ],
+          },
+          "toolCall": { # Tool call step.
+            "codeExecutionCall": { # Code execution call step.
+              "arguments": { # The arguments to pass to the code execution. # Required. The arguments to pass to the code execution.
+                "code": "A String", # The code to be executed.
+                "language": "A String", # Programming language of the `code`.
+              },
+            },
+            "fileSearchCall": { # File Search call step.
+            },
+            "functionCall": { # A function tool call step.
+              "arguments": { # `Struct` represents a structured data value, consisting of fields which map to dynamically typed values. # Required. The arguments to pass to the function.
+                "fields": [ # Dynamically typed fields. List instead of map because LLMs are sensitive to ordering, and we want to give users full control.
+                  { # Represents a single field in a struct.
+                    "name": "A String",
+                    "value": { # `Value` represents a dynamically typed value which can be either null, a number, a string, a boolean, a recursive struct value, or a list of values. A producer of value is expected to set one of these variants. Absence of any variant indicates an error.
+                      "boolValue": True or False, # Represents a boolean value.
+                      "contentValue": { # The content of the response. # Represents rich content (text, image, etc.).
+                        "audio": { # An audio content block.
+                          "channels": 42, # The number of audio channels.
+                          "data": "A String", # The audio content.
+                          "mimeTypeString": "A String", # Flexible MIME type string of the audio, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                          "sampleRate": 42, # The sample rate of the audio.
+                          "uri": "A String", # The URI of the audio.
+                        },
+                        "document": { # A document content block.
+                          "data": "A String", # The document content.
+                          "mimeTypeString": "A String", # Flexible MIME type string of the document, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                          "uri": "A String", # The URI of the document.
+                        },
+                        "image": { # An image content block.
+                          "data": "A String", # The image content.
+                          "mimeTypeString": "A String", # Flexible MIME type string of the image, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                          "resolution": "A String", # The resolution of the media.
+                          "uri": "A String", # The URI of the image.
+                        },
+                        "text": { # A text content block.
+                          "annotations": [ # Citation information for model-generated content.
+                            { # Citation information for model-generated content.
+                              "endIndex": 42, # End of the attributed segment, exclusive.
+                              "fileCitation": { # A file citation annotation. # A file citation annotation.
+                                "customMetadata": { # User provided metadata about the retrieved context.
+                                  "a_key": "", # Properties of the object.
+                                },
+                                "documentUri": "A String", # The URI of the file.
+                                "fileName": "A String", # The name of the file.
+                                "mediaId": "A String", # Media ID in-case of image citations, if applicable.
+                                "pageNumber": 42, # Page number of the cited document, if applicable.
+                                "source": "A String", # Source attributed for a portion of the text.
+                              },
+                              "placeCitation": { # A place citation annotation. # A place citation annotation.
+                                "name": "A String", # Title of the place.
+                                "placeId": "A String", # The ID of the place, in `places/{place_id}` format.
+                                "reviewSnippets": [ # Snippets of reviews that are used to generate answers about the features of a given place in Google Maps.
+                                  { # Encapsulates a snippet of a user review that answers a question about the features of a specific place in Google Maps.
+                                    "reviewId": "A String", # The ID of the review snippet.
+                                    "title": "A String", # Title of the review.
+                                    "url": "A String", # A link that corresponds to the user review on Google Maps.
+                                  },
+                                ],
+                                "url": "A String", # URI reference of the place.
+                              },
+                              "speechMetadata": { # Speech annotation for text content. # Speech annotation for text content.
+                                "speaker": "A String", # The speaker to associate with this turn.
+                                "style": "A String", # Style instruction for the speech synthesis.
+                              },
+                              "startIndex": 42, # Start of segment of the response that is attributed to this source. Index indicates the start of the segment, measured in bytes.
+                              "urlCitation": { # A URL citation annotation. # NOTE: We use these instead of the Citation message for historical reasons. A URL citation annotation.
+                                "title": "A String", # The title of the URL.
+                                "url": "A String", # The URL.
+                              },
+                              "wordInfo": { # Word-level ASR annotation for transcription output. Carries the word text, optional timing, and optional speaker attribution. # Word-level ASR annotation with timing and speaker info.
+                                "endOffset": "A String", # End offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                                "speaker": "A String", # Optional. Speaker label for this word (e.g. "spk_1", "spk_2"). Present when diarization_mode is set in TranscriptionConfig.
+                                "startOffset": "A String", # Start offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                                "text": "A String", # The transcribed word.
+                              },
+                            },
+                          ],
+                          "text": "A String", # Required. The text content.
+                        },
+                        "video": { # A video content block.
+                          "data": "A String", # The video content.
+                          "mimeTypeString": "A String", # Flexible MIME type string of the video, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                          "name": "A String", # A user-defined name for this content block. Can be referenced by the model in the final response.
+                          "processingConfig": {
+                            "static": {
+                              "endOffset": "A String", # Optional. Segment end time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "30s". Must be non-negative and greater than `start_offset` if `start_offset` is set.
+                              "fps": 3.14, # Optional. Video frame-rate sampling density.
+                              "startOffset": "A String", # Optional. Segment start time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "10.5s". Must be non-negative.
+                            },
+                          },
+                          "processingType": "A String",
+                          "resolution": "A String", # The resolution of the media.
+                          "uri": "A String", # The URI of the video.
+                        },
+                      },
+                      "listValue": { # `ListValue` is a wrapper around a repeated field of values. # Represents a repeated `Value`.
+                        "values": [ # Repeated field of dynamically typed values.
+                          # Object with schema name: GenaiVertexV1Value
+                        ],
+                      },
+                      "nullValue": "A String", # Represents a null value.
+                      "numberValue": 3.14, # Represents a double value.
+                      "stringValue": "A String", # Represents a string value.
+                      "structValue": # Object with schema name: GenaiVertexV1Struct # Represents a structured value.
+                    },
+                  },
+                ],
+              },
+              "name": "A String", # Required. The name of the tool to call.
+            },
+            "googleMapsCall": { # Google Maps call step.
+              "arguments": { # The arguments to pass to the Google Maps tool. # The arguments to pass to the Google Maps tool.
+                "queries": [ # The queries to be executed.
+                  "A String",
+                ],
+              },
+            },
+            "googleSearchCall": { # Google Search call step.
+              "arguments": { # The arguments to pass to Google Search. # Required. The arguments to pass to Google Search.
+                "queries": [ # Web search queries for the following-up web search.
+                  "A String",
+                ],
+              },
+              "searchType": "A String", # The type of search grounding enabled.
+            },
+            "id": "A String", # Required. A unique ID for this specific tool call.
+            "processingCall": { # A server-initiated processing step for media analysis (e.g. video understanding).
+            },
+            "retrievalCall": { # Retrieval call step. Used by Vertex Retrieval tools such as Parallel AI, Exa AI, Vertex AI Search, etc. RetrievalType decides which tool is used.
+              "arguments": { # The arguments to pass to Retrieval tools. # Required. The arguments to pass to the retrieval tool.
+                "queries": [ # Queries for Retrieval information.
+                  "A String",
+                ],
+              },
+              "retrievalType": "A String", # The type of retrieval tools.
+            },
+            "signature": "A String", # A signature hash for backend validation.
+            "urlContextCall": { # URL context call step.
+              "arguments": { # The arguments to pass to the URL context. # Required. The arguments to pass to the URL context.
+                "urls": [ # The URLs to fetch.
+                  "A String",
+                ],
+              },
+            },
+          },
+          "toolResult": { # Tool result step.
+            "callId": "A String", # Required. ID to match the ID from the function call block.
+            "codeExecutionResult": { # Code execution result step.
+              "isError": True or False, # Whether the code execution resulted in an error.
+              "result": "A String", # Required. The output of the code execution.
+            },
+            "fileSearchResult": { # File Search result step.
+            },
+            "functionResult": { # Result of a function tool call.
+              "isError": True or False, # Whether the tool call resulted in an error.
+              "name": "A String", # The name of the tool that was called.
+              "result": { # `Value` represents a dynamically typed value which can be either null, a number, a string, a boolean, a recursive struct value, or a list of values. A producer of value is expected to set one of these variants. Absence of any variant indicates an error. # Required. The result of the tool call.
+                "boolValue": True or False, # Represents a boolean value.
+                "contentValue": { # The content of the response. # Represents rich content (text, image, etc.).
+                  "audio": { # An audio content block.
+                    "channels": 42, # The number of audio channels.
+                    "data": "A String", # The audio content.
+                    "mimeTypeString": "A String", # Flexible MIME type string of the audio, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                    "sampleRate": 42, # The sample rate of the audio.
+                    "uri": "A String", # The URI of the audio.
+                  },
+                  "document": { # A document content block.
+                    "data": "A String", # The document content.
+                    "mimeTypeString": "A String", # Flexible MIME type string of the document, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                    "uri": "A String", # The URI of the document.
+                  },
+                  "image": { # An image content block.
+                    "data": "A String", # The image content.
+                    "mimeTypeString": "A String", # Flexible MIME type string of the image, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                    "resolution": "A String", # The resolution of the media.
+                    "uri": "A String", # The URI of the image.
+                  },
+                  "text": { # A text content block.
+                    "annotations": [ # Citation information for model-generated content.
+                      { # Citation information for model-generated content.
+                        "endIndex": 42, # End of the attributed segment, exclusive.
+                        "fileCitation": { # A file citation annotation. # A file citation annotation.
+                          "customMetadata": { # User provided metadata about the retrieved context.
+                            "a_key": "", # Properties of the object.
+                          },
+                          "documentUri": "A String", # The URI of the file.
+                          "fileName": "A String", # The name of the file.
+                          "mediaId": "A String", # Media ID in-case of image citations, if applicable.
+                          "pageNumber": 42, # Page number of the cited document, if applicable.
+                          "source": "A String", # Source attributed for a portion of the text.
+                        },
+                        "placeCitation": { # A place citation annotation. # A place citation annotation.
+                          "name": "A String", # Title of the place.
+                          "placeId": "A String", # The ID of the place, in `places/{place_id}` format.
+                          "reviewSnippets": [ # Snippets of reviews that are used to generate answers about the features of a given place in Google Maps.
+                            { # Encapsulates a snippet of a user review that answers a question about the features of a specific place in Google Maps.
+                              "reviewId": "A String", # The ID of the review snippet.
+                              "title": "A String", # Title of the review.
+                              "url": "A String", # A link that corresponds to the user review on Google Maps.
+                            },
+                          ],
+                          "url": "A String", # URI reference of the place.
+                        },
+                        "speechMetadata": { # Speech annotation for text content. # Speech annotation for text content.
+                          "speaker": "A String", # The speaker to associate with this turn.
+                          "style": "A String", # Style instruction for the speech synthesis.
+                        },
+                        "startIndex": 42, # Start of segment of the response that is attributed to this source. Index indicates the start of the segment, measured in bytes.
+                        "urlCitation": { # A URL citation annotation. # NOTE: We use these instead of the Citation message for historical reasons. A URL citation annotation.
+                          "title": "A String", # The title of the URL.
+                          "url": "A String", # The URL.
+                        },
+                        "wordInfo": { # Word-level ASR annotation for transcription output. Carries the word text, optional timing, and optional speaker attribution. # Word-level ASR annotation with timing and speaker info.
+                          "endOffset": "A String", # End offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                          "speaker": "A String", # Optional. Speaker label for this word (e.g. "spk_1", "spk_2"). Present when diarization_mode is set in TranscriptionConfig.
+                          "startOffset": "A String", # Start offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                          "text": "A String", # The transcribed word.
+                        },
+                      },
+                    ],
+                    "text": "A String", # Required. The text content.
+                  },
+                  "video": { # A video content block.
+                    "data": "A String", # The video content.
+                    "mimeTypeString": "A String", # Flexible MIME type string of the video, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                    "name": "A String", # A user-defined name for this content block. Can be referenced by the model in the final response.
+                    "processingConfig": {
+                      "static": {
+                        "endOffset": "A String", # Optional. Segment end time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "30s". Must be non-negative and greater than `start_offset` if `start_offset` is set.
+                        "fps": 3.14, # Optional. Video frame-rate sampling density.
+                        "startOffset": "A String", # Optional. Segment start time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "10.5s". Must be non-negative.
+                      },
+                    },
+                    "processingType": "A String",
+                    "resolution": "A String", # The resolution of the media.
+                    "uri": "A String", # The URI of the video.
+                  },
+                },
+                "listValue": { # `ListValue` is a wrapper around a repeated field of values. # Represents a repeated `Value`.
+                  "values": [ # Repeated field of dynamically typed values.
+                    # Object with schema name: GenaiVertexV1Value
+                  ],
+                },
+                "nullValue": "A String", # Represents a null value.
+                "numberValue": 3.14, # Represents a double value.
+                "stringValue": "A String", # Represents a string value.
+                "structValue": # Object with schema name: GenaiVertexV1Struct # Represents a structured value.
+              },
+            },
+            "googleMapsResult": { # Google Maps result step.
+              "result": [
+                { # The result of the Google Maps.
+                  "places": [
+                    {
+                      "name": "A String",
+                      "placeId": "A String",
+                      "reviewSnippets": [
+                        { # Encapsulates a snippet of a user review that answers a question about the features of a specific place in Google Maps.
+                          "reviewId": "A String", # The ID of the review snippet.
+                          "title": "A String", # Title of the review.
+                          "url": "A String", # A link that corresponds to the user review on Google Maps.
+                        },
+                      ],
+                      "url": "A String",
+                    },
+                  ],
+                  "widgetContextToken": "A String",
+                },
+              ],
+            },
+            "googleSearchResult": { # Google Search result step.
+              "isError": True or False, # Whether the Google Search resulted in an error.
+              "result": [ # Required. The results of the Google Search.
+                { # The result of the Google Search.
+                  "searchSuggestions": "A String", # Web content snippet that can be embedded in a web page or an app webview.
+                },
+              ],
+            },
+            "processingResult": { # The result of a server-initiated media processing step.
+            },
+            "retrievalResult": { # Vertex Retrieval result step. Used by Vertex Retrieval tools such as Parallel AI, Exa AI, Vertex AI Search, etc.
+              "isError": True or False, # Whether the retrieval resulted in an error.
+            },
+            "signature": "A String", # A signature hash for backend validation.
+            "urlContextResult": { # URL context result step.
+              "isError": True or False, # Whether the URL context resulted in an error.
+              "result": [ # Required. The results of the URL context.
+                { # The result of the URL context.
+                  "status": "A String", # The status of the URL retrieval.
+                  "url": "A String", # The URL that was fetched.
+                },
+              ],
+            },
+          },
+          "userInput": { # Input provided by the user. # DO NOT USE -- These are for 3P JSON only
+            "contentList": { # A list of Content. # The content of the step. An array of Content objects.
+              "contents": [ # The contents of the list.
+                { # The content of the response.
+                  "audio": { # An audio content block.
+                    "channels": 42, # The number of audio channels.
+                    "data": "A String", # The audio content.
+                    "mimeTypeString": "A String", # Flexible MIME type string of the audio, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                    "sampleRate": 42, # The sample rate of the audio.
+                    "uri": "A String", # The URI of the audio.
+                  },
+                  "document": { # A document content block.
+                    "data": "A String", # The document content.
+                    "mimeTypeString": "A String", # Flexible MIME type string of the document, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                    "uri": "A String", # The URI of the document.
+                  },
+                  "image": { # An image content block.
+                    "data": "A String", # The image content.
+                    "mimeTypeString": "A String", # Flexible MIME type string of the image, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                    "resolution": "A String", # The resolution of the media.
+                    "uri": "A String", # The URI of the image.
+                  },
+                  "text": { # A text content block.
+                    "annotations": [ # Citation information for model-generated content.
+                      { # Citation information for model-generated content.
+                        "endIndex": 42, # End of the attributed segment, exclusive.
+                        "fileCitation": { # A file citation annotation. # A file citation annotation.
+                          "customMetadata": { # User provided metadata about the retrieved context.
+                            "a_key": "", # Properties of the object.
+                          },
+                          "documentUri": "A String", # The URI of the file.
+                          "fileName": "A String", # The name of the file.
+                          "mediaId": "A String", # Media ID in-case of image citations, if applicable.
+                          "pageNumber": 42, # Page number of the cited document, if applicable.
+                          "source": "A String", # Source attributed for a portion of the text.
+                        },
+                        "placeCitation": { # A place citation annotation. # A place citation annotation.
+                          "name": "A String", # Title of the place.
+                          "placeId": "A String", # The ID of the place, in `places/{place_id}` format.
+                          "reviewSnippets": [ # Snippets of reviews that are used to generate answers about the features of a given place in Google Maps.
+                            { # Encapsulates a snippet of a user review that answers a question about the features of a specific place in Google Maps.
+                              "reviewId": "A String", # The ID of the review snippet.
+                              "title": "A String", # Title of the review.
+                              "url": "A String", # A link that corresponds to the user review on Google Maps.
+                            },
+                          ],
+                          "url": "A String", # URI reference of the place.
+                        },
+                        "speechMetadata": { # Speech annotation for text content. # Speech annotation for text content.
+                          "speaker": "A String", # The speaker to associate with this turn.
+                          "style": "A String", # Style instruction for the speech synthesis.
+                        },
+                        "startIndex": 42, # Start of segment of the response that is attributed to this source. Index indicates the start of the segment, measured in bytes.
+                        "urlCitation": { # A URL citation annotation. # NOTE: We use these instead of the Citation message for historical reasons. A URL citation annotation.
+                          "title": "A String", # The title of the URL.
+                          "url": "A String", # The URL.
+                        },
+                        "wordInfo": { # Word-level ASR annotation for transcription output. Carries the word text, optional timing, and optional speaker attribution. # Word-level ASR annotation with timing and speaker info.
+                          "endOffset": "A String", # End offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                          "speaker": "A String", # Optional. Speaker label for this word (e.g. "spk_1", "spk_2"). Present when diarization_mode is set in TranscriptionConfig.
+                          "startOffset": "A String", # Start offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                          "text": "A String", # The transcribed word.
+                        },
+                      },
+                    ],
+                    "text": "A String", # Required. The text content.
+                  },
+                  "video": { # A video content block.
+                    "data": "A String", # The video content.
+                    "mimeTypeString": "A String", # Flexible MIME type string of the video, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                    "name": "A String", # A user-defined name for this content block. Can be referenced by the model in the final response.
+                    "processingConfig": {
+                      "static": {
+                        "endOffset": "A String", # Optional. Segment end time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "30s". Must be non-negative and greater than `start_offset` if `start_offset` is set.
+                        "fps": 3.14, # Optional. Video frame-rate sampling density.
+                        "startOffset": "A String", # Optional. Segment start time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "10.5s". Must be non-negative.
+                      },
+                    },
+                    "processingType": "A String",
+                    "resolution": "A String", # The resolution of the media.
+                    "uri": "A String", # The URI of the video.
+                  },
+                },
+              ],
+            },
+            "contentString": "A String", # The content of the step. A single string.
+          },
+        },
+      ],
+      "stringContent": "A String", # A string input for the interaction, it will be processed as a single text input.
+      "systemInstruction": "A String", # System instruction for the interaction.
+      "tools": [ # A list of tool declarations the model may call during interaction.
+        { # A tool that can be used by the model.
+          "codeExecution": { # A tool that can be used by the model to execute code. # A tool that can be used by the model to execute code.
+          },
+          "computerUse": { # A tool that can be used by the model to interact with the computer. # Tool to support the model interacting directly with the computer.
+            "disabledSafetyPolicies": [ # Optional. Disabled safety policies for computer use.
+              "A String",
+            ],
+            "enablePromptInjectionDetection": True or False, # Whether enable the prompt injection detection check on computer-use request.
+            "environment": "A String", # The environment being operated.
+            "excludedPredefinedFunctions": [ # The list of predefined functions that are excluded from the model call.
+              "A String",
+            ],
+          },
+          "fileSearch": { # A tool that can be used by the model to search files. # A tool that can be used by the model to search files.
+            "fileSearchStoreNames": [ # The file search store names to search.
+              "A String",
+            ],
+            "metadataFilter": "A String", # Metadata filter to apply to the semantic retrieval documents and chunks.
+            "topK": 42, # The number of semantic retrieval chunks to retrieve.
+          },
+          "function": { # A tool that can be used by the model. # A function that can be used by the model.
+            "description": "A String", # A description of the function.
+            "name": "A String", # The name of the function.
+            "parameters": { # `Value` represents a dynamically typed value which can be either null, a number, a string, a boolean, a recursive struct value, or a list of values. A producer of value is expected to set one of these variants. Absence of any variant indicates an error. # The JSON Schema for the function's parameters.
+              "boolValue": True or False, # Represents a boolean value.
+              "contentValue": { # The content of the response. # Represents rich content (text, image, etc.).
+                "audio": { # An audio content block.
+                  "channels": 42, # The number of audio channels.
+                  "data": "A String", # The audio content.
+                  "mimeTypeString": "A String", # Flexible MIME type string of the audio, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                  "sampleRate": 42, # The sample rate of the audio.
+                  "uri": "A String", # The URI of the audio.
+                },
+                "document": { # A document content block.
+                  "data": "A String", # The document content.
+                  "mimeTypeString": "A String", # Flexible MIME type string of the document, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                  "uri": "A String", # The URI of the document.
+                },
+                "image": { # An image content block.
+                  "data": "A String", # The image content.
+                  "mimeTypeString": "A String", # Flexible MIME type string of the image, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                  "resolution": "A String", # The resolution of the media.
+                  "uri": "A String", # The URI of the image.
+                },
+                "text": { # A text content block.
+                  "annotations": [ # Citation information for model-generated content.
+                    { # Citation information for model-generated content.
+                      "endIndex": 42, # End of the attributed segment, exclusive.
+                      "fileCitation": { # A file citation annotation. # A file citation annotation.
+                        "customMetadata": { # User provided metadata about the retrieved context.
+                          "a_key": "", # Properties of the object.
+                        },
+                        "documentUri": "A String", # The URI of the file.
+                        "fileName": "A String", # The name of the file.
+                        "mediaId": "A String", # Media ID in-case of image citations, if applicable.
+                        "pageNumber": 42, # Page number of the cited document, if applicable.
+                        "source": "A String", # Source attributed for a portion of the text.
+                      },
+                      "placeCitation": { # A place citation annotation. # A place citation annotation.
+                        "name": "A String", # Title of the place.
+                        "placeId": "A String", # The ID of the place, in `places/{place_id}` format.
+                        "reviewSnippets": [ # Snippets of reviews that are used to generate answers about the features of a given place in Google Maps.
+                          { # Encapsulates a snippet of a user review that answers a question about the features of a specific place in Google Maps.
+                            "reviewId": "A String", # The ID of the review snippet.
+                            "title": "A String", # Title of the review.
+                            "url": "A String", # A link that corresponds to the user review on Google Maps.
+                          },
+                        ],
+                        "url": "A String", # URI reference of the place.
+                      },
+                      "speechMetadata": { # Speech annotation for text content. # Speech annotation for text content.
+                        "speaker": "A String", # The speaker to associate with this turn.
+                        "style": "A String", # Style instruction for the speech synthesis.
+                      },
+                      "startIndex": 42, # Start of segment of the response that is attributed to this source. Index indicates the start of the segment, measured in bytes.
+                      "urlCitation": { # A URL citation annotation. # NOTE: We use these instead of the Citation message for historical reasons. A URL citation annotation.
+                        "title": "A String", # The title of the URL.
+                        "url": "A String", # The URL.
+                      },
+                      "wordInfo": { # Word-level ASR annotation for transcription output. Carries the word text, optional timing, and optional speaker attribution. # Word-level ASR annotation with timing and speaker info.
+                        "endOffset": "A String", # End offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                        "speaker": "A String", # Optional. Speaker label for this word (e.g. "spk_1", "spk_2"). Present when diarization_mode is set in TranscriptionConfig.
+                        "startOffset": "A String", # Start offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                        "text": "A String", # The transcribed word.
+                      },
+                    },
+                  ],
+                  "text": "A String", # Required. The text content.
+                },
+                "video": { # A video content block.
+                  "data": "A String", # The video content.
+                  "mimeTypeString": "A String", # Flexible MIME type string of the video, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                  "name": "A String", # A user-defined name for this content block. Can be referenced by the model in the final response.
+                  "processingConfig": {
+                    "static": {
+                      "endOffset": "A String", # Optional. Segment end time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "30s". Must be non-negative and greater than `start_offset` if `start_offset` is set.
+                      "fps": 3.14, # Optional. Video frame-rate sampling density.
+                      "startOffset": "A String", # Optional. Segment start time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "10.5s". Must be non-negative.
+                    },
+                  },
+                  "processingType": "A String",
+                  "resolution": "A String", # The resolution of the media.
+                  "uri": "A String", # The URI of the video.
+                },
+              },
+              "listValue": { # `ListValue` is a wrapper around a repeated field of values. # Represents a repeated `Value`.
+                "values": [ # Repeated field of dynamically typed values.
+                  # Object with schema name: GenaiVertexV1Value
+                ],
+              },
+              "nullValue": "A String", # Represents a null value.
+              "numberValue": 3.14, # Represents a double value.
+              "stringValue": "A String", # Represents a string value.
+              "structValue": # Object with schema name: GenaiVertexV1Struct # Represents a structured value.
+            },
+          },
+          "googleMaps": { # A tool that can be used by the model to call Google Maps. # A tool that can be used by the model to search Google Maps.
+            "enableWidget": True or False, # Whether to return a widget context token in the tool call result of the response.
+            "latitude": 3.14, # The latitude of the user's location.
+            "longitude": 3.14, # The longitude of the user's location.
+          },
+          "googleSearch": { # A tool that can be used by the model to search Google. # A tool that can be used by the model to search Google.
+            "searchTypes": [ # The types of search grounding to enable.
+              "A String",
+            ],
+          },
+          "mcpServer": { # A MCPServer is a server that can be called by the model to perform actions. # A MCPServer is a server that can be called by the model to perform actions.
+            "allowedTools": [ # The allowed tools.
+              { # The configuration for allowed tools.
+                "mode": "A String", # The mode of the tool choice.
+                "tools": [ # The names of the allowed tools.
+                  "A String",
+                ],
+              },
+            ],
+            "headers": { # Optional: Fields for authentication headers, timeouts, etc., if needed.
+              "a_key": "A String",
+            },
+            "name": "A String", # The name of the MCPServer.
+            "url": "A String", # The full URL for the MCPServer endpoint. Example: "https://api.example.com/mcp"
+          },
+          "retrieval": { # A tool that can be used by the model to retrieve files. # A tool that can be used by the model to retrieve files.
+            "exaAiSearchConfig": { # Used to specify configuration for ExaAISearch. # Used to specify configuration for ExaAISearch.
+              "apiKey": "A String", # Required. The API key for ExaAiSearch.
+              "customConfig": { # Optional. This field can be used to pass any parameter from the Exa.ai Search API.
+                "a_key": "", # Properties of the object.
+              },
+            },
+            "parallelAiSearchConfig": { # Used to specify configuration for ParallelAISearch. # Used to specify configuration for ParallelAISearch.
+              "apiKey": "A String", # Optional. The API key for ParallelAiSearch.
+              "customConfig": { # Optional. Custom configs for ParallelAiSearch.
+                "a_key": "", # Properties of the object.
+              },
+            },
+            "ragStoreConfig": { # Use to specify configuration for RAG Store. # Used to specify configuration for RagStore.
+              "ragResources": [ # Optional. The representation of the rag source.
+                { # The definition of the Rag resource.
+                  "ragCorpus": "A String", # Optional. RagCorpora resource name.
+                  "ragFileIds": [ # Optional. rag_file_id. The files should be in the same rag_corpus set in rag_corpus field.
+                    "A String",
+                  ],
+                },
+              ],
+              "ragRetrievalConfig": { # Specifies the context retrieval config. # Optional. The retrieval config for the Rag query.
+                "filter": { # Config for filters. # Optional. Config for filters.
+                  "metadataFilter": "A String", # Optional. String for metadata filtering.
+                  "vectorDistanceThreshold": 3.14, # Optional. Only returns contexts with vector distance smaller than the threshold.
+                  "vectorSimilarityThreshold": 3.14, # Optional. Only returns contexts with vector similarity larger than the threshold.
+                },
+                "hybridSearch": { # Config for Hybrid Search. # Optional. Config for Hybrid Search.
+                  "alpha": 3.14, # Optional. Alpha value controls the weight between dense and sparse vector search results.
+                },
+                "ranking": { # Config for ranking and reranking. # Optional. Config for ranking and reranking.
+                  "rankService": { # Config for Rank Service. # Config for Rank Service.
+                    "modelName": "A String", # Optional. The model name of the rank service.
+                  },
+                },
+                "topK": 42, # Optional. The number of contexts to retrieve.
+              },
+            },
+            "retrievalTypes": [ # The types of file retrieval to enable.
+              "A String",
+            ],
+            "vertexAiSearchConfig": { # Used to specify configuration for VertexAISearch. # Used to specify configuration for VertexAISearch.
+              "datastores": [ # Optional. Used to specify Vertex AI Search datastores.
+                "A String",
+              ],
+              "engine": "A String", # Optional. Used to specify Vertex AI Search engine.
+            },
+          },
+          "urlContext": { # A tool that can be used by the model to fetch URL context. # A tool that can be used by the model to fetch URL context.
+          },
+        },
+      ],
+      "updated": "A String", # Required. Output only. The time at which the response was last updated in ISO 8601 format (YYYY-MM-DDThh:mm:ssZ).
+      "usage": { # Statistics on the interaction request's token usage. # Output only. Statistics on the interaction request's token usage.
+        "cachedTokensByModality": [ # A breakdown of cached token usage by modality.
+          { # The token count for a single response modality.
+            "modality": "A String", # The modality associated with the token count.
+            "tokens": 42, # Number of tokens for the modality.
+          },
+        ],
+        "groundingToolCount": [ # Grounding tool count.
+          { # The number of grounding tool counts.
+            "count": 42, # The number of grounding tool counts.
+            "type": "A String", # The grounding tool type associated with the count.
+          },
+        ],
+        "inputTokensByModality": [ # A breakdown of input token usage by modality.
+          { # The token count for a single response modality.
+            "modality": "A String", # The modality associated with the token count.
+            "tokens": 42, # Number of tokens for the modality.
+          },
+        ],
+        "outputTokensByModality": [ # A breakdown of output token usage by modality.
+          { # The token count for a single response modality.
+            "modality": "A String", # The modality associated with the token count.
+            "tokens": 42, # Number of tokens for the modality.
+          },
+        ],
+        "toolUseTokensByModality": [ # A breakdown of tool-use token usage by modality.
+          { # The token count for a single response modality.
+            "modality": "A String", # The modality associated with the token count.
+            "tokens": 42, # Number of tokens for the modality.
+          },
+        ],
+        "totalCachedTokens": 42, # Number of tokens in the cached part of the prompt (the cached content).
+        "totalInputTokens": 42, # Number of tokens in the prompt (context).
+        "totalOutputTokens": 42, # Total number of tokens across all the generated responses.
+        "totalThoughtTokens": 42, # Number of tokens of thoughts for thinking models.
+        "totalTokens": 42, # Total token count for the interaction request (prompt + responses + other internal tokens).
+        "totalToolUseTokens": 42, # Number of tokens present in tool-use prompt(s).
+      },
+    },
+  },
+  "interactionCreatedEvent": { # Server response confirming that a new interaction was created. # The interaction data, used for interaction.created events. Used when steps are enabled.
+    "interaction": { # Response for InteractionService.CreateInteraction. # Required. Partial interaction resource emitted when the stream is created.
+      "agentInteraction": { # Interaction for generating the completion using agents. # Interaction for generating the completion using agents.
+        "agent": "A String", # The name of the `Agent` used for generating the completion.
+        "antigravityConfig": { # Configuration for the Antigravity agent runtime. Provides server-side control over the agent's execution environment and tool configuration. # Antigravity agent configuration. This configuration is session-level settings that are passed to the agent runtime on a per-request basis.
+          "maxTotalTokens": "A String", # Max total tokens for the agent run.
+          "model": "A String", # The model to use for agent reasoning.
+        },
+        "codeMenderConfig": { # Configuration for the CodeMender agent.
+          "findRequest": { # Request parameters specific to FIND sessions, used for discovering vulnerabilities in a codebase. # Parameters for finding vulnerabilities.
+            "description": "A String", # Additional context or custom instructions provided by the user to guide the vulnerability analysis.
+            "findingId": "A String", # The identifier of a specific finding to verify. This is primarily used in VERIFY mode to focus the agent's execution-based validation on a single vulnerability.
+            "mode": "A String", # The mode of the find session.
+            "sourceFiles": [ # A list of source files to provide as context for the scan.
+              { # Content of a single file in the codebase.
+                "content": "A String", # The UTF-8 encoded text content of the file.
+                "path": "A String", # The relative path of the file from the project root.
+              },
+            ],
+          },
+          "fixRequest": { # Request parameters specific to FIX sessions, used for generating and validating security patches. # Parameters for fixing vulnerabilities.
+            "description": "A String", # Additional context or custom instructions provided by the user to guide the patch generation process.
+            "findingId": "A String", # The identifier of the specific security finding to be remediated. This ID maps to a previously discovered vulnerability.
+            "sourceFiles": [ # A list of source files providing context for the remediation. These files are typically the ones containing the identified vulnerability.
+              { # Content of a single file in the codebase.
+                "content": "A String", # The UTF-8 encoded text content of the file.
+                "path": "A String", # The relative path of the file from the project root.
+              },
+            ],
+          },
+          "model": "A String", # The name of the model to use for the CodeMender agent. One CodeMender session will only use one model.
+          "sessionConfig": { # The configuration of CodeMender sessions. # Optional session-specific configurations to override default agent behavior.
+            "maxRounds": 42, # The maximum number of interaction rounds the agent is allowed to perform before reaching a timeout.
+          },
+          "sessionId": "A String", # Parameter for grouping multiple interactions that belong to the same CodeMender session.
+        },
+        "deepResearchConfig": { # Configuration for the Deep Research agent.
+          "collaborativePlanning": True or False, # Enables human-in-the-loop planning for the Deep Research agent. If set to true, the Deep Research agent will provide a research plan in its response. The agent will then proceed only if the user confirms the plan in the next turn.
+          "enableBigqueryTool": True or False, # Enables bigquery tool for the Deep Research agent.
+          "thinkingSummaries": "A String", # Whether to include thought summaries in the response.
+          "visualization": "A String", # Whether to include visualizations in the response.
+        },
+        "dynamicConfig": { # Configuration for dynamic agents.
+          "config": { # `Struct` represents a structured data value, consisting of fields which map to dynamically typed values. # For agents that are not supported statically in the API definition.
+            "fields": [ # Dynamically typed fields. List instead of map because LLMs are sensitive to ordering, and we want to give users full control.
+              { # Represents a single field in a struct.
+                "name": "A String",
+                "value": { # `Value` represents a dynamically typed value which can be either null, a number, a string, a boolean, a recursive struct value, or a list of values. A producer of value is expected to set one of these variants. Absence of any variant indicates an error.
+                  "boolValue": True or False, # Represents a boolean value.
+                  "contentValue": { # The content of the response. # Represents rich content (text, image, etc.).
+                    "audio": { # An audio content block.
+                      "channels": 42, # The number of audio channels.
+                      "data": "A String", # The audio content.
+                      "mimeTypeString": "A String", # Flexible MIME type string of the audio, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                      "sampleRate": 42, # The sample rate of the audio.
+                      "uri": "A String", # The URI of the audio.
+                    },
+                    "document": { # A document content block.
+                      "data": "A String", # The document content.
+                      "mimeTypeString": "A String", # Flexible MIME type string of the document, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                      "uri": "A String", # The URI of the document.
+                    },
+                    "image": { # An image content block.
+                      "data": "A String", # The image content.
+                      "mimeTypeString": "A String", # Flexible MIME type string of the image, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                      "resolution": "A String", # The resolution of the media.
+                      "uri": "A String", # The URI of the image.
+                    },
+                    "text": { # A text content block.
+                      "annotations": [ # Citation information for model-generated content.
+                        { # Citation information for model-generated content.
+                          "endIndex": 42, # End of the attributed segment, exclusive.
+                          "fileCitation": { # A file citation annotation. # A file citation annotation.
+                            "customMetadata": { # User provided metadata about the retrieved context.
+                              "a_key": "", # Properties of the object.
+                            },
+                            "documentUri": "A String", # The URI of the file.
+                            "fileName": "A String", # The name of the file.
+                            "mediaId": "A String", # Media ID in-case of image citations, if applicable.
+                            "pageNumber": 42, # Page number of the cited document, if applicable.
+                            "source": "A String", # Source attributed for a portion of the text.
+                          },
+                          "placeCitation": { # A place citation annotation. # A place citation annotation.
+                            "name": "A String", # Title of the place.
+                            "placeId": "A String", # The ID of the place, in `places/{place_id}` format.
+                            "reviewSnippets": [ # Snippets of reviews that are used to generate answers about the features of a given place in Google Maps.
+                              { # Encapsulates a snippet of a user review that answers a question about the features of a specific place in Google Maps.
+                                "reviewId": "A String", # The ID of the review snippet.
+                                "title": "A String", # Title of the review.
+                                "url": "A String", # A link that corresponds to the user review on Google Maps.
+                              },
+                            ],
+                            "url": "A String", # URI reference of the place.
+                          },
+                          "speechMetadata": { # Speech annotation for text content. # Speech annotation for text content.
+                            "speaker": "A String", # The speaker to associate with this turn.
+                            "style": "A String", # Style instruction for the speech synthesis.
+                          },
+                          "startIndex": 42, # Start of segment of the response that is attributed to this source. Index indicates the start of the segment, measured in bytes.
+                          "urlCitation": { # A URL citation annotation. # NOTE: We use these instead of the Citation message for historical reasons. A URL citation annotation.
+                            "title": "A String", # The title of the URL.
+                            "url": "A String", # The URL.
+                          },
+                          "wordInfo": { # Word-level ASR annotation for transcription output. Carries the word text, optional timing, and optional speaker attribution. # Word-level ASR annotation with timing and speaker info.
+                            "endOffset": "A String", # End offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                            "speaker": "A String", # Optional. Speaker label for this word (e.g. "spk_1", "spk_2"). Present when diarization_mode is set in TranscriptionConfig.
+                            "startOffset": "A String", # Start offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                            "text": "A String", # The transcribed word.
+                          },
+                        },
+                      ],
+                      "text": "A String", # Required. The text content.
+                    },
+                    "video": { # A video content block.
+                      "data": "A String", # The video content.
+                      "mimeTypeString": "A String", # Flexible MIME type string of the video, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                      "name": "A String", # A user-defined name for this content block. Can be referenced by the model in the final response.
+                      "processingConfig": {
+                        "static": {
+                          "endOffset": "A String", # Optional. Segment end time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "30s". Must be non-negative and greater than `start_offset` if `start_offset` is set.
+                          "fps": 3.14, # Optional. Video frame-rate sampling density.
+                          "startOffset": "A String", # Optional. Segment start time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "10.5s". Must be non-negative.
+                        },
+                      },
+                      "processingType": "A String",
+                      "resolution": "A String", # The resolution of the media.
+                      "uri": "A String", # The URI of the video.
+                    },
+                  },
+                  "listValue": { # `ListValue` is a wrapper around a repeated field of values. # Represents a repeated `Value`.
+                    "values": [ # Repeated field of dynamically typed values.
+                      # Object with schema name: GenaiVertexV1Value
+                    ],
+                  },
+                  "nullValue": "A String", # Represents a null value.
+                  "numberValue": 3.14, # Represents a double value.
+                  "stringValue": "A String", # Represents a string value.
+                  "structValue": # Object with schema name: GenaiVertexV1Struct # Represents a structured value.
+                },
+              },
+            ],
+          },
+        },
+      },
+      "content": { # The content of the response. # The content for the interaction.
+        "audio": { # An audio content block.
+          "channels": 42, # The number of audio channels.
+          "data": "A String", # The audio content.
+          "mimeTypeString": "A String", # Flexible MIME type string of the audio, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+          "sampleRate": 42, # The sample rate of the audio.
+          "uri": "A String", # The URI of the audio.
+        },
+        "document": { # A document content block.
+          "data": "A String", # The document content.
+          "mimeTypeString": "A String", # Flexible MIME type string of the document, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+          "uri": "A String", # The URI of the document.
+        },
+        "image": { # An image content block.
+          "data": "A String", # The image content.
+          "mimeTypeString": "A String", # Flexible MIME type string of the image, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+          "resolution": "A String", # The resolution of the media.
+          "uri": "A String", # The URI of the image.
+        },
+        "text": { # A text content block.
+          "annotations": [ # Citation information for model-generated content.
+            { # Citation information for model-generated content.
+              "endIndex": 42, # End of the attributed segment, exclusive.
+              "fileCitation": { # A file citation annotation. # A file citation annotation.
+                "customMetadata": { # User provided metadata about the retrieved context.
+                  "a_key": "", # Properties of the object.
+                },
+                "documentUri": "A String", # The URI of the file.
+                "fileName": "A String", # The name of the file.
+                "mediaId": "A String", # Media ID in-case of image citations, if applicable.
+                "pageNumber": 42, # Page number of the cited document, if applicable.
+                "source": "A String", # Source attributed for a portion of the text.
+              },
+              "placeCitation": { # A place citation annotation. # A place citation annotation.
+                "name": "A String", # Title of the place.
+                "placeId": "A String", # The ID of the place, in `places/{place_id}` format.
+                "reviewSnippets": [ # Snippets of reviews that are used to generate answers about the features of a given place in Google Maps.
+                  { # Encapsulates a snippet of a user review that answers a question about the features of a specific place in Google Maps.
+                    "reviewId": "A String", # The ID of the review snippet.
+                    "title": "A String", # Title of the review.
+                    "url": "A String", # A link that corresponds to the user review on Google Maps.
+                  },
+                ],
+                "url": "A String", # URI reference of the place.
+              },
+              "speechMetadata": { # Speech annotation for text content. # Speech annotation for text content.
+                "speaker": "A String", # The speaker to associate with this turn.
+                "style": "A String", # Style instruction for the speech synthesis.
+              },
+              "startIndex": 42, # Start of segment of the response that is attributed to this source. Index indicates the start of the segment, measured in bytes.
+              "urlCitation": { # A URL citation annotation. # NOTE: We use these instead of the Citation message for historical reasons. A URL citation annotation.
+                "title": "A String", # The title of the URL.
+                "url": "A String", # The URL.
+              },
+              "wordInfo": { # Word-level ASR annotation for transcription output. Carries the word text, optional timing, and optional speaker attribution. # Word-level ASR annotation with timing and speaker info.
+                "endOffset": "A String", # End offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                "speaker": "A String", # Optional. Speaker label for this word (e.g. "spk_1", "spk_2"). Present when diarization_mode is set in TranscriptionConfig.
+                "startOffset": "A String", # Start offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                "text": "A String", # The transcribed word.
+              },
+            },
+          ],
+          "text": "A String", # Required. The text content.
+        },
+        "video": { # A video content block.
+          "data": "A String", # The video content.
+          "mimeTypeString": "A String", # Flexible MIME type string of the video, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+          "name": "A String", # A user-defined name for this content block. Can be referenced by the model in the final response.
+          "processingConfig": {
+            "static": {
+              "endOffset": "A String", # Optional. Segment end time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "30s". Must be non-negative and greater than `start_offset` if `start_offset` is set.
+              "fps": 3.14, # Optional. Video frame-rate sampling density.
+              "startOffset": "A String", # Optional. Segment start time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "10.5s". Must be non-negative.
+            },
+          },
+          "processingType": "A String",
+          "resolution": "A String", # The resolution of the media.
+          "uri": "A String", # The URI of the video.
+        },
+      },
+      "created": "A String", # Required. Output only. The time at which the response was created in ISO 8601 format (YYYY-MM-DDThh:mm:ssZ).
+      "envId": "A String", # The environment ID for the interaction. Can be 'remote' for default environment.
+      "environmentId": "A String", # Output only. The environment ID for the interaction. Only populated if environment config is set in the request.
+      "errors": [ # Output only. Diagnostic faults / platform errors recorded on the interaction.
+        { # Error message from an interaction.
+          "code": "A String", # A URI that identifies the error type.
+          "message": "A String", # A human-readable error message.
+        },
+      ],
+      "id": "A String", # Required. Output only. A unique identifier for the interaction completion.
+      "labels": { # The labels with user-defined metadata for the request. 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",
+      },
+      "modelInteraction": { # Interaction for generating the completion using models. # Interaction for generating the completion using models.
+        "generationConfig": { # Configuration parameters for model interactions. # Input only. Configuration parameters for the model interaction.
+          "maxOutputTokens": 42, # The maximum number of tokens to include in the response.
+          "seed": 42, # Seed used in decoding for reproducibility.
+          "stopSequences": [ # A list of character sequences that will stop output interaction.
+            "A String",
+          ],
+          "structuredSpeechConfig": { # Configuration for multi-speaker and speech generation. # Speech and multi-speaker configuration.
+            "speakers": [ # Individual speaker configurations.
+              { # The configuration for speech interaction.
+                "language": "A String", # The language of the speech.
+                "speaker": "A String", # The speaker's name, it should match the speaker name given in the prompt.
+                "voice": "A String", # The voice of the speaker.
+              },
+            ],
+          },
+          "temperature": 3.14, # Controls the randomness of the output.
+          "thinkingLevel": "A String", # The level of thought tokens that the model should generate.
+          "thinkingSummaries": "A String", # Whether to include thought summaries in the response.
+          "toolChoiceConfig": { # The tool choice configuration containing allowed tools. # The config for the tool choice.
+            "allowedTools": { # The configuration for allowed tools. # The allowed tools.
+              "mode": "A String", # The mode of the tool choice.
+              "tools": [ # The names of the allowed tools.
+                "A String",
+              ],
+            },
+          },
+          "toolChoiceMode": "A String", # The mode of the tool choice.
+          "topP": 3.14, # The maximum cumulative probability of tokens to consider when sampling.
+          "transcriptionConfig": { # Configuration for speech recognition (transcription). # Optional. Configuration for speech recognition (transcription). If present, ASR is enabled.
+            "adaptationPhrases": [ # Optional. A list of phrases to bias the ASR model towards.
+              "A String",
+            ],
+            "customVocabulary": [ # Optional. A list of custom vocabulary phrases to bias the speech recognition model toward recognizing specific terms.
+              "A String",
+            ],
+            "diarizationMode": "A String", # Optional. Configures speaker diarization. Supported values: "speaker".
+            "languageCodes": [ # Optional. BCP-47 language codes providing hints about the languages present in the audio. If omitted or empty, defaults to automatic language detection.
+              "A String",
+            ],
+            "timestampGranularities": [ # Optional. The granularity of timestamps to include in the transcription output. Supported values: "word". If empty, no timestamps are generated.
+              "A String",
+            ],
+          },
+          "videoConfig": { # Configuration options for video generation. # Configuration for video generation.
+            "task": "A String", # Optional task mode for video generation. If not specified, the model automatically determines the appropriate mode based on the provided text prompt and input media.
+          },
+        },
+        "model": "A String", # The name of the `Model` used for generating the completion.
+      },
+      "previousInteractionId": "A String", # The ID of the previous interaction, if any.
+      "responseFormatList": {
+        "responseFormats": [
+          {
+            "audio": { # Configuration for audio output format.
+              "bitRate": 42, # Bit rate in bits per second (bps). Only applicable for compressed formats (MP3, Opus).
+              "delivery": "A String", # The delivery mode for the audio output.
+              "mimeType": "A String", # The MIME type of the audio output.
+              "sampleRate": 42, # Sample rate in Hz.
+            },
+            "image": { # Configuration for image output format.
+              "aspectRatio": "A String", # The aspect ratio for the image output.
+              "delivery": "A String", # The delivery mode for the image output.
+              "imageSize": "A String", # The size of the image output.
+              "mimeType": "A String", # The MIME type of the image output.
+            },
+            "structValue": { # `Struct` represents a structured data value, consisting of fields which map to dynamically typed values. # Multi-discriminator values is already enabled in GAOS
+              "fields": [ # Dynamically typed fields. List instead of map because LLMs are sensitive to ordering, and we want to give users full control.
+                { # Represents a single field in a struct.
+                  "name": "A String",
+                  "value": { # `Value` represents a dynamically typed value which can be either null, a number, a string, a boolean, a recursive struct value, or a list of values. A producer of value is expected to set one of these variants. Absence of any variant indicates an error.
+                    "boolValue": True or False, # Represents a boolean value.
+                    "contentValue": { # The content of the response. # Represents rich content (text, image, etc.).
+                      "audio": { # An audio content block.
+                        "channels": 42, # The number of audio channels.
+                        "data": "A String", # The audio content.
+                        "mimeTypeString": "A String", # Flexible MIME type string of the audio, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                        "sampleRate": 42, # The sample rate of the audio.
+                        "uri": "A String", # The URI of the audio.
+                      },
+                      "document": { # A document content block.
+                        "data": "A String", # The document content.
+                        "mimeTypeString": "A String", # Flexible MIME type string of the document, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                        "uri": "A String", # The URI of the document.
+                      },
+                      "image": { # An image content block.
+                        "data": "A String", # The image content.
+                        "mimeTypeString": "A String", # Flexible MIME type string of the image, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                        "resolution": "A String", # The resolution of the media.
+                        "uri": "A String", # The URI of the image.
+                      },
+                      "text": { # A text content block.
+                        "annotations": [ # Citation information for model-generated content.
+                          { # Citation information for model-generated content.
+                            "endIndex": 42, # End of the attributed segment, exclusive.
+                            "fileCitation": { # A file citation annotation. # A file citation annotation.
+                              "customMetadata": { # User provided metadata about the retrieved context.
+                                "a_key": "", # Properties of the object.
+                              },
+                              "documentUri": "A String", # The URI of the file.
+                              "fileName": "A String", # The name of the file.
+                              "mediaId": "A String", # Media ID in-case of image citations, if applicable.
+                              "pageNumber": 42, # Page number of the cited document, if applicable.
+                              "source": "A String", # Source attributed for a portion of the text.
+                            },
+                            "placeCitation": { # A place citation annotation. # A place citation annotation.
+                              "name": "A String", # Title of the place.
+                              "placeId": "A String", # The ID of the place, in `places/{place_id}` format.
+                              "reviewSnippets": [ # Snippets of reviews that are used to generate answers about the features of a given place in Google Maps.
+                                { # Encapsulates a snippet of a user review that answers a question about the features of a specific place in Google Maps.
+                                  "reviewId": "A String", # The ID of the review snippet.
+                                  "title": "A String", # Title of the review.
+                                  "url": "A String", # A link that corresponds to the user review on Google Maps.
+                                },
+                              ],
+                              "url": "A String", # URI reference of the place.
+                            },
+                            "speechMetadata": { # Speech annotation for text content. # Speech annotation for text content.
+                              "speaker": "A String", # The speaker to associate with this turn.
+                              "style": "A String", # Style instruction for the speech synthesis.
+                            },
+                            "startIndex": 42, # Start of segment of the response that is attributed to this source. Index indicates the start of the segment, measured in bytes.
+                            "urlCitation": { # A URL citation annotation. # NOTE: We use these instead of the Citation message for historical reasons. A URL citation annotation.
+                              "title": "A String", # The title of the URL.
+                              "url": "A String", # The URL.
+                            },
+                            "wordInfo": { # Word-level ASR annotation for transcription output. Carries the word text, optional timing, and optional speaker attribution. # Word-level ASR annotation with timing and speaker info.
+                              "endOffset": "A String", # End offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                              "speaker": "A String", # Optional. Speaker label for this word (e.g. "spk_1", "spk_2"). Present when diarization_mode is set in TranscriptionConfig.
+                              "startOffset": "A String", # Start offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                              "text": "A String", # The transcribed word.
+                            },
+                          },
+                        ],
+                        "text": "A String", # Required. The text content.
+                      },
+                      "video": { # A video content block.
+                        "data": "A String", # The video content.
+                        "mimeTypeString": "A String", # Flexible MIME type string of the video, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                        "name": "A String", # A user-defined name for this content block. Can be referenced by the model in the final response.
+                        "processingConfig": {
+                          "static": {
+                            "endOffset": "A String", # Optional. Segment end time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "30s". Must be non-negative and greater than `start_offset` if `start_offset` is set.
+                            "fps": 3.14, # Optional. Video frame-rate sampling density.
+                            "startOffset": "A String", # Optional. Segment start time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "10.5s". Must be non-negative.
+                          },
+                        },
+                        "processingType": "A String",
+                        "resolution": "A String", # The resolution of the media.
+                        "uri": "A String", # The URI of the video.
+                      },
+                    },
+                    "listValue": { # `ListValue` is a wrapper around a repeated field of values. # Represents a repeated `Value`.
+                      "values": [ # Repeated field of dynamically typed values.
+                        # Object with schema name: GenaiVertexV1Value
+                      ],
+                    },
+                    "nullValue": "A String", # Represents a null value.
+                    "numberValue": 3.14, # Represents a double value.
+                    "stringValue": "A String", # Represents a string value.
+                    "structValue": # Object with schema name: GenaiVertexV1Struct # Represents a structured value.
+                  },
+                },
+              ],
+            },
+            "text": { # Configuration for text output format.
+              "mimeType": "A String", # The MIME type of the text output.
+              "schema": { # `Struct` represents a structured data value, consisting of fields which map to dynamically typed values. # The JSON schema that the output should conform to. Only applicable when mime_type is application/json.
+                "fields": [ # Dynamically typed fields. List instead of map because LLMs are sensitive to ordering, and we want to give users full control.
+                  { # Represents a single field in a struct.
+                    "name": "A String",
+                    "value": { # `Value` represents a dynamically typed value which can be either null, a number, a string, a boolean, a recursive struct value, or a list of values. A producer of value is expected to set one of these variants. Absence of any variant indicates an error.
+                      "boolValue": True or False, # Represents a boolean value.
+                      "contentValue": { # The content of the response. # Represents rich content (text, image, etc.).
+                        "audio": { # An audio content block.
+                          "channels": 42, # The number of audio channels.
+                          "data": "A String", # The audio content.
+                          "mimeTypeString": "A String", # Flexible MIME type string of the audio, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                          "sampleRate": 42, # The sample rate of the audio.
+                          "uri": "A String", # The URI of the audio.
+                        },
+                        "document": { # A document content block.
+                          "data": "A String", # The document content.
+                          "mimeTypeString": "A String", # Flexible MIME type string of the document, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                          "uri": "A String", # The URI of the document.
+                        },
+                        "image": { # An image content block.
+                          "data": "A String", # The image content.
+                          "mimeTypeString": "A String", # Flexible MIME type string of the image, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                          "resolution": "A String", # The resolution of the media.
+                          "uri": "A String", # The URI of the image.
+                        },
+                        "text": { # A text content block.
+                          "annotations": [ # Citation information for model-generated content.
+                            { # Citation information for model-generated content.
+                              "endIndex": 42, # End of the attributed segment, exclusive.
+                              "fileCitation": { # A file citation annotation. # A file citation annotation.
+                                "customMetadata": { # User provided metadata about the retrieved context.
+                                  "a_key": "", # Properties of the object.
+                                },
+                                "documentUri": "A String", # The URI of the file.
+                                "fileName": "A String", # The name of the file.
+                                "mediaId": "A String", # Media ID in-case of image citations, if applicable.
+                                "pageNumber": 42, # Page number of the cited document, if applicable.
+                                "source": "A String", # Source attributed for a portion of the text.
+                              },
+                              "placeCitation": { # A place citation annotation. # A place citation annotation.
+                                "name": "A String", # Title of the place.
+                                "placeId": "A String", # The ID of the place, in `places/{place_id}` format.
+                                "reviewSnippets": [ # Snippets of reviews that are used to generate answers about the features of a given place in Google Maps.
+                                  { # Encapsulates a snippet of a user review that answers a question about the features of a specific place in Google Maps.
+                                    "reviewId": "A String", # The ID of the review snippet.
+                                    "title": "A String", # Title of the review.
+                                    "url": "A String", # A link that corresponds to the user review on Google Maps.
+                                  },
+                                ],
+                                "url": "A String", # URI reference of the place.
+                              },
+                              "speechMetadata": { # Speech annotation for text content. # Speech annotation for text content.
+                                "speaker": "A String", # The speaker to associate with this turn.
+                                "style": "A String", # Style instruction for the speech synthesis.
+                              },
+                              "startIndex": 42, # Start of segment of the response that is attributed to this source. Index indicates the start of the segment, measured in bytes.
+                              "urlCitation": { # A URL citation annotation. # NOTE: We use these instead of the Citation message for historical reasons. A URL citation annotation.
+                                "title": "A String", # The title of the URL.
+                                "url": "A String", # The URL.
+                              },
+                              "wordInfo": { # Word-level ASR annotation for transcription output. Carries the word text, optional timing, and optional speaker attribution. # Word-level ASR annotation with timing and speaker info.
+                                "endOffset": "A String", # End offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                                "speaker": "A String", # Optional. Speaker label for this word (e.g. "spk_1", "spk_2"). Present when diarization_mode is set in TranscriptionConfig.
+                                "startOffset": "A String", # Start offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                                "text": "A String", # The transcribed word.
+                              },
+                            },
+                          ],
+                          "text": "A String", # Required. The text content.
+                        },
+                        "video": { # A video content block.
+                          "data": "A String", # The video content.
+                          "mimeTypeString": "A String", # Flexible MIME type string of the video, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                          "name": "A String", # A user-defined name for this content block. Can be referenced by the model in the final response.
+                          "processingConfig": {
+                            "static": {
+                              "endOffset": "A String", # Optional. Segment end time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "30s". Must be non-negative and greater than `start_offset` if `start_offset` is set.
+                              "fps": 3.14, # Optional. Video frame-rate sampling density.
+                              "startOffset": "A String", # Optional. Segment start time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "10.5s". Must be non-negative.
+                            },
+                          },
+                          "processingType": "A String",
+                          "resolution": "A String", # The resolution of the media.
+                          "uri": "A String", # The URI of the video.
+                        },
+                      },
+                      "listValue": { # `ListValue` is a wrapper around a repeated field of values. # Represents a repeated `Value`.
+                        "values": [ # Repeated field of dynamically typed values.
+                          # Object with schema name: GenaiVertexV1Value
+                        ],
+                      },
+                      "nullValue": "A String", # Represents a null value.
+                      "numberValue": 3.14, # Represents a double value.
+                      "stringValue": "A String", # Represents a string value.
+                      "structValue": # Object with schema name: GenaiVertexV1Struct # Represents a structured value.
+                    },
+                  },
+                ],
+              },
+            },
+            "video": { # Configuration for video output format.
+              "aspectRatio": "A String", # The aspect ratio for the video output.
+              "delivery": "A String", # The delivery mode for the video output.
+              "duration": "A String", # The duration for the video output.
+              "gcsUri": "A String", # The Cloud Storage URI to store the video output. Required for Vertex if delivery mode is URI.
+              "resolution": "A String", # The video output resolution. Defaults to 720p.
+            },
+          },
+        ],
+      },
+      "responseFormatSingleton": {
+        "audio": { # Configuration for audio output format.
+          "bitRate": 42, # Bit rate in bits per second (bps). Only applicable for compressed formats (MP3, Opus).
+          "delivery": "A String", # The delivery mode for the audio output.
+          "mimeType": "A String", # The MIME type of the audio output.
+          "sampleRate": 42, # Sample rate in Hz.
+        },
+        "image": { # Configuration for image output format.
+          "aspectRatio": "A String", # The aspect ratio for the image output.
+          "delivery": "A String", # The delivery mode for the image output.
+          "imageSize": "A String", # The size of the image output.
+          "mimeType": "A String", # The MIME type of the image output.
+        },
+        "structValue": { # `Struct` represents a structured data value, consisting of fields which map to dynamically typed values. # Multi-discriminator values is already enabled in GAOS
+          "fields": [ # Dynamically typed fields. List instead of map because LLMs are sensitive to ordering, and we want to give users full control.
+            { # Represents a single field in a struct.
+              "name": "A String",
+              "value": { # `Value` represents a dynamically typed value which can be either null, a number, a string, a boolean, a recursive struct value, or a list of values. A producer of value is expected to set one of these variants. Absence of any variant indicates an error.
+                "boolValue": True or False, # Represents a boolean value.
+                "contentValue": { # The content of the response. # Represents rich content (text, image, etc.).
+                  "audio": { # An audio content block.
+                    "channels": 42, # The number of audio channels.
+                    "data": "A String", # The audio content.
+                    "mimeTypeString": "A String", # Flexible MIME type string of the audio, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                    "sampleRate": 42, # The sample rate of the audio.
+                    "uri": "A String", # The URI of the audio.
+                  },
+                  "document": { # A document content block.
+                    "data": "A String", # The document content.
+                    "mimeTypeString": "A String", # Flexible MIME type string of the document, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                    "uri": "A String", # The URI of the document.
+                  },
+                  "image": { # An image content block.
+                    "data": "A String", # The image content.
+                    "mimeTypeString": "A String", # Flexible MIME type string of the image, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                    "resolution": "A String", # The resolution of the media.
+                    "uri": "A String", # The URI of the image.
+                  },
+                  "text": { # A text content block.
+                    "annotations": [ # Citation information for model-generated content.
+                      { # Citation information for model-generated content.
+                        "endIndex": 42, # End of the attributed segment, exclusive.
+                        "fileCitation": { # A file citation annotation. # A file citation annotation.
+                          "customMetadata": { # User provided metadata about the retrieved context.
+                            "a_key": "", # Properties of the object.
+                          },
+                          "documentUri": "A String", # The URI of the file.
+                          "fileName": "A String", # The name of the file.
+                          "mediaId": "A String", # Media ID in-case of image citations, if applicable.
+                          "pageNumber": 42, # Page number of the cited document, if applicable.
+                          "source": "A String", # Source attributed for a portion of the text.
+                        },
+                        "placeCitation": { # A place citation annotation. # A place citation annotation.
+                          "name": "A String", # Title of the place.
+                          "placeId": "A String", # The ID of the place, in `places/{place_id}` format.
+                          "reviewSnippets": [ # Snippets of reviews that are used to generate answers about the features of a given place in Google Maps.
+                            { # Encapsulates a snippet of a user review that answers a question about the features of a specific place in Google Maps.
+                              "reviewId": "A String", # The ID of the review snippet.
+                              "title": "A String", # Title of the review.
+                              "url": "A String", # A link that corresponds to the user review on Google Maps.
+                            },
+                          ],
+                          "url": "A String", # URI reference of the place.
+                        },
+                        "speechMetadata": { # Speech annotation for text content. # Speech annotation for text content.
+                          "speaker": "A String", # The speaker to associate with this turn.
+                          "style": "A String", # Style instruction for the speech synthesis.
+                        },
+                        "startIndex": 42, # Start of segment of the response that is attributed to this source. Index indicates the start of the segment, measured in bytes.
+                        "urlCitation": { # A URL citation annotation. # NOTE: We use these instead of the Citation message for historical reasons. A URL citation annotation.
+                          "title": "A String", # The title of the URL.
+                          "url": "A String", # The URL.
+                        },
+                        "wordInfo": { # Word-level ASR annotation for transcription output. Carries the word text, optional timing, and optional speaker attribution. # Word-level ASR annotation with timing and speaker info.
+                          "endOffset": "A String", # End offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                          "speaker": "A String", # Optional. Speaker label for this word (e.g. "spk_1", "spk_2"). Present when diarization_mode is set in TranscriptionConfig.
+                          "startOffset": "A String", # Start offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                          "text": "A String", # The transcribed word.
+                        },
+                      },
+                    ],
+                    "text": "A String", # Required. The text content.
+                  },
+                  "video": { # A video content block.
+                    "data": "A String", # The video content.
+                    "mimeTypeString": "A String", # Flexible MIME type string of the video, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                    "name": "A String", # A user-defined name for this content block. Can be referenced by the model in the final response.
+                    "processingConfig": {
+                      "static": {
+                        "endOffset": "A String", # Optional. Segment end time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "30s". Must be non-negative and greater than `start_offset` if `start_offset` is set.
+                        "fps": 3.14, # Optional. Video frame-rate sampling density.
+                        "startOffset": "A String", # Optional. Segment start time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "10.5s". Must be non-negative.
+                      },
+                    },
+                    "processingType": "A String",
+                    "resolution": "A String", # The resolution of the media.
+                    "uri": "A String", # The URI of the video.
+                  },
+                },
+                "listValue": { # `ListValue` is a wrapper around a repeated field of values. # Represents a repeated `Value`.
+                  "values": [ # Repeated field of dynamically typed values.
+                    # Object with schema name: GenaiVertexV1Value
+                  ],
+                },
+                "nullValue": "A String", # Represents a null value.
+                "numberValue": 3.14, # Represents a double value.
+                "stringValue": "A String", # Represents a string value.
+                "structValue": # Object with schema name: GenaiVertexV1Struct # Represents a structured value.
+              },
+            },
+          ],
+        },
+        "text": { # Configuration for text output format.
+          "mimeType": "A String", # The MIME type of the text output.
+          "schema": { # `Struct` represents a structured data value, consisting of fields which map to dynamically typed values. # The JSON schema that the output should conform to. Only applicable when mime_type is application/json.
+            "fields": [ # Dynamically typed fields. List instead of map because LLMs are sensitive to ordering, and we want to give users full control.
+              { # Represents a single field in a struct.
+                "name": "A String",
+                "value": { # `Value` represents a dynamically typed value which can be either null, a number, a string, a boolean, a recursive struct value, or a list of values. A producer of value is expected to set one of these variants. Absence of any variant indicates an error.
+                  "boolValue": True or False, # Represents a boolean value.
+                  "contentValue": { # The content of the response. # Represents rich content (text, image, etc.).
+                    "audio": { # An audio content block.
+                      "channels": 42, # The number of audio channels.
+                      "data": "A String", # The audio content.
+                      "mimeTypeString": "A String", # Flexible MIME type string of the audio, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                      "sampleRate": 42, # The sample rate of the audio.
+                      "uri": "A String", # The URI of the audio.
+                    },
+                    "document": { # A document content block.
+                      "data": "A String", # The document content.
+                      "mimeTypeString": "A String", # Flexible MIME type string of the document, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                      "uri": "A String", # The URI of the document.
+                    },
+                    "image": { # An image content block.
+                      "data": "A String", # The image content.
+                      "mimeTypeString": "A String", # Flexible MIME type string of the image, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                      "resolution": "A String", # The resolution of the media.
+                      "uri": "A String", # The URI of the image.
+                    },
+                    "text": { # A text content block.
+                      "annotations": [ # Citation information for model-generated content.
+                        { # Citation information for model-generated content.
+                          "endIndex": 42, # End of the attributed segment, exclusive.
+                          "fileCitation": { # A file citation annotation. # A file citation annotation.
+                            "customMetadata": { # User provided metadata about the retrieved context.
+                              "a_key": "", # Properties of the object.
+                            },
+                            "documentUri": "A String", # The URI of the file.
+                            "fileName": "A String", # The name of the file.
+                            "mediaId": "A String", # Media ID in-case of image citations, if applicable.
+                            "pageNumber": 42, # Page number of the cited document, if applicable.
+                            "source": "A String", # Source attributed for a portion of the text.
+                          },
+                          "placeCitation": { # A place citation annotation. # A place citation annotation.
+                            "name": "A String", # Title of the place.
+                            "placeId": "A String", # The ID of the place, in `places/{place_id}` format.
+                            "reviewSnippets": [ # Snippets of reviews that are used to generate answers about the features of a given place in Google Maps.
+                              { # Encapsulates a snippet of a user review that answers a question about the features of a specific place in Google Maps.
+                                "reviewId": "A String", # The ID of the review snippet.
+                                "title": "A String", # Title of the review.
+                                "url": "A String", # A link that corresponds to the user review on Google Maps.
+                              },
+                            ],
+                            "url": "A String", # URI reference of the place.
+                          },
+                          "speechMetadata": { # Speech annotation for text content. # Speech annotation for text content.
+                            "speaker": "A String", # The speaker to associate with this turn.
+                            "style": "A String", # Style instruction for the speech synthesis.
+                          },
+                          "startIndex": 42, # Start of segment of the response that is attributed to this source. Index indicates the start of the segment, measured in bytes.
+                          "urlCitation": { # A URL citation annotation. # NOTE: We use these instead of the Citation message for historical reasons. A URL citation annotation.
+                            "title": "A String", # The title of the URL.
+                            "url": "A String", # The URL.
+                          },
+                          "wordInfo": { # Word-level ASR annotation for transcription output. Carries the word text, optional timing, and optional speaker attribution. # Word-level ASR annotation with timing and speaker info.
+                            "endOffset": "A String", # End offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                            "speaker": "A String", # Optional. Speaker label for this word (e.g. "spk_1", "spk_2"). Present when diarization_mode is set in TranscriptionConfig.
+                            "startOffset": "A String", # Start offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                            "text": "A String", # The transcribed word.
+                          },
+                        },
+                      ],
+                      "text": "A String", # Required. The text content.
+                    },
+                    "video": { # A video content block.
+                      "data": "A String", # The video content.
+                      "mimeTypeString": "A String", # Flexible MIME type string of the video, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                      "name": "A String", # A user-defined name for this content block. Can be referenced by the model in the final response.
+                      "processingConfig": {
+                        "static": {
+                          "endOffset": "A String", # Optional. Segment end time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "30s". Must be non-negative and greater than `start_offset` if `start_offset` is set.
+                          "fps": 3.14, # Optional. Video frame-rate sampling density.
+                          "startOffset": "A String", # Optional. Segment start time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "10.5s". Must be non-negative.
+                        },
+                      },
+                      "processingType": "A String",
+                      "resolution": "A String", # The resolution of the media.
+                      "uri": "A String", # The URI of the video.
+                    },
+                  },
+                  "listValue": { # `ListValue` is a wrapper around a repeated field of values. # Represents a repeated `Value`.
+                    "values": [ # Repeated field of dynamically typed values.
+                      # Object with schema name: GenaiVertexV1Value
+                    ],
+                  },
+                  "nullValue": "A String", # Represents a null value.
+                  "numberValue": 3.14, # Represents a double value.
+                  "stringValue": "A String", # Represents a string value.
+                  "structValue": # Object with schema name: GenaiVertexV1Struct # Represents a structured value.
+                },
+              },
+            ],
+          },
+        },
+        "video": { # Configuration for video output format.
+          "aspectRatio": "A String", # The aspect ratio for the video output.
+          "delivery": "A String", # The delivery mode for the video output.
+          "duration": "A String", # The duration for the video output.
+          "gcsUri": "A String", # The Cloud Storage URI to store the video output. Required for Vertex if delivery mode is URI.
+          "resolution": "A String", # The video output resolution. Defaults to 720p.
+        },
+      },
+      "safetySettings": [ # Safety settings for the interaction.
+        { # A safety setting that affects the safety-blocking behavior. A SafetySetting consists of a harm category and a threshold for that category.
+          "method": "A String", # Optional. The method for blocking content. If not specified, the default behavior is to use the probability score.
+          "threshold": "A String", # Required. The threshold for blocking content. If the harm probability exceeds this threshold, the content will be blocked.
+          "type": "A String", # Required. The type of harm category to be blocked.
+        },
+      ],
+      "serviceTier": "A String", # The service tier for the interaction.
+      "status": "A String", # Required. Output only. The status of the interaction.
+      "stepList": { # A list of Steps. # Input only. The steps for the interaction.
+        "steps": [ # The steps of the list.
+          { # A step in the interaction.
+            "modelOutput": { # Output generated by the model.
+              "content": [
+                { # The content of the response.
+                  "audio": { # An audio content block.
+                    "channels": 42, # The number of audio channels.
+                    "data": "A String", # The audio content.
+                    "mimeTypeString": "A String", # Flexible MIME type string of the audio, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                    "sampleRate": 42, # The sample rate of the audio.
+                    "uri": "A String", # The URI of the audio.
+                  },
+                  "document": { # A document content block.
+                    "data": "A String", # The document content.
+                    "mimeTypeString": "A String", # Flexible MIME type string of the document, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                    "uri": "A String", # The URI of the document.
+                  },
+                  "image": { # An image content block.
+                    "data": "A String", # The image content.
+                    "mimeTypeString": "A String", # Flexible MIME type string of the image, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                    "resolution": "A String", # The resolution of the media.
+                    "uri": "A String", # The URI of the image.
+                  },
+                  "text": { # A text content block.
+                    "annotations": [ # Citation information for model-generated content.
+                      { # Citation information for model-generated content.
+                        "endIndex": 42, # End of the attributed segment, exclusive.
+                        "fileCitation": { # A file citation annotation. # A file citation annotation.
+                          "customMetadata": { # User provided metadata about the retrieved context.
+                            "a_key": "", # Properties of the object.
+                          },
+                          "documentUri": "A String", # The URI of the file.
+                          "fileName": "A String", # The name of the file.
+                          "mediaId": "A String", # Media ID in-case of image citations, if applicable.
+                          "pageNumber": 42, # Page number of the cited document, if applicable.
+                          "source": "A String", # Source attributed for a portion of the text.
+                        },
+                        "placeCitation": { # A place citation annotation. # A place citation annotation.
+                          "name": "A String", # Title of the place.
+                          "placeId": "A String", # The ID of the place, in `places/{place_id}` format.
+                          "reviewSnippets": [ # Snippets of reviews that are used to generate answers about the features of a given place in Google Maps.
+                            { # Encapsulates a snippet of a user review that answers a question about the features of a specific place in Google Maps.
+                              "reviewId": "A String", # The ID of the review snippet.
+                              "title": "A String", # Title of the review.
+                              "url": "A String", # A link that corresponds to the user review on Google Maps.
+                            },
+                          ],
+                          "url": "A String", # URI reference of the place.
+                        },
+                        "speechMetadata": { # Speech annotation for text content. # Speech annotation for text content.
+                          "speaker": "A String", # The speaker to associate with this turn.
+                          "style": "A String", # Style instruction for the speech synthesis.
+                        },
+                        "startIndex": 42, # Start of segment of the response that is attributed to this source. Index indicates the start of the segment, measured in bytes.
+                        "urlCitation": { # A URL citation annotation. # NOTE: We use these instead of the Citation message for historical reasons. A URL citation annotation.
+                          "title": "A String", # The title of the URL.
+                          "url": "A String", # The URL.
+                        },
+                        "wordInfo": { # Word-level ASR annotation for transcription output. Carries the word text, optional timing, and optional speaker attribution. # Word-level ASR annotation with timing and speaker info.
+                          "endOffset": "A String", # End offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                          "speaker": "A String", # Optional. Speaker label for this word (e.g. "spk_1", "spk_2"). Present when diarization_mode is set in TranscriptionConfig.
+                          "startOffset": "A String", # Start offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                          "text": "A String", # The transcribed word.
+                        },
+                      },
+                    ],
+                    "text": "A String", # Required. The text content.
+                  },
+                  "video": { # A video content block.
+                    "data": "A String", # The video content.
+                    "mimeTypeString": "A String", # Flexible MIME type string of the video, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                    "name": "A String", # A user-defined name for this content block. Can be referenced by the model in the final response.
+                    "processingConfig": {
+                      "static": {
+                        "endOffset": "A String", # Optional. Segment end time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "30s". Must be non-negative and greater than `start_offset` if `start_offset` is set.
+                        "fps": 3.14, # Optional. Video frame-rate sampling density.
+                        "startOffset": "A String", # Optional. Segment start time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "10.5s". Must be non-negative.
+                      },
+                    },
+                    "processingType": "A String",
+                    "resolution": "A String", # The resolution of the media.
+                    "uri": "A String", # The URI of the video.
+                  },
+                },
+              ],
+              "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.
+              },
+            },
+            "thought": { # A thought step.
+              "signature": "A String", # A signature hash for backend validation.
+              "summary": [ # A summary of the thought.
+                { # The content of the response.
+                  "audio": { # An audio content block.
+                    "channels": 42, # The number of audio channels.
+                    "data": "A String", # The audio content.
+                    "mimeTypeString": "A String", # Flexible MIME type string of the audio, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                    "sampleRate": 42, # The sample rate of the audio.
+                    "uri": "A String", # The URI of the audio.
+                  },
+                  "document": { # A document content block.
+                    "data": "A String", # The document content.
+                    "mimeTypeString": "A String", # Flexible MIME type string of the document, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                    "uri": "A String", # The URI of the document.
+                  },
+                  "image": { # An image content block.
+                    "data": "A String", # The image content.
+                    "mimeTypeString": "A String", # Flexible MIME type string of the image, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                    "resolution": "A String", # The resolution of the media.
+                    "uri": "A String", # The URI of the image.
+                  },
+                  "text": { # A text content block.
+                    "annotations": [ # Citation information for model-generated content.
+                      { # Citation information for model-generated content.
+                        "endIndex": 42, # End of the attributed segment, exclusive.
+                        "fileCitation": { # A file citation annotation. # A file citation annotation.
+                          "customMetadata": { # User provided metadata about the retrieved context.
+                            "a_key": "", # Properties of the object.
+                          },
+                          "documentUri": "A String", # The URI of the file.
+                          "fileName": "A String", # The name of the file.
+                          "mediaId": "A String", # Media ID in-case of image citations, if applicable.
+                          "pageNumber": 42, # Page number of the cited document, if applicable.
+                          "source": "A String", # Source attributed for a portion of the text.
+                        },
+                        "placeCitation": { # A place citation annotation. # A place citation annotation.
+                          "name": "A String", # Title of the place.
+                          "placeId": "A String", # The ID of the place, in `places/{place_id}` format.
+                          "reviewSnippets": [ # Snippets of reviews that are used to generate answers about the features of a given place in Google Maps.
+                            { # Encapsulates a snippet of a user review that answers a question about the features of a specific place in Google Maps.
+                              "reviewId": "A String", # The ID of the review snippet.
+                              "title": "A String", # Title of the review.
+                              "url": "A String", # A link that corresponds to the user review on Google Maps.
+                            },
+                          ],
+                          "url": "A String", # URI reference of the place.
+                        },
+                        "speechMetadata": { # Speech annotation for text content. # Speech annotation for text content.
+                          "speaker": "A String", # The speaker to associate with this turn.
+                          "style": "A String", # Style instruction for the speech synthesis.
+                        },
+                        "startIndex": 42, # Start of segment of the response that is attributed to this source. Index indicates the start of the segment, measured in bytes.
+                        "urlCitation": { # A URL citation annotation. # NOTE: We use these instead of the Citation message for historical reasons. A URL citation annotation.
+                          "title": "A String", # The title of the URL.
+                          "url": "A String", # The URL.
+                        },
+                        "wordInfo": { # Word-level ASR annotation for transcription output. Carries the word text, optional timing, and optional speaker attribution. # Word-level ASR annotation with timing and speaker info.
+                          "endOffset": "A String", # End offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                          "speaker": "A String", # Optional. Speaker label for this word (e.g. "spk_1", "spk_2"). Present when diarization_mode is set in TranscriptionConfig.
+                          "startOffset": "A String", # Start offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                          "text": "A String", # The transcribed word.
+                        },
+                      },
+                    ],
+                    "text": "A String", # Required. The text content.
+                  },
+                  "video": { # A video content block.
+                    "data": "A String", # The video content.
+                    "mimeTypeString": "A String", # Flexible MIME type string of the video, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                    "name": "A String", # A user-defined name for this content block. Can be referenced by the model in the final response.
+                    "processingConfig": {
+                      "static": {
+                        "endOffset": "A String", # Optional. Segment end time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "30s". Must be non-negative and greater than `start_offset` if `start_offset` is set.
+                        "fps": 3.14, # Optional. Video frame-rate sampling density.
+                        "startOffset": "A String", # Optional. Segment start time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "10.5s". Must be non-negative.
+                      },
+                    },
+                    "processingType": "A String",
+                    "resolution": "A String", # The resolution of the media.
+                    "uri": "A String", # The URI of the video.
+                  },
+                },
+              ],
+            },
+            "toolCall": { # Tool call step.
+              "codeExecutionCall": { # Code execution call step.
+                "arguments": { # The arguments to pass to the code execution. # Required. The arguments to pass to the code execution.
+                  "code": "A String", # The code to be executed.
+                  "language": "A String", # Programming language of the `code`.
+                },
+              },
+              "fileSearchCall": { # File Search call step.
+              },
+              "functionCall": { # A function tool call step.
+                "arguments": { # `Struct` represents a structured data value, consisting of fields which map to dynamically typed values. # Required. The arguments to pass to the function.
+                  "fields": [ # Dynamically typed fields. List instead of map because LLMs are sensitive to ordering, and we want to give users full control.
+                    { # Represents a single field in a struct.
+                      "name": "A String",
+                      "value": { # `Value` represents a dynamically typed value which can be either null, a number, a string, a boolean, a recursive struct value, or a list of values. A producer of value is expected to set one of these variants. Absence of any variant indicates an error.
+                        "boolValue": True or False, # Represents a boolean value.
+                        "contentValue": { # The content of the response. # Represents rich content (text, image, etc.).
+                          "audio": { # An audio content block.
+                            "channels": 42, # The number of audio channels.
+                            "data": "A String", # The audio content.
+                            "mimeTypeString": "A String", # Flexible MIME type string of the audio, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                            "sampleRate": 42, # The sample rate of the audio.
+                            "uri": "A String", # The URI of the audio.
+                          },
+                          "document": { # A document content block.
+                            "data": "A String", # The document content.
+                            "mimeTypeString": "A String", # Flexible MIME type string of the document, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                            "uri": "A String", # The URI of the document.
+                          },
+                          "image": { # An image content block.
+                            "data": "A String", # The image content.
+                            "mimeTypeString": "A String", # Flexible MIME type string of the image, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                            "resolution": "A String", # The resolution of the media.
+                            "uri": "A String", # The URI of the image.
+                          },
+                          "text": { # A text content block.
+                            "annotations": [ # Citation information for model-generated content.
+                              { # Citation information for model-generated content.
+                                "endIndex": 42, # End of the attributed segment, exclusive.
+                                "fileCitation": { # A file citation annotation. # A file citation annotation.
+                                  "customMetadata": { # User provided metadata about the retrieved context.
+                                    "a_key": "", # Properties of the object.
+                                  },
+                                  "documentUri": "A String", # The URI of the file.
+                                  "fileName": "A String", # The name of the file.
+                                  "mediaId": "A String", # Media ID in-case of image citations, if applicable.
+                                  "pageNumber": 42, # Page number of the cited document, if applicable.
+                                  "source": "A String", # Source attributed for a portion of the text.
+                                },
+                                "placeCitation": { # A place citation annotation. # A place citation annotation.
+                                  "name": "A String", # Title of the place.
+                                  "placeId": "A String", # The ID of the place, in `places/{place_id}` format.
+                                  "reviewSnippets": [ # Snippets of reviews that are used to generate answers about the features of a given place in Google Maps.
+                                    { # Encapsulates a snippet of a user review that answers a question about the features of a specific place in Google Maps.
+                                      "reviewId": "A String", # The ID of the review snippet.
+                                      "title": "A String", # Title of the review.
+                                      "url": "A String", # A link that corresponds to the user review on Google Maps.
+                                    },
+                                  ],
+                                  "url": "A String", # URI reference of the place.
+                                },
+                                "speechMetadata": { # Speech annotation for text content. # Speech annotation for text content.
+                                  "speaker": "A String", # The speaker to associate with this turn.
+                                  "style": "A String", # Style instruction for the speech synthesis.
+                                },
+                                "startIndex": 42, # Start of segment of the response that is attributed to this source. Index indicates the start of the segment, measured in bytes.
+                                "urlCitation": { # A URL citation annotation. # NOTE: We use these instead of the Citation message for historical reasons. A URL citation annotation.
+                                  "title": "A String", # The title of the URL.
+                                  "url": "A String", # The URL.
+                                },
+                                "wordInfo": { # Word-level ASR annotation for transcription output. Carries the word text, optional timing, and optional speaker attribution. # Word-level ASR annotation with timing and speaker info.
+                                  "endOffset": "A String", # End offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                                  "speaker": "A String", # Optional. Speaker label for this word (e.g. "spk_1", "spk_2"). Present when diarization_mode is set in TranscriptionConfig.
+                                  "startOffset": "A String", # Start offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                                  "text": "A String", # The transcribed word.
+                                },
+                              },
+                            ],
+                            "text": "A String", # Required. The text content.
+                          },
+                          "video": { # A video content block.
+                            "data": "A String", # The video content.
+                            "mimeTypeString": "A String", # Flexible MIME type string of the video, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                            "name": "A String", # A user-defined name for this content block. Can be referenced by the model in the final response.
+                            "processingConfig": {
+                              "static": {
+                                "endOffset": "A String", # Optional. Segment end time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "30s". Must be non-negative and greater than `start_offset` if `start_offset` is set.
+                                "fps": 3.14, # Optional. Video frame-rate sampling density.
+                                "startOffset": "A String", # Optional. Segment start time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "10.5s". Must be non-negative.
+                              },
+                            },
+                            "processingType": "A String",
+                            "resolution": "A String", # The resolution of the media.
+                            "uri": "A String", # The URI of the video.
+                          },
+                        },
+                        "listValue": { # `ListValue` is a wrapper around a repeated field of values. # Represents a repeated `Value`.
+                          "values": [ # Repeated field of dynamically typed values.
+                            # Object with schema name: GenaiVertexV1Value
+                          ],
+                        },
+                        "nullValue": "A String", # Represents a null value.
+                        "numberValue": 3.14, # Represents a double value.
+                        "stringValue": "A String", # Represents a string value.
+                        "structValue": # Object with schema name: GenaiVertexV1Struct # Represents a structured value.
+                      },
+                    },
+                  ],
+                },
+                "name": "A String", # Required. The name of the tool to call.
+              },
+              "googleMapsCall": { # Google Maps call step.
+                "arguments": { # The arguments to pass to the Google Maps tool. # The arguments to pass to the Google Maps tool.
+                  "queries": [ # The queries to be executed.
+                    "A String",
+                  ],
+                },
+              },
+              "googleSearchCall": { # Google Search call step.
+                "arguments": { # The arguments to pass to Google Search. # Required. The arguments to pass to Google Search.
+                  "queries": [ # Web search queries for the following-up web search.
+                    "A String",
+                  ],
+                },
+                "searchType": "A String", # The type of search grounding enabled.
+              },
+              "id": "A String", # Required. A unique ID for this specific tool call.
+              "processingCall": { # A server-initiated processing step for media analysis (e.g. video understanding).
+              },
+              "retrievalCall": { # Retrieval call step. Used by Vertex Retrieval tools such as Parallel AI, Exa AI, Vertex AI Search, etc. RetrievalType decides which tool is used.
+                "arguments": { # The arguments to pass to Retrieval tools. # Required. The arguments to pass to the retrieval tool.
+                  "queries": [ # Queries for Retrieval information.
+                    "A String",
+                  ],
+                },
+                "retrievalType": "A String", # The type of retrieval tools.
+              },
+              "signature": "A String", # A signature hash for backend validation.
+              "urlContextCall": { # URL context call step.
+                "arguments": { # The arguments to pass to the URL context. # Required. The arguments to pass to the URL context.
+                  "urls": [ # The URLs to fetch.
+                    "A String",
+                  ],
+                },
+              },
+            },
+            "toolResult": { # Tool result step.
+              "callId": "A String", # Required. ID to match the ID from the function call block.
+              "codeExecutionResult": { # Code execution result step.
+                "isError": True or False, # Whether the code execution resulted in an error.
+                "result": "A String", # Required. The output of the code execution.
+              },
+              "fileSearchResult": { # File Search result step.
+              },
+              "functionResult": { # Result of a function tool call.
+                "isError": True or False, # Whether the tool call resulted in an error.
+                "name": "A String", # The name of the tool that was called.
+                "result": { # `Value` represents a dynamically typed value which can be either null, a number, a string, a boolean, a recursive struct value, or a list of values. A producer of value is expected to set one of these variants. Absence of any variant indicates an error. # Required. The result of the tool call.
+                  "boolValue": True or False, # Represents a boolean value.
+                  "contentValue": { # The content of the response. # Represents rich content (text, image, etc.).
+                    "audio": { # An audio content block.
+                      "channels": 42, # The number of audio channels.
+                      "data": "A String", # The audio content.
+                      "mimeTypeString": "A String", # Flexible MIME type string of the audio, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                      "sampleRate": 42, # The sample rate of the audio.
+                      "uri": "A String", # The URI of the audio.
+                    },
+                    "document": { # A document content block.
+                      "data": "A String", # The document content.
+                      "mimeTypeString": "A String", # Flexible MIME type string of the document, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                      "uri": "A String", # The URI of the document.
+                    },
+                    "image": { # An image content block.
+                      "data": "A String", # The image content.
+                      "mimeTypeString": "A String", # Flexible MIME type string of the image, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                      "resolution": "A String", # The resolution of the media.
+                      "uri": "A String", # The URI of the image.
+                    },
+                    "text": { # A text content block.
+                      "annotations": [ # Citation information for model-generated content.
+                        { # Citation information for model-generated content.
+                          "endIndex": 42, # End of the attributed segment, exclusive.
+                          "fileCitation": { # A file citation annotation. # A file citation annotation.
+                            "customMetadata": { # User provided metadata about the retrieved context.
+                              "a_key": "", # Properties of the object.
+                            },
+                            "documentUri": "A String", # The URI of the file.
+                            "fileName": "A String", # The name of the file.
+                            "mediaId": "A String", # Media ID in-case of image citations, if applicable.
+                            "pageNumber": 42, # Page number of the cited document, if applicable.
+                            "source": "A String", # Source attributed for a portion of the text.
+                          },
+                          "placeCitation": { # A place citation annotation. # A place citation annotation.
+                            "name": "A String", # Title of the place.
+                            "placeId": "A String", # The ID of the place, in `places/{place_id}` format.
+                            "reviewSnippets": [ # Snippets of reviews that are used to generate answers about the features of a given place in Google Maps.
+                              { # Encapsulates a snippet of a user review that answers a question about the features of a specific place in Google Maps.
+                                "reviewId": "A String", # The ID of the review snippet.
+                                "title": "A String", # Title of the review.
+                                "url": "A String", # A link that corresponds to the user review on Google Maps.
+                              },
+                            ],
+                            "url": "A String", # URI reference of the place.
+                          },
+                          "speechMetadata": { # Speech annotation for text content. # Speech annotation for text content.
+                            "speaker": "A String", # The speaker to associate with this turn.
+                            "style": "A String", # Style instruction for the speech synthesis.
+                          },
+                          "startIndex": 42, # Start of segment of the response that is attributed to this source. Index indicates the start of the segment, measured in bytes.
+                          "urlCitation": { # A URL citation annotation. # NOTE: We use these instead of the Citation message for historical reasons. A URL citation annotation.
+                            "title": "A String", # The title of the URL.
+                            "url": "A String", # The URL.
+                          },
+                          "wordInfo": { # Word-level ASR annotation for transcription output. Carries the word text, optional timing, and optional speaker attribution. # Word-level ASR annotation with timing and speaker info.
+                            "endOffset": "A String", # End offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                            "speaker": "A String", # Optional. Speaker label for this word (e.g. "spk_1", "spk_2"). Present when diarization_mode is set in TranscriptionConfig.
+                            "startOffset": "A String", # Start offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                            "text": "A String", # The transcribed word.
+                          },
+                        },
+                      ],
+                      "text": "A String", # Required. The text content.
+                    },
+                    "video": { # A video content block.
+                      "data": "A String", # The video content.
+                      "mimeTypeString": "A String", # Flexible MIME type string of the video, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                      "name": "A String", # A user-defined name for this content block. Can be referenced by the model in the final response.
+                      "processingConfig": {
+                        "static": {
+                          "endOffset": "A String", # Optional. Segment end time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "30s". Must be non-negative and greater than `start_offset` if `start_offset` is set.
+                          "fps": 3.14, # Optional. Video frame-rate sampling density.
+                          "startOffset": "A String", # Optional. Segment start time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "10.5s". Must be non-negative.
+                        },
+                      },
+                      "processingType": "A String",
+                      "resolution": "A String", # The resolution of the media.
+                      "uri": "A String", # The URI of the video.
+                    },
+                  },
+                  "listValue": { # `ListValue` is a wrapper around a repeated field of values. # Represents a repeated `Value`.
+                    "values": [ # Repeated field of dynamically typed values.
+                      # Object with schema name: GenaiVertexV1Value
+                    ],
+                  },
+                  "nullValue": "A String", # Represents a null value.
+                  "numberValue": 3.14, # Represents a double value.
+                  "stringValue": "A String", # Represents a string value.
+                  "structValue": # Object with schema name: GenaiVertexV1Struct # Represents a structured value.
+                },
+              },
+              "googleMapsResult": { # Google Maps result step.
+                "result": [
+                  { # The result of the Google Maps.
+                    "places": [
+                      {
+                        "name": "A String",
+                        "placeId": "A String",
+                        "reviewSnippets": [
+                          { # Encapsulates a snippet of a user review that answers a question about the features of a specific place in Google Maps.
+                            "reviewId": "A String", # The ID of the review snippet.
+                            "title": "A String", # Title of the review.
+                            "url": "A String", # A link that corresponds to the user review on Google Maps.
+                          },
+                        ],
+                        "url": "A String",
+                      },
+                    ],
+                    "widgetContextToken": "A String",
+                  },
+                ],
+              },
+              "googleSearchResult": { # Google Search result step.
+                "isError": True or False, # Whether the Google Search resulted in an error.
+                "result": [ # Required. The results of the Google Search.
+                  { # The result of the Google Search.
+                    "searchSuggestions": "A String", # Web content snippet that can be embedded in a web page or an app webview.
+                  },
+                ],
+              },
+              "processingResult": { # The result of a server-initiated media processing step.
+              },
+              "retrievalResult": { # Vertex Retrieval result step. Used by Vertex Retrieval tools such as Parallel AI, Exa AI, Vertex AI Search, etc.
+                "isError": True or False, # Whether the retrieval resulted in an error.
+              },
+              "signature": "A String", # A signature hash for backend validation.
+              "urlContextResult": { # URL context result step.
+                "isError": True or False, # Whether the URL context resulted in an error.
+                "result": [ # Required. The results of the URL context.
+                  { # The result of the URL context.
+                    "status": "A String", # The status of the URL retrieval.
+                    "url": "A String", # The URL that was fetched.
+                  },
+                ],
+              },
+            },
+            "userInput": { # Input provided by the user. # DO NOT USE -- These are for 3P JSON only
+              "contentList": { # A list of Content. # The content of the step. An array of Content objects.
+                "contents": [ # The contents of the list.
+                  { # The content of the response.
+                    "audio": { # An audio content block.
+                      "channels": 42, # The number of audio channels.
+                      "data": "A String", # The audio content.
+                      "mimeTypeString": "A String", # Flexible MIME type string of the audio, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                      "sampleRate": 42, # The sample rate of the audio.
+                      "uri": "A String", # The URI of the audio.
+                    },
+                    "document": { # A document content block.
+                      "data": "A String", # The document content.
+                      "mimeTypeString": "A String", # Flexible MIME type string of the document, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                      "uri": "A String", # The URI of the document.
+                    },
+                    "image": { # An image content block.
+                      "data": "A String", # The image content.
+                      "mimeTypeString": "A String", # Flexible MIME type string of the image, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                      "resolution": "A String", # The resolution of the media.
+                      "uri": "A String", # The URI of the image.
+                    },
+                    "text": { # A text content block.
+                      "annotations": [ # Citation information for model-generated content.
+                        { # Citation information for model-generated content.
+                          "endIndex": 42, # End of the attributed segment, exclusive.
+                          "fileCitation": { # A file citation annotation. # A file citation annotation.
+                            "customMetadata": { # User provided metadata about the retrieved context.
+                              "a_key": "", # Properties of the object.
+                            },
+                            "documentUri": "A String", # The URI of the file.
+                            "fileName": "A String", # The name of the file.
+                            "mediaId": "A String", # Media ID in-case of image citations, if applicable.
+                            "pageNumber": 42, # Page number of the cited document, if applicable.
+                            "source": "A String", # Source attributed for a portion of the text.
+                          },
+                          "placeCitation": { # A place citation annotation. # A place citation annotation.
+                            "name": "A String", # Title of the place.
+                            "placeId": "A String", # The ID of the place, in `places/{place_id}` format.
+                            "reviewSnippets": [ # Snippets of reviews that are used to generate answers about the features of a given place in Google Maps.
+                              { # Encapsulates a snippet of a user review that answers a question about the features of a specific place in Google Maps.
+                                "reviewId": "A String", # The ID of the review snippet.
+                                "title": "A String", # Title of the review.
+                                "url": "A String", # A link that corresponds to the user review on Google Maps.
+                              },
+                            ],
+                            "url": "A String", # URI reference of the place.
+                          },
+                          "speechMetadata": { # Speech annotation for text content. # Speech annotation for text content.
+                            "speaker": "A String", # The speaker to associate with this turn.
+                            "style": "A String", # Style instruction for the speech synthesis.
+                          },
+                          "startIndex": 42, # Start of segment of the response that is attributed to this source. Index indicates the start of the segment, measured in bytes.
+                          "urlCitation": { # A URL citation annotation. # NOTE: We use these instead of the Citation message for historical reasons. A URL citation annotation.
+                            "title": "A String", # The title of the URL.
+                            "url": "A String", # The URL.
+                          },
+                          "wordInfo": { # Word-level ASR annotation for transcription output. Carries the word text, optional timing, and optional speaker attribution. # Word-level ASR annotation with timing and speaker info.
+                            "endOffset": "A String", # End offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                            "speaker": "A String", # Optional. Speaker label for this word (e.g. "spk_1", "spk_2"). Present when diarization_mode is set in TranscriptionConfig.
+                            "startOffset": "A String", # Start offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                            "text": "A String", # The transcribed word.
+                          },
+                        },
+                      ],
+                      "text": "A String", # Required. The text content.
+                    },
+                    "video": { # A video content block.
+                      "data": "A String", # The video content.
+                      "mimeTypeString": "A String", # Flexible MIME type string of the video, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                      "name": "A String", # A user-defined name for this content block. Can be referenced by the model in the final response.
+                      "processingConfig": {
+                        "static": {
+                          "endOffset": "A String", # Optional. Segment end time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "30s". Must be non-negative and greater than `start_offset` if `start_offset` is set.
+                          "fps": 3.14, # Optional. Video frame-rate sampling density.
+                          "startOffset": "A String", # Optional. Segment start time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "10.5s". Must be non-negative.
+                        },
+                      },
+                      "processingType": "A String",
+                      "resolution": "A String", # The resolution of the media.
+                      "uri": "A String", # The URI of the video.
+                    },
+                  },
+                ],
+              },
+              "contentString": "A String", # The content of the step. A single string.
+            },
+          },
+        ],
+      },
+      "steps": [ # Required. Output only. The steps that make up the interaction, when included in the response.
+        { # A step in the interaction.
+          "modelOutput": { # Output generated by the model.
+            "content": [
+              { # The content of the response.
+                "audio": { # An audio content block.
+                  "channels": 42, # The number of audio channels.
+                  "data": "A String", # The audio content.
+                  "mimeTypeString": "A String", # Flexible MIME type string of the audio, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                  "sampleRate": 42, # The sample rate of the audio.
+                  "uri": "A String", # The URI of the audio.
+                },
+                "document": { # A document content block.
+                  "data": "A String", # The document content.
+                  "mimeTypeString": "A String", # Flexible MIME type string of the document, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                  "uri": "A String", # The URI of the document.
+                },
+                "image": { # An image content block.
+                  "data": "A String", # The image content.
+                  "mimeTypeString": "A String", # Flexible MIME type string of the image, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                  "resolution": "A String", # The resolution of the media.
+                  "uri": "A String", # The URI of the image.
+                },
+                "text": { # A text content block.
+                  "annotations": [ # Citation information for model-generated content.
+                    { # Citation information for model-generated content.
+                      "endIndex": 42, # End of the attributed segment, exclusive.
+                      "fileCitation": { # A file citation annotation. # A file citation annotation.
+                        "customMetadata": { # User provided metadata about the retrieved context.
+                          "a_key": "", # Properties of the object.
+                        },
+                        "documentUri": "A String", # The URI of the file.
+                        "fileName": "A String", # The name of the file.
+                        "mediaId": "A String", # Media ID in-case of image citations, if applicable.
+                        "pageNumber": 42, # Page number of the cited document, if applicable.
+                        "source": "A String", # Source attributed for a portion of the text.
+                      },
+                      "placeCitation": { # A place citation annotation. # A place citation annotation.
+                        "name": "A String", # Title of the place.
+                        "placeId": "A String", # The ID of the place, in `places/{place_id}` format.
+                        "reviewSnippets": [ # Snippets of reviews that are used to generate answers about the features of a given place in Google Maps.
+                          { # Encapsulates a snippet of a user review that answers a question about the features of a specific place in Google Maps.
+                            "reviewId": "A String", # The ID of the review snippet.
+                            "title": "A String", # Title of the review.
+                            "url": "A String", # A link that corresponds to the user review on Google Maps.
+                          },
+                        ],
+                        "url": "A String", # URI reference of the place.
+                      },
+                      "speechMetadata": { # Speech annotation for text content. # Speech annotation for text content.
+                        "speaker": "A String", # The speaker to associate with this turn.
+                        "style": "A String", # Style instruction for the speech synthesis.
+                      },
+                      "startIndex": 42, # Start of segment of the response that is attributed to this source. Index indicates the start of the segment, measured in bytes.
+                      "urlCitation": { # A URL citation annotation. # NOTE: We use these instead of the Citation message for historical reasons. A URL citation annotation.
+                        "title": "A String", # The title of the URL.
+                        "url": "A String", # The URL.
+                      },
+                      "wordInfo": { # Word-level ASR annotation for transcription output. Carries the word text, optional timing, and optional speaker attribution. # Word-level ASR annotation with timing and speaker info.
+                        "endOffset": "A String", # End offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                        "speaker": "A String", # Optional. Speaker label for this word (e.g. "spk_1", "spk_2"). Present when diarization_mode is set in TranscriptionConfig.
+                        "startOffset": "A String", # Start offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                        "text": "A String", # The transcribed word.
+                      },
+                    },
+                  ],
+                  "text": "A String", # Required. The text content.
+                },
+                "video": { # A video content block.
+                  "data": "A String", # The video content.
+                  "mimeTypeString": "A String", # Flexible MIME type string of the video, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                  "name": "A String", # A user-defined name for this content block. Can be referenced by the model in the final response.
+                  "processingConfig": {
+                    "static": {
+                      "endOffset": "A String", # Optional. Segment end time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "30s". Must be non-negative and greater than `start_offset` if `start_offset` is set.
+                      "fps": 3.14, # Optional. Video frame-rate sampling density.
+                      "startOffset": "A String", # Optional. Segment start time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "10.5s". Must be non-negative.
+                    },
+                  },
+                  "processingType": "A String",
+                  "resolution": "A String", # The resolution of the media.
+                  "uri": "A String", # The URI of the video.
+                },
+              },
+            ],
+            "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.
+            },
+          },
+          "thought": { # A thought step.
+            "signature": "A String", # A signature hash for backend validation.
+            "summary": [ # A summary of the thought.
+              { # The content of the response.
+                "audio": { # An audio content block.
+                  "channels": 42, # The number of audio channels.
+                  "data": "A String", # The audio content.
+                  "mimeTypeString": "A String", # Flexible MIME type string of the audio, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                  "sampleRate": 42, # The sample rate of the audio.
+                  "uri": "A String", # The URI of the audio.
+                },
+                "document": { # A document content block.
+                  "data": "A String", # The document content.
+                  "mimeTypeString": "A String", # Flexible MIME type string of the document, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                  "uri": "A String", # The URI of the document.
+                },
+                "image": { # An image content block.
+                  "data": "A String", # The image content.
+                  "mimeTypeString": "A String", # Flexible MIME type string of the image, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                  "resolution": "A String", # The resolution of the media.
+                  "uri": "A String", # The URI of the image.
+                },
+                "text": { # A text content block.
+                  "annotations": [ # Citation information for model-generated content.
+                    { # Citation information for model-generated content.
+                      "endIndex": 42, # End of the attributed segment, exclusive.
+                      "fileCitation": { # A file citation annotation. # A file citation annotation.
+                        "customMetadata": { # User provided metadata about the retrieved context.
+                          "a_key": "", # Properties of the object.
+                        },
+                        "documentUri": "A String", # The URI of the file.
+                        "fileName": "A String", # The name of the file.
+                        "mediaId": "A String", # Media ID in-case of image citations, if applicable.
+                        "pageNumber": 42, # Page number of the cited document, if applicable.
+                        "source": "A String", # Source attributed for a portion of the text.
+                      },
+                      "placeCitation": { # A place citation annotation. # A place citation annotation.
+                        "name": "A String", # Title of the place.
+                        "placeId": "A String", # The ID of the place, in `places/{place_id}` format.
+                        "reviewSnippets": [ # Snippets of reviews that are used to generate answers about the features of a given place in Google Maps.
+                          { # Encapsulates a snippet of a user review that answers a question about the features of a specific place in Google Maps.
+                            "reviewId": "A String", # The ID of the review snippet.
+                            "title": "A String", # Title of the review.
+                            "url": "A String", # A link that corresponds to the user review on Google Maps.
+                          },
+                        ],
+                        "url": "A String", # URI reference of the place.
+                      },
+                      "speechMetadata": { # Speech annotation for text content. # Speech annotation for text content.
+                        "speaker": "A String", # The speaker to associate with this turn.
+                        "style": "A String", # Style instruction for the speech synthesis.
+                      },
+                      "startIndex": 42, # Start of segment of the response that is attributed to this source. Index indicates the start of the segment, measured in bytes.
+                      "urlCitation": { # A URL citation annotation. # NOTE: We use these instead of the Citation message for historical reasons. A URL citation annotation.
+                        "title": "A String", # The title of the URL.
+                        "url": "A String", # The URL.
+                      },
+                      "wordInfo": { # Word-level ASR annotation for transcription output. Carries the word text, optional timing, and optional speaker attribution. # Word-level ASR annotation with timing and speaker info.
+                        "endOffset": "A String", # End offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                        "speaker": "A String", # Optional. Speaker label for this word (e.g. "spk_1", "spk_2"). Present when diarization_mode is set in TranscriptionConfig.
+                        "startOffset": "A String", # Start offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                        "text": "A String", # The transcribed word.
+                      },
+                    },
+                  ],
+                  "text": "A String", # Required. The text content.
+                },
+                "video": { # A video content block.
+                  "data": "A String", # The video content.
+                  "mimeTypeString": "A String", # Flexible MIME type string of the video, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                  "name": "A String", # A user-defined name for this content block. Can be referenced by the model in the final response.
+                  "processingConfig": {
+                    "static": {
+                      "endOffset": "A String", # Optional. Segment end time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "30s". Must be non-negative and greater than `start_offset` if `start_offset` is set.
+                      "fps": 3.14, # Optional. Video frame-rate sampling density.
+                      "startOffset": "A String", # Optional. Segment start time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "10.5s". Must be non-negative.
+                    },
+                  },
+                  "processingType": "A String",
+                  "resolution": "A String", # The resolution of the media.
+                  "uri": "A String", # The URI of the video.
+                },
+              },
+            ],
+          },
+          "toolCall": { # Tool call step.
+            "codeExecutionCall": { # Code execution call step.
+              "arguments": { # The arguments to pass to the code execution. # Required. The arguments to pass to the code execution.
+                "code": "A String", # The code to be executed.
+                "language": "A String", # Programming language of the `code`.
+              },
+            },
+            "fileSearchCall": { # File Search call step.
+            },
+            "functionCall": { # A function tool call step.
+              "arguments": { # `Struct` represents a structured data value, consisting of fields which map to dynamically typed values. # Required. The arguments to pass to the function.
+                "fields": [ # Dynamically typed fields. List instead of map because LLMs are sensitive to ordering, and we want to give users full control.
+                  { # Represents a single field in a struct.
+                    "name": "A String",
+                    "value": { # `Value` represents a dynamically typed value which can be either null, a number, a string, a boolean, a recursive struct value, or a list of values. A producer of value is expected to set one of these variants. Absence of any variant indicates an error.
+                      "boolValue": True or False, # Represents a boolean value.
+                      "contentValue": { # The content of the response. # Represents rich content (text, image, etc.).
+                        "audio": { # An audio content block.
+                          "channels": 42, # The number of audio channels.
+                          "data": "A String", # The audio content.
+                          "mimeTypeString": "A String", # Flexible MIME type string of the audio, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                          "sampleRate": 42, # The sample rate of the audio.
+                          "uri": "A String", # The URI of the audio.
+                        },
+                        "document": { # A document content block.
+                          "data": "A String", # The document content.
+                          "mimeTypeString": "A String", # Flexible MIME type string of the document, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                          "uri": "A String", # The URI of the document.
+                        },
+                        "image": { # An image content block.
+                          "data": "A String", # The image content.
+                          "mimeTypeString": "A String", # Flexible MIME type string of the image, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                          "resolution": "A String", # The resolution of the media.
+                          "uri": "A String", # The URI of the image.
+                        },
+                        "text": { # A text content block.
+                          "annotations": [ # Citation information for model-generated content.
+                            { # Citation information for model-generated content.
+                              "endIndex": 42, # End of the attributed segment, exclusive.
+                              "fileCitation": { # A file citation annotation. # A file citation annotation.
+                                "customMetadata": { # User provided metadata about the retrieved context.
+                                  "a_key": "", # Properties of the object.
+                                },
+                                "documentUri": "A String", # The URI of the file.
+                                "fileName": "A String", # The name of the file.
+                                "mediaId": "A String", # Media ID in-case of image citations, if applicable.
+                                "pageNumber": 42, # Page number of the cited document, if applicable.
+                                "source": "A String", # Source attributed for a portion of the text.
+                              },
+                              "placeCitation": { # A place citation annotation. # A place citation annotation.
+                                "name": "A String", # Title of the place.
+                                "placeId": "A String", # The ID of the place, in `places/{place_id}` format.
+                                "reviewSnippets": [ # Snippets of reviews that are used to generate answers about the features of a given place in Google Maps.
+                                  { # Encapsulates a snippet of a user review that answers a question about the features of a specific place in Google Maps.
+                                    "reviewId": "A String", # The ID of the review snippet.
+                                    "title": "A String", # Title of the review.
+                                    "url": "A String", # A link that corresponds to the user review on Google Maps.
+                                  },
+                                ],
+                                "url": "A String", # URI reference of the place.
+                              },
+                              "speechMetadata": { # Speech annotation for text content. # Speech annotation for text content.
+                                "speaker": "A String", # The speaker to associate with this turn.
+                                "style": "A String", # Style instruction for the speech synthesis.
+                              },
+                              "startIndex": 42, # Start of segment of the response that is attributed to this source. Index indicates the start of the segment, measured in bytes.
+                              "urlCitation": { # A URL citation annotation. # NOTE: We use these instead of the Citation message for historical reasons. A URL citation annotation.
+                                "title": "A String", # The title of the URL.
+                                "url": "A String", # The URL.
+                              },
+                              "wordInfo": { # Word-level ASR annotation for transcription output. Carries the word text, optional timing, and optional speaker attribution. # Word-level ASR annotation with timing and speaker info.
+                                "endOffset": "A String", # End offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                                "speaker": "A String", # Optional. Speaker label for this word (e.g. "spk_1", "spk_2"). Present when diarization_mode is set in TranscriptionConfig.
+                                "startOffset": "A String", # Start offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                                "text": "A String", # The transcribed word.
+                              },
+                            },
+                          ],
+                          "text": "A String", # Required. The text content.
+                        },
+                        "video": { # A video content block.
+                          "data": "A String", # The video content.
+                          "mimeTypeString": "A String", # Flexible MIME type string of the video, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                          "name": "A String", # A user-defined name for this content block. Can be referenced by the model in the final response.
+                          "processingConfig": {
+                            "static": {
+                              "endOffset": "A String", # Optional. Segment end time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "30s". Must be non-negative and greater than `start_offset` if `start_offset` is set.
+                              "fps": 3.14, # Optional. Video frame-rate sampling density.
+                              "startOffset": "A String", # Optional. Segment start time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "10.5s". Must be non-negative.
+                            },
+                          },
+                          "processingType": "A String",
+                          "resolution": "A String", # The resolution of the media.
+                          "uri": "A String", # The URI of the video.
+                        },
+                      },
+                      "listValue": { # `ListValue` is a wrapper around a repeated field of values. # Represents a repeated `Value`.
+                        "values": [ # Repeated field of dynamically typed values.
+                          # Object with schema name: GenaiVertexV1Value
+                        ],
+                      },
+                      "nullValue": "A String", # Represents a null value.
+                      "numberValue": 3.14, # Represents a double value.
+                      "stringValue": "A String", # Represents a string value.
+                      "structValue": # Object with schema name: GenaiVertexV1Struct # Represents a structured value.
+                    },
+                  },
+                ],
+              },
+              "name": "A String", # Required. The name of the tool to call.
+            },
+            "googleMapsCall": { # Google Maps call step.
+              "arguments": { # The arguments to pass to the Google Maps tool. # The arguments to pass to the Google Maps tool.
+                "queries": [ # The queries to be executed.
+                  "A String",
+                ],
+              },
+            },
+            "googleSearchCall": { # Google Search call step.
+              "arguments": { # The arguments to pass to Google Search. # Required. The arguments to pass to Google Search.
+                "queries": [ # Web search queries for the following-up web search.
+                  "A String",
+                ],
+              },
+              "searchType": "A String", # The type of search grounding enabled.
+            },
+            "id": "A String", # Required. A unique ID for this specific tool call.
+            "processingCall": { # A server-initiated processing step for media analysis (e.g. video understanding).
+            },
+            "retrievalCall": { # Retrieval call step. Used by Vertex Retrieval tools such as Parallel AI, Exa AI, Vertex AI Search, etc. RetrievalType decides which tool is used.
+              "arguments": { # The arguments to pass to Retrieval tools. # Required. The arguments to pass to the retrieval tool.
+                "queries": [ # Queries for Retrieval information.
+                  "A String",
+                ],
+              },
+              "retrievalType": "A String", # The type of retrieval tools.
+            },
+            "signature": "A String", # A signature hash for backend validation.
+            "urlContextCall": { # URL context call step.
+              "arguments": { # The arguments to pass to the URL context. # Required. The arguments to pass to the URL context.
+                "urls": [ # The URLs to fetch.
+                  "A String",
+                ],
+              },
+            },
+          },
+          "toolResult": { # Tool result step.
+            "callId": "A String", # Required. ID to match the ID from the function call block.
+            "codeExecutionResult": { # Code execution result step.
+              "isError": True or False, # Whether the code execution resulted in an error.
+              "result": "A String", # Required. The output of the code execution.
+            },
+            "fileSearchResult": { # File Search result step.
+            },
+            "functionResult": { # Result of a function tool call.
+              "isError": True or False, # Whether the tool call resulted in an error.
+              "name": "A String", # The name of the tool that was called.
+              "result": { # `Value` represents a dynamically typed value which can be either null, a number, a string, a boolean, a recursive struct value, or a list of values. A producer of value is expected to set one of these variants. Absence of any variant indicates an error. # Required. The result of the tool call.
+                "boolValue": True or False, # Represents a boolean value.
+                "contentValue": { # The content of the response. # Represents rich content (text, image, etc.).
+                  "audio": { # An audio content block.
+                    "channels": 42, # The number of audio channels.
+                    "data": "A String", # The audio content.
+                    "mimeTypeString": "A String", # Flexible MIME type string of the audio, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                    "sampleRate": 42, # The sample rate of the audio.
+                    "uri": "A String", # The URI of the audio.
+                  },
+                  "document": { # A document content block.
+                    "data": "A String", # The document content.
+                    "mimeTypeString": "A String", # Flexible MIME type string of the document, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                    "uri": "A String", # The URI of the document.
+                  },
+                  "image": { # An image content block.
+                    "data": "A String", # The image content.
+                    "mimeTypeString": "A String", # Flexible MIME type string of the image, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                    "resolution": "A String", # The resolution of the media.
+                    "uri": "A String", # The URI of the image.
+                  },
+                  "text": { # A text content block.
+                    "annotations": [ # Citation information for model-generated content.
+                      { # Citation information for model-generated content.
+                        "endIndex": 42, # End of the attributed segment, exclusive.
+                        "fileCitation": { # A file citation annotation. # A file citation annotation.
+                          "customMetadata": { # User provided metadata about the retrieved context.
+                            "a_key": "", # Properties of the object.
+                          },
+                          "documentUri": "A String", # The URI of the file.
+                          "fileName": "A String", # The name of the file.
+                          "mediaId": "A String", # Media ID in-case of image citations, if applicable.
+                          "pageNumber": 42, # Page number of the cited document, if applicable.
+                          "source": "A String", # Source attributed for a portion of the text.
+                        },
+                        "placeCitation": { # A place citation annotation. # A place citation annotation.
+                          "name": "A String", # Title of the place.
+                          "placeId": "A String", # The ID of the place, in `places/{place_id}` format.
+                          "reviewSnippets": [ # Snippets of reviews that are used to generate answers about the features of a given place in Google Maps.
+                            { # Encapsulates a snippet of a user review that answers a question about the features of a specific place in Google Maps.
+                              "reviewId": "A String", # The ID of the review snippet.
+                              "title": "A String", # Title of the review.
+                              "url": "A String", # A link that corresponds to the user review on Google Maps.
+                            },
+                          ],
+                          "url": "A String", # URI reference of the place.
+                        },
+                        "speechMetadata": { # Speech annotation for text content. # Speech annotation for text content.
+                          "speaker": "A String", # The speaker to associate with this turn.
+                          "style": "A String", # Style instruction for the speech synthesis.
+                        },
+                        "startIndex": 42, # Start of segment of the response that is attributed to this source. Index indicates the start of the segment, measured in bytes.
+                        "urlCitation": { # A URL citation annotation. # NOTE: We use these instead of the Citation message for historical reasons. A URL citation annotation.
+                          "title": "A String", # The title of the URL.
+                          "url": "A String", # The URL.
+                        },
+                        "wordInfo": { # Word-level ASR annotation for transcription output. Carries the word text, optional timing, and optional speaker attribution. # Word-level ASR annotation with timing and speaker info.
+                          "endOffset": "A String", # End offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                          "speaker": "A String", # Optional. Speaker label for this word (e.g. "spk_1", "spk_2"). Present when diarization_mode is set in TranscriptionConfig.
+                          "startOffset": "A String", # Start offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                          "text": "A String", # The transcribed word.
+                        },
+                      },
+                    ],
+                    "text": "A String", # Required. The text content.
+                  },
+                  "video": { # A video content block.
+                    "data": "A String", # The video content.
+                    "mimeTypeString": "A String", # Flexible MIME type string of the video, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                    "name": "A String", # A user-defined name for this content block. Can be referenced by the model in the final response.
+                    "processingConfig": {
+                      "static": {
+                        "endOffset": "A String", # Optional. Segment end time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "30s". Must be non-negative and greater than `start_offset` if `start_offset` is set.
+                        "fps": 3.14, # Optional. Video frame-rate sampling density.
+                        "startOffset": "A String", # Optional. Segment start time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "10.5s". Must be non-negative.
+                      },
+                    },
+                    "processingType": "A String",
+                    "resolution": "A String", # The resolution of the media.
+                    "uri": "A String", # The URI of the video.
+                  },
+                },
+                "listValue": { # `ListValue` is a wrapper around a repeated field of values. # Represents a repeated `Value`.
+                  "values": [ # Repeated field of dynamically typed values.
+                    # Object with schema name: GenaiVertexV1Value
+                  ],
+                },
+                "nullValue": "A String", # Represents a null value.
+                "numberValue": 3.14, # Represents a double value.
+                "stringValue": "A String", # Represents a string value.
+                "structValue": # Object with schema name: GenaiVertexV1Struct # Represents a structured value.
+              },
+            },
+            "googleMapsResult": { # Google Maps result step.
+              "result": [
+                { # The result of the Google Maps.
+                  "places": [
+                    {
+                      "name": "A String",
+                      "placeId": "A String",
+                      "reviewSnippets": [
+                        { # Encapsulates a snippet of a user review that answers a question about the features of a specific place in Google Maps.
+                          "reviewId": "A String", # The ID of the review snippet.
+                          "title": "A String", # Title of the review.
+                          "url": "A String", # A link that corresponds to the user review on Google Maps.
+                        },
+                      ],
+                      "url": "A String",
+                    },
+                  ],
+                  "widgetContextToken": "A String",
+                },
+              ],
+            },
+            "googleSearchResult": { # Google Search result step.
+              "isError": True or False, # Whether the Google Search resulted in an error.
+              "result": [ # Required. The results of the Google Search.
+                { # The result of the Google Search.
+                  "searchSuggestions": "A String", # Web content snippet that can be embedded in a web page or an app webview.
+                },
+              ],
+            },
+            "processingResult": { # The result of a server-initiated media processing step.
+            },
+            "retrievalResult": { # Vertex Retrieval result step. Used by Vertex Retrieval tools such as Parallel AI, Exa AI, Vertex AI Search, etc.
+              "isError": True or False, # Whether the retrieval resulted in an error.
+            },
+            "signature": "A String", # A signature hash for backend validation.
+            "urlContextResult": { # URL context result step.
+              "isError": True or False, # Whether the URL context resulted in an error.
+              "result": [ # Required. The results of the URL context.
+                { # The result of the URL context.
+                  "status": "A String", # The status of the URL retrieval.
+                  "url": "A String", # The URL that was fetched.
+                },
+              ],
+            },
+          },
+          "userInput": { # Input provided by the user. # DO NOT USE -- These are for 3P JSON only
+            "contentList": { # A list of Content. # The content of the step. An array of Content objects.
+              "contents": [ # The contents of the list.
+                { # The content of the response.
+                  "audio": { # An audio content block.
+                    "channels": 42, # The number of audio channels.
+                    "data": "A String", # The audio content.
+                    "mimeTypeString": "A String", # Flexible MIME type string of the audio, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                    "sampleRate": 42, # The sample rate of the audio.
+                    "uri": "A String", # The URI of the audio.
+                  },
+                  "document": { # A document content block.
+                    "data": "A String", # The document content.
+                    "mimeTypeString": "A String", # Flexible MIME type string of the document, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                    "uri": "A String", # The URI of the document.
+                  },
+                  "image": { # An image content block.
+                    "data": "A String", # The image content.
+                    "mimeTypeString": "A String", # Flexible MIME type string of the image, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                    "resolution": "A String", # The resolution of the media.
+                    "uri": "A String", # The URI of the image.
+                  },
+                  "text": { # A text content block.
+                    "annotations": [ # Citation information for model-generated content.
+                      { # Citation information for model-generated content.
+                        "endIndex": 42, # End of the attributed segment, exclusive.
+                        "fileCitation": { # A file citation annotation. # A file citation annotation.
+                          "customMetadata": { # User provided metadata about the retrieved context.
+                            "a_key": "", # Properties of the object.
+                          },
+                          "documentUri": "A String", # The URI of the file.
+                          "fileName": "A String", # The name of the file.
+                          "mediaId": "A String", # Media ID in-case of image citations, if applicable.
+                          "pageNumber": 42, # Page number of the cited document, if applicable.
+                          "source": "A String", # Source attributed for a portion of the text.
+                        },
+                        "placeCitation": { # A place citation annotation. # A place citation annotation.
+                          "name": "A String", # Title of the place.
+                          "placeId": "A String", # The ID of the place, in `places/{place_id}` format.
+                          "reviewSnippets": [ # Snippets of reviews that are used to generate answers about the features of a given place in Google Maps.
+                            { # Encapsulates a snippet of a user review that answers a question about the features of a specific place in Google Maps.
+                              "reviewId": "A String", # The ID of the review snippet.
+                              "title": "A String", # Title of the review.
+                              "url": "A String", # A link that corresponds to the user review on Google Maps.
+                            },
+                          ],
+                          "url": "A String", # URI reference of the place.
+                        },
+                        "speechMetadata": { # Speech annotation for text content. # Speech annotation for text content.
+                          "speaker": "A String", # The speaker to associate with this turn.
+                          "style": "A String", # Style instruction for the speech synthesis.
+                        },
+                        "startIndex": 42, # Start of segment of the response that is attributed to this source. Index indicates the start of the segment, measured in bytes.
+                        "urlCitation": { # A URL citation annotation. # NOTE: We use these instead of the Citation message for historical reasons. A URL citation annotation.
+                          "title": "A String", # The title of the URL.
+                          "url": "A String", # The URL.
+                        },
+                        "wordInfo": { # Word-level ASR annotation for transcription output. Carries the word text, optional timing, and optional speaker attribution. # Word-level ASR annotation with timing and speaker info.
+                          "endOffset": "A String", # End offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                          "speaker": "A String", # Optional. Speaker label for this word (e.g. "spk_1", "spk_2"). Present when diarization_mode is set in TranscriptionConfig.
+                          "startOffset": "A String", # Start offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                          "text": "A String", # The transcribed word.
+                        },
+                      },
+                    ],
+                    "text": "A String", # Required. The text content.
+                  },
+                  "video": { # A video content block.
+                    "data": "A String", # The video content.
+                    "mimeTypeString": "A String", # Flexible MIME type string of the video, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                    "name": "A String", # A user-defined name for this content block. Can be referenced by the model in the final response.
+                    "processingConfig": {
+                      "static": {
+                        "endOffset": "A String", # Optional. Segment end time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "30s". Must be non-negative and greater than `start_offset` if `start_offset` is set.
+                        "fps": 3.14, # Optional. Video frame-rate sampling density.
+                        "startOffset": "A String", # Optional. Segment start time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "10.5s". Must be non-negative.
+                      },
+                    },
+                    "processingType": "A String",
+                    "resolution": "A String", # The resolution of the media.
+                    "uri": "A String", # The URI of the video.
+                  },
+                },
+              ],
+            },
+            "contentString": "A String", # The content of the step. A single string.
+          },
+        },
+      ],
+      "stringContent": "A String", # A string input for the interaction, it will be processed as a single text input.
+      "systemInstruction": "A String", # System instruction for the interaction.
+      "tools": [ # A list of tool declarations the model may call during interaction.
+        { # A tool that can be used by the model.
+          "codeExecution": { # A tool that can be used by the model to execute code. # A tool that can be used by the model to execute code.
+          },
+          "computerUse": { # A tool that can be used by the model to interact with the computer. # Tool to support the model interacting directly with the computer.
+            "disabledSafetyPolicies": [ # Optional. Disabled safety policies for computer use.
+              "A String",
+            ],
+            "enablePromptInjectionDetection": True or False, # Whether enable the prompt injection detection check on computer-use request.
+            "environment": "A String", # The environment being operated.
+            "excludedPredefinedFunctions": [ # The list of predefined functions that are excluded from the model call.
+              "A String",
+            ],
+          },
+          "fileSearch": { # A tool that can be used by the model to search files. # A tool that can be used by the model to search files.
+            "fileSearchStoreNames": [ # The file search store names to search.
+              "A String",
+            ],
+            "metadataFilter": "A String", # Metadata filter to apply to the semantic retrieval documents and chunks.
+            "topK": 42, # The number of semantic retrieval chunks to retrieve.
+          },
+          "function": { # A tool that can be used by the model. # A function that can be used by the model.
+            "description": "A String", # A description of the function.
+            "name": "A String", # The name of the function.
+            "parameters": { # `Value` represents a dynamically typed value which can be either null, a number, a string, a boolean, a recursive struct value, or a list of values. A producer of value is expected to set one of these variants. Absence of any variant indicates an error. # The JSON Schema for the function's parameters.
+              "boolValue": True or False, # Represents a boolean value.
+              "contentValue": { # The content of the response. # Represents rich content (text, image, etc.).
+                "audio": { # An audio content block.
+                  "channels": 42, # The number of audio channels.
+                  "data": "A String", # The audio content.
+                  "mimeTypeString": "A String", # Flexible MIME type string of the audio, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                  "sampleRate": 42, # The sample rate of the audio.
+                  "uri": "A String", # The URI of the audio.
+                },
+                "document": { # A document content block.
+                  "data": "A String", # The document content.
+                  "mimeTypeString": "A String", # Flexible MIME type string of the document, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                  "uri": "A String", # The URI of the document.
+                },
+                "image": { # An image content block.
+                  "data": "A String", # The image content.
+                  "mimeTypeString": "A String", # Flexible MIME type string of the image, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                  "resolution": "A String", # The resolution of the media.
+                  "uri": "A String", # The URI of the image.
+                },
+                "text": { # A text content block.
+                  "annotations": [ # Citation information for model-generated content.
+                    { # Citation information for model-generated content.
+                      "endIndex": 42, # End of the attributed segment, exclusive.
+                      "fileCitation": { # A file citation annotation. # A file citation annotation.
+                        "customMetadata": { # User provided metadata about the retrieved context.
+                          "a_key": "", # Properties of the object.
+                        },
+                        "documentUri": "A String", # The URI of the file.
+                        "fileName": "A String", # The name of the file.
+                        "mediaId": "A String", # Media ID in-case of image citations, if applicable.
+                        "pageNumber": 42, # Page number of the cited document, if applicable.
+                        "source": "A String", # Source attributed for a portion of the text.
+                      },
+                      "placeCitation": { # A place citation annotation. # A place citation annotation.
+                        "name": "A String", # Title of the place.
+                        "placeId": "A String", # The ID of the place, in `places/{place_id}` format.
+                        "reviewSnippets": [ # Snippets of reviews that are used to generate answers about the features of a given place in Google Maps.
+                          { # Encapsulates a snippet of a user review that answers a question about the features of a specific place in Google Maps.
+                            "reviewId": "A String", # The ID of the review snippet.
+                            "title": "A String", # Title of the review.
+                            "url": "A String", # A link that corresponds to the user review on Google Maps.
+                          },
+                        ],
+                        "url": "A String", # URI reference of the place.
+                      },
+                      "speechMetadata": { # Speech annotation for text content. # Speech annotation for text content.
+                        "speaker": "A String", # The speaker to associate with this turn.
+                        "style": "A String", # Style instruction for the speech synthesis.
+                      },
+                      "startIndex": 42, # Start of segment of the response that is attributed to this source. Index indicates the start of the segment, measured in bytes.
+                      "urlCitation": { # A URL citation annotation. # NOTE: We use these instead of the Citation message for historical reasons. A URL citation annotation.
+                        "title": "A String", # The title of the URL.
+                        "url": "A String", # The URL.
+                      },
+                      "wordInfo": { # Word-level ASR annotation for transcription output. Carries the word text, optional timing, and optional speaker attribution. # Word-level ASR annotation with timing and speaker info.
+                        "endOffset": "A String", # End offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                        "speaker": "A String", # Optional. Speaker label for this word (e.g. "spk_1", "spk_2"). Present when diarization_mode is set in TranscriptionConfig.
+                        "startOffset": "A String", # Start offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                        "text": "A String", # The transcribed word.
+                      },
+                    },
+                  ],
+                  "text": "A String", # Required. The text content.
+                },
+                "video": { # A video content block.
+                  "data": "A String", # The video content.
+                  "mimeTypeString": "A String", # Flexible MIME type string of the video, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                  "name": "A String", # A user-defined name for this content block. Can be referenced by the model in the final response.
+                  "processingConfig": {
+                    "static": {
+                      "endOffset": "A String", # Optional. Segment end time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "30s". Must be non-negative and greater than `start_offset` if `start_offset` is set.
+                      "fps": 3.14, # Optional. Video frame-rate sampling density.
+                      "startOffset": "A String", # Optional. Segment start time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "10.5s". Must be non-negative.
+                    },
+                  },
+                  "processingType": "A String",
+                  "resolution": "A String", # The resolution of the media.
+                  "uri": "A String", # The URI of the video.
+                },
+              },
+              "listValue": { # `ListValue` is a wrapper around a repeated field of values. # Represents a repeated `Value`.
+                "values": [ # Repeated field of dynamically typed values.
+                  # Object with schema name: GenaiVertexV1Value
+                ],
+              },
+              "nullValue": "A String", # Represents a null value.
+              "numberValue": 3.14, # Represents a double value.
+              "stringValue": "A String", # Represents a string value.
+              "structValue": # Object with schema name: GenaiVertexV1Struct # Represents a structured value.
+            },
+          },
+          "googleMaps": { # A tool that can be used by the model to call Google Maps. # A tool that can be used by the model to search Google Maps.
+            "enableWidget": True or False, # Whether to return a widget context token in the tool call result of the response.
+            "latitude": 3.14, # The latitude of the user's location.
+            "longitude": 3.14, # The longitude of the user's location.
+          },
+          "googleSearch": { # A tool that can be used by the model to search Google. # A tool that can be used by the model to search Google.
+            "searchTypes": [ # The types of search grounding to enable.
+              "A String",
+            ],
+          },
+          "mcpServer": { # A MCPServer is a server that can be called by the model to perform actions. # A MCPServer is a server that can be called by the model to perform actions.
+            "allowedTools": [ # The allowed tools.
+              { # The configuration for allowed tools.
+                "mode": "A String", # The mode of the tool choice.
+                "tools": [ # The names of the allowed tools.
+                  "A String",
+                ],
+              },
+            ],
+            "headers": { # Optional: Fields for authentication headers, timeouts, etc., if needed.
+              "a_key": "A String",
+            },
+            "name": "A String", # The name of the MCPServer.
+            "url": "A String", # The full URL for the MCPServer endpoint. Example: "https://api.example.com/mcp"
+          },
+          "retrieval": { # A tool that can be used by the model to retrieve files. # A tool that can be used by the model to retrieve files.
+            "exaAiSearchConfig": { # Used to specify configuration for ExaAISearch. # Used to specify configuration for ExaAISearch.
+              "apiKey": "A String", # Required. The API key for ExaAiSearch.
+              "customConfig": { # Optional. This field can be used to pass any parameter from the Exa.ai Search API.
+                "a_key": "", # Properties of the object.
+              },
+            },
+            "parallelAiSearchConfig": { # Used to specify configuration for ParallelAISearch. # Used to specify configuration for ParallelAISearch.
+              "apiKey": "A String", # Optional. The API key for ParallelAiSearch.
+              "customConfig": { # Optional. Custom configs for ParallelAiSearch.
+                "a_key": "", # Properties of the object.
+              },
+            },
+            "ragStoreConfig": { # Use to specify configuration for RAG Store. # Used to specify configuration for RagStore.
+              "ragResources": [ # Optional. The representation of the rag source.
+                { # The definition of the Rag resource.
+                  "ragCorpus": "A String", # Optional. RagCorpora resource name.
+                  "ragFileIds": [ # Optional. rag_file_id. The files should be in the same rag_corpus set in rag_corpus field.
+                    "A String",
+                  ],
+                },
+              ],
+              "ragRetrievalConfig": { # Specifies the context retrieval config. # Optional. The retrieval config for the Rag query.
+                "filter": { # Config for filters. # Optional. Config for filters.
+                  "metadataFilter": "A String", # Optional. String for metadata filtering.
+                  "vectorDistanceThreshold": 3.14, # Optional. Only returns contexts with vector distance smaller than the threshold.
+                  "vectorSimilarityThreshold": 3.14, # Optional. Only returns contexts with vector similarity larger than the threshold.
+                },
+                "hybridSearch": { # Config for Hybrid Search. # Optional. Config for Hybrid Search.
+                  "alpha": 3.14, # Optional. Alpha value controls the weight between dense and sparse vector search results.
+                },
+                "ranking": { # Config for ranking and reranking. # Optional. Config for ranking and reranking.
+                  "rankService": { # Config for Rank Service. # Config for Rank Service.
+                    "modelName": "A String", # Optional. The model name of the rank service.
+                  },
+                },
+                "topK": 42, # Optional. The number of contexts to retrieve.
+              },
+            },
+            "retrievalTypes": [ # The types of file retrieval to enable.
+              "A String",
+            ],
+            "vertexAiSearchConfig": { # Used to specify configuration for VertexAISearch. # Used to specify configuration for VertexAISearch.
+              "datastores": [ # Optional. Used to specify Vertex AI Search datastores.
+                "A String",
+              ],
+              "engine": "A String", # Optional. Used to specify Vertex AI Search engine.
+            },
+          },
+          "urlContext": { # A tool that can be used by the model to fetch URL context. # A tool that can be used by the model to fetch URL context.
+          },
+        },
+      ],
+      "updated": "A String", # Required. Output only. The time at which the response was last updated in ISO 8601 format (YYYY-MM-DDThh:mm:ssZ).
+      "usage": { # Statistics on the interaction request's token usage. # Output only. Statistics on the interaction request's token usage.
+        "cachedTokensByModality": [ # A breakdown of cached token usage by modality.
+          { # The token count for a single response modality.
+            "modality": "A String", # The modality associated with the token count.
+            "tokens": 42, # Number of tokens for the modality.
+          },
+        ],
+        "groundingToolCount": [ # Grounding tool count.
+          { # The number of grounding tool counts.
+            "count": 42, # The number of grounding tool counts.
+            "type": "A String", # The grounding tool type associated with the count.
+          },
+        ],
+        "inputTokensByModality": [ # A breakdown of input token usage by modality.
+          { # The token count for a single response modality.
+            "modality": "A String", # The modality associated with the token count.
+            "tokens": 42, # Number of tokens for the modality.
+          },
+        ],
+        "outputTokensByModality": [ # A breakdown of output token usage by modality.
+          { # The token count for a single response modality.
+            "modality": "A String", # The modality associated with the token count.
+            "tokens": 42, # Number of tokens for the modality.
+          },
+        ],
+        "toolUseTokensByModality": [ # A breakdown of tool-use token usage by modality.
+          { # The token count for a single response modality.
+            "modality": "A String", # The modality associated with the token count.
+            "tokens": 42, # Number of tokens for the modality.
+          },
+        ],
+        "totalCachedTokens": 42, # Number of tokens in the cached part of the prompt (the cached content).
+        "totalInputTokens": 42, # Number of tokens in the prompt (context).
+        "totalOutputTokens": 42, # Total number of tokens across all the generated responses.
+        "totalThoughtTokens": 42, # Number of tokens of thoughts for thinking models.
+        "totalTokens": 42, # Total token count for the interaction request (prompt + responses + other internal tokens).
+        "totalToolUseTokens": 42, # Number of tokens present in tool-use prompt(s).
+      },
+    },
+  },
+  "interactionStatusUpdate": { # The interaction status data, used for interaction.status_update events.
+    "interactionId": "A String",
+    "status": "A String",
+    "usage": { # Statistics on the interaction request's token usage. # Model usage statistics up to this checkpoint.
+      "cachedTokensByModality": [ # A breakdown of cached token usage by modality.
+        { # The token count for a single response modality.
+          "modality": "A String", # The modality associated with the token count.
+          "tokens": 42, # Number of tokens for the modality.
+        },
+      ],
+      "groundingToolCount": [ # Grounding tool count.
+        { # The number of grounding tool counts.
+          "count": 42, # The number of grounding tool counts.
+          "type": "A String", # The grounding tool type associated with the count.
+        },
+      ],
+      "inputTokensByModality": [ # A breakdown of input token usage by modality.
+        { # The token count for a single response modality.
+          "modality": "A String", # The modality associated with the token count.
+          "tokens": 42, # Number of tokens for the modality.
+        },
+      ],
+      "outputTokensByModality": [ # A breakdown of output token usage by modality.
+        { # The token count for a single response modality.
+          "modality": "A String", # The modality associated with the token count.
+          "tokens": 42, # Number of tokens for the modality.
+        },
+      ],
+      "toolUseTokensByModality": [ # A breakdown of tool-use token usage by modality.
+        { # The token count for a single response modality.
+          "modality": "A String", # The modality associated with the token count.
+          "tokens": 42, # Number of tokens for the modality.
+        },
+      ],
+      "totalCachedTokens": 42, # Number of tokens in the cached part of the prompt (the cached content).
+      "totalInputTokens": 42, # Number of tokens in the prompt (context).
+      "totalOutputTokens": 42, # Total number of tokens across all the generated responses.
+      "totalThoughtTokens": 42, # Number of tokens of thoughts for thinking models.
+      "totalTokens": 42, # Total token count for the interaction request (prompt + responses + other internal tokens).
+      "totalToolUseTokens": 42, # Number of tokens present in tool-use prompt(s).
+    },
+  },
+  "stepDelta": { # The step delta data, used for step.delta events. Step-based streaming event, used when steps are enabled.
+    "delta": {
+      "argumentsDelta": {
+        "arguments": "A String",
+      },
+      "audio": {
+        "channels": 42, # The number of audio channels.
+        "data": "A String",
+        "mimeType": "A String",
+        "sampleRate": 42, # The sample rate of the audio.
+        "uri": "A String",
+      },
+      "document": {
+        "data": "A String",
+        "mimeType": "A String",
+        "uri": "A String",
+      },
+      "functionResult": {
+        "isError": True or False,
+        "name": "A String",
+        "result": { # `Value` represents a dynamically typed value which can be either null, a number, a string, a boolean, a recursive struct value, or a list of values. A producer of value is expected to set one of these variants. Absence of any variant indicates an error.
+          "boolValue": True or False, # Represents a boolean value.
+          "contentValue": { # The content of the response. # Represents rich content (text, image, etc.).
+            "audio": { # An audio content block.
+              "channels": 42, # The number of audio channels.
+              "data": "A String", # The audio content.
+              "mimeTypeString": "A String", # Flexible MIME type string of the audio, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+              "sampleRate": 42, # The sample rate of the audio.
+              "uri": "A String", # The URI of the audio.
+            },
+            "document": { # A document content block.
+              "data": "A String", # The document content.
+              "mimeTypeString": "A String", # Flexible MIME type string of the document, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+              "uri": "A String", # The URI of the document.
+            },
+            "image": { # An image content block.
+              "data": "A String", # The image content.
+              "mimeTypeString": "A String", # Flexible MIME type string of the image, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+              "resolution": "A String", # The resolution of the media.
+              "uri": "A String", # The URI of the image.
+            },
+            "text": { # A text content block.
+              "annotations": [ # Citation information for model-generated content.
+                { # Citation information for model-generated content.
+                  "endIndex": 42, # End of the attributed segment, exclusive.
+                  "fileCitation": { # A file citation annotation. # A file citation annotation.
+                    "customMetadata": { # User provided metadata about the retrieved context.
+                      "a_key": "", # Properties of the object.
+                    },
+                    "documentUri": "A String", # The URI of the file.
+                    "fileName": "A String", # The name of the file.
+                    "mediaId": "A String", # Media ID in-case of image citations, if applicable.
+                    "pageNumber": 42, # Page number of the cited document, if applicable.
+                    "source": "A String", # Source attributed for a portion of the text.
+                  },
+                  "placeCitation": { # A place citation annotation. # A place citation annotation.
+                    "name": "A String", # Title of the place.
+                    "placeId": "A String", # The ID of the place, in `places/{place_id}` format.
+                    "reviewSnippets": [ # Snippets of reviews that are used to generate answers about the features of a given place in Google Maps.
+                      { # Encapsulates a snippet of a user review that answers a question about the features of a specific place in Google Maps.
+                        "reviewId": "A String", # The ID of the review snippet.
+                        "title": "A String", # Title of the review.
+                        "url": "A String", # A link that corresponds to the user review on Google Maps.
+                      },
+                    ],
+                    "url": "A String", # URI reference of the place.
+                  },
+                  "speechMetadata": { # Speech annotation for text content. # Speech annotation for text content.
+                    "speaker": "A String", # The speaker to associate with this turn.
+                    "style": "A String", # Style instruction for the speech synthesis.
+                  },
+                  "startIndex": 42, # Start of segment of the response that is attributed to this source. Index indicates the start of the segment, measured in bytes.
+                  "urlCitation": { # A URL citation annotation. # NOTE: We use these instead of the Citation message for historical reasons. A URL citation annotation.
+                    "title": "A String", # The title of the URL.
+                    "url": "A String", # The URL.
+                  },
+                  "wordInfo": { # Word-level ASR annotation for transcription output. Carries the word text, optional timing, and optional speaker attribution. # Word-level ASR annotation with timing and speaker info.
+                    "endOffset": "A String", # End offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                    "speaker": "A String", # Optional. Speaker label for this word (e.g. "spk_1", "spk_2"). Present when diarization_mode is set in TranscriptionConfig.
+                    "startOffset": "A String", # Start offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                    "text": "A String", # The transcribed word.
+                  },
+                },
+              ],
+              "text": "A String", # Required. The text content.
+            },
+            "video": { # A video content block.
+              "data": "A String", # The video content.
+              "mimeTypeString": "A String", # Flexible MIME type string of the video, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+              "name": "A String", # A user-defined name for this content block. Can be referenced by the model in the final response.
+              "processingConfig": {
+                "static": {
+                  "endOffset": "A String", # Optional. Segment end time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "30s". Must be non-negative and greater than `start_offset` if `start_offset` is set.
+                  "fps": 3.14, # Optional. Video frame-rate sampling density.
+                  "startOffset": "A String", # Optional. Segment start time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "10.5s". Must be non-negative.
+                },
+              },
+              "processingType": "A String",
+              "resolution": "A String", # The resolution of the media.
+              "uri": "A String", # The URI of the video.
+            },
+          },
+          "listValue": { # `ListValue` is a wrapper around a repeated field of values. # Represents a repeated `Value`.
+            "values": [ # Repeated field of dynamically typed values.
+              # Object with schema name: GenaiVertexV1Value
+            ],
+          },
+          "nullValue": "A String", # Represents a null value.
+          "numberValue": 3.14, # Represents a double value.
+          "stringValue": "A String", # Represents a string value.
+          "structValue": # Object with schema name: GenaiVertexV1Struct # Represents a structured value.
+        },
+      },
+      "image": {
+        "data": "A String",
+        "mimeType": "A String",
+        "resolution": "A String", # The resolution of the media.
+        "uri": "A String",
+      },
+      "serverToolCall": {
+        "codeExecutionCall": {
+          "arguments": { # The arguments to pass to the code execution.
+            "code": "A String", # The code to be executed.
+            "language": "A String", # Programming language of the `code`.
+          },
+        },
+        "fileSearchCall": {
+        },
+        "googleMapsCall": {
+          "arguments": { # The arguments to pass to the Google Maps tool. # The arguments to pass to the Google Maps tool.
+            "queries": [ # The queries to be executed.
+              "A String",
+            ],
+          },
+        },
+        "googleSearchCall": {
+          "arguments": { # The arguments to pass to Google Search.
+            "queries": [ # Web search queries for the following-up web search.
+              "A String",
+            ],
+          },
+        },
+        "processingCall": { # Streaming delta for a server-initiated media processing step.
+        },
+        "retrievalCall": { # Used by Vertex Retrieval tools such as Parallel AI, Exa AI, Vertex AI Search, etc. RetrievalType decides which tool is used.
+          "arguments": { # The arguments to pass to Retrieval tools. # Required. The arguments to pass to the Retrieval tool.
+            "queries": [ # Queries for Retrieval information.
+              "A String",
+            ],
+          },
+          "retrievalType": "A String", # The type of retrieval tools.
+        },
+        "signature": "A String", # A signature hash for backend validation.
+        "urlContextCall": {
+          "arguments": { # The arguments to pass to the URL context.
+            "urls": [ # The URLs to fetch.
+              "A String",
+            ],
+          },
+        },
+      },
+      "serverToolResult": {
+        "codeExecutionResult": {
+          "isError": True or False,
+          "result": "A String",
+        },
+        "fileSearchResult": {
+          "result": [
+            { # The result of the File Search.
+            },
+          ],
+        },
+        "googleMapsResult": {
+          "result": [ # The results of the Google Maps.
+            { # The result of the Google Maps.
+              "places": [ # The places that were found.
+                {
+                  "name": "A String", # Title of the place.
+                  "placeId": "A String", # The ID of the place, in `places/{place_id}` format.
+                  "reviewSnippets": [ # Snippets of reviews that are used to generate answers about the features of a given place in Google Maps.
+                    { # Encapsulates a snippet of a user review that answers a question about the features of a specific place in Google Maps.
+                      "reviewId": "A String", # The ID of the review snippet.
+                      "title": "A String", # Title of the review.
+                      "url": "A String", # A link that corresponds to the user review on Google Maps.
+                    },
+                  ],
+                  "url": "A String", # URI reference of the place.
+                },
+              ],
+              "widgetContextToken": "A String", # Resource name of the Google Maps widget context token.
+            },
+          ],
+        },
+        "googleSearchResult": {
+          "isError": True or False,
+          "result": [
+            { # The result of the Google Search.
+              "searchSuggestions": "A String", # Web content snippet that can be embedded in a web page or an app webview.
+            },
+          ],
+        },
+        "processingResult": { # Streaming delta for the result of a server-initiated media processing step.
+        },
+        "retrievalResult": { # Used by Vertex Retrieval tools such as Parallel AI, Exa AI, Vertex AI Search, etc. ToolResultDelta.type
+          "isError": True or False, # Whether the retrieval resulted in an error.
+        },
+        "signature": "A String", # A signature hash for backend validation.
+        "urlContextResult": {
+          "isError": True or False,
+          "result": [
+            { # The result of the URL context.
+              "status": "A String", # The status of the URL retrieval.
+              "url": "A String", # The URL that was fetched.
+            },
+          ],
+        },
+      },
+      "text": {
+        "text": "A String",
+      },
+      "textAnnotationDelta": {
+        "annotations": [ # Citation information for model-generated content.
+          { # Citation information for model-generated content.
+            "endIndex": 42, # End of the attributed segment, exclusive.
+            "fileCitation": { # A file citation annotation. # A file citation annotation.
+              "customMetadata": { # User provided metadata about the retrieved context.
+                "a_key": "", # Properties of the object.
+              },
+              "documentUri": "A String", # The URI of the file.
+              "fileName": "A String", # The name of the file.
+              "mediaId": "A String", # Media ID in-case of image citations, if applicable.
+              "pageNumber": 42, # Page number of the cited document, if applicable.
+              "source": "A String", # Source attributed for a portion of the text.
+            },
+            "placeCitation": { # A place citation annotation. # A place citation annotation.
+              "name": "A String", # Title of the place.
+              "placeId": "A String", # The ID of the place, in `places/{place_id}` format.
+              "reviewSnippets": [ # Snippets of reviews that are used to generate answers about the features of a given place in Google Maps.
+                { # Encapsulates a snippet of a user review that answers a question about the features of a specific place in Google Maps.
+                  "reviewId": "A String", # The ID of the review snippet.
+                  "title": "A String", # Title of the review.
+                  "url": "A String", # A link that corresponds to the user review on Google Maps.
+                },
+              ],
+              "url": "A String", # URI reference of the place.
+            },
+            "speechMetadata": { # Speech annotation for text content. # Speech annotation for text content.
+              "speaker": "A String", # The speaker to associate with this turn.
+              "style": "A String", # Style instruction for the speech synthesis.
+            },
+            "startIndex": 42, # Start of segment of the response that is attributed to this source. Index indicates the start of the segment, measured in bytes.
+            "urlCitation": { # A URL citation annotation. # NOTE: We use these instead of the Citation message for historical reasons. A URL citation annotation.
+              "title": "A String", # The title of the URL.
+              "url": "A String", # The URL.
+            },
+            "wordInfo": { # Word-level ASR annotation for transcription output. Carries the word text, optional timing, and optional speaker attribution. # Word-level ASR annotation with timing and speaker info.
+              "endOffset": "A String", # End offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+              "speaker": "A String", # Optional. Speaker label for this word (e.g. "spk_1", "spk_2"). Present when diarization_mode is set in TranscriptionConfig.
+              "startOffset": "A String", # Start offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+              "text": "A String", # The transcribed word.
+            },
+          },
+        ],
+      },
+      "thoughtSignature": {
+        "signature": "A String", # Signature to match the backend source to be part of the generation.
+      },
+      "thoughtSummary": {
+        "content": { # The content of the response. # A new summary item to be added to the thought.
+          "audio": { # An audio content block.
+            "channels": 42, # The number of audio channels.
+            "data": "A String", # The audio content.
+            "mimeTypeString": "A String", # Flexible MIME type string of the audio, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+            "sampleRate": 42, # The sample rate of the audio.
+            "uri": "A String", # The URI of the audio.
+          },
+          "document": { # A document content block.
+            "data": "A String", # The document content.
+            "mimeTypeString": "A String", # Flexible MIME type string of the document, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+            "uri": "A String", # The URI of the document.
+          },
+          "image": { # An image content block.
+            "data": "A String", # The image content.
+            "mimeTypeString": "A String", # Flexible MIME type string of the image, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+            "resolution": "A String", # The resolution of the media.
+            "uri": "A String", # The URI of the image.
+          },
+          "text": { # A text content block.
+            "annotations": [ # Citation information for model-generated content.
+              { # Citation information for model-generated content.
+                "endIndex": 42, # End of the attributed segment, exclusive.
+                "fileCitation": { # A file citation annotation. # A file citation annotation.
+                  "customMetadata": { # User provided metadata about the retrieved context.
+                    "a_key": "", # Properties of the object.
+                  },
+                  "documentUri": "A String", # The URI of the file.
+                  "fileName": "A String", # The name of the file.
+                  "mediaId": "A String", # Media ID in-case of image citations, if applicable.
+                  "pageNumber": 42, # Page number of the cited document, if applicable.
+                  "source": "A String", # Source attributed for a portion of the text.
+                },
+                "placeCitation": { # A place citation annotation. # A place citation annotation.
+                  "name": "A String", # Title of the place.
+                  "placeId": "A String", # The ID of the place, in `places/{place_id}` format.
+                  "reviewSnippets": [ # Snippets of reviews that are used to generate answers about the features of a given place in Google Maps.
+                    { # Encapsulates a snippet of a user review that answers a question about the features of a specific place in Google Maps.
+                      "reviewId": "A String", # The ID of the review snippet.
+                      "title": "A String", # Title of the review.
+                      "url": "A String", # A link that corresponds to the user review on Google Maps.
+                    },
+                  ],
+                  "url": "A String", # URI reference of the place.
+                },
+                "speechMetadata": { # Speech annotation for text content. # Speech annotation for text content.
+                  "speaker": "A String", # The speaker to associate with this turn.
+                  "style": "A String", # Style instruction for the speech synthesis.
+                },
+                "startIndex": 42, # Start of segment of the response that is attributed to this source. Index indicates the start of the segment, measured in bytes.
+                "urlCitation": { # A URL citation annotation. # NOTE: We use these instead of the Citation message for historical reasons. A URL citation annotation.
+                  "title": "A String", # The title of the URL.
+                  "url": "A String", # The URL.
+                },
+                "wordInfo": { # Word-level ASR annotation for transcription output. Carries the word text, optional timing, and optional speaker attribution. # Word-level ASR annotation with timing and speaker info.
+                  "endOffset": "A String", # End offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                  "speaker": "A String", # Optional. Speaker label for this word (e.g. "spk_1", "spk_2"). Present when diarization_mode is set in TranscriptionConfig.
+                  "startOffset": "A String", # Start offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                  "text": "A String", # The transcribed word.
+                },
+              },
+            ],
+            "text": "A String", # Required. The text content.
+          },
+          "video": { # A video content block.
+            "data": "A String", # The video content.
+            "mimeTypeString": "A String", # Flexible MIME type string of the video, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+            "name": "A String", # A user-defined name for this content block. Can be referenced by the model in the final response.
+            "processingConfig": {
+              "static": {
+                "endOffset": "A String", # Optional. Segment end time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "30s". Must be non-negative and greater than `start_offset` if `start_offset` is set.
+                "fps": 3.14, # Optional. Video frame-rate sampling density.
+                "startOffset": "A String", # Optional. Segment start time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "10.5s". Must be non-negative.
+              },
+            },
+            "processingType": "A String",
+            "resolution": "A String", # The resolution of the media.
+            "uri": "A String", # The URI of the video.
+          },
+        },
+      },
+      "video": {
+        "data": "A String",
+        "mimeType": "A String",
+        "resolution": "A String", # The resolution of the media.
+        "uri": "A String",
+      },
+    },
+    "index": 42,
+  },
+  "stepStart": { # The step start data, used for step.start events. Step-based streaming event, used when steps are enabled.
+    "index": 42,
+    "step": { # A step in the interaction.
+      "modelOutput": { # Output generated by the model.
+        "content": [
+          { # The content of the response.
+            "audio": { # An audio content block.
+              "channels": 42, # The number of audio channels.
+              "data": "A String", # The audio content.
+              "mimeTypeString": "A String", # Flexible MIME type string of the audio, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+              "sampleRate": 42, # The sample rate of the audio.
+              "uri": "A String", # The URI of the audio.
+            },
+            "document": { # A document content block.
+              "data": "A String", # The document content.
+              "mimeTypeString": "A String", # Flexible MIME type string of the document, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+              "uri": "A String", # The URI of the document.
+            },
+            "image": { # An image content block.
+              "data": "A String", # The image content.
+              "mimeTypeString": "A String", # Flexible MIME type string of the image, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+              "resolution": "A String", # The resolution of the media.
+              "uri": "A String", # The URI of the image.
+            },
+            "text": { # A text content block.
+              "annotations": [ # Citation information for model-generated content.
+                { # Citation information for model-generated content.
+                  "endIndex": 42, # End of the attributed segment, exclusive.
+                  "fileCitation": { # A file citation annotation. # A file citation annotation.
+                    "customMetadata": { # User provided metadata about the retrieved context.
+                      "a_key": "", # Properties of the object.
+                    },
+                    "documentUri": "A String", # The URI of the file.
+                    "fileName": "A String", # The name of the file.
+                    "mediaId": "A String", # Media ID in-case of image citations, if applicable.
+                    "pageNumber": 42, # Page number of the cited document, if applicable.
+                    "source": "A String", # Source attributed for a portion of the text.
+                  },
+                  "placeCitation": { # A place citation annotation. # A place citation annotation.
+                    "name": "A String", # Title of the place.
+                    "placeId": "A String", # The ID of the place, in `places/{place_id}` format.
+                    "reviewSnippets": [ # Snippets of reviews that are used to generate answers about the features of a given place in Google Maps.
+                      { # Encapsulates a snippet of a user review that answers a question about the features of a specific place in Google Maps.
+                        "reviewId": "A String", # The ID of the review snippet.
+                        "title": "A String", # Title of the review.
+                        "url": "A String", # A link that corresponds to the user review on Google Maps.
+                      },
+                    ],
+                    "url": "A String", # URI reference of the place.
+                  },
+                  "speechMetadata": { # Speech annotation for text content. # Speech annotation for text content.
+                    "speaker": "A String", # The speaker to associate with this turn.
+                    "style": "A String", # Style instruction for the speech synthesis.
+                  },
+                  "startIndex": 42, # Start of segment of the response that is attributed to this source. Index indicates the start of the segment, measured in bytes.
+                  "urlCitation": { # A URL citation annotation. # NOTE: We use these instead of the Citation message for historical reasons. A URL citation annotation.
+                    "title": "A String", # The title of the URL.
+                    "url": "A String", # The URL.
+                  },
+                  "wordInfo": { # Word-level ASR annotation for transcription output. Carries the word text, optional timing, and optional speaker attribution. # Word-level ASR annotation with timing and speaker info.
+                    "endOffset": "A String", # End offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                    "speaker": "A String", # Optional. Speaker label for this word (e.g. "spk_1", "spk_2"). Present when diarization_mode is set in TranscriptionConfig.
+                    "startOffset": "A String", # Start offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                    "text": "A String", # The transcribed word.
+                  },
+                },
+              ],
+              "text": "A String", # Required. The text content.
+            },
+            "video": { # A video content block.
+              "data": "A String", # The video content.
+              "mimeTypeString": "A String", # Flexible MIME type string of the video, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+              "name": "A String", # A user-defined name for this content block. Can be referenced by the model in the final response.
+              "processingConfig": {
+                "static": {
+                  "endOffset": "A String", # Optional. Segment end time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "30s". Must be non-negative and greater than `start_offset` if `start_offset` is set.
+                  "fps": 3.14, # Optional. Video frame-rate sampling density.
+                  "startOffset": "A String", # Optional. Segment start time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "10.5s". Must be non-negative.
+                },
+              },
+              "processingType": "A String",
+              "resolution": "A String", # The resolution of the media.
+              "uri": "A String", # The URI of the video.
+            },
+          },
+        ],
+        "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.
+        },
+      },
+      "thought": { # A thought step.
+        "signature": "A String", # A signature hash for backend validation.
+        "summary": [ # A summary of the thought.
+          { # The content of the response.
+            "audio": { # An audio content block.
+              "channels": 42, # The number of audio channels.
+              "data": "A String", # The audio content.
+              "mimeTypeString": "A String", # Flexible MIME type string of the audio, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+              "sampleRate": 42, # The sample rate of the audio.
+              "uri": "A String", # The URI of the audio.
+            },
+            "document": { # A document content block.
+              "data": "A String", # The document content.
+              "mimeTypeString": "A String", # Flexible MIME type string of the document, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+              "uri": "A String", # The URI of the document.
+            },
+            "image": { # An image content block.
+              "data": "A String", # The image content.
+              "mimeTypeString": "A String", # Flexible MIME type string of the image, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+              "resolution": "A String", # The resolution of the media.
+              "uri": "A String", # The URI of the image.
+            },
+            "text": { # A text content block.
+              "annotations": [ # Citation information for model-generated content.
+                { # Citation information for model-generated content.
+                  "endIndex": 42, # End of the attributed segment, exclusive.
+                  "fileCitation": { # A file citation annotation. # A file citation annotation.
+                    "customMetadata": { # User provided metadata about the retrieved context.
+                      "a_key": "", # Properties of the object.
+                    },
+                    "documentUri": "A String", # The URI of the file.
+                    "fileName": "A String", # The name of the file.
+                    "mediaId": "A String", # Media ID in-case of image citations, if applicable.
+                    "pageNumber": 42, # Page number of the cited document, if applicable.
+                    "source": "A String", # Source attributed for a portion of the text.
+                  },
+                  "placeCitation": { # A place citation annotation. # A place citation annotation.
+                    "name": "A String", # Title of the place.
+                    "placeId": "A String", # The ID of the place, in `places/{place_id}` format.
+                    "reviewSnippets": [ # Snippets of reviews that are used to generate answers about the features of a given place in Google Maps.
+                      { # Encapsulates a snippet of a user review that answers a question about the features of a specific place in Google Maps.
+                        "reviewId": "A String", # The ID of the review snippet.
+                        "title": "A String", # Title of the review.
+                        "url": "A String", # A link that corresponds to the user review on Google Maps.
+                      },
+                    ],
+                    "url": "A String", # URI reference of the place.
+                  },
+                  "speechMetadata": { # Speech annotation for text content. # Speech annotation for text content.
+                    "speaker": "A String", # The speaker to associate with this turn.
+                    "style": "A String", # Style instruction for the speech synthesis.
+                  },
+                  "startIndex": 42, # Start of segment of the response that is attributed to this source. Index indicates the start of the segment, measured in bytes.
+                  "urlCitation": { # A URL citation annotation. # NOTE: We use these instead of the Citation message for historical reasons. A URL citation annotation.
+                    "title": "A String", # The title of the URL.
+                    "url": "A String", # The URL.
+                  },
+                  "wordInfo": { # Word-level ASR annotation for transcription output. Carries the word text, optional timing, and optional speaker attribution. # Word-level ASR annotation with timing and speaker info.
+                    "endOffset": "A String", # End offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                    "speaker": "A String", # Optional. Speaker label for this word (e.g. "spk_1", "spk_2"). Present when diarization_mode is set in TranscriptionConfig.
+                    "startOffset": "A String", # Start offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                    "text": "A String", # The transcribed word.
+                  },
+                },
+              ],
+              "text": "A String", # Required. The text content.
+            },
+            "video": { # A video content block.
+              "data": "A String", # The video content.
+              "mimeTypeString": "A String", # Flexible MIME type string of the video, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+              "name": "A String", # A user-defined name for this content block. Can be referenced by the model in the final response.
+              "processingConfig": {
+                "static": {
+                  "endOffset": "A String", # Optional. Segment end time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "30s". Must be non-negative and greater than `start_offset` if `start_offset` is set.
+                  "fps": 3.14, # Optional. Video frame-rate sampling density.
+                  "startOffset": "A String", # Optional. Segment start time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "10.5s". Must be non-negative.
+                },
+              },
+              "processingType": "A String",
+              "resolution": "A String", # The resolution of the media.
+              "uri": "A String", # The URI of the video.
+            },
+          },
+        ],
+      },
+      "toolCall": { # Tool call step.
+        "codeExecutionCall": { # Code execution call step.
+          "arguments": { # The arguments to pass to the code execution. # Required. The arguments to pass to the code execution.
+            "code": "A String", # The code to be executed.
+            "language": "A String", # Programming language of the `code`.
+          },
+        },
+        "fileSearchCall": { # File Search call step.
+        },
+        "functionCall": { # A function tool call step.
+          "arguments": { # `Struct` represents a structured data value, consisting of fields which map to dynamically typed values. # Required. The arguments to pass to the function.
+            "fields": [ # Dynamically typed fields. List instead of map because LLMs are sensitive to ordering, and we want to give users full control.
+              { # Represents a single field in a struct.
+                "name": "A String",
+                "value": { # `Value` represents a dynamically typed value which can be either null, a number, a string, a boolean, a recursive struct value, or a list of values. A producer of value is expected to set one of these variants. Absence of any variant indicates an error.
+                  "boolValue": True or False, # Represents a boolean value.
+                  "contentValue": { # The content of the response. # Represents rich content (text, image, etc.).
+                    "audio": { # An audio content block.
+                      "channels": 42, # The number of audio channels.
+                      "data": "A String", # The audio content.
+                      "mimeTypeString": "A String", # Flexible MIME type string of the audio, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                      "sampleRate": 42, # The sample rate of the audio.
+                      "uri": "A String", # The URI of the audio.
+                    },
+                    "document": { # A document content block.
+                      "data": "A String", # The document content.
+                      "mimeTypeString": "A String", # Flexible MIME type string of the document, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                      "uri": "A String", # The URI of the document.
+                    },
+                    "image": { # An image content block.
+                      "data": "A String", # The image content.
+                      "mimeTypeString": "A String", # Flexible MIME type string of the image, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                      "resolution": "A String", # The resolution of the media.
+                      "uri": "A String", # The URI of the image.
+                    },
+                    "text": { # A text content block.
+                      "annotations": [ # Citation information for model-generated content.
+                        { # Citation information for model-generated content.
+                          "endIndex": 42, # End of the attributed segment, exclusive.
+                          "fileCitation": { # A file citation annotation. # A file citation annotation.
+                            "customMetadata": { # User provided metadata about the retrieved context.
+                              "a_key": "", # Properties of the object.
+                            },
+                            "documentUri": "A String", # The URI of the file.
+                            "fileName": "A String", # The name of the file.
+                            "mediaId": "A String", # Media ID in-case of image citations, if applicable.
+                            "pageNumber": 42, # Page number of the cited document, if applicable.
+                            "source": "A String", # Source attributed for a portion of the text.
+                          },
+                          "placeCitation": { # A place citation annotation. # A place citation annotation.
+                            "name": "A String", # Title of the place.
+                            "placeId": "A String", # The ID of the place, in `places/{place_id}` format.
+                            "reviewSnippets": [ # Snippets of reviews that are used to generate answers about the features of a given place in Google Maps.
+                              { # Encapsulates a snippet of a user review that answers a question about the features of a specific place in Google Maps.
+                                "reviewId": "A String", # The ID of the review snippet.
+                                "title": "A String", # Title of the review.
+                                "url": "A String", # A link that corresponds to the user review on Google Maps.
+                              },
+                            ],
+                            "url": "A String", # URI reference of the place.
+                          },
+                          "speechMetadata": { # Speech annotation for text content. # Speech annotation for text content.
+                            "speaker": "A String", # The speaker to associate with this turn.
+                            "style": "A String", # Style instruction for the speech synthesis.
+                          },
+                          "startIndex": 42, # Start of segment of the response that is attributed to this source. Index indicates the start of the segment, measured in bytes.
+                          "urlCitation": { # A URL citation annotation. # NOTE: We use these instead of the Citation message for historical reasons. A URL citation annotation.
+                            "title": "A String", # The title of the URL.
+                            "url": "A String", # The URL.
+                          },
+                          "wordInfo": { # Word-level ASR annotation for transcription output. Carries the word text, optional timing, and optional speaker attribution. # Word-level ASR annotation with timing and speaker info.
+                            "endOffset": "A String", # End offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                            "speaker": "A String", # Optional. Speaker label for this word (e.g. "spk_1", "spk_2"). Present when diarization_mode is set in TranscriptionConfig.
+                            "startOffset": "A String", # Start offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                            "text": "A String", # The transcribed word.
+                          },
+                        },
+                      ],
+                      "text": "A String", # Required. The text content.
+                    },
+                    "video": { # A video content block.
+                      "data": "A String", # The video content.
+                      "mimeTypeString": "A String", # Flexible MIME type string of the video, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                      "name": "A String", # A user-defined name for this content block. Can be referenced by the model in the final response.
+                      "processingConfig": {
+                        "static": {
+                          "endOffset": "A String", # Optional. Segment end time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "30s". Must be non-negative and greater than `start_offset` if `start_offset` is set.
+                          "fps": 3.14, # Optional. Video frame-rate sampling density.
+                          "startOffset": "A String", # Optional. Segment start time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "10.5s". Must be non-negative.
+                        },
+                      },
+                      "processingType": "A String",
+                      "resolution": "A String", # The resolution of the media.
+                      "uri": "A String", # The URI of the video.
+                    },
+                  },
+                  "listValue": { # `ListValue` is a wrapper around a repeated field of values. # Represents a repeated `Value`.
+                    "values": [ # Repeated field of dynamically typed values.
+                      # Object with schema name: GenaiVertexV1Value
+                    ],
+                  },
+                  "nullValue": "A String", # Represents a null value.
+                  "numberValue": 3.14, # Represents a double value.
+                  "stringValue": "A String", # Represents a string value.
+                  "structValue": # Object with schema name: GenaiVertexV1Struct # Represents a structured value.
+                },
+              },
+            ],
+          },
+          "name": "A String", # Required. The name of the tool to call.
+        },
+        "googleMapsCall": { # Google Maps call step.
+          "arguments": { # The arguments to pass to the Google Maps tool. # The arguments to pass to the Google Maps tool.
+            "queries": [ # The queries to be executed.
+              "A String",
+            ],
+          },
+        },
+        "googleSearchCall": { # Google Search call step.
+          "arguments": { # The arguments to pass to Google Search. # Required. The arguments to pass to Google Search.
+            "queries": [ # Web search queries for the following-up web search.
+              "A String",
+            ],
+          },
+          "searchType": "A String", # The type of search grounding enabled.
+        },
+        "id": "A String", # Required. A unique ID for this specific tool call.
+        "processingCall": { # A server-initiated processing step for media analysis (e.g. video understanding).
+        },
+        "retrievalCall": { # Retrieval call step. Used by Vertex Retrieval tools such as Parallel AI, Exa AI, Vertex AI Search, etc. RetrievalType decides which tool is used.
+          "arguments": { # The arguments to pass to Retrieval tools. # Required. The arguments to pass to the retrieval tool.
+            "queries": [ # Queries for Retrieval information.
+              "A String",
+            ],
+          },
+          "retrievalType": "A String", # The type of retrieval tools.
+        },
+        "signature": "A String", # A signature hash for backend validation.
+        "urlContextCall": { # URL context call step.
+          "arguments": { # The arguments to pass to the URL context. # Required. The arguments to pass to the URL context.
+            "urls": [ # The URLs to fetch.
+              "A String",
+            ],
+          },
+        },
+      },
+      "toolResult": { # Tool result step.
+        "callId": "A String", # Required. ID to match the ID from the function call block.
+        "codeExecutionResult": { # Code execution result step.
+          "isError": True or False, # Whether the code execution resulted in an error.
+          "result": "A String", # Required. The output of the code execution.
+        },
+        "fileSearchResult": { # File Search result step.
+        },
+        "functionResult": { # Result of a function tool call.
+          "isError": True or False, # Whether the tool call resulted in an error.
+          "name": "A String", # The name of the tool that was called.
+          "result": { # `Value` represents a dynamically typed value which can be either null, a number, a string, a boolean, a recursive struct value, or a list of values. A producer of value is expected to set one of these variants. Absence of any variant indicates an error. # Required. The result of the tool call.
+            "boolValue": True or False, # Represents a boolean value.
+            "contentValue": { # The content of the response. # Represents rich content (text, image, etc.).
+              "audio": { # An audio content block.
+                "channels": 42, # The number of audio channels.
+                "data": "A String", # The audio content.
+                "mimeTypeString": "A String", # Flexible MIME type string of the audio, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                "sampleRate": 42, # The sample rate of the audio.
+                "uri": "A String", # The URI of the audio.
+              },
+              "document": { # A document content block.
+                "data": "A String", # The document content.
+                "mimeTypeString": "A String", # Flexible MIME type string of the document, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                "uri": "A String", # The URI of the document.
+              },
+              "image": { # An image content block.
+                "data": "A String", # The image content.
+                "mimeTypeString": "A String", # Flexible MIME type string of the image, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                "resolution": "A String", # The resolution of the media.
+                "uri": "A String", # The URI of the image.
+              },
+              "text": { # A text content block.
+                "annotations": [ # Citation information for model-generated content.
+                  { # Citation information for model-generated content.
+                    "endIndex": 42, # End of the attributed segment, exclusive.
+                    "fileCitation": { # A file citation annotation. # A file citation annotation.
+                      "customMetadata": { # User provided metadata about the retrieved context.
+                        "a_key": "", # Properties of the object.
+                      },
+                      "documentUri": "A String", # The URI of the file.
+                      "fileName": "A String", # The name of the file.
+                      "mediaId": "A String", # Media ID in-case of image citations, if applicable.
+                      "pageNumber": 42, # Page number of the cited document, if applicable.
+                      "source": "A String", # Source attributed for a portion of the text.
+                    },
+                    "placeCitation": { # A place citation annotation. # A place citation annotation.
+                      "name": "A String", # Title of the place.
+                      "placeId": "A String", # The ID of the place, in `places/{place_id}` format.
+                      "reviewSnippets": [ # Snippets of reviews that are used to generate answers about the features of a given place in Google Maps.
+                        { # Encapsulates a snippet of a user review that answers a question about the features of a specific place in Google Maps.
+                          "reviewId": "A String", # The ID of the review snippet.
+                          "title": "A String", # Title of the review.
+                          "url": "A String", # A link that corresponds to the user review on Google Maps.
+                        },
+                      ],
+                      "url": "A String", # URI reference of the place.
+                    },
+                    "speechMetadata": { # Speech annotation for text content. # Speech annotation for text content.
+                      "speaker": "A String", # The speaker to associate with this turn.
+                      "style": "A String", # Style instruction for the speech synthesis.
+                    },
+                    "startIndex": 42, # Start of segment of the response that is attributed to this source. Index indicates the start of the segment, measured in bytes.
+                    "urlCitation": { # A URL citation annotation. # NOTE: We use these instead of the Citation message for historical reasons. A URL citation annotation.
+                      "title": "A String", # The title of the URL.
+                      "url": "A String", # The URL.
+                    },
+                    "wordInfo": { # Word-level ASR annotation for transcription output. Carries the word text, optional timing, and optional speaker attribution. # Word-level ASR annotation with timing and speaker info.
+                      "endOffset": "A String", # End offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                      "speaker": "A String", # Optional. Speaker label for this word (e.g. "spk_1", "spk_2"). Present when diarization_mode is set in TranscriptionConfig.
+                      "startOffset": "A String", # Start offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                      "text": "A String", # The transcribed word.
+                    },
+                  },
+                ],
+                "text": "A String", # Required. The text content.
+              },
+              "video": { # A video content block.
+                "data": "A String", # The video content.
+                "mimeTypeString": "A String", # Flexible MIME type string of the video, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                "name": "A String", # A user-defined name for this content block. Can be referenced by the model in the final response.
+                "processingConfig": {
+                  "static": {
+                    "endOffset": "A String", # Optional. Segment end time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "30s". Must be non-negative and greater than `start_offset` if `start_offset` is set.
+                    "fps": 3.14, # Optional. Video frame-rate sampling density.
+                    "startOffset": "A String", # Optional. Segment start time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "10.5s". Must be non-negative.
+                  },
+                },
+                "processingType": "A String",
+                "resolution": "A String", # The resolution of the media.
+                "uri": "A String", # The URI of the video.
+              },
+            },
+            "listValue": { # `ListValue` is a wrapper around a repeated field of values. # Represents a repeated `Value`.
+              "values": [ # Repeated field of dynamically typed values.
+                # Object with schema name: GenaiVertexV1Value
+              ],
+            },
+            "nullValue": "A String", # Represents a null value.
+            "numberValue": 3.14, # Represents a double value.
+            "stringValue": "A String", # Represents a string value.
+            "structValue": # Object with schema name: GenaiVertexV1Struct # Represents a structured value.
+          },
+        },
+        "googleMapsResult": { # Google Maps result step.
+          "result": [
+            { # The result of the Google Maps.
+              "places": [
+                {
+                  "name": "A String",
+                  "placeId": "A String",
+                  "reviewSnippets": [
+                    { # Encapsulates a snippet of a user review that answers a question about the features of a specific place in Google Maps.
+                      "reviewId": "A String", # The ID of the review snippet.
+                      "title": "A String", # Title of the review.
+                      "url": "A String", # A link that corresponds to the user review on Google Maps.
+                    },
+                  ],
+                  "url": "A String",
+                },
+              ],
+              "widgetContextToken": "A String",
+            },
+          ],
+        },
+        "googleSearchResult": { # Google Search result step.
+          "isError": True or False, # Whether the Google Search resulted in an error.
+          "result": [ # Required. The results of the Google Search.
+            { # The result of the Google Search.
+              "searchSuggestions": "A String", # Web content snippet that can be embedded in a web page or an app webview.
+            },
+          ],
+        },
+        "processingResult": { # The result of a server-initiated media processing step.
+        },
+        "retrievalResult": { # Vertex Retrieval result step. Used by Vertex Retrieval tools such as Parallel AI, Exa AI, Vertex AI Search, etc.
+          "isError": True or False, # Whether the retrieval resulted in an error.
+        },
+        "signature": "A String", # A signature hash for backend validation.
+        "urlContextResult": { # URL context result step.
+          "isError": True or False, # Whether the URL context resulted in an error.
+          "result": [ # Required. The results of the URL context.
+            { # The result of the URL context.
+              "status": "A String", # The status of the URL retrieval.
+              "url": "A String", # The URL that was fetched.
+            },
+          ],
+        },
+      },
+      "userInput": { # Input provided by the user. # DO NOT USE -- These are for 3P JSON only
+        "contentList": { # A list of Content. # The content of the step. An array of Content objects.
+          "contents": [ # The contents of the list.
+            { # The content of the response.
+              "audio": { # An audio content block.
+                "channels": 42, # The number of audio channels.
+                "data": "A String", # The audio content.
+                "mimeTypeString": "A String", # Flexible MIME type string of the audio, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                "sampleRate": 42, # The sample rate of the audio.
+                "uri": "A String", # The URI of the audio.
+              },
+              "document": { # A document content block.
+                "data": "A String", # The document content.
+                "mimeTypeString": "A String", # Flexible MIME type string of the document, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                "uri": "A String", # The URI of the document.
+              },
+              "image": { # An image content block.
+                "data": "A String", # The image content.
+                "mimeTypeString": "A String", # Flexible MIME type string of the image, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                "resolution": "A String", # The resolution of the media.
+                "uri": "A String", # The URI of the image.
+              },
+              "text": { # A text content block.
+                "annotations": [ # Citation information for model-generated content.
+                  { # Citation information for model-generated content.
+                    "endIndex": 42, # End of the attributed segment, exclusive.
+                    "fileCitation": { # A file citation annotation. # A file citation annotation.
+                      "customMetadata": { # User provided metadata about the retrieved context.
+                        "a_key": "", # Properties of the object.
+                      },
+                      "documentUri": "A String", # The URI of the file.
+                      "fileName": "A String", # The name of the file.
+                      "mediaId": "A String", # Media ID in-case of image citations, if applicable.
+                      "pageNumber": 42, # Page number of the cited document, if applicable.
+                      "source": "A String", # Source attributed for a portion of the text.
+                    },
+                    "placeCitation": { # A place citation annotation. # A place citation annotation.
+                      "name": "A String", # Title of the place.
+                      "placeId": "A String", # The ID of the place, in `places/{place_id}` format.
+                      "reviewSnippets": [ # Snippets of reviews that are used to generate answers about the features of a given place in Google Maps.
+                        { # Encapsulates a snippet of a user review that answers a question about the features of a specific place in Google Maps.
+                          "reviewId": "A String", # The ID of the review snippet.
+                          "title": "A String", # Title of the review.
+                          "url": "A String", # A link that corresponds to the user review on Google Maps.
+                        },
+                      ],
+                      "url": "A String", # URI reference of the place.
+                    },
+                    "speechMetadata": { # Speech annotation for text content. # Speech annotation for text content.
+                      "speaker": "A String", # The speaker to associate with this turn.
+                      "style": "A String", # Style instruction for the speech synthesis.
+                    },
+                    "startIndex": 42, # Start of segment of the response that is attributed to this source. Index indicates the start of the segment, measured in bytes.
+                    "urlCitation": { # A URL citation annotation. # NOTE: We use these instead of the Citation message for historical reasons. A URL citation annotation.
+                      "title": "A String", # The title of the URL.
+                      "url": "A String", # The URL.
+                    },
+                    "wordInfo": { # Word-level ASR annotation for transcription output. Carries the word text, optional timing, and optional speaker attribution. # Word-level ASR annotation with timing and speaker info.
+                      "endOffset": "A String", # End offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                      "speaker": "A String", # Optional. Speaker label for this word (e.g. "spk_1", "spk_2"). Present when diarization_mode is set in TranscriptionConfig.
+                      "startOffset": "A String", # Start offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                      "text": "A String", # The transcribed word.
+                    },
+                  },
+                ],
+                "text": "A String", # Required. The text content.
+              },
+              "video": { # A video content block.
+                "data": "A String", # The video content.
+                "mimeTypeString": "A String", # Flexible MIME type string of the video, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                "name": "A String", # A user-defined name for this content block. Can be referenced by the model in the final response.
+                "processingConfig": {
+                  "static": {
+                    "endOffset": "A String", # Optional. Segment end time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "30s". Must be non-negative and greater than `start_offset` if `start_offset` is set.
+                    "fps": 3.14, # Optional. Video frame-rate sampling density.
+                    "startOffset": "A String", # Optional. Segment start time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "10.5s". Must be non-negative.
+                  },
+                },
+                "processingType": "A String",
+                "resolution": "A String", # The resolution of the media.
+                "uri": "A String", # The URI of the video.
+              },
+            },
+          ],
+        },
+        "contentString": "A String", # The content of the step. A single string.
+      },
+    },
+  },
+  "stepStop": { # The step stop data, used for step.stop events. Step-based streaming event, used when steps are enabled.
+    "index": 42,
+    "stepUsage": { # Statistics on the interaction request's token usage. # Model usage stats for this specific step.
+      "cachedTokensByModality": [ # A breakdown of cached token usage by modality.
+        { # The token count for a single response modality.
+          "modality": "A String", # The modality associated with the token count.
+          "tokens": 42, # Number of tokens for the modality.
+        },
+      ],
+      "groundingToolCount": [ # Grounding tool count.
+        { # The number of grounding tool counts.
+          "count": 42, # The number of grounding tool counts.
+          "type": "A String", # The grounding tool type associated with the count.
+        },
+      ],
+      "inputTokensByModality": [ # A breakdown of input token usage by modality.
+        { # The token count for a single response modality.
+          "modality": "A String", # The modality associated with the token count.
+          "tokens": 42, # Number of tokens for the modality.
+        },
+      ],
+      "outputTokensByModality": [ # A breakdown of output token usage by modality.
+        { # The token count for a single response modality.
+          "modality": "A String", # The modality associated with the token count.
+          "tokens": 42, # Number of tokens for the modality.
+        },
+      ],
+      "toolUseTokensByModality": [ # A breakdown of tool-use token usage by modality.
+        { # The token count for a single response modality.
+          "modality": "A String", # The modality associated with the token count.
+          "tokens": 42, # Number of tokens for the modality.
+        },
+      ],
+      "totalCachedTokens": 42, # Number of tokens in the cached part of the prompt (the cached content).
+      "totalInputTokens": 42, # Number of tokens in the prompt (context).
+      "totalOutputTokens": 42, # Total number of tokens across all the generated responses.
+      "totalThoughtTokens": 42, # Number of tokens of thoughts for thinking models.
+      "totalTokens": 42, # Total token count for the interaction request (prompt + responses + other internal tokens).
+      "totalToolUseTokens": 42, # Number of tokens present in tool-use prompt(s).
+    },
+    "usage": { # Statistics on the interaction request's token usage. # Cumulative model usage stats from the start of the session.
+      "cachedTokensByModality": [ # A breakdown of cached token usage by modality.
+        { # The token count for a single response modality.
+          "modality": "A String", # The modality associated with the token count.
+          "tokens": 42, # Number of tokens for the modality.
+        },
+      ],
+      "groundingToolCount": [ # Grounding tool count.
+        { # The number of grounding tool counts.
+          "count": 42, # The number of grounding tool counts.
+          "type": "A String", # The grounding tool type associated with the count.
+        },
+      ],
+      "inputTokensByModality": [ # A breakdown of input token usage by modality.
+        { # The token count for a single response modality.
+          "modality": "A String", # The modality associated with the token count.
+          "tokens": 42, # Number of tokens for the modality.
+        },
+      ],
+      "outputTokensByModality": [ # A breakdown of output token usage by modality.
+        { # The token count for a single response modality.
+          "modality": "A String", # The modality associated with the token count.
+          "tokens": 42, # Number of tokens for the modality.
+        },
+      ],
+      "toolUseTokensByModality": [ # A breakdown of tool-use token usage by modality.
+        { # The token count for a single response modality.
+          "modality": "A String", # The modality associated with the token count.
+          "tokens": 42, # Number of tokens for the modality.
+        },
+      ],
+      "totalCachedTokens": 42, # Number of tokens in the cached part of the prompt (the cached content).
+      "totalInputTokens": 42, # Number of tokens in the prompt (context).
+      "totalOutputTokens": 42, # Total number of tokens across all the generated responses.
+      "totalThoughtTokens": 42, # Number of tokens of thoughts for thinking models.
+      "totalTokens": 42, # Total token count for the interaction request (prompt + responses + other internal tokens).
+      "totalToolUseTokens": 42, # Number of tokens present in tool-use prompt(s).
+    },
+  },
+}
+
+ + \ No newline at end of file diff --git a/docs/dyn/aiplatform_v1.projects.locations.agents.html b/docs/dyn/aiplatform_v1.projects.locations.agents.html index 9b4c5b8964..55136e98c1 100644 --- a/docs/dyn/aiplatform_v1.projects.locations.agents.html +++ b/docs/dyn/aiplatform_v1.projects.locations.agents.html @@ -124,6 +124,7 @@

Method Details

"base_environment": "", # Optional. The base environment configuration for the agent. Valid types: * A string value for the environment ID, or `remote` for the default. * A struct value for the `environment_config`. "created": "A String", # Output only. The time the agent was created. "description": "A String", # Optional. The description of the agent. + "effectiveIdentity": "A String", # Output only. The resolved Agent Identity (SPIFFE principal) of the agent. "id": "A String", # Immutable. The user-specified ID for the agent. This ID becomes the final component of the agent resource name. If not provided, Vertex AI will generate a value for this ID. The ID can be up to 63 characters and must match the regular expression `[a-z]([a-z0-9-]{0,61}[a-z0-9])?`. "metadata": { # Optional. The metadata for the agent. "a_key": "A String", @@ -236,6 +237,7 @@

Method Details

"base_environment": "", # Optional. The base environment configuration for the agent. Valid types: * A string value for the environment ID, or `remote` for the default. * A struct value for the `environment_config`. "created": "A String", # Output only. The time the agent was created. "description": "A String", # Optional. The description of the agent. + "effectiveIdentity": "A String", # Output only. The resolved Agent Identity (SPIFFE principal) of the agent. "id": "A String", # Immutable. The user-specified ID for the agent. This ID becomes the final component of the agent resource name. If not provided, Vertex AI will generate a value for this ID. The ID can be up to 63 characters and must match the regular expression `[a-z]([a-z0-9-]{0,61}[a-z0-9])?`. "metadata": { # Optional. The metadata for the agent. "a_key": "A String", @@ -325,6 +327,7 @@

Method Details

"base_environment": "", # Optional. The base environment configuration for the agent. Valid types: * A string value for the environment ID, or `remote` for the default. * A struct value for the `environment_config`. "created": "A String", # Output only. The time the agent was created. "description": "A String", # Optional. The description of the agent. + "effectiveIdentity": "A String", # Output only. The resolved Agent Identity (SPIFFE principal) of the agent. "id": "A String", # Immutable. The user-specified ID for the agent. This ID becomes the final component of the agent resource name. If not provided, Vertex AI will generate a value for this ID. The ID can be up to 63 characters and must match the regular expression `[a-z]([a-z0-9-]{0,61}[a-z0-9])?`. "metadata": { # Optional. The metadata for the agent. "a_key": "A String", @@ -385,6 +388,7 @@

Method Details

"base_environment": "", # Optional. The base environment configuration for the agent. Valid types: * A string value for the environment ID, or `remote` for the default. * A struct value for the `environment_config`. "created": "A String", # Output only. The time the agent was created. "description": "A String", # Optional. The description of the agent. + "effectiveIdentity": "A String", # Output only. The resolved Agent Identity (SPIFFE principal) of the agent. "id": "A String", # Immutable. The user-specified ID for the agent. This ID becomes the final component of the agent resource name. If not provided, Vertex AI will generate a value for this ID. The ID can be up to 63 characters and must match the regular expression `[a-z]([a-z0-9-]{0,61}[a-z0-9])?`. "metadata": { # Optional. The metadata for the agent. "a_key": "A String", diff --git a/docs/dyn/aiplatform_v1.projects.locations.batchPredictionJobs.html b/docs/dyn/aiplatform_v1.projects.locations.batchPredictionJobs.html index bf99f7e88e..3de0cd4738 100644 --- a/docs/dyn/aiplatform_v1.projects.locations.batchPredictionJobs.html +++ b/docs/dyn/aiplatform_v1.projects.locations.batchPredictionJobs.html @@ -368,7 +368,7 @@

Method Details

"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). + "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). At most 200 environment variables can be specified. Each variable (`NAME=value`) must be smaller than 128 KiB, and the total size of all variables must not exceed 512 KiB. { # 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. @@ -737,7 +737,7 @@

Method Details

"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). + "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). At most 200 environment variables can be specified. Each variable (`NAME=value`) must be smaller than 128 KiB, and the total size of all variables must not exceed 512 KiB. { # 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. @@ -1148,7 +1148,7 @@

Method Details

"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). + "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). At most 200 environment variables can be specified. Each variable (`NAME=value`) must be smaller than 128 KiB, and the total size of all variables must not exceed 512 KiB. { # 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. @@ -1530,7 +1530,7 @@

Method Details

"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). + "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). At most 200 environment variables can be specified. Each variable (`NAME=value`) must be smaller than 128 KiB, and the total size of all variables must not exceed 512 KiB. { # 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. diff --git a/docs/dyn/aiplatform_v1.projects.locations.cachedContents.html b/docs/dyn/aiplatform_v1.projects.locations.cachedContents.html index 86426d669e..a58d048f15 100644 --- a/docs/dyn/aiplatform_v1.projects.locations.cachedContents.html +++ b/docs/dyn/aiplatform_v1.projects.locations.cachedContents.html @@ -114,7 +114,7 @@

Method Details

"contents": [ # Optional. Input only. Immutable. The content to cache { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -216,7 +216,7 @@

Method Details

"name": "A String", # Immutable. Identifier. The server-generated resource name of the cached content Format: projects/{project}/locations/{location}/cachedContents/{cached_content} "systemInstruction": { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. # Optional. Input only. Immutable. Developer set system instruction. Currently, text only "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -581,7 +581,7 @@

Method Details

"contents": [ # Optional. Input only. Immutable. The content to cache { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -683,7 +683,7 @@

Method Details

"name": "A String", # Immutable. Identifier. The server-generated resource name of the cached content Format: projects/{project}/locations/{location}/cachedContents/{cached_content} "systemInstruction": { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. # Optional. Input only. Immutable. Developer set system instruction. Currently, text only "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -1073,7 +1073,7 @@

Method Details

"contents": [ # Optional. Input only. Immutable. The content to cache { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -1175,7 +1175,7 @@

Method Details

"name": "A String", # Immutable. Identifier. The server-generated resource name of the cached content Format: projects/{project}/locations/{location}/cachedContents/{cached_content} "systemInstruction": { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. # Optional. Input only. Immutable. Developer set system instruction. Currently, text only "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -1551,7 +1551,7 @@

Method Details

"contents": [ # Optional. Input only. Immutable. The content to cache { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -1653,7 +1653,7 @@

Method Details

"name": "A String", # Immutable. Identifier. The server-generated resource name of the cached content Format: projects/{project}/locations/{location}/cachedContents/{cached_content} "systemInstruction": { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. # Optional. Input only. Immutable. Developer set system instruction. Currently, text only "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -2037,7 +2037,7 @@

Method Details

"contents": [ # Optional. Input only. Immutable. The content to cache { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -2139,7 +2139,7 @@

Method Details

"name": "A String", # Immutable. Identifier. The server-generated resource name of the cached content Format: projects/{project}/locations/{location}/cachedContents/{cached_content} "systemInstruction": { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. # Optional. Input only. Immutable. Developer set system instruction. Currently, text only "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -2505,7 +2505,7 @@

Method Details

"contents": [ # Optional. Input only. Immutable. The content to cache { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -2607,7 +2607,7 @@

Method Details

"name": "A String", # Immutable. Identifier. The server-generated resource name of the cached content Format: projects/{project}/locations/{location}/cachedContents/{cached_content} "systemInstruction": { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. # Optional. Input only. Immutable. Developer set system instruction. Currently, text only "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. diff --git a/docs/dyn/aiplatform_v1.projects.locations.endpoints.html b/docs/dyn/aiplatform_v1.projects.locations.endpoints.html index 5b7d0bf27b..71f642bc74 100644 --- a/docs/dyn/aiplatform_v1.projects.locations.endpoints.html +++ b/docs/dyn/aiplatform_v1.projects.locations.endpoints.html @@ -200,7 +200,7 @@

Method Details

"contents": [ # Optional. Input content. { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -334,7 +334,7 @@

Method Details

"contents": [ # Optional. Input content. { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -599,7 +599,7 @@

Method Details

"model": "A String", # Optional. The name of the publisher model requested to serve the prediction. Format: `projects/{project}/locations/{location}/publishers/*/models/*` "systemInstruction": { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. # Optional. The user provided system instructions for the model. Note: only text should be used in parts and content in each part will be in a separate paragraph. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -1899,7 +1899,7 @@

Method Details

"contents": [ # Required. The content of the current conversation with the model. For single-turn queries, this is a single instance. For multi-turn queries, this is a repeated field that contains conversation history + latest request. { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -2174,7 +2174,7 @@

Method Details

], "systemInstruction": { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. # Optional. The user provided system instructions for the model. Note: only text should be used in parts and content in each part will be in a separate paragraph. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -2548,7 +2548,7 @@

Method Details

}, "content": { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. # Output only. The content of the candidate. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -2639,6 +2639,7 @@

Method Details

], "role": "A String", # Optional. The producer of the content. Must be either 'user' or 'model'. If not set, the service will default to 'user'. }, + "continuationToken": "A String", # Output only. An optional opaque continuation token returned when `finish_reason` is `CONTINUATION`. Clients can pass this token in a subsequent `GenerateContentRequest` to continue generation. "finishMessage": "A String", # Output only. Describes the reason the model stopped generating tokens in more detail. This field is returned only when `finish_reason` is set. "finishReason": "A String", # Output only. The reason why the model stopped generating tokens. If empty, the model has not stopped generating. "groundingMetadata": { # Information about the sources that support the content of a response. When grounding is enabled, the model returns citations for claims in the response. This object contains the retrieved sources. # Output only. Metadata returned when grounding is enabled. It contains the sources used to ground the generated content. @@ -4414,7 +4415,7 @@

Method Details

"contents": [ # Required. The content of the current conversation with the model. For single-turn queries, this is a single instance. For multi-turn queries, this is a repeated field that contains conversation history + latest request. { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -4689,7 +4690,7 @@

Method Details

], "systemInstruction": { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. # Optional. The user provided system instructions for the model. Note: only text should be used in parts and content in each part will be in a separate paragraph. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -5063,7 +5064,7 @@

Method Details

}, "content": { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. # Output only. The content of the candidate. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -5154,6 +5155,7 @@

Method Details

], "role": "A String", # Optional. The producer of the content. Must be either 'user' or 'model'. If not set, the service will default to 'user'. }, + "continuationToken": "A String", # Output only. An optional opaque continuation token returned when `finish_reason` is `CONTINUATION`. Clients can pass this token in a subsequent `GenerateContentRequest` to continue generation. "finishMessage": "A String", # Output only. Describes the reason the model stopped generating tokens in more detail. This field is returned only when `finish_reason` is set. "finishReason": "A String", # Output only. The reason why the model stopped generating tokens. If empty, the model has not stopped generating. "groundingMetadata": { # Information about the sources that support the content of a response. When grounding is enabled, the model returns citations for claims in the response. This object contains the retrieved sources. # Output only. Metadata returned when grounding is enabled. It contains the sources used to ground the generated content. diff --git a/docs/dyn/aiplatform_v1.projects.locations.evaluationItems.html b/docs/dyn/aiplatform_v1.projects.locations.evaluationItems.html index dd6d3e07f7..067a4d62ac 100644 --- a/docs/dyn/aiplatform_v1.projects.locations.evaluationItems.html +++ b/docs/dyn/aiplatform_v1.projects.locations.evaluationItems.html @@ -612,7 +612,7 @@

Method Details

"author": "A String", # Required. The ID of the agent or entity that generated this event. Use "user" to denote events generated by the end-user. "content": { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. # Required. The content of the event (e.g., text response, tool call, tool response). "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -1218,7 +1218,7 @@

Method Details

"author": "A String", # Required. The ID of the agent or entity that generated this event. Use "user" to denote events generated by the end-user. "content": { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. # Required. The content of the event (e.g., text response, tool call, tool response). "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -1823,7 +1823,7 @@

Method Details

"author": "A String", # Required. The ID of the agent or entity that generated this event. Use "user" to denote events generated by the end-user. "content": { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. # Required. The content of the event (e.g., text response, tool call, tool response). "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -1929,7 +1929,7 @@

Method Details

"values": { # The values for fields in the prompt template. "a_key": { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -2579,7 +2579,7 @@

Method Details

"author": "A String", # Required. The ID of the agent or entity that generated this event. Use "user" to denote events generated by the end-user. "content": { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. # Required. The content of the event (e.g., text response, tool call, tool response). "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -3185,7 +3185,7 @@

Method Details

"author": "A String", # Required. The ID of the agent or entity that generated this event. Use "user" to denote events generated by the end-user. "content": { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. # Required. The content of the event (e.g., text response, tool call, tool response). "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -3790,7 +3790,7 @@

Method Details

"author": "A String", # Required. The ID of the agent or entity that generated this event. Use "user" to denote events generated by the end-user. "content": { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. # Required. The content of the event (e.g., text response, tool call, tool response). "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -3896,7 +3896,7 @@

Method Details

"values": { # The values for fields in the prompt template. "a_key": { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -4537,7 +4537,7 @@

Method Details

"author": "A String", # Required. The ID of the agent or entity that generated this event. Use "user" to denote events generated by the end-user. "content": { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. # Required. The content of the event (e.g., text response, tool call, tool response). "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -5143,7 +5143,7 @@

Method Details

"author": "A String", # Required. The ID of the agent or entity that generated this event. Use "user" to denote events generated by the end-user. "content": { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. # Required. The content of the event (e.g., text response, tool call, tool response). "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -5748,7 +5748,7 @@

Method Details

"author": "A String", # Required. The ID of the agent or entity that generated this event. Use "user" to denote events generated by the end-user. "content": { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. # Required. The content of the event (e.g., text response, tool call, tool response). "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -5854,7 +5854,7 @@

Method Details

"values": { # The values for fields in the prompt template. "a_key": { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -6504,7 +6504,7 @@

Method Details

"author": "A String", # Required. The ID of the agent or entity that generated this event. Use "user" to denote events generated by the end-user. "content": { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. # Required. The content of the event (e.g., text response, tool call, tool response). "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -7110,7 +7110,7 @@

Method Details

"author": "A String", # Required. The ID of the agent or entity that generated this event. Use "user" to denote events generated by the end-user. "content": { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. # Required. The content of the event (e.g., text response, tool call, tool response). "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -7715,7 +7715,7 @@

Method Details

"author": "A String", # Required. The ID of the agent or entity that generated this event. Use "user" to denote events generated by the end-user. "content": { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. # Required. The content of the event (e.g., text response, tool call, tool response). "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -7821,7 +7821,7 @@

Method Details

"values": { # The values for fields in the prompt template. "a_key": { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -8504,7 +8504,7 @@

Method Details

"author": "A String", # Required. The ID of the agent or entity that generated this event. Use "user" to denote events generated by the end-user. "content": { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. # Required. The content of the event (e.g., text response, tool call, tool response). "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -9110,7 +9110,7 @@

Method Details

"author": "A String", # Required. The ID of the agent or entity that generated this event. Use "user" to denote events generated by the end-user. "content": { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. # Required. The content of the event (e.g., text response, tool call, tool response). "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -9715,7 +9715,7 @@

Method Details

"author": "A String", # Required. The ID of the agent or entity that generated this event. Use "user" to denote events generated by the end-user. "content": { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. # Required. The content of the event (e.g., text response, tool call, tool response). "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -9821,7 +9821,7 @@

Method Details

"values": { # The values for fields in the prompt template. "a_key": { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -10471,7 +10471,7 @@

Method Details

"author": "A String", # Required. The ID of the agent or entity that generated this event. Use "user" to denote events generated by the end-user. "content": { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. # Required. The content of the event (e.g., text response, tool call, tool response). "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -11077,7 +11077,7 @@

Method Details

"author": "A String", # Required. The ID of the agent or entity that generated this event. Use "user" to denote events generated by the end-user. "content": { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. # Required. The content of the event (e.g., text response, tool call, tool response). "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -11682,7 +11682,7 @@

Method Details

"author": "A String", # Required. The ID of the agent or entity that generated this event. Use "user" to denote events generated by the end-user. "content": { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. # Required. The content of the event (e.g., text response, tool call, tool response). "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -11788,7 +11788,7 @@

Method Details

"values": { # The values for fields in the prompt template. "a_key": { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -12442,7 +12442,7 @@

Method Details

"author": "A String", # Required. The ID of the agent or entity that generated this event. Use "user" to denote events generated by the end-user. "content": { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. # Required. The content of the event (e.g., text response, tool call, tool response). "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -13048,7 +13048,7 @@

Method Details

"author": "A String", # Required. The ID of the agent or entity that generated this event. Use "user" to denote events generated by the end-user. "content": { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. # Required. The content of the event (e.g., text response, tool call, tool response). "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -13653,7 +13653,7 @@

Method Details

"author": "A String", # Required. The ID of the agent or entity that generated this event. Use "user" to denote events generated by the end-user. "content": { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. # Required. The content of the event (e.g., text response, tool call, tool response). "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -13759,7 +13759,7 @@

Method Details

"values": { # The values for fields in the prompt template. "a_key": { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -14409,7 +14409,7 @@

Method Details

"author": "A String", # Required. The ID of the agent or entity that generated this event. Use "user" to denote events generated by the end-user. "content": { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. # Required. The content of the event (e.g., text response, tool call, tool response). "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -15015,7 +15015,7 @@

Method Details

"author": "A String", # Required. The ID of the agent or entity that generated this event. Use "user" to denote events generated by the end-user. "content": { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. # Required. The content of the event (e.g., text response, tool call, tool response). "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -15620,7 +15620,7 @@

Method Details

"author": "A String", # Required. The ID of the agent or entity that generated this event. Use "user" to denote events generated by the end-user. "content": { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. # Required. The content of the event (e.g., text response, tool call, tool response). "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -15726,7 +15726,7 @@

Method Details

"values": { # The values for fields in the prompt template. "a_key": { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. diff --git a/docs/dyn/aiplatform_v1.projects.locations.html b/docs/dyn/aiplatform_v1.projects.locations.html index 4816b92152..496286414c 100644 --- a/docs/dyn/aiplatform_v1.projects.locations.html +++ b/docs/dyn/aiplatform_v1.projects.locations.html @@ -164,6 +164,16 @@

Instance Methods

Returns the indexes Resource.

+

+ interactions() +

+

Returns the interactions Resource.

+ +

+ interactionsHttp() +

+

Returns the interactionsHttp Resource.

+

memoryBanks()

@@ -971,7 +981,7 @@

Method Details

"contents": [ # Optional. Input content to augment, only text format is supported for now. { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -1109,7 +1119,7 @@

Method Details

"augmentedPrompt": [ # Augmented prompt, only text format is supported for now. { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -1240,7 +1250,7 @@

Method Details

{ # Request message for CorroborateContent. "content": { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. # Optional. Input content to corroborate, only text format is supported for now. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -1457,7 +1467,7 @@

Method Details

"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). + "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). At most 200 environment variables can be specified. Each variable (`NAME=value`) must be smaller than 128 KiB, and the total size of all variables must not exceed 512 KiB. { # 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. @@ -2531,7 +2541,7 @@

Method Details

"contents": [ # Optional. Repeated contents. { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -2878,7 +2888,7 @@

Method Details

"contents": [ # Optional. Repeated contents. { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -3221,7 +3231,7 @@

Method Details

"contents": [ # Optional. Repeated contents. { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -3320,7 +3330,7 @@

Method Details

"event": [ # Optional. A list of events. { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -3893,7 +3903,598 @@

Method Details

"author": "A String", # Required. The ID of the agent or entity that generated this event. "content": { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. # Required. The content of the event (e.g., text response, tool call, tool response). "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. + "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. + "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. + "text": "A String", # Required. The transcription text of this audio segment. + "words": [ # Optional. Detailed word-level transcriptions and timing details. Present when `word_timestamp` is set. + { # Information about a single recognized word. + "endOffset": "A String", # Optional. End offset in time of the word relative to the start of the audio. + "startOffset": "A String", # Optional. Start offset in time of the word relative to the start of the audio. + "word": "A String", # Required. Transcript of the word. + }, + ], + }, + "codeExecutionResult": { # Result of executing the ExecutableCode. Generated only when the `CodeExecution` tool is used. # Optional. The result of executing the ExecutableCode. + "id": "A String", # Optional. The identifier of the `ExecutableCode` part this result is for. Only populated if the corresponding `ExecutableCode` has an id. + "outcome": "A String", # Required. Outcome of the code execution. + "output": "A String", # Optional. Contains stdout when code execution is successful, stderr or other description otherwise. + }, + "executableCode": { # Code generated by the model that is meant to be executed, and the result returned to the model. Generated when using the `CodeExecution` tool, in which the code will be automatically executed, and a corresponding CodeExecutionResult will also be generated. # Optional. Code generated by the model that is intended to be executed. + "code": "A String", # Required. The code to be executed. + "id": "A String", # Optional. Unique identifier of the `ExecutableCode` part. The server returns the `CodeExecutionResult` with the matching `id`. + "language": "A String", # Required. Programming language of the `code`. + }, + "fileData": { # URI-based data. A FileData message contains a URI pointing to data of a specific media type. It is used to represent images, audio, and video stored in Google Cloud Storage. # Optional. The URI-based data of the part. This can be used to include files from Google Cloud Storage. + "displayName": "A String", # Optional. The display name of the file. Used to provide a label or filename to distinguish files. This field is only returned in `PromptMessage` for prompt management. It is used in the Gemini calls only when server side tools (`code_execution`, `google_search`, and `url_context`) are enabled. + "fileUri": "A String", # Required. The URI of the file in Google Cloud Storage. + "mimeType": "A String", # Required. The IANA standard MIME type of the source data. + }, + "functionCall": { # A predicted FunctionCall returned from the model that contains a string representing the FunctionDeclaration.name and a structured JSON object containing the parameters and their values. # Optional. A predicted function call returned from the model. This contains the name of the function to call and the arguments to pass to the function. + "args": { # Optional. The function parameters and values in JSON object format. See FunctionDeclaration.parameters for parameter details. + "a_key": "", # Properties of the object. + }, + "id": "A String", # Optional. The unique id of the function call. If populated, the client to execute the `function_call` and return the response with the matching `id`. + "name": "A String", # Optional. The name of the function to call. Matches FunctionDeclaration.name. + "partialArgs": [ # Optional. The partial argument value of the function call. If provided, represents the arguments/fields that are streamed incrementally. + { # Partial argument value of the function call. + "boolValue": True or False, # Optional. Represents a boolean value. + "jsonPath": "A String", # Required. A JSON Path (RFC 9535) to the argument being streamed. https://datatracker.ietf.org/doc/html/rfc9535. e.g. "$.foo.bar[0].data". + "nullValue": "A String", # Optional. Represents a null value. + "numberValue": 3.14, # Optional. Represents a double value. + "stringValue": "A String", # Optional. Represents a string value. + "willContinue": True or False, # Optional. Whether this is not the last part of the same json_path. If true, another PartialArg message for the current json_path is expected to follow. + }, + ], + "willContinue": True or False, # Optional. Whether this is the last part of the FunctionCall. If true, another partial message for the current FunctionCall is expected to follow. + }, + "functionResponse": { # The result output from a FunctionCall that contains a string representing the FunctionDeclaration.name and a structured JSON object containing any output from the function is used as context to the model. This should contain the result of a `FunctionCall` made based on model prediction. # Optional. The result of a function call. This is used to provide the model with the result of a function call that it predicted. + "id": "A String", # Optional. The id of the function call this response is for. Populated by the client to match the corresponding function call `id`. + "name": "A String", # Required. The name of the function to call. Matches FunctionDeclaration.name and FunctionCall.name. + "parts": [ # Optional. Ordered `Parts` that constitute a function response. Parts may have different IANA MIME types. + { # A datatype containing media that is part of a `FunctionResponse` message. A `FunctionResponsePart` consists of data which has an associated datatype. A `FunctionResponsePart` can only contain one of the accepted types in `FunctionResponsePart.data`. A `FunctionResponsePart` must have a fixed IANA MIME type identifying the type and subtype of the media if the `inline_data` field is filled with raw bytes. + "fileData": { # URI based data for function response. # URI based data. + "displayName": "A String", # Optional. Display name of the file data. Used to provide a label or filename to distinguish file datas. This field is only returned in PromptMessage for prompt management. It is currently used in the Gemini GenerateContent calls only when server side tools (code_execution, google_search, and url_context) are enabled. + "fileUri": "A String", # Required. URI. + "mimeType": "A String", # Required. The IANA standard MIME type of the source data. + }, + "inlineData": { # Raw media bytes for function response. Text should not be sent as raw bytes, use the 'text' field. # Inline media bytes. + "data": "A String", # Required. Raw bytes. + "displayName": "A String", # Optional. Display name of the blob. Used to provide a label or filename to distinguish blobs. This field is only returned in PromptMessage for prompt management. It is currently used in the Gemini GenerateContent calls only when server side tools (code_execution, google_search, and url_context) are enabled. + "mimeType": "A String", # Required. The IANA standard MIME type of the source data. + }, + }, + ], + "response": { # Required. The function response in JSON object format. Use "output" key to specify function output and "error" key to specify error details (if any). If "output" and "error" keys are not specified, then whole "response" is treated as function output. + "a_key": "", # Properties of the object. + }, + "scheduling": "A String", # Optional. Specifies how the response should be scheduled in the conversation. Only applicable to NON_BLOCKING function calls, is ignored otherwise. Defaults to WHEN_IDLE. + }, + "inlineData": { # A content blob. A Blob contains data of a specific media type. It is used to represent images, audio, and video. # Optional. The inline data content of the part. This can be used to include images, audio, or video in a request. + "data": "A String", # Required. The raw bytes of the data. + "displayName": "A String", # Optional. The display name of the blob. Used to provide a label or filename to distinguish blobs. This field is only returned in `PromptMessage` for prompt management. It is used in the Gemini calls only when server-side tools (`code_execution`, `google_search`, and `url_context`) are enabled. + "mimeType": "A String", # Required. The IANA standard MIME type of the source data. + }, + "mediaResolution": { # per part media resolution. Media resolution for the input media. # per part media resolution. Media resolution for the input media. + "level": "A String", # The tokenization quality used for given media. + }, + "speechMetadata": { # Structured Metadata Sub-Message for Part # Optional. Turn-level metadata for speech generation (e.g. Daikon speaker/style). May be set alongside `text` to attach speaker and style information to a text part. + "speaker": "A String", # Optional. Identifies which speaker is speaking this turn. + "style": "A String", # Optional. Natural language description of the vocal style (e.g., "cheerful"). + }, + "text": "A String", # Optional. The text content of the part. When sent from the VSCode Gemini Code Assist extension, references to @mentioned items will be converted to markdown boldface text. For example `@my-repo` will be converted to and sent as `**my-repo**` by the IDE agent. + "thought": True or False, # Optional. Indicates whether the `part` represents the model's thought process or reasoning. + "thoughtSignature": "A String", # Optional. An opaque signature for the thought so it can be reused in subsequent requests. + "videoMetadata": { # Provides metadata for a video, including the start and end offsets for clipping and the frame rate. # Optional. Video metadata. The metadata should only be specified while the video data is presented in inline_data or file_data. + "endOffset": "A String", # Optional. The end offset of the video. + "fps": 3.14, # Optional. The frame rate of the video sent to the model. If not specified, the default value is 1.0. The valid range is (0.0, 24.0]. + "startOffset": "A String", # Optional. The start offset of the video. + }, + }, + ], + "role": "A String", # Optional. The producer of the content. Must be either 'user' or 'model'. If not set, the service will default to 'user'. + }, + "eventTime": "A String", # Optional. The timestamp when the event occurred. + "stateDelta": { # Optional. The change in the session state caused by this event. This is a key-value map of fields that were modified or added by the event. + "a_key": "", # Properties of the object. + }, + }, + ], + "turnId": "A String", # Optional. A unique identifier for the turn. Useful for referencing specific turns across systems. + "turnIndex": 42, # Required. The 0-based index of the turn in the conversation sequence. + }, + ], + }, + "agentEvalData": { # Represents data specific to multi-turn agent evaluations. # Optional. Data used for agent evaluation. + "agents": { # Optional. A map containing the static configurations for each agent in the system. Key: agent_id (matches the `author` field in events). Value: The static configuration of the agent. + "a_key": { # Represents configuration for an Agent. + "agentId": "A String", # Required. Unique identifier of the agent. This ID is used to refer to this agent, e.g., in AgentEvent.author, or in the `sub_agents` field. It must be unique within the `agents` map. + "agentType": "A String", # Optional. The type or class of the agent (e.g., "LlmAgent", "RouterAgent", "ToolUseAgent"). Useful for the autorater to understand the expected behavior of the agent. + "description": "A String", # Optional. A high-level description of the agent's role and responsibilities. Critical for evaluating if the agent is routing tasks correctly. + "instruction": "A String", # Optional. Provides instructions for the LLM model, guiding the agent's behavior. Can be static or dynamic. Dynamic instructions can contain placeholders like {variable_name} that will be resolved at runtime using the `AgentEvent.state_delta` field. + "subAgents": [ # Optional. The list of valid agent IDs that this agent can delegate to. This defines the directed edges in the multi-agent system graph topology. + "A String", + ], + "tools": [ # Optional. The list of tools available to this agent. + { # Tool details that the model may use to generate response. A `Tool` is a piece of code that enables the system to interact with external systems to perform an action, or set of actions, outside of knowledge and scope of the model. A Tool object should contain exactly one type of Tool (e.g FunctionDeclaration, Retrieval or GoogleSearchRetrieval). + "codeExecution": { # Tool that executes code generated by the model, and automatically returns the result to the model. See also ExecutableCode and CodeExecutionResult, which are input and output to this tool. # Optional. CodeExecution tool type. Enables the model to execute code as part of generation. + }, + "computerUse": { # A tool that enables the model to interact directly with a computer environment. # Optional. Tool to support the model interacting directly with the computer. If enabled, it automatically populates computer-use specific Function Declarations. + "disabledSafetyPolicies": [ # Optional. A list of safety policies to disable for the computer use tool. + "A String", + ], + "enablePromptInjectionDetection": True or False, # Optional. Whether to enable the prompt injection detection check on the computer use request. + "environment": "A String", # Required. The target environment where the computer use tool operates. + "excludedPredefinedFunctions": [ # Optional. A list of predefined functions to explicitly exclude from the model call. By default, [predefined functions](https://cloud.google.com/vertex-ai/generative-ai/docs/computer-use#supported-actions) are included. Excluding functions allows for a more restricted action space or custom definitions for predefined functions. + "A String", + ], + }, + "enterpriseWebSearch": { # Tool to search public web data, powered by Vertex AI Search and Sec4 compliance. # Optional. Tool to support searching public web data, powered by Vertex AI Search and Sec4 compliance. + "blockingConfidence": "A String", # Optional. Sites with confidence level chosen & above this value will be blocked from the search results. + "excludeDomains": [ # Optional. List of domains to be excluded from the search results. The default limit is 2000 domains. + "A String", + ], + }, + "exaAiSearch": { # ExaAiSearch tool type. A tool that uses the Exa.ai search engine for grounding. # Optional. Uses Exa.ai to search for information to answer user queries. The search results will be grounded on Exa.ai and presented to the model for response generation + "apiKey": "A String", # Required. The API key for ExaAiSearch. + "customConfigs": { # Optional. This field can be used to pass any parameter from the Exa.ai Search API. + "a_key": "", # Properties of the object. + }, + }, + "functionDeclarations": [ # Optional. Function tool type. One or more function declarations to be passed to the model along with the current user query. Model may decide to call a subset of these functions by populating FunctionCall in the response. User should provide a FunctionResponse for each function call in the next turn. Based on the function responses, Model will generate the final response back to the user. Maximum 512 function declarations can be provided. + { # Structured representation of a function declaration as defined by the [OpenAPI 3.0 specification](https://spec.openapis.org/oas/v3.0.3). Included in this declaration are the function name, description, parameters and response type. This FunctionDeclaration is a representation of a block of code that can be used as a `Tool` by the model and executed by the client. + "behavior": "A String", # Optional. Specifies the function Behavior. If not specified, the system keeps the current function call behavior. This field is currently only supported by the BidiGenerateContent method. + "description": "A String", # Optional. Description and purpose of the function. Model uses it to decide how and whether to call the function. + "name": "A String", # Required. The name of the function to call. Must start with a letter or an underscore. Must be a-z, A-Z, 0-9, or contain underscores, dots, colons and dashes, with a maximum length of 128. + "parameters": { # Defines the schema of input and output data. This is a subset of the [OpenAPI 3.0 Schema Object](https://spec.openapis.org/oas/v3.0.3#schema-object). # Optional. Describes the parameters to this function in JSON Schema Object format. Reflects the Open API 3.03 Parameter Object. string Key: the name of the parameter. Parameter names are case sensitive. Schema Value: the Schema defining the type used for the parameter. For function with no parameters, this can be left unset. Parameter names must start with a letter or an underscore and must only contain chars a-z, A-Z, 0-9, or underscores with a maximum length of 64. Example with 1 required and 1 optional parameter: type: OBJECT properties: param1: type: STRING param2: type: INTEGER required: - param1 + "additionalProperties": "", # Optional. If `type` is `OBJECT`, specifies how to handle properties not defined in `properties`. If it is a boolean `false`, no additional properties are allowed. If it is a schema, additional properties are allowed if they conform to the schema. + "anyOf": [ # Optional. The instance must be valid against any (one or more) of the subschemas listed in `any_of`. + # Object with schema name: GoogleCloudAiplatformV1Schema + ], + "default": "", # Optional. Default value to use if the field is not specified. + "defs": { # Optional. `defs` provides a map of schema definitions that can be reused by `ref` elsewhere in the schema. Only allowed at root level of the schema. + "a_key": # Object with schema name: GoogleCloudAiplatformV1Schema + }, + "description": "A String", # Optional. Describes the data. The model uses this field to understand the purpose of the schema and how to use it. It is a best practice to provide a clear and descriptive explanation for the schema and its properties here, rather than in the prompt. + "enum": [ # Optional. Possible values of the field. This field can be used to restrict a value to a fixed set of values. To mark a field as an enum, set `format` to `enum` and provide the list of possible values in `enum`. For example: 1. To define directions: `{type:STRING, format:enum, enum:["EAST", "NORTH", "SOUTH", "WEST"]}` 2. To define apartment numbers: `{type:INTEGER, format:enum, enum:["101", "201", "301"]}` + "A String", + ], + "example": "", # Optional. Example of an instance of this schema. + "format": "A String", # Optional. The format of the data. For `NUMBER` type, format can be `float` or `double`. For `INTEGER` type, format can be `int32` or `int64`. For `STRING` type, format can be `email`, `byte`, `date`, `date-time`, `password`, and other formats to further refine the data type. + "items": # Object with schema name: GoogleCloudAiplatformV1Schema # Optional. If type is `ARRAY`, `items` specifies the schema of elements in the array. + "maxItems": "A String", # Optional. If type is `ARRAY`, `max_items` specifies the maximum number of items in an array. + "maxLength": "A String", # Optional. If type is `STRING`, `max_length` specifies the maximum length of the string. + "maxProperties": "A String", # Optional. If type is `OBJECT`, `max_properties` specifies the maximum number of properties that can be provided. + "maximum": 3.14, # Optional. If type is `INTEGER` or `NUMBER`, `maximum` specifies the maximum allowed value. + "minItems": "A String", # Optional. If type is `ARRAY`, `min_items` specifies the minimum number of items in an array. + "minLength": "A String", # Optional. If type is `STRING`, `min_length` specifies the minimum length of the string. + "minProperties": "A String", # Optional. If type is `OBJECT`, `min_properties` specifies the minimum number of properties that can be provided. + "minimum": 3.14, # Optional. If type is `INTEGER` or `NUMBER`, `minimum` specifies the minimum allowed value. + "nullable": True or False, # Optional. Indicates if the value of this field can be null. + "pattern": "A String", # Optional. If type is `STRING`, `pattern` specifies a regular expression that the string must match. + "properties": { # Optional. If type is `OBJECT`, `properties` is a map of property names to schema definitions for each property of the object. + "a_key": # Object with schema name: GoogleCloudAiplatformV1Schema + }, + "propertyOrdering": [ # Optional. Order of properties displayed or used where order matters. This is not a standard field in OpenAPI specification, but can be used to control the order of properties. + "A String", + ], + "ref": "A String", # Optional. Allows referencing another schema definition to use in place of this schema. The value must be a valid reference to a schema in `defs`. For example, the following schema defines a reference to a schema node named "Pet": type: object properties: pet: ref: #/defs/Pet defs: Pet: type: object properties: name: type: string The value of the "pet" property is a reference to the schema node named "Pet". See details in https://json-schema.org/understanding-json-schema/structuring + "required": [ # Optional. If type is `OBJECT`, `required` lists the names of properties that must be present. + "A String", + ], + "title": "A String", # Optional. Title for the schema. + "type": "A String", # Optional. Data type of the schema field. + }, + "parametersJsonSchema": "", # Optional. Describes the parameters to the function in JSON Schema format. The schema must describe an object where the properties are the parameters to the function. For example: ``` { "type": "object", "properties": { "name": { "type": "string" }, "age": { "type": "integer" } }, "additionalProperties": false, "required": ["name", "age"], "propertyOrdering": ["name", "age"] } ``` This field is mutually exclusive with `parameters`. + "response": { # Defines the schema of input and output data. This is a subset of the [OpenAPI 3.0 Schema Object](https://spec.openapis.org/oas/v3.0.3#schema-object). # Optional. Describes the output from this function in JSON Schema format. Reflects the Open API 3.03 Response Object. The Schema defines the type used for the response value of the function. + "additionalProperties": "", # Optional. If `type` is `OBJECT`, specifies how to handle properties not defined in `properties`. If it is a boolean `false`, no additional properties are allowed. If it is a schema, additional properties are allowed if they conform to the schema. + "anyOf": [ # Optional. The instance must be valid against any (one or more) of the subschemas listed in `any_of`. + # Object with schema name: GoogleCloudAiplatformV1Schema + ], + "default": "", # Optional. Default value to use if the field is not specified. + "defs": { # Optional. `defs` provides a map of schema definitions that can be reused by `ref` elsewhere in the schema. Only allowed at root level of the schema. + "a_key": # Object with schema name: GoogleCloudAiplatformV1Schema + }, + "description": "A String", # Optional. Describes the data. The model uses this field to understand the purpose of the schema and how to use it. It is a best practice to provide a clear and descriptive explanation for the schema and its properties here, rather than in the prompt. + "enum": [ # Optional. Possible values of the field. This field can be used to restrict a value to a fixed set of values. To mark a field as an enum, set `format` to `enum` and provide the list of possible values in `enum`. For example: 1. To define directions: `{type:STRING, format:enum, enum:["EAST", "NORTH", "SOUTH", "WEST"]}` 2. To define apartment numbers: `{type:INTEGER, format:enum, enum:["101", "201", "301"]}` + "A String", + ], + "example": "", # Optional. Example of an instance of this schema. + "format": "A String", # Optional. The format of the data. For `NUMBER` type, format can be `float` or `double`. For `INTEGER` type, format can be `int32` or `int64`. For `STRING` type, format can be `email`, `byte`, `date`, `date-time`, `password`, and other formats to further refine the data type. + "items": # Object with schema name: GoogleCloudAiplatformV1Schema # Optional. If type is `ARRAY`, `items` specifies the schema of elements in the array. + "maxItems": "A String", # Optional. If type is `ARRAY`, `max_items` specifies the maximum number of items in an array. + "maxLength": "A String", # Optional. If type is `STRING`, `max_length` specifies the maximum length of the string. + "maxProperties": "A String", # Optional. If type is `OBJECT`, `max_properties` specifies the maximum number of properties that can be provided. + "maximum": 3.14, # Optional. If type is `INTEGER` or `NUMBER`, `maximum` specifies the maximum allowed value. + "minItems": "A String", # Optional. If type is `ARRAY`, `min_items` specifies the minimum number of items in an array. + "minLength": "A String", # Optional. If type is `STRING`, `min_length` specifies the minimum length of the string. + "minProperties": "A String", # Optional. If type is `OBJECT`, `min_properties` specifies the minimum number of properties that can be provided. + "minimum": 3.14, # Optional. If type is `INTEGER` or `NUMBER`, `minimum` specifies the minimum allowed value. + "nullable": True or False, # Optional. Indicates if the value of this field can be null. + "pattern": "A String", # Optional. If type is `STRING`, `pattern` specifies a regular expression that the string must match. + "properties": { # Optional. If type is `OBJECT`, `properties` is a map of property names to schema definitions for each property of the object. + "a_key": # Object with schema name: GoogleCloudAiplatformV1Schema + }, + "propertyOrdering": [ # Optional. Order of properties displayed or used where order matters. This is not a standard field in OpenAPI specification, but can be used to control the order of properties. + "A String", + ], + "ref": "A String", # Optional. Allows referencing another schema definition to use in place of this schema. The value must be a valid reference to a schema in `defs`. For example, the following schema defines a reference to a schema node named "Pet": type: object properties: pet: ref: #/defs/Pet defs: Pet: type: object properties: name: type: string The value of the "pet" property is a reference to the schema node named "Pet". See details in https://json-schema.org/understanding-json-schema/structuring + "required": [ # Optional. If type is `OBJECT`, `required` lists the names of properties that must be present. + "A String", + ], + "title": "A String", # Optional. Title for the schema. + "type": "A String", # Optional. Data type of the schema field. + }, + "responseJsonSchema": "", # Optional. Describes the output from this function in JSON Schema format. The value specified by the schema is the response value of the function. This field is mutually exclusive with `response`. + }, + ], + "googleMaps": { # Tool to retrieve public maps data for grounding, powered by Google. # Optional. GoogleMaps tool type. Tool to support Google Maps in Model. + "enableWidget": True or False, # Optional. Deprecated: The Google Maps contextual widget behavior in Grounding with Google Maps is being deprecated; this field is planned for removal and no longer has any effect once removed. If true, include the widget context token in the response. + "groundingTypes": { # Defines the types of Google Maps grounding that can be enabled and their configurations. # Optional. Specifies the types of Google Maps grounding to enable. Defaults to `places` when unset. + "places": { # Grounding with Google Maps Places data (e.g. QueryPlaces). This is the default Google Maps grounding type when no other type is specified. # Optional. Enables grounding with Google Maps Places. This is the default grounding type when no `GroundingTypes` are specified. + }, + "routing": { # Grounding with Google Maps Routing APIs (ComputeRoutes and SearchAlongRoute). # Optional. Enables grounding with Google Maps Routing APIs (ComputeRoutes and SearchAlongRoute). + }, + }, + }, + "googleSearch": { # GoogleSearch tool type. Tool to support Google Search in Model. Powered by Google. # Optional. GoogleSearch tool type. Tool to support Google Search in Model. Powered by Google. + "blockingConfidence": "A String", # Optional. Sites with confidence level chosen & above this value will be blocked from the search results. + "excludeDomains": [ # Optional. List of domains to be excluded from the search results. The default limit is 2000 domains. Example: ["amazon.com", "facebook.com"]. + "A String", + ], + "searchTypes": { # Different types of search that can be enabled on the GoogleSearch tool. # Optional. The set of search types to enable. If not set, web search is enabled by default. + "imageSearch": { # Image search for grounding and related configurations. # Optional. Setting this field enables image search. Image bytes are returned. + }, + "webSearch": { # Standard web search for grounding and related configurations. Only text results are returned. # Optional. Setting this field enables web search. Only text results are returned. + }, + }, + }, + "googleSearchRetrieval": { # Tool to retrieve public web data for grounding, powered by Google. # Optional. Specialized retrieval tool that is powered by Google Search. + "dynamicRetrievalConfig": { # Describes the options to customize dynamic retrieval. # Specifies the dynamic retrieval configuration for the given source. + "dynamicThreshold": 3.14, # Optional. The threshold to be used in dynamic retrieval. If not set, a system default value is used. + "mode": "A String", # The mode of the predictor to be used in dynamic retrieval. + }, + }, + "parallelAiSearch": { # ParallelAiSearch tool type. A tool that uses the Parallel.ai search engine for grounding. # Optional. If specified, Vertex AI will use Parallel.ai to search for information to answer user queries. The search results will be grounded on Parallel.ai and presented to the model for response generation + "apiKey": "A String", # Optional. The API key for ParallelAiSearch. If an API key is not provided, the system will attempt to verify access by checking for an active Parallel.ai subscription through the Google Cloud Marketplace. See https://docs.parallel.ai/search/search-quickstart for more details. + "customConfigs": { # Optional. Custom configs for ParallelAiSearch. This field can be used to pass any parameter from the Parallel.ai Search API. See the Parallel.ai documentation for the full list of available parameters and their usage: https://docs.parallel.ai/api-reference/search-beta/search Currently only `source_policy`, `excerpts`, `max_results`, `mode`, `fetch_policy` can be set via this field. For example: { "source_policy": { "include_domains": ["google.com", "wikipedia.org"], "exclude_domains": ["example.com"] }, "fetch_policy": { "max_age_seconds": 3600 } } + "a_key": "", # Properties of the object. + }, + "enableDataRetention": True or False, # Optional. Deprecated: Use `enable_zero_data_retention` instead. Instructs Vertex Grounding to use Parallel's Zero Data Retention Marketplace product. If this value is "false" or omitted, the Parallel Web Search for Grounding standard subscription will be used. If this value is "true", the Parallel Web Search for Grounding - ZDR subscription will be used. + "enableZeroDataRetention": True or False, # Optional. Instructs Vertex Grounding to use Parallel's Zero Data Retention Marketplace product. If this value is "false" or omitted, the Parallel Web Search for Grounding standard subscription will be used. If this value is "true", the Parallel Web Search for Grounding - ZDR subscription will be used. + }, + "retrieval": { # Defines a retrieval tool that model can call to access external knowledge. # Optional. Retrieval tool type. System will always execute the provided retrieval tool(s) to get external knowledge to answer the prompt. Retrieval results are presented to the model for generation. + "disableAttribution": True or False, # Optional. Deprecated. This option is no longer supported. + "externalApi": { # Retrieve from data source powered by external API for grounding. The external API is not owned by Google, but need to follow the pre-defined API spec. # Use data source powered by external API for grounding. + "apiAuth": { # The generic reusable api auth config. Deprecated. Please use AuthConfig (google/cloud/aiplatform/master/auth.proto) instead. # The authentication config to access the API. Deprecated. Please use auth_config instead. + "apiKeyConfig": { # The API secret. # The API secret. + "apiKeySecretVersion": "A String", # Required. The SecretManager secret version resource name storing API key. e.g. projects/{project}/secrets/{secret}/versions/{version} + "apiKeyString": "A String", # The API key string. Either this or `api_key_secret_version` must be set. + }, + }, + "apiSpec": "A String", # The API spec that the external API implements. + "authConfig": { # Auth configuration to run the extension. # The authentication config to access the API. + "apiKeyConfig": { # Config for authentication with API key. # Config for API key auth. + "apiKeySecret": "A String", # Optional. The name of the SecretManager secret version resource storing the API key. Format: `projects/{project}/secrets/{secrete}/versions/{version}` - If both `api_key_secret` and `api_key_string` are specified, this field takes precedence over `api_key_string`. - If specified, the `secretmanager.versions.access` permission should be granted to Vertex AI Extension Service Agent (https://cloud.google.com/vertex-ai/docs/general/access-control#service-agents) on the specified resource. + "apiKeyString": "A String", # Optional. The API key to be used in the request directly. + "httpElementLocation": "A String", # Optional. The location of the API key. + "name": "A String", # Optional. The parameter name of the API key. E.g. If the API request is "https://example.com/act?api_key=", "api_key" would be the parameter name. + }, + "authType": "A String", # Type of auth scheme. + "googleServiceAccountConfig": { # Config for Google Service Account Authentication. # Config for Google Service Account auth. + "serviceAccount": "A String", # Optional. The service account that the extension execution service runs as. - If the service account is specified, the `iam.serviceAccounts.getAccessToken` permission should be granted to Vertex AI Extension Service Agent (https://cloud.google.com/vertex-ai/docs/general/access-control#service-agents) on the specified service account. - If not specified, the Vertex AI Extension Service Agent will be used to execute the Extension. + }, + "httpBasicAuthConfig": { # Config for HTTP Basic Authentication. # Config for HTTP Basic auth. + "credentialSecret": "A String", # Required. The name of the SecretManager secret version resource storing the base64 encoded credentials. Format: `projects/{project}/secrets/{secrete}/versions/{version}` - If specified, the `secretmanager.versions.access` permission should be granted to Vertex AI Extension Service Agent (https://cloud.google.com/vertex-ai/docs/general/access-control#service-agents) on the specified resource. + }, + "oauthConfig": { # Config for user oauth. # Config for user oauth. + "accessToken": "A String", # Access token for extension endpoint. Only used to propagate token from [[ExecuteExtensionRequest.runtime_auth_config]] at request time. + "serviceAccount": "A String", # The service account used to generate access tokens for executing the Extension. - If the service account is specified, the `iam.serviceAccounts.getAccessToken` permission should be granted to Vertex AI Extension Service Agent (https://cloud.google.com/vertex-ai/docs/general/access-control#service-agents) on the provided service account. + }, + "oidcConfig": { # Config for user OIDC auth. # Config for user OIDC auth. + "idToken": "A String", # OpenID Connect formatted ID token for extension endpoint. Only used to propagate token from [[ExecuteExtensionRequest.runtime_auth_config]] at request time. + "serviceAccount": "A String", # The service account used to generate an OpenID Connect (OIDC)-compatible JWT token signed by the Google OIDC Provider (accounts.google.com) for extension endpoint (https://cloud.google.com/iam/docs/create-short-lived-credentials-direct#sa-credentials-oidc). - The audience for the token will be set to the URL in the server url defined in the OpenApi spec. - If the service account is provided, the service account should grant `iam.serviceAccounts.getOpenIdToken` permission to Vertex AI Extension Service Agent (https://cloud.google.com/vertex-ai/docs/general/access-control#service-agents). + }, + }, + "elasticSearchParams": { # The search parameters to use for the ELASTIC_SEARCH spec. # Parameters for the elastic search API. + "index": "A String", # The ElasticSearch index to use. + "numHits": 42, # Optional. Number of hits (chunks) to request. When specified, it is passed to Elasticsearch as the `num_hits` param. + "searchTemplate": "A String", # The ElasticSearch search template to use. + }, + "endpoint": "A String", # The endpoint of the external API. The system will call the API at this endpoint to retrieve the data for grounding. Example: https://acme.com:443/search + "simpleSearchParams": { # The search parameters to use for SIMPLE_SEARCH spec. # Parameters for the simple search API. + }, + }, + "vertexAiSearch": { # Retrieve from Vertex AI Search datastore or engine for grounding. datastore and engine are mutually exclusive. See https://cloud.google.com/products/agent-builder # Set to use data source powered by Vertex AI Search. + "dataStoreSpecs": [ # Specifications that define the specific DataStores to be searched, along with configurations for those data stores. This is only considered for Engines with multiple data stores. It should only be set if engine is used. + { # Define data stores within engine to filter on in a search call and configurations for those data stores. For more information, see https://cloud.google.com/generative-ai-app-builder/docs/reference/rpc/google.cloud.discoveryengine.v1#datastorespec + "dataStore": "A String", # Full resource name of DataStore, such as Format: `projects/{project}/locations/{location}/collections/{collection}/dataStores/{dataStore}` + "filter": "A String", # Optional. Filter specification to filter documents in the data store specified by data_store field. For more information on filtering, see [Filtering](https://cloud.google.com/generative-ai-app-builder/docs/filter-search-metadata) + }, + ], + "datastore": "A String", # Optional. Fully-qualified Vertex AI Search data store resource ID. Format: `projects/{project}/locations/{location}/collections/{collection}/dataStores/{dataStore}` + "engine": "A String", # Optional. Fully-qualified Vertex AI Search engine resource ID. Format: `projects/{project}/locations/{location}/collections/{collection}/engines/{engine}` + "filter": "A String", # Optional. Filter strings to be passed to the search API. + "maxResults": 42, # Optional. Number of search results to return per query. The default value is 10. The maximumm allowed value is 10. + }, + "vertexRagStore": { # Retrieve from Vertex RAG Store for grounding. # Set to use data source powered by Vertex RAG store. User data is uploaded via the VertexRagDataService. + "ragResources": [ # Optional. The representation of the rag source. It can be used to specify corpus only or ragfiles. Currently only support one corpus or multiple files from one corpus. In the future we may open up multiple corpora support. + { # The definition of the Rag resource. + "ragCorpus": "A String", # Optional. RagCorpora resource name. Format: `projects/{project}/locations/{location}/ragCorpora/{rag_corpus}` + "ragFileIds": [ # Optional. rag_file_id. The files should be in the same rag_corpus set in rag_corpus field. + "A String", + ], + }, + ], + "ragRetrievalConfig": { # Specifies the context retrieval config. # Optional. The retrieval config for the Rag query. + "filter": { # Config for filters. # Optional. Config for filters. + "metadataFilter": "A String", # Optional. String for metadata filtering. + "vectorDistanceThreshold": 3.14, # Optional. Only returns contexts with vector distance smaller than the threshold. + "vectorSimilarityThreshold": 3.14, # Optional. Only returns contexts with vector similarity larger than the threshold. + }, + "ranking": { # Config for ranking and reranking. # Optional. Config for ranking and reranking. + "llmRanker": { # Config for LlmRanker. # Optional. Config for LlmRanker. + "modelName": "A String", # Optional. The model name used for ranking. See [Supported models](https://cloud.google.com/vertex-ai/generative-ai/docs/model-reference/inference#supported-models). + }, + "rankService": { # Config for Rank Service. # Optional. Config for Rank Service. + "modelName": "A String", # Optional. The model name of the rank service. Format: `semantic-ranker-512@latest` + }, + }, + "topK": 42, # Optional. The number of contexts to retrieve. + }, + "similarityTopK": 42, # Optional. Number of top k results to return from the selected corpora. + "vectorDistanceThreshold": 3.14, # Optional. Only return results with vector distance smaller than the threshold. + }, + }, + "urlContext": { # Tool to support URL context. # Optional. Tool to support URL context retrieval. + }, + }, + ], + }, + }, + "turns": [ # Optional. A chronological list of conversation turns. Each turn represents a logical execution cycle (e.g., User Input -> Agent Response). + { # Represents a single turn/invocation in the conversation. + "events": [ # Optional. The list of events that occurred during this turn. + { # Represents a single event in the execution trace. + "activeTools": [ # Optional. The list of tools that were active/available to the agent at the time of this event. This overrides the `AgentConfig.tools` if set. + { # Tool details that the model may use to generate response. A `Tool` is a piece of code that enables the system to interact with external systems to perform an action, or set of actions, outside of knowledge and scope of the model. A Tool object should contain exactly one type of Tool (e.g FunctionDeclaration, Retrieval or GoogleSearchRetrieval). + "codeExecution": { # Tool that executes code generated by the model, and automatically returns the result to the model. See also ExecutableCode and CodeExecutionResult, which are input and output to this tool. # Optional. CodeExecution tool type. Enables the model to execute code as part of generation. + }, + "computerUse": { # A tool that enables the model to interact directly with a computer environment. # Optional. Tool to support the model interacting directly with the computer. If enabled, it automatically populates computer-use specific Function Declarations. + "disabledSafetyPolicies": [ # Optional. A list of safety policies to disable for the computer use tool. + "A String", + ], + "enablePromptInjectionDetection": True or False, # Optional. Whether to enable the prompt injection detection check on the computer use request. + "environment": "A String", # Required. The target environment where the computer use tool operates. + "excludedPredefinedFunctions": [ # Optional. A list of predefined functions to explicitly exclude from the model call. By default, [predefined functions](https://cloud.google.com/vertex-ai/generative-ai/docs/computer-use#supported-actions) are included. Excluding functions allows for a more restricted action space or custom definitions for predefined functions. + "A String", + ], + }, + "enterpriseWebSearch": { # Tool to search public web data, powered by Vertex AI Search and Sec4 compliance. # Optional. Tool to support searching public web data, powered by Vertex AI Search and Sec4 compliance. + "blockingConfidence": "A String", # Optional. Sites with confidence level chosen & above this value will be blocked from the search results. + "excludeDomains": [ # Optional. List of domains to be excluded from the search results. The default limit is 2000 domains. + "A String", + ], + }, + "exaAiSearch": { # ExaAiSearch tool type. A tool that uses the Exa.ai search engine for grounding. # Optional. Uses Exa.ai to search for information to answer user queries. The search results will be grounded on Exa.ai and presented to the model for response generation + "apiKey": "A String", # Required. The API key for ExaAiSearch. + "customConfigs": { # Optional. This field can be used to pass any parameter from the Exa.ai Search API. + "a_key": "", # Properties of the object. + }, + }, + "functionDeclarations": [ # Optional. Function tool type. One or more function declarations to be passed to the model along with the current user query. Model may decide to call a subset of these functions by populating FunctionCall in the response. User should provide a FunctionResponse for each function call in the next turn. Based on the function responses, Model will generate the final response back to the user. Maximum 512 function declarations can be provided. + { # Structured representation of a function declaration as defined by the [OpenAPI 3.0 specification](https://spec.openapis.org/oas/v3.0.3). Included in this declaration are the function name, description, parameters and response type. This FunctionDeclaration is a representation of a block of code that can be used as a `Tool` by the model and executed by the client. + "behavior": "A String", # Optional. Specifies the function Behavior. If not specified, the system keeps the current function call behavior. This field is currently only supported by the BidiGenerateContent method. + "description": "A String", # Optional. Description and purpose of the function. Model uses it to decide how and whether to call the function. + "name": "A String", # Required. The name of the function to call. Must start with a letter or an underscore. Must be a-z, A-Z, 0-9, or contain underscores, dots, colons and dashes, with a maximum length of 128. + "parameters": { # Defines the schema of input and output data. This is a subset of the [OpenAPI 3.0 Schema Object](https://spec.openapis.org/oas/v3.0.3#schema-object). # Optional. Describes the parameters to this function in JSON Schema Object format. Reflects the Open API 3.03 Parameter Object. string Key: the name of the parameter. Parameter names are case sensitive. Schema Value: the Schema defining the type used for the parameter. For function with no parameters, this can be left unset. Parameter names must start with a letter or an underscore and must only contain chars a-z, A-Z, 0-9, or underscores with a maximum length of 64. Example with 1 required and 1 optional parameter: type: OBJECT properties: param1: type: STRING param2: type: INTEGER required: - param1 + "additionalProperties": "", # Optional. If `type` is `OBJECT`, specifies how to handle properties not defined in `properties`. If it is a boolean `false`, no additional properties are allowed. If it is a schema, additional properties are allowed if they conform to the schema. + "anyOf": [ # Optional. The instance must be valid against any (one or more) of the subschemas listed in `any_of`. + # Object with schema name: GoogleCloudAiplatformV1Schema + ], + "default": "", # Optional. Default value to use if the field is not specified. + "defs": { # Optional. `defs` provides a map of schema definitions that can be reused by `ref` elsewhere in the schema. Only allowed at root level of the schema. + "a_key": # Object with schema name: GoogleCloudAiplatformV1Schema + }, + "description": "A String", # Optional. Describes the data. The model uses this field to understand the purpose of the schema and how to use it. It is a best practice to provide a clear and descriptive explanation for the schema and its properties here, rather than in the prompt. + "enum": [ # Optional. Possible values of the field. This field can be used to restrict a value to a fixed set of values. To mark a field as an enum, set `format` to `enum` and provide the list of possible values in `enum`. For example: 1. To define directions: `{type:STRING, format:enum, enum:["EAST", "NORTH", "SOUTH", "WEST"]}` 2. To define apartment numbers: `{type:INTEGER, format:enum, enum:["101", "201", "301"]}` + "A String", + ], + "example": "", # Optional. Example of an instance of this schema. + "format": "A String", # Optional. The format of the data. For `NUMBER` type, format can be `float` or `double`. For `INTEGER` type, format can be `int32` or `int64`. For `STRING` type, format can be `email`, `byte`, `date`, `date-time`, `password`, and other formats to further refine the data type. + "items": # Object with schema name: GoogleCloudAiplatformV1Schema # Optional. If type is `ARRAY`, `items` specifies the schema of elements in the array. + "maxItems": "A String", # Optional. If type is `ARRAY`, `max_items` specifies the maximum number of items in an array. + "maxLength": "A String", # Optional. If type is `STRING`, `max_length` specifies the maximum length of the string. + "maxProperties": "A String", # Optional. If type is `OBJECT`, `max_properties` specifies the maximum number of properties that can be provided. + "maximum": 3.14, # Optional. If type is `INTEGER` or `NUMBER`, `maximum` specifies the maximum allowed value. + "minItems": "A String", # Optional. If type is `ARRAY`, `min_items` specifies the minimum number of items in an array. + "minLength": "A String", # Optional. If type is `STRING`, `min_length` specifies the minimum length of the string. + "minProperties": "A String", # Optional. If type is `OBJECT`, `min_properties` specifies the minimum number of properties that can be provided. + "minimum": 3.14, # Optional. If type is `INTEGER` or `NUMBER`, `minimum` specifies the minimum allowed value. + "nullable": True or False, # Optional. Indicates if the value of this field can be null. + "pattern": "A String", # Optional. If type is `STRING`, `pattern` specifies a regular expression that the string must match. + "properties": { # Optional. If type is `OBJECT`, `properties` is a map of property names to schema definitions for each property of the object. + "a_key": # Object with schema name: GoogleCloudAiplatformV1Schema + }, + "propertyOrdering": [ # Optional. Order of properties displayed or used where order matters. This is not a standard field in OpenAPI specification, but can be used to control the order of properties. + "A String", + ], + "ref": "A String", # Optional. Allows referencing another schema definition to use in place of this schema. The value must be a valid reference to a schema in `defs`. For example, the following schema defines a reference to a schema node named "Pet": type: object properties: pet: ref: #/defs/Pet defs: Pet: type: object properties: name: type: string The value of the "pet" property is a reference to the schema node named "Pet". See details in https://json-schema.org/understanding-json-schema/structuring + "required": [ # Optional. If type is `OBJECT`, `required` lists the names of properties that must be present. + "A String", + ], + "title": "A String", # Optional. Title for the schema. + "type": "A String", # Optional. Data type of the schema field. + }, + "parametersJsonSchema": "", # Optional. Describes the parameters to the function in JSON Schema format. The schema must describe an object where the properties are the parameters to the function. For example: ``` { "type": "object", "properties": { "name": { "type": "string" }, "age": { "type": "integer" } }, "additionalProperties": false, "required": ["name", "age"], "propertyOrdering": ["name", "age"] } ``` This field is mutually exclusive with `parameters`. + "response": { # Defines the schema of input and output data. This is a subset of the [OpenAPI 3.0 Schema Object](https://spec.openapis.org/oas/v3.0.3#schema-object). # Optional. Describes the output from this function in JSON Schema format. Reflects the Open API 3.03 Response Object. The Schema defines the type used for the response value of the function. + "additionalProperties": "", # Optional. If `type` is `OBJECT`, specifies how to handle properties not defined in `properties`. If it is a boolean `false`, no additional properties are allowed. If it is a schema, additional properties are allowed if they conform to the schema. + "anyOf": [ # Optional. The instance must be valid against any (one or more) of the subschemas listed in `any_of`. + # Object with schema name: GoogleCloudAiplatformV1Schema + ], + "default": "", # Optional. Default value to use if the field is not specified. + "defs": { # Optional. `defs` provides a map of schema definitions that can be reused by `ref` elsewhere in the schema. Only allowed at root level of the schema. + "a_key": # Object with schema name: GoogleCloudAiplatformV1Schema + }, + "description": "A String", # Optional. Describes the data. The model uses this field to understand the purpose of the schema and how to use it. It is a best practice to provide a clear and descriptive explanation for the schema and its properties here, rather than in the prompt. + "enum": [ # Optional. Possible values of the field. This field can be used to restrict a value to a fixed set of values. To mark a field as an enum, set `format` to `enum` and provide the list of possible values in `enum`. For example: 1. To define directions: `{type:STRING, format:enum, enum:["EAST", "NORTH", "SOUTH", "WEST"]}` 2. To define apartment numbers: `{type:INTEGER, format:enum, enum:["101", "201", "301"]}` + "A String", + ], + "example": "", # Optional. Example of an instance of this schema. + "format": "A String", # Optional. The format of the data. For `NUMBER` type, format can be `float` or `double`. For `INTEGER` type, format can be `int32` or `int64`. For `STRING` type, format can be `email`, `byte`, `date`, `date-time`, `password`, and other formats to further refine the data type. + "items": # Object with schema name: GoogleCloudAiplatformV1Schema # Optional. If type is `ARRAY`, `items` specifies the schema of elements in the array. + "maxItems": "A String", # Optional. If type is `ARRAY`, `max_items` specifies the maximum number of items in an array. + "maxLength": "A String", # Optional. If type is `STRING`, `max_length` specifies the maximum length of the string. + "maxProperties": "A String", # Optional. If type is `OBJECT`, `max_properties` specifies the maximum number of properties that can be provided. + "maximum": 3.14, # Optional. If type is `INTEGER` or `NUMBER`, `maximum` specifies the maximum allowed value. + "minItems": "A String", # Optional. If type is `ARRAY`, `min_items` specifies the minimum number of items in an array. + "minLength": "A String", # Optional. If type is `STRING`, `min_length` specifies the minimum length of the string. + "minProperties": "A String", # Optional. If type is `OBJECT`, `min_properties` specifies the minimum number of properties that can be provided. + "minimum": 3.14, # Optional. If type is `INTEGER` or `NUMBER`, `minimum` specifies the minimum allowed value. + "nullable": True or False, # Optional. Indicates if the value of this field can be null. + "pattern": "A String", # Optional. If type is `STRING`, `pattern` specifies a regular expression that the string must match. + "properties": { # Optional. If type is `OBJECT`, `properties` is a map of property names to schema definitions for each property of the object. + "a_key": # Object with schema name: GoogleCloudAiplatformV1Schema + }, + "propertyOrdering": [ # Optional. Order of properties displayed or used where order matters. This is not a standard field in OpenAPI specification, but can be used to control the order of properties. + "A String", + ], + "ref": "A String", # Optional. Allows referencing another schema definition to use in place of this schema. The value must be a valid reference to a schema in `defs`. For example, the following schema defines a reference to a schema node named "Pet": type: object properties: pet: ref: #/defs/Pet defs: Pet: type: object properties: name: type: string The value of the "pet" property is a reference to the schema node named "Pet". See details in https://json-schema.org/understanding-json-schema/structuring + "required": [ # Optional. If type is `OBJECT`, `required` lists the names of properties that must be present. + "A String", + ], + "title": "A String", # Optional. Title for the schema. + "type": "A String", # Optional. Data type of the schema field. + }, + "responseJsonSchema": "", # Optional. Describes the output from this function in JSON Schema format. The value specified by the schema is the response value of the function. This field is mutually exclusive with `response`. + }, + ], + "googleMaps": { # Tool to retrieve public maps data for grounding, powered by Google. # Optional. GoogleMaps tool type. Tool to support Google Maps in Model. + "enableWidget": True or False, # Optional. Deprecated: The Google Maps contextual widget behavior in Grounding with Google Maps is being deprecated; this field is planned for removal and no longer has any effect once removed. If true, include the widget context token in the response. + "groundingTypes": { # Defines the types of Google Maps grounding that can be enabled and their configurations. # Optional. Specifies the types of Google Maps grounding to enable. Defaults to `places` when unset. + "places": { # Grounding with Google Maps Places data (e.g. QueryPlaces). This is the default Google Maps grounding type when no other type is specified. # Optional. Enables grounding with Google Maps Places. This is the default grounding type when no `GroundingTypes` are specified. + }, + "routing": { # Grounding with Google Maps Routing APIs (ComputeRoutes and SearchAlongRoute). # Optional. Enables grounding with Google Maps Routing APIs (ComputeRoutes and SearchAlongRoute). + }, + }, + }, + "googleSearch": { # GoogleSearch tool type. Tool to support Google Search in Model. Powered by Google. # Optional. GoogleSearch tool type. Tool to support Google Search in Model. Powered by Google. + "blockingConfidence": "A String", # Optional. Sites with confidence level chosen & above this value will be blocked from the search results. + "excludeDomains": [ # Optional. List of domains to be excluded from the search results. The default limit is 2000 domains. Example: ["amazon.com", "facebook.com"]. + "A String", + ], + "searchTypes": { # Different types of search that can be enabled on the GoogleSearch tool. # Optional. The set of search types to enable. If not set, web search is enabled by default. + "imageSearch": { # Image search for grounding and related configurations. # Optional. Setting this field enables image search. Image bytes are returned. + }, + "webSearch": { # Standard web search for grounding and related configurations. Only text results are returned. # Optional. Setting this field enables web search. Only text results are returned. + }, + }, + }, + "googleSearchRetrieval": { # Tool to retrieve public web data for grounding, powered by Google. # Optional. Specialized retrieval tool that is powered by Google Search. + "dynamicRetrievalConfig": { # Describes the options to customize dynamic retrieval. # Specifies the dynamic retrieval configuration for the given source. + "dynamicThreshold": 3.14, # Optional. The threshold to be used in dynamic retrieval. If not set, a system default value is used. + "mode": "A String", # The mode of the predictor to be used in dynamic retrieval. + }, + }, + "parallelAiSearch": { # ParallelAiSearch tool type. A tool that uses the Parallel.ai search engine for grounding. # Optional. If specified, Vertex AI will use Parallel.ai to search for information to answer user queries. The search results will be grounded on Parallel.ai and presented to the model for response generation + "apiKey": "A String", # Optional. The API key for ParallelAiSearch. If an API key is not provided, the system will attempt to verify access by checking for an active Parallel.ai subscription through the Google Cloud Marketplace. See https://docs.parallel.ai/search/search-quickstart for more details. + "customConfigs": { # Optional. Custom configs for ParallelAiSearch. This field can be used to pass any parameter from the Parallel.ai Search API. See the Parallel.ai documentation for the full list of available parameters and their usage: https://docs.parallel.ai/api-reference/search-beta/search Currently only `source_policy`, `excerpts`, `max_results`, `mode`, `fetch_policy` can be set via this field. For example: { "source_policy": { "include_domains": ["google.com", "wikipedia.org"], "exclude_domains": ["example.com"] }, "fetch_policy": { "max_age_seconds": 3600 } } + "a_key": "", # Properties of the object. + }, + "enableDataRetention": True or False, # Optional. Deprecated: Use `enable_zero_data_retention` instead. Instructs Vertex Grounding to use Parallel's Zero Data Retention Marketplace product. If this value is "false" or omitted, the Parallel Web Search for Grounding standard subscription will be used. If this value is "true", the Parallel Web Search for Grounding - ZDR subscription will be used. + "enableZeroDataRetention": True or False, # Optional. Instructs Vertex Grounding to use Parallel's Zero Data Retention Marketplace product. If this value is "false" or omitted, the Parallel Web Search for Grounding standard subscription will be used. If this value is "true", the Parallel Web Search for Grounding - ZDR subscription will be used. + }, + "retrieval": { # Defines a retrieval tool that model can call to access external knowledge. # Optional. Retrieval tool type. System will always execute the provided retrieval tool(s) to get external knowledge to answer the prompt. Retrieval results are presented to the model for generation. + "disableAttribution": True or False, # Optional. Deprecated. This option is no longer supported. + "externalApi": { # Retrieve from data source powered by external API for grounding. The external API is not owned by Google, but need to follow the pre-defined API spec. # Use data source powered by external API for grounding. + "apiAuth": { # The generic reusable api auth config. Deprecated. Please use AuthConfig (google/cloud/aiplatform/master/auth.proto) instead. # The authentication config to access the API. Deprecated. Please use auth_config instead. + "apiKeyConfig": { # The API secret. # The API secret. + "apiKeySecretVersion": "A String", # Required. The SecretManager secret version resource name storing API key. e.g. projects/{project}/secrets/{secret}/versions/{version} + "apiKeyString": "A String", # The API key string. Either this or `api_key_secret_version` must be set. + }, + }, + "apiSpec": "A String", # The API spec that the external API implements. + "authConfig": { # Auth configuration to run the extension. # The authentication config to access the API. + "apiKeyConfig": { # Config for authentication with API key. # Config for API key auth. + "apiKeySecret": "A String", # Optional. The name of the SecretManager secret version resource storing the API key. Format: `projects/{project}/secrets/{secrete}/versions/{version}` - If both `api_key_secret` and `api_key_string` are specified, this field takes precedence over `api_key_string`. - If specified, the `secretmanager.versions.access` permission should be granted to Vertex AI Extension Service Agent (https://cloud.google.com/vertex-ai/docs/general/access-control#service-agents) on the specified resource. + "apiKeyString": "A String", # Optional. The API key to be used in the request directly. + "httpElementLocation": "A String", # Optional. The location of the API key. + "name": "A String", # Optional. The parameter name of the API key. E.g. If the API request is "https://example.com/act?api_key=", "api_key" would be the parameter name. + }, + "authType": "A String", # Type of auth scheme. + "googleServiceAccountConfig": { # Config for Google Service Account Authentication. # Config for Google Service Account auth. + "serviceAccount": "A String", # Optional. The service account that the extension execution service runs as. - If the service account is specified, the `iam.serviceAccounts.getAccessToken` permission should be granted to Vertex AI Extension Service Agent (https://cloud.google.com/vertex-ai/docs/general/access-control#service-agents) on the specified service account. - If not specified, the Vertex AI Extension Service Agent will be used to execute the Extension. + }, + "httpBasicAuthConfig": { # Config for HTTP Basic Authentication. # Config for HTTP Basic auth. + "credentialSecret": "A String", # Required. The name of the SecretManager secret version resource storing the base64 encoded credentials. Format: `projects/{project}/secrets/{secrete}/versions/{version}` - If specified, the `secretmanager.versions.access` permission should be granted to Vertex AI Extension Service Agent (https://cloud.google.com/vertex-ai/docs/general/access-control#service-agents) on the specified resource. + }, + "oauthConfig": { # Config for user oauth. # Config for user oauth. + "accessToken": "A String", # Access token for extension endpoint. Only used to propagate token from [[ExecuteExtensionRequest.runtime_auth_config]] at request time. + "serviceAccount": "A String", # The service account used to generate access tokens for executing the Extension. - If the service account is specified, the `iam.serviceAccounts.getAccessToken` permission should be granted to Vertex AI Extension Service Agent (https://cloud.google.com/vertex-ai/docs/general/access-control#service-agents) on the provided service account. + }, + "oidcConfig": { # Config for user OIDC auth. # Config for user OIDC auth. + "idToken": "A String", # OpenID Connect formatted ID token for extension endpoint. Only used to propagate token from [[ExecuteExtensionRequest.runtime_auth_config]] at request time. + "serviceAccount": "A String", # The service account used to generate an OpenID Connect (OIDC)-compatible JWT token signed by the Google OIDC Provider (accounts.google.com) for extension endpoint (https://cloud.google.com/iam/docs/create-short-lived-credentials-direct#sa-credentials-oidc). - The audience for the token will be set to the URL in the server url defined in the OpenApi spec. - If the service account is provided, the service account should grant `iam.serviceAccounts.getOpenIdToken` permission to Vertex AI Extension Service Agent (https://cloud.google.com/vertex-ai/docs/general/access-control#service-agents). + }, + }, + "elasticSearchParams": { # The search parameters to use for the ELASTIC_SEARCH spec. # Parameters for the elastic search API. + "index": "A String", # The ElasticSearch index to use. + "numHits": 42, # Optional. Number of hits (chunks) to request. When specified, it is passed to Elasticsearch as the `num_hits` param. + "searchTemplate": "A String", # The ElasticSearch search template to use. + }, + "endpoint": "A String", # The endpoint of the external API. The system will call the API at this endpoint to retrieve the data for grounding. Example: https://acme.com:443/search + "simpleSearchParams": { # The search parameters to use for SIMPLE_SEARCH spec. # Parameters for the simple search API. + }, + }, + "vertexAiSearch": { # Retrieve from Vertex AI Search datastore or engine for grounding. datastore and engine are mutually exclusive. See https://cloud.google.com/products/agent-builder # Set to use data source powered by Vertex AI Search. + "dataStoreSpecs": [ # Specifications that define the specific DataStores to be searched, along with configurations for those data stores. This is only considered for Engines with multiple data stores. It should only be set if engine is used. + { # Define data stores within engine to filter on in a search call and configurations for those data stores. For more information, see https://cloud.google.com/generative-ai-app-builder/docs/reference/rpc/google.cloud.discoveryengine.v1#datastorespec + "dataStore": "A String", # Full resource name of DataStore, such as Format: `projects/{project}/locations/{location}/collections/{collection}/dataStores/{dataStore}` + "filter": "A String", # Optional. Filter specification to filter documents in the data store specified by data_store field. For more information on filtering, see [Filtering](https://cloud.google.com/generative-ai-app-builder/docs/filter-search-metadata) + }, + ], + "datastore": "A String", # Optional. Fully-qualified Vertex AI Search data store resource ID. Format: `projects/{project}/locations/{location}/collections/{collection}/dataStores/{dataStore}` + "engine": "A String", # Optional. Fully-qualified Vertex AI Search engine resource ID. Format: `projects/{project}/locations/{location}/collections/{collection}/engines/{engine}` + "filter": "A String", # Optional. Filter strings to be passed to the search API. + "maxResults": 42, # Optional. Number of search results to return per query. The default value is 10. The maximumm allowed value is 10. + }, + "vertexRagStore": { # Retrieve from Vertex RAG Store for grounding. # Set to use data source powered by Vertex RAG store. User data is uploaded via the VertexRagDataService. + "ragResources": [ # Optional. The representation of the rag source. It can be used to specify corpus only or ragfiles. Currently only support one corpus or multiple files from one corpus. In the future we may open up multiple corpora support. + { # The definition of the Rag resource. + "ragCorpus": "A String", # Optional. RagCorpora resource name. Format: `projects/{project}/locations/{location}/ragCorpora/{rag_corpus}` + "ragFileIds": [ # Optional. rag_file_id. The files should be in the same rag_corpus set in rag_corpus field. + "A String", + ], + }, + ], + "ragRetrievalConfig": { # Specifies the context retrieval config. # Optional. The retrieval config for the Rag query. + "filter": { # Config for filters. # Optional. Config for filters. + "metadataFilter": "A String", # Optional. String for metadata filtering. + "vectorDistanceThreshold": 3.14, # Optional. Only returns contexts with vector distance smaller than the threshold. + "vectorSimilarityThreshold": 3.14, # Optional. Only returns contexts with vector similarity larger than the threshold. + }, + "ranking": { # Config for ranking and reranking. # Optional. Config for ranking and reranking. + "llmRanker": { # Config for LlmRanker. # Optional. Config for LlmRanker. + "modelName": "A String", # Optional. The model name used for ranking. See [Supported models](https://cloud.google.com/vertex-ai/generative-ai/docs/model-reference/inference#supported-models). + }, + "rankService": { # Config for Rank Service. # Optional. Config for Rank Service. + "modelName": "A String", # Optional. The model name of the rank service. Format: `semantic-ranker-512@latest` + }, + }, + "topK": 42, # Optional. The number of contexts to retrieve. + }, + "similarityTopK": 42, # Optional. Number of top k results to return from the selected corpora. + "vectorDistanceThreshold": 3.14, # Optional. Only return results with vector distance smaller than the threshold. + }, + }, + "urlContext": { # Tool to support URL context. # Optional. Tool to support URL context retrieval. + }, + }, + ], + "author": "A String", # Required. The ID of the agent or entity that generated this event. Use "user" to denote events generated by the end-user. + "content": { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. # Required. The content of the event (e.g., text response, tool call, tool response). + "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -4008,7 +4609,7 @@

Method Details

"contents": [ # Optional. Repeated contents. { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -4110,7 +4711,7 @@

Method Details

"contents": [ # Optional. Repeated contents. { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -4210,7 +4811,7 @@

Method Details

"contents": [ # Optional. Repeated contents. { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -4310,7 +4911,7 @@

Method Details

"contents": [ # Optional. Repeated contents. { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -5308,7 +5909,7 @@

Method Details

"contents": [ # Optional. Repeated contents. { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -5449,7 +6050,7 @@

Method Details

"contents": [ # Optional. Repeated contents. { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -6106,7 +6707,7 @@

Method Details

"contents": [ # Optional. Repeated contents. { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -6446,7 +7047,7 @@

Method Details

"contents": [ # Required. The prompt to generate rubrics from. For single-turn queries, this is a single instance. For multi-turn queries, this is a repeated field that contains conversation history + latest request. { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -7301,7 +7902,7 @@

Method Details

"author": "A String", # Required. The ID of the agent or entity that generated this event. Use "user" to denote events generated by the end-user. "content": { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. # Required. The content of the event (e.g., text response, tool call, tool response). "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -7907,7 +8508,7 @@

Method Details

"author": "A String", # Required. The ID of the agent or entity that generated this event. Use "user" to denote events generated by the end-user. "content": { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. # Required. The content of the event (e.g., text response, tool call, tool response). "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -8512,7 +9113,7 @@

Method Details

"author": "A String", # Required. The ID of the agent or entity that generated this event. Use "user" to denote events generated by the end-user. "content": { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. # Required. The content of the event (e.g., text response, tool call, tool response). "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -8618,7 +9219,7 @@

Method Details

"values": { # The values for fields in the prompt template. "a_key": { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -8788,7 +9389,7 @@

Method Details

{ # Represents a single named field within a synthetic example, consisting of a name and the actual content. "content": { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. # Required. The actual content or value for this field. This can be text, images, or other types of data. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -8911,7 +9512,7 @@

Method Details

{ # Represents a single named field within a synthetic example, consisting of a name and the actual content. "content": { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. # Required. The actual content or value for this field. This can be text, images, or other types of data. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. diff --git a/docs/dyn/aiplatform_v1.projects.locations.interactions.html b/docs/dyn/aiplatform_v1.projects.locations.interactions.html new file mode 100644 index 0000000000..16511204fb --- /dev/null +++ b/docs/dyn/aiplatform_v1.projects.locations.interactions.html @@ -0,0 +1,11777 @@ + + + +

Agent Platform API . projects . locations . interactions

+

Instance Methods

+

+ close()

+

Close httplib2 connections.

+

+ create(projectsId, locationsId, body=None, x__xgafv=None)

+

Creates an interaction.

+

+ createStream(projectsId, locationsId, body=None, x__xgafv=None)

+

Creates an interaction and streams the response.

+

+ delete(name, x__xgafv=None)

+

Deletes an interaction.

+

Method Details

+
+ close() + 
Close httplib2 connections.
+
+ +
+ create(projectsId, locationsId, body=None, x__xgafv=None) + 
Creates an interaction.
+
+Args:
+  projectsId: string, A parameter (required)
+  locationsId: string, A parameter (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # Configuration parameters for creating an interaction.
+  "background": True or False, # Input only. Whether to run the model interaction in the background.
+  "interaction": { # Response for InteractionService.CreateInteraction. # The interaction to create.
+    "agentInteraction": { # Interaction for generating the completion using agents. # Interaction for generating the completion using agents.
+      "agent": "A String", # The name of the `Agent` used for generating the completion.
+      "antigravityConfig": { # Configuration for the Antigravity agent runtime. Provides server-side control over the agent's execution environment and tool configuration. # Antigravity agent configuration. This configuration is session-level settings that are passed to the agent runtime on a per-request basis.
+        "maxTotalTokens": "A String", # Max total tokens for the agent run.
+        "model": "A String", # The model to use for agent reasoning.
+      },
+      "codeMenderConfig": { # Configuration for the CodeMender agent.
+        "findRequest": { # Request parameters specific to FIND sessions, used for discovering vulnerabilities in a codebase. # Parameters for finding vulnerabilities.
+          "description": "A String", # Additional context or custom instructions provided by the user to guide the vulnerability analysis.
+          "findingId": "A String", # The identifier of a specific finding to verify. This is primarily used in VERIFY mode to focus the agent's execution-based validation on a single vulnerability.
+          "mode": "A String", # The mode of the find session.
+          "sourceFiles": [ # A list of source files to provide as context for the scan.
+            { # Content of a single file in the codebase.
+              "content": "A String", # The UTF-8 encoded text content of the file.
+              "path": "A String", # The relative path of the file from the project root.
+            },
+          ],
+        },
+        "fixRequest": { # Request parameters specific to FIX sessions, used for generating and validating security patches. # Parameters for fixing vulnerabilities.
+          "description": "A String", # Additional context or custom instructions provided by the user to guide the patch generation process.
+          "findingId": "A String", # The identifier of the specific security finding to be remediated. This ID maps to a previously discovered vulnerability.
+          "sourceFiles": [ # A list of source files providing context for the remediation. These files are typically the ones containing the identified vulnerability.
+            { # Content of a single file in the codebase.
+              "content": "A String", # The UTF-8 encoded text content of the file.
+              "path": "A String", # The relative path of the file from the project root.
+            },
+          ],
+        },
+        "model": "A String", # The name of the model to use for the CodeMender agent. One CodeMender session will only use one model.
+        "sessionConfig": { # The configuration of CodeMender sessions. # Optional session-specific configurations to override default agent behavior.
+          "maxRounds": 42, # The maximum number of interaction rounds the agent is allowed to perform before reaching a timeout.
+        },
+        "sessionId": "A String", # Parameter for grouping multiple interactions that belong to the same CodeMender session.
+      },
+      "deepResearchConfig": { # Configuration for the Deep Research agent.
+        "collaborativePlanning": True or False, # Enables human-in-the-loop planning for the Deep Research agent. If set to true, the Deep Research agent will provide a research plan in its response. The agent will then proceed only if the user confirms the plan in the next turn.
+        "enableBigqueryTool": True or False, # Enables bigquery tool for the Deep Research agent.
+        "thinkingSummaries": "A String", # Whether to include thought summaries in the response.
+        "visualization": "A String", # Whether to include visualizations in the response.
+      },
+      "dynamicConfig": { # Configuration for dynamic agents.
+        "config": { # `Struct` represents a structured data value, consisting of fields which map to dynamically typed values. # For agents that are not supported statically in the API definition.
+          "fields": [ # Dynamically typed fields. List instead of map because LLMs are sensitive to ordering, and we want to give users full control.
+            { # Represents a single field in a struct.
+              "name": "A String",
+              "value": { # `Value` represents a dynamically typed value which can be either null, a number, a string, a boolean, a recursive struct value, or a list of values. A producer of value is expected to set one of these variants. Absence of any variant indicates an error.
+                "boolValue": True or False, # Represents a boolean value.
+                "contentValue": { # The content of the response. # Represents rich content (text, image, etc.).
+                  "audio": { # An audio content block.
+                    "channels": 42, # The number of audio channels.
+                    "data": "A String", # The audio content.
+                    "mimeTypeString": "A String", # Flexible MIME type string of the audio, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                    "sampleRate": 42, # The sample rate of the audio.
+                    "uri": "A String", # The URI of the audio.
+                  },
+                  "document": { # A document content block.
+                    "data": "A String", # The document content.
+                    "mimeTypeString": "A String", # Flexible MIME type string of the document, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                    "uri": "A String", # The URI of the document.
+                  },
+                  "image": { # An image content block.
+                    "data": "A String", # The image content.
+                    "mimeTypeString": "A String", # Flexible MIME type string of the image, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                    "resolution": "A String", # The resolution of the media.
+                    "uri": "A String", # The URI of the image.
+                  },
+                  "text": { # A text content block.
+                    "annotations": [ # Citation information for model-generated content.
+                      { # Citation information for model-generated content.
+                        "endIndex": 42, # End of the attributed segment, exclusive.
+                        "fileCitation": { # A file citation annotation. # A file citation annotation.
+                          "customMetadata": { # User provided metadata about the retrieved context.
+                            "a_key": "", # Properties of the object.
+                          },
+                          "documentUri": "A String", # The URI of the file.
+                          "fileName": "A String", # The name of the file.
+                          "mediaId": "A String", # Media ID in-case of image citations, if applicable.
+                          "pageNumber": 42, # Page number of the cited document, if applicable.
+                          "source": "A String", # Source attributed for a portion of the text.
+                        },
+                        "placeCitation": { # A place citation annotation. # A place citation annotation.
+                          "name": "A String", # Title of the place.
+                          "placeId": "A String", # The ID of the place, in `places/{place_id}` format.
+                          "reviewSnippets": [ # Snippets of reviews that are used to generate answers about the features of a given place in Google Maps.
+                            { # Encapsulates a snippet of a user review that answers a question about the features of a specific place in Google Maps.
+                              "reviewId": "A String", # The ID of the review snippet.
+                              "title": "A String", # Title of the review.
+                              "url": "A String", # A link that corresponds to the user review on Google Maps.
+                            },
+                          ],
+                          "url": "A String", # URI reference of the place.
+                        },
+                        "speechMetadata": { # Speech annotation for text content. # Speech annotation for text content.
+                          "speaker": "A String", # The speaker to associate with this turn.
+                          "style": "A String", # Style instruction for the speech synthesis.
+                        },
+                        "startIndex": 42, # Start of segment of the response that is attributed to this source. Index indicates the start of the segment, measured in bytes.
+                        "urlCitation": { # A URL citation annotation. # NOTE: We use these instead of the Citation message for historical reasons. A URL citation annotation.
+                          "title": "A String", # The title of the URL.
+                          "url": "A String", # The URL.
+                        },
+                        "wordInfo": { # Word-level ASR annotation for transcription output. Carries the word text, optional timing, and optional speaker attribution. # Word-level ASR annotation with timing and speaker info.
+                          "endOffset": "A String", # End offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                          "speaker": "A String", # Optional. Speaker label for this word (e.g. "spk_1", "spk_2"). Present when diarization_mode is set in TranscriptionConfig.
+                          "startOffset": "A String", # Start offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                          "text": "A String", # The transcribed word.
+                        },
+                      },
+                    ],
+                    "text": "A String", # Required. The text content.
+                  },
+                  "video": { # A video content block.
+                    "data": "A String", # The video content.
+                    "mimeTypeString": "A String", # Flexible MIME type string of the video, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                    "name": "A String", # A user-defined name for this content block. Can be referenced by the model in the final response.
+                    "processingConfig": {
+                      "static": {
+                        "endOffset": "A String", # Optional. Segment end time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "30s". Must be non-negative and greater than `start_offset` if `start_offset` is set.
+                        "fps": 3.14, # Optional. Video frame-rate sampling density.
+                        "startOffset": "A String", # Optional. Segment start time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "10.5s". Must be non-negative.
+                      },
+                    },
+                    "processingType": "A String",
+                    "resolution": "A String", # The resolution of the media.
+                    "uri": "A String", # The URI of the video.
+                  },
+                },
+                "listValue": { # `ListValue` is a wrapper around a repeated field of values. # Represents a repeated `Value`.
+                  "values": [ # Repeated field of dynamically typed values.
+                    # Object with schema name: GenaiVertexV1Value
+                  ],
+                },
+                "nullValue": "A String", # Represents a null value.
+                "numberValue": 3.14, # Represents a double value.
+                "stringValue": "A String", # Represents a string value.
+                "structValue": # Object with schema name: GenaiVertexV1Struct # Represents a structured value.
+              },
+            },
+          ],
+        },
+      },
+    },
+    "content": { # The content of the response. # The content for the interaction.
+      "audio": { # An audio content block.
+        "channels": 42, # The number of audio channels.
+        "data": "A String", # The audio content.
+        "mimeTypeString": "A String", # Flexible MIME type string of the audio, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+        "sampleRate": 42, # The sample rate of the audio.
+        "uri": "A String", # The URI of the audio.
+      },
+      "document": { # A document content block.
+        "data": "A String", # The document content.
+        "mimeTypeString": "A String", # Flexible MIME type string of the document, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+        "uri": "A String", # The URI of the document.
+      },
+      "image": { # An image content block.
+        "data": "A String", # The image content.
+        "mimeTypeString": "A String", # Flexible MIME type string of the image, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+        "resolution": "A String", # The resolution of the media.
+        "uri": "A String", # The URI of the image.
+      },
+      "text": { # A text content block.
+        "annotations": [ # Citation information for model-generated content.
+          { # Citation information for model-generated content.
+            "endIndex": 42, # End of the attributed segment, exclusive.
+            "fileCitation": { # A file citation annotation. # A file citation annotation.
+              "customMetadata": { # User provided metadata about the retrieved context.
+                "a_key": "", # Properties of the object.
+              },
+              "documentUri": "A String", # The URI of the file.
+              "fileName": "A String", # The name of the file.
+              "mediaId": "A String", # Media ID in-case of image citations, if applicable.
+              "pageNumber": 42, # Page number of the cited document, if applicable.
+              "source": "A String", # Source attributed for a portion of the text.
+            },
+            "placeCitation": { # A place citation annotation. # A place citation annotation.
+              "name": "A String", # Title of the place.
+              "placeId": "A String", # The ID of the place, in `places/{place_id}` format.
+              "reviewSnippets": [ # Snippets of reviews that are used to generate answers about the features of a given place in Google Maps.
+                { # Encapsulates a snippet of a user review that answers a question about the features of a specific place in Google Maps.
+                  "reviewId": "A String", # The ID of the review snippet.
+                  "title": "A String", # Title of the review.
+                  "url": "A String", # A link that corresponds to the user review on Google Maps.
+                },
+              ],
+              "url": "A String", # URI reference of the place.
+            },
+            "speechMetadata": { # Speech annotation for text content. # Speech annotation for text content.
+              "speaker": "A String", # The speaker to associate with this turn.
+              "style": "A String", # Style instruction for the speech synthesis.
+            },
+            "startIndex": 42, # Start of segment of the response that is attributed to this source. Index indicates the start of the segment, measured in bytes.
+            "urlCitation": { # A URL citation annotation. # NOTE: We use these instead of the Citation message for historical reasons. A URL citation annotation.
+              "title": "A String", # The title of the URL.
+              "url": "A String", # The URL.
+            },
+            "wordInfo": { # Word-level ASR annotation for transcription output. Carries the word text, optional timing, and optional speaker attribution. # Word-level ASR annotation with timing and speaker info.
+              "endOffset": "A String", # End offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+              "speaker": "A String", # Optional. Speaker label for this word (e.g. "spk_1", "spk_2"). Present when diarization_mode is set in TranscriptionConfig.
+              "startOffset": "A String", # Start offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+              "text": "A String", # The transcribed word.
+            },
+          },
+        ],
+        "text": "A String", # Required. The text content.
+      },
+      "video": { # A video content block.
+        "data": "A String", # The video content.
+        "mimeTypeString": "A String", # Flexible MIME type string of the video, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+        "name": "A String", # A user-defined name for this content block. Can be referenced by the model in the final response.
+        "processingConfig": {
+          "static": {
+            "endOffset": "A String", # Optional. Segment end time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "30s". Must be non-negative and greater than `start_offset` if `start_offset` is set.
+            "fps": 3.14, # Optional. Video frame-rate sampling density.
+            "startOffset": "A String", # Optional. Segment start time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "10.5s". Must be non-negative.
+          },
+        },
+        "processingType": "A String",
+        "resolution": "A String", # The resolution of the media.
+        "uri": "A String", # The URI of the video.
+      },
+    },
+    "created": "A String", # Required. Output only. The time at which the response was created in ISO 8601 format (YYYY-MM-DDThh:mm:ssZ).
+    "envId": "A String", # The environment ID for the interaction. Can be 'remote' for default environment.
+    "environmentId": "A String", # Output only. The environment ID for the interaction. Only populated if environment config is set in the request.
+    "errors": [ # Output only. Diagnostic faults / platform errors recorded on the interaction.
+      { # Error message from an interaction.
+        "code": "A String", # A URI that identifies the error type.
+        "message": "A String", # A human-readable error message.
+      },
+    ],
+    "id": "A String", # Required. Output only. A unique identifier for the interaction completion.
+    "labels": { # The labels with user-defined metadata for the request. 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",
+    },
+    "modelInteraction": { # Interaction for generating the completion using models. # Interaction for generating the completion using models.
+      "generationConfig": { # Configuration parameters for model interactions. # Input only. Configuration parameters for the model interaction.
+        "maxOutputTokens": 42, # The maximum number of tokens to include in the response.
+        "seed": 42, # Seed used in decoding for reproducibility.
+        "stopSequences": [ # A list of character sequences that will stop output interaction.
+          "A String",
+        ],
+        "structuredSpeechConfig": { # Configuration for multi-speaker and speech generation. # Speech and multi-speaker configuration.
+          "speakers": [ # Individual speaker configurations.
+            { # The configuration for speech interaction.
+              "language": "A String", # The language of the speech.
+              "speaker": "A String", # The speaker's name, it should match the speaker name given in the prompt.
+              "voice": "A String", # The voice of the speaker.
+            },
+          ],
+        },
+        "temperature": 3.14, # Controls the randomness of the output.
+        "thinkingLevel": "A String", # The level of thought tokens that the model should generate.
+        "thinkingSummaries": "A String", # Whether to include thought summaries in the response.
+        "toolChoiceConfig": { # The tool choice configuration containing allowed tools. # The config for the tool choice.
+          "allowedTools": { # The configuration for allowed tools. # The allowed tools.
+            "mode": "A String", # The mode of the tool choice.
+            "tools": [ # The names of the allowed tools.
+              "A String",
+            ],
+          },
+        },
+        "toolChoiceMode": "A String", # The mode of the tool choice.
+        "topP": 3.14, # The maximum cumulative probability of tokens to consider when sampling.
+        "transcriptionConfig": { # Configuration for speech recognition (transcription). # Optional. Configuration for speech recognition (transcription). If present, ASR is enabled.
+          "adaptationPhrases": [ # Optional. A list of phrases to bias the ASR model towards.
+            "A String",
+          ],
+          "customVocabulary": [ # Optional. A list of custom vocabulary phrases to bias the speech recognition model toward recognizing specific terms.
+            "A String",
+          ],
+          "diarizationMode": "A String", # Optional. Configures speaker diarization. Supported values: "speaker".
+          "languageCodes": [ # Optional. BCP-47 language codes providing hints about the languages present in the audio. If omitted or empty, defaults to automatic language detection.
+            "A String",
+          ],
+          "timestampGranularities": [ # Optional. The granularity of timestamps to include in the transcription output. Supported values: "word". If empty, no timestamps are generated.
+            "A String",
+          ],
+        },
+        "videoConfig": { # Configuration options for video generation. # Configuration for video generation.
+          "task": "A String", # Optional task mode for video generation. If not specified, the model automatically determines the appropriate mode based on the provided text prompt and input media.
+        },
+      },
+      "model": "A String", # The name of the `Model` used for generating the completion.
+    },
+    "previousInteractionId": "A String", # The ID of the previous interaction, if any.
+    "responseFormatList": {
+      "responseFormats": [
+        {
+          "audio": { # Configuration for audio output format.
+            "bitRate": 42, # Bit rate in bits per second (bps). Only applicable for compressed formats (MP3, Opus).
+            "delivery": "A String", # The delivery mode for the audio output.
+            "mimeType": "A String", # The MIME type of the audio output.
+            "sampleRate": 42, # Sample rate in Hz.
+          },
+          "image": { # Configuration for image output format.
+            "aspectRatio": "A String", # The aspect ratio for the image output.
+            "delivery": "A String", # The delivery mode for the image output.
+            "imageSize": "A String", # The size of the image output.
+            "mimeType": "A String", # The MIME type of the image output.
+          },
+          "structValue": { # `Struct` represents a structured data value, consisting of fields which map to dynamically typed values. # Multi-discriminator values is already enabled in GAOS
+            "fields": [ # Dynamically typed fields. List instead of map because LLMs are sensitive to ordering, and we want to give users full control.
+              { # Represents a single field in a struct.
+                "name": "A String",
+                "value": { # `Value` represents a dynamically typed value which can be either null, a number, a string, a boolean, a recursive struct value, or a list of values. A producer of value is expected to set one of these variants. Absence of any variant indicates an error.
+                  "boolValue": True or False, # Represents a boolean value.
+                  "contentValue": { # The content of the response. # Represents rich content (text, image, etc.).
+                    "audio": { # An audio content block.
+                      "channels": 42, # The number of audio channels.
+                      "data": "A String", # The audio content.
+                      "mimeTypeString": "A String", # Flexible MIME type string of the audio, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                      "sampleRate": 42, # The sample rate of the audio.
+                      "uri": "A String", # The URI of the audio.
+                    },
+                    "document": { # A document content block.
+                      "data": "A String", # The document content.
+                      "mimeTypeString": "A String", # Flexible MIME type string of the document, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                      "uri": "A String", # The URI of the document.
+                    },
+                    "image": { # An image content block.
+                      "data": "A String", # The image content.
+                      "mimeTypeString": "A String", # Flexible MIME type string of the image, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                      "resolution": "A String", # The resolution of the media.
+                      "uri": "A String", # The URI of the image.
+                    },
+                    "text": { # A text content block.
+                      "annotations": [ # Citation information for model-generated content.
+                        { # Citation information for model-generated content.
+                          "endIndex": 42, # End of the attributed segment, exclusive.
+                          "fileCitation": { # A file citation annotation. # A file citation annotation.
+                            "customMetadata": { # User provided metadata about the retrieved context.
+                              "a_key": "", # Properties of the object.
+                            },
+                            "documentUri": "A String", # The URI of the file.
+                            "fileName": "A String", # The name of the file.
+                            "mediaId": "A String", # Media ID in-case of image citations, if applicable.
+                            "pageNumber": 42, # Page number of the cited document, if applicable.
+                            "source": "A String", # Source attributed for a portion of the text.
+                          },
+                          "placeCitation": { # A place citation annotation. # A place citation annotation.
+                            "name": "A String", # Title of the place.
+                            "placeId": "A String", # The ID of the place, in `places/{place_id}` format.
+                            "reviewSnippets": [ # Snippets of reviews that are used to generate answers about the features of a given place in Google Maps.
+                              { # Encapsulates a snippet of a user review that answers a question about the features of a specific place in Google Maps.
+                                "reviewId": "A String", # The ID of the review snippet.
+                                "title": "A String", # Title of the review.
+                                "url": "A String", # A link that corresponds to the user review on Google Maps.
+                              },
+                            ],
+                            "url": "A String", # URI reference of the place.
+                          },
+                          "speechMetadata": { # Speech annotation for text content. # Speech annotation for text content.
+                            "speaker": "A String", # The speaker to associate with this turn.
+                            "style": "A String", # Style instruction for the speech synthesis.
+                          },
+                          "startIndex": 42, # Start of segment of the response that is attributed to this source. Index indicates the start of the segment, measured in bytes.
+                          "urlCitation": { # A URL citation annotation. # NOTE: We use these instead of the Citation message for historical reasons. A URL citation annotation.
+                            "title": "A String", # The title of the URL.
+                            "url": "A String", # The URL.
+                          },
+                          "wordInfo": { # Word-level ASR annotation for transcription output. Carries the word text, optional timing, and optional speaker attribution. # Word-level ASR annotation with timing and speaker info.
+                            "endOffset": "A String", # End offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                            "speaker": "A String", # Optional. Speaker label for this word (e.g. "spk_1", "spk_2"). Present when diarization_mode is set in TranscriptionConfig.
+                            "startOffset": "A String", # Start offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                            "text": "A String", # The transcribed word.
+                          },
+                        },
+                      ],
+                      "text": "A String", # Required. The text content.
+                    },
+                    "video": { # A video content block.
+                      "data": "A String", # The video content.
+                      "mimeTypeString": "A String", # Flexible MIME type string of the video, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                      "name": "A String", # A user-defined name for this content block. Can be referenced by the model in the final response.
+                      "processingConfig": {
+                        "static": {
+                          "endOffset": "A String", # Optional. Segment end time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "30s". Must be non-negative and greater than `start_offset` if `start_offset` is set.
+                          "fps": 3.14, # Optional. Video frame-rate sampling density.
+                          "startOffset": "A String", # Optional. Segment start time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "10.5s". Must be non-negative.
+                        },
+                      },
+                      "processingType": "A String",
+                      "resolution": "A String", # The resolution of the media.
+                      "uri": "A String", # The URI of the video.
+                    },
+                  },
+                  "listValue": { # `ListValue` is a wrapper around a repeated field of values. # Represents a repeated `Value`.
+                    "values": [ # Repeated field of dynamically typed values.
+                      # Object with schema name: GenaiVertexV1Value
+                    ],
+                  },
+                  "nullValue": "A String", # Represents a null value.
+                  "numberValue": 3.14, # Represents a double value.
+                  "stringValue": "A String", # Represents a string value.
+                  "structValue": # Object with schema name: GenaiVertexV1Struct # Represents a structured value.
+                },
+              },
+            ],
+          },
+          "text": { # Configuration for text output format.
+            "mimeType": "A String", # The MIME type of the text output.
+            "schema": { # `Struct` represents a structured data value, consisting of fields which map to dynamically typed values. # The JSON schema that the output should conform to. Only applicable when mime_type is application/json.
+              "fields": [ # Dynamically typed fields. List instead of map because LLMs are sensitive to ordering, and we want to give users full control.
+                { # Represents a single field in a struct.
+                  "name": "A String",
+                  "value": { # `Value` represents a dynamically typed value which can be either null, a number, a string, a boolean, a recursive struct value, or a list of values. A producer of value is expected to set one of these variants. Absence of any variant indicates an error.
+                    "boolValue": True or False, # Represents a boolean value.
+                    "contentValue": { # The content of the response. # Represents rich content (text, image, etc.).
+                      "audio": { # An audio content block.
+                        "channels": 42, # The number of audio channels.
+                        "data": "A String", # The audio content.
+                        "mimeTypeString": "A String", # Flexible MIME type string of the audio, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                        "sampleRate": 42, # The sample rate of the audio.
+                        "uri": "A String", # The URI of the audio.
+                      },
+                      "document": { # A document content block.
+                        "data": "A String", # The document content.
+                        "mimeTypeString": "A String", # Flexible MIME type string of the document, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                        "uri": "A String", # The URI of the document.
+                      },
+                      "image": { # An image content block.
+                        "data": "A String", # The image content.
+                        "mimeTypeString": "A String", # Flexible MIME type string of the image, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                        "resolution": "A String", # The resolution of the media.
+                        "uri": "A String", # The URI of the image.
+                      },
+                      "text": { # A text content block.
+                        "annotations": [ # Citation information for model-generated content.
+                          { # Citation information for model-generated content.
+                            "endIndex": 42, # End of the attributed segment, exclusive.
+                            "fileCitation": { # A file citation annotation. # A file citation annotation.
+                              "customMetadata": { # User provided metadata about the retrieved context.
+                                "a_key": "", # Properties of the object.
+                              },
+                              "documentUri": "A String", # The URI of the file.
+                              "fileName": "A String", # The name of the file.
+                              "mediaId": "A String", # Media ID in-case of image citations, if applicable.
+                              "pageNumber": 42, # Page number of the cited document, if applicable.
+                              "source": "A String", # Source attributed for a portion of the text.
+                            },
+                            "placeCitation": { # A place citation annotation. # A place citation annotation.
+                              "name": "A String", # Title of the place.
+                              "placeId": "A String", # The ID of the place, in `places/{place_id}` format.
+                              "reviewSnippets": [ # Snippets of reviews that are used to generate answers about the features of a given place in Google Maps.
+                                { # Encapsulates a snippet of a user review that answers a question about the features of a specific place in Google Maps.
+                                  "reviewId": "A String", # The ID of the review snippet.
+                                  "title": "A String", # Title of the review.
+                                  "url": "A String", # A link that corresponds to the user review on Google Maps.
+                                },
+                              ],
+                              "url": "A String", # URI reference of the place.
+                            },
+                            "speechMetadata": { # Speech annotation for text content. # Speech annotation for text content.
+                              "speaker": "A String", # The speaker to associate with this turn.
+                              "style": "A String", # Style instruction for the speech synthesis.
+                            },
+                            "startIndex": 42, # Start of segment of the response that is attributed to this source. Index indicates the start of the segment, measured in bytes.
+                            "urlCitation": { # A URL citation annotation. # NOTE: We use these instead of the Citation message for historical reasons. A URL citation annotation.
+                              "title": "A String", # The title of the URL.
+                              "url": "A String", # The URL.
+                            },
+                            "wordInfo": { # Word-level ASR annotation for transcription output. Carries the word text, optional timing, and optional speaker attribution. # Word-level ASR annotation with timing and speaker info.
+                              "endOffset": "A String", # End offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                              "speaker": "A String", # Optional. Speaker label for this word (e.g. "spk_1", "spk_2"). Present when diarization_mode is set in TranscriptionConfig.
+                              "startOffset": "A String", # Start offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                              "text": "A String", # The transcribed word.
+                            },
+                          },
+                        ],
+                        "text": "A String", # Required. The text content.
+                      },
+                      "video": { # A video content block.
+                        "data": "A String", # The video content.
+                        "mimeTypeString": "A String", # Flexible MIME type string of the video, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                        "name": "A String", # A user-defined name for this content block. Can be referenced by the model in the final response.
+                        "processingConfig": {
+                          "static": {
+                            "endOffset": "A String", # Optional. Segment end time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "30s". Must be non-negative and greater than `start_offset` if `start_offset` is set.
+                            "fps": 3.14, # Optional. Video frame-rate sampling density.
+                            "startOffset": "A String", # Optional. Segment start time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "10.5s". Must be non-negative.
+                          },
+                        },
+                        "processingType": "A String",
+                        "resolution": "A String", # The resolution of the media.
+                        "uri": "A String", # The URI of the video.
+                      },
+                    },
+                    "listValue": { # `ListValue` is a wrapper around a repeated field of values. # Represents a repeated `Value`.
+                      "values": [ # Repeated field of dynamically typed values.
+                        # Object with schema name: GenaiVertexV1Value
+                      ],
+                    },
+                    "nullValue": "A String", # Represents a null value.
+                    "numberValue": 3.14, # Represents a double value.
+                    "stringValue": "A String", # Represents a string value.
+                    "structValue": # Object with schema name: GenaiVertexV1Struct # Represents a structured value.
+                  },
+                },
+              ],
+            },
+          },
+          "video": { # Configuration for video output format.
+            "aspectRatio": "A String", # The aspect ratio for the video output.
+            "delivery": "A String", # The delivery mode for the video output.
+            "duration": "A String", # The duration for the video output.
+            "gcsUri": "A String", # The Cloud Storage URI to store the video output. Required for Vertex if delivery mode is URI.
+            "resolution": "A String", # The video output resolution. Defaults to 720p.
+          },
+        },
+      ],
+    },
+    "responseFormatSingleton": {
+      "audio": { # Configuration for audio output format.
+        "bitRate": 42, # Bit rate in bits per second (bps). Only applicable for compressed formats (MP3, Opus).
+        "delivery": "A String", # The delivery mode for the audio output.
+        "mimeType": "A String", # The MIME type of the audio output.
+        "sampleRate": 42, # Sample rate in Hz.
+      },
+      "image": { # Configuration for image output format.
+        "aspectRatio": "A String", # The aspect ratio for the image output.
+        "delivery": "A String", # The delivery mode for the image output.
+        "imageSize": "A String", # The size of the image output.
+        "mimeType": "A String", # The MIME type of the image output.
+      },
+      "structValue": { # `Struct` represents a structured data value, consisting of fields which map to dynamically typed values. # Multi-discriminator values is already enabled in GAOS
+        "fields": [ # Dynamically typed fields. List instead of map because LLMs are sensitive to ordering, and we want to give users full control.
+          { # Represents a single field in a struct.
+            "name": "A String",
+            "value": { # `Value` represents a dynamically typed value which can be either null, a number, a string, a boolean, a recursive struct value, or a list of values. A producer of value is expected to set one of these variants. Absence of any variant indicates an error.
+              "boolValue": True or False, # Represents a boolean value.
+              "contentValue": { # The content of the response. # Represents rich content (text, image, etc.).
+                "audio": { # An audio content block.
+                  "channels": 42, # The number of audio channels.
+                  "data": "A String", # The audio content.
+                  "mimeTypeString": "A String", # Flexible MIME type string of the audio, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                  "sampleRate": 42, # The sample rate of the audio.
+                  "uri": "A String", # The URI of the audio.
+                },
+                "document": { # A document content block.
+                  "data": "A String", # The document content.
+                  "mimeTypeString": "A String", # Flexible MIME type string of the document, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                  "uri": "A String", # The URI of the document.
+                },
+                "image": { # An image content block.
+                  "data": "A String", # The image content.
+                  "mimeTypeString": "A String", # Flexible MIME type string of the image, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                  "resolution": "A String", # The resolution of the media.
+                  "uri": "A String", # The URI of the image.
+                },
+                "text": { # A text content block.
+                  "annotations": [ # Citation information for model-generated content.
+                    { # Citation information for model-generated content.
+                      "endIndex": 42, # End of the attributed segment, exclusive.
+                      "fileCitation": { # A file citation annotation. # A file citation annotation.
+                        "customMetadata": { # User provided metadata about the retrieved context.
+                          "a_key": "", # Properties of the object.
+                        },
+                        "documentUri": "A String", # The URI of the file.
+                        "fileName": "A String", # The name of the file.
+                        "mediaId": "A String", # Media ID in-case of image citations, if applicable.
+                        "pageNumber": 42, # Page number of the cited document, if applicable.
+                        "source": "A String", # Source attributed for a portion of the text.
+                      },
+                      "placeCitation": { # A place citation annotation. # A place citation annotation.
+                        "name": "A String", # Title of the place.
+                        "placeId": "A String", # The ID of the place, in `places/{place_id}` format.
+                        "reviewSnippets": [ # Snippets of reviews that are used to generate answers about the features of a given place in Google Maps.
+                          { # Encapsulates a snippet of a user review that answers a question about the features of a specific place in Google Maps.
+                            "reviewId": "A String", # The ID of the review snippet.
+                            "title": "A String", # Title of the review.
+                            "url": "A String", # A link that corresponds to the user review on Google Maps.
+                          },
+                        ],
+                        "url": "A String", # URI reference of the place.
+                      },
+                      "speechMetadata": { # Speech annotation for text content. # Speech annotation for text content.
+                        "speaker": "A String", # The speaker to associate with this turn.
+                        "style": "A String", # Style instruction for the speech synthesis.
+                      },
+                      "startIndex": 42, # Start of segment of the response that is attributed to this source. Index indicates the start of the segment, measured in bytes.
+                      "urlCitation": { # A URL citation annotation. # NOTE: We use these instead of the Citation message for historical reasons. A URL citation annotation.
+                        "title": "A String", # The title of the URL.
+                        "url": "A String", # The URL.
+                      },
+                      "wordInfo": { # Word-level ASR annotation for transcription output. Carries the word text, optional timing, and optional speaker attribution. # Word-level ASR annotation with timing and speaker info.
+                        "endOffset": "A String", # End offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                        "speaker": "A String", # Optional. Speaker label for this word (e.g. "spk_1", "spk_2"). Present when diarization_mode is set in TranscriptionConfig.
+                        "startOffset": "A String", # Start offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                        "text": "A String", # The transcribed word.
+                      },
+                    },
+                  ],
+                  "text": "A String", # Required. The text content.
+                },
+                "video": { # A video content block.
+                  "data": "A String", # The video content.
+                  "mimeTypeString": "A String", # Flexible MIME type string of the video, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                  "name": "A String", # A user-defined name for this content block. Can be referenced by the model in the final response.
+                  "processingConfig": {
+                    "static": {
+                      "endOffset": "A String", # Optional. Segment end time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "30s". Must be non-negative and greater than `start_offset` if `start_offset` is set.
+                      "fps": 3.14, # Optional. Video frame-rate sampling density.
+                      "startOffset": "A String", # Optional. Segment start time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "10.5s". Must be non-negative.
+                    },
+                  },
+                  "processingType": "A String",
+                  "resolution": "A String", # The resolution of the media.
+                  "uri": "A String", # The URI of the video.
+                },
+              },
+              "listValue": { # `ListValue` is a wrapper around a repeated field of values. # Represents a repeated `Value`.
+                "values": [ # Repeated field of dynamically typed values.
+                  # Object with schema name: GenaiVertexV1Value
+                ],
+              },
+              "nullValue": "A String", # Represents a null value.
+              "numberValue": 3.14, # Represents a double value.
+              "stringValue": "A String", # Represents a string value.
+              "structValue": # Object with schema name: GenaiVertexV1Struct # Represents a structured value.
+            },
+          },
+        ],
+      },
+      "text": { # Configuration for text output format.
+        "mimeType": "A String", # The MIME type of the text output.
+        "schema": { # `Struct` represents a structured data value, consisting of fields which map to dynamically typed values. # The JSON schema that the output should conform to. Only applicable when mime_type is application/json.
+          "fields": [ # Dynamically typed fields. List instead of map because LLMs are sensitive to ordering, and we want to give users full control.
+            { # Represents a single field in a struct.
+              "name": "A String",
+              "value": { # `Value` represents a dynamically typed value which can be either null, a number, a string, a boolean, a recursive struct value, or a list of values. A producer of value is expected to set one of these variants. Absence of any variant indicates an error.
+                "boolValue": True or False, # Represents a boolean value.
+                "contentValue": { # The content of the response. # Represents rich content (text, image, etc.).
+                  "audio": { # An audio content block.
+                    "channels": 42, # The number of audio channels.
+                    "data": "A String", # The audio content.
+                    "mimeTypeString": "A String", # Flexible MIME type string of the audio, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                    "sampleRate": 42, # The sample rate of the audio.
+                    "uri": "A String", # The URI of the audio.
+                  },
+                  "document": { # A document content block.
+                    "data": "A String", # The document content.
+                    "mimeTypeString": "A String", # Flexible MIME type string of the document, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                    "uri": "A String", # The URI of the document.
+                  },
+                  "image": { # An image content block.
+                    "data": "A String", # The image content.
+                    "mimeTypeString": "A String", # Flexible MIME type string of the image, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                    "resolution": "A String", # The resolution of the media.
+                    "uri": "A String", # The URI of the image.
+                  },
+                  "text": { # A text content block.
+                    "annotations": [ # Citation information for model-generated content.
+                      { # Citation information for model-generated content.
+                        "endIndex": 42, # End of the attributed segment, exclusive.
+                        "fileCitation": { # A file citation annotation. # A file citation annotation.
+                          "customMetadata": { # User provided metadata about the retrieved context.
+                            "a_key": "", # Properties of the object.
+                          },
+                          "documentUri": "A String", # The URI of the file.
+                          "fileName": "A String", # The name of the file.
+                          "mediaId": "A String", # Media ID in-case of image citations, if applicable.
+                          "pageNumber": 42, # Page number of the cited document, if applicable.
+                          "source": "A String", # Source attributed for a portion of the text.
+                        },
+                        "placeCitation": { # A place citation annotation. # A place citation annotation.
+                          "name": "A String", # Title of the place.
+                          "placeId": "A String", # The ID of the place, in `places/{place_id}` format.
+                          "reviewSnippets": [ # Snippets of reviews that are used to generate answers about the features of a given place in Google Maps.
+                            { # Encapsulates a snippet of a user review that answers a question about the features of a specific place in Google Maps.
+                              "reviewId": "A String", # The ID of the review snippet.
+                              "title": "A String", # Title of the review.
+                              "url": "A String", # A link that corresponds to the user review on Google Maps.
+                            },
+                          ],
+                          "url": "A String", # URI reference of the place.
+                        },
+                        "speechMetadata": { # Speech annotation for text content. # Speech annotation for text content.
+                          "speaker": "A String", # The speaker to associate with this turn.
+                          "style": "A String", # Style instruction for the speech synthesis.
+                        },
+                        "startIndex": 42, # Start of segment of the response that is attributed to this source. Index indicates the start of the segment, measured in bytes.
+                        "urlCitation": { # A URL citation annotation. # NOTE: We use these instead of the Citation message for historical reasons. A URL citation annotation.
+                          "title": "A String", # The title of the URL.
+                          "url": "A String", # The URL.
+                        },
+                        "wordInfo": { # Word-level ASR annotation for transcription output. Carries the word text, optional timing, and optional speaker attribution. # Word-level ASR annotation with timing and speaker info.
+                          "endOffset": "A String", # End offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                          "speaker": "A String", # Optional. Speaker label for this word (e.g. "spk_1", "spk_2"). Present when diarization_mode is set in TranscriptionConfig.
+                          "startOffset": "A String", # Start offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                          "text": "A String", # The transcribed word.
+                        },
+                      },
+                    ],
+                    "text": "A String", # Required. The text content.
+                  },
+                  "video": { # A video content block.
+                    "data": "A String", # The video content.
+                    "mimeTypeString": "A String", # Flexible MIME type string of the video, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                    "name": "A String", # A user-defined name for this content block. Can be referenced by the model in the final response.
+                    "processingConfig": {
+                      "static": {
+                        "endOffset": "A String", # Optional. Segment end time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "30s". Must be non-negative and greater than `start_offset` if `start_offset` is set.
+                        "fps": 3.14, # Optional. Video frame-rate sampling density.
+                        "startOffset": "A String", # Optional. Segment start time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "10.5s". Must be non-negative.
+                      },
+                    },
+                    "processingType": "A String",
+                    "resolution": "A String", # The resolution of the media.
+                    "uri": "A String", # The URI of the video.
+                  },
+                },
+                "listValue": { # `ListValue` is a wrapper around a repeated field of values. # Represents a repeated `Value`.
+                  "values": [ # Repeated field of dynamically typed values.
+                    # Object with schema name: GenaiVertexV1Value
+                  ],
+                },
+                "nullValue": "A String", # Represents a null value.
+                "numberValue": 3.14, # Represents a double value.
+                "stringValue": "A String", # Represents a string value.
+                "structValue": # Object with schema name: GenaiVertexV1Struct # Represents a structured value.
+              },
+            },
+          ],
+        },
+      },
+      "video": { # Configuration for video output format.
+        "aspectRatio": "A String", # The aspect ratio for the video output.
+        "delivery": "A String", # The delivery mode for the video output.
+        "duration": "A String", # The duration for the video output.
+        "gcsUri": "A String", # The Cloud Storage URI to store the video output. Required for Vertex if delivery mode is URI.
+        "resolution": "A String", # The video output resolution. Defaults to 720p.
+      },
+    },
+    "safetySettings": [ # Safety settings for the interaction.
+      { # A safety setting that affects the safety-blocking behavior. A SafetySetting consists of a harm category and a threshold for that category.
+        "method": "A String", # Optional. The method for blocking content. If not specified, the default behavior is to use the probability score.
+        "threshold": "A String", # Required. The threshold for blocking content. If the harm probability exceeds this threshold, the content will be blocked.
+        "type": "A String", # Required. The type of harm category to be blocked.
+      },
+    ],
+    "serviceTier": "A String", # The service tier for the interaction.
+    "status": "A String", # Required. Output only. The status of the interaction.
+    "stepList": { # A list of Steps. # Input only. The steps for the interaction.
+      "steps": [ # The steps of the list.
+        { # A step in the interaction.
+          "modelOutput": { # Output generated by the model.
+            "content": [
+              { # The content of the response.
+                "audio": { # An audio content block.
+                  "channels": 42, # The number of audio channels.
+                  "data": "A String", # The audio content.
+                  "mimeTypeString": "A String", # Flexible MIME type string of the audio, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                  "sampleRate": 42, # The sample rate of the audio.
+                  "uri": "A String", # The URI of the audio.
+                },
+                "document": { # A document content block.
+                  "data": "A String", # The document content.
+                  "mimeTypeString": "A String", # Flexible MIME type string of the document, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                  "uri": "A String", # The URI of the document.
+                },
+                "image": { # An image content block.
+                  "data": "A String", # The image content.
+                  "mimeTypeString": "A String", # Flexible MIME type string of the image, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                  "resolution": "A String", # The resolution of the media.
+                  "uri": "A String", # The URI of the image.
+                },
+                "text": { # A text content block.
+                  "annotations": [ # Citation information for model-generated content.
+                    { # Citation information for model-generated content.
+                      "endIndex": 42, # End of the attributed segment, exclusive.
+                      "fileCitation": { # A file citation annotation. # A file citation annotation.
+                        "customMetadata": { # User provided metadata about the retrieved context.
+                          "a_key": "", # Properties of the object.
+                        },
+                        "documentUri": "A String", # The URI of the file.
+                        "fileName": "A String", # The name of the file.
+                        "mediaId": "A String", # Media ID in-case of image citations, if applicable.
+                        "pageNumber": 42, # Page number of the cited document, if applicable.
+                        "source": "A String", # Source attributed for a portion of the text.
+                      },
+                      "placeCitation": { # A place citation annotation. # A place citation annotation.
+                        "name": "A String", # Title of the place.
+                        "placeId": "A String", # The ID of the place, in `places/{place_id}` format.
+                        "reviewSnippets": [ # Snippets of reviews that are used to generate answers about the features of a given place in Google Maps.
+                          { # Encapsulates a snippet of a user review that answers a question about the features of a specific place in Google Maps.
+                            "reviewId": "A String", # The ID of the review snippet.
+                            "title": "A String", # Title of the review.
+                            "url": "A String", # A link that corresponds to the user review on Google Maps.
+                          },
+                        ],
+                        "url": "A String", # URI reference of the place.
+                      },
+                      "speechMetadata": { # Speech annotation for text content. # Speech annotation for text content.
+                        "speaker": "A String", # The speaker to associate with this turn.
+                        "style": "A String", # Style instruction for the speech synthesis.
+                      },
+                      "startIndex": 42, # Start of segment of the response that is attributed to this source. Index indicates the start of the segment, measured in bytes.
+                      "urlCitation": { # A URL citation annotation. # NOTE: We use these instead of the Citation message for historical reasons. A URL citation annotation.
+                        "title": "A String", # The title of the URL.
+                        "url": "A String", # The URL.
+                      },
+                      "wordInfo": { # Word-level ASR annotation for transcription output. Carries the word text, optional timing, and optional speaker attribution. # Word-level ASR annotation with timing and speaker info.
+                        "endOffset": "A String", # End offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                        "speaker": "A String", # Optional. Speaker label for this word (e.g. "spk_1", "spk_2"). Present when diarization_mode is set in TranscriptionConfig.
+                        "startOffset": "A String", # Start offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                        "text": "A String", # The transcribed word.
+                      },
+                    },
+                  ],
+                  "text": "A String", # Required. The text content.
+                },
+                "video": { # A video content block.
+                  "data": "A String", # The video content.
+                  "mimeTypeString": "A String", # Flexible MIME type string of the video, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                  "name": "A String", # A user-defined name for this content block. Can be referenced by the model in the final response.
+                  "processingConfig": {
+                    "static": {
+                      "endOffset": "A String", # Optional. Segment end time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "30s". Must be non-negative and greater than `start_offset` if `start_offset` is set.
+                      "fps": 3.14, # Optional. Video frame-rate sampling density.
+                      "startOffset": "A String", # Optional. Segment start time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "10.5s". Must be non-negative.
+                    },
+                  },
+                  "processingType": "A String",
+                  "resolution": "A String", # The resolution of the media.
+                  "uri": "A String", # The URI of the video.
+                },
+              },
+            ],
+            "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.
+            },
+          },
+          "thought": { # A thought step.
+            "signature": "A String", # A signature hash for backend validation.
+            "summary": [ # A summary of the thought.
+              { # The content of the response.
+                "audio": { # An audio content block.
+                  "channels": 42, # The number of audio channels.
+                  "data": "A String", # The audio content.
+                  "mimeTypeString": "A String", # Flexible MIME type string of the audio, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                  "sampleRate": 42, # The sample rate of the audio.
+                  "uri": "A String", # The URI of the audio.
+                },
+                "document": { # A document content block.
+                  "data": "A String", # The document content.
+                  "mimeTypeString": "A String", # Flexible MIME type string of the document, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                  "uri": "A String", # The URI of the document.
+                },
+                "image": { # An image content block.
+                  "data": "A String", # The image content.
+                  "mimeTypeString": "A String", # Flexible MIME type string of the image, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                  "resolution": "A String", # The resolution of the media.
+                  "uri": "A String", # The URI of the image.
+                },
+                "text": { # A text content block.
+                  "annotations": [ # Citation information for model-generated content.
+                    { # Citation information for model-generated content.
+                      "endIndex": 42, # End of the attributed segment, exclusive.
+                      "fileCitation": { # A file citation annotation. # A file citation annotation.
+                        "customMetadata": { # User provided metadata about the retrieved context.
+                          "a_key": "", # Properties of the object.
+                        },
+                        "documentUri": "A String", # The URI of the file.
+                        "fileName": "A String", # The name of the file.
+                        "mediaId": "A String", # Media ID in-case of image citations, if applicable.
+                        "pageNumber": 42, # Page number of the cited document, if applicable.
+                        "source": "A String", # Source attributed for a portion of the text.
+                      },
+                      "placeCitation": { # A place citation annotation. # A place citation annotation.
+                        "name": "A String", # Title of the place.
+                        "placeId": "A String", # The ID of the place, in `places/{place_id}` format.
+                        "reviewSnippets": [ # Snippets of reviews that are used to generate answers about the features of a given place in Google Maps.
+                          { # Encapsulates a snippet of a user review that answers a question about the features of a specific place in Google Maps.
+                            "reviewId": "A String", # The ID of the review snippet.
+                            "title": "A String", # Title of the review.
+                            "url": "A String", # A link that corresponds to the user review on Google Maps.
+                          },
+                        ],
+                        "url": "A String", # URI reference of the place.
+                      },
+                      "speechMetadata": { # Speech annotation for text content. # Speech annotation for text content.
+                        "speaker": "A String", # The speaker to associate with this turn.
+                        "style": "A String", # Style instruction for the speech synthesis.
+                      },
+                      "startIndex": 42, # Start of segment of the response that is attributed to this source. Index indicates the start of the segment, measured in bytes.
+                      "urlCitation": { # A URL citation annotation. # NOTE: We use these instead of the Citation message for historical reasons. A URL citation annotation.
+                        "title": "A String", # The title of the URL.
+                        "url": "A String", # The URL.
+                      },
+                      "wordInfo": { # Word-level ASR annotation for transcription output. Carries the word text, optional timing, and optional speaker attribution. # Word-level ASR annotation with timing and speaker info.
+                        "endOffset": "A String", # End offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                        "speaker": "A String", # Optional. Speaker label for this word (e.g. "spk_1", "spk_2"). Present when diarization_mode is set in TranscriptionConfig.
+                        "startOffset": "A String", # Start offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                        "text": "A String", # The transcribed word.
+                      },
+                    },
+                  ],
+                  "text": "A String", # Required. The text content.
+                },
+                "video": { # A video content block.
+                  "data": "A String", # The video content.
+                  "mimeTypeString": "A String", # Flexible MIME type string of the video, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                  "name": "A String", # A user-defined name for this content block. Can be referenced by the model in the final response.
+                  "processingConfig": {
+                    "static": {
+                      "endOffset": "A String", # Optional. Segment end time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "30s". Must be non-negative and greater than `start_offset` if `start_offset` is set.
+                      "fps": 3.14, # Optional. Video frame-rate sampling density.
+                      "startOffset": "A String", # Optional. Segment start time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "10.5s". Must be non-negative.
+                    },
+                  },
+                  "processingType": "A String",
+                  "resolution": "A String", # The resolution of the media.
+                  "uri": "A String", # The URI of the video.
+                },
+              },
+            ],
+          },
+          "toolCall": { # Tool call step.
+            "codeExecutionCall": { # Code execution call step.
+              "arguments": { # The arguments to pass to the code execution. # Required. The arguments to pass to the code execution.
+                "code": "A String", # The code to be executed.
+                "language": "A String", # Programming language of the `code`.
+              },
+            },
+            "fileSearchCall": { # File Search call step.
+            },
+            "functionCall": { # A function tool call step.
+              "arguments": { # `Struct` represents a structured data value, consisting of fields which map to dynamically typed values. # Required. The arguments to pass to the function.
+                "fields": [ # Dynamically typed fields. List instead of map because LLMs are sensitive to ordering, and we want to give users full control.
+                  { # Represents a single field in a struct.
+                    "name": "A String",
+                    "value": { # `Value` represents a dynamically typed value which can be either null, a number, a string, a boolean, a recursive struct value, or a list of values. A producer of value is expected to set one of these variants. Absence of any variant indicates an error.
+                      "boolValue": True or False, # Represents a boolean value.
+                      "contentValue": { # The content of the response. # Represents rich content (text, image, etc.).
+                        "audio": { # An audio content block.
+                          "channels": 42, # The number of audio channels.
+                          "data": "A String", # The audio content.
+                          "mimeTypeString": "A String", # Flexible MIME type string of the audio, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                          "sampleRate": 42, # The sample rate of the audio.
+                          "uri": "A String", # The URI of the audio.
+                        },
+                        "document": { # A document content block.
+                          "data": "A String", # The document content.
+                          "mimeTypeString": "A String", # Flexible MIME type string of the document, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                          "uri": "A String", # The URI of the document.
+                        },
+                        "image": { # An image content block.
+                          "data": "A String", # The image content.
+                          "mimeTypeString": "A String", # Flexible MIME type string of the image, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                          "resolution": "A String", # The resolution of the media.
+                          "uri": "A String", # The URI of the image.
+                        },
+                        "text": { # A text content block.
+                          "annotations": [ # Citation information for model-generated content.
+                            { # Citation information for model-generated content.
+                              "endIndex": 42, # End of the attributed segment, exclusive.
+                              "fileCitation": { # A file citation annotation. # A file citation annotation.
+                                "customMetadata": { # User provided metadata about the retrieved context.
+                                  "a_key": "", # Properties of the object.
+                                },
+                                "documentUri": "A String", # The URI of the file.
+                                "fileName": "A String", # The name of the file.
+                                "mediaId": "A String", # Media ID in-case of image citations, if applicable.
+                                "pageNumber": 42, # Page number of the cited document, if applicable.
+                                "source": "A String", # Source attributed for a portion of the text.
+                              },
+                              "placeCitation": { # A place citation annotation. # A place citation annotation.
+                                "name": "A String", # Title of the place.
+                                "placeId": "A String", # The ID of the place, in `places/{place_id}` format.
+                                "reviewSnippets": [ # Snippets of reviews that are used to generate answers about the features of a given place in Google Maps.
+                                  { # Encapsulates a snippet of a user review that answers a question about the features of a specific place in Google Maps.
+                                    "reviewId": "A String", # The ID of the review snippet.
+                                    "title": "A String", # Title of the review.
+                                    "url": "A String", # A link that corresponds to the user review on Google Maps.
+                                  },
+                                ],
+                                "url": "A String", # URI reference of the place.
+                              },
+                              "speechMetadata": { # Speech annotation for text content. # Speech annotation for text content.
+                                "speaker": "A String", # The speaker to associate with this turn.
+                                "style": "A String", # Style instruction for the speech synthesis.
+                              },
+                              "startIndex": 42, # Start of segment of the response that is attributed to this source. Index indicates the start of the segment, measured in bytes.
+                              "urlCitation": { # A URL citation annotation. # NOTE: We use these instead of the Citation message for historical reasons. A URL citation annotation.
+                                "title": "A String", # The title of the URL.
+                                "url": "A String", # The URL.
+                              },
+                              "wordInfo": { # Word-level ASR annotation for transcription output. Carries the word text, optional timing, and optional speaker attribution. # Word-level ASR annotation with timing and speaker info.
+                                "endOffset": "A String", # End offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                                "speaker": "A String", # Optional. Speaker label for this word (e.g. "spk_1", "spk_2"). Present when diarization_mode is set in TranscriptionConfig.
+                                "startOffset": "A String", # Start offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                                "text": "A String", # The transcribed word.
+                              },
+                            },
+                          ],
+                          "text": "A String", # Required. The text content.
+                        },
+                        "video": { # A video content block.
+                          "data": "A String", # The video content.
+                          "mimeTypeString": "A String", # Flexible MIME type string of the video, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                          "name": "A String", # A user-defined name for this content block. Can be referenced by the model in the final response.
+                          "processingConfig": {
+                            "static": {
+                              "endOffset": "A String", # Optional. Segment end time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "30s". Must be non-negative and greater than `start_offset` if `start_offset` is set.
+                              "fps": 3.14, # Optional. Video frame-rate sampling density.
+                              "startOffset": "A String", # Optional. Segment start time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "10.5s". Must be non-negative.
+                            },
+                          },
+                          "processingType": "A String",
+                          "resolution": "A String", # The resolution of the media.
+                          "uri": "A String", # The URI of the video.
+                        },
+                      },
+                      "listValue": { # `ListValue` is a wrapper around a repeated field of values. # Represents a repeated `Value`.
+                        "values": [ # Repeated field of dynamically typed values.
+                          # Object with schema name: GenaiVertexV1Value
+                        ],
+                      },
+                      "nullValue": "A String", # Represents a null value.
+                      "numberValue": 3.14, # Represents a double value.
+                      "stringValue": "A String", # Represents a string value.
+                      "structValue": # Object with schema name: GenaiVertexV1Struct # Represents a structured value.
+                    },
+                  },
+                ],
+              },
+              "name": "A String", # Required. The name of the tool to call.
+            },
+            "googleMapsCall": { # Google Maps call step.
+              "arguments": { # The arguments to pass to the Google Maps tool. # The arguments to pass to the Google Maps tool.
+                "queries": [ # The queries to be executed.
+                  "A String",
+                ],
+              },
+            },
+            "googleSearchCall": { # Google Search call step.
+              "arguments": { # The arguments to pass to Google Search. # Required. The arguments to pass to Google Search.
+                "queries": [ # Web search queries for the following-up web search.
+                  "A String",
+                ],
+              },
+              "searchType": "A String", # The type of search grounding enabled.
+            },
+            "id": "A String", # Required. A unique ID for this specific tool call.
+            "processingCall": { # A server-initiated processing step for media analysis (e.g. video understanding).
+            },
+            "retrievalCall": { # Retrieval call step. Used by Vertex Retrieval tools such as Parallel AI, Exa AI, Vertex AI Search, etc. RetrievalType decides which tool is used.
+              "arguments": { # The arguments to pass to Retrieval tools. # Required. The arguments to pass to the retrieval tool.
+                "queries": [ # Queries for Retrieval information.
+                  "A String",
+                ],
+              },
+              "retrievalType": "A String", # The type of retrieval tools.
+            },
+            "signature": "A String", # A signature hash for backend validation.
+            "urlContextCall": { # URL context call step.
+              "arguments": { # The arguments to pass to the URL context. # Required. The arguments to pass to the URL context.
+                "urls": [ # The URLs to fetch.
+                  "A String",
+                ],
+              },
+            },
+          },
+          "toolResult": { # Tool result step.
+            "callId": "A String", # Required. ID to match the ID from the function call block.
+            "codeExecutionResult": { # Code execution result step.
+              "isError": True or False, # Whether the code execution resulted in an error.
+              "result": "A String", # Required. The output of the code execution.
+            },
+            "fileSearchResult": { # File Search result step.
+            },
+            "functionResult": { # Result of a function tool call.
+              "isError": True or False, # Whether the tool call resulted in an error.
+              "name": "A String", # The name of the tool that was called.
+              "result": { # `Value` represents a dynamically typed value which can be either null, a number, a string, a boolean, a recursive struct value, or a list of values. A producer of value is expected to set one of these variants. Absence of any variant indicates an error. # Required. The result of the tool call.
+                "boolValue": True or False, # Represents a boolean value.
+                "contentValue": { # The content of the response. # Represents rich content (text, image, etc.).
+                  "audio": { # An audio content block.
+                    "channels": 42, # The number of audio channels.
+                    "data": "A String", # The audio content.
+                    "mimeTypeString": "A String", # Flexible MIME type string of the audio, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                    "sampleRate": 42, # The sample rate of the audio.
+                    "uri": "A String", # The URI of the audio.
+                  },
+                  "document": { # A document content block.
+                    "data": "A String", # The document content.
+                    "mimeTypeString": "A String", # Flexible MIME type string of the document, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                    "uri": "A String", # The URI of the document.
+                  },
+                  "image": { # An image content block.
+                    "data": "A String", # The image content.
+                    "mimeTypeString": "A String", # Flexible MIME type string of the image, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                    "resolution": "A String", # The resolution of the media.
+                    "uri": "A String", # The URI of the image.
+                  },
+                  "text": { # A text content block.
+                    "annotations": [ # Citation information for model-generated content.
+                      { # Citation information for model-generated content.
+                        "endIndex": 42, # End of the attributed segment, exclusive.
+                        "fileCitation": { # A file citation annotation. # A file citation annotation.
+                          "customMetadata": { # User provided metadata about the retrieved context.
+                            "a_key": "", # Properties of the object.
+                          },
+                          "documentUri": "A String", # The URI of the file.
+                          "fileName": "A String", # The name of the file.
+                          "mediaId": "A String", # Media ID in-case of image citations, if applicable.
+                          "pageNumber": 42, # Page number of the cited document, if applicable.
+                          "source": "A String", # Source attributed for a portion of the text.
+                        },
+                        "placeCitation": { # A place citation annotation. # A place citation annotation.
+                          "name": "A String", # Title of the place.
+                          "placeId": "A String", # The ID of the place, in `places/{place_id}` format.
+                          "reviewSnippets": [ # Snippets of reviews that are used to generate answers about the features of a given place in Google Maps.
+                            { # Encapsulates a snippet of a user review that answers a question about the features of a specific place in Google Maps.
+                              "reviewId": "A String", # The ID of the review snippet.
+                              "title": "A String", # Title of the review.
+                              "url": "A String", # A link that corresponds to the user review on Google Maps.
+                            },
+                          ],
+                          "url": "A String", # URI reference of the place.
+                        },
+                        "speechMetadata": { # Speech annotation for text content. # Speech annotation for text content.
+                          "speaker": "A String", # The speaker to associate with this turn.
+                          "style": "A String", # Style instruction for the speech synthesis.
+                        },
+                        "startIndex": 42, # Start of segment of the response that is attributed to this source. Index indicates the start of the segment, measured in bytes.
+                        "urlCitation": { # A URL citation annotation. # NOTE: We use these instead of the Citation message for historical reasons. A URL citation annotation.
+                          "title": "A String", # The title of the URL.
+                          "url": "A String", # The URL.
+                        },
+                        "wordInfo": { # Word-level ASR annotation for transcription output. Carries the word text, optional timing, and optional speaker attribution. # Word-level ASR annotation with timing and speaker info.
+                          "endOffset": "A String", # End offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                          "speaker": "A String", # Optional. Speaker label for this word (e.g. "spk_1", "spk_2"). Present when diarization_mode is set in TranscriptionConfig.
+                          "startOffset": "A String", # Start offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                          "text": "A String", # The transcribed word.
+                        },
+                      },
+                    ],
+                    "text": "A String", # Required. The text content.
+                  },
+                  "video": { # A video content block.
+                    "data": "A String", # The video content.
+                    "mimeTypeString": "A String", # Flexible MIME type string of the video, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                    "name": "A String", # A user-defined name for this content block. Can be referenced by the model in the final response.
+                    "processingConfig": {
+                      "static": {
+                        "endOffset": "A String", # Optional. Segment end time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "30s". Must be non-negative and greater than `start_offset` if `start_offset` is set.
+                        "fps": 3.14, # Optional. Video frame-rate sampling density.
+                        "startOffset": "A String", # Optional. Segment start time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "10.5s". Must be non-negative.
+                      },
+                    },
+                    "processingType": "A String",
+                    "resolution": "A String", # The resolution of the media.
+                    "uri": "A String", # The URI of the video.
+                  },
+                },
+                "listValue": { # `ListValue` is a wrapper around a repeated field of values. # Represents a repeated `Value`.
+                  "values": [ # Repeated field of dynamically typed values.
+                    # Object with schema name: GenaiVertexV1Value
+                  ],
+                },
+                "nullValue": "A String", # Represents a null value.
+                "numberValue": 3.14, # Represents a double value.
+                "stringValue": "A String", # Represents a string value.
+                "structValue": # Object with schema name: GenaiVertexV1Struct # Represents a structured value.
+              },
+            },
+            "googleMapsResult": { # Google Maps result step.
+              "result": [
+                { # The result of the Google Maps.
+                  "places": [
+                    {
+                      "name": "A String",
+                      "placeId": "A String",
+                      "reviewSnippets": [
+                        { # Encapsulates a snippet of a user review that answers a question about the features of a specific place in Google Maps.
+                          "reviewId": "A String", # The ID of the review snippet.
+                          "title": "A String", # Title of the review.
+                          "url": "A String", # A link that corresponds to the user review on Google Maps.
+                        },
+                      ],
+                      "url": "A String",
+                    },
+                  ],
+                  "widgetContextToken": "A String",
+                },
+              ],
+            },
+            "googleSearchResult": { # Google Search result step.
+              "isError": True or False, # Whether the Google Search resulted in an error.
+              "result": [ # Required. The results of the Google Search.
+                { # The result of the Google Search.
+                  "searchSuggestions": "A String", # Web content snippet that can be embedded in a web page or an app webview.
+                },
+              ],
+            },
+            "processingResult": { # The result of a server-initiated media processing step.
+            },
+            "retrievalResult": { # Vertex Retrieval result step. Used by Vertex Retrieval tools such as Parallel AI, Exa AI, Vertex AI Search, etc.
+              "isError": True or False, # Whether the retrieval resulted in an error.
+            },
+            "signature": "A String", # A signature hash for backend validation.
+            "urlContextResult": { # URL context result step.
+              "isError": True or False, # Whether the URL context resulted in an error.
+              "result": [ # Required. The results of the URL context.
+                { # The result of the URL context.
+                  "status": "A String", # The status of the URL retrieval.
+                  "url": "A String", # The URL that was fetched.
+                },
+              ],
+            },
+          },
+          "userInput": { # Input provided by the user. # DO NOT USE -- These are for 3P JSON only
+            "contentList": { # A list of Content. # The content of the step. An array of Content objects.
+              "contents": [ # The contents of the list.
+                { # The content of the response.
+                  "audio": { # An audio content block.
+                    "channels": 42, # The number of audio channels.
+                    "data": "A String", # The audio content.
+                    "mimeTypeString": "A String", # Flexible MIME type string of the audio, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                    "sampleRate": 42, # The sample rate of the audio.
+                    "uri": "A String", # The URI of the audio.
+                  },
+                  "document": { # A document content block.
+                    "data": "A String", # The document content.
+                    "mimeTypeString": "A String", # Flexible MIME type string of the document, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                    "uri": "A String", # The URI of the document.
+                  },
+                  "image": { # An image content block.
+                    "data": "A String", # The image content.
+                    "mimeTypeString": "A String", # Flexible MIME type string of the image, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                    "resolution": "A String", # The resolution of the media.
+                    "uri": "A String", # The URI of the image.
+                  },
+                  "text": { # A text content block.
+                    "annotations": [ # Citation information for model-generated content.
+                      { # Citation information for model-generated content.
+                        "endIndex": 42, # End of the attributed segment, exclusive.
+                        "fileCitation": { # A file citation annotation. # A file citation annotation.
+                          "customMetadata": { # User provided metadata about the retrieved context.
+                            "a_key": "", # Properties of the object.
+                          },
+                          "documentUri": "A String", # The URI of the file.
+                          "fileName": "A String", # The name of the file.
+                          "mediaId": "A String", # Media ID in-case of image citations, if applicable.
+                          "pageNumber": 42, # Page number of the cited document, if applicable.
+                          "source": "A String", # Source attributed for a portion of the text.
+                        },
+                        "placeCitation": { # A place citation annotation. # A place citation annotation.
+                          "name": "A String", # Title of the place.
+                          "placeId": "A String", # The ID of the place, in `places/{place_id}` format.
+                          "reviewSnippets": [ # Snippets of reviews that are used to generate answers about the features of a given place in Google Maps.
+                            { # Encapsulates a snippet of a user review that answers a question about the features of a specific place in Google Maps.
+                              "reviewId": "A String", # The ID of the review snippet.
+                              "title": "A String", # Title of the review.
+                              "url": "A String", # A link that corresponds to the user review on Google Maps.
+                            },
+                          ],
+                          "url": "A String", # URI reference of the place.
+                        },
+                        "speechMetadata": { # Speech annotation for text content. # Speech annotation for text content.
+                          "speaker": "A String", # The speaker to associate with this turn.
+                          "style": "A String", # Style instruction for the speech synthesis.
+                        },
+                        "startIndex": 42, # Start of segment of the response that is attributed to this source. Index indicates the start of the segment, measured in bytes.
+                        "urlCitation": { # A URL citation annotation. # NOTE: We use these instead of the Citation message for historical reasons. A URL citation annotation.
+                          "title": "A String", # The title of the URL.
+                          "url": "A String", # The URL.
+                        },
+                        "wordInfo": { # Word-level ASR annotation for transcription output. Carries the word text, optional timing, and optional speaker attribution. # Word-level ASR annotation with timing and speaker info.
+                          "endOffset": "A String", # End offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                          "speaker": "A String", # Optional. Speaker label for this word (e.g. "spk_1", "spk_2"). Present when diarization_mode is set in TranscriptionConfig.
+                          "startOffset": "A String", # Start offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                          "text": "A String", # The transcribed word.
+                        },
+                      },
+                    ],
+                    "text": "A String", # Required. The text content.
+                  },
+                  "video": { # A video content block.
+                    "data": "A String", # The video content.
+                    "mimeTypeString": "A String", # Flexible MIME type string of the video, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                    "name": "A String", # A user-defined name for this content block. Can be referenced by the model in the final response.
+                    "processingConfig": {
+                      "static": {
+                        "endOffset": "A String", # Optional. Segment end time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "30s". Must be non-negative and greater than `start_offset` if `start_offset` is set.
+                        "fps": 3.14, # Optional. Video frame-rate sampling density.
+                        "startOffset": "A String", # Optional. Segment start time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "10.5s". Must be non-negative.
+                      },
+                    },
+                    "processingType": "A String",
+                    "resolution": "A String", # The resolution of the media.
+                    "uri": "A String", # The URI of the video.
+                  },
+                },
+              ],
+            },
+            "contentString": "A String", # The content of the step. A single string.
+          },
+        },
+      ],
+    },
+    "steps": [ # Required. Output only. The steps that make up the interaction, when included in the response.
+      { # A step in the interaction.
+        "modelOutput": { # Output generated by the model.
+          "content": [
+            { # The content of the response.
+              "audio": { # An audio content block.
+                "channels": 42, # The number of audio channels.
+                "data": "A String", # The audio content.
+                "mimeTypeString": "A String", # Flexible MIME type string of the audio, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                "sampleRate": 42, # The sample rate of the audio.
+                "uri": "A String", # The URI of the audio.
+              },
+              "document": { # A document content block.
+                "data": "A String", # The document content.
+                "mimeTypeString": "A String", # Flexible MIME type string of the document, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                "uri": "A String", # The URI of the document.
+              },
+              "image": { # An image content block.
+                "data": "A String", # The image content.
+                "mimeTypeString": "A String", # Flexible MIME type string of the image, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                "resolution": "A String", # The resolution of the media.
+                "uri": "A String", # The URI of the image.
+              },
+              "text": { # A text content block.
+                "annotations": [ # Citation information for model-generated content.
+                  { # Citation information for model-generated content.
+                    "endIndex": 42, # End of the attributed segment, exclusive.
+                    "fileCitation": { # A file citation annotation. # A file citation annotation.
+                      "customMetadata": { # User provided metadata about the retrieved context.
+                        "a_key": "", # Properties of the object.
+                      },
+                      "documentUri": "A String", # The URI of the file.
+                      "fileName": "A String", # The name of the file.
+                      "mediaId": "A String", # Media ID in-case of image citations, if applicable.
+                      "pageNumber": 42, # Page number of the cited document, if applicable.
+                      "source": "A String", # Source attributed for a portion of the text.
+                    },
+                    "placeCitation": { # A place citation annotation. # A place citation annotation.
+                      "name": "A String", # Title of the place.
+                      "placeId": "A String", # The ID of the place, in `places/{place_id}` format.
+                      "reviewSnippets": [ # Snippets of reviews that are used to generate answers about the features of a given place in Google Maps.
+                        { # Encapsulates a snippet of a user review that answers a question about the features of a specific place in Google Maps.
+                          "reviewId": "A String", # The ID of the review snippet.
+                          "title": "A String", # Title of the review.
+                          "url": "A String", # A link that corresponds to the user review on Google Maps.
+                        },
+                      ],
+                      "url": "A String", # URI reference of the place.
+                    },
+                    "speechMetadata": { # Speech annotation for text content. # Speech annotation for text content.
+                      "speaker": "A String", # The speaker to associate with this turn.
+                      "style": "A String", # Style instruction for the speech synthesis.
+                    },
+                    "startIndex": 42, # Start of segment of the response that is attributed to this source. Index indicates the start of the segment, measured in bytes.
+                    "urlCitation": { # A URL citation annotation. # NOTE: We use these instead of the Citation message for historical reasons. A URL citation annotation.
+                      "title": "A String", # The title of the URL.
+                      "url": "A String", # The URL.
+                    },
+                    "wordInfo": { # Word-level ASR annotation for transcription output. Carries the word text, optional timing, and optional speaker attribution. # Word-level ASR annotation with timing and speaker info.
+                      "endOffset": "A String", # End offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                      "speaker": "A String", # Optional. Speaker label for this word (e.g. "spk_1", "spk_2"). Present when diarization_mode is set in TranscriptionConfig.
+                      "startOffset": "A String", # Start offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                      "text": "A String", # The transcribed word.
+                    },
+                  },
+                ],
+                "text": "A String", # Required. The text content.
+              },
+              "video": { # A video content block.
+                "data": "A String", # The video content.
+                "mimeTypeString": "A String", # Flexible MIME type string of the video, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                "name": "A String", # A user-defined name for this content block. Can be referenced by the model in the final response.
+                "processingConfig": {
+                  "static": {
+                    "endOffset": "A String", # Optional. Segment end time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "30s". Must be non-negative and greater than `start_offset` if `start_offset` is set.
+                    "fps": 3.14, # Optional. Video frame-rate sampling density.
+                    "startOffset": "A String", # Optional. Segment start time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "10.5s". Must be non-negative.
+                  },
+                },
+                "processingType": "A String",
+                "resolution": "A String", # The resolution of the media.
+                "uri": "A String", # The URI of the video.
+              },
+            },
+          ],
+          "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.
+          },
+        },
+        "thought": { # A thought step.
+          "signature": "A String", # A signature hash for backend validation.
+          "summary": [ # A summary of the thought.
+            { # The content of the response.
+              "audio": { # An audio content block.
+                "channels": 42, # The number of audio channels.
+                "data": "A String", # The audio content.
+                "mimeTypeString": "A String", # Flexible MIME type string of the audio, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                "sampleRate": 42, # The sample rate of the audio.
+                "uri": "A String", # The URI of the audio.
+              },
+              "document": { # A document content block.
+                "data": "A String", # The document content.
+                "mimeTypeString": "A String", # Flexible MIME type string of the document, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                "uri": "A String", # The URI of the document.
+              },
+              "image": { # An image content block.
+                "data": "A String", # The image content.
+                "mimeTypeString": "A String", # Flexible MIME type string of the image, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                "resolution": "A String", # The resolution of the media.
+                "uri": "A String", # The URI of the image.
+              },
+              "text": { # A text content block.
+                "annotations": [ # Citation information for model-generated content.
+                  { # Citation information for model-generated content.
+                    "endIndex": 42, # End of the attributed segment, exclusive.
+                    "fileCitation": { # A file citation annotation. # A file citation annotation.
+                      "customMetadata": { # User provided metadata about the retrieved context.
+                        "a_key": "", # Properties of the object.
+                      },
+                      "documentUri": "A String", # The URI of the file.
+                      "fileName": "A String", # The name of the file.
+                      "mediaId": "A String", # Media ID in-case of image citations, if applicable.
+                      "pageNumber": 42, # Page number of the cited document, if applicable.
+                      "source": "A String", # Source attributed for a portion of the text.
+                    },
+                    "placeCitation": { # A place citation annotation. # A place citation annotation.
+                      "name": "A String", # Title of the place.
+                      "placeId": "A String", # The ID of the place, in `places/{place_id}` format.
+                      "reviewSnippets": [ # Snippets of reviews that are used to generate answers about the features of a given place in Google Maps.
+                        { # Encapsulates a snippet of a user review that answers a question about the features of a specific place in Google Maps.
+                          "reviewId": "A String", # The ID of the review snippet.
+                          "title": "A String", # Title of the review.
+                          "url": "A String", # A link that corresponds to the user review on Google Maps.
+                        },
+                      ],
+                      "url": "A String", # URI reference of the place.
+                    },
+                    "speechMetadata": { # Speech annotation for text content. # Speech annotation for text content.
+                      "speaker": "A String", # The speaker to associate with this turn.
+                      "style": "A String", # Style instruction for the speech synthesis.
+                    },
+                    "startIndex": 42, # Start of segment of the response that is attributed to this source. Index indicates the start of the segment, measured in bytes.
+                    "urlCitation": { # A URL citation annotation. # NOTE: We use these instead of the Citation message for historical reasons. A URL citation annotation.
+                      "title": "A String", # The title of the URL.
+                      "url": "A String", # The URL.
+                    },
+                    "wordInfo": { # Word-level ASR annotation for transcription output. Carries the word text, optional timing, and optional speaker attribution. # Word-level ASR annotation with timing and speaker info.
+                      "endOffset": "A String", # End offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                      "speaker": "A String", # Optional. Speaker label for this word (e.g. "spk_1", "spk_2"). Present when diarization_mode is set in TranscriptionConfig.
+                      "startOffset": "A String", # Start offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                      "text": "A String", # The transcribed word.
+                    },
+                  },
+                ],
+                "text": "A String", # Required. The text content.
+              },
+              "video": { # A video content block.
+                "data": "A String", # The video content.
+                "mimeTypeString": "A String", # Flexible MIME type string of the video, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                "name": "A String", # A user-defined name for this content block. Can be referenced by the model in the final response.
+                "processingConfig": {
+                  "static": {
+                    "endOffset": "A String", # Optional. Segment end time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "30s". Must be non-negative and greater than `start_offset` if `start_offset` is set.
+                    "fps": 3.14, # Optional. Video frame-rate sampling density.
+                    "startOffset": "A String", # Optional. Segment start time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "10.5s". Must be non-negative.
+                  },
+                },
+                "processingType": "A String",
+                "resolution": "A String", # The resolution of the media.
+                "uri": "A String", # The URI of the video.
+              },
+            },
+          ],
+        },
+        "toolCall": { # Tool call step.
+          "codeExecutionCall": { # Code execution call step.
+            "arguments": { # The arguments to pass to the code execution. # Required. The arguments to pass to the code execution.
+              "code": "A String", # The code to be executed.
+              "language": "A String", # Programming language of the `code`.
+            },
+          },
+          "fileSearchCall": { # File Search call step.
+          },
+          "functionCall": { # A function tool call step.
+            "arguments": { # `Struct` represents a structured data value, consisting of fields which map to dynamically typed values. # Required. The arguments to pass to the function.
+              "fields": [ # Dynamically typed fields. List instead of map because LLMs are sensitive to ordering, and we want to give users full control.
+                { # Represents a single field in a struct.
+                  "name": "A String",
+                  "value": { # `Value` represents a dynamically typed value which can be either null, a number, a string, a boolean, a recursive struct value, or a list of values. A producer of value is expected to set one of these variants. Absence of any variant indicates an error.
+                    "boolValue": True or False, # Represents a boolean value.
+                    "contentValue": { # The content of the response. # Represents rich content (text, image, etc.).
+                      "audio": { # An audio content block.
+                        "channels": 42, # The number of audio channels.
+                        "data": "A String", # The audio content.
+                        "mimeTypeString": "A String", # Flexible MIME type string of the audio, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                        "sampleRate": 42, # The sample rate of the audio.
+                        "uri": "A String", # The URI of the audio.
+                      },
+                      "document": { # A document content block.
+                        "data": "A String", # The document content.
+                        "mimeTypeString": "A String", # Flexible MIME type string of the document, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                        "uri": "A String", # The URI of the document.
+                      },
+                      "image": { # An image content block.
+                        "data": "A String", # The image content.
+                        "mimeTypeString": "A String", # Flexible MIME type string of the image, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                        "resolution": "A String", # The resolution of the media.
+                        "uri": "A String", # The URI of the image.
+                      },
+                      "text": { # A text content block.
+                        "annotations": [ # Citation information for model-generated content.
+                          { # Citation information for model-generated content.
+                            "endIndex": 42, # End of the attributed segment, exclusive.
+                            "fileCitation": { # A file citation annotation. # A file citation annotation.
+                              "customMetadata": { # User provided metadata about the retrieved context.
+                                "a_key": "", # Properties of the object.
+                              },
+                              "documentUri": "A String", # The URI of the file.
+                              "fileName": "A String", # The name of the file.
+                              "mediaId": "A String", # Media ID in-case of image citations, if applicable.
+                              "pageNumber": 42, # Page number of the cited document, if applicable.
+                              "source": "A String", # Source attributed for a portion of the text.
+                            },
+                            "placeCitation": { # A place citation annotation. # A place citation annotation.
+                              "name": "A String", # Title of the place.
+                              "placeId": "A String", # The ID of the place, in `places/{place_id}` format.
+                              "reviewSnippets": [ # Snippets of reviews that are used to generate answers about the features of a given place in Google Maps.
+                                { # Encapsulates a snippet of a user review that answers a question about the features of a specific place in Google Maps.
+                                  "reviewId": "A String", # The ID of the review snippet.
+                                  "title": "A String", # Title of the review.
+                                  "url": "A String", # A link that corresponds to the user review on Google Maps.
+                                },
+                              ],
+                              "url": "A String", # URI reference of the place.
+                            },
+                            "speechMetadata": { # Speech annotation for text content. # Speech annotation for text content.
+                              "speaker": "A String", # The speaker to associate with this turn.
+                              "style": "A String", # Style instruction for the speech synthesis.
+                            },
+                            "startIndex": 42, # Start of segment of the response that is attributed to this source. Index indicates the start of the segment, measured in bytes.
+                            "urlCitation": { # A URL citation annotation. # NOTE: We use these instead of the Citation message for historical reasons. A URL citation annotation.
+                              "title": "A String", # The title of the URL.
+                              "url": "A String", # The URL.
+                            },
+                            "wordInfo": { # Word-level ASR annotation for transcription output. Carries the word text, optional timing, and optional speaker attribution. # Word-level ASR annotation with timing and speaker info.
+                              "endOffset": "A String", # End offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                              "speaker": "A String", # Optional. Speaker label for this word (e.g. "spk_1", "spk_2"). Present when diarization_mode is set in TranscriptionConfig.
+                              "startOffset": "A String", # Start offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                              "text": "A String", # The transcribed word.
+                            },
+                          },
+                        ],
+                        "text": "A String", # Required. The text content.
+                      },
+                      "video": { # A video content block.
+                        "data": "A String", # The video content.
+                        "mimeTypeString": "A String", # Flexible MIME type string of the video, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                        "name": "A String", # A user-defined name for this content block. Can be referenced by the model in the final response.
+                        "processingConfig": {
+                          "static": {
+                            "endOffset": "A String", # Optional. Segment end time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "30s". Must be non-negative and greater than `start_offset` if `start_offset` is set.
+                            "fps": 3.14, # Optional. Video frame-rate sampling density.
+                            "startOffset": "A String", # Optional. Segment start time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "10.5s". Must be non-negative.
+                          },
+                        },
+                        "processingType": "A String",
+                        "resolution": "A String", # The resolution of the media.
+                        "uri": "A String", # The URI of the video.
+                      },
+                    },
+                    "listValue": { # `ListValue` is a wrapper around a repeated field of values. # Represents a repeated `Value`.
+                      "values": [ # Repeated field of dynamically typed values.
+                        # Object with schema name: GenaiVertexV1Value
+                      ],
+                    },
+                    "nullValue": "A String", # Represents a null value.
+                    "numberValue": 3.14, # Represents a double value.
+                    "stringValue": "A String", # Represents a string value.
+                    "structValue": # Object with schema name: GenaiVertexV1Struct # Represents a structured value.
+                  },
+                },
+              ],
+            },
+            "name": "A String", # Required. The name of the tool to call.
+          },
+          "googleMapsCall": { # Google Maps call step.
+            "arguments": { # The arguments to pass to the Google Maps tool. # The arguments to pass to the Google Maps tool.
+              "queries": [ # The queries to be executed.
+                "A String",
+              ],
+            },
+          },
+          "googleSearchCall": { # Google Search call step.
+            "arguments": { # The arguments to pass to Google Search. # Required. The arguments to pass to Google Search.
+              "queries": [ # Web search queries for the following-up web search.
+                "A String",
+              ],
+            },
+            "searchType": "A String", # The type of search grounding enabled.
+          },
+          "id": "A String", # Required. A unique ID for this specific tool call.
+          "processingCall": { # A server-initiated processing step for media analysis (e.g. video understanding).
+          },
+          "retrievalCall": { # Retrieval call step. Used by Vertex Retrieval tools such as Parallel AI, Exa AI, Vertex AI Search, etc. RetrievalType decides which tool is used.
+            "arguments": { # The arguments to pass to Retrieval tools. # Required. The arguments to pass to the retrieval tool.
+              "queries": [ # Queries for Retrieval information.
+                "A String",
+              ],
+            },
+            "retrievalType": "A String", # The type of retrieval tools.
+          },
+          "signature": "A String", # A signature hash for backend validation.
+          "urlContextCall": { # URL context call step.
+            "arguments": { # The arguments to pass to the URL context. # Required. The arguments to pass to the URL context.
+              "urls": [ # The URLs to fetch.
+                "A String",
+              ],
+            },
+          },
+        },
+        "toolResult": { # Tool result step.
+          "callId": "A String", # Required. ID to match the ID from the function call block.
+          "codeExecutionResult": { # Code execution result step.
+            "isError": True or False, # Whether the code execution resulted in an error.
+            "result": "A String", # Required. The output of the code execution.
+          },
+          "fileSearchResult": { # File Search result step.
+          },
+          "functionResult": { # Result of a function tool call.
+            "isError": True or False, # Whether the tool call resulted in an error.
+            "name": "A String", # The name of the tool that was called.
+            "result": { # `Value` represents a dynamically typed value which can be either null, a number, a string, a boolean, a recursive struct value, or a list of values. A producer of value is expected to set one of these variants. Absence of any variant indicates an error. # Required. The result of the tool call.
+              "boolValue": True or False, # Represents a boolean value.
+              "contentValue": { # The content of the response. # Represents rich content (text, image, etc.).
+                "audio": { # An audio content block.
+                  "channels": 42, # The number of audio channels.
+                  "data": "A String", # The audio content.
+                  "mimeTypeString": "A String", # Flexible MIME type string of the audio, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                  "sampleRate": 42, # The sample rate of the audio.
+                  "uri": "A String", # The URI of the audio.
+                },
+                "document": { # A document content block.
+                  "data": "A String", # The document content.
+                  "mimeTypeString": "A String", # Flexible MIME type string of the document, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                  "uri": "A String", # The URI of the document.
+                },
+                "image": { # An image content block.
+                  "data": "A String", # The image content.
+                  "mimeTypeString": "A String", # Flexible MIME type string of the image, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                  "resolution": "A String", # The resolution of the media.
+                  "uri": "A String", # The URI of the image.
+                },
+                "text": { # A text content block.
+                  "annotations": [ # Citation information for model-generated content.
+                    { # Citation information for model-generated content.
+                      "endIndex": 42, # End of the attributed segment, exclusive.
+                      "fileCitation": { # A file citation annotation. # A file citation annotation.
+                        "customMetadata": { # User provided metadata about the retrieved context.
+                          "a_key": "", # Properties of the object.
+                        },
+                        "documentUri": "A String", # The URI of the file.
+                        "fileName": "A String", # The name of the file.
+                        "mediaId": "A String", # Media ID in-case of image citations, if applicable.
+                        "pageNumber": 42, # Page number of the cited document, if applicable.
+                        "source": "A String", # Source attributed for a portion of the text.
+                      },
+                      "placeCitation": { # A place citation annotation. # A place citation annotation.
+                        "name": "A String", # Title of the place.
+                        "placeId": "A String", # The ID of the place, in `places/{place_id}` format.
+                        "reviewSnippets": [ # Snippets of reviews that are used to generate answers about the features of a given place in Google Maps.
+                          { # Encapsulates a snippet of a user review that answers a question about the features of a specific place in Google Maps.
+                            "reviewId": "A String", # The ID of the review snippet.
+                            "title": "A String", # Title of the review.
+                            "url": "A String", # A link that corresponds to the user review on Google Maps.
+                          },
+                        ],
+                        "url": "A String", # URI reference of the place.
+                      },
+                      "speechMetadata": { # Speech annotation for text content. # Speech annotation for text content.
+                        "speaker": "A String", # The speaker to associate with this turn.
+                        "style": "A String", # Style instruction for the speech synthesis.
+                      },
+                      "startIndex": 42, # Start of segment of the response that is attributed to this source. Index indicates the start of the segment, measured in bytes.
+                      "urlCitation": { # A URL citation annotation. # NOTE: We use these instead of the Citation message for historical reasons. A URL citation annotation.
+                        "title": "A String", # The title of the URL.
+                        "url": "A String", # The URL.
+                      },
+                      "wordInfo": { # Word-level ASR annotation for transcription output. Carries the word text, optional timing, and optional speaker attribution. # Word-level ASR annotation with timing and speaker info.
+                        "endOffset": "A String", # End offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                        "speaker": "A String", # Optional. Speaker label for this word (e.g. "spk_1", "spk_2"). Present when diarization_mode is set in TranscriptionConfig.
+                        "startOffset": "A String", # Start offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                        "text": "A String", # The transcribed word.
+                      },
+                    },
+                  ],
+                  "text": "A String", # Required. The text content.
+                },
+                "video": { # A video content block.
+                  "data": "A String", # The video content.
+                  "mimeTypeString": "A String", # Flexible MIME type string of the video, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                  "name": "A String", # A user-defined name for this content block. Can be referenced by the model in the final response.
+                  "processingConfig": {
+                    "static": {
+                      "endOffset": "A String", # Optional. Segment end time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "30s". Must be non-negative and greater than `start_offset` if `start_offset` is set.
+                      "fps": 3.14, # Optional. Video frame-rate sampling density.
+                      "startOffset": "A String", # Optional. Segment start time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "10.5s". Must be non-negative.
+                    },
+                  },
+                  "processingType": "A String",
+                  "resolution": "A String", # The resolution of the media.
+                  "uri": "A String", # The URI of the video.
+                },
+              },
+              "listValue": { # `ListValue` is a wrapper around a repeated field of values. # Represents a repeated `Value`.
+                "values": [ # Repeated field of dynamically typed values.
+                  # Object with schema name: GenaiVertexV1Value
+                ],
+              },
+              "nullValue": "A String", # Represents a null value.
+              "numberValue": 3.14, # Represents a double value.
+              "stringValue": "A String", # Represents a string value.
+              "structValue": # Object with schema name: GenaiVertexV1Struct # Represents a structured value.
+            },
+          },
+          "googleMapsResult": { # Google Maps result step.
+            "result": [
+              { # The result of the Google Maps.
+                "places": [
+                  {
+                    "name": "A String",
+                    "placeId": "A String",
+                    "reviewSnippets": [
+                      { # Encapsulates a snippet of a user review that answers a question about the features of a specific place in Google Maps.
+                        "reviewId": "A String", # The ID of the review snippet.
+                        "title": "A String", # Title of the review.
+                        "url": "A String", # A link that corresponds to the user review on Google Maps.
+                      },
+                    ],
+                    "url": "A String",
+                  },
+                ],
+                "widgetContextToken": "A String",
+              },
+            ],
+          },
+          "googleSearchResult": { # Google Search result step.
+            "isError": True or False, # Whether the Google Search resulted in an error.
+            "result": [ # Required. The results of the Google Search.
+              { # The result of the Google Search.
+                "searchSuggestions": "A String", # Web content snippet that can be embedded in a web page or an app webview.
+              },
+            ],
+          },
+          "processingResult": { # The result of a server-initiated media processing step.
+          },
+          "retrievalResult": { # Vertex Retrieval result step. Used by Vertex Retrieval tools such as Parallel AI, Exa AI, Vertex AI Search, etc.
+            "isError": True or False, # Whether the retrieval resulted in an error.
+          },
+          "signature": "A String", # A signature hash for backend validation.
+          "urlContextResult": { # URL context result step.
+            "isError": True or False, # Whether the URL context resulted in an error.
+            "result": [ # Required. The results of the URL context.
+              { # The result of the URL context.
+                "status": "A String", # The status of the URL retrieval.
+                "url": "A String", # The URL that was fetched.
+              },
+            ],
+          },
+        },
+        "userInput": { # Input provided by the user. # DO NOT USE -- These are for 3P JSON only
+          "contentList": { # A list of Content. # The content of the step. An array of Content objects.
+            "contents": [ # The contents of the list.
+              { # The content of the response.
+                "audio": { # An audio content block.
+                  "channels": 42, # The number of audio channels.
+                  "data": "A String", # The audio content.
+                  "mimeTypeString": "A String", # Flexible MIME type string of the audio, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                  "sampleRate": 42, # The sample rate of the audio.
+                  "uri": "A String", # The URI of the audio.
+                },
+                "document": { # A document content block.
+                  "data": "A String", # The document content.
+                  "mimeTypeString": "A String", # Flexible MIME type string of the document, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                  "uri": "A String", # The URI of the document.
+                },
+                "image": { # An image content block.
+                  "data": "A String", # The image content.
+                  "mimeTypeString": "A String", # Flexible MIME type string of the image, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                  "resolution": "A String", # The resolution of the media.
+                  "uri": "A String", # The URI of the image.
+                },
+                "text": { # A text content block.
+                  "annotations": [ # Citation information for model-generated content.
+                    { # Citation information for model-generated content.
+                      "endIndex": 42, # End of the attributed segment, exclusive.
+                      "fileCitation": { # A file citation annotation. # A file citation annotation.
+                        "customMetadata": { # User provided metadata about the retrieved context.
+                          "a_key": "", # Properties of the object.
+                        },
+                        "documentUri": "A String", # The URI of the file.
+                        "fileName": "A String", # The name of the file.
+                        "mediaId": "A String", # Media ID in-case of image citations, if applicable.
+                        "pageNumber": 42, # Page number of the cited document, if applicable.
+                        "source": "A String", # Source attributed for a portion of the text.
+                      },
+                      "placeCitation": { # A place citation annotation. # A place citation annotation.
+                        "name": "A String", # Title of the place.
+                        "placeId": "A String", # The ID of the place, in `places/{place_id}` format.
+                        "reviewSnippets": [ # Snippets of reviews that are used to generate answers about the features of a given place in Google Maps.
+                          { # Encapsulates a snippet of a user review that answers a question about the features of a specific place in Google Maps.
+                            "reviewId": "A String", # The ID of the review snippet.
+                            "title": "A String", # Title of the review.
+                            "url": "A String", # A link that corresponds to the user review on Google Maps.
+                          },
+                        ],
+                        "url": "A String", # URI reference of the place.
+                      },
+                      "speechMetadata": { # Speech annotation for text content. # Speech annotation for text content.
+                        "speaker": "A String", # The speaker to associate with this turn.
+                        "style": "A String", # Style instruction for the speech synthesis.
+                      },
+                      "startIndex": 42, # Start of segment of the response that is attributed to this source. Index indicates the start of the segment, measured in bytes.
+                      "urlCitation": { # A URL citation annotation. # NOTE: We use these instead of the Citation message for historical reasons. A URL citation annotation.
+                        "title": "A String", # The title of the URL.
+                        "url": "A String", # The URL.
+                      },
+                      "wordInfo": { # Word-level ASR annotation for transcription output. Carries the word text, optional timing, and optional speaker attribution. # Word-level ASR annotation with timing and speaker info.
+                        "endOffset": "A String", # End offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                        "speaker": "A String", # Optional. Speaker label for this word (e.g. "spk_1", "spk_2"). Present when diarization_mode is set in TranscriptionConfig.
+                        "startOffset": "A String", # Start offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                        "text": "A String", # The transcribed word.
+                      },
+                    },
+                  ],
+                  "text": "A String", # Required. The text content.
+                },
+                "video": { # A video content block.
+                  "data": "A String", # The video content.
+                  "mimeTypeString": "A String", # Flexible MIME type string of the video, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                  "name": "A String", # A user-defined name for this content block. Can be referenced by the model in the final response.
+                  "processingConfig": {
+                    "static": {
+                      "endOffset": "A String", # Optional. Segment end time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "30s". Must be non-negative and greater than `start_offset` if `start_offset` is set.
+                      "fps": 3.14, # Optional. Video frame-rate sampling density.
+                      "startOffset": "A String", # Optional. Segment start time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "10.5s". Must be non-negative.
+                    },
+                  },
+                  "processingType": "A String",
+                  "resolution": "A String", # The resolution of the media.
+                  "uri": "A String", # The URI of the video.
+                },
+              },
+            ],
+          },
+          "contentString": "A String", # The content of the step. A single string.
+        },
+      },
+    ],
+    "stringContent": "A String", # A string input for the interaction, it will be processed as a single text input.
+    "systemInstruction": "A String", # System instruction for the interaction.
+    "tools": [ # A list of tool declarations the model may call during interaction.
+      { # A tool that can be used by the model.
+        "codeExecution": { # A tool that can be used by the model to execute code. # A tool that can be used by the model to execute code.
+        },
+        "computerUse": { # A tool that can be used by the model to interact with the computer. # Tool to support the model interacting directly with the computer.
+          "disabledSafetyPolicies": [ # Optional. Disabled safety policies for computer use.
+            "A String",
+          ],
+          "enablePromptInjectionDetection": True or False, # Whether enable the prompt injection detection check on computer-use request.
+          "environment": "A String", # The environment being operated.
+          "excludedPredefinedFunctions": [ # The list of predefined functions that are excluded from the model call.
+            "A String",
+          ],
+        },
+        "fileSearch": { # A tool that can be used by the model to search files. # A tool that can be used by the model to search files.
+          "fileSearchStoreNames": [ # The file search store names to search.
+            "A String",
+          ],
+          "metadataFilter": "A String", # Metadata filter to apply to the semantic retrieval documents and chunks.
+          "topK": 42, # The number of semantic retrieval chunks to retrieve.
+        },
+        "function": { # A tool that can be used by the model. # A function that can be used by the model.
+          "description": "A String", # A description of the function.
+          "name": "A String", # The name of the function.
+          "parameters": { # `Value` represents a dynamically typed value which can be either null, a number, a string, a boolean, a recursive struct value, or a list of values. A producer of value is expected to set one of these variants. Absence of any variant indicates an error. # The JSON Schema for the function's parameters.
+            "boolValue": True or False, # Represents a boolean value.
+            "contentValue": { # The content of the response. # Represents rich content (text, image, etc.).
+              "audio": { # An audio content block.
+                "channels": 42, # The number of audio channels.
+                "data": "A String", # The audio content.
+                "mimeTypeString": "A String", # Flexible MIME type string of the audio, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                "sampleRate": 42, # The sample rate of the audio.
+                "uri": "A String", # The URI of the audio.
+              },
+              "document": { # A document content block.
+                "data": "A String", # The document content.
+                "mimeTypeString": "A String", # Flexible MIME type string of the document, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                "uri": "A String", # The URI of the document.
+              },
+              "image": { # An image content block.
+                "data": "A String", # The image content.
+                "mimeTypeString": "A String", # Flexible MIME type string of the image, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                "resolution": "A String", # The resolution of the media.
+                "uri": "A String", # The URI of the image.
+              },
+              "text": { # A text content block.
+                "annotations": [ # Citation information for model-generated content.
+                  { # Citation information for model-generated content.
+                    "endIndex": 42, # End of the attributed segment, exclusive.
+                    "fileCitation": { # A file citation annotation. # A file citation annotation.
+                      "customMetadata": { # User provided metadata about the retrieved context.
+                        "a_key": "", # Properties of the object.
+                      },
+                      "documentUri": "A String", # The URI of the file.
+                      "fileName": "A String", # The name of the file.
+                      "mediaId": "A String", # Media ID in-case of image citations, if applicable.
+                      "pageNumber": 42, # Page number of the cited document, if applicable.
+                      "source": "A String", # Source attributed for a portion of the text.
+                    },
+                    "placeCitation": { # A place citation annotation. # A place citation annotation.
+                      "name": "A String", # Title of the place.
+                      "placeId": "A String", # The ID of the place, in `places/{place_id}` format.
+                      "reviewSnippets": [ # Snippets of reviews that are used to generate answers about the features of a given place in Google Maps.
+                        { # Encapsulates a snippet of a user review that answers a question about the features of a specific place in Google Maps.
+                          "reviewId": "A String", # The ID of the review snippet.
+                          "title": "A String", # Title of the review.
+                          "url": "A String", # A link that corresponds to the user review on Google Maps.
+                        },
+                      ],
+                      "url": "A String", # URI reference of the place.
+                    },
+                    "speechMetadata": { # Speech annotation for text content. # Speech annotation for text content.
+                      "speaker": "A String", # The speaker to associate with this turn.
+                      "style": "A String", # Style instruction for the speech synthesis.
+                    },
+                    "startIndex": 42, # Start of segment of the response that is attributed to this source. Index indicates the start of the segment, measured in bytes.
+                    "urlCitation": { # A URL citation annotation. # NOTE: We use these instead of the Citation message for historical reasons. A URL citation annotation.
+                      "title": "A String", # The title of the URL.
+                      "url": "A String", # The URL.
+                    },
+                    "wordInfo": { # Word-level ASR annotation for transcription output. Carries the word text, optional timing, and optional speaker attribution. # Word-level ASR annotation with timing and speaker info.
+                      "endOffset": "A String", # End offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                      "speaker": "A String", # Optional. Speaker label for this word (e.g. "spk_1", "spk_2"). Present when diarization_mode is set in TranscriptionConfig.
+                      "startOffset": "A String", # Start offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                      "text": "A String", # The transcribed word.
+                    },
+                  },
+                ],
+                "text": "A String", # Required. The text content.
+              },
+              "video": { # A video content block.
+                "data": "A String", # The video content.
+                "mimeTypeString": "A String", # Flexible MIME type string of the video, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                "name": "A String", # A user-defined name for this content block. Can be referenced by the model in the final response.
+                "processingConfig": {
+                  "static": {
+                    "endOffset": "A String", # Optional. Segment end time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "30s". Must be non-negative and greater than `start_offset` if `start_offset` is set.
+                    "fps": 3.14, # Optional. Video frame-rate sampling density.
+                    "startOffset": "A String", # Optional. Segment start time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "10.5s". Must be non-negative.
+                  },
+                },
+                "processingType": "A String",
+                "resolution": "A String", # The resolution of the media.
+                "uri": "A String", # The URI of the video.
+              },
+            },
+            "listValue": { # `ListValue` is a wrapper around a repeated field of values. # Represents a repeated `Value`.
+              "values": [ # Repeated field of dynamically typed values.
+                # Object with schema name: GenaiVertexV1Value
+              ],
+            },
+            "nullValue": "A String", # Represents a null value.
+            "numberValue": 3.14, # Represents a double value.
+            "stringValue": "A String", # Represents a string value.
+            "structValue": # Object with schema name: GenaiVertexV1Struct # Represents a structured value.
+          },
+        },
+        "googleMaps": { # A tool that can be used by the model to call Google Maps. # A tool that can be used by the model to search Google Maps.
+          "enableWidget": True or False, # Whether to return a widget context token in the tool call result of the response.
+          "latitude": 3.14, # The latitude of the user's location.
+          "longitude": 3.14, # The longitude of the user's location.
+        },
+        "googleSearch": { # A tool that can be used by the model to search Google. # A tool that can be used by the model to search Google.
+          "searchTypes": [ # The types of search grounding to enable.
+            "A String",
+          ],
+        },
+        "mcpServer": { # A MCPServer is a server that can be called by the model to perform actions. # A MCPServer is a server that can be called by the model to perform actions.
+          "allowedTools": [ # The allowed tools.
+            { # The configuration for allowed tools.
+              "mode": "A String", # The mode of the tool choice.
+              "tools": [ # The names of the allowed tools.
+                "A String",
+              ],
+            },
+          ],
+          "headers": { # Optional: Fields for authentication headers, timeouts, etc., if needed.
+            "a_key": "A String",
+          },
+          "name": "A String", # The name of the MCPServer.
+          "url": "A String", # The full URL for the MCPServer endpoint. Example: "https://api.example.com/mcp"
+        },
+        "retrieval": { # A tool that can be used by the model to retrieve files. # A tool that can be used by the model to retrieve files.
+          "exaAiSearchConfig": { # Used to specify configuration for ExaAISearch. # Used to specify configuration for ExaAISearch.
+            "apiKey": "A String", # Required. The API key for ExaAiSearch.
+            "customConfig": { # Optional. This field can be used to pass any parameter from the Exa.ai Search API.
+              "a_key": "", # Properties of the object.
+            },
+          },
+          "parallelAiSearchConfig": { # Used to specify configuration for ParallelAISearch. # Used to specify configuration for ParallelAISearch.
+            "apiKey": "A String", # Optional. The API key for ParallelAiSearch.
+            "customConfig": { # Optional. Custom configs for ParallelAiSearch.
+              "a_key": "", # Properties of the object.
+            },
+          },
+          "ragStoreConfig": { # Use to specify configuration for RAG Store. # Used to specify configuration for RagStore.
+            "ragResources": [ # Optional. The representation of the rag source.
+              { # The definition of the Rag resource.
+                "ragCorpus": "A String", # Optional. RagCorpora resource name.
+                "ragFileIds": [ # Optional. rag_file_id. The files should be in the same rag_corpus set in rag_corpus field.
+                  "A String",
+                ],
+              },
+            ],
+            "ragRetrievalConfig": { # Specifies the context retrieval config. # Optional. The retrieval config for the Rag query.
+              "filter": { # Config for filters. # Optional. Config for filters.
+                "metadataFilter": "A String", # Optional. String for metadata filtering.
+                "vectorDistanceThreshold": 3.14, # Optional. Only returns contexts with vector distance smaller than the threshold.
+                "vectorSimilarityThreshold": 3.14, # Optional. Only returns contexts with vector similarity larger than the threshold.
+              },
+              "hybridSearch": { # Config for Hybrid Search. # Optional. Config for Hybrid Search.
+                "alpha": 3.14, # Optional. Alpha value controls the weight between dense and sparse vector search results.
+              },
+              "ranking": { # Config for ranking and reranking. # Optional. Config for ranking and reranking.
+                "rankService": { # Config for Rank Service. # Config for Rank Service.
+                  "modelName": "A String", # Optional. The model name of the rank service.
+                },
+              },
+              "topK": 42, # Optional. The number of contexts to retrieve.
+            },
+          },
+          "retrievalTypes": [ # The types of file retrieval to enable.
+            "A String",
+          ],
+          "vertexAiSearchConfig": { # Used to specify configuration for VertexAISearch. # Used to specify configuration for VertexAISearch.
+            "datastores": [ # Optional. Used to specify Vertex AI Search datastores.
+              "A String",
+            ],
+            "engine": "A String", # Optional. Used to specify Vertex AI Search engine.
+          },
+        },
+        "urlContext": { # A tool that can be used by the model to fetch URL context. # A tool that can be used by the model to fetch URL context.
+        },
+      },
+    ],
+    "updated": "A String", # Required. Output only. The time at which the response was last updated in ISO 8601 format (YYYY-MM-DDThh:mm:ssZ).
+    "usage": { # Statistics on the interaction request's token usage. # Output only. Statistics on the interaction request's token usage.
+      "cachedTokensByModality": [ # A breakdown of cached token usage by modality.
+        { # The token count for a single response modality.
+          "modality": "A String", # The modality associated with the token count.
+          "tokens": 42, # Number of tokens for the modality.
+        },
+      ],
+      "groundingToolCount": [ # Grounding tool count.
+        { # The number of grounding tool counts.
+          "count": 42, # The number of grounding tool counts.
+          "type": "A String", # The grounding tool type associated with the count.
+        },
+      ],
+      "inputTokensByModality": [ # A breakdown of input token usage by modality.
+        { # The token count for a single response modality.
+          "modality": "A String", # The modality associated with the token count.
+          "tokens": 42, # Number of tokens for the modality.
+        },
+      ],
+      "outputTokensByModality": [ # A breakdown of output token usage by modality.
+        { # The token count for a single response modality.
+          "modality": "A String", # The modality associated with the token count.
+          "tokens": 42, # Number of tokens for the modality.
+        },
+      ],
+      "toolUseTokensByModality": [ # A breakdown of tool-use token usage by modality.
+        { # The token count for a single response modality.
+          "modality": "A String", # The modality associated with the token count.
+          "tokens": 42, # Number of tokens for the modality.
+        },
+      ],
+      "totalCachedTokens": 42, # Number of tokens in the cached part of the prompt (the cached content).
+      "totalInputTokens": 42, # Number of tokens in the prompt (context).
+      "totalOutputTokens": 42, # Total number of tokens across all the generated responses.
+      "totalThoughtTokens": 42, # Number of tokens of thoughts for thinking models.
+      "totalTokens": 42, # Total token count for the interaction request (prompt + responses + other internal tokens).
+      "totalToolUseTokens": 42, # Number of tokens present in tool-use prompt(s).
+    },
+  },
+  "store": True or False, # Input only. Whether to store the response and request for later retrieval.
+  "stream": True or False, # Input only. Whether the interaction will be streamed.
+}
+
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # Response for InteractionService.CreateInteraction.
+  "agentInteraction": { # Interaction for generating the completion using agents. # Interaction for generating the completion using agents.
+    "agent": "A String", # The name of the `Agent` used for generating the completion.
+    "antigravityConfig": { # Configuration for the Antigravity agent runtime. Provides server-side control over the agent's execution environment and tool configuration. # Antigravity agent configuration. This configuration is session-level settings that are passed to the agent runtime on a per-request basis.
+      "maxTotalTokens": "A String", # Max total tokens for the agent run.
+      "model": "A String", # The model to use for agent reasoning.
+    },
+    "codeMenderConfig": { # Configuration for the CodeMender agent.
+      "findRequest": { # Request parameters specific to FIND sessions, used for discovering vulnerabilities in a codebase. # Parameters for finding vulnerabilities.
+        "description": "A String", # Additional context or custom instructions provided by the user to guide the vulnerability analysis.
+        "findingId": "A String", # The identifier of a specific finding to verify. This is primarily used in VERIFY mode to focus the agent's execution-based validation on a single vulnerability.
+        "mode": "A String", # The mode of the find session.
+        "sourceFiles": [ # A list of source files to provide as context for the scan.
+          { # Content of a single file in the codebase.
+            "content": "A String", # The UTF-8 encoded text content of the file.
+            "path": "A String", # The relative path of the file from the project root.
+          },
+        ],
+      },
+      "fixRequest": { # Request parameters specific to FIX sessions, used for generating and validating security patches. # Parameters for fixing vulnerabilities.
+        "description": "A String", # Additional context or custom instructions provided by the user to guide the patch generation process.
+        "findingId": "A String", # The identifier of the specific security finding to be remediated. This ID maps to a previously discovered vulnerability.
+        "sourceFiles": [ # A list of source files providing context for the remediation. These files are typically the ones containing the identified vulnerability.
+          { # Content of a single file in the codebase.
+            "content": "A String", # The UTF-8 encoded text content of the file.
+            "path": "A String", # The relative path of the file from the project root.
+          },
+        ],
+      },
+      "model": "A String", # The name of the model to use for the CodeMender agent. One CodeMender session will only use one model.
+      "sessionConfig": { # The configuration of CodeMender sessions. # Optional session-specific configurations to override default agent behavior.
+        "maxRounds": 42, # The maximum number of interaction rounds the agent is allowed to perform before reaching a timeout.
+      },
+      "sessionId": "A String", # Parameter for grouping multiple interactions that belong to the same CodeMender session.
+    },
+    "deepResearchConfig": { # Configuration for the Deep Research agent.
+      "collaborativePlanning": True or False, # Enables human-in-the-loop planning for the Deep Research agent. If set to true, the Deep Research agent will provide a research plan in its response. The agent will then proceed only if the user confirms the plan in the next turn.
+      "enableBigqueryTool": True or False, # Enables bigquery tool for the Deep Research agent.
+      "thinkingSummaries": "A String", # Whether to include thought summaries in the response.
+      "visualization": "A String", # Whether to include visualizations in the response.
+    },
+    "dynamicConfig": { # Configuration for dynamic agents.
+      "config": { # `Struct` represents a structured data value, consisting of fields which map to dynamically typed values. # For agents that are not supported statically in the API definition.
+        "fields": [ # Dynamically typed fields. List instead of map because LLMs are sensitive to ordering, and we want to give users full control.
+          { # Represents a single field in a struct.
+            "name": "A String",
+            "value": { # `Value` represents a dynamically typed value which can be either null, a number, a string, a boolean, a recursive struct value, or a list of values. A producer of value is expected to set one of these variants. Absence of any variant indicates an error.
+              "boolValue": True or False, # Represents a boolean value.
+              "contentValue": { # The content of the response. # Represents rich content (text, image, etc.).
+                "audio": { # An audio content block.
+                  "channels": 42, # The number of audio channels.
+                  "data": "A String", # The audio content.
+                  "mimeTypeString": "A String", # Flexible MIME type string of the audio, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                  "sampleRate": 42, # The sample rate of the audio.
+                  "uri": "A String", # The URI of the audio.
+                },
+                "document": { # A document content block.
+                  "data": "A String", # The document content.
+                  "mimeTypeString": "A String", # Flexible MIME type string of the document, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                  "uri": "A String", # The URI of the document.
+                },
+                "image": { # An image content block.
+                  "data": "A String", # The image content.
+                  "mimeTypeString": "A String", # Flexible MIME type string of the image, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                  "resolution": "A String", # The resolution of the media.
+                  "uri": "A String", # The URI of the image.
+                },
+                "text": { # A text content block.
+                  "annotations": [ # Citation information for model-generated content.
+                    { # Citation information for model-generated content.
+                      "endIndex": 42, # End of the attributed segment, exclusive.
+                      "fileCitation": { # A file citation annotation. # A file citation annotation.
+                        "customMetadata": { # User provided metadata about the retrieved context.
+                          "a_key": "", # Properties of the object.
+                        },
+                        "documentUri": "A String", # The URI of the file.
+                        "fileName": "A String", # The name of the file.
+                        "mediaId": "A String", # Media ID in-case of image citations, if applicable.
+                        "pageNumber": 42, # Page number of the cited document, if applicable.
+                        "source": "A String", # Source attributed for a portion of the text.
+                      },
+                      "placeCitation": { # A place citation annotation. # A place citation annotation.
+                        "name": "A String", # Title of the place.
+                        "placeId": "A String", # The ID of the place, in `places/{place_id}` format.
+                        "reviewSnippets": [ # Snippets of reviews that are used to generate answers about the features of a given place in Google Maps.
+                          { # Encapsulates a snippet of a user review that answers a question about the features of a specific place in Google Maps.
+                            "reviewId": "A String", # The ID of the review snippet.
+                            "title": "A String", # Title of the review.
+                            "url": "A String", # A link that corresponds to the user review on Google Maps.
+                          },
+                        ],
+                        "url": "A String", # URI reference of the place.
+                      },
+                      "speechMetadata": { # Speech annotation for text content. # Speech annotation for text content.
+                        "speaker": "A String", # The speaker to associate with this turn.
+                        "style": "A String", # Style instruction for the speech synthesis.
+                      },
+                      "startIndex": 42, # Start of segment of the response that is attributed to this source. Index indicates the start of the segment, measured in bytes.
+                      "urlCitation": { # A URL citation annotation. # NOTE: We use these instead of the Citation message for historical reasons. A URL citation annotation.
+                        "title": "A String", # The title of the URL.
+                        "url": "A String", # The URL.
+                      },
+                      "wordInfo": { # Word-level ASR annotation for transcription output. Carries the word text, optional timing, and optional speaker attribution. # Word-level ASR annotation with timing and speaker info.
+                        "endOffset": "A String", # End offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                        "speaker": "A String", # Optional. Speaker label for this word (e.g. "spk_1", "spk_2"). Present when diarization_mode is set in TranscriptionConfig.
+                        "startOffset": "A String", # Start offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                        "text": "A String", # The transcribed word.
+                      },
+                    },
+                  ],
+                  "text": "A String", # Required. The text content.
+                },
+                "video": { # A video content block.
+                  "data": "A String", # The video content.
+                  "mimeTypeString": "A String", # Flexible MIME type string of the video, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                  "name": "A String", # A user-defined name for this content block. Can be referenced by the model in the final response.
+                  "processingConfig": {
+                    "static": {
+                      "endOffset": "A String", # Optional. Segment end time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "30s". Must be non-negative and greater than `start_offset` if `start_offset` is set.
+                      "fps": 3.14, # Optional. Video frame-rate sampling density.
+                      "startOffset": "A String", # Optional. Segment start time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "10.5s". Must be non-negative.
+                    },
+                  },
+                  "processingType": "A String",
+                  "resolution": "A String", # The resolution of the media.
+                  "uri": "A String", # The URI of the video.
+                },
+              },
+              "listValue": { # `ListValue` is a wrapper around a repeated field of values. # Represents a repeated `Value`.
+                "values": [ # Repeated field of dynamically typed values.
+                  # Object with schema name: GenaiVertexV1Value
+                ],
+              },
+              "nullValue": "A String", # Represents a null value.
+              "numberValue": 3.14, # Represents a double value.
+              "stringValue": "A String", # Represents a string value.
+              "structValue": # Object with schema name: GenaiVertexV1Struct # Represents a structured value.
+            },
+          },
+        ],
+      },
+    },
+  },
+  "content": { # The content of the response. # The content for the interaction.
+    "audio": { # An audio content block.
+      "channels": 42, # The number of audio channels.
+      "data": "A String", # The audio content.
+      "mimeTypeString": "A String", # Flexible MIME type string of the audio, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+      "sampleRate": 42, # The sample rate of the audio.
+      "uri": "A String", # The URI of the audio.
+    },
+    "document": { # A document content block.
+      "data": "A String", # The document content.
+      "mimeTypeString": "A String", # Flexible MIME type string of the document, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+      "uri": "A String", # The URI of the document.
+    },
+    "image": { # An image content block.
+      "data": "A String", # The image content.
+      "mimeTypeString": "A String", # Flexible MIME type string of the image, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+      "resolution": "A String", # The resolution of the media.
+      "uri": "A String", # The URI of the image.
+    },
+    "text": { # A text content block.
+      "annotations": [ # Citation information for model-generated content.
+        { # Citation information for model-generated content.
+          "endIndex": 42, # End of the attributed segment, exclusive.
+          "fileCitation": { # A file citation annotation. # A file citation annotation.
+            "customMetadata": { # User provided metadata about the retrieved context.
+              "a_key": "", # Properties of the object.
+            },
+            "documentUri": "A String", # The URI of the file.
+            "fileName": "A String", # The name of the file.
+            "mediaId": "A String", # Media ID in-case of image citations, if applicable.
+            "pageNumber": 42, # Page number of the cited document, if applicable.
+            "source": "A String", # Source attributed for a portion of the text.
+          },
+          "placeCitation": { # A place citation annotation. # A place citation annotation.
+            "name": "A String", # Title of the place.
+            "placeId": "A String", # The ID of the place, in `places/{place_id}` format.
+            "reviewSnippets": [ # Snippets of reviews that are used to generate answers about the features of a given place in Google Maps.
+              { # Encapsulates a snippet of a user review that answers a question about the features of a specific place in Google Maps.
+                "reviewId": "A String", # The ID of the review snippet.
+                "title": "A String", # Title of the review.
+                "url": "A String", # A link that corresponds to the user review on Google Maps.
+              },
+            ],
+            "url": "A String", # URI reference of the place.
+          },
+          "speechMetadata": { # Speech annotation for text content. # Speech annotation for text content.
+            "speaker": "A String", # The speaker to associate with this turn.
+            "style": "A String", # Style instruction for the speech synthesis.
+          },
+          "startIndex": 42, # Start of segment of the response that is attributed to this source. Index indicates the start of the segment, measured in bytes.
+          "urlCitation": { # A URL citation annotation. # NOTE: We use these instead of the Citation message for historical reasons. A URL citation annotation.
+            "title": "A String", # The title of the URL.
+            "url": "A String", # The URL.
+          },
+          "wordInfo": { # Word-level ASR annotation for transcription output. Carries the word text, optional timing, and optional speaker attribution. # Word-level ASR annotation with timing and speaker info.
+            "endOffset": "A String", # End offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+            "speaker": "A String", # Optional. Speaker label for this word (e.g. "spk_1", "spk_2"). Present when diarization_mode is set in TranscriptionConfig.
+            "startOffset": "A String", # Start offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+            "text": "A String", # The transcribed word.
+          },
+        },
+      ],
+      "text": "A String", # Required. The text content.
+    },
+    "video": { # A video content block.
+      "data": "A String", # The video content.
+      "mimeTypeString": "A String", # Flexible MIME type string of the video, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+      "name": "A String", # A user-defined name for this content block. Can be referenced by the model in the final response.
+      "processingConfig": {
+        "static": {
+          "endOffset": "A String", # Optional. Segment end time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "30s". Must be non-negative and greater than `start_offset` if `start_offset` is set.
+          "fps": 3.14, # Optional. Video frame-rate sampling density.
+          "startOffset": "A String", # Optional. Segment start time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "10.5s". Must be non-negative.
+        },
+      },
+      "processingType": "A String",
+      "resolution": "A String", # The resolution of the media.
+      "uri": "A String", # The URI of the video.
+    },
+  },
+  "created": "A String", # Required. Output only. The time at which the response was created in ISO 8601 format (YYYY-MM-DDThh:mm:ssZ).
+  "envId": "A String", # The environment ID for the interaction. Can be 'remote' for default environment.
+  "environmentId": "A String", # Output only. The environment ID for the interaction. Only populated if environment config is set in the request.
+  "errors": [ # Output only. Diagnostic faults / platform errors recorded on the interaction.
+    { # Error message from an interaction.
+      "code": "A String", # A URI that identifies the error type.
+      "message": "A String", # A human-readable error message.
+    },
+  ],
+  "id": "A String", # Required. Output only. A unique identifier for the interaction completion.
+  "labels": { # The labels with user-defined metadata for the request. 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",
+  },
+  "modelInteraction": { # Interaction for generating the completion using models. # Interaction for generating the completion using models.
+    "generationConfig": { # Configuration parameters for model interactions. # Input only. Configuration parameters for the model interaction.
+      "maxOutputTokens": 42, # The maximum number of tokens to include in the response.
+      "seed": 42, # Seed used in decoding for reproducibility.
+      "stopSequences": [ # A list of character sequences that will stop output interaction.
+        "A String",
+      ],
+      "structuredSpeechConfig": { # Configuration for multi-speaker and speech generation. # Speech and multi-speaker configuration.
+        "speakers": [ # Individual speaker configurations.
+          { # The configuration for speech interaction.
+            "language": "A String", # The language of the speech.
+            "speaker": "A String", # The speaker's name, it should match the speaker name given in the prompt.
+            "voice": "A String", # The voice of the speaker.
+          },
+        ],
+      },
+      "temperature": 3.14, # Controls the randomness of the output.
+      "thinkingLevel": "A String", # The level of thought tokens that the model should generate.
+      "thinkingSummaries": "A String", # Whether to include thought summaries in the response.
+      "toolChoiceConfig": { # The tool choice configuration containing allowed tools. # The config for the tool choice.
+        "allowedTools": { # The configuration for allowed tools. # The allowed tools.
+          "mode": "A String", # The mode of the tool choice.
+          "tools": [ # The names of the allowed tools.
+            "A String",
+          ],
+        },
+      },
+      "toolChoiceMode": "A String", # The mode of the tool choice.
+      "topP": 3.14, # The maximum cumulative probability of tokens to consider when sampling.
+      "transcriptionConfig": { # Configuration for speech recognition (transcription). # Optional. Configuration for speech recognition (transcription). If present, ASR is enabled.
+        "adaptationPhrases": [ # Optional. A list of phrases to bias the ASR model towards.
+          "A String",
+        ],
+        "customVocabulary": [ # Optional. A list of custom vocabulary phrases to bias the speech recognition model toward recognizing specific terms.
+          "A String",
+        ],
+        "diarizationMode": "A String", # Optional. Configures speaker diarization. Supported values: "speaker".
+        "languageCodes": [ # Optional. BCP-47 language codes providing hints about the languages present in the audio. If omitted or empty, defaults to automatic language detection.
+          "A String",
+        ],
+        "timestampGranularities": [ # Optional. The granularity of timestamps to include in the transcription output. Supported values: "word". If empty, no timestamps are generated.
+          "A String",
+        ],
+      },
+      "videoConfig": { # Configuration options for video generation. # Configuration for video generation.
+        "task": "A String", # Optional task mode for video generation. If not specified, the model automatically determines the appropriate mode based on the provided text prompt and input media.
+      },
+    },
+    "model": "A String", # The name of the `Model` used for generating the completion.
+  },
+  "previousInteractionId": "A String", # The ID of the previous interaction, if any.
+  "responseFormatList": {
+    "responseFormats": [
+      {
+        "audio": { # Configuration for audio output format.
+          "bitRate": 42, # Bit rate in bits per second (bps). Only applicable for compressed formats (MP3, Opus).
+          "delivery": "A String", # The delivery mode for the audio output.
+          "mimeType": "A String", # The MIME type of the audio output.
+          "sampleRate": 42, # Sample rate in Hz.
+        },
+        "image": { # Configuration for image output format.
+          "aspectRatio": "A String", # The aspect ratio for the image output.
+          "delivery": "A String", # The delivery mode for the image output.
+          "imageSize": "A String", # The size of the image output.
+          "mimeType": "A String", # The MIME type of the image output.
+        },
+        "structValue": { # `Struct` represents a structured data value, consisting of fields which map to dynamically typed values. # Multi-discriminator values is already enabled in GAOS
+          "fields": [ # Dynamically typed fields. List instead of map because LLMs are sensitive to ordering, and we want to give users full control.
+            { # Represents a single field in a struct.
+              "name": "A String",
+              "value": { # `Value` represents a dynamically typed value which can be either null, a number, a string, a boolean, a recursive struct value, or a list of values. A producer of value is expected to set one of these variants. Absence of any variant indicates an error.
+                "boolValue": True or False, # Represents a boolean value.
+                "contentValue": { # The content of the response. # Represents rich content (text, image, etc.).
+                  "audio": { # An audio content block.
+                    "channels": 42, # The number of audio channels.
+                    "data": "A String", # The audio content.
+                    "mimeTypeString": "A String", # Flexible MIME type string of the audio, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                    "sampleRate": 42, # The sample rate of the audio.
+                    "uri": "A String", # The URI of the audio.
+                  },
+                  "document": { # A document content block.
+                    "data": "A String", # The document content.
+                    "mimeTypeString": "A String", # Flexible MIME type string of the document, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                    "uri": "A String", # The URI of the document.
+                  },
+                  "image": { # An image content block.
+                    "data": "A String", # The image content.
+                    "mimeTypeString": "A String", # Flexible MIME type string of the image, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                    "resolution": "A String", # The resolution of the media.
+                    "uri": "A String", # The URI of the image.
+                  },
+                  "text": { # A text content block.
+                    "annotations": [ # Citation information for model-generated content.
+                      { # Citation information for model-generated content.
+                        "endIndex": 42, # End of the attributed segment, exclusive.
+                        "fileCitation": { # A file citation annotation. # A file citation annotation.
+                          "customMetadata": { # User provided metadata about the retrieved context.
+                            "a_key": "", # Properties of the object.
+                          },
+                          "documentUri": "A String", # The URI of the file.
+                          "fileName": "A String", # The name of the file.
+                          "mediaId": "A String", # Media ID in-case of image citations, if applicable.
+                          "pageNumber": 42, # Page number of the cited document, if applicable.
+                          "source": "A String", # Source attributed for a portion of the text.
+                        },
+                        "placeCitation": { # A place citation annotation. # A place citation annotation.
+                          "name": "A String", # Title of the place.
+                          "placeId": "A String", # The ID of the place, in `places/{place_id}` format.
+                          "reviewSnippets": [ # Snippets of reviews that are used to generate answers about the features of a given place in Google Maps.
+                            { # Encapsulates a snippet of a user review that answers a question about the features of a specific place in Google Maps.
+                              "reviewId": "A String", # The ID of the review snippet.
+                              "title": "A String", # Title of the review.
+                              "url": "A String", # A link that corresponds to the user review on Google Maps.
+                            },
+                          ],
+                          "url": "A String", # URI reference of the place.
+                        },
+                        "speechMetadata": { # Speech annotation for text content. # Speech annotation for text content.
+                          "speaker": "A String", # The speaker to associate with this turn.
+                          "style": "A String", # Style instruction for the speech synthesis.
+                        },
+                        "startIndex": 42, # Start of segment of the response that is attributed to this source. Index indicates the start of the segment, measured in bytes.
+                        "urlCitation": { # A URL citation annotation. # NOTE: We use these instead of the Citation message for historical reasons. A URL citation annotation.
+                          "title": "A String", # The title of the URL.
+                          "url": "A String", # The URL.
+                        },
+                        "wordInfo": { # Word-level ASR annotation for transcription output. Carries the word text, optional timing, and optional speaker attribution. # Word-level ASR annotation with timing and speaker info.
+                          "endOffset": "A String", # End offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                          "speaker": "A String", # Optional. Speaker label for this word (e.g. "spk_1", "spk_2"). Present when diarization_mode is set in TranscriptionConfig.
+                          "startOffset": "A String", # Start offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                          "text": "A String", # The transcribed word.
+                        },
+                      },
+                    ],
+                    "text": "A String", # Required. The text content.
+                  },
+                  "video": { # A video content block.
+                    "data": "A String", # The video content.
+                    "mimeTypeString": "A String", # Flexible MIME type string of the video, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                    "name": "A String", # A user-defined name for this content block. Can be referenced by the model in the final response.
+                    "processingConfig": {
+                      "static": {
+                        "endOffset": "A String", # Optional. Segment end time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "30s". Must be non-negative and greater than `start_offset` if `start_offset` is set.
+                        "fps": 3.14, # Optional. Video frame-rate sampling density.
+                        "startOffset": "A String", # Optional. Segment start time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "10.5s". Must be non-negative.
+                      },
+                    },
+                    "processingType": "A String",
+                    "resolution": "A String", # The resolution of the media.
+                    "uri": "A String", # The URI of the video.
+                  },
+                },
+                "listValue": { # `ListValue` is a wrapper around a repeated field of values. # Represents a repeated `Value`.
+                  "values": [ # Repeated field of dynamically typed values.
+                    # Object with schema name: GenaiVertexV1Value
+                  ],
+                },
+                "nullValue": "A String", # Represents a null value.
+                "numberValue": 3.14, # Represents a double value.
+                "stringValue": "A String", # Represents a string value.
+                "structValue": # Object with schema name: GenaiVertexV1Struct # Represents a structured value.
+              },
+            },
+          ],
+        },
+        "text": { # Configuration for text output format.
+          "mimeType": "A String", # The MIME type of the text output.
+          "schema": { # `Struct` represents a structured data value, consisting of fields which map to dynamically typed values. # The JSON schema that the output should conform to. Only applicable when mime_type is application/json.
+            "fields": [ # Dynamically typed fields. List instead of map because LLMs are sensitive to ordering, and we want to give users full control.
+              { # Represents a single field in a struct.
+                "name": "A String",
+                "value": { # `Value` represents a dynamically typed value which can be either null, a number, a string, a boolean, a recursive struct value, or a list of values. A producer of value is expected to set one of these variants. Absence of any variant indicates an error.
+                  "boolValue": True or False, # Represents a boolean value.
+                  "contentValue": { # The content of the response. # Represents rich content (text, image, etc.).
+                    "audio": { # An audio content block.
+                      "channels": 42, # The number of audio channels.
+                      "data": "A String", # The audio content.
+                      "mimeTypeString": "A String", # Flexible MIME type string of the audio, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                      "sampleRate": 42, # The sample rate of the audio.
+                      "uri": "A String", # The URI of the audio.
+                    },
+                    "document": { # A document content block.
+                      "data": "A String", # The document content.
+                      "mimeTypeString": "A String", # Flexible MIME type string of the document, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                      "uri": "A String", # The URI of the document.
+                    },
+                    "image": { # An image content block.
+                      "data": "A String", # The image content.
+                      "mimeTypeString": "A String", # Flexible MIME type string of the image, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                      "resolution": "A String", # The resolution of the media.
+                      "uri": "A String", # The URI of the image.
+                    },
+                    "text": { # A text content block.
+                      "annotations": [ # Citation information for model-generated content.
+                        { # Citation information for model-generated content.
+                          "endIndex": 42, # End of the attributed segment, exclusive.
+                          "fileCitation": { # A file citation annotation. # A file citation annotation.
+                            "customMetadata": { # User provided metadata about the retrieved context.
+                              "a_key": "", # Properties of the object.
+                            },
+                            "documentUri": "A String", # The URI of the file.
+                            "fileName": "A String", # The name of the file.
+                            "mediaId": "A String", # Media ID in-case of image citations, if applicable.
+                            "pageNumber": 42, # Page number of the cited document, if applicable.
+                            "source": "A String", # Source attributed for a portion of the text.
+                          },
+                          "placeCitation": { # A place citation annotation. # A place citation annotation.
+                            "name": "A String", # Title of the place.
+                            "placeId": "A String", # The ID of the place, in `places/{place_id}` format.
+                            "reviewSnippets": [ # Snippets of reviews that are used to generate answers about the features of a given place in Google Maps.
+                              { # Encapsulates a snippet of a user review that answers a question about the features of a specific place in Google Maps.
+                                "reviewId": "A String", # The ID of the review snippet.
+                                "title": "A String", # Title of the review.
+                                "url": "A String", # A link that corresponds to the user review on Google Maps.
+                              },
+                            ],
+                            "url": "A String", # URI reference of the place.
+                          },
+                          "speechMetadata": { # Speech annotation for text content. # Speech annotation for text content.
+                            "speaker": "A String", # The speaker to associate with this turn.
+                            "style": "A String", # Style instruction for the speech synthesis.
+                          },
+                          "startIndex": 42, # Start of segment of the response that is attributed to this source. Index indicates the start of the segment, measured in bytes.
+                          "urlCitation": { # A URL citation annotation. # NOTE: We use these instead of the Citation message for historical reasons. A URL citation annotation.
+                            "title": "A String", # The title of the URL.
+                            "url": "A String", # The URL.
+                          },
+                          "wordInfo": { # Word-level ASR annotation for transcription output. Carries the word text, optional timing, and optional speaker attribution. # Word-level ASR annotation with timing and speaker info.
+                            "endOffset": "A String", # End offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                            "speaker": "A String", # Optional. Speaker label for this word (e.g. "spk_1", "spk_2"). Present when diarization_mode is set in TranscriptionConfig.
+                            "startOffset": "A String", # Start offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                            "text": "A String", # The transcribed word.
+                          },
+                        },
+                      ],
+                      "text": "A String", # Required. The text content.
+                    },
+                    "video": { # A video content block.
+                      "data": "A String", # The video content.
+                      "mimeTypeString": "A String", # Flexible MIME type string of the video, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                      "name": "A String", # A user-defined name for this content block. Can be referenced by the model in the final response.
+                      "processingConfig": {
+                        "static": {
+                          "endOffset": "A String", # Optional. Segment end time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "30s". Must be non-negative and greater than `start_offset` if `start_offset` is set.
+                          "fps": 3.14, # Optional. Video frame-rate sampling density.
+                          "startOffset": "A String", # Optional. Segment start time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "10.5s". Must be non-negative.
+                        },
+                      },
+                      "processingType": "A String",
+                      "resolution": "A String", # The resolution of the media.
+                      "uri": "A String", # The URI of the video.
+                    },
+                  },
+                  "listValue": { # `ListValue` is a wrapper around a repeated field of values. # Represents a repeated `Value`.
+                    "values": [ # Repeated field of dynamically typed values.
+                      # Object with schema name: GenaiVertexV1Value
+                    ],
+                  },
+                  "nullValue": "A String", # Represents a null value.
+                  "numberValue": 3.14, # Represents a double value.
+                  "stringValue": "A String", # Represents a string value.
+                  "structValue": # Object with schema name: GenaiVertexV1Struct # Represents a structured value.
+                },
+              },
+            ],
+          },
+        },
+        "video": { # Configuration for video output format.
+          "aspectRatio": "A String", # The aspect ratio for the video output.
+          "delivery": "A String", # The delivery mode for the video output.
+          "duration": "A String", # The duration for the video output.
+          "gcsUri": "A String", # The Cloud Storage URI to store the video output. Required for Vertex if delivery mode is URI.
+          "resolution": "A String", # The video output resolution. Defaults to 720p.
+        },
+      },
+    ],
+  },
+  "responseFormatSingleton": {
+    "audio": { # Configuration for audio output format.
+      "bitRate": 42, # Bit rate in bits per second (bps). Only applicable for compressed formats (MP3, Opus).
+      "delivery": "A String", # The delivery mode for the audio output.
+      "mimeType": "A String", # The MIME type of the audio output.
+      "sampleRate": 42, # Sample rate in Hz.
+    },
+    "image": { # Configuration for image output format.
+      "aspectRatio": "A String", # The aspect ratio for the image output.
+      "delivery": "A String", # The delivery mode for the image output.
+      "imageSize": "A String", # The size of the image output.
+      "mimeType": "A String", # The MIME type of the image output.
+    },
+    "structValue": { # `Struct` represents a structured data value, consisting of fields which map to dynamically typed values. # Multi-discriminator values is already enabled in GAOS
+      "fields": [ # Dynamically typed fields. List instead of map because LLMs are sensitive to ordering, and we want to give users full control.
+        { # Represents a single field in a struct.
+          "name": "A String",
+          "value": { # `Value` represents a dynamically typed value which can be either null, a number, a string, a boolean, a recursive struct value, or a list of values. A producer of value is expected to set one of these variants. Absence of any variant indicates an error.
+            "boolValue": True or False, # Represents a boolean value.
+            "contentValue": { # The content of the response. # Represents rich content (text, image, etc.).
+              "audio": { # An audio content block.
+                "channels": 42, # The number of audio channels.
+                "data": "A String", # The audio content.
+                "mimeTypeString": "A String", # Flexible MIME type string of the audio, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                "sampleRate": 42, # The sample rate of the audio.
+                "uri": "A String", # The URI of the audio.
+              },
+              "document": { # A document content block.
+                "data": "A String", # The document content.
+                "mimeTypeString": "A String", # Flexible MIME type string of the document, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                "uri": "A String", # The URI of the document.
+              },
+              "image": { # An image content block.
+                "data": "A String", # The image content.
+                "mimeTypeString": "A String", # Flexible MIME type string of the image, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                "resolution": "A String", # The resolution of the media.
+                "uri": "A String", # The URI of the image.
+              },
+              "text": { # A text content block.
+                "annotations": [ # Citation information for model-generated content.
+                  { # Citation information for model-generated content.
+                    "endIndex": 42, # End of the attributed segment, exclusive.
+                    "fileCitation": { # A file citation annotation. # A file citation annotation.
+                      "customMetadata": { # User provided metadata about the retrieved context.
+                        "a_key": "", # Properties of the object.
+                      },
+                      "documentUri": "A String", # The URI of the file.
+                      "fileName": "A String", # The name of the file.
+                      "mediaId": "A String", # Media ID in-case of image citations, if applicable.
+                      "pageNumber": 42, # Page number of the cited document, if applicable.
+                      "source": "A String", # Source attributed for a portion of the text.
+                    },
+                    "placeCitation": { # A place citation annotation. # A place citation annotation.
+                      "name": "A String", # Title of the place.
+                      "placeId": "A String", # The ID of the place, in `places/{place_id}` format.
+                      "reviewSnippets": [ # Snippets of reviews that are used to generate answers about the features of a given place in Google Maps.
+                        { # Encapsulates a snippet of a user review that answers a question about the features of a specific place in Google Maps.
+                          "reviewId": "A String", # The ID of the review snippet.
+                          "title": "A String", # Title of the review.
+                          "url": "A String", # A link that corresponds to the user review on Google Maps.
+                        },
+                      ],
+                      "url": "A String", # URI reference of the place.
+                    },
+                    "speechMetadata": { # Speech annotation for text content. # Speech annotation for text content.
+                      "speaker": "A String", # The speaker to associate with this turn.
+                      "style": "A String", # Style instruction for the speech synthesis.
+                    },
+                    "startIndex": 42, # Start of segment of the response that is attributed to this source. Index indicates the start of the segment, measured in bytes.
+                    "urlCitation": { # A URL citation annotation. # NOTE: We use these instead of the Citation message for historical reasons. A URL citation annotation.
+                      "title": "A String", # The title of the URL.
+                      "url": "A String", # The URL.
+                    },
+                    "wordInfo": { # Word-level ASR annotation for transcription output. Carries the word text, optional timing, and optional speaker attribution. # Word-level ASR annotation with timing and speaker info.
+                      "endOffset": "A String", # End offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                      "speaker": "A String", # Optional. Speaker label for this word (e.g. "spk_1", "spk_2"). Present when diarization_mode is set in TranscriptionConfig.
+                      "startOffset": "A String", # Start offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                      "text": "A String", # The transcribed word.
+                    },
+                  },
+                ],
+                "text": "A String", # Required. The text content.
+              },
+              "video": { # A video content block.
+                "data": "A String", # The video content.
+                "mimeTypeString": "A String", # Flexible MIME type string of the video, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                "name": "A String", # A user-defined name for this content block. Can be referenced by the model in the final response.
+                "processingConfig": {
+                  "static": {
+                    "endOffset": "A String", # Optional. Segment end time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "30s". Must be non-negative and greater than `start_offset` if `start_offset` is set.
+                    "fps": 3.14, # Optional. Video frame-rate sampling density.
+                    "startOffset": "A String", # Optional. Segment start time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "10.5s". Must be non-negative.
+                  },
+                },
+                "processingType": "A String",
+                "resolution": "A String", # The resolution of the media.
+                "uri": "A String", # The URI of the video.
+              },
+            },
+            "listValue": { # `ListValue` is a wrapper around a repeated field of values. # Represents a repeated `Value`.
+              "values": [ # Repeated field of dynamically typed values.
+                # Object with schema name: GenaiVertexV1Value
+              ],
+            },
+            "nullValue": "A String", # Represents a null value.
+            "numberValue": 3.14, # Represents a double value.
+            "stringValue": "A String", # Represents a string value.
+            "structValue": # Object with schema name: GenaiVertexV1Struct # Represents a structured value.
+          },
+        },
+      ],
+    },
+    "text": { # Configuration for text output format.
+      "mimeType": "A String", # The MIME type of the text output.
+      "schema": { # `Struct` represents a structured data value, consisting of fields which map to dynamically typed values. # The JSON schema that the output should conform to. Only applicable when mime_type is application/json.
+        "fields": [ # Dynamically typed fields. List instead of map because LLMs are sensitive to ordering, and we want to give users full control.
+          { # Represents a single field in a struct.
+            "name": "A String",
+            "value": { # `Value` represents a dynamically typed value which can be either null, a number, a string, a boolean, a recursive struct value, or a list of values. A producer of value is expected to set one of these variants. Absence of any variant indicates an error.
+              "boolValue": True or False, # Represents a boolean value.
+              "contentValue": { # The content of the response. # Represents rich content (text, image, etc.).
+                "audio": { # An audio content block.
+                  "channels": 42, # The number of audio channels.
+                  "data": "A String", # The audio content.
+                  "mimeTypeString": "A String", # Flexible MIME type string of the audio, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                  "sampleRate": 42, # The sample rate of the audio.
+                  "uri": "A String", # The URI of the audio.
+                },
+                "document": { # A document content block.
+                  "data": "A String", # The document content.
+                  "mimeTypeString": "A String", # Flexible MIME type string of the document, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                  "uri": "A String", # The URI of the document.
+                },
+                "image": { # An image content block.
+                  "data": "A String", # The image content.
+                  "mimeTypeString": "A String", # Flexible MIME type string of the image, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                  "resolution": "A String", # The resolution of the media.
+                  "uri": "A String", # The URI of the image.
+                },
+                "text": { # A text content block.
+                  "annotations": [ # Citation information for model-generated content.
+                    { # Citation information for model-generated content.
+                      "endIndex": 42, # End of the attributed segment, exclusive.
+                      "fileCitation": { # A file citation annotation. # A file citation annotation.
+                        "customMetadata": { # User provided metadata about the retrieved context.
+                          "a_key": "", # Properties of the object.
+                        },
+                        "documentUri": "A String", # The URI of the file.
+                        "fileName": "A String", # The name of the file.
+                        "mediaId": "A String", # Media ID in-case of image citations, if applicable.
+                        "pageNumber": 42, # Page number of the cited document, if applicable.
+                        "source": "A String", # Source attributed for a portion of the text.
+                      },
+                      "placeCitation": { # A place citation annotation. # A place citation annotation.
+                        "name": "A String", # Title of the place.
+                        "placeId": "A String", # The ID of the place, in `places/{place_id}` format.
+                        "reviewSnippets": [ # Snippets of reviews that are used to generate answers about the features of a given place in Google Maps.
+                          { # Encapsulates a snippet of a user review that answers a question about the features of a specific place in Google Maps.
+                            "reviewId": "A String", # The ID of the review snippet.
+                            "title": "A String", # Title of the review.
+                            "url": "A String", # A link that corresponds to the user review on Google Maps.
+                          },
+                        ],
+                        "url": "A String", # URI reference of the place.
+                      },
+                      "speechMetadata": { # Speech annotation for text content. # Speech annotation for text content.
+                        "speaker": "A String", # The speaker to associate with this turn.
+                        "style": "A String", # Style instruction for the speech synthesis.
+                      },
+                      "startIndex": 42, # Start of segment of the response that is attributed to this source. Index indicates the start of the segment, measured in bytes.
+                      "urlCitation": { # A URL citation annotation. # NOTE: We use these instead of the Citation message for historical reasons. A URL citation annotation.
+                        "title": "A String", # The title of the URL.
+                        "url": "A String", # The URL.
+                      },
+                      "wordInfo": { # Word-level ASR annotation for transcription output. Carries the word text, optional timing, and optional speaker attribution. # Word-level ASR annotation with timing and speaker info.
+                        "endOffset": "A String", # End offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                        "speaker": "A String", # Optional. Speaker label for this word (e.g. "spk_1", "spk_2"). Present when diarization_mode is set in TranscriptionConfig.
+                        "startOffset": "A String", # Start offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                        "text": "A String", # The transcribed word.
+                      },
+                    },
+                  ],
+                  "text": "A String", # Required. The text content.
+                },
+                "video": { # A video content block.
+                  "data": "A String", # The video content.
+                  "mimeTypeString": "A String", # Flexible MIME type string of the video, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                  "name": "A String", # A user-defined name for this content block. Can be referenced by the model in the final response.
+                  "processingConfig": {
+                    "static": {
+                      "endOffset": "A String", # Optional. Segment end time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "30s". Must be non-negative and greater than `start_offset` if `start_offset` is set.
+                      "fps": 3.14, # Optional. Video frame-rate sampling density.
+                      "startOffset": "A String", # Optional. Segment start time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "10.5s". Must be non-negative.
+                    },
+                  },
+                  "processingType": "A String",
+                  "resolution": "A String", # The resolution of the media.
+                  "uri": "A String", # The URI of the video.
+                },
+              },
+              "listValue": { # `ListValue` is a wrapper around a repeated field of values. # Represents a repeated `Value`.
+                "values": [ # Repeated field of dynamically typed values.
+                  # Object with schema name: GenaiVertexV1Value
+                ],
+              },
+              "nullValue": "A String", # Represents a null value.
+              "numberValue": 3.14, # Represents a double value.
+              "stringValue": "A String", # Represents a string value.
+              "structValue": # Object with schema name: GenaiVertexV1Struct # Represents a structured value.
+            },
+          },
+        ],
+      },
+    },
+    "video": { # Configuration for video output format.
+      "aspectRatio": "A String", # The aspect ratio for the video output.
+      "delivery": "A String", # The delivery mode for the video output.
+      "duration": "A String", # The duration for the video output.
+      "gcsUri": "A String", # The Cloud Storage URI to store the video output. Required for Vertex if delivery mode is URI.
+      "resolution": "A String", # The video output resolution. Defaults to 720p.
+    },
+  },
+  "safetySettings": [ # Safety settings for the interaction.
+    { # A safety setting that affects the safety-blocking behavior. A SafetySetting consists of a harm category and a threshold for that category.
+      "method": "A String", # Optional. The method for blocking content. If not specified, the default behavior is to use the probability score.
+      "threshold": "A String", # Required. The threshold for blocking content. If the harm probability exceeds this threshold, the content will be blocked.
+      "type": "A String", # Required. The type of harm category to be blocked.
+    },
+  ],
+  "serviceTier": "A String", # The service tier for the interaction.
+  "status": "A String", # Required. Output only. The status of the interaction.
+  "stepList": { # A list of Steps. # Input only. The steps for the interaction.
+    "steps": [ # The steps of the list.
+      { # A step in the interaction.
+        "modelOutput": { # Output generated by the model.
+          "content": [
+            { # The content of the response.
+              "audio": { # An audio content block.
+                "channels": 42, # The number of audio channels.
+                "data": "A String", # The audio content.
+                "mimeTypeString": "A String", # Flexible MIME type string of the audio, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                "sampleRate": 42, # The sample rate of the audio.
+                "uri": "A String", # The URI of the audio.
+              },
+              "document": { # A document content block.
+                "data": "A String", # The document content.
+                "mimeTypeString": "A String", # Flexible MIME type string of the document, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                "uri": "A String", # The URI of the document.
+              },
+              "image": { # An image content block.
+                "data": "A String", # The image content.
+                "mimeTypeString": "A String", # Flexible MIME type string of the image, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                "resolution": "A String", # The resolution of the media.
+                "uri": "A String", # The URI of the image.
+              },
+              "text": { # A text content block.
+                "annotations": [ # Citation information for model-generated content.
+                  { # Citation information for model-generated content.
+                    "endIndex": 42, # End of the attributed segment, exclusive.
+                    "fileCitation": { # A file citation annotation. # A file citation annotation.
+                      "customMetadata": { # User provided metadata about the retrieved context.
+                        "a_key": "", # Properties of the object.
+                      },
+                      "documentUri": "A String", # The URI of the file.
+                      "fileName": "A String", # The name of the file.
+                      "mediaId": "A String", # Media ID in-case of image citations, if applicable.
+                      "pageNumber": 42, # Page number of the cited document, if applicable.
+                      "source": "A String", # Source attributed for a portion of the text.
+                    },
+                    "placeCitation": { # A place citation annotation. # A place citation annotation.
+                      "name": "A String", # Title of the place.
+                      "placeId": "A String", # The ID of the place, in `places/{place_id}` format.
+                      "reviewSnippets": [ # Snippets of reviews that are used to generate answers about the features of a given place in Google Maps.
+                        { # Encapsulates a snippet of a user review that answers a question about the features of a specific place in Google Maps.
+                          "reviewId": "A String", # The ID of the review snippet.
+                          "title": "A String", # Title of the review.
+                          "url": "A String", # A link that corresponds to the user review on Google Maps.
+                        },
+                      ],
+                      "url": "A String", # URI reference of the place.
+                    },
+                    "speechMetadata": { # Speech annotation for text content. # Speech annotation for text content.
+                      "speaker": "A String", # The speaker to associate with this turn.
+                      "style": "A String", # Style instruction for the speech synthesis.
+                    },
+                    "startIndex": 42, # Start of segment of the response that is attributed to this source. Index indicates the start of the segment, measured in bytes.
+                    "urlCitation": { # A URL citation annotation. # NOTE: We use these instead of the Citation message for historical reasons. A URL citation annotation.
+                      "title": "A String", # The title of the URL.
+                      "url": "A String", # The URL.
+                    },
+                    "wordInfo": { # Word-level ASR annotation for transcription output. Carries the word text, optional timing, and optional speaker attribution. # Word-level ASR annotation with timing and speaker info.
+                      "endOffset": "A String", # End offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                      "speaker": "A String", # Optional. Speaker label for this word (e.g. "spk_1", "spk_2"). Present when diarization_mode is set in TranscriptionConfig.
+                      "startOffset": "A String", # Start offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                      "text": "A String", # The transcribed word.
+                    },
+                  },
+                ],
+                "text": "A String", # Required. The text content.
+              },
+              "video": { # A video content block.
+                "data": "A String", # The video content.
+                "mimeTypeString": "A String", # Flexible MIME type string of the video, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                "name": "A String", # A user-defined name for this content block. Can be referenced by the model in the final response.
+                "processingConfig": {
+                  "static": {
+                    "endOffset": "A String", # Optional. Segment end time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "30s". Must be non-negative and greater than `start_offset` if `start_offset` is set.
+                    "fps": 3.14, # Optional. Video frame-rate sampling density.
+                    "startOffset": "A String", # Optional. Segment start time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "10.5s". Must be non-negative.
+                  },
+                },
+                "processingType": "A String",
+                "resolution": "A String", # The resolution of the media.
+                "uri": "A String", # The URI of the video.
+              },
+            },
+          ],
+          "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.
+          },
+        },
+        "thought": { # A thought step.
+          "signature": "A String", # A signature hash for backend validation.
+          "summary": [ # A summary of the thought.
+            { # The content of the response.
+              "audio": { # An audio content block.
+                "channels": 42, # The number of audio channels.
+                "data": "A String", # The audio content.
+                "mimeTypeString": "A String", # Flexible MIME type string of the audio, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                "sampleRate": 42, # The sample rate of the audio.
+                "uri": "A String", # The URI of the audio.
+              },
+              "document": { # A document content block.
+                "data": "A String", # The document content.
+                "mimeTypeString": "A String", # Flexible MIME type string of the document, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                "uri": "A String", # The URI of the document.
+              },
+              "image": { # An image content block.
+                "data": "A String", # The image content.
+                "mimeTypeString": "A String", # Flexible MIME type string of the image, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                "resolution": "A String", # The resolution of the media.
+                "uri": "A String", # The URI of the image.
+              },
+              "text": { # A text content block.
+                "annotations": [ # Citation information for model-generated content.
+                  { # Citation information for model-generated content.
+                    "endIndex": 42, # End of the attributed segment, exclusive.
+                    "fileCitation": { # A file citation annotation. # A file citation annotation.
+                      "customMetadata": { # User provided metadata about the retrieved context.
+                        "a_key": "", # Properties of the object.
+                      },
+                      "documentUri": "A String", # The URI of the file.
+                      "fileName": "A String", # The name of the file.
+                      "mediaId": "A String", # Media ID in-case of image citations, if applicable.
+                      "pageNumber": 42, # Page number of the cited document, if applicable.
+                      "source": "A String", # Source attributed for a portion of the text.
+                    },
+                    "placeCitation": { # A place citation annotation. # A place citation annotation.
+                      "name": "A String", # Title of the place.
+                      "placeId": "A String", # The ID of the place, in `places/{place_id}` format.
+                      "reviewSnippets": [ # Snippets of reviews that are used to generate answers about the features of a given place in Google Maps.
+                        { # Encapsulates a snippet of a user review that answers a question about the features of a specific place in Google Maps.
+                          "reviewId": "A String", # The ID of the review snippet.
+                          "title": "A String", # Title of the review.
+                          "url": "A String", # A link that corresponds to the user review on Google Maps.
+                        },
+                      ],
+                      "url": "A String", # URI reference of the place.
+                    },
+                    "speechMetadata": { # Speech annotation for text content. # Speech annotation for text content.
+                      "speaker": "A String", # The speaker to associate with this turn.
+                      "style": "A String", # Style instruction for the speech synthesis.
+                    },
+                    "startIndex": 42, # Start of segment of the response that is attributed to this source. Index indicates the start of the segment, measured in bytes.
+                    "urlCitation": { # A URL citation annotation. # NOTE: We use these instead of the Citation message for historical reasons. A URL citation annotation.
+                      "title": "A String", # The title of the URL.
+                      "url": "A String", # The URL.
+                    },
+                    "wordInfo": { # Word-level ASR annotation for transcription output. Carries the word text, optional timing, and optional speaker attribution. # Word-level ASR annotation with timing and speaker info.
+                      "endOffset": "A String", # End offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                      "speaker": "A String", # Optional. Speaker label for this word (e.g. "spk_1", "spk_2"). Present when diarization_mode is set in TranscriptionConfig.
+                      "startOffset": "A String", # Start offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                      "text": "A String", # The transcribed word.
+                    },
+                  },
+                ],
+                "text": "A String", # Required. The text content.
+              },
+              "video": { # A video content block.
+                "data": "A String", # The video content.
+                "mimeTypeString": "A String", # Flexible MIME type string of the video, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                "name": "A String", # A user-defined name for this content block. Can be referenced by the model in the final response.
+                "processingConfig": {
+                  "static": {
+                    "endOffset": "A String", # Optional. Segment end time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "30s". Must be non-negative and greater than `start_offset` if `start_offset` is set.
+                    "fps": 3.14, # Optional. Video frame-rate sampling density.
+                    "startOffset": "A String", # Optional. Segment start time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "10.5s". Must be non-negative.
+                  },
+                },
+                "processingType": "A String",
+                "resolution": "A String", # The resolution of the media.
+                "uri": "A String", # The URI of the video.
+              },
+            },
+          ],
+        },
+        "toolCall": { # Tool call step.
+          "codeExecutionCall": { # Code execution call step.
+            "arguments": { # The arguments to pass to the code execution. # Required. The arguments to pass to the code execution.
+              "code": "A String", # The code to be executed.
+              "language": "A String", # Programming language of the `code`.
+            },
+          },
+          "fileSearchCall": { # File Search call step.
+          },
+          "functionCall": { # A function tool call step.
+            "arguments": { # `Struct` represents a structured data value, consisting of fields which map to dynamically typed values. # Required. The arguments to pass to the function.
+              "fields": [ # Dynamically typed fields. List instead of map because LLMs are sensitive to ordering, and we want to give users full control.
+                { # Represents a single field in a struct.
+                  "name": "A String",
+                  "value": { # `Value` represents a dynamically typed value which can be either null, a number, a string, a boolean, a recursive struct value, or a list of values. A producer of value is expected to set one of these variants. Absence of any variant indicates an error.
+                    "boolValue": True or False, # Represents a boolean value.
+                    "contentValue": { # The content of the response. # Represents rich content (text, image, etc.).
+                      "audio": { # An audio content block.
+                        "channels": 42, # The number of audio channels.
+                        "data": "A String", # The audio content.
+                        "mimeTypeString": "A String", # Flexible MIME type string of the audio, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                        "sampleRate": 42, # The sample rate of the audio.
+                        "uri": "A String", # The URI of the audio.
+                      },
+                      "document": { # A document content block.
+                        "data": "A String", # The document content.
+                        "mimeTypeString": "A String", # Flexible MIME type string of the document, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                        "uri": "A String", # The URI of the document.
+                      },
+                      "image": { # An image content block.
+                        "data": "A String", # The image content.
+                        "mimeTypeString": "A String", # Flexible MIME type string of the image, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                        "resolution": "A String", # The resolution of the media.
+                        "uri": "A String", # The URI of the image.
+                      },
+                      "text": { # A text content block.
+                        "annotations": [ # Citation information for model-generated content.
+                          { # Citation information for model-generated content.
+                            "endIndex": 42, # End of the attributed segment, exclusive.
+                            "fileCitation": { # A file citation annotation. # A file citation annotation.
+                              "customMetadata": { # User provided metadata about the retrieved context.
+                                "a_key": "", # Properties of the object.
+                              },
+                              "documentUri": "A String", # The URI of the file.
+                              "fileName": "A String", # The name of the file.
+                              "mediaId": "A String", # Media ID in-case of image citations, if applicable.
+                              "pageNumber": 42, # Page number of the cited document, if applicable.
+                              "source": "A String", # Source attributed for a portion of the text.
+                            },
+                            "placeCitation": { # A place citation annotation. # A place citation annotation.
+                              "name": "A String", # Title of the place.
+                              "placeId": "A String", # The ID of the place, in `places/{place_id}` format.
+                              "reviewSnippets": [ # Snippets of reviews that are used to generate answers about the features of a given place in Google Maps.
+                                { # Encapsulates a snippet of a user review that answers a question about the features of a specific place in Google Maps.
+                                  "reviewId": "A String", # The ID of the review snippet.
+                                  "title": "A String", # Title of the review.
+                                  "url": "A String", # A link that corresponds to the user review on Google Maps.
+                                },
+                              ],
+                              "url": "A String", # URI reference of the place.
+                            },
+                            "speechMetadata": { # Speech annotation for text content. # Speech annotation for text content.
+                              "speaker": "A String", # The speaker to associate with this turn.
+                              "style": "A String", # Style instruction for the speech synthesis.
+                            },
+                            "startIndex": 42, # Start of segment of the response that is attributed to this source. Index indicates the start of the segment, measured in bytes.
+                            "urlCitation": { # A URL citation annotation. # NOTE: We use these instead of the Citation message for historical reasons. A URL citation annotation.
+                              "title": "A String", # The title of the URL.
+                              "url": "A String", # The URL.
+                            },
+                            "wordInfo": { # Word-level ASR annotation for transcription output. Carries the word text, optional timing, and optional speaker attribution. # Word-level ASR annotation with timing and speaker info.
+                              "endOffset": "A String", # End offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                              "speaker": "A String", # Optional. Speaker label for this word (e.g. "spk_1", "spk_2"). Present when diarization_mode is set in TranscriptionConfig.
+                              "startOffset": "A String", # Start offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                              "text": "A String", # The transcribed word.
+                            },
+                          },
+                        ],
+                        "text": "A String", # Required. The text content.
+                      },
+                      "video": { # A video content block.
+                        "data": "A String", # The video content.
+                        "mimeTypeString": "A String", # Flexible MIME type string of the video, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                        "name": "A String", # A user-defined name for this content block. Can be referenced by the model in the final response.
+                        "processingConfig": {
+                          "static": {
+                            "endOffset": "A String", # Optional. Segment end time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "30s". Must be non-negative and greater than `start_offset` if `start_offset` is set.
+                            "fps": 3.14, # Optional. Video frame-rate sampling density.
+                            "startOffset": "A String", # Optional. Segment start time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "10.5s". Must be non-negative.
+                          },
+                        },
+                        "processingType": "A String",
+                        "resolution": "A String", # The resolution of the media.
+                        "uri": "A String", # The URI of the video.
+                      },
+                    },
+                    "listValue": { # `ListValue` is a wrapper around a repeated field of values. # Represents a repeated `Value`.
+                      "values": [ # Repeated field of dynamically typed values.
+                        # Object with schema name: GenaiVertexV1Value
+                      ],
+                    },
+                    "nullValue": "A String", # Represents a null value.
+                    "numberValue": 3.14, # Represents a double value.
+                    "stringValue": "A String", # Represents a string value.
+                    "structValue": # Object with schema name: GenaiVertexV1Struct # Represents a structured value.
+                  },
+                },
+              ],
+            },
+            "name": "A String", # Required. The name of the tool to call.
+          },
+          "googleMapsCall": { # Google Maps call step.
+            "arguments": { # The arguments to pass to the Google Maps tool. # The arguments to pass to the Google Maps tool.
+              "queries": [ # The queries to be executed.
+                "A String",
+              ],
+            },
+          },
+          "googleSearchCall": { # Google Search call step.
+            "arguments": { # The arguments to pass to Google Search. # Required. The arguments to pass to Google Search.
+              "queries": [ # Web search queries for the following-up web search.
+                "A String",
+              ],
+            },
+            "searchType": "A String", # The type of search grounding enabled.
+          },
+          "id": "A String", # Required. A unique ID for this specific tool call.
+          "processingCall": { # A server-initiated processing step for media analysis (e.g. video understanding).
+          },
+          "retrievalCall": { # Retrieval call step. Used by Vertex Retrieval tools such as Parallel AI, Exa AI, Vertex AI Search, etc. RetrievalType decides which tool is used.
+            "arguments": { # The arguments to pass to Retrieval tools. # Required. The arguments to pass to the retrieval tool.
+              "queries": [ # Queries for Retrieval information.
+                "A String",
+              ],
+            },
+            "retrievalType": "A String", # The type of retrieval tools.
+          },
+          "signature": "A String", # A signature hash for backend validation.
+          "urlContextCall": { # URL context call step.
+            "arguments": { # The arguments to pass to the URL context. # Required. The arguments to pass to the URL context.
+              "urls": [ # The URLs to fetch.
+                "A String",
+              ],
+            },
+          },
+        },
+        "toolResult": { # Tool result step.
+          "callId": "A String", # Required. ID to match the ID from the function call block.
+          "codeExecutionResult": { # Code execution result step.
+            "isError": True or False, # Whether the code execution resulted in an error.
+            "result": "A String", # Required. The output of the code execution.
+          },
+          "fileSearchResult": { # File Search result step.
+          },
+          "functionResult": { # Result of a function tool call.
+            "isError": True or False, # Whether the tool call resulted in an error.
+            "name": "A String", # The name of the tool that was called.
+            "result": { # `Value` represents a dynamically typed value which can be either null, a number, a string, a boolean, a recursive struct value, or a list of values. A producer of value is expected to set one of these variants. Absence of any variant indicates an error. # Required. The result of the tool call.
+              "boolValue": True or False, # Represents a boolean value.
+              "contentValue": { # The content of the response. # Represents rich content (text, image, etc.).
+                "audio": { # An audio content block.
+                  "channels": 42, # The number of audio channels.
+                  "data": "A String", # The audio content.
+                  "mimeTypeString": "A String", # Flexible MIME type string of the audio, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                  "sampleRate": 42, # The sample rate of the audio.
+                  "uri": "A String", # The URI of the audio.
+                },
+                "document": { # A document content block.
+                  "data": "A String", # The document content.
+                  "mimeTypeString": "A String", # Flexible MIME type string of the document, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                  "uri": "A String", # The URI of the document.
+                },
+                "image": { # An image content block.
+                  "data": "A String", # The image content.
+                  "mimeTypeString": "A String", # Flexible MIME type string of the image, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                  "resolution": "A String", # The resolution of the media.
+                  "uri": "A String", # The URI of the image.
+                },
+                "text": { # A text content block.
+                  "annotations": [ # Citation information for model-generated content.
+                    { # Citation information for model-generated content.
+                      "endIndex": 42, # End of the attributed segment, exclusive.
+                      "fileCitation": { # A file citation annotation. # A file citation annotation.
+                        "customMetadata": { # User provided metadata about the retrieved context.
+                          "a_key": "", # Properties of the object.
+                        },
+                        "documentUri": "A String", # The URI of the file.
+                        "fileName": "A String", # The name of the file.
+                        "mediaId": "A String", # Media ID in-case of image citations, if applicable.
+                        "pageNumber": 42, # Page number of the cited document, if applicable.
+                        "source": "A String", # Source attributed for a portion of the text.
+                      },
+                      "placeCitation": { # A place citation annotation. # A place citation annotation.
+                        "name": "A String", # Title of the place.
+                        "placeId": "A String", # The ID of the place, in `places/{place_id}` format.
+                        "reviewSnippets": [ # Snippets of reviews that are used to generate answers about the features of a given place in Google Maps.
+                          { # Encapsulates a snippet of a user review that answers a question about the features of a specific place in Google Maps.
+                            "reviewId": "A String", # The ID of the review snippet.
+                            "title": "A String", # Title of the review.
+                            "url": "A String", # A link that corresponds to the user review on Google Maps.
+                          },
+                        ],
+                        "url": "A String", # URI reference of the place.
+                      },
+                      "speechMetadata": { # Speech annotation for text content. # Speech annotation for text content.
+                        "speaker": "A String", # The speaker to associate with this turn.
+                        "style": "A String", # Style instruction for the speech synthesis.
+                      },
+                      "startIndex": 42, # Start of segment of the response that is attributed to this source. Index indicates the start of the segment, measured in bytes.
+                      "urlCitation": { # A URL citation annotation. # NOTE: We use these instead of the Citation message for historical reasons. A URL citation annotation.
+                        "title": "A String", # The title of the URL.
+                        "url": "A String", # The URL.
+                      },
+                      "wordInfo": { # Word-level ASR annotation for transcription output. Carries the word text, optional timing, and optional speaker attribution. # Word-level ASR annotation with timing and speaker info.
+                        "endOffset": "A String", # End offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                        "speaker": "A String", # Optional. Speaker label for this word (e.g. "spk_1", "spk_2"). Present when diarization_mode is set in TranscriptionConfig.
+                        "startOffset": "A String", # Start offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                        "text": "A String", # The transcribed word.
+                      },
+                    },
+                  ],
+                  "text": "A String", # Required. The text content.
+                },
+                "video": { # A video content block.
+                  "data": "A String", # The video content.
+                  "mimeTypeString": "A String", # Flexible MIME type string of the video, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                  "name": "A String", # A user-defined name for this content block. Can be referenced by the model in the final response.
+                  "processingConfig": {
+                    "static": {
+                      "endOffset": "A String", # Optional. Segment end time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "30s". Must be non-negative and greater than `start_offset` if `start_offset` is set.
+                      "fps": 3.14, # Optional. Video frame-rate sampling density.
+                      "startOffset": "A String", # Optional. Segment start time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "10.5s". Must be non-negative.
+                    },
+                  },
+                  "processingType": "A String",
+                  "resolution": "A String", # The resolution of the media.
+                  "uri": "A String", # The URI of the video.
+                },
+              },
+              "listValue": { # `ListValue` is a wrapper around a repeated field of values. # Represents a repeated `Value`.
+                "values": [ # Repeated field of dynamically typed values.
+                  # Object with schema name: GenaiVertexV1Value
+                ],
+              },
+              "nullValue": "A String", # Represents a null value.
+              "numberValue": 3.14, # Represents a double value.
+              "stringValue": "A String", # Represents a string value.
+              "structValue": # Object with schema name: GenaiVertexV1Struct # Represents a structured value.
+            },
+          },
+          "googleMapsResult": { # Google Maps result step.
+            "result": [
+              { # The result of the Google Maps.
+                "places": [
+                  {
+                    "name": "A String",
+                    "placeId": "A String",
+                    "reviewSnippets": [
+                      { # Encapsulates a snippet of a user review that answers a question about the features of a specific place in Google Maps.
+                        "reviewId": "A String", # The ID of the review snippet.
+                        "title": "A String", # Title of the review.
+                        "url": "A String", # A link that corresponds to the user review on Google Maps.
+                      },
+                    ],
+                    "url": "A String",
+                  },
+                ],
+                "widgetContextToken": "A String",
+              },
+            ],
+          },
+          "googleSearchResult": { # Google Search result step.
+            "isError": True or False, # Whether the Google Search resulted in an error.
+            "result": [ # Required. The results of the Google Search.
+              { # The result of the Google Search.
+                "searchSuggestions": "A String", # Web content snippet that can be embedded in a web page or an app webview.
+              },
+            ],
+          },
+          "processingResult": { # The result of a server-initiated media processing step.
+          },
+          "retrievalResult": { # Vertex Retrieval result step. Used by Vertex Retrieval tools such as Parallel AI, Exa AI, Vertex AI Search, etc.
+            "isError": True or False, # Whether the retrieval resulted in an error.
+          },
+          "signature": "A String", # A signature hash for backend validation.
+          "urlContextResult": { # URL context result step.
+            "isError": True or False, # Whether the URL context resulted in an error.
+            "result": [ # Required. The results of the URL context.
+              { # The result of the URL context.
+                "status": "A String", # The status of the URL retrieval.
+                "url": "A String", # The URL that was fetched.
+              },
+            ],
+          },
+        },
+        "userInput": { # Input provided by the user. # DO NOT USE -- These are for 3P JSON only
+          "contentList": { # A list of Content. # The content of the step. An array of Content objects.
+            "contents": [ # The contents of the list.
+              { # The content of the response.
+                "audio": { # An audio content block.
+                  "channels": 42, # The number of audio channels.
+                  "data": "A String", # The audio content.
+                  "mimeTypeString": "A String", # Flexible MIME type string of the audio, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                  "sampleRate": 42, # The sample rate of the audio.
+                  "uri": "A String", # The URI of the audio.
+                },
+                "document": { # A document content block.
+                  "data": "A String", # The document content.
+                  "mimeTypeString": "A String", # Flexible MIME type string of the document, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                  "uri": "A String", # The URI of the document.
+                },
+                "image": { # An image content block.
+                  "data": "A String", # The image content.
+                  "mimeTypeString": "A String", # Flexible MIME type string of the image, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                  "resolution": "A String", # The resolution of the media.
+                  "uri": "A String", # The URI of the image.
+                },
+                "text": { # A text content block.
+                  "annotations": [ # Citation information for model-generated content.
+                    { # Citation information for model-generated content.
+                      "endIndex": 42, # End of the attributed segment, exclusive.
+                      "fileCitation": { # A file citation annotation. # A file citation annotation.
+                        "customMetadata": { # User provided metadata about the retrieved context.
+                          "a_key": "", # Properties of the object.
+                        },
+                        "documentUri": "A String", # The URI of the file.
+                        "fileName": "A String", # The name of the file.
+                        "mediaId": "A String", # Media ID in-case of image citations, if applicable.
+                        "pageNumber": 42, # Page number of the cited document, if applicable.
+                        "source": "A String", # Source attributed for a portion of the text.
+                      },
+                      "placeCitation": { # A place citation annotation. # A place citation annotation.
+                        "name": "A String", # Title of the place.
+                        "placeId": "A String", # The ID of the place, in `places/{place_id}` format.
+                        "reviewSnippets": [ # Snippets of reviews that are used to generate answers about the features of a given place in Google Maps.
+                          { # Encapsulates a snippet of a user review that answers a question about the features of a specific place in Google Maps.
+                            "reviewId": "A String", # The ID of the review snippet.
+                            "title": "A String", # Title of the review.
+                            "url": "A String", # A link that corresponds to the user review on Google Maps.
+                          },
+                        ],
+                        "url": "A String", # URI reference of the place.
+                      },
+                      "speechMetadata": { # Speech annotation for text content. # Speech annotation for text content.
+                        "speaker": "A String", # The speaker to associate with this turn.
+                        "style": "A String", # Style instruction for the speech synthesis.
+                      },
+                      "startIndex": 42, # Start of segment of the response that is attributed to this source. Index indicates the start of the segment, measured in bytes.
+                      "urlCitation": { # A URL citation annotation. # NOTE: We use these instead of the Citation message for historical reasons. A URL citation annotation.
+                        "title": "A String", # The title of the URL.
+                        "url": "A String", # The URL.
+                      },
+                      "wordInfo": { # Word-level ASR annotation for transcription output. Carries the word text, optional timing, and optional speaker attribution. # Word-level ASR annotation with timing and speaker info.
+                        "endOffset": "A String", # End offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                        "speaker": "A String", # Optional. Speaker label for this word (e.g. "spk_1", "spk_2"). Present when diarization_mode is set in TranscriptionConfig.
+                        "startOffset": "A String", # Start offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                        "text": "A String", # The transcribed word.
+                      },
+                    },
+                  ],
+                  "text": "A String", # Required. The text content.
+                },
+                "video": { # A video content block.
+                  "data": "A String", # The video content.
+                  "mimeTypeString": "A String", # Flexible MIME type string of the video, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                  "name": "A String", # A user-defined name for this content block. Can be referenced by the model in the final response.
+                  "processingConfig": {
+                    "static": {
+                      "endOffset": "A String", # Optional. Segment end time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "30s". Must be non-negative and greater than `start_offset` if `start_offset` is set.
+                      "fps": 3.14, # Optional. Video frame-rate sampling density.
+                      "startOffset": "A String", # Optional. Segment start time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "10.5s". Must be non-negative.
+                    },
+                  },
+                  "processingType": "A String",
+                  "resolution": "A String", # The resolution of the media.
+                  "uri": "A String", # The URI of the video.
+                },
+              },
+            ],
+          },
+          "contentString": "A String", # The content of the step. A single string.
+        },
+      },
+    ],
+  },
+  "steps": [ # Required. Output only. The steps that make up the interaction, when included in the response.
+    { # A step in the interaction.
+      "modelOutput": { # Output generated by the model.
+        "content": [
+          { # The content of the response.
+            "audio": { # An audio content block.
+              "channels": 42, # The number of audio channels.
+              "data": "A String", # The audio content.
+              "mimeTypeString": "A String", # Flexible MIME type string of the audio, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+              "sampleRate": 42, # The sample rate of the audio.
+              "uri": "A String", # The URI of the audio.
+            },
+            "document": { # A document content block.
+              "data": "A String", # The document content.
+              "mimeTypeString": "A String", # Flexible MIME type string of the document, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+              "uri": "A String", # The URI of the document.
+            },
+            "image": { # An image content block.
+              "data": "A String", # The image content.
+              "mimeTypeString": "A String", # Flexible MIME type string of the image, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+              "resolution": "A String", # The resolution of the media.
+              "uri": "A String", # The URI of the image.
+            },
+            "text": { # A text content block.
+              "annotations": [ # Citation information for model-generated content.
+                { # Citation information for model-generated content.
+                  "endIndex": 42, # End of the attributed segment, exclusive.
+                  "fileCitation": { # A file citation annotation. # A file citation annotation.
+                    "customMetadata": { # User provided metadata about the retrieved context.
+                      "a_key": "", # Properties of the object.
+                    },
+                    "documentUri": "A String", # The URI of the file.
+                    "fileName": "A String", # The name of the file.
+                    "mediaId": "A String", # Media ID in-case of image citations, if applicable.
+                    "pageNumber": 42, # Page number of the cited document, if applicable.
+                    "source": "A String", # Source attributed for a portion of the text.
+                  },
+                  "placeCitation": { # A place citation annotation. # A place citation annotation.
+                    "name": "A String", # Title of the place.
+                    "placeId": "A String", # The ID of the place, in `places/{place_id}` format.
+                    "reviewSnippets": [ # Snippets of reviews that are used to generate answers about the features of a given place in Google Maps.
+                      { # Encapsulates a snippet of a user review that answers a question about the features of a specific place in Google Maps.
+                        "reviewId": "A String", # The ID of the review snippet.
+                        "title": "A String", # Title of the review.
+                        "url": "A String", # A link that corresponds to the user review on Google Maps.
+                      },
+                    ],
+                    "url": "A String", # URI reference of the place.
+                  },
+                  "speechMetadata": { # Speech annotation for text content. # Speech annotation for text content.
+                    "speaker": "A String", # The speaker to associate with this turn.
+                    "style": "A String", # Style instruction for the speech synthesis.
+                  },
+                  "startIndex": 42, # Start of segment of the response that is attributed to this source. Index indicates the start of the segment, measured in bytes.
+                  "urlCitation": { # A URL citation annotation. # NOTE: We use these instead of the Citation message for historical reasons. A URL citation annotation.
+                    "title": "A String", # The title of the URL.
+                    "url": "A String", # The URL.
+                  },
+                  "wordInfo": { # Word-level ASR annotation for transcription output. Carries the word text, optional timing, and optional speaker attribution. # Word-level ASR annotation with timing and speaker info.
+                    "endOffset": "A String", # End offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                    "speaker": "A String", # Optional. Speaker label for this word (e.g. "spk_1", "spk_2"). Present when diarization_mode is set in TranscriptionConfig.
+                    "startOffset": "A String", # Start offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                    "text": "A String", # The transcribed word.
+                  },
+                },
+              ],
+              "text": "A String", # Required. The text content.
+            },
+            "video": { # A video content block.
+              "data": "A String", # The video content.
+              "mimeTypeString": "A String", # Flexible MIME type string of the video, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+              "name": "A String", # A user-defined name for this content block. Can be referenced by the model in the final response.
+              "processingConfig": {
+                "static": {
+                  "endOffset": "A String", # Optional. Segment end time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "30s". Must be non-negative and greater than `start_offset` if `start_offset` is set.
+                  "fps": 3.14, # Optional. Video frame-rate sampling density.
+                  "startOffset": "A String", # Optional. Segment start time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "10.5s". Must be non-negative.
+                },
+              },
+              "processingType": "A String",
+              "resolution": "A String", # The resolution of the media.
+              "uri": "A String", # The URI of the video.
+            },
+          },
+        ],
+        "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.
+        },
+      },
+      "thought": { # A thought step.
+        "signature": "A String", # A signature hash for backend validation.
+        "summary": [ # A summary of the thought.
+          { # The content of the response.
+            "audio": { # An audio content block.
+              "channels": 42, # The number of audio channels.
+              "data": "A String", # The audio content.
+              "mimeTypeString": "A String", # Flexible MIME type string of the audio, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+              "sampleRate": 42, # The sample rate of the audio.
+              "uri": "A String", # The URI of the audio.
+            },
+            "document": { # A document content block.
+              "data": "A String", # The document content.
+              "mimeTypeString": "A String", # Flexible MIME type string of the document, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+              "uri": "A String", # The URI of the document.
+            },
+            "image": { # An image content block.
+              "data": "A String", # The image content.
+              "mimeTypeString": "A String", # Flexible MIME type string of the image, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+              "resolution": "A String", # The resolution of the media.
+              "uri": "A String", # The URI of the image.
+            },
+            "text": { # A text content block.
+              "annotations": [ # Citation information for model-generated content.
+                { # Citation information for model-generated content.
+                  "endIndex": 42, # End of the attributed segment, exclusive.
+                  "fileCitation": { # A file citation annotation. # A file citation annotation.
+                    "customMetadata": { # User provided metadata about the retrieved context.
+                      "a_key": "", # Properties of the object.
+                    },
+                    "documentUri": "A String", # The URI of the file.
+                    "fileName": "A String", # The name of the file.
+                    "mediaId": "A String", # Media ID in-case of image citations, if applicable.
+                    "pageNumber": 42, # Page number of the cited document, if applicable.
+                    "source": "A String", # Source attributed for a portion of the text.
+                  },
+                  "placeCitation": { # A place citation annotation. # A place citation annotation.
+                    "name": "A String", # Title of the place.
+                    "placeId": "A String", # The ID of the place, in `places/{place_id}` format.
+                    "reviewSnippets": [ # Snippets of reviews that are used to generate answers about the features of a given place in Google Maps.
+                      { # Encapsulates a snippet of a user review that answers a question about the features of a specific place in Google Maps.
+                        "reviewId": "A String", # The ID of the review snippet.
+                        "title": "A String", # Title of the review.
+                        "url": "A String", # A link that corresponds to the user review on Google Maps.
+                      },
+                    ],
+                    "url": "A String", # URI reference of the place.
+                  },
+                  "speechMetadata": { # Speech annotation for text content. # Speech annotation for text content.
+                    "speaker": "A String", # The speaker to associate with this turn.
+                    "style": "A String", # Style instruction for the speech synthesis.
+                  },
+                  "startIndex": 42, # Start of segment of the response that is attributed to this source. Index indicates the start of the segment, measured in bytes.
+                  "urlCitation": { # A URL citation annotation. # NOTE: We use these instead of the Citation message for historical reasons. A URL citation annotation.
+                    "title": "A String", # The title of the URL.
+                    "url": "A String", # The URL.
+                  },
+                  "wordInfo": { # Word-level ASR annotation for transcription output. Carries the word text, optional timing, and optional speaker attribution. # Word-level ASR annotation with timing and speaker info.
+                    "endOffset": "A String", # End offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                    "speaker": "A String", # Optional. Speaker label for this word (e.g. "spk_1", "spk_2"). Present when diarization_mode is set in TranscriptionConfig.
+                    "startOffset": "A String", # Start offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                    "text": "A String", # The transcribed word.
+                  },
+                },
+              ],
+              "text": "A String", # Required. The text content.
+            },
+            "video": { # A video content block.
+              "data": "A String", # The video content.
+              "mimeTypeString": "A String", # Flexible MIME type string of the video, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+              "name": "A String", # A user-defined name for this content block. Can be referenced by the model in the final response.
+              "processingConfig": {
+                "static": {
+                  "endOffset": "A String", # Optional. Segment end time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "30s". Must be non-negative and greater than `start_offset` if `start_offset` is set.
+                  "fps": 3.14, # Optional. Video frame-rate sampling density.
+                  "startOffset": "A String", # Optional. Segment start time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "10.5s". Must be non-negative.
+                },
+              },
+              "processingType": "A String",
+              "resolution": "A String", # The resolution of the media.
+              "uri": "A String", # The URI of the video.
+            },
+          },
+        ],
+      },
+      "toolCall": { # Tool call step.
+        "codeExecutionCall": { # Code execution call step.
+          "arguments": { # The arguments to pass to the code execution. # Required. The arguments to pass to the code execution.
+            "code": "A String", # The code to be executed.
+            "language": "A String", # Programming language of the `code`.
+          },
+        },
+        "fileSearchCall": { # File Search call step.
+        },
+        "functionCall": { # A function tool call step.
+          "arguments": { # `Struct` represents a structured data value, consisting of fields which map to dynamically typed values. # Required. The arguments to pass to the function.
+            "fields": [ # Dynamically typed fields. List instead of map because LLMs are sensitive to ordering, and we want to give users full control.
+              { # Represents a single field in a struct.
+                "name": "A String",
+                "value": { # `Value` represents a dynamically typed value which can be either null, a number, a string, a boolean, a recursive struct value, or a list of values. A producer of value is expected to set one of these variants. Absence of any variant indicates an error.
+                  "boolValue": True or False, # Represents a boolean value.
+                  "contentValue": { # The content of the response. # Represents rich content (text, image, etc.).
+                    "audio": { # An audio content block.
+                      "channels": 42, # The number of audio channels.
+                      "data": "A String", # The audio content.
+                      "mimeTypeString": "A String", # Flexible MIME type string of the audio, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                      "sampleRate": 42, # The sample rate of the audio.
+                      "uri": "A String", # The URI of the audio.
+                    },
+                    "document": { # A document content block.
+                      "data": "A String", # The document content.
+                      "mimeTypeString": "A String", # Flexible MIME type string of the document, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                      "uri": "A String", # The URI of the document.
+                    },
+                    "image": { # An image content block.
+                      "data": "A String", # The image content.
+                      "mimeTypeString": "A String", # Flexible MIME type string of the image, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                      "resolution": "A String", # The resolution of the media.
+                      "uri": "A String", # The URI of the image.
+                    },
+                    "text": { # A text content block.
+                      "annotations": [ # Citation information for model-generated content.
+                        { # Citation information for model-generated content.
+                          "endIndex": 42, # End of the attributed segment, exclusive.
+                          "fileCitation": { # A file citation annotation. # A file citation annotation.
+                            "customMetadata": { # User provided metadata about the retrieved context.
+                              "a_key": "", # Properties of the object.
+                            },
+                            "documentUri": "A String", # The URI of the file.
+                            "fileName": "A String", # The name of the file.
+                            "mediaId": "A String", # Media ID in-case of image citations, if applicable.
+                            "pageNumber": 42, # Page number of the cited document, if applicable.
+                            "source": "A String", # Source attributed for a portion of the text.
+                          },
+                          "placeCitation": { # A place citation annotation. # A place citation annotation.
+                            "name": "A String", # Title of the place.
+                            "placeId": "A String", # The ID of the place, in `places/{place_id}` format.
+                            "reviewSnippets": [ # Snippets of reviews that are used to generate answers about the features of a given place in Google Maps.
+                              { # Encapsulates a snippet of a user review that answers a question about the features of a specific place in Google Maps.
+                                "reviewId": "A String", # The ID of the review snippet.
+                                "title": "A String", # Title of the review.
+                                "url": "A String", # A link that corresponds to the user review on Google Maps.
+                              },
+                            ],
+                            "url": "A String", # URI reference of the place.
+                          },
+                          "speechMetadata": { # Speech annotation for text content. # Speech annotation for text content.
+                            "speaker": "A String", # The speaker to associate with this turn.
+                            "style": "A String", # Style instruction for the speech synthesis.
+                          },
+                          "startIndex": 42, # Start of segment of the response that is attributed to this source. Index indicates the start of the segment, measured in bytes.
+                          "urlCitation": { # A URL citation annotation. # NOTE: We use these instead of the Citation message for historical reasons. A URL citation annotation.
+                            "title": "A String", # The title of the URL.
+                            "url": "A String", # The URL.
+                          },
+                          "wordInfo": { # Word-level ASR annotation for transcription output. Carries the word text, optional timing, and optional speaker attribution. # Word-level ASR annotation with timing and speaker info.
+                            "endOffset": "A String", # End offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                            "speaker": "A String", # Optional. Speaker label for this word (e.g. "spk_1", "spk_2"). Present when diarization_mode is set in TranscriptionConfig.
+                            "startOffset": "A String", # Start offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                            "text": "A String", # The transcribed word.
+                          },
+                        },
+                      ],
+                      "text": "A String", # Required. The text content.
+                    },
+                    "video": { # A video content block.
+                      "data": "A String", # The video content.
+                      "mimeTypeString": "A String", # Flexible MIME type string of the video, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                      "name": "A String", # A user-defined name for this content block. Can be referenced by the model in the final response.
+                      "processingConfig": {
+                        "static": {
+                          "endOffset": "A String", # Optional. Segment end time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "30s". Must be non-negative and greater than `start_offset` if `start_offset` is set.
+                          "fps": 3.14, # Optional. Video frame-rate sampling density.
+                          "startOffset": "A String", # Optional. Segment start time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "10.5s". Must be non-negative.
+                        },
+                      },
+                      "processingType": "A String",
+                      "resolution": "A String", # The resolution of the media.
+                      "uri": "A String", # The URI of the video.
+                    },
+                  },
+                  "listValue": { # `ListValue` is a wrapper around a repeated field of values. # Represents a repeated `Value`.
+                    "values": [ # Repeated field of dynamically typed values.
+                      # Object with schema name: GenaiVertexV1Value
+                    ],
+                  },
+                  "nullValue": "A String", # Represents a null value.
+                  "numberValue": 3.14, # Represents a double value.
+                  "stringValue": "A String", # Represents a string value.
+                  "structValue": # Object with schema name: GenaiVertexV1Struct # Represents a structured value.
+                },
+              },
+            ],
+          },
+          "name": "A String", # Required. The name of the tool to call.
+        },
+        "googleMapsCall": { # Google Maps call step.
+          "arguments": { # The arguments to pass to the Google Maps tool. # The arguments to pass to the Google Maps tool.
+            "queries": [ # The queries to be executed.
+              "A String",
+            ],
+          },
+        },
+        "googleSearchCall": { # Google Search call step.
+          "arguments": { # The arguments to pass to Google Search. # Required. The arguments to pass to Google Search.
+            "queries": [ # Web search queries for the following-up web search.
+              "A String",
+            ],
+          },
+          "searchType": "A String", # The type of search grounding enabled.
+        },
+        "id": "A String", # Required. A unique ID for this specific tool call.
+        "processingCall": { # A server-initiated processing step for media analysis (e.g. video understanding).
+        },
+        "retrievalCall": { # Retrieval call step. Used by Vertex Retrieval tools such as Parallel AI, Exa AI, Vertex AI Search, etc. RetrievalType decides which tool is used.
+          "arguments": { # The arguments to pass to Retrieval tools. # Required. The arguments to pass to the retrieval tool.
+            "queries": [ # Queries for Retrieval information.
+              "A String",
+            ],
+          },
+          "retrievalType": "A String", # The type of retrieval tools.
+        },
+        "signature": "A String", # A signature hash for backend validation.
+        "urlContextCall": { # URL context call step.
+          "arguments": { # The arguments to pass to the URL context. # Required. The arguments to pass to the URL context.
+            "urls": [ # The URLs to fetch.
+              "A String",
+            ],
+          },
+        },
+      },
+      "toolResult": { # Tool result step.
+        "callId": "A String", # Required. ID to match the ID from the function call block.
+        "codeExecutionResult": { # Code execution result step.
+          "isError": True or False, # Whether the code execution resulted in an error.
+          "result": "A String", # Required. The output of the code execution.
+        },
+        "fileSearchResult": { # File Search result step.
+        },
+        "functionResult": { # Result of a function tool call.
+          "isError": True or False, # Whether the tool call resulted in an error.
+          "name": "A String", # The name of the tool that was called.
+          "result": { # `Value` represents a dynamically typed value which can be either null, a number, a string, a boolean, a recursive struct value, or a list of values. A producer of value is expected to set one of these variants. Absence of any variant indicates an error. # Required. The result of the tool call.
+            "boolValue": True or False, # Represents a boolean value.
+            "contentValue": { # The content of the response. # Represents rich content (text, image, etc.).
+              "audio": { # An audio content block.
+                "channels": 42, # The number of audio channels.
+                "data": "A String", # The audio content.
+                "mimeTypeString": "A String", # Flexible MIME type string of the audio, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                "sampleRate": 42, # The sample rate of the audio.
+                "uri": "A String", # The URI of the audio.
+              },
+              "document": { # A document content block.
+                "data": "A String", # The document content.
+                "mimeTypeString": "A String", # Flexible MIME type string of the document, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                "uri": "A String", # The URI of the document.
+              },
+              "image": { # An image content block.
+                "data": "A String", # The image content.
+                "mimeTypeString": "A String", # Flexible MIME type string of the image, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                "resolution": "A String", # The resolution of the media.
+                "uri": "A String", # The URI of the image.
+              },
+              "text": { # A text content block.
+                "annotations": [ # Citation information for model-generated content.
+                  { # Citation information for model-generated content.
+                    "endIndex": 42, # End of the attributed segment, exclusive.
+                    "fileCitation": { # A file citation annotation. # A file citation annotation.
+                      "customMetadata": { # User provided metadata about the retrieved context.
+                        "a_key": "", # Properties of the object.
+                      },
+                      "documentUri": "A String", # The URI of the file.
+                      "fileName": "A String", # The name of the file.
+                      "mediaId": "A String", # Media ID in-case of image citations, if applicable.
+                      "pageNumber": 42, # Page number of the cited document, if applicable.
+                      "source": "A String", # Source attributed for a portion of the text.
+                    },
+                    "placeCitation": { # A place citation annotation. # A place citation annotation.
+                      "name": "A String", # Title of the place.
+                      "placeId": "A String", # The ID of the place, in `places/{place_id}` format.
+                      "reviewSnippets": [ # Snippets of reviews that are used to generate answers about the features of a given place in Google Maps.
+                        { # Encapsulates a snippet of a user review that answers a question about the features of a specific place in Google Maps.
+                          "reviewId": "A String", # The ID of the review snippet.
+                          "title": "A String", # Title of the review.
+                          "url": "A String", # A link that corresponds to the user review on Google Maps.
+                        },
+                      ],
+                      "url": "A String", # URI reference of the place.
+                    },
+                    "speechMetadata": { # Speech annotation for text content. # Speech annotation for text content.
+                      "speaker": "A String", # The speaker to associate with this turn.
+                      "style": "A String", # Style instruction for the speech synthesis.
+                    },
+                    "startIndex": 42, # Start of segment of the response that is attributed to this source. Index indicates the start of the segment, measured in bytes.
+                    "urlCitation": { # A URL citation annotation. # NOTE: We use these instead of the Citation message for historical reasons. A URL citation annotation.
+                      "title": "A String", # The title of the URL.
+                      "url": "A String", # The URL.
+                    },
+                    "wordInfo": { # Word-level ASR annotation for transcription output. Carries the word text, optional timing, and optional speaker attribution. # Word-level ASR annotation with timing and speaker info.
+                      "endOffset": "A String", # End offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                      "speaker": "A String", # Optional. Speaker label for this word (e.g. "spk_1", "spk_2"). Present when diarization_mode is set in TranscriptionConfig.
+                      "startOffset": "A String", # Start offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                      "text": "A String", # The transcribed word.
+                    },
+                  },
+                ],
+                "text": "A String", # Required. The text content.
+              },
+              "video": { # A video content block.
+                "data": "A String", # The video content.
+                "mimeTypeString": "A String", # Flexible MIME type string of the video, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                "name": "A String", # A user-defined name for this content block. Can be referenced by the model in the final response.
+                "processingConfig": {
+                  "static": {
+                    "endOffset": "A String", # Optional. Segment end time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "30s". Must be non-negative and greater than `start_offset` if `start_offset` is set.
+                    "fps": 3.14, # Optional. Video frame-rate sampling density.
+                    "startOffset": "A String", # Optional. Segment start time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "10.5s". Must be non-negative.
+                  },
+                },
+                "processingType": "A String",
+                "resolution": "A String", # The resolution of the media.
+                "uri": "A String", # The URI of the video.
+              },
+            },
+            "listValue": { # `ListValue` is a wrapper around a repeated field of values. # Represents a repeated `Value`.
+              "values": [ # Repeated field of dynamically typed values.
+                # Object with schema name: GenaiVertexV1Value
+              ],
+            },
+            "nullValue": "A String", # Represents a null value.
+            "numberValue": 3.14, # Represents a double value.
+            "stringValue": "A String", # Represents a string value.
+            "structValue": # Object with schema name: GenaiVertexV1Struct # Represents a structured value.
+          },
+        },
+        "googleMapsResult": { # Google Maps result step.
+          "result": [
+            { # The result of the Google Maps.
+              "places": [
+                {
+                  "name": "A String",
+                  "placeId": "A String",
+                  "reviewSnippets": [
+                    { # Encapsulates a snippet of a user review that answers a question about the features of a specific place in Google Maps.
+                      "reviewId": "A String", # The ID of the review snippet.
+                      "title": "A String", # Title of the review.
+                      "url": "A String", # A link that corresponds to the user review on Google Maps.
+                    },
+                  ],
+                  "url": "A String",
+                },
+              ],
+              "widgetContextToken": "A String",
+            },
+          ],
+        },
+        "googleSearchResult": { # Google Search result step.
+          "isError": True or False, # Whether the Google Search resulted in an error.
+          "result": [ # Required. The results of the Google Search.
+            { # The result of the Google Search.
+              "searchSuggestions": "A String", # Web content snippet that can be embedded in a web page or an app webview.
+            },
+          ],
+        },
+        "processingResult": { # The result of a server-initiated media processing step.
+        },
+        "retrievalResult": { # Vertex Retrieval result step. Used by Vertex Retrieval tools such as Parallel AI, Exa AI, Vertex AI Search, etc.
+          "isError": True or False, # Whether the retrieval resulted in an error.
+        },
+        "signature": "A String", # A signature hash for backend validation.
+        "urlContextResult": { # URL context result step.
+          "isError": True or False, # Whether the URL context resulted in an error.
+          "result": [ # Required. The results of the URL context.
+            { # The result of the URL context.
+              "status": "A String", # The status of the URL retrieval.
+              "url": "A String", # The URL that was fetched.
+            },
+          ],
+        },
+      },
+      "userInput": { # Input provided by the user. # DO NOT USE -- These are for 3P JSON only
+        "contentList": { # A list of Content. # The content of the step. An array of Content objects.
+          "contents": [ # The contents of the list.
+            { # The content of the response.
+              "audio": { # An audio content block.
+                "channels": 42, # The number of audio channels.
+                "data": "A String", # The audio content.
+                "mimeTypeString": "A String", # Flexible MIME type string of the audio, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                "sampleRate": 42, # The sample rate of the audio.
+                "uri": "A String", # The URI of the audio.
+              },
+              "document": { # A document content block.
+                "data": "A String", # The document content.
+                "mimeTypeString": "A String", # Flexible MIME type string of the document, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                "uri": "A String", # The URI of the document.
+              },
+              "image": { # An image content block.
+                "data": "A String", # The image content.
+                "mimeTypeString": "A String", # Flexible MIME type string of the image, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                "resolution": "A String", # The resolution of the media.
+                "uri": "A String", # The URI of the image.
+              },
+              "text": { # A text content block.
+                "annotations": [ # Citation information for model-generated content.
+                  { # Citation information for model-generated content.
+                    "endIndex": 42, # End of the attributed segment, exclusive.
+                    "fileCitation": { # A file citation annotation. # A file citation annotation.
+                      "customMetadata": { # User provided metadata about the retrieved context.
+                        "a_key": "", # Properties of the object.
+                      },
+                      "documentUri": "A String", # The URI of the file.
+                      "fileName": "A String", # The name of the file.
+                      "mediaId": "A String", # Media ID in-case of image citations, if applicable.
+                      "pageNumber": 42, # Page number of the cited document, if applicable.
+                      "source": "A String", # Source attributed for a portion of the text.
+                    },
+                    "placeCitation": { # A place citation annotation. # A place citation annotation.
+                      "name": "A String", # Title of the place.
+                      "placeId": "A String", # The ID of the place, in `places/{place_id}` format.
+                      "reviewSnippets": [ # Snippets of reviews that are used to generate answers about the features of a given place in Google Maps.
+                        { # Encapsulates a snippet of a user review that answers a question about the features of a specific place in Google Maps.
+                          "reviewId": "A String", # The ID of the review snippet.
+                          "title": "A String", # Title of the review.
+                          "url": "A String", # A link that corresponds to the user review on Google Maps.
+                        },
+                      ],
+                      "url": "A String", # URI reference of the place.
+                    },
+                    "speechMetadata": { # Speech annotation for text content. # Speech annotation for text content.
+                      "speaker": "A String", # The speaker to associate with this turn.
+                      "style": "A String", # Style instruction for the speech synthesis.
+                    },
+                    "startIndex": 42, # Start of segment of the response that is attributed to this source. Index indicates the start of the segment, measured in bytes.
+                    "urlCitation": { # A URL citation annotation. # NOTE: We use these instead of the Citation message for historical reasons. A URL citation annotation.
+                      "title": "A String", # The title of the URL.
+                      "url": "A String", # The URL.
+                    },
+                    "wordInfo": { # Word-level ASR annotation for transcription output. Carries the word text, optional timing, and optional speaker attribution. # Word-level ASR annotation with timing and speaker info.
+                      "endOffset": "A String", # End offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                      "speaker": "A String", # Optional. Speaker label for this word (e.g. "spk_1", "spk_2"). Present when diarization_mode is set in TranscriptionConfig.
+                      "startOffset": "A String", # Start offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                      "text": "A String", # The transcribed word.
+                    },
+                  },
+                ],
+                "text": "A String", # Required. The text content.
+              },
+              "video": { # A video content block.
+                "data": "A String", # The video content.
+                "mimeTypeString": "A String", # Flexible MIME type string of the video, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                "name": "A String", # A user-defined name for this content block. Can be referenced by the model in the final response.
+                "processingConfig": {
+                  "static": {
+                    "endOffset": "A String", # Optional. Segment end time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "30s". Must be non-negative and greater than `start_offset` if `start_offset` is set.
+                    "fps": 3.14, # Optional. Video frame-rate sampling density.
+                    "startOffset": "A String", # Optional. Segment start time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "10.5s". Must be non-negative.
+                  },
+                },
+                "processingType": "A String",
+                "resolution": "A String", # The resolution of the media.
+                "uri": "A String", # The URI of the video.
+              },
+            },
+          ],
+        },
+        "contentString": "A String", # The content of the step. A single string.
+      },
+    },
+  ],
+  "stringContent": "A String", # A string input for the interaction, it will be processed as a single text input.
+  "systemInstruction": "A String", # System instruction for the interaction.
+  "tools": [ # A list of tool declarations the model may call during interaction.
+    { # A tool that can be used by the model.
+      "codeExecution": { # A tool that can be used by the model to execute code. # A tool that can be used by the model to execute code.
+      },
+      "computerUse": { # A tool that can be used by the model to interact with the computer. # Tool to support the model interacting directly with the computer.
+        "disabledSafetyPolicies": [ # Optional. Disabled safety policies for computer use.
+          "A String",
+        ],
+        "enablePromptInjectionDetection": True or False, # Whether enable the prompt injection detection check on computer-use request.
+        "environment": "A String", # The environment being operated.
+        "excludedPredefinedFunctions": [ # The list of predefined functions that are excluded from the model call.
+          "A String",
+        ],
+      },
+      "fileSearch": { # A tool that can be used by the model to search files. # A tool that can be used by the model to search files.
+        "fileSearchStoreNames": [ # The file search store names to search.
+          "A String",
+        ],
+        "metadataFilter": "A String", # Metadata filter to apply to the semantic retrieval documents and chunks.
+        "topK": 42, # The number of semantic retrieval chunks to retrieve.
+      },
+      "function": { # A tool that can be used by the model. # A function that can be used by the model.
+        "description": "A String", # A description of the function.
+        "name": "A String", # The name of the function.
+        "parameters": { # `Value` represents a dynamically typed value which can be either null, a number, a string, a boolean, a recursive struct value, or a list of values. A producer of value is expected to set one of these variants. Absence of any variant indicates an error. # The JSON Schema for the function's parameters.
+          "boolValue": True or False, # Represents a boolean value.
+          "contentValue": { # The content of the response. # Represents rich content (text, image, etc.).
+            "audio": { # An audio content block.
+              "channels": 42, # The number of audio channels.
+              "data": "A String", # The audio content.
+              "mimeTypeString": "A String", # Flexible MIME type string of the audio, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+              "sampleRate": 42, # The sample rate of the audio.
+              "uri": "A String", # The URI of the audio.
+            },
+            "document": { # A document content block.
+              "data": "A String", # The document content.
+              "mimeTypeString": "A String", # Flexible MIME type string of the document, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+              "uri": "A String", # The URI of the document.
+            },
+            "image": { # An image content block.
+              "data": "A String", # The image content.
+              "mimeTypeString": "A String", # Flexible MIME type string of the image, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+              "resolution": "A String", # The resolution of the media.
+              "uri": "A String", # The URI of the image.
+            },
+            "text": { # A text content block.
+              "annotations": [ # Citation information for model-generated content.
+                { # Citation information for model-generated content.
+                  "endIndex": 42, # End of the attributed segment, exclusive.
+                  "fileCitation": { # A file citation annotation. # A file citation annotation.
+                    "customMetadata": { # User provided metadata about the retrieved context.
+                      "a_key": "", # Properties of the object.
+                    },
+                    "documentUri": "A String", # The URI of the file.
+                    "fileName": "A String", # The name of the file.
+                    "mediaId": "A String", # Media ID in-case of image citations, if applicable.
+                    "pageNumber": 42, # Page number of the cited document, if applicable.
+                    "source": "A String", # Source attributed for a portion of the text.
+                  },
+                  "placeCitation": { # A place citation annotation. # A place citation annotation.
+                    "name": "A String", # Title of the place.
+                    "placeId": "A String", # The ID of the place, in `places/{place_id}` format.
+                    "reviewSnippets": [ # Snippets of reviews that are used to generate answers about the features of a given place in Google Maps.
+                      { # Encapsulates a snippet of a user review that answers a question about the features of a specific place in Google Maps.
+                        "reviewId": "A String", # The ID of the review snippet.
+                        "title": "A String", # Title of the review.
+                        "url": "A String", # A link that corresponds to the user review on Google Maps.
+                      },
+                    ],
+                    "url": "A String", # URI reference of the place.
+                  },
+                  "speechMetadata": { # Speech annotation for text content. # Speech annotation for text content.
+                    "speaker": "A String", # The speaker to associate with this turn.
+                    "style": "A String", # Style instruction for the speech synthesis.
+                  },
+                  "startIndex": 42, # Start of segment of the response that is attributed to this source. Index indicates the start of the segment, measured in bytes.
+                  "urlCitation": { # A URL citation annotation. # NOTE: We use these instead of the Citation message for historical reasons. A URL citation annotation.
+                    "title": "A String", # The title of the URL.
+                    "url": "A String", # The URL.
+                  },
+                  "wordInfo": { # Word-level ASR annotation for transcription output. Carries the word text, optional timing, and optional speaker attribution. # Word-level ASR annotation with timing and speaker info.
+                    "endOffset": "A String", # End offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                    "speaker": "A String", # Optional. Speaker label for this word (e.g. "spk_1", "spk_2"). Present when diarization_mode is set in TranscriptionConfig.
+                    "startOffset": "A String", # Start offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                    "text": "A String", # The transcribed word.
+                  },
+                },
+              ],
+              "text": "A String", # Required. The text content.
+            },
+            "video": { # A video content block.
+              "data": "A String", # The video content.
+              "mimeTypeString": "A String", # Flexible MIME type string of the video, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+              "name": "A String", # A user-defined name for this content block. Can be referenced by the model in the final response.
+              "processingConfig": {
+                "static": {
+                  "endOffset": "A String", # Optional. Segment end time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "30s". Must be non-negative and greater than `start_offset` if `start_offset` is set.
+                  "fps": 3.14, # Optional. Video frame-rate sampling density.
+                  "startOffset": "A String", # Optional. Segment start time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "10.5s". Must be non-negative.
+                },
+              },
+              "processingType": "A String",
+              "resolution": "A String", # The resolution of the media.
+              "uri": "A String", # The URI of the video.
+            },
+          },
+          "listValue": { # `ListValue` is a wrapper around a repeated field of values. # Represents a repeated `Value`.
+            "values": [ # Repeated field of dynamically typed values.
+              # Object with schema name: GenaiVertexV1Value
+            ],
+          },
+          "nullValue": "A String", # Represents a null value.
+          "numberValue": 3.14, # Represents a double value.
+          "stringValue": "A String", # Represents a string value.
+          "structValue": # Object with schema name: GenaiVertexV1Struct # Represents a structured value.
+        },
+      },
+      "googleMaps": { # A tool that can be used by the model to call Google Maps. # A tool that can be used by the model to search Google Maps.
+        "enableWidget": True or False, # Whether to return a widget context token in the tool call result of the response.
+        "latitude": 3.14, # The latitude of the user's location.
+        "longitude": 3.14, # The longitude of the user's location.
+      },
+      "googleSearch": { # A tool that can be used by the model to search Google. # A tool that can be used by the model to search Google.
+        "searchTypes": [ # The types of search grounding to enable.
+          "A String",
+        ],
+      },
+      "mcpServer": { # A MCPServer is a server that can be called by the model to perform actions. # A MCPServer is a server that can be called by the model to perform actions.
+        "allowedTools": [ # The allowed tools.
+          { # The configuration for allowed tools.
+            "mode": "A String", # The mode of the tool choice.
+            "tools": [ # The names of the allowed tools.
+              "A String",
+            ],
+          },
+        ],
+        "headers": { # Optional: Fields for authentication headers, timeouts, etc., if needed.
+          "a_key": "A String",
+        },
+        "name": "A String", # The name of the MCPServer.
+        "url": "A String", # The full URL for the MCPServer endpoint. Example: "https://api.example.com/mcp"
+      },
+      "retrieval": { # A tool that can be used by the model to retrieve files. # A tool that can be used by the model to retrieve files.
+        "exaAiSearchConfig": { # Used to specify configuration for ExaAISearch. # Used to specify configuration for ExaAISearch.
+          "apiKey": "A String", # Required. The API key for ExaAiSearch.
+          "customConfig": { # Optional. This field can be used to pass any parameter from the Exa.ai Search API.
+            "a_key": "", # Properties of the object.
+          },
+        },
+        "parallelAiSearchConfig": { # Used to specify configuration for ParallelAISearch. # Used to specify configuration for ParallelAISearch.
+          "apiKey": "A String", # Optional. The API key for ParallelAiSearch.
+          "customConfig": { # Optional. Custom configs for ParallelAiSearch.
+            "a_key": "", # Properties of the object.
+          },
+        },
+        "ragStoreConfig": { # Use to specify configuration for RAG Store. # Used to specify configuration for RagStore.
+          "ragResources": [ # Optional. The representation of the rag source.
+            { # The definition of the Rag resource.
+              "ragCorpus": "A String", # Optional. RagCorpora resource name.
+              "ragFileIds": [ # Optional. rag_file_id. The files should be in the same rag_corpus set in rag_corpus field.
+                "A String",
+              ],
+            },
+          ],
+          "ragRetrievalConfig": { # Specifies the context retrieval config. # Optional. The retrieval config for the Rag query.
+            "filter": { # Config for filters. # Optional. Config for filters.
+              "metadataFilter": "A String", # Optional. String for metadata filtering.
+              "vectorDistanceThreshold": 3.14, # Optional. Only returns contexts with vector distance smaller than the threshold.
+              "vectorSimilarityThreshold": 3.14, # Optional. Only returns contexts with vector similarity larger than the threshold.
+            },
+            "hybridSearch": { # Config for Hybrid Search. # Optional. Config for Hybrid Search.
+              "alpha": 3.14, # Optional. Alpha value controls the weight between dense and sparse vector search results.
+            },
+            "ranking": { # Config for ranking and reranking. # Optional. Config for ranking and reranking.
+              "rankService": { # Config for Rank Service. # Config for Rank Service.
+                "modelName": "A String", # Optional. The model name of the rank service.
+              },
+            },
+            "topK": 42, # Optional. The number of contexts to retrieve.
+          },
+        },
+        "retrievalTypes": [ # The types of file retrieval to enable.
+          "A String",
+        ],
+        "vertexAiSearchConfig": { # Used to specify configuration for VertexAISearch. # Used to specify configuration for VertexAISearch.
+          "datastores": [ # Optional. Used to specify Vertex AI Search datastores.
+            "A String",
+          ],
+          "engine": "A String", # Optional. Used to specify Vertex AI Search engine.
+        },
+      },
+      "urlContext": { # A tool that can be used by the model to fetch URL context. # A tool that can be used by the model to fetch URL context.
+      },
+    },
+  ],
+  "updated": "A String", # Required. Output only. The time at which the response was last updated in ISO 8601 format (YYYY-MM-DDThh:mm:ssZ).
+  "usage": { # Statistics on the interaction request's token usage. # Output only. Statistics on the interaction request's token usage.
+    "cachedTokensByModality": [ # A breakdown of cached token usage by modality.
+      { # The token count for a single response modality.
+        "modality": "A String", # The modality associated with the token count.
+        "tokens": 42, # Number of tokens for the modality.
+      },
+    ],
+    "groundingToolCount": [ # Grounding tool count.
+      { # The number of grounding tool counts.
+        "count": 42, # The number of grounding tool counts.
+        "type": "A String", # The grounding tool type associated with the count.
+      },
+    ],
+    "inputTokensByModality": [ # A breakdown of input token usage by modality.
+      { # The token count for a single response modality.
+        "modality": "A String", # The modality associated with the token count.
+        "tokens": 42, # Number of tokens for the modality.
+      },
+    ],
+    "outputTokensByModality": [ # A breakdown of output token usage by modality.
+      { # The token count for a single response modality.
+        "modality": "A String", # The modality associated with the token count.
+        "tokens": 42, # Number of tokens for the modality.
+      },
+    ],
+    "toolUseTokensByModality": [ # A breakdown of tool-use token usage by modality.
+      { # The token count for a single response modality.
+        "modality": "A String", # The modality associated with the token count.
+        "tokens": 42, # Number of tokens for the modality.
+      },
+    ],
+    "totalCachedTokens": 42, # Number of tokens in the cached part of the prompt (the cached content).
+    "totalInputTokens": 42, # Number of tokens in the prompt (context).
+    "totalOutputTokens": 42, # Total number of tokens across all the generated responses.
+    "totalThoughtTokens": 42, # Number of tokens of thoughts for thinking models.
+    "totalTokens": 42, # Total token count for the interaction request (prompt + responses + other internal tokens).
+    "totalToolUseTokens": 42, # Number of tokens present in tool-use prompt(s).
+  },
+}
+
+ +
+ createStream(projectsId, locationsId, body=None, x__xgafv=None) + 
Creates an interaction and streams the response.
+
+Args:
+  projectsId: string, A parameter (required)
+  locationsId: string, A parameter (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # Configuration parameters for creating an interaction.
+  "background": True or False, # Input only. Whether to run the model interaction in the background.
+  "interaction": { # Response for InteractionService.CreateInteraction. # The interaction to create.
+    "agentInteraction": { # Interaction for generating the completion using agents. # Interaction for generating the completion using agents.
+      "agent": "A String", # The name of the `Agent` used for generating the completion.
+      "antigravityConfig": { # Configuration for the Antigravity agent runtime. Provides server-side control over the agent's execution environment and tool configuration. # Antigravity agent configuration. This configuration is session-level settings that are passed to the agent runtime on a per-request basis.
+        "maxTotalTokens": "A String", # Max total tokens for the agent run.
+        "model": "A String", # The model to use for agent reasoning.
+      },
+      "codeMenderConfig": { # Configuration for the CodeMender agent.
+        "findRequest": { # Request parameters specific to FIND sessions, used for discovering vulnerabilities in a codebase. # Parameters for finding vulnerabilities.
+          "description": "A String", # Additional context or custom instructions provided by the user to guide the vulnerability analysis.
+          "findingId": "A String", # The identifier of a specific finding to verify. This is primarily used in VERIFY mode to focus the agent's execution-based validation on a single vulnerability.
+          "mode": "A String", # The mode of the find session.
+          "sourceFiles": [ # A list of source files to provide as context for the scan.
+            { # Content of a single file in the codebase.
+              "content": "A String", # The UTF-8 encoded text content of the file.
+              "path": "A String", # The relative path of the file from the project root.
+            },
+          ],
+        },
+        "fixRequest": { # Request parameters specific to FIX sessions, used for generating and validating security patches. # Parameters for fixing vulnerabilities.
+          "description": "A String", # Additional context or custom instructions provided by the user to guide the patch generation process.
+          "findingId": "A String", # The identifier of the specific security finding to be remediated. This ID maps to a previously discovered vulnerability.
+          "sourceFiles": [ # A list of source files providing context for the remediation. These files are typically the ones containing the identified vulnerability.
+            { # Content of a single file in the codebase.
+              "content": "A String", # The UTF-8 encoded text content of the file.
+              "path": "A String", # The relative path of the file from the project root.
+            },
+          ],
+        },
+        "model": "A String", # The name of the model to use for the CodeMender agent. One CodeMender session will only use one model.
+        "sessionConfig": { # The configuration of CodeMender sessions. # Optional session-specific configurations to override default agent behavior.
+          "maxRounds": 42, # The maximum number of interaction rounds the agent is allowed to perform before reaching a timeout.
+        },
+        "sessionId": "A String", # Parameter for grouping multiple interactions that belong to the same CodeMender session.
+      },
+      "deepResearchConfig": { # Configuration for the Deep Research agent.
+        "collaborativePlanning": True or False, # Enables human-in-the-loop planning for the Deep Research agent. If set to true, the Deep Research agent will provide a research plan in its response. The agent will then proceed only if the user confirms the plan in the next turn.
+        "enableBigqueryTool": True or False, # Enables bigquery tool for the Deep Research agent.
+        "thinkingSummaries": "A String", # Whether to include thought summaries in the response.
+        "visualization": "A String", # Whether to include visualizations in the response.
+      },
+      "dynamicConfig": { # Configuration for dynamic agents.
+        "config": { # `Struct` represents a structured data value, consisting of fields which map to dynamically typed values. # For agents that are not supported statically in the API definition.
+          "fields": [ # Dynamically typed fields. List instead of map because LLMs are sensitive to ordering, and we want to give users full control.
+            { # Represents a single field in a struct.
+              "name": "A String",
+              "value": { # `Value` represents a dynamically typed value which can be either null, a number, a string, a boolean, a recursive struct value, or a list of values. A producer of value is expected to set one of these variants. Absence of any variant indicates an error.
+                "boolValue": True or False, # Represents a boolean value.
+                "contentValue": { # The content of the response. # Represents rich content (text, image, etc.).
+                  "audio": { # An audio content block.
+                    "channels": 42, # The number of audio channels.
+                    "data": "A String", # The audio content.
+                    "mimeTypeString": "A String", # Flexible MIME type string of the audio, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                    "sampleRate": 42, # The sample rate of the audio.
+                    "uri": "A String", # The URI of the audio.
+                  },
+                  "document": { # A document content block.
+                    "data": "A String", # The document content.
+                    "mimeTypeString": "A String", # Flexible MIME type string of the document, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                    "uri": "A String", # The URI of the document.
+                  },
+                  "image": { # An image content block.
+                    "data": "A String", # The image content.
+                    "mimeTypeString": "A String", # Flexible MIME type string of the image, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                    "resolution": "A String", # The resolution of the media.
+                    "uri": "A String", # The URI of the image.
+                  },
+                  "text": { # A text content block.
+                    "annotations": [ # Citation information for model-generated content.
+                      { # Citation information for model-generated content.
+                        "endIndex": 42, # End of the attributed segment, exclusive.
+                        "fileCitation": { # A file citation annotation. # A file citation annotation.
+                          "customMetadata": { # User provided metadata about the retrieved context.
+                            "a_key": "", # Properties of the object.
+                          },
+                          "documentUri": "A String", # The URI of the file.
+                          "fileName": "A String", # The name of the file.
+                          "mediaId": "A String", # Media ID in-case of image citations, if applicable.
+                          "pageNumber": 42, # Page number of the cited document, if applicable.
+                          "source": "A String", # Source attributed for a portion of the text.
+                        },
+                        "placeCitation": { # A place citation annotation. # A place citation annotation.
+                          "name": "A String", # Title of the place.
+                          "placeId": "A String", # The ID of the place, in `places/{place_id}` format.
+                          "reviewSnippets": [ # Snippets of reviews that are used to generate answers about the features of a given place in Google Maps.
+                            { # Encapsulates a snippet of a user review that answers a question about the features of a specific place in Google Maps.
+                              "reviewId": "A String", # The ID of the review snippet.
+                              "title": "A String", # Title of the review.
+                              "url": "A String", # A link that corresponds to the user review on Google Maps.
+                            },
+                          ],
+                          "url": "A String", # URI reference of the place.
+                        },
+                        "speechMetadata": { # Speech annotation for text content. # Speech annotation for text content.
+                          "speaker": "A String", # The speaker to associate with this turn.
+                          "style": "A String", # Style instruction for the speech synthesis.
+                        },
+                        "startIndex": 42, # Start of segment of the response that is attributed to this source. Index indicates the start of the segment, measured in bytes.
+                        "urlCitation": { # A URL citation annotation. # NOTE: We use these instead of the Citation message for historical reasons. A URL citation annotation.
+                          "title": "A String", # The title of the URL.
+                          "url": "A String", # The URL.
+                        },
+                        "wordInfo": { # Word-level ASR annotation for transcription output. Carries the word text, optional timing, and optional speaker attribution. # Word-level ASR annotation with timing and speaker info.
+                          "endOffset": "A String", # End offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                          "speaker": "A String", # Optional. Speaker label for this word (e.g. "spk_1", "spk_2"). Present when diarization_mode is set in TranscriptionConfig.
+                          "startOffset": "A String", # Start offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                          "text": "A String", # The transcribed word.
+                        },
+                      },
+                    ],
+                    "text": "A String", # Required. The text content.
+                  },
+                  "video": { # A video content block.
+                    "data": "A String", # The video content.
+                    "mimeTypeString": "A String", # Flexible MIME type string of the video, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                    "name": "A String", # A user-defined name for this content block. Can be referenced by the model in the final response.
+                    "processingConfig": {
+                      "static": {
+                        "endOffset": "A String", # Optional. Segment end time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "30s". Must be non-negative and greater than `start_offset` if `start_offset` is set.
+                        "fps": 3.14, # Optional. Video frame-rate sampling density.
+                        "startOffset": "A String", # Optional. Segment start time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "10.5s". Must be non-negative.
+                      },
+                    },
+                    "processingType": "A String",
+                    "resolution": "A String", # The resolution of the media.
+                    "uri": "A String", # The URI of the video.
+                  },
+                },
+                "listValue": { # `ListValue` is a wrapper around a repeated field of values. # Represents a repeated `Value`.
+                  "values": [ # Repeated field of dynamically typed values.
+                    # Object with schema name: GenaiVertexV1Value
+                  ],
+                },
+                "nullValue": "A String", # Represents a null value.
+                "numberValue": 3.14, # Represents a double value.
+                "stringValue": "A String", # Represents a string value.
+                "structValue": # Object with schema name: GenaiVertexV1Struct # Represents a structured value.
+              },
+            },
+          ],
+        },
+      },
+    },
+    "content": { # The content of the response. # The content for the interaction.
+      "audio": { # An audio content block.
+        "channels": 42, # The number of audio channels.
+        "data": "A String", # The audio content.
+        "mimeTypeString": "A String", # Flexible MIME type string of the audio, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+        "sampleRate": 42, # The sample rate of the audio.
+        "uri": "A String", # The URI of the audio.
+      },
+      "document": { # A document content block.
+        "data": "A String", # The document content.
+        "mimeTypeString": "A String", # Flexible MIME type string of the document, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+        "uri": "A String", # The URI of the document.
+      },
+      "image": { # An image content block.
+        "data": "A String", # The image content.
+        "mimeTypeString": "A String", # Flexible MIME type string of the image, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+        "resolution": "A String", # The resolution of the media.
+        "uri": "A String", # The URI of the image.
+      },
+      "text": { # A text content block.
+        "annotations": [ # Citation information for model-generated content.
+          { # Citation information for model-generated content.
+            "endIndex": 42, # End of the attributed segment, exclusive.
+            "fileCitation": { # A file citation annotation. # A file citation annotation.
+              "customMetadata": { # User provided metadata about the retrieved context.
+                "a_key": "", # Properties of the object.
+              },
+              "documentUri": "A String", # The URI of the file.
+              "fileName": "A String", # The name of the file.
+              "mediaId": "A String", # Media ID in-case of image citations, if applicable.
+              "pageNumber": 42, # Page number of the cited document, if applicable.
+              "source": "A String", # Source attributed for a portion of the text.
+            },
+            "placeCitation": { # A place citation annotation. # A place citation annotation.
+              "name": "A String", # Title of the place.
+              "placeId": "A String", # The ID of the place, in `places/{place_id}` format.
+              "reviewSnippets": [ # Snippets of reviews that are used to generate answers about the features of a given place in Google Maps.
+                { # Encapsulates a snippet of a user review that answers a question about the features of a specific place in Google Maps.
+                  "reviewId": "A String", # The ID of the review snippet.
+                  "title": "A String", # Title of the review.
+                  "url": "A String", # A link that corresponds to the user review on Google Maps.
+                },
+              ],
+              "url": "A String", # URI reference of the place.
+            },
+            "speechMetadata": { # Speech annotation for text content. # Speech annotation for text content.
+              "speaker": "A String", # The speaker to associate with this turn.
+              "style": "A String", # Style instruction for the speech synthesis.
+            },
+            "startIndex": 42, # Start of segment of the response that is attributed to this source. Index indicates the start of the segment, measured in bytes.
+            "urlCitation": { # A URL citation annotation. # NOTE: We use these instead of the Citation message for historical reasons. A URL citation annotation.
+              "title": "A String", # The title of the URL.
+              "url": "A String", # The URL.
+            },
+            "wordInfo": { # Word-level ASR annotation for transcription output. Carries the word text, optional timing, and optional speaker attribution. # Word-level ASR annotation with timing and speaker info.
+              "endOffset": "A String", # End offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+              "speaker": "A String", # Optional. Speaker label for this word (e.g. "spk_1", "spk_2"). Present when diarization_mode is set in TranscriptionConfig.
+              "startOffset": "A String", # Start offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+              "text": "A String", # The transcribed word.
+            },
+          },
+        ],
+        "text": "A String", # Required. The text content.
+      },
+      "video": { # A video content block.
+        "data": "A String", # The video content.
+        "mimeTypeString": "A String", # Flexible MIME type string of the video, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+        "name": "A String", # A user-defined name for this content block. Can be referenced by the model in the final response.
+        "processingConfig": {
+          "static": {
+            "endOffset": "A String", # Optional. Segment end time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "30s". Must be non-negative and greater than `start_offset` if `start_offset` is set.
+            "fps": 3.14, # Optional. Video frame-rate sampling density.
+            "startOffset": "A String", # Optional. Segment start time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "10.5s". Must be non-negative.
+          },
+        },
+        "processingType": "A String",
+        "resolution": "A String", # The resolution of the media.
+        "uri": "A String", # The URI of the video.
+      },
+    },
+    "created": "A String", # Required. Output only. The time at which the response was created in ISO 8601 format (YYYY-MM-DDThh:mm:ssZ).
+    "envId": "A String", # The environment ID for the interaction. Can be 'remote' for default environment.
+    "environmentId": "A String", # Output only. The environment ID for the interaction. Only populated if environment config is set in the request.
+    "errors": [ # Output only. Diagnostic faults / platform errors recorded on the interaction.
+      { # Error message from an interaction.
+        "code": "A String", # A URI that identifies the error type.
+        "message": "A String", # A human-readable error message.
+      },
+    ],
+    "id": "A String", # Required. Output only. A unique identifier for the interaction completion.
+    "labels": { # The labels with user-defined metadata for the request. 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",
+    },
+    "modelInteraction": { # Interaction for generating the completion using models. # Interaction for generating the completion using models.
+      "generationConfig": { # Configuration parameters for model interactions. # Input only. Configuration parameters for the model interaction.
+        "maxOutputTokens": 42, # The maximum number of tokens to include in the response.
+        "seed": 42, # Seed used in decoding for reproducibility.
+        "stopSequences": [ # A list of character sequences that will stop output interaction.
+          "A String",
+        ],
+        "structuredSpeechConfig": { # Configuration for multi-speaker and speech generation. # Speech and multi-speaker configuration.
+          "speakers": [ # Individual speaker configurations.
+            { # The configuration for speech interaction.
+              "language": "A String", # The language of the speech.
+              "speaker": "A String", # The speaker's name, it should match the speaker name given in the prompt.
+              "voice": "A String", # The voice of the speaker.
+            },
+          ],
+        },
+        "temperature": 3.14, # Controls the randomness of the output.
+        "thinkingLevel": "A String", # The level of thought tokens that the model should generate.
+        "thinkingSummaries": "A String", # Whether to include thought summaries in the response.
+        "toolChoiceConfig": { # The tool choice configuration containing allowed tools. # The config for the tool choice.
+          "allowedTools": { # The configuration for allowed tools. # The allowed tools.
+            "mode": "A String", # The mode of the tool choice.
+            "tools": [ # The names of the allowed tools.
+              "A String",
+            ],
+          },
+        },
+        "toolChoiceMode": "A String", # The mode of the tool choice.
+        "topP": 3.14, # The maximum cumulative probability of tokens to consider when sampling.
+        "transcriptionConfig": { # Configuration for speech recognition (transcription). # Optional. Configuration for speech recognition (transcription). If present, ASR is enabled.
+          "adaptationPhrases": [ # Optional. A list of phrases to bias the ASR model towards.
+            "A String",
+          ],
+          "customVocabulary": [ # Optional. A list of custom vocabulary phrases to bias the speech recognition model toward recognizing specific terms.
+            "A String",
+          ],
+          "diarizationMode": "A String", # Optional. Configures speaker diarization. Supported values: "speaker".
+          "languageCodes": [ # Optional. BCP-47 language codes providing hints about the languages present in the audio. If omitted or empty, defaults to automatic language detection.
+            "A String",
+          ],
+          "timestampGranularities": [ # Optional. The granularity of timestamps to include in the transcription output. Supported values: "word". If empty, no timestamps are generated.
+            "A String",
+          ],
+        },
+        "videoConfig": { # Configuration options for video generation. # Configuration for video generation.
+          "task": "A String", # Optional task mode for video generation. If not specified, the model automatically determines the appropriate mode based on the provided text prompt and input media.
+        },
+      },
+      "model": "A String", # The name of the `Model` used for generating the completion.
+    },
+    "previousInteractionId": "A String", # The ID of the previous interaction, if any.
+    "responseFormatList": {
+      "responseFormats": [
+        {
+          "audio": { # Configuration for audio output format.
+            "bitRate": 42, # Bit rate in bits per second (bps). Only applicable for compressed formats (MP3, Opus).
+            "delivery": "A String", # The delivery mode for the audio output.
+            "mimeType": "A String", # The MIME type of the audio output.
+            "sampleRate": 42, # Sample rate in Hz.
+          },
+          "image": { # Configuration for image output format.
+            "aspectRatio": "A String", # The aspect ratio for the image output.
+            "delivery": "A String", # The delivery mode for the image output.
+            "imageSize": "A String", # The size of the image output.
+            "mimeType": "A String", # The MIME type of the image output.
+          },
+          "structValue": { # `Struct` represents a structured data value, consisting of fields which map to dynamically typed values. # Multi-discriminator values is already enabled in GAOS
+            "fields": [ # Dynamically typed fields. List instead of map because LLMs are sensitive to ordering, and we want to give users full control.
+              { # Represents a single field in a struct.
+                "name": "A String",
+                "value": { # `Value` represents a dynamically typed value which can be either null, a number, a string, a boolean, a recursive struct value, or a list of values. A producer of value is expected to set one of these variants. Absence of any variant indicates an error.
+                  "boolValue": True or False, # Represents a boolean value.
+                  "contentValue": { # The content of the response. # Represents rich content (text, image, etc.).
+                    "audio": { # An audio content block.
+                      "channels": 42, # The number of audio channels.
+                      "data": "A String", # The audio content.
+                      "mimeTypeString": "A String", # Flexible MIME type string of the audio, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                      "sampleRate": 42, # The sample rate of the audio.
+                      "uri": "A String", # The URI of the audio.
+                    },
+                    "document": { # A document content block.
+                      "data": "A String", # The document content.
+                      "mimeTypeString": "A String", # Flexible MIME type string of the document, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                      "uri": "A String", # The URI of the document.
+                    },
+                    "image": { # An image content block.
+                      "data": "A String", # The image content.
+                      "mimeTypeString": "A String", # Flexible MIME type string of the image, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                      "resolution": "A String", # The resolution of the media.
+                      "uri": "A String", # The URI of the image.
+                    },
+                    "text": { # A text content block.
+                      "annotations": [ # Citation information for model-generated content.
+                        { # Citation information for model-generated content.
+                          "endIndex": 42, # End of the attributed segment, exclusive.
+                          "fileCitation": { # A file citation annotation. # A file citation annotation.
+                            "customMetadata": { # User provided metadata about the retrieved context.
+                              "a_key": "", # Properties of the object.
+                            },
+                            "documentUri": "A String", # The URI of the file.
+                            "fileName": "A String", # The name of the file.
+                            "mediaId": "A String", # Media ID in-case of image citations, if applicable.
+                            "pageNumber": 42, # Page number of the cited document, if applicable.
+                            "source": "A String", # Source attributed for a portion of the text.
+                          },
+                          "placeCitation": { # A place citation annotation. # A place citation annotation.
+                            "name": "A String", # Title of the place.
+                            "placeId": "A String", # The ID of the place, in `places/{place_id}` format.
+                            "reviewSnippets": [ # Snippets of reviews that are used to generate answers about the features of a given place in Google Maps.
+                              { # Encapsulates a snippet of a user review that answers a question about the features of a specific place in Google Maps.
+                                "reviewId": "A String", # The ID of the review snippet.
+                                "title": "A String", # Title of the review.
+                                "url": "A String", # A link that corresponds to the user review on Google Maps.
+                              },
+                            ],
+                            "url": "A String", # URI reference of the place.
+                          },
+                          "speechMetadata": { # Speech annotation for text content. # Speech annotation for text content.
+                            "speaker": "A String", # The speaker to associate with this turn.
+                            "style": "A String", # Style instruction for the speech synthesis.
+                          },
+                          "startIndex": 42, # Start of segment of the response that is attributed to this source. Index indicates the start of the segment, measured in bytes.
+                          "urlCitation": { # A URL citation annotation. # NOTE: We use these instead of the Citation message for historical reasons. A URL citation annotation.
+                            "title": "A String", # The title of the URL.
+                            "url": "A String", # The URL.
+                          },
+                          "wordInfo": { # Word-level ASR annotation for transcription output. Carries the word text, optional timing, and optional speaker attribution. # Word-level ASR annotation with timing and speaker info.
+                            "endOffset": "A String", # End offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                            "speaker": "A String", # Optional. Speaker label for this word (e.g. "spk_1", "spk_2"). Present when diarization_mode is set in TranscriptionConfig.
+                            "startOffset": "A String", # Start offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                            "text": "A String", # The transcribed word.
+                          },
+                        },
+                      ],
+                      "text": "A String", # Required. The text content.
+                    },
+                    "video": { # A video content block.
+                      "data": "A String", # The video content.
+                      "mimeTypeString": "A String", # Flexible MIME type string of the video, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                      "name": "A String", # A user-defined name for this content block. Can be referenced by the model in the final response.
+                      "processingConfig": {
+                        "static": {
+                          "endOffset": "A String", # Optional. Segment end time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "30s". Must be non-negative and greater than `start_offset` if `start_offset` is set.
+                          "fps": 3.14, # Optional. Video frame-rate sampling density.
+                          "startOffset": "A String", # Optional. Segment start time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "10.5s". Must be non-negative.
+                        },
+                      },
+                      "processingType": "A String",
+                      "resolution": "A String", # The resolution of the media.
+                      "uri": "A String", # The URI of the video.
+                    },
+                  },
+                  "listValue": { # `ListValue` is a wrapper around a repeated field of values. # Represents a repeated `Value`.
+                    "values": [ # Repeated field of dynamically typed values.
+                      # Object with schema name: GenaiVertexV1Value
+                    ],
+                  },
+                  "nullValue": "A String", # Represents a null value.
+                  "numberValue": 3.14, # Represents a double value.
+                  "stringValue": "A String", # Represents a string value.
+                  "structValue": # Object with schema name: GenaiVertexV1Struct # Represents a structured value.
+                },
+              },
+            ],
+          },
+          "text": { # Configuration for text output format.
+            "mimeType": "A String", # The MIME type of the text output.
+            "schema": { # `Struct` represents a structured data value, consisting of fields which map to dynamically typed values. # The JSON schema that the output should conform to. Only applicable when mime_type is application/json.
+              "fields": [ # Dynamically typed fields. List instead of map because LLMs are sensitive to ordering, and we want to give users full control.
+                { # Represents a single field in a struct.
+                  "name": "A String",
+                  "value": { # `Value` represents a dynamically typed value which can be either null, a number, a string, a boolean, a recursive struct value, or a list of values. A producer of value is expected to set one of these variants. Absence of any variant indicates an error.
+                    "boolValue": True or False, # Represents a boolean value.
+                    "contentValue": { # The content of the response. # Represents rich content (text, image, etc.).
+                      "audio": { # An audio content block.
+                        "channels": 42, # The number of audio channels.
+                        "data": "A String", # The audio content.
+                        "mimeTypeString": "A String", # Flexible MIME type string of the audio, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                        "sampleRate": 42, # The sample rate of the audio.
+                        "uri": "A String", # The URI of the audio.
+                      },
+                      "document": { # A document content block.
+                        "data": "A String", # The document content.
+                        "mimeTypeString": "A String", # Flexible MIME type string of the document, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                        "uri": "A String", # The URI of the document.
+                      },
+                      "image": { # An image content block.
+                        "data": "A String", # The image content.
+                        "mimeTypeString": "A String", # Flexible MIME type string of the image, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                        "resolution": "A String", # The resolution of the media.
+                        "uri": "A String", # The URI of the image.
+                      },
+                      "text": { # A text content block.
+                        "annotations": [ # Citation information for model-generated content.
+                          { # Citation information for model-generated content.
+                            "endIndex": 42, # End of the attributed segment, exclusive.
+                            "fileCitation": { # A file citation annotation. # A file citation annotation.
+                              "customMetadata": { # User provided metadata about the retrieved context.
+                                "a_key": "", # Properties of the object.
+                              },
+                              "documentUri": "A String", # The URI of the file.
+                              "fileName": "A String", # The name of the file.
+                              "mediaId": "A String", # Media ID in-case of image citations, if applicable.
+                              "pageNumber": 42, # Page number of the cited document, if applicable.
+                              "source": "A String", # Source attributed for a portion of the text.
+                            },
+                            "placeCitation": { # A place citation annotation. # A place citation annotation.
+                              "name": "A String", # Title of the place.
+                              "placeId": "A String", # The ID of the place, in `places/{place_id}` format.
+                              "reviewSnippets": [ # Snippets of reviews that are used to generate answers about the features of a given place in Google Maps.
+                                { # Encapsulates a snippet of a user review that answers a question about the features of a specific place in Google Maps.
+                                  "reviewId": "A String", # The ID of the review snippet.
+                                  "title": "A String", # Title of the review.
+                                  "url": "A String", # A link that corresponds to the user review on Google Maps.
+                                },
+                              ],
+                              "url": "A String", # URI reference of the place.
+                            },
+                            "speechMetadata": { # Speech annotation for text content. # Speech annotation for text content.
+                              "speaker": "A String", # The speaker to associate with this turn.
+                              "style": "A String", # Style instruction for the speech synthesis.
+                            },
+                            "startIndex": 42, # Start of segment of the response that is attributed to this source. Index indicates the start of the segment, measured in bytes.
+                            "urlCitation": { # A URL citation annotation. # NOTE: We use these instead of the Citation message for historical reasons. A URL citation annotation.
+                              "title": "A String", # The title of the URL.
+                              "url": "A String", # The URL.
+                            },
+                            "wordInfo": { # Word-level ASR annotation for transcription output. Carries the word text, optional timing, and optional speaker attribution. # Word-level ASR annotation with timing and speaker info.
+                              "endOffset": "A String", # End offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                              "speaker": "A String", # Optional. Speaker label for this word (e.g. "spk_1", "spk_2"). Present when diarization_mode is set in TranscriptionConfig.
+                              "startOffset": "A String", # Start offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                              "text": "A String", # The transcribed word.
+                            },
+                          },
+                        ],
+                        "text": "A String", # Required. The text content.
+                      },
+                      "video": { # A video content block.
+                        "data": "A String", # The video content.
+                        "mimeTypeString": "A String", # Flexible MIME type string of the video, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                        "name": "A String", # A user-defined name for this content block. Can be referenced by the model in the final response.
+                        "processingConfig": {
+                          "static": {
+                            "endOffset": "A String", # Optional. Segment end time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "30s". Must be non-negative and greater than `start_offset` if `start_offset` is set.
+                            "fps": 3.14, # Optional. Video frame-rate sampling density.
+                            "startOffset": "A String", # Optional. Segment start time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "10.5s". Must be non-negative.
+                          },
+                        },
+                        "processingType": "A String",
+                        "resolution": "A String", # The resolution of the media.
+                        "uri": "A String", # The URI of the video.
+                      },
+                    },
+                    "listValue": { # `ListValue` is a wrapper around a repeated field of values. # Represents a repeated `Value`.
+                      "values": [ # Repeated field of dynamically typed values.
+                        # Object with schema name: GenaiVertexV1Value
+                      ],
+                    },
+                    "nullValue": "A String", # Represents a null value.
+                    "numberValue": 3.14, # Represents a double value.
+                    "stringValue": "A String", # Represents a string value.
+                    "structValue": # Object with schema name: GenaiVertexV1Struct # Represents a structured value.
+                  },
+                },
+              ],
+            },
+          },
+          "video": { # Configuration for video output format.
+            "aspectRatio": "A String", # The aspect ratio for the video output.
+            "delivery": "A String", # The delivery mode for the video output.
+            "duration": "A String", # The duration for the video output.
+            "gcsUri": "A String", # The Cloud Storage URI to store the video output. Required for Vertex if delivery mode is URI.
+            "resolution": "A String", # The video output resolution. Defaults to 720p.
+          },
+        },
+      ],
+    },
+    "responseFormatSingleton": {
+      "audio": { # Configuration for audio output format.
+        "bitRate": 42, # Bit rate in bits per second (bps). Only applicable for compressed formats (MP3, Opus).
+        "delivery": "A String", # The delivery mode for the audio output.
+        "mimeType": "A String", # The MIME type of the audio output.
+        "sampleRate": 42, # Sample rate in Hz.
+      },
+      "image": { # Configuration for image output format.
+        "aspectRatio": "A String", # The aspect ratio for the image output.
+        "delivery": "A String", # The delivery mode for the image output.
+        "imageSize": "A String", # The size of the image output.
+        "mimeType": "A String", # The MIME type of the image output.
+      },
+      "structValue": { # `Struct` represents a structured data value, consisting of fields which map to dynamically typed values. # Multi-discriminator values is already enabled in GAOS
+        "fields": [ # Dynamically typed fields. List instead of map because LLMs are sensitive to ordering, and we want to give users full control.
+          { # Represents a single field in a struct.
+            "name": "A String",
+            "value": { # `Value` represents a dynamically typed value which can be either null, a number, a string, a boolean, a recursive struct value, or a list of values. A producer of value is expected to set one of these variants. Absence of any variant indicates an error.
+              "boolValue": True or False, # Represents a boolean value.
+              "contentValue": { # The content of the response. # Represents rich content (text, image, etc.).
+                "audio": { # An audio content block.
+                  "channels": 42, # The number of audio channels.
+                  "data": "A String", # The audio content.
+                  "mimeTypeString": "A String", # Flexible MIME type string of the audio, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                  "sampleRate": 42, # The sample rate of the audio.
+                  "uri": "A String", # The URI of the audio.
+                },
+                "document": { # A document content block.
+                  "data": "A String", # The document content.
+                  "mimeTypeString": "A String", # Flexible MIME type string of the document, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                  "uri": "A String", # The URI of the document.
+                },
+                "image": { # An image content block.
+                  "data": "A String", # The image content.
+                  "mimeTypeString": "A String", # Flexible MIME type string of the image, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                  "resolution": "A String", # The resolution of the media.
+                  "uri": "A String", # The URI of the image.
+                },
+                "text": { # A text content block.
+                  "annotations": [ # Citation information for model-generated content.
+                    { # Citation information for model-generated content.
+                      "endIndex": 42, # End of the attributed segment, exclusive.
+                      "fileCitation": { # A file citation annotation. # A file citation annotation.
+                        "customMetadata": { # User provided metadata about the retrieved context.
+                          "a_key": "", # Properties of the object.
+                        },
+                        "documentUri": "A String", # The URI of the file.
+                        "fileName": "A String", # The name of the file.
+                        "mediaId": "A String", # Media ID in-case of image citations, if applicable.
+                        "pageNumber": 42, # Page number of the cited document, if applicable.
+                        "source": "A String", # Source attributed for a portion of the text.
+                      },
+                      "placeCitation": { # A place citation annotation. # A place citation annotation.
+                        "name": "A String", # Title of the place.
+                        "placeId": "A String", # The ID of the place, in `places/{place_id}` format.
+                        "reviewSnippets": [ # Snippets of reviews that are used to generate answers about the features of a given place in Google Maps.
+                          { # Encapsulates a snippet of a user review that answers a question about the features of a specific place in Google Maps.
+                            "reviewId": "A String", # The ID of the review snippet.
+                            "title": "A String", # Title of the review.
+                            "url": "A String", # A link that corresponds to the user review on Google Maps.
+                          },
+                        ],
+                        "url": "A String", # URI reference of the place.
+                      },
+                      "speechMetadata": { # Speech annotation for text content. # Speech annotation for text content.
+                        "speaker": "A String", # The speaker to associate with this turn.
+                        "style": "A String", # Style instruction for the speech synthesis.
+                      },
+                      "startIndex": 42, # Start of segment of the response that is attributed to this source. Index indicates the start of the segment, measured in bytes.
+                      "urlCitation": { # A URL citation annotation. # NOTE: We use these instead of the Citation message for historical reasons. A URL citation annotation.
+                        "title": "A String", # The title of the URL.
+                        "url": "A String", # The URL.
+                      },
+                      "wordInfo": { # Word-level ASR annotation for transcription output. Carries the word text, optional timing, and optional speaker attribution. # Word-level ASR annotation with timing and speaker info.
+                        "endOffset": "A String", # End offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                        "speaker": "A String", # Optional. Speaker label for this word (e.g. "spk_1", "spk_2"). Present when diarization_mode is set in TranscriptionConfig.
+                        "startOffset": "A String", # Start offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                        "text": "A String", # The transcribed word.
+                      },
+                    },
+                  ],
+                  "text": "A String", # Required. The text content.
+                },
+                "video": { # A video content block.
+                  "data": "A String", # The video content.
+                  "mimeTypeString": "A String", # Flexible MIME type string of the video, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                  "name": "A String", # A user-defined name for this content block. Can be referenced by the model in the final response.
+                  "processingConfig": {
+                    "static": {
+                      "endOffset": "A String", # Optional. Segment end time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "30s". Must be non-negative and greater than `start_offset` if `start_offset` is set.
+                      "fps": 3.14, # Optional. Video frame-rate sampling density.
+                      "startOffset": "A String", # Optional. Segment start time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "10.5s". Must be non-negative.
+                    },
+                  },
+                  "processingType": "A String",
+                  "resolution": "A String", # The resolution of the media.
+                  "uri": "A String", # The URI of the video.
+                },
+              },
+              "listValue": { # `ListValue` is a wrapper around a repeated field of values. # Represents a repeated `Value`.
+                "values": [ # Repeated field of dynamically typed values.
+                  # Object with schema name: GenaiVertexV1Value
+                ],
+              },
+              "nullValue": "A String", # Represents a null value.
+              "numberValue": 3.14, # Represents a double value.
+              "stringValue": "A String", # Represents a string value.
+              "structValue": # Object with schema name: GenaiVertexV1Struct # Represents a structured value.
+            },
+          },
+        ],
+      },
+      "text": { # Configuration for text output format.
+        "mimeType": "A String", # The MIME type of the text output.
+        "schema": { # `Struct` represents a structured data value, consisting of fields which map to dynamically typed values. # The JSON schema that the output should conform to. Only applicable when mime_type is application/json.
+          "fields": [ # Dynamically typed fields. List instead of map because LLMs are sensitive to ordering, and we want to give users full control.
+            { # Represents a single field in a struct.
+              "name": "A String",
+              "value": { # `Value` represents a dynamically typed value which can be either null, a number, a string, a boolean, a recursive struct value, or a list of values. A producer of value is expected to set one of these variants. Absence of any variant indicates an error.
+                "boolValue": True or False, # Represents a boolean value.
+                "contentValue": { # The content of the response. # Represents rich content (text, image, etc.).
+                  "audio": { # An audio content block.
+                    "channels": 42, # The number of audio channels.
+                    "data": "A String", # The audio content.
+                    "mimeTypeString": "A String", # Flexible MIME type string of the audio, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                    "sampleRate": 42, # The sample rate of the audio.
+                    "uri": "A String", # The URI of the audio.
+                  },
+                  "document": { # A document content block.
+                    "data": "A String", # The document content.
+                    "mimeTypeString": "A String", # Flexible MIME type string of the document, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                    "uri": "A String", # The URI of the document.
+                  },
+                  "image": { # An image content block.
+                    "data": "A String", # The image content.
+                    "mimeTypeString": "A String", # Flexible MIME type string of the image, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                    "resolution": "A String", # The resolution of the media.
+                    "uri": "A String", # The URI of the image.
+                  },
+                  "text": { # A text content block.
+                    "annotations": [ # Citation information for model-generated content.
+                      { # Citation information for model-generated content.
+                        "endIndex": 42, # End of the attributed segment, exclusive.
+                        "fileCitation": { # A file citation annotation. # A file citation annotation.
+                          "customMetadata": { # User provided metadata about the retrieved context.
+                            "a_key": "", # Properties of the object.
+                          },
+                          "documentUri": "A String", # The URI of the file.
+                          "fileName": "A String", # The name of the file.
+                          "mediaId": "A String", # Media ID in-case of image citations, if applicable.
+                          "pageNumber": 42, # Page number of the cited document, if applicable.
+                          "source": "A String", # Source attributed for a portion of the text.
+                        },
+                        "placeCitation": { # A place citation annotation. # A place citation annotation.
+                          "name": "A String", # Title of the place.
+                          "placeId": "A String", # The ID of the place, in `places/{place_id}` format.
+                          "reviewSnippets": [ # Snippets of reviews that are used to generate answers about the features of a given place in Google Maps.
+                            { # Encapsulates a snippet of a user review that answers a question about the features of a specific place in Google Maps.
+                              "reviewId": "A String", # The ID of the review snippet.
+                              "title": "A String", # Title of the review.
+                              "url": "A String", # A link that corresponds to the user review on Google Maps.
+                            },
+                          ],
+                          "url": "A String", # URI reference of the place.
+                        },
+                        "speechMetadata": { # Speech annotation for text content. # Speech annotation for text content.
+                          "speaker": "A String", # The speaker to associate with this turn.
+                          "style": "A String", # Style instruction for the speech synthesis.
+                        },
+                        "startIndex": 42, # Start of segment of the response that is attributed to this source. Index indicates the start of the segment, measured in bytes.
+                        "urlCitation": { # A URL citation annotation. # NOTE: We use these instead of the Citation message for historical reasons. A URL citation annotation.
+                          "title": "A String", # The title of the URL.
+                          "url": "A String", # The URL.
+                        },
+                        "wordInfo": { # Word-level ASR annotation for transcription output. Carries the word text, optional timing, and optional speaker attribution. # Word-level ASR annotation with timing and speaker info.
+                          "endOffset": "A String", # End offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                          "speaker": "A String", # Optional. Speaker label for this word (e.g. "spk_1", "spk_2"). Present when diarization_mode is set in TranscriptionConfig.
+                          "startOffset": "A String", # Start offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                          "text": "A String", # The transcribed word.
+                        },
+                      },
+                    ],
+                    "text": "A String", # Required. The text content.
+                  },
+                  "video": { # A video content block.
+                    "data": "A String", # The video content.
+                    "mimeTypeString": "A String", # Flexible MIME type string of the video, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                    "name": "A String", # A user-defined name for this content block. Can be referenced by the model in the final response.
+                    "processingConfig": {
+                      "static": {
+                        "endOffset": "A String", # Optional. Segment end time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "30s". Must be non-negative and greater than `start_offset` if `start_offset` is set.
+                        "fps": 3.14, # Optional. Video frame-rate sampling density.
+                        "startOffset": "A String", # Optional. Segment start time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "10.5s". Must be non-negative.
+                      },
+                    },
+                    "processingType": "A String",
+                    "resolution": "A String", # The resolution of the media.
+                    "uri": "A String", # The URI of the video.
+                  },
+                },
+                "listValue": { # `ListValue` is a wrapper around a repeated field of values. # Represents a repeated `Value`.
+                  "values": [ # Repeated field of dynamically typed values.
+                    # Object with schema name: GenaiVertexV1Value
+                  ],
+                },
+                "nullValue": "A String", # Represents a null value.
+                "numberValue": 3.14, # Represents a double value.
+                "stringValue": "A String", # Represents a string value.
+                "structValue": # Object with schema name: GenaiVertexV1Struct # Represents a structured value.
+              },
+            },
+          ],
+        },
+      },
+      "video": { # Configuration for video output format.
+        "aspectRatio": "A String", # The aspect ratio for the video output.
+        "delivery": "A String", # The delivery mode for the video output.
+        "duration": "A String", # The duration for the video output.
+        "gcsUri": "A String", # The Cloud Storage URI to store the video output. Required for Vertex if delivery mode is URI.
+        "resolution": "A String", # The video output resolution. Defaults to 720p.
+      },
+    },
+    "safetySettings": [ # Safety settings for the interaction.
+      { # A safety setting that affects the safety-blocking behavior. A SafetySetting consists of a harm category and a threshold for that category.
+        "method": "A String", # Optional. The method for blocking content. If not specified, the default behavior is to use the probability score.
+        "threshold": "A String", # Required. The threshold for blocking content. If the harm probability exceeds this threshold, the content will be blocked.
+        "type": "A String", # Required. The type of harm category to be blocked.
+      },
+    ],
+    "serviceTier": "A String", # The service tier for the interaction.
+    "status": "A String", # Required. Output only. The status of the interaction.
+    "stepList": { # A list of Steps. # Input only. The steps for the interaction.
+      "steps": [ # The steps of the list.
+        { # A step in the interaction.
+          "modelOutput": { # Output generated by the model.
+            "content": [
+              { # The content of the response.
+                "audio": { # An audio content block.
+                  "channels": 42, # The number of audio channels.
+                  "data": "A String", # The audio content.
+                  "mimeTypeString": "A String", # Flexible MIME type string of the audio, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                  "sampleRate": 42, # The sample rate of the audio.
+                  "uri": "A String", # The URI of the audio.
+                },
+                "document": { # A document content block.
+                  "data": "A String", # The document content.
+                  "mimeTypeString": "A String", # Flexible MIME type string of the document, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                  "uri": "A String", # The URI of the document.
+                },
+                "image": { # An image content block.
+                  "data": "A String", # The image content.
+                  "mimeTypeString": "A String", # Flexible MIME type string of the image, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                  "resolution": "A String", # The resolution of the media.
+                  "uri": "A String", # The URI of the image.
+                },
+                "text": { # A text content block.
+                  "annotations": [ # Citation information for model-generated content.
+                    { # Citation information for model-generated content.
+                      "endIndex": 42, # End of the attributed segment, exclusive.
+                      "fileCitation": { # A file citation annotation. # A file citation annotation.
+                        "customMetadata": { # User provided metadata about the retrieved context.
+                          "a_key": "", # Properties of the object.
+                        },
+                        "documentUri": "A String", # The URI of the file.
+                        "fileName": "A String", # The name of the file.
+                        "mediaId": "A String", # Media ID in-case of image citations, if applicable.
+                        "pageNumber": 42, # Page number of the cited document, if applicable.
+                        "source": "A String", # Source attributed for a portion of the text.
+                      },
+                      "placeCitation": { # A place citation annotation. # A place citation annotation.
+                        "name": "A String", # Title of the place.
+                        "placeId": "A String", # The ID of the place, in `places/{place_id}` format.
+                        "reviewSnippets": [ # Snippets of reviews that are used to generate answers about the features of a given place in Google Maps.
+                          { # Encapsulates a snippet of a user review that answers a question about the features of a specific place in Google Maps.
+                            "reviewId": "A String", # The ID of the review snippet.
+                            "title": "A String", # Title of the review.
+                            "url": "A String", # A link that corresponds to the user review on Google Maps.
+                          },
+                        ],
+                        "url": "A String", # URI reference of the place.
+                      },
+                      "speechMetadata": { # Speech annotation for text content. # Speech annotation for text content.
+                        "speaker": "A String", # The speaker to associate with this turn.
+                        "style": "A String", # Style instruction for the speech synthesis.
+                      },
+                      "startIndex": 42, # Start of segment of the response that is attributed to this source. Index indicates the start of the segment, measured in bytes.
+                      "urlCitation": { # A URL citation annotation. # NOTE: We use these instead of the Citation message for historical reasons. A URL citation annotation.
+                        "title": "A String", # The title of the URL.
+                        "url": "A String", # The URL.
+                      },
+                      "wordInfo": { # Word-level ASR annotation for transcription output. Carries the word text, optional timing, and optional speaker attribution. # Word-level ASR annotation with timing and speaker info.
+                        "endOffset": "A String", # End offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                        "speaker": "A String", # Optional. Speaker label for this word (e.g. "spk_1", "spk_2"). Present when diarization_mode is set in TranscriptionConfig.
+                        "startOffset": "A String", # Start offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                        "text": "A String", # The transcribed word.
+                      },
+                    },
+                  ],
+                  "text": "A String", # Required. The text content.
+                },
+                "video": { # A video content block.
+                  "data": "A String", # The video content.
+                  "mimeTypeString": "A String", # Flexible MIME type string of the video, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                  "name": "A String", # A user-defined name for this content block. Can be referenced by the model in the final response.
+                  "processingConfig": {
+                    "static": {
+                      "endOffset": "A String", # Optional. Segment end time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "30s". Must be non-negative and greater than `start_offset` if `start_offset` is set.
+                      "fps": 3.14, # Optional. Video frame-rate sampling density.
+                      "startOffset": "A String", # Optional. Segment start time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "10.5s". Must be non-negative.
+                    },
+                  },
+                  "processingType": "A String",
+                  "resolution": "A String", # The resolution of the media.
+                  "uri": "A String", # The URI of the video.
+                },
+              },
+            ],
+            "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.
+            },
+          },
+          "thought": { # A thought step.
+            "signature": "A String", # A signature hash for backend validation.
+            "summary": [ # A summary of the thought.
+              { # The content of the response.
+                "audio": { # An audio content block.
+                  "channels": 42, # The number of audio channels.
+                  "data": "A String", # The audio content.
+                  "mimeTypeString": "A String", # Flexible MIME type string of the audio, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                  "sampleRate": 42, # The sample rate of the audio.
+                  "uri": "A String", # The URI of the audio.
+                },
+                "document": { # A document content block.
+                  "data": "A String", # The document content.
+                  "mimeTypeString": "A String", # Flexible MIME type string of the document, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                  "uri": "A String", # The URI of the document.
+                },
+                "image": { # An image content block.
+                  "data": "A String", # The image content.
+                  "mimeTypeString": "A String", # Flexible MIME type string of the image, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                  "resolution": "A String", # The resolution of the media.
+                  "uri": "A String", # The URI of the image.
+                },
+                "text": { # A text content block.
+                  "annotations": [ # Citation information for model-generated content.
+                    { # Citation information for model-generated content.
+                      "endIndex": 42, # End of the attributed segment, exclusive.
+                      "fileCitation": { # A file citation annotation. # A file citation annotation.
+                        "customMetadata": { # User provided metadata about the retrieved context.
+                          "a_key": "", # Properties of the object.
+                        },
+                        "documentUri": "A String", # The URI of the file.
+                        "fileName": "A String", # The name of the file.
+                        "mediaId": "A String", # Media ID in-case of image citations, if applicable.
+                        "pageNumber": 42, # Page number of the cited document, if applicable.
+                        "source": "A String", # Source attributed for a portion of the text.
+                      },
+                      "placeCitation": { # A place citation annotation. # A place citation annotation.
+                        "name": "A String", # Title of the place.
+                        "placeId": "A String", # The ID of the place, in `places/{place_id}` format.
+                        "reviewSnippets": [ # Snippets of reviews that are used to generate answers about the features of a given place in Google Maps.
+                          { # Encapsulates a snippet of a user review that answers a question about the features of a specific place in Google Maps.
+                            "reviewId": "A String", # The ID of the review snippet.
+                            "title": "A String", # Title of the review.
+                            "url": "A String", # A link that corresponds to the user review on Google Maps.
+                          },
+                        ],
+                        "url": "A String", # URI reference of the place.
+                      },
+                      "speechMetadata": { # Speech annotation for text content. # Speech annotation for text content.
+                        "speaker": "A String", # The speaker to associate with this turn.
+                        "style": "A String", # Style instruction for the speech synthesis.
+                      },
+                      "startIndex": 42, # Start of segment of the response that is attributed to this source. Index indicates the start of the segment, measured in bytes.
+                      "urlCitation": { # A URL citation annotation. # NOTE: We use these instead of the Citation message for historical reasons. A URL citation annotation.
+                        "title": "A String", # The title of the URL.
+                        "url": "A String", # The URL.
+                      },
+                      "wordInfo": { # Word-level ASR annotation for transcription output. Carries the word text, optional timing, and optional speaker attribution. # Word-level ASR annotation with timing and speaker info.
+                        "endOffset": "A String", # End offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                        "speaker": "A String", # Optional. Speaker label for this word (e.g. "spk_1", "spk_2"). Present when diarization_mode is set in TranscriptionConfig.
+                        "startOffset": "A String", # Start offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                        "text": "A String", # The transcribed word.
+                      },
+                    },
+                  ],
+                  "text": "A String", # Required. The text content.
+                },
+                "video": { # A video content block.
+                  "data": "A String", # The video content.
+                  "mimeTypeString": "A String", # Flexible MIME type string of the video, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                  "name": "A String", # A user-defined name for this content block. Can be referenced by the model in the final response.
+                  "processingConfig": {
+                    "static": {
+                      "endOffset": "A String", # Optional. Segment end time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "30s". Must be non-negative and greater than `start_offset` if `start_offset` is set.
+                      "fps": 3.14, # Optional. Video frame-rate sampling density.
+                      "startOffset": "A String", # Optional. Segment start time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "10.5s". Must be non-negative.
+                    },
+                  },
+                  "processingType": "A String",
+                  "resolution": "A String", # The resolution of the media.
+                  "uri": "A String", # The URI of the video.
+                },
+              },
+            ],
+          },
+          "toolCall": { # Tool call step.
+            "codeExecutionCall": { # Code execution call step.
+              "arguments": { # The arguments to pass to the code execution. # Required. The arguments to pass to the code execution.
+                "code": "A String", # The code to be executed.
+                "language": "A String", # Programming language of the `code`.
+              },
+            },
+            "fileSearchCall": { # File Search call step.
+            },
+            "functionCall": { # A function tool call step.
+              "arguments": { # `Struct` represents a structured data value, consisting of fields which map to dynamically typed values. # Required. The arguments to pass to the function.
+                "fields": [ # Dynamically typed fields. List instead of map because LLMs are sensitive to ordering, and we want to give users full control.
+                  { # Represents a single field in a struct.
+                    "name": "A String",
+                    "value": { # `Value` represents a dynamically typed value which can be either null, a number, a string, a boolean, a recursive struct value, or a list of values. A producer of value is expected to set one of these variants. Absence of any variant indicates an error.
+                      "boolValue": True or False, # Represents a boolean value.
+                      "contentValue": { # The content of the response. # Represents rich content (text, image, etc.).
+                        "audio": { # An audio content block.
+                          "channels": 42, # The number of audio channels.
+                          "data": "A String", # The audio content.
+                          "mimeTypeString": "A String", # Flexible MIME type string of the audio, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                          "sampleRate": 42, # The sample rate of the audio.
+                          "uri": "A String", # The URI of the audio.
+                        },
+                        "document": { # A document content block.
+                          "data": "A String", # The document content.
+                          "mimeTypeString": "A String", # Flexible MIME type string of the document, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                          "uri": "A String", # The URI of the document.
+                        },
+                        "image": { # An image content block.
+                          "data": "A String", # The image content.
+                          "mimeTypeString": "A String", # Flexible MIME type string of the image, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                          "resolution": "A String", # The resolution of the media.
+                          "uri": "A String", # The URI of the image.
+                        },
+                        "text": { # A text content block.
+                          "annotations": [ # Citation information for model-generated content.
+                            { # Citation information for model-generated content.
+                              "endIndex": 42, # End of the attributed segment, exclusive.
+                              "fileCitation": { # A file citation annotation. # A file citation annotation.
+                                "customMetadata": { # User provided metadata about the retrieved context.
+                                  "a_key": "", # Properties of the object.
+                                },
+                                "documentUri": "A String", # The URI of the file.
+                                "fileName": "A String", # The name of the file.
+                                "mediaId": "A String", # Media ID in-case of image citations, if applicable.
+                                "pageNumber": 42, # Page number of the cited document, if applicable.
+                                "source": "A String", # Source attributed for a portion of the text.
+                              },
+                              "placeCitation": { # A place citation annotation. # A place citation annotation.
+                                "name": "A String", # Title of the place.
+                                "placeId": "A String", # The ID of the place, in `places/{place_id}` format.
+                                "reviewSnippets": [ # Snippets of reviews that are used to generate answers about the features of a given place in Google Maps.
+                                  { # Encapsulates a snippet of a user review that answers a question about the features of a specific place in Google Maps.
+                                    "reviewId": "A String", # The ID of the review snippet.
+                                    "title": "A String", # Title of the review.
+                                    "url": "A String", # A link that corresponds to the user review on Google Maps.
+                                  },
+                                ],
+                                "url": "A String", # URI reference of the place.
+                              },
+                              "speechMetadata": { # Speech annotation for text content. # Speech annotation for text content.
+                                "speaker": "A String", # The speaker to associate with this turn.
+                                "style": "A String", # Style instruction for the speech synthesis.
+                              },
+                              "startIndex": 42, # Start of segment of the response that is attributed to this source. Index indicates the start of the segment, measured in bytes.
+                              "urlCitation": { # A URL citation annotation. # NOTE: We use these instead of the Citation message for historical reasons. A URL citation annotation.
+                                "title": "A String", # The title of the URL.
+                                "url": "A String", # The URL.
+                              },
+                              "wordInfo": { # Word-level ASR annotation for transcription output. Carries the word text, optional timing, and optional speaker attribution. # Word-level ASR annotation with timing and speaker info.
+                                "endOffset": "A String", # End offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                                "speaker": "A String", # Optional. Speaker label for this word (e.g. "spk_1", "spk_2"). Present when diarization_mode is set in TranscriptionConfig.
+                                "startOffset": "A String", # Start offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                                "text": "A String", # The transcribed word.
+                              },
+                            },
+                          ],
+                          "text": "A String", # Required. The text content.
+                        },
+                        "video": { # A video content block.
+                          "data": "A String", # The video content.
+                          "mimeTypeString": "A String", # Flexible MIME type string of the video, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                          "name": "A String", # A user-defined name for this content block. Can be referenced by the model in the final response.
+                          "processingConfig": {
+                            "static": {
+                              "endOffset": "A String", # Optional. Segment end time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "30s". Must be non-negative and greater than `start_offset` if `start_offset` is set.
+                              "fps": 3.14, # Optional. Video frame-rate sampling density.
+                              "startOffset": "A String", # Optional. Segment start time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "10.5s". Must be non-negative.
+                            },
+                          },
+                          "processingType": "A String",
+                          "resolution": "A String", # The resolution of the media.
+                          "uri": "A String", # The URI of the video.
+                        },
+                      },
+                      "listValue": { # `ListValue` is a wrapper around a repeated field of values. # Represents a repeated `Value`.
+                        "values": [ # Repeated field of dynamically typed values.
+                          # Object with schema name: GenaiVertexV1Value
+                        ],
+                      },
+                      "nullValue": "A String", # Represents a null value.
+                      "numberValue": 3.14, # Represents a double value.
+                      "stringValue": "A String", # Represents a string value.
+                      "structValue": # Object with schema name: GenaiVertexV1Struct # Represents a structured value.
+                    },
+                  },
+                ],
+              },
+              "name": "A String", # Required. The name of the tool to call.
+            },
+            "googleMapsCall": { # Google Maps call step.
+              "arguments": { # The arguments to pass to the Google Maps tool. # The arguments to pass to the Google Maps tool.
+                "queries": [ # The queries to be executed.
+                  "A String",
+                ],
+              },
+            },
+            "googleSearchCall": { # Google Search call step.
+              "arguments": { # The arguments to pass to Google Search. # Required. The arguments to pass to Google Search.
+                "queries": [ # Web search queries for the following-up web search.
+                  "A String",
+                ],
+              },
+              "searchType": "A String", # The type of search grounding enabled.
+            },
+            "id": "A String", # Required. A unique ID for this specific tool call.
+            "processingCall": { # A server-initiated processing step for media analysis (e.g. video understanding).
+            },
+            "retrievalCall": { # Retrieval call step. Used by Vertex Retrieval tools such as Parallel AI, Exa AI, Vertex AI Search, etc. RetrievalType decides which tool is used.
+              "arguments": { # The arguments to pass to Retrieval tools. # Required. The arguments to pass to the retrieval tool.
+                "queries": [ # Queries for Retrieval information.
+                  "A String",
+                ],
+              },
+              "retrievalType": "A String", # The type of retrieval tools.
+            },
+            "signature": "A String", # A signature hash for backend validation.
+            "urlContextCall": { # URL context call step.
+              "arguments": { # The arguments to pass to the URL context. # Required. The arguments to pass to the URL context.
+                "urls": [ # The URLs to fetch.
+                  "A String",
+                ],
+              },
+            },
+          },
+          "toolResult": { # Tool result step.
+            "callId": "A String", # Required. ID to match the ID from the function call block.
+            "codeExecutionResult": { # Code execution result step.
+              "isError": True or False, # Whether the code execution resulted in an error.
+              "result": "A String", # Required. The output of the code execution.
+            },
+            "fileSearchResult": { # File Search result step.
+            },
+            "functionResult": { # Result of a function tool call.
+              "isError": True or False, # Whether the tool call resulted in an error.
+              "name": "A String", # The name of the tool that was called.
+              "result": { # `Value` represents a dynamically typed value which can be either null, a number, a string, a boolean, a recursive struct value, or a list of values. A producer of value is expected to set one of these variants. Absence of any variant indicates an error. # Required. The result of the tool call.
+                "boolValue": True or False, # Represents a boolean value.
+                "contentValue": { # The content of the response. # Represents rich content (text, image, etc.).
+                  "audio": { # An audio content block.
+                    "channels": 42, # The number of audio channels.
+                    "data": "A String", # The audio content.
+                    "mimeTypeString": "A String", # Flexible MIME type string of the audio, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                    "sampleRate": 42, # The sample rate of the audio.
+                    "uri": "A String", # The URI of the audio.
+                  },
+                  "document": { # A document content block.
+                    "data": "A String", # The document content.
+                    "mimeTypeString": "A String", # Flexible MIME type string of the document, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                    "uri": "A String", # The URI of the document.
+                  },
+                  "image": { # An image content block.
+                    "data": "A String", # The image content.
+                    "mimeTypeString": "A String", # Flexible MIME type string of the image, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                    "resolution": "A String", # The resolution of the media.
+                    "uri": "A String", # The URI of the image.
+                  },
+                  "text": { # A text content block.
+                    "annotations": [ # Citation information for model-generated content.
+                      { # Citation information for model-generated content.
+                        "endIndex": 42, # End of the attributed segment, exclusive.
+                        "fileCitation": { # A file citation annotation. # A file citation annotation.
+                          "customMetadata": { # User provided metadata about the retrieved context.
+                            "a_key": "", # Properties of the object.
+                          },
+                          "documentUri": "A String", # The URI of the file.
+                          "fileName": "A String", # The name of the file.
+                          "mediaId": "A String", # Media ID in-case of image citations, if applicable.
+                          "pageNumber": 42, # Page number of the cited document, if applicable.
+                          "source": "A String", # Source attributed for a portion of the text.
+                        },
+                        "placeCitation": { # A place citation annotation. # A place citation annotation.
+                          "name": "A String", # Title of the place.
+                          "placeId": "A String", # The ID of the place, in `places/{place_id}` format.
+                          "reviewSnippets": [ # Snippets of reviews that are used to generate answers about the features of a given place in Google Maps.
+                            { # Encapsulates a snippet of a user review that answers a question about the features of a specific place in Google Maps.
+                              "reviewId": "A String", # The ID of the review snippet.
+                              "title": "A String", # Title of the review.
+                              "url": "A String", # A link that corresponds to the user review on Google Maps.
+                            },
+                          ],
+                          "url": "A String", # URI reference of the place.
+                        },
+                        "speechMetadata": { # Speech annotation for text content. # Speech annotation for text content.
+                          "speaker": "A String", # The speaker to associate with this turn.
+                          "style": "A String", # Style instruction for the speech synthesis.
+                        },
+                        "startIndex": 42, # Start of segment of the response that is attributed to this source. Index indicates the start of the segment, measured in bytes.
+                        "urlCitation": { # A URL citation annotation. # NOTE: We use these instead of the Citation message for historical reasons. A URL citation annotation.
+                          "title": "A String", # The title of the URL.
+                          "url": "A String", # The URL.
+                        },
+                        "wordInfo": { # Word-level ASR annotation for transcription output. Carries the word text, optional timing, and optional speaker attribution. # Word-level ASR annotation with timing and speaker info.
+                          "endOffset": "A String", # End offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                          "speaker": "A String", # Optional. Speaker label for this word (e.g. "spk_1", "spk_2"). Present when diarization_mode is set in TranscriptionConfig.
+                          "startOffset": "A String", # Start offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                          "text": "A String", # The transcribed word.
+                        },
+                      },
+                    ],
+                    "text": "A String", # Required. The text content.
+                  },
+                  "video": { # A video content block.
+                    "data": "A String", # The video content.
+                    "mimeTypeString": "A String", # Flexible MIME type string of the video, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                    "name": "A String", # A user-defined name for this content block. Can be referenced by the model in the final response.
+                    "processingConfig": {
+                      "static": {
+                        "endOffset": "A String", # Optional. Segment end time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "30s". Must be non-negative and greater than `start_offset` if `start_offset` is set.
+                        "fps": 3.14, # Optional. Video frame-rate sampling density.
+                        "startOffset": "A String", # Optional. Segment start time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "10.5s". Must be non-negative.
+                      },
+                    },
+                    "processingType": "A String",
+                    "resolution": "A String", # The resolution of the media.
+                    "uri": "A String", # The URI of the video.
+                  },
+                },
+                "listValue": { # `ListValue` is a wrapper around a repeated field of values. # Represents a repeated `Value`.
+                  "values": [ # Repeated field of dynamically typed values.
+                    # Object with schema name: GenaiVertexV1Value
+                  ],
+                },
+                "nullValue": "A String", # Represents a null value.
+                "numberValue": 3.14, # Represents a double value.
+                "stringValue": "A String", # Represents a string value.
+                "structValue": # Object with schema name: GenaiVertexV1Struct # Represents a structured value.
+              },
+            },
+            "googleMapsResult": { # Google Maps result step.
+              "result": [
+                { # The result of the Google Maps.
+                  "places": [
+                    {
+                      "name": "A String",
+                      "placeId": "A String",
+                      "reviewSnippets": [
+                        { # Encapsulates a snippet of a user review that answers a question about the features of a specific place in Google Maps.
+                          "reviewId": "A String", # The ID of the review snippet.
+                          "title": "A String", # Title of the review.
+                          "url": "A String", # A link that corresponds to the user review on Google Maps.
+                        },
+                      ],
+                      "url": "A String",
+                    },
+                  ],
+                  "widgetContextToken": "A String",
+                },
+              ],
+            },
+            "googleSearchResult": { # Google Search result step.
+              "isError": True or False, # Whether the Google Search resulted in an error.
+              "result": [ # Required. The results of the Google Search.
+                { # The result of the Google Search.
+                  "searchSuggestions": "A String", # Web content snippet that can be embedded in a web page or an app webview.
+                },
+              ],
+            },
+            "processingResult": { # The result of a server-initiated media processing step.
+            },
+            "retrievalResult": { # Vertex Retrieval result step. Used by Vertex Retrieval tools such as Parallel AI, Exa AI, Vertex AI Search, etc.
+              "isError": True or False, # Whether the retrieval resulted in an error.
+            },
+            "signature": "A String", # A signature hash for backend validation.
+            "urlContextResult": { # URL context result step.
+              "isError": True or False, # Whether the URL context resulted in an error.
+              "result": [ # Required. The results of the URL context.
+                { # The result of the URL context.
+                  "status": "A String", # The status of the URL retrieval.
+                  "url": "A String", # The URL that was fetched.
+                },
+              ],
+            },
+          },
+          "userInput": { # Input provided by the user. # DO NOT USE -- These are for 3P JSON only
+            "contentList": { # A list of Content. # The content of the step. An array of Content objects.
+              "contents": [ # The contents of the list.
+                { # The content of the response.
+                  "audio": { # An audio content block.
+                    "channels": 42, # The number of audio channels.
+                    "data": "A String", # The audio content.
+                    "mimeTypeString": "A String", # Flexible MIME type string of the audio, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                    "sampleRate": 42, # The sample rate of the audio.
+                    "uri": "A String", # The URI of the audio.
+                  },
+                  "document": { # A document content block.
+                    "data": "A String", # The document content.
+                    "mimeTypeString": "A String", # Flexible MIME type string of the document, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                    "uri": "A String", # The URI of the document.
+                  },
+                  "image": { # An image content block.
+                    "data": "A String", # The image content.
+                    "mimeTypeString": "A String", # Flexible MIME type string of the image, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                    "resolution": "A String", # The resolution of the media.
+                    "uri": "A String", # The URI of the image.
+                  },
+                  "text": { # A text content block.
+                    "annotations": [ # Citation information for model-generated content.
+                      { # Citation information for model-generated content.
+                        "endIndex": 42, # End of the attributed segment, exclusive.
+                        "fileCitation": { # A file citation annotation. # A file citation annotation.
+                          "customMetadata": { # User provided metadata about the retrieved context.
+                            "a_key": "", # Properties of the object.
+                          },
+                          "documentUri": "A String", # The URI of the file.
+                          "fileName": "A String", # The name of the file.
+                          "mediaId": "A String", # Media ID in-case of image citations, if applicable.
+                          "pageNumber": 42, # Page number of the cited document, if applicable.
+                          "source": "A String", # Source attributed for a portion of the text.
+                        },
+                        "placeCitation": { # A place citation annotation. # A place citation annotation.
+                          "name": "A String", # Title of the place.
+                          "placeId": "A String", # The ID of the place, in `places/{place_id}` format.
+                          "reviewSnippets": [ # Snippets of reviews that are used to generate answers about the features of a given place in Google Maps.
+                            { # Encapsulates a snippet of a user review that answers a question about the features of a specific place in Google Maps.
+                              "reviewId": "A String", # The ID of the review snippet.
+                              "title": "A String", # Title of the review.
+                              "url": "A String", # A link that corresponds to the user review on Google Maps.
+                            },
+                          ],
+                          "url": "A String", # URI reference of the place.
+                        },
+                        "speechMetadata": { # Speech annotation for text content. # Speech annotation for text content.
+                          "speaker": "A String", # The speaker to associate with this turn.
+                          "style": "A String", # Style instruction for the speech synthesis.
+                        },
+                        "startIndex": 42, # Start of segment of the response that is attributed to this source. Index indicates the start of the segment, measured in bytes.
+                        "urlCitation": { # A URL citation annotation. # NOTE: We use these instead of the Citation message for historical reasons. A URL citation annotation.
+                          "title": "A String", # The title of the URL.
+                          "url": "A String", # The URL.
+                        },
+                        "wordInfo": { # Word-level ASR annotation for transcription output. Carries the word text, optional timing, and optional speaker attribution. # Word-level ASR annotation with timing and speaker info.
+                          "endOffset": "A String", # End offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                          "speaker": "A String", # Optional. Speaker label for this word (e.g. "spk_1", "spk_2"). Present when diarization_mode is set in TranscriptionConfig.
+                          "startOffset": "A String", # Start offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                          "text": "A String", # The transcribed word.
+                        },
+                      },
+                    ],
+                    "text": "A String", # Required. The text content.
+                  },
+                  "video": { # A video content block.
+                    "data": "A String", # The video content.
+                    "mimeTypeString": "A String", # Flexible MIME type string of the video, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                    "name": "A String", # A user-defined name for this content block. Can be referenced by the model in the final response.
+                    "processingConfig": {
+                      "static": {
+                        "endOffset": "A String", # Optional. Segment end time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "30s". Must be non-negative and greater than `start_offset` if `start_offset` is set.
+                        "fps": 3.14, # Optional. Video frame-rate sampling density.
+                        "startOffset": "A String", # Optional. Segment start time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "10.5s". Must be non-negative.
+                      },
+                    },
+                    "processingType": "A String",
+                    "resolution": "A String", # The resolution of the media.
+                    "uri": "A String", # The URI of the video.
+                  },
+                },
+              ],
+            },
+            "contentString": "A String", # The content of the step. A single string.
+          },
+        },
+      ],
+    },
+    "steps": [ # Required. Output only. The steps that make up the interaction, when included in the response.
+      { # A step in the interaction.
+        "modelOutput": { # Output generated by the model.
+          "content": [
+            { # The content of the response.
+              "audio": { # An audio content block.
+                "channels": 42, # The number of audio channels.
+                "data": "A String", # The audio content.
+                "mimeTypeString": "A String", # Flexible MIME type string of the audio, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                "sampleRate": 42, # The sample rate of the audio.
+                "uri": "A String", # The URI of the audio.
+              },
+              "document": { # A document content block.
+                "data": "A String", # The document content.
+                "mimeTypeString": "A String", # Flexible MIME type string of the document, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                "uri": "A String", # The URI of the document.
+              },
+              "image": { # An image content block.
+                "data": "A String", # The image content.
+                "mimeTypeString": "A String", # Flexible MIME type string of the image, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                "resolution": "A String", # The resolution of the media.
+                "uri": "A String", # The URI of the image.
+              },
+              "text": { # A text content block.
+                "annotations": [ # Citation information for model-generated content.
+                  { # Citation information for model-generated content.
+                    "endIndex": 42, # End of the attributed segment, exclusive.
+                    "fileCitation": { # A file citation annotation. # A file citation annotation.
+                      "customMetadata": { # User provided metadata about the retrieved context.
+                        "a_key": "", # Properties of the object.
+                      },
+                      "documentUri": "A String", # The URI of the file.
+                      "fileName": "A String", # The name of the file.
+                      "mediaId": "A String", # Media ID in-case of image citations, if applicable.
+                      "pageNumber": 42, # Page number of the cited document, if applicable.
+                      "source": "A String", # Source attributed for a portion of the text.
+                    },
+                    "placeCitation": { # A place citation annotation. # A place citation annotation.
+                      "name": "A String", # Title of the place.
+                      "placeId": "A String", # The ID of the place, in `places/{place_id}` format.
+                      "reviewSnippets": [ # Snippets of reviews that are used to generate answers about the features of a given place in Google Maps.
+                        { # Encapsulates a snippet of a user review that answers a question about the features of a specific place in Google Maps.
+                          "reviewId": "A String", # The ID of the review snippet.
+                          "title": "A String", # Title of the review.
+                          "url": "A String", # A link that corresponds to the user review on Google Maps.
+                        },
+                      ],
+                      "url": "A String", # URI reference of the place.
+                    },
+                    "speechMetadata": { # Speech annotation for text content. # Speech annotation for text content.
+                      "speaker": "A String", # The speaker to associate with this turn.
+                      "style": "A String", # Style instruction for the speech synthesis.
+                    },
+                    "startIndex": 42, # Start of segment of the response that is attributed to this source. Index indicates the start of the segment, measured in bytes.
+                    "urlCitation": { # A URL citation annotation. # NOTE: We use these instead of the Citation message for historical reasons. A URL citation annotation.
+                      "title": "A String", # The title of the URL.
+                      "url": "A String", # The URL.
+                    },
+                    "wordInfo": { # Word-level ASR annotation for transcription output. Carries the word text, optional timing, and optional speaker attribution. # Word-level ASR annotation with timing and speaker info.
+                      "endOffset": "A String", # End offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                      "speaker": "A String", # Optional. Speaker label for this word (e.g. "spk_1", "spk_2"). Present when diarization_mode is set in TranscriptionConfig.
+                      "startOffset": "A String", # Start offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                      "text": "A String", # The transcribed word.
+                    },
+                  },
+                ],
+                "text": "A String", # Required. The text content.
+              },
+              "video": { # A video content block.
+                "data": "A String", # The video content.
+                "mimeTypeString": "A String", # Flexible MIME type string of the video, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                "name": "A String", # A user-defined name for this content block. Can be referenced by the model in the final response.
+                "processingConfig": {
+                  "static": {
+                    "endOffset": "A String", # Optional. Segment end time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "30s". Must be non-negative and greater than `start_offset` if `start_offset` is set.
+                    "fps": 3.14, # Optional. Video frame-rate sampling density.
+                    "startOffset": "A String", # Optional. Segment start time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "10.5s". Must be non-negative.
+                  },
+                },
+                "processingType": "A String",
+                "resolution": "A String", # The resolution of the media.
+                "uri": "A String", # The URI of the video.
+              },
+            },
+          ],
+          "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.
+          },
+        },
+        "thought": { # A thought step.
+          "signature": "A String", # A signature hash for backend validation.
+          "summary": [ # A summary of the thought.
+            { # The content of the response.
+              "audio": { # An audio content block.
+                "channels": 42, # The number of audio channels.
+                "data": "A String", # The audio content.
+                "mimeTypeString": "A String", # Flexible MIME type string of the audio, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                "sampleRate": 42, # The sample rate of the audio.
+                "uri": "A String", # The URI of the audio.
+              },
+              "document": { # A document content block.
+                "data": "A String", # The document content.
+                "mimeTypeString": "A String", # Flexible MIME type string of the document, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                "uri": "A String", # The URI of the document.
+              },
+              "image": { # An image content block.
+                "data": "A String", # The image content.
+                "mimeTypeString": "A String", # Flexible MIME type string of the image, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                "resolution": "A String", # The resolution of the media.
+                "uri": "A String", # The URI of the image.
+              },
+              "text": { # A text content block.
+                "annotations": [ # Citation information for model-generated content.
+                  { # Citation information for model-generated content.
+                    "endIndex": 42, # End of the attributed segment, exclusive.
+                    "fileCitation": { # A file citation annotation. # A file citation annotation.
+                      "customMetadata": { # User provided metadata about the retrieved context.
+                        "a_key": "", # Properties of the object.
+                      },
+                      "documentUri": "A String", # The URI of the file.
+                      "fileName": "A String", # The name of the file.
+                      "mediaId": "A String", # Media ID in-case of image citations, if applicable.
+                      "pageNumber": 42, # Page number of the cited document, if applicable.
+                      "source": "A String", # Source attributed for a portion of the text.
+                    },
+                    "placeCitation": { # A place citation annotation. # A place citation annotation.
+                      "name": "A String", # Title of the place.
+                      "placeId": "A String", # The ID of the place, in `places/{place_id}` format.
+                      "reviewSnippets": [ # Snippets of reviews that are used to generate answers about the features of a given place in Google Maps.
+                        { # Encapsulates a snippet of a user review that answers a question about the features of a specific place in Google Maps.
+                          "reviewId": "A String", # The ID of the review snippet.
+                          "title": "A String", # Title of the review.
+                          "url": "A String", # A link that corresponds to the user review on Google Maps.
+                        },
+                      ],
+                      "url": "A String", # URI reference of the place.
+                    },
+                    "speechMetadata": { # Speech annotation for text content. # Speech annotation for text content.
+                      "speaker": "A String", # The speaker to associate with this turn.
+                      "style": "A String", # Style instruction for the speech synthesis.
+                    },
+                    "startIndex": 42, # Start of segment of the response that is attributed to this source. Index indicates the start of the segment, measured in bytes.
+                    "urlCitation": { # A URL citation annotation. # NOTE: We use these instead of the Citation message for historical reasons. A URL citation annotation.
+                      "title": "A String", # The title of the URL.
+                      "url": "A String", # The URL.
+                    },
+                    "wordInfo": { # Word-level ASR annotation for transcription output. Carries the word text, optional timing, and optional speaker attribution. # Word-level ASR annotation with timing and speaker info.
+                      "endOffset": "A String", # End offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                      "speaker": "A String", # Optional. Speaker label for this word (e.g. "spk_1", "spk_2"). Present when diarization_mode is set in TranscriptionConfig.
+                      "startOffset": "A String", # Start offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                      "text": "A String", # The transcribed word.
+                    },
+                  },
+                ],
+                "text": "A String", # Required. The text content.
+              },
+              "video": { # A video content block.
+                "data": "A String", # The video content.
+                "mimeTypeString": "A String", # Flexible MIME type string of the video, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                "name": "A String", # A user-defined name for this content block. Can be referenced by the model in the final response.
+                "processingConfig": {
+                  "static": {
+                    "endOffset": "A String", # Optional. Segment end time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "30s". Must be non-negative and greater than `start_offset` if `start_offset` is set.
+                    "fps": 3.14, # Optional. Video frame-rate sampling density.
+                    "startOffset": "A String", # Optional. Segment start time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "10.5s". Must be non-negative.
+                  },
+                },
+                "processingType": "A String",
+                "resolution": "A String", # The resolution of the media.
+                "uri": "A String", # The URI of the video.
+              },
+            },
+          ],
+        },
+        "toolCall": { # Tool call step.
+          "codeExecutionCall": { # Code execution call step.
+            "arguments": { # The arguments to pass to the code execution. # Required. The arguments to pass to the code execution.
+              "code": "A String", # The code to be executed.
+              "language": "A String", # Programming language of the `code`.
+            },
+          },
+          "fileSearchCall": { # File Search call step.
+          },
+          "functionCall": { # A function tool call step.
+            "arguments": { # `Struct` represents a structured data value, consisting of fields which map to dynamically typed values. # Required. The arguments to pass to the function.
+              "fields": [ # Dynamically typed fields. List instead of map because LLMs are sensitive to ordering, and we want to give users full control.
+                { # Represents a single field in a struct.
+                  "name": "A String",
+                  "value": { # `Value` represents a dynamically typed value which can be either null, a number, a string, a boolean, a recursive struct value, or a list of values. A producer of value is expected to set one of these variants. Absence of any variant indicates an error.
+                    "boolValue": True or False, # Represents a boolean value.
+                    "contentValue": { # The content of the response. # Represents rich content (text, image, etc.).
+                      "audio": { # An audio content block.
+                        "channels": 42, # The number of audio channels.
+                        "data": "A String", # The audio content.
+                        "mimeTypeString": "A String", # Flexible MIME type string of the audio, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                        "sampleRate": 42, # The sample rate of the audio.
+                        "uri": "A String", # The URI of the audio.
+                      },
+                      "document": { # A document content block.
+                        "data": "A String", # The document content.
+                        "mimeTypeString": "A String", # Flexible MIME type string of the document, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                        "uri": "A String", # The URI of the document.
+                      },
+                      "image": { # An image content block.
+                        "data": "A String", # The image content.
+                        "mimeTypeString": "A String", # Flexible MIME type string of the image, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                        "resolution": "A String", # The resolution of the media.
+                        "uri": "A String", # The URI of the image.
+                      },
+                      "text": { # A text content block.
+                        "annotations": [ # Citation information for model-generated content.
+                          { # Citation information for model-generated content.
+                            "endIndex": 42, # End of the attributed segment, exclusive.
+                            "fileCitation": { # A file citation annotation. # A file citation annotation.
+                              "customMetadata": { # User provided metadata about the retrieved context.
+                                "a_key": "", # Properties of the object.
+                              },
+                              "documentUri": "A String", # The URI of the file.
+                              "fileName": "A String", # The name of the file.
+                              "mediaId": "A String", # Media ID in-case of image citations, if applicable.
+                              "pageNumber": 42, # Page number of the cited document, if applicable.
+                              "source": "A String", # Source attributed for a portion of the text.
+                            },
+                            "placeCitation": { # A place citation annotation. # A place citation annotation.
+                              "name": "A String", # Title of the place.
+                              "placeId": "A String", # The ID of the place, in `places/{place_id}` format.
+                              "reviewSnippets": [ # Snippets of reviews that are used to generate answers about the features of a given place in Google Maps.
+                                { # Encapsulates a snippet of a user review that answers a question about the features of a specific place in Google Maps.
+                                  "reviewId": "A String", # The ID of the review snippet.
+                                  "title": "A String", # Title of the review.
+                                  "url": "A String", # A link that corresponds to the user review on Google Maps.
+                                },
+                              ],
+                              "url": "A String", # URI reference of the place.
+                            },
+                            "speechMetadata": { # Speech annotation for text content. # Speech annotation for text content.
+                              "speaker": "A String", # The speaker to associate with this turn.
+                              "style": "A String", # Style instruction for the speech synthesis.
+                            },
+                            "startIndex": 42, # Start of segment of the response that is attributed to this source. Index indicates the start of the segment, measured in bytes.
+                            "urlCitation": { # A URL citation annotation. # NOTE: We use these instead of the Citation message for historical reasons. A URL citation annotation.
+                              "title": "A String", # The title of the URL.
+                              "url": "A String", # The URL.
+                            },
+                            "wordInfo": { # Word-level ASR annotation for transcription output. Carries the word text, optional timing, and optional speaker attribution. # Word-level ASR annotation with timing and speaker info.
+                              "endOffset": "A String", # End offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                              "speaker": "A String", # Optional. Speaker label for this word (e.g. "spk_1", "spk_2"). Present when diarization_mode is set in TranscriptionConfig.
+                              "startOffset": "A String", # Start offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                              "text": "A String", # The transcribed word.
+                            },
+                          },
+                        ],
+                        "text": "A String", # Required. The text content.
+                      },
+                      "video": { # A video content block.
+                        "data": "A String", # The video content.
+                        "mimeTypeString": "A String", # Flexible MIME type string of the video, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                        "name": "A String", # A user-defined name for this content block. Can be referenced by the model in the final response.
+                        "processingConfig": {
+                          "static": {
+                            "endOffset": "A String", # Optional. Segment end time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "30s". Must be non-negative and greater than `start_offset` if `start_offset` is set.
+                            "fps": 3.14, # Optional. Video frame-rate sampling density.
+                            "startOffset": "A String", # Optional. Segment start time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "10.5s". Must be non-negative.
+                          },
+                        },
+                        "processingType": "A String",
+                        "resolution": "A String", # The resolution of the media.
+                        "uri": "A String", # The URI of the video.
+                      },
+                    },
+                    "listValue": { # `ListValue` is a wrapper around a repeated field of values. # Represents a repeated `Value`.
+                      "values": [ # Repeated field of dynamically typed values.
+                        # Object with schema name: GenaiVertexV1Value
+                      ],
+                    },
+                    "nullValue": "A String", # Represents a null value.
+                    "numberValue": 3.14, # Represents a double value.
+                    "stringValue": "A String", # Represents a string value.
+                    "structValue": # Object with schema name: GenaiVertexV1Struct # Represents a structured value.
+                  },
+                },
+              ],
+            },
+            "name": "A String", # Required. The name of the tool to call.
+          },
+          "googleMapsCall": { # Google Maps call step.
+            "arguments": { # The arguments to pass to the Google Maps tool. # The arguments to pass to the Google Maps tool.
+              "queries": [ # The queries to be executed.
+                "A String",
+              ],
+            },
+          },
+          "googleSearchCall": { # Google Search call step.
+            "arguments": { # The arguments to pass to Google Search. # Required. The arguments to pass to Google Search.
+              "queries": [ # Web search queries for the following-up web search.
+                "A String",
+              ],
+            },
+            "searchType": "A String", # The type of search grounding enabled.
+          },
+          "id": "A String", # Required. A unique ID for this specific tool call.
+          "processingCall": { # A server-initiated processing step for media analysis (e.g. video understanding).
+          },
+          "retrievalCall": { # Retrieval call step. Used by Vertex Retrieval tools such as Parallel AI, Exa AI, Vertex AI Search, etc. RetrievalType decides which tool is used.
+            "arguments": { # The arguments to pass to Retrieval tools. # Required. The arguments to pass to the retrieval tool.
+              "queries": [ # Queries for Retrieval information.
+                "A String",
+              ],
+            },
+            "retrievalType": "A String", # The type of retrieval tools.
+          },
+          "signature": "A String", # A signature hash for backend validation.
+          "urlContextCall": { # URL context call step.
+            "arguments": { # The arguments to pass to the URL context. # Required. The arguments to pass to the URL context.
+              "urls": [ # The URLs to fetch.
+                "A String",
+              ],
+            },
+          },
+        },
+        "toolResult": { # Tool result step.
+          "callId": "A String", # Required. ID to match the ID from the function call block.
+          "codeExecutionResult": { # Code execution result step.
+            "isError": True or False, # Whether the code execution resulted in an error.
+            "result": "A String", # Required. The output of the code execution.
+          },
+          "fileSearchResult": { # File Search result step.
+          },
+          "functionResult": { # Result of a function tool call.
+            "isError": True or False, # Whether the tool call resulted in an error.
+            "name": "A String", # The name of the tool that was called.
+            "result": { # `Value` represents a dynamically typed value which can be either null, a number, a string, a boolean, a recursive struct value, or a list of values. A producer of value is expected to set one of these variants. Absence of any variant indicates an error. # Required. The result of the tool call.
+              "boolValue": True or False, # Represents a boolean value.
+              "contentValue": { # The content of the response. # Represents rich content (text, image, etc.).
+                "audio": { # An audio content block.
+                  "channels": 42, # The number of audio channels.
+                  "data": "A String", # The audio content.
+                  "mimeTypeString": "A String", # Flexible MIME type string of the audio, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                  "sampleRate": 42, # The sample rate of the audio.
+                  "uri": "A String", # The URI of the audio.
+                },
+                "document": { # A document content block.
+                  "data": "A String", # The document content.
+                  "mimeTypeString": "A String", # Flexible MIME type string of the document, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                  "uri": "A String", # The URI of the document.
+                },
+                "image": { # An image content block.
+                  "data": "A String", # The image content.
+                  "mimeTypeString": "A String", # Flexible MIME type string of the image, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                  "resolution": "A String", # The resolution of the media.
+                  "uri": "A String", # The URI of the image.
+                },
+                "text": { # A text content block.
+                  "annotations": [ # Citation information for model-generated content.
+                    { # Citation information for model-generated content.
+                      "endIndex": 42, # End of the attributed segment, exclusive.
+                      "fileCitation": { # A file citation annotation. # A file citation annotation.
+                        "customMetadata": { # User provided metadata about the retrieved context.
+                          "a_key": "", # Properties of the object.
+                        },
+                        "documentUri": "A String", # The URI of the file.
+                        "fileName": "A String", # The name of the file.
+                        "mediaId": "A String", # Media ID in-case of image citations, if applicable.
+                        "pageNumber": 42, # Page number of the cited document, if applicable.
+                        "source": "A String", # Source attributed for a portion of the text.
+                      },
+                      "placeCitation": { # A place citation annotation. # A place citation annotation.
+                        "name": "A String", # Title of the place.
+                        "placeId": "A String", # The ID of the place, in `places/{place_id}` format.
+                        "reviewSnippets": [ # Snippets of reviews that are used to generate answers about the features of a given place in Google Maps.
+                          { # Encapsulates a snippet of a user review that answers a question about the features of a specific place in Google Maps.
+                            "reviewId": "A String", # The ID of the review snippet.
+                            "title": "A String", # Title of the review.
+                            "url": "A String", # A link that corresponds to the user review on Google Maps.
+                          },
+                        ],
+                        "url": "A String", # URI reference of the place.
+                      },
+                      "speechMetadata": { # Speech annotation for text content. # Speech annotation for text content.
+                        "speaker": "A String", # The speaker to associate with this turn.
+                        "style": "A String", # Style instruction for the speech synthesis.
+                      },
+                      "startIndex": 42, # Start of segment of the response that is attributed to this source. Index indicates the start of the segment, measured in bytes.
+                      "urlCitation": { # A URL citation annotation. # NOTE: We use these instead of the Citation message for historical reasons. A URL citation annotation.
+                        "title": "A String", # The title of the URL.
+                        "url": "A String", # The URL.
+                      },
+                      "wordInfo": { # Word-level ASR annotation for transcription output. Carries the word text, optional timing, and optional speaker attribution. # Word-level ASR annotation with timing and speaker info.
+                        "endOffset": "A String", # End offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                        "speaker": "A String", # Optional. Speaker label for this word (e.g. "spk_1", "spk_2"). Present when diarization_mode is set in TranscriptionConfig.
+                        "startOffset": "A String", # Start offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                        "text": "A String", # The transcribed word.
+                      },
+                    },
+                  ],
+                  "text": "A String", # Required. The text content.
+                },
+                "video": { # A video content block.
+                  "data": "A String", # The video content.
+                  "mimeTypeString": "A String", # Flexible MIME type string of the video, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                  "name": "A String", # A user-defined name for this content block. Can be referenced by the model in the final response.
+                  "processingConfig": {
+                    "static": {
+                      "endOffset": "A String", # Optional. Segment end time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "30s". Must be non-negative and greater than `start_offset` if `start_offset` is set.
+                      "fps": 3.14, # Optional. Video frame-rate sampling density.
+                      "startOffset": "A String", # Optional. Segment start time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "10.5s". Must be non-negative.
+                    },
+                  },
+                  "processingType": "A String",
+                  "resolution": "A String", # The resolution of the media.
+                  "uri": "A String", # The URI of the video.
+                },
+              },
+              "listValue": { # `ListValue` is a wrapper around a repeated field of values. # Represents a repeated `Value`.
+                "values": [ # Repeated field of dynamically typed values.
+                  # Object with schema name: GenaiVertexV1Value
+                ],
+              },
+              "nullValue": "A String", # Represents a null value.
+              "numberValue": 3.14, # Represents a double value.
+              "stringValue": "A String", # Represents a string value.
+              "structValue": # Object with schema name: GenaiVertexV1Struct # Represents a structured value.
+            },
+          },
+          "googleMapsResult": { # Google Maps result step.
+            "result": [
+              { # The result of the Google Maps.
+                "places": [
+                  {
+                    "name": "A String",
+                    "placeId": "A String",
+                    "reviewSnippets": [
+                      { # Encapsulates a snippet of a user review that answers a question about the features of a specific place in Google Maps.
+                        "reviewId": "A String", # The ID of the review snippet.
+                        "title": "A String", # Title of the review.
+                        "url": "A String", # A link that corresponds to the user review on Google Maps.
+                      },
+                    ],
+                    "url": "A String",
+                  },
+                ],
+                "widgetContextToken": "A String",
+              },
+            ],
+          },
+          "googleSearchResult": { # Google Search result step.
+            "isError": True or False, # Whether the Google Search resulted in an error.
+            "result": [ # Required. The results of the Google Search.
+              { # The result of the Google Search.
+                "searchSuggestions": "A String", # Web content snippet that can be embedded in a web page or an app webview.
+              },
+            ],
+          },
+          "processingResult": { # The result of a server-initiated media processing step.
+          },
+          "retrievalResult": { # Vertex Retrieval result step. Used by Vertex Retrieval tools such as Parallel AI, Exa AI, Vertex AI Search, etc.
+            "isError": True or False, # Whether the retrieval resulted in an error.
+          },
+          "signature": "A String", # A signature hash for backend validation.
+          "urlContextResult": { # URL context result step.
+            "isError": True or False, # Whether the URL context resulted in an error.
+            "result": [ # Required. The results of the URL context.
+              { # The result of the URL context.
+                "status": "A String", # The status of the URL retrieval.
+                "url": "A String", # The URL that was fetched.
+              },
+            ],
+          },
+        },
+        "userInput": { # Input provided by the user. # DO NOT USE -- These are for 3P JSON only
+          "contentList": { # A list of Content. # The content of the step. An array of Content objects.
+            "contents": [ # The contents of the list.
+              { # The content of the response.
+                "audio": { # An audio content block.
+                  "channels": 42, # The number of audio channels.
+                  "data": "A String", # The audio content.
+                  "mimeTypeString": "A String", # Flexible MIME type string of the audio, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                  "sampleRate": 42, # The sample rate of the audio.
+                  "uri": "A String", # The URI of the audio.
+                },
+                "document": { # A document content block.
+                  "data": "A String", # The document content.
+                  "mimeTypeString": "A String", # Flexible MIME type string of the document, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                  "uri": "A String", # The URI of the document.
+                },
+                "image": { # An image content block.
+                  "data": "A String", # The image content.
+                  "mimeTypeString": "A String", # Flexible MIME type string of the image, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                  "resolution": "A String", # The resolution of the media.
+                  "uri": "A String", # The URI of the image.
+                },
+                "text": { # A text content block.
+                  "annotations": [ # Citation information for model-generated content.
+                    { # Citation information for model-generated content.
+                      "endIndex": 42, # End of the attributed segment, exclusive.
+                      "fileCitation": { # A file citation annotation. # A file citation annotation.
+                        "customMetadata": { # User provided metadata about the retrieved context.
+                          "a_key": "", # Properties of the object.
+                        },
+                        "documentUri": "A String", # The URI of the file.
+                        "fileName": "A String", # The name of the file.
+                        "mediaId": "A String", # Media ID in-case of image citations, if applicable.
+                        "pageNumber": 42, # Page number of the cited document, if applicable.
+                        "source": "A String", # Source attributed for a portion of the text.
+                      },
+                      "placeCitation": { # A place citation annotation. # A place citation annotation.
+                        "name": "A String", # Title of the place.
+                        "placeId": "A String", # The ID of the place, in `places/{place_id}` format.
+                        "reviewSnippets": [ # Snippets of reviews that are used to generate answers about the features of a given place in Google Maps.
+                          { # Encapsulates a snippet of a user review that answers a question about the features of a specific place in Google Maps.
+                            "reviewId": "A String", # The ID of the review snippet.
+                            "title": "A String", # Title of the review.
+                            "url": "A String", # A link that corresponds to the user review on Google Maps.
+                          },
+                        ],
+                        "url": "A String", # URI reference of the place.
+                      },
+                      "speechMetadata": { # Speech annotation for text content. # Speech annotation for text content.
+                        "speaker": "A String", # The speaker to associate with this turn.
+                        "style": "A String", # Style instruction for the speech synthesis.
+                      },
+                      "startIndex": 42, # Start of segment of the response that is attributed to this source. Index indicates the start of the segment, measured in bytes.
+                      "urlCitation": { # A URL citation annotation. # NOTE: We use these instead of the Citation message for historical reasons. A URL citation annotation.
+                        "title": "A String", # The title of the URL.
+                        "url": "A String", # The URL.
+                      },
+                      "wordInfo": { # Word-level ASR annotation for transcription output. Carries the word text, optional timing, and optional speaker attribution. # Word-level ASR annotation with timing and speaker info.
+                        "endOffset": "A String", # End offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                        "speaker": "A String", # Optional. Speaker label for this word (e.g. "spk_1", "spk_2"). Present when diarization_mode is set in TranscriptionConfig.
+                        "startOffset": "A String", # Start offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                        "text": "A String", # The transcribed word.
+                      },
+                    },
+                  ],
+                  "text": "A String", # Required. The text content.
+                },
+                "video": { # A video content block.
+                  "data": "A String", # The video content.
+                  "mimeTypeString": "A String", # Flexible MIME type string of the video, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                  "name": "A String", # A user-defined name for this content block. Can be referenced by the model in the final response.
+                  "processingConfig": {
+                    "static": {
+                      "endOffset": "A String", # Optional. Segment end time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "30s". Must be non-negative and greater than `start_offset` if `start_offset` is set.
+                      "fps": 3.14, # Optional. Video frame-rate sampling density.
+                      "startOffset": "A String", # Optional. Segment start time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "10.5s". Must be non-negative.
+                    },
+                  },
+                  "processingType": "A String",
+                  "resolution": "A String", # The resolution of the media.
+                  "uri": "A String", # The URI of the video.
+                },
+              },
+            ],
+          },
+          "contentString": "A String", # The content of the step. A single string.
+        },
+      },
+    ],
+    "stringContent": "A String", # A string input for the interaction, it will be processed as a single text input.
+    "systemInstruction": "A String", # System instruction for the interaction.
+    "tools": [ # A list of tool declarations the model may call during interaction.
+      { # A tool that can be used by the model.
+        "codeExecution": { # A tool that can be used by the model to execute code. # A tool that can be used by the model to execute code.
+        },
+        "computerUse": { # A tool that can be used by the model to interact with the computer. # Tool to support the model interacting directly with the computer.
+          "disabledSafetyPolicies": [ # Optional. Disabled safety policies for computer use.
+            "A String",
+          ],
+          "enablePromptInjectionDetection": True or False, # Whether enable the prompt injection detection check on computer-use request.
+          "environment": "A String", # The environment being operated.
+          "excludedPredefinedFunctions": [ # The list of predefined functions that are excluded from the model call.
+            "A String",
+          ],
+        },
+        "fileSearch": { # A tool that can be used by the model to search files. # A tool that can be used by the model to search files.
+          "fileSearchStoreNames": [ # The file search store names to search.
+            "A String",
+          ],
+          "metadataFilter": "A String", # Metadata filter to apply to the semantic retrieval documents and chunks.
+          "topK": 42, # The number of semantic retrieval chunks to retrieve.
+        },
+        "function": { # A tool that can be used by the model. # A function that can be used by the model.
+          "description": "A String", # A description of the function.
+          "name": "A String", # The name of the function.
+          "parameters": { # `Value` represents a dynamically typed value which can be either null, a number, a string, a boolean, a recursive struct value, or a list of values. A producer of value is expected to set one of these variants. Absence of any variant indicates an error. # The JSON Schema for the function's parameters.
+            "boolValue": True or False, # Represents a boolean value.
+            "contentValue": { # The content of the response. # Represents rich content (text, image, etc.).
+              "audio": { # An audio content block.
+                "channels": 42, # The number of audio channels.
+                "data": "A String", # The audio content.
+                "mimeTypeString": "A String", # Flexible MIME type string of the audio, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                "sampleRate": 42, # The sample rate of the audio.
+                "uri": "A String", # The URI of the audio.
+              },
+              "document": { # A document content block.
+                "data": "A String", # The document content.
+                "mimeTypeString": "A String", # Flexible MIME type string of the document, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                "uri": "A String", # The URI of the document.
+              },
+              "image": { # An image content block.
+                "data": "A String", # The image content.
+                "mimeTypeString": "A String", # Flexible MIME type string of the image, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                "resolution": "A String", # The resolution of the media.
+                "uri": "A String", # The URI of the image.
+              },
+              "text": { # A text content block.
+                "annotations": [ # Citation information for model-generated content.
+                  { # Citation information for model-generated content.
+                    "endIndex": 42, # End of the attributed segment, exclusive.
+                    "fileCitation": { # A file citation annotation. # A file citation annotation.
+                      "customMetadata": { # User provided metadata about the retrieved context.
+                        "a_key": "", # Properties of the object.
+                      },
+                      "documentUri": "A String", # The URI of the file.
+                      "fileName": "A String", # The name of the file.
+                      "mediaId": "A String", # Media ID in-case of image citations, if applicable.
+                      "pageNumber": 42, # Page number of the cited document, if applicable.
+                      "source": "A String", # Source attributed for a portion of the text.
+                    },
+                    "placeCitation": { # A place citation annotation. # A place citation annotation.
+                      "name": "A String", # Title of the place.
+                      "placeId": "A String", # The ID of the place, in `places/{place_id}` format.
+                      "reviewSnippets": [ # Snippets of reviews that are used to generate answers about the features of a given place in Google Maps.
+                        { # Encapsulates a snippet of a user review that answers a question about the features of a specific place in Google Maps.
+                          "reviewId": "A String", # The ID of the review snippet.
+                          "title": "A String", # Title of the review.
+                          "url": "A String", # A link that corresponds to the user review on Google Maps.
+                        },
+                      ],
+                      "url": "A String", # URI reference of the place.
+                    },
+                    "speechMetadata": { # Speech annotation for text content. # Speech annotation for text content.
+                      "speaker": "A String", # The speaker to associate with this turn.
+                      "style": "A String", # Style instruction for the speech synthesis.
+                    },
+                    "startIndex": 42, # Start of segment of the response that is attributed to this source. Index indicates the start of the segment, measured in bytes.
+                    "urlCitation": { # A URL citation annotation. # NOTE: We use these instead of the Citation message for historical reasons. A URL citation annotation.
+                      "title": "A String", # The title of the URL.
+                      "url": "A String", # The URL.
+                    },
+                    "wordInfo": { # Word-level ASR annotation for transcription output. Carries the word text, optional timing, and optional speaker attribution. # Word-level ASR annotation with timing and speaker info.
+                      "endOffset": "A String", # End offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                      "speaker": "A String", # Optional. Speaker label for this word (e.g. "spk_1", "spk_2"). Present when diarization_mode is set in TranscriptionConfig.
+                      "startOffset": "A String", # Start offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                      "text": "A String", # The transcribed word.
+                    },
+                  },
+                ],
+                "text": "A String", # Required. The text content.
+              },
+              "video": { # A video content block.
+                "data": "A String", # The video content.
+                "mimeTypeString": "A String", # Flexible MIME type string of the video, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                "name": "A String", # A user-defined name for this content block. Can be referenced by the model in the final response.
+                "processingConfig": {
+                  "static": {
+                    "endOffset": "A String", # Optional. Segment end time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "30s". Must be non-negative and greater than `start_offset` if `start_offset` is set.
+                    "fps": 3.14, # Optional. Video frame-rate sampling density.
+                    "startOffset": "A String", # Optional. Segment start time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "10.5s". Must be non-negative.
+                  },
+                },
+                "processingType": "A String",
+                "resolution": "A String", # The resolution of the media.
+                "uri": "A String", # The URI of the video.
+              },
+            },
+            "listValue": { # `ListValue` is a wrapper around a repeated field of values. # Represents a repeated `Value`.
+              "values": [ # Repeated field of dynamically typed values.
+                # Object with schema name: GenaiVertexV1Value
+              ],
+            },
+            "nullValue": "A String", # Represents a null value.
+            "numberValue": 3.14, # Represents a double value.
+            "stringValue": "A String", # Represents a string value.
+            "structValue": # Object with schema name: GenaiVertexV1Struct # Represents a structured value.
+          },
+        },
+        "googleMaps": { # A tool that can be used by the model to call Google Maps. # A tool that can be used by the model to search Google Maps.
+          "enableWidget": True or False, # Whether to return a widget context token in the tool call result of the response.
+          "latitude": 3.14, # The latitude of the user's location.
+          "longitude": 3.14, # The longitude of the user's location.
+        },
+        "googleSearch": { # A tool that can be used by the model to search Google. # A tool that can be used by the model to search Google.
+          "searchTypes": [ # The types of search grounding to enable.
+            "A String",
+          ],
+        },
+        "mcpServer": { # A MCPServer is a server that can be called by the model to perform actions. # A MCPServer is a server that can be called by the model to perform actions.
+          "allowedTools": [ # The allowed tools.
+            { # The configuration for allowed tools.
+              "mode": "A String", # The mode of the tool choice.
+              "tools": [ # The names of the allowed tools.
+                "A String",
+              ],
+            },
+          ],
+          "headers": { # Optional: Fields for authentication headers, timeouts, etc., if needed.
+            "a_key": "A String",
+          },
+          "name": "A String", # The name of the MCPServer.
+          "url": "A String", # The full URL for the MCPServer endpoint. Example: "https://api.example.com/mcp"
+        },
+        "retrieval": { # A tool that can be used by the model to retrieve files. # A tool that can be used by the model to retrieve files.
+          "exaAiSearchConfig": { # Used to specify configuration for ExaAISearch. # Used to specify configuration for ExaAISearch.
+            "apiKey": "A String", # Required. The API key for ExaAiSearch.
+            "customConfig": { # Optional. This field can be used to pass any parameter from the Exa.ai Search API.
+              "a_key": "", # Properties of the object.
+            },
+          },
+          "parallelAiSearchConfig": { # Used to specify configuration for ParallelAISearch. # Used to specify configuration for ParallelAISearch.
+            "apiKey": "A String", # Optional. The API key for ParallelAiSearch.
+            "customConfig": { # Optional. Custom configs for ParallelAiSearch.
+              "a_key": "", # Properties of the object.
+            },
+          },
+          "ragStoreConfig": { # Use to specify configuration for RAG Store. # Used to specify configuration for RagStore.
+            "ragResources": [ # Optional. The representation of the rag source.
+              { # The definition of the Rag resource.
+                "ragCorpus": "A String", # Optional. RagCorpora resource name.
+                "ragFileIds": [ # Optional. rag_file_id. The files should be in the same rag_corpus set in rag_corpus field.
+                  "A String",
+                ],
+              },
+            ],
+            "ragRetrievalConfig": { # Specifies the context retrieval config. # Optional. The retrieval config for the Rag query.
+              "filter": { # Config for filters. # Optional. Config for filters.
+                "metadataFilter": "A String", # Optional. String for metadata filtering.
+                "vectorDistanceThreshold": 3.14, # Optional. Only returns contexts with vector distance smaller than the threshold.
+                "vectorSimilarityThreshold": 3.14, # Optional. Only returns contexts with vector similarity larger than the threshold.
+              },
+              "hybridSearch": { # Config for Hybrid Search. # Optional. Config for Hybrid Search.
+                "alpha": 3.14, # Optional. Alpha value controls the weight between dense and sparse vector search results.
+              },
+              "ranking": { # Config for ranking and reranking. # Optional. Config for ranking and reranking.
+                "rankService": { # Config for Rank Service. # Config for Rank Service.
+                  "modelName": "A String", # Optional. The model name of the rank service.
+                },
+              },
+              "topK": 42, # Optional. The number of contexts to retrieve.
+            },
+          },
+          "retrievalTypes": [ # The types of file retrieval to enable.
+            "A String",
+          ],
+          "vertexAiSearchConfig": { # Used to specify configuration for VertexAISearch. # Used to specify configuration for VertexAISearch.
+            "datastores": [ # Optional. Used to specify Vertex AI Search datastores.
+              "A String",
+            ],
+            "engine": "A String", # Optional. Used to specify Vertex AI Search engine.
+          },
+        },
+        "urlContext": { # A tool that can be used by the model to fetch URL context. # A tool that can be used by the model to fetch URL context.
+        },
+      },
+    ],
+    "updated": "A String", # Required. Output only. The time at which the response was last updated in ISO 8601 format (YYYY-MM-DDThh:mm:ssZ).
+    "usage": { # Statistics on the interaction request's token usage. # Output only. Statistics on the interaction request's token usage.
+      "cachedTokensByModality": [ # A breakdown of cached token usage by modality.
+        { # The token count for a single response modality.
+          "modality": "A String", # The modality associated with the token count.
+          "tokens": 42, # Number of tokens for the modality.
+        },
+      ],
+      "groundingToolCount": [ # Grounding tool count.
+        { # The number of grounding tool counts.
+          "count": 42, # The number of grounding tool counts.
+          "type": "A String", # The grounding tool type associated with the count.
+        },
+      ],
+      "inputTokensByModality": [ # A breakdown of input token usage by modality.
+        { # The token count for a single response modality.
+          "modality": "A String", # The modality associated with the token count.
+          "tokens": 42, # Number of tokens for the modality.
+        },
+      ],
+      "outputTokensByModality": [ # A breakdown of output token usage by modality.
+        { # The token count for a single response modality.
+          "modality": "A String", # The modality associated with the token count.
+          "tokens": 42, # Number of tokens for the modality.
+        },
+      ],
+      "toolUseTokensByModality": [ # A breakdown of tool-use token usage by modality.
+        { # The token count for a single response modality.
+          "modality": "A String", # The modality associated with the token count.
+          "tokens": 42, # Number of tokens for the modality.
+        },
+      ],
+      "totalCachedTokens": 42, # Number of tokens in the cached part of the prompt (the cached content).
+      "totalInputTokens": 42, # Number of tokens in the prompt (context).
+      "totalOutputTokens": 42, # Total number of tokens across all the generated responses.
+      "totalThoughtTokens": 42, # Number of tokens of thoughts for thinking models.
+      "totalTokens": 42, # Total token count for the interaction request (prompt + responses + other internal tokens).
+      "totalToolUseTokens": 42, # Number of tokens present in tool-use prompt(s).
+    },
+  },
+  "store": True or False, # Input only. Whether to store the response and request for later retrieval.
+  "stream": True or False, # Input only. Whether the interaction will be streamed.
+}
+
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    {
+  "errorEvent": { # The error event data, used for error events.
+    "error": { # Error message from an interaction.
+      "code": "A String", # A URI that identifies the error type.
+      "message": "A String", # A human-readable error message.
+    },
+  },
+  "eventId": "A String", # The event_id token to be used to resume the interaction stream, from this event.
+  "interactionCompletedEvent": { # Signals that the Interaction completed. Sent when the Interaction receives Complete/Cancel or naturally terminates. No more input can be sent to the Interaction after this. # The interaction data, used for interaction.completed events. Used when steps are enabled.
+    "interaction": { # Response for InteractionService.CreateInteraction. # Required. Partial completed interaction resource emitted at the end of the stream.
+      "agentInteraction": { # Interaction for generating the completion using agents. # Interaction for generating the completion using agents.
+        "agent": "A String", # The name of the `Agent` used for generating the completion.
+        "antigravityConfig": { # Configuration for the Antigravity agent runtime. Provides server-side control over the agent's execution environment and tool configuration. # Antigravity agent configuration. This configuration is session-level settings that are passed to the agent runtime on a per-request basis.
+          "maxTotalTokens": "A String", # Max total tokens for the agent run.
+          "model": "A String", # The model to use for agent reasoning.
+        },
+        "codeMenderConfig": { # Configuration for the CodeMender agent.
+          "findRequest": { # Request parameters specific to FIND sessions, used for discovering vulnerabilities in a codebase. # Parameters for finding vulnerabilities.
+            "description": "A String", # Additional context or custom instructions provided by the user to guide the vulnerability analysis.
+            "findingId": "A String", # The identifier of a specific finding to verify. This is primarily used in VERIFY mode to focus the agent's execution-based validation on a single vulnerability.
+            "mode": "A String", # The mode of the find session.
+            "sourceFiles": [ # A list of source files to provide as context for the scan.
+              { # Content of a single file in the codebase.
+                "content": "A String", # The UTF-8 encoded text content of the file.
+                "path": "A String", # The relative path of the file from the project root.
+              },
+            ],
+          },
+          "fixRequest": { # Request parameters specific to FIX sessions, used for generating and validating security patches. # Parameters for fixing vulnerabilities.
+            "description": "A String", # Additional context or custom instructions provided by the user to guide the patch generation process.
+            "findingId": "A String", # The identifier of the specific security finding to be remediated. This ID maps to a previously discovered vulnerability.
+            "sourceFiles": [ # A list of source files providing context for the remediation. These files are typically the ones containing the identified vulnerability.
+              { # Content of a single file in the codebase.
+                "content": "A String", # The UTF-8 encoded text content of the file.
+                "path": "A String", # The relative path of the file from the project root.
+              },
+            ],
+          },
+          "model": "A String", # The name of the model to use for the CodeMender agent. One CodeMender session will only use one model.
+          "sessionConfig": { # The configuration of CodeMender sessions. # Optional session-specific configurations to override default agent behavior.
+            "maxRounds": 42, # The maximum number of interaction rounds the agent is allowed to perform before reaching a timeout.
+          },
+          "sessionId": "A String", # Parameter for grouping multiple interactions that belong to the same CodeMender session.
+        },
+        "deepResearchConfig": { # Configuration for the Deep Research agent.
+          "collaborativePlanning": True or False, # Enables human-in-the-loop planning for the Deep Research agent. If set to true, the Deep Research agent will provide a research plan in its response. The agent will then proceed only if the user confirms the plan in the next turn.
+          "enableBigqueryTool": True or False, # Enables bigquery tool for the Deep Research agent.
+          "thinkingSummaries": "A String", # Whether to include thought summaries in the response.
+          "visualization": "A String", # Whether to include visualizations in the response.
+        },
+        "dynamicConfig": { # Configuration for dynamic agents.
+          "config": { # `Struct` represents a structured data value, consisting of fields which map to dynamically typed values. # For agents that are not supported statically in the API definition.
+            "fields": [ # Dynamically typed fields. List instead of map because LLMs are sensitive to ordering, and we want to give users full control.
+              { # Represents a single field in a struct.
+                "name": "A String",
+                "value": { # `Value` represents a dynamically typed value which can be either null, a number, a string, a boolean, a recursive struct value, or a list of values. A producer of value is expected to set one of these variants. Absence of any variant indicates an error.
+                  "boolValue": True or False, # Represents a boolean value.
+                  "contentValue": { # The content of the response. # Represents rich content (text, image, etc.).
+                    "audio": { # An audio content block.
+                      "channels": 42, # The number of audio channels.
+                      "data": "A String", # The audio content.
+                      "mimeTypeString": "A String", # Flexible MIME type string of the audio, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                      "sampleRate": 42, # The sample rate of the audio.
+                      "uri": "A String", # The URI of the audio.
+                    },
+                    "document": { # A document content block.
+                      "data": "A String", # The document content.
+                      "mimeTypeString": "A String", # Flexible MIME type string of the document, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                      "uri": "A String", # The URI of the document.
+                    },
+                    "image": { # An image content block.
+                      "data": "A String", # The image content.
+                      "mimeTypeString": "A String", # Flexible MIME type string of the image, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                      "resolution": "A String", # The resolution of the media.
+                      "uri": "A String", # The URI of the image.
+                    },
+                    "text": { # A text content block.
+                      "annotations": [ # Citation information for model-generated content.
+                        { # Citation information for model-generated content.
+                          "endIndex": 42, # End of the attributed segment, exclusive.
+                          "fileCitation": { # A file citation annotation. # A file citation annotation.
+                            "customMetadata": { # User provided metadata about the retrieved context.
+                              "a_key": "", # Properties of the object.
+                            },
+                            "documentUri": "A String", # The URI of the file.
+                            "fileName": "A String", # The name of the file.
+                            "mediaId": "A String", # Media ID in-case of image citations, if applicable.
+                            "pageNumber": 42, # Page number of the cited document, if applicable.
+                            "source": "A String", # Source attributed for a portion of the text.
+                          },
+                          "placeCitation": { # A place citation annotation. # A place citation annotation.
+                            "name": "A String", # Title of the place.
+                            "placeId": "A String", # The ID of the place, in `places/{place_id}` format.
+                            "reviewSnippets": [ # Snippets of reviews that are used to generate answers about the features of a given place in Google Maps.
+                              { # Encapsulates a snippet of a user review that answers a question about the features of a specific place in Google Maps.
+                                "reviewId": "A String", # The ID of the review snippet.
+                                "title": "A String", # Title of the review.
+                                "url": "A String", # A link that corresponds to the user review on Google Maps.
+                              },
+                            ],
+                            "url": "A String", # URI reference of the place.
+                          },
+                          "speechMetadata": { # Speech annotation for text content. # Speech annotation for text content.
+                            "speaker": "A String", # The speaker to associate with this turn.
+                            "style": "A String", # Style instruction for the speech synthesis.
+                          },
+                          "startIndex": 42, # Start of segment of the response that is attributed to this source. Index indicates the start of the segment, measured in bytes.
+                          "urlCitation": { # A URL citation annotation. # NOTE: We use these instead of the Citation message for historical reasons. A URL citation annotation.
+                            "title": "A String", # The title of the URL.
+                            "url": "A String", # The URL.
+                          },
+                          "wordInfo": { # Word-level ASR annotation for transcription output. Carries the word text, optional timing, and optional speaker attribution. # Word-level ASR annotation with timing and speaker info.
+                            "endOffset": "A String", # End offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                            "speaker": "A String", # Optional. Speaker label for this word (e.g. "spk_1", "spk_2"). Present when diarization_mode is set in TranscriptionConfig.
+                            "startOffset": "A String", # Start offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                            "text": "A String", # The transcribed word.
+                          },
+                        },
+                      ],
+                      "text": "A String", # Required. The text content.
+                    },
+                    "video": { # A video content block.
+                      "data": "A String", # The video content.
+                      "mimeTypeString": "A String", # Flexible MIME type string of the video, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                      "name": "A String", # A user-defined name for this content block. Can be referenced by the model in the final response.
+                      "processingConfig": {
+                        "static": {
+                          "endOffset": "A String", # Optional. Segment end time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "30s". Must be non-negative and greater than `start_offset` if `start_offset` is set.
+                          "fps": 3.14, # Optional. Video frame-rate sampling density.
+                          "startOffset": "A String", # Optional. Segment start time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "10.5s". Must be non-negative.
+                        },
+                      },
+                      "processingType": "A String",
+                      "resolution": "A String", # The resolution of the media.
+                      "uri": "A String", # The URI of the video.
+                    },
+                  },
+                  "listValue": { # `ListValue` is a wrapper around a repeated field of values. # Represents a repeated `Value`.
+                    "values": [ # Repeated field of dynamically typed values.
+                      # Object with schema name: GenaiVertexV1Value
+                    ],
+                  },
+                  "nullValue": "A String", # Represents a null value.
+                  "numberValue": 3.14, # Represents a double value.
+                  "stringValue": "A String", # Represents a string value.
+                  "structValue": # Object with schema name: GenaiVertexV1Struct # Represents a structured value.
+                },
+              },
+            ],
+          },
+        },
+      },
+      "content": { # The content of the response. # The content for the interaction.
+        "audio": { # An audio content block.
+          "channels": 42, # The number of audio channels.
+          "data": "A String", # The audio content.
+          "mimeTypeString": "A String", # Flexible MIME type string of the audio, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+          "sampleRate": 42, # The sample rate of the audio.
+          "uri": "A String", # The URI of the audio.
+        },
+        "document": { # A document content block.
+          "data": "A String", # The document content.
+          "mimeTypeString": "A String", # Flexible MIME type string of the document, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+          "uri": "A String", # The URI of the document.
+        },
+        "image": { # An image content block.
+          "data": "A String", # The image content.
+          "mimeTypeString": "A String", # Flexible MIME type string of the image, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+          "resolution": "A String", # The resolution of the media.
+          "uri": "A String", # The URI of the image.
+        },
+        "text": { # A text content block.
+          "annotations": [ # Citation information for model-generated content.
+            { # Citation information for model-generated content.
+              "endIndex": 42, # End of the attributed segment, exclusive.
+              "fileCitation": { # A file citation annotation. # A file citation annotation.
+                "customMetadata": { # User provided metadata about the retrieved context.
+                  "a_key": "", # Properties of the object.
+                },
+                "documentUri": "A String", # The URI of the file.
+                "fileName": "A String", # The name of the file.
+                "mediaId": "A String", # Media ID in-case of image citations, if applicable.
+                "pageNumber": 42, # Page number of the cited document, if applicable.
+                "source": "A String", # Source attributed for a portion of the text.
+              },
+              "placeCitation": { # A place citation annotation. # A place citation annotation.
+                "name": "A String", # Title of the place.
+                "placeId": "A String", # The ID of the place, in `places/{place_id}` format.
+                "reviewSnippets": [ # Snippets of reviews that are used to generate answers about the features of a given place in Google Maps.
+                  { # Encapsulates a snippet of a user review that answers a question about the features of a specific place in Google Maps.
+                    "reviewId": "A String", # The ID of the review snippet.
+                    "title": "A String", # Title of the review.
+                    "url": "A String", # A link that corresponds to the user review on Google Maps.
+                  },
+                ],
+                "url": "A String", # URI reference of the place.
+              },
+              "speechMetadata": { # Speech annotation for text content. # Speech annotation for text content.
+                "speaker": "A String", # The speaker to associate with this turn.
+                "style": "A String", # Style instruction for the speech synthesis.
+              },
+              "startIndex": 42, # Start of segment of the response that is attributed to this source. Index indicates the start of the segment, measured in bytes.
+              "urlCitation": { # A URL citation annotation. # NOTE: We use these instead of the Citation message for historical reasons. A URL citation annotation.
+                "title": "A String", # The title of the URL.
+                "url": "A String", # The URL.
+              },
+              "wordInfo": { # Word-level ASR annotation for transcription output. Carries the word text, optional timing, and optional speaker attribution. # Word-level ASR annotation with timing and speaker info.
+                "endOffset": "A String", # End offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                "speaker": "A String", # Optional. Speaker label for this word (e.g. "spk_1", "spk_2"). Present when diarization_mode is set in TranscriptionConfig.
+                "startOffset": "A String", # Start offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                "text": "A String", # The transcribed word.
+              },
+            },
+          ],
+          "text": "A String", # Required. The text content.
+        },
+        "video": { # A video content block.
+          "data": "A String", # The video content.
+          "mimeTypeString": "A String", # Flexible MIME type string of the video, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+          "name": "A String", # A user-defined name for this content block. Can be referenced by the model in the final response.
+          "processingConfig": {
+            "static": {
+              "endOffset": "A String", # Optional. Segment end time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "30s". Must be non-negative and greater than `start_offset` if `start_offset` is set.
+              "fps": 3.14, # Optional. Video frame-rate sampling density.
+              "startOffset": "A String", # Optional. Segment start time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "10.5s". Must be non-negative.
+            },
+          },
+          "processingType": "A String",
+          "resolution": "A String", # The resolution of the media.
+          "uri": "A String", # The URI of the video.
+        },
+      },
+      "created": "A String", # Required. Output only. The time at which the response was created in ISO 8601 format (YYYY-MM-DDThh:mm:ssZ).
+      "envId": "A String", # The environment ID for the interaction. Can be 'remote' for default environment.
+      "environmentId": "A String", # Output only. The environment ID for the interaction. Only populated if environment config is set in the request.
+      "errors": [ # Output only. Diagnostic faults / platform errors recorded on the interaction.
+        { # Error message from an interaction.
+          "code": "A String", # A URI that identifies the error type.
+          "message": "A String", # A human-readable error message.
+        },
+      ],
+      "id": "A String", # Required. Output only. A unique identifier for the interaction completion.
+      "labels": { # The labels with user-defined metadata for the request. 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",
+      },
+      "modelInteraction": { # Interaction for generating the completion using models. # Interaction for generating the completion using models.
+        "generationConfig": { # Configuration parameters for model interactions. # Input only. Configuration parameters for the model interaction.
+          "maxOutputTokens": 42, # The maximum number of tokens to include in the response.
+          "seed": 42, # Seed used in decoding for reproducibility.
+          "stopSequences": [ # A list of character sequences that will stop output interaction.
+            "A String",
+          ],
+          "structuredSpeechConfig": { # Configuration for multi-speaker and speech generation. # Speech and multi-speaker configuration.
+            "speakers": [ # Individual speaker configurations.
+              { # The configuration for speech interaction.
+                "language": "A String", # The language of the speech.
+                "speaker": "A String", # The speaker's name, it should match the speaker name given in the prompt.
+                "voice": "A String", # The voice of the speaker.
+              },
+            ],
+          },
+          "temperature": 3.14, # Controls the randomness of the output.
+          "thinkingLevel": "A String", # The level of thought tokens that the model should generate.
+          "thinkingSummaries": "A String", # Whether to include thought summaries in the response.
+          "toolChoiceConfig": { # The tool choice configuration containing allowed tools. # The config for the tool choice.
+            "allowedTools": { # The configuration for allowed tools. # The allowed tools.
+              "mode": "A String", # The mode of the tool choice.
+              "tools": [ # The names of the allowed tools.
+                "A String",
+              ],
+            },
+          },
+          "toolChoiceMode": "A String", # The mode of the tool choice.
+          "topP": 3.14, # The maximum cumulative probability of tokens to consider when sampling.
+          "transcriptionConfig": { # Configuration for speech recognition (transcription). # Optional. Configuration for speech recognition (transcription). If present, ASR is enabled.
+            "adaptationPhrases": [ # Optional. A list of phrases to bias the ASR model towards.
+              "A String",
+            ],
+            "customVocabulary": [ # Optional. A list of custom vocabulary phrases to bias the speech recognition model toward recognizing specific terms.
+              "A String",
+            ],
+            "diarizationMode": "A String", # Optional. Configures speaker diarization. Supported values: "speaker".
+            "languageCodes": [ # Optional. BCP-47 language codes providing hints about the languages present in the audio. If omitted or empty, defaults to automatic language detection.
+              "A String",
+            ],
+            "timestampGranularities": [ # Optional. The granularity of timestamps to include in the transcription output. Supported values: "word". If empty, no timestamps are generated.
+              "A String",
+            ],
+          },
+          "videoConfig": { # Configuration options for video generation. # Configuration for video generation.
+            "task": "A String", # Optional task mode for video generation. If not specified, the model automatically determines the appropriate mode based on the provided text prompt and input media.
+          },
+        },
+        "model": "A String", # The name of the `Model` used for generating the completion.
+      },
+      "previousInteractionId": "A String", # The ID of the previous interaction, if any.
+      "responseFormatList": {
+        "responseFormats": [
+          {
+            "audio": { # Configuration for audio output format.
+              "bitRate": 42, # Bit rate in bits per second (bps). Only applicable for compressed formats (MP3, Opus).
+              "delivery": "A String", # The delivery mode for the audio output.
+              "mimeType": "A String", # The MIME type of the audio output.
+              "sampleRate": 42, # Sample rate in Hz.
+            },
+            "image": { # Configuration for image output format.
+              "aspectRatio": "A String", # The aspect ratio for the image output.
+              "delivery": "A String", # The delivery mode for the image output.
+              "imageSize": "A String", # The size of the image output.
+              "mimeType": "A String", # The MIME type of the image output.
+            },
+            "structValue": { # `Struct` represents a structured data value, consisting of fields which map to dynamically typed values. # Multi-discriminator values is already enabled in GAOS
+              "fields": [ # Dynamically typed fields. List instead of map because LLMs are sensitive to ordering, and we want to give users full control.
+                { # Represents a single field in a struct.
+                  "name": "A String",
+                  "value": { # `Value` represents a dynamically typed value which can be either null, a number, a string, a boolean, a recursive struct value, or a list of values. A producer of value is expected to set one of these variants. Absence of any variant indicates an error.
+                    "boolValue": True or False, # Represents a boolean value.
+                    "contentValue": { # The content of the response. # Represents rich content (text, image, etc.).
+                      "audio": { # An audio content block.
+                        "channels": 42, # The number of audio channels.
+                        "data": "A String", # The audio content.
+                        "mimeTypeString": "A String", # Flexible MIME type string of the audio, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                        "sampleRate": 42, # The sample rate of the audio.
+                        "uri": "A String", # The URI of the audio.
+                      },
+                      "document": { # A document content block.
+                        "data": "A String", # The document content.
+                        "mimeTypeString": "A String", # Flexible MIME type string of the document, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                        "uri": "A String", # The URI of the document.
+                      },
+                      "image": { # An image content block.
+                        "data": "A String", # The image content.
+                        "mimeTypeString": "A String", # Flexible MIME type string of the image, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                        "resolution": "A String", # The resolution of the media.
+                        "uri": "A String", # The URI of the image.
+                      },
+                      "text": { # A text content block.
+                        "annotations": [ # Citation information for model-generated content.
+                          { # Citation information for model-generated content.
+                            "endIndex": 42, # End of the attributed segment, exclusive.
+                            "fileCitation": { # A file citation annotation. # A file citation annotation.
+                              "customMetadata": { # User provided metadata about the retrieved context.
+                                "a_key": "", # Properties of the object.
+                              },
+                              "documentUri": "A String", # The URI of the file.
+                              "fileName": "A String", # The name of the file.
+                              "mediaId": "A String", # Media ID in-case of image citations, if applicable.
+                              "pageNumber": 42, # Page number of the cited document, if applicable.
+                              "source": "A String", # Source attributed for a portion of the text.
+                            },
+                            "placeCitation": { # A place citation annotation. # A place citation annotation.
+                              "name": "A String", # Title of the place.
+                              "placeId": "A String", # The ID of the place, in `places/{place_id}` format.
+                              "reviewSnippets": [ # Snippets of reviews that are used to generate answers about the features of a given place in Google Maps.
+                                { # Encapsulates a snippet of a user review that answers a question about the features of a specific place in Google Maps.
+                                  "reviewId": "A String", # The ID of the review snippet.
+                                  "title": "A String", # Title of the review.
+                                  "url": "A String", # A link that corresponds to the user review on Google Maps.
+                                },
+                              ],
+                              "url": "A String", # URI reference of the place.
+                            },
+                            "speechMetadata": { # Speech annotation for text content. # Speech annotation for text content.
+                              "speaker": "A String", # The speaker to associate with this turn.
+                              "style": "A String", # Style instruction for the speech synthesis.
+                            },
+                            "startIndex": 42, # Start of segment of the response that is attributed to this source. Index indicates the start of the segment, measured in bytes.
+                            "urlCitation": { # A URL citation annotation. # NOTE: We use these instead of the Citation message for historical reasons. A URL citation annotation.
+                              "title": "A String", # The title of the URL.
+                              "url": "A String", # The URL.
+                            },
+                            "wordInfo": { # Word-level ASR annotation for transcription output. Carries the word text, optional timing, and optional speaker attribution. # Word-level ASR annotation with timing and speaker info.
+                              "endOffset": "A String", # End offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                              "speaker": "A String", # Optional. Speaker label for this word (e.g. "spk_1", "spk_2"). Present when diarization_mode is set in TranscriptionConfig.
+                              "startOffset": "A String", # Start offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                              "text": "A String", # The transcribed word.
+                            },
+                          },
+                        ],
+                        "text": "A String", # Required. The text content.
+                      },
+                      "video": { # A video content block.
+                        "data": "A String", # The video content.
+                        "mimeTypeString": "A String", # Flexible MIME type string of the video, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                        "name": "A String", # A user-defined name for this content block. Can be referenced by the model in the final response.
+                        "processingConfig": {
+                          "static": {
+                            "endOffset": "A String", # Optional. Segment end time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "30s". Must be non-negative and greater than `start_offset` if `start_offset` is set.
+                            "fps": 3.14, # Optional. Video frame-rate sampling density.
+                            "startOffset": "A String", # Optional. Segment start time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "10.5s". Must be non-negative.
+                          },
+                        },
+                        "processingType": "A String",
+                        "resolution": "A String", # The resolution of the media.
+                        "uri": "A String", # The URI of the video.
+                      },
+                    },
+                    "listValue": { # `ListValue` is a wrapper around a repeated field of values. # Represents a repeated `Value`.
+                      "values": [ # Repeated field of dynamically typed values.
+                        # Object with schema name: GenaiVertexV1Value
+                      ],
+                    },
+                    "nullValue": "A String", # Represents a null value.
+                    "numberValue": 3.14, # Represents a double value.
+                    "stringValue": "A String", # Represents a string value.
+                    "structValue": # Object with schema name: GenaiVertexV1Struct # Represents a structured value.
+                  },
+                },
+              ],
+            },
+            "text": { # Configuration for text output format.
+              "mimeType": "A String", # The MIME type of the text output.
+              "schema": { # `Struct` represents a structured data value, consisting of fields which map to dynamically typed values. # The JSON schema that the output should conform to. Only applicable when mime_type is application/json.
+                "fields": [ # Dynamically typed fields. List instead of map because LLMs are sensitive to ordering, and we want to give users full control.
+                  { # Represents a single field in a struct.
+                    "name": "A String",
+                    "value": { # `Value` represents a dynamically typed value which can be either null, a number, a string, a boolean, a recursive struct value, or a list of values. A producer of value is expected to set one of these variants. Absence of any variant indicates an error.
+                      "boolValue": True or False, # Represents a boolean value.
+                      "contentValue": { # The content of the response. # Represents rich content (text, image, etc.).
+                        "audio": { # An audio content block.
+                          "channels": 42, # The number of audio channels.
+                          "data": "A String", # The audio content.
+                          "mimeTypeString": "A String", # Flexible MIME type string of the audio, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                          "sampleRate": 42, # The sample rate of the audio.
+                          "uri": "A String", # The URI of the audio.
+                        },
+                        "document": { # A document content block.
+                          "data": "A String", # The document content.
+                          "mimeTypeString": "A String", # Flexible MIME type string of the document, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                          "uri": "A String", # The URI of the document.
+                        },
+                        "image": { # An image content block.
+                          "data": "A String", # The image content.
+                          "mimeTypeString": "A String", # Flexible MIME type string of the image, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                          "resolution": "A String", # The resolution of the media.
+                          "uri": "A String", # The URI of the image.
+                        },
+                        "text": { # A text content block.
+                          "annotations": [ # Citation information for model-generated content.
+                            { # Citation information for model-generated content.
+                              "endIndex": 42, # End of the attributed segment, exclusive.
+                              "fileCitation": { # A file citation annotation. # A file citation annotation.
+                                "customMetadata": { # User provided metadata about the retrieved context.
+                                  "a_key": "", # Properties of the object.
+                                },
+                                "documentUri": "A String", # The URI of the file.
+                                "fileName": "A String", # The name of the file.
+                                "mediaId": "A String", # Media ID in-case of image citations, if applicable.
+                                "pageNumber": 42, # Page number of the cited document, if applicable.
+                                "source": "A String", # Source attributed for a portion of the text.
+                              },
+                              "placeCitation": { # A place citation annotation. # A place citation annotation.
+                                "name": "A String", # Title of the place.
+                                "placeId": "A String", # The ID of the place, in `places/{place_id}` format.
+                                "reviewSnippets": [ # Snippets of reviews that are used to generate answers about the features of a given place in Google Maps.
+                                  { # Encapsulates a snippet of a user review that answers a question about the features of a specific place in Google Maps.
+                                    "reviewId": "A String", # The ID of the review snippet.
+                                    "title": "A String", # Title of the review.
+                                    "url": "A String", # A link that corresponds to the user review on Google Maps.
+                                  },
+                                ],
+                                "url": "A String", # URI reference of the place.
+                              },
+                              "speechMetadata": { # Speech annotation for text content. # Speech annotation for text content.
+                                "speaker": "A String", # The speaker to associate with this turn.
+                                "style": "A String", # Style instruction for the speech synthesis.
+                              },
+                              "startIndex": 42, # Start of segment of the response that is attributed to this source. Index indicates the start of the segment, measured in bytes.
+                              "urlCitation": { # A URL citation annotation. # NOTE: We use these instead of the Citation message for historical reasons. A URL citation annotation.
+                                "title": "A String", # The title of the URL.
+                                "url": "A String", # The URL.
+                              },
+                              "wordInfo": { # Word-level ASR annotation for transcription output. Carries the word text, optional timing, and optional speaker attribution. # Word-level ASR annotation with timing and speaker info.
+                                "endOffset": "A String", # End offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                                "speaker": "A String", # Optional. Speaker label for this word (e.g. "spk_1", "spk_2"). Present when diarization_mode is set in TranscriptionConfig.
+                                "startOffset": "A String", # Start offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                                "text": "A String", # The transcribed word.
+                              },
+                            },
+                          ],
+                          "text": "A String", # Required. The text content.
+                        },
+                        "video": { # A video content block.
+                          "data": "A String", # The video content.
+                          "mimeTypeString": "A String", # Flexible MIME type string of the video, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                          "name": "A String", # A user-defined name for this content block. Can be referenced by the model in the final response.
+                          "processingConfig": {
+                            "static": {
+                              "endOffset": "A String", # Optional. Segment end time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "30s". Must be non-negative and greater than `start_offset` if `start_offset` is set.
+                              "fps": 3.14, # Optional. Video frame-rate sampling density.
+                              "startOffset": "A String", # Optional. Segment start time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "10.5s". Must be non-negative.
+                            },
+                          },
+                          "processingType": "A String",
+                          "resolution": "A String", # The resolution of the media.
+                          "uri": "A String", # The URI of the video.
+                        },
+                      },
+                      "listValue": { # `ListValue` is a wrapper around a repeated field of values. # Represents a repeated `Value`.
+                        "values": [ # Repeated field of dynamically typed values.
+                          # Object with schema name: GenaiVertexV1Value
+                        ],
+                      },
+                      "nullValue": "A String", # Represents a null value.
+                      "numberValue": 3.14, # Represents a double value.
+                      "stringValue": "A String", # Represents a string value.
+                      "structValue": # Object with schema name: GenaiVertexV1Struct # Represents a structured value.
+                    },
+                  },
+                ],
+              },
+            },
+            "video": { # Configuration for video output format.
+              "aspectRatio": "A String", # The aspect ratio for the video output.
+              "delivery": "A String", # The delivery mode for the video output.
+              "duration": "A String", # The duration for the video output.
+              "gcsUri": "A String", # The Cloud Storage URI to store the video output. Required for Vertex if delivery mode is URI.
+              "resolution": "A String", # The video output resolution. Defaults to 720p.
+            },
+          },
+        ],
+      },
+      "responseFormatSingleton": {
+        "audio": { # Configuration for audio output format.
+          "bitRate": 42, # Bit rate in bits per second (bps). Only applicable for compressed formats (MP3, Opus).
+          "delivery": "A String", # The delivery mode for the audio output.
+          "mimeType": "A String", # The MIME type of the audio output.
+          "sampleRate": 42, # Sample rate in Hz.
+        },
+        "image": { # Configuration for image output format.
+          "aspectRatio": "A String", # The aspect ratio for the image output.
+          "delivery": "A String", # The delivery mode for the image output.
+          "imageSize": "A String", # The size of the image output.
+          "mimeType": "A String", # The MIME type of the image output.
+        },
+        "structValue": { # `Struct` represents a structured data value, consisting of fields which map to dynamically typed values. # Multi-discriminator values is already enabled in GAOS
+          "fields": [ # Dynamically typed fields. List instead of map because LLMs are sensitive to ordering, and we want to give users full control.
+            { # Represents a single field in a struct.
+              "name": "A String",
+              "value": { # `Value` represents a dynamically typed value which can be either null, a number, a string, a boolean, a recursive struct value, or a list of values. A producer of value is expected to set one of these variants. Absence of any variant indicates an error.
+                "boolValue": True or False, # Represents a boolean value.
+                "contentValue": { # The content of the response. # Represents rich content (text, image, etc.).
+                  "audio": { # An audio content block.
+                    "channels": 42, # The number of audio channels.
+                    "data": "A String", # The audio content.
+                    "mimeTypeString": "A String", # Flexible MIME type string of the audio, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                    "sampleRate": 42, # The sample rate of the audio.
+                    "uri": "A String", # The URI of the audio.
+                  },
+                  "document": { # A document content block.
+                    "data": "A String", # The document content.
+                    "mimeTypeString": "A String", # Flexible MIME type string of the document, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                    "uri": "A String", # The URI of the document.
+                  },
+                  "image": { # An image content block.
+                    "data": "A String", # The image content.
+                    "mimeTypeString": "A String", # Flexible MIME type string of the image, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                    "resolution": "A String", # The resolution of the media.
+                    "uri": "A String", # The URI of the image.
+                  },
+                  "text": { # A text content block.
+                    "annotations": [ # Citation information for model-generated content.
+                      { # Citation information for model-generated content.
+                        "endIndex": 42, # End of the attributed segment, exclusive.
+                        "fileCitation": { # A file citation annotation. # A file citation annotation.
+                          "customMetadata": { # User provided metadata about the retrieved context.
+                            "a_key": "", # Properties of the object.
+                          },
+                          "documentUri": "A String", # The URI of the file.
+                          "fileName": "A String", # The name of the file.
+                          "mediaId": "A String", # Media ID in-case of image citations, if applicable.
+                          "pageNumber": 42, # Page number of the cited document, if applicable.
+                          "source": "A String", # Source attributed for a portion of the text.
+                        },
+                        "placeCitation": { # A place citation annotation. # A place citation annotation.
+                          "name": "A String", # Title of the place.
+                          "placeId": "A String", # The ID of the place, in `places/{place_id}` format.
+                          "reviewSnippets": [ # Snippets of reviews that are used to generate answers about the features of a given place in Google Maps.
+                            { # Encapsulates a snippet of a user review that answers a question about the features of a specific place in Google Maps.
+                              "reviewId": "A String", # The ID of the review snippet.
+                              "title": "A String", # Title of the review.
+                              "url": "A String", # A link that corresponds to the user review on Google Maps.
+                            },
+                          ],
+                          "url": "A String", # URI reference of the place.
+                        },
+                        "speechMetadata": { # Speech annotation for text content. # Speech annotation for text content.
+                          "speaker": "A String", # The speaker to associate with this turn.
+                          "style": "A String", # Style instruction for the speech synthesis.
+                        },
+                        "startIndex": 42, # Start of segment of the response that is attributed to this source. Index indicates the start of the segment, measured in bytes.
+                        "urlCitation": { # A URL citation annotation. # NOTE: We use these instead of the Citation message for historical reasons. A URL citation annotation.
+                          "title": "A String", # The title of the URL.
+                          "url": "A String", # The URL.
+                        },
+                        "wordInfo": { # Word-level ASR annotation for transcription output. Carries the word text, optional timing, and optional speaker attribution. # Word-level ASR annotation with timing and speaker info.
+                          "endOffset": "A String", # End offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                          "speaker": "A String", # Optional. Speaker label for this word (e.g. "spk_1", "spk_2"). Present when diarization_mode is set in TranscriptionConfig.
+                          "startOffset": "A String", # Start offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                          "text": "A String", # The transcribed word.
+                        },
+                      },
+                    ],
+                    "text": "A String", # Required. The text content.
+                  },
+                  "video": { # A video content block.
+                    "data": "A String", # The video content.
+                    "mimeTypeString": "A String", # Flexible MIME type string of the video, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                    "name": "A String", # A user-defined name for this content block. Can be referenced by the model in the final response.
+                    "processingConfig": {
+                      "static": {
+                        "endOffset": "A String", # Optional. Segment end time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "30s". Must be non-negative and greater than `start_offset` if `start_offset` is set.
+                        "fps": 3.14, # Optional. Video frame-rate sampling density.
+                        "startOffset": "A String", # Optional. Segment start time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "10.5s". Must be non-negative.
+                      },
+                    },
+                    "processingType": "A String",
+                    "resolution": "A String", # The resolution of the media.
+                    "uri": "A String", # The URI of the video.
+                  },
+                },
+                "listValue": { # `ListValue` is a wrapper around a repeated field of values. # Represents a repeated `Value`.
+                  "values": [ # Repeated field of dynamically typed values.
+                    # Object with schema name: GenaiVertexV1Value
+                  ],
+                },
+                "nullValue": "A String", # Represents a null value.
+                "numberValue": 3.14, # Represents a double value.
+                "stringValue": "A String", # Represents a string value.
+                "structValue": # Object with schema name: GenaiVertexV1Struct # Represents a structured value.
+              },
+            },
+          ],
+        },
+        "text": { # Configuration for text output format.
+          "mimeType": "A String", # The MIME type of the text output.
+          "schema": { # `Struct` represents a structured data value, consisting of fields which map to dynamically typed values. # The JSON schema that the output should conform to. Only applicable when mime_type is application/json.
+            "fields": [ # Dynamically typed fields. List instead of map because LLMs are sensitive to ordering, and we want to give users full control.
+              { # Represents a single field in a struct.
+                "name": "A String",
+                "value": { # `Value` represents a dynamically typed value which can be either null, a number, a string, a boolean, a recursive struct value, or a list of values. A producer of value is expected to set one of these variants. Absence of any variant indicates an error.
+                  "boolValue": True or False, # Represents a boolean value.
+                  "contentValue": { # The content of the response. # Represents rich content (text, image, etc.).
+                    "audio": { # An audio content block.
+                      "channels": 42, # The number of audio channels.
+                      "data": "A String", # The audio content.
+                      "mimeTypeString": "A String", # Flexible MIME type string of the audio, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                      "sampleRate": 42, # The sample rate of the audio.
+                      "uri": "A String", # The URI of the audio.
+                    },
+                    "document": { # A document content block.
+                      "data": "A String", # The document content.
+                      "mimeTypeString": "A String", # Flexible MIME type string of the document, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                      "uri": "A String", # The URI of the document.
+                    },
+                    "image": { # An image content block.
+                      "data": "A String", # The image content.
+                      "mimeTypeString": "A String", # Flexible MIME type string of the image, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                      "resolution": "A String", # The resolution of the media.
+                      "uri": "A String", # The URI of the image.
+                    },
+                    "text": { # A text content block.
+                      "annotations": [ # Citation information for model-generated content.
+                        { # Citation information for model-generated content.
+                          "endIndex": 42, # End of the attributed segment, exclusive.
+                          "fileCitation": { # A file citation annotation. # A file citation annotation.
+                            "customMetadata": { # User provided metadata about the retrieved context.
+                              "a_key": "", # Properties of the object.
+                            },
+                            "documentUri": "A String", # The URI of the file.
+                            "fileName": "A String", # The name of the file.
+                            "mediaId": "A String", # Media ID in-case of image citations, if applicable.
+                            "pageNumber": 42, # Page number of the cited document, if applicable.
+                            "source": "A String", # Source attributed for a portion of the text.
+                          },
+                          "placeCitation": { # A place citation annotation. # A place citation annotation.
+                            "name": "A String", # Title of the place.
+                            "placeId": "A String", # The ID of the place, in `places/{place_id}` format.
+                            "reviewSnippets": [ # Snippets of reviews that are used to generate answers about the features of a given place in Google Maps.
+                              { # Encapsulates a snippet of a user review that answers a question about the features of a specific place in Google Maps.
+                                "reviewId": "A String", # The ID of the review snippet.
+                                "title": "A String", # Title of the review.
+                                "url": "A String", # A link that corresponds to the user review on Google Maps.
+                              },
+                            ],
+                            "url": "A String", # URI reference of the place.
+                          },
+                          "speechMetadata": { # Speech annotation for text content. # Speech annotation for text content.
+                            "speaker": "A String", # The speaker to associate with this turn.
+                            "style": "A String", # Style instruction for the speech synthesis.
+                          },
+                          "startIndex": 42, # Start of segment of the response that is attributed to this source. Index indicates the start of the segment, measured in bytes.
+                          "urlCitation": { # A URL citation annotation. # NOTE: We use these instead of the Citation message for historical reasons. A URL citation annotation.
+                            "title": "A String", # The title of the URL.
+                            "url": "A String", # The URL.
+                          },
+                          "wordInfo": { # Word-level ASR annotation for transcription output. Carries the word text, optional timing, and optional speaker attribution. # Word-level ASR annotation with timing and speaker info.
+                            "endOffset": "A String", # End offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                            "speaker": "A String", # Optional. Speaker label for this word (e.g. "spk_1", "spk_2"). Present when diarization_mode is set in TranscriptionConfig.
+                            "startOffset": "A String", # Start offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                            "text": "A String", # The transcribed word.
+                          },
+                        },
+                      ],
+                      "text": "A String", # Required. The text content.
+                    },
+                    "video": { # A video content block.
+                      "data": "A String", # The video content.
+                      "mimeTypeString": "A String", # Flexible MIME type string of the video, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                      "name": "A String", # A user-defined name for this content block. Can be referenced by the model in the final response.
+                      "processingConfig": {
+                        "static": {
+                          "endOffset": "A String", # Optional. Segment end time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "30s". Must be non-negative and greater than `start_offset` if `start_offset` is set.
+                          "fps": 3.14, # Optional. Video frame-rate sampling density.
+                          "startOffset": "A String", # Optional. Segment start time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "10.5s". Must be non-negative.
+                        },
+                      },
+                      "processingType": "A String",
+                      "resolution": "A String", # The resolution of the media.
+                      "uri": "A String", # The URI of the video.
+                    },
+                  },
+                  "listValue": { # `ListValue` is a wrapper around a repeated field of values. # Represents a repeated `Value`.
+                    "values": [ # Repeated field of dynamically typed values.
+                      # Object with schema name: GenaiVertexV1Value
+                    ],
+                  },
+                  "nullValue": "A String", # Represents a null value.
+                  "numberValue": 3.14, # Represents a double value.
+                  "stringValue": "A String", # Represents a string value.
+                  "structValue": # Object with schema name: GenaiVertexV1Struct # Represents a structured value.
+                },
+              },
+            ],
+          },
+        },
+        "video": { # Configuration for video output format.
+          "aspectRatio": "A String", # The aspect ratio for the video output.
+          "delivery": "A String", # The delivery mode for the video output.
+          "duration": "A String", # The duration for the video output.
+          "gcsUri": "A String", # The Cloud Storage URI to store the video output. Required for Vertex if delivery mode is URI.
+          "resolution": "A String", # The video output resolution. Defaults to 720p.
+        },
+      },
+      "safetySettings": [ # Safety settings for the interaction.
+        { # A safety setting that affects the safety-blocking behavior. A SafetySetting consists of a harm category and a threshold for that category.
+          "method": "A String", # Optional. The method for blocking content. If not specified, the default behavior is to use the probability score.
+          "threshold": "A String", # Required. The threshold for blocking content. If the harm probability exceeds this threshold, the content will be blocked.
+          "type": "A String", # Required. The type of harm category to be blocked.
+        },
+      ],
+      "serviceTier": "A String", # The service tier for the interaction.
+      "status": "A String", # Required. Output only. The status of the interaction.
+      "stepList": { # A list of Steps. # Input only. The steps for the interaction.
+        "steps": [ # The steps of the list.
+          { # A step in the interaction.
+            "modelOutput": { # Output generated by the model.
+              "content": [
+                { # The content of the response.
+                  "audio": { # An audio content block.
+                    "channels": 42, # The number of audio channels.
+                    "data": "A String", # The audio content.
+                    "mimeTypeString": "A String", # Flexible MIME type string of the audio, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                    "sampleRate": 42, # The sample rate of the audio.
+                    "uri": "A String", # The URI of the audio.
+                  },
+                  "document": { # A document content block.
+                    "data": "A String", # The document content.
+                    "mimeTypeString": "A String", # Flexible MIME type string of the document, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                    "uri": "A String", # The URI of the document.
+                  },
+                  "image": { # An image content block.
+                    "data": "A String", # The image content.
+                    "mimeTypeString": "A String", # Flexible MIME type string of the image, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                    "resolution": "A String", # The resolution of the media.
+                    "uri": "A String", # The URI of the image.
+                  },
+                  "text": { # A text content block.
+                    "annotations": [ # Citation information for model-generated content.
+                      { # Citation information for model-generated content.
+                        "endIndex": 42, # End of the attributed segment, exclusive.
+                        "fileCitation": { # A file citation annotation. # A file citation annotation.
+                          "customMetadata": { # User provided metadata about the retrieved context.
+                            "a_key": "", # Properties of the object.
+                          },
+                          "documentUri": "A String", # The URI of the file.
+                          "fileName": "A String", # The name of the file.
+                          "mediaId": "A String", # Media ID in-case of image citations, if applicable.
+                          "pageNumber": 42, # Page number of the cited document, if applicable.
+                          "source": "A String", # Source attributed for a portion of the text.
+                        },
+                        "placeCitation": { # A place citation annotation. # A place citation annotation.
+                          "name": "A String", # Title of the place.
+                          "placeId": "A String", # The ID of the place, in `places/{place_id}` format.
+                          "reviewSnippets": [ # Snippets of reviews that are used to generate answers about the features of a given place in Google Maps.
+                            { # Encapsulates a snippet of a user review that answers a question about the features of a specific place in Google Maps.
+                              "reviewId": "A String", # The ID of the review snippet.
+                              "title": "A String", # Title of the review.
+                              "url": "A String", # A link that corresponds to the user review on Google Maps.
+                            },
+                          ],
+                          "url": "A String", # URI reference of the place.
+                        },
+                        "speechMetadata": { # Speech annotation for text content. # Speech annotation for text content.
+                          "speaker": "A String", # The speaker to associate with this turn.
+                          "style": "A String", # Style instruction for the speech synthesis.
+                        },
+                        "startIndex": 42, # Start of segment of the response that is attributed to this source. Index indicates the start of the segment, measured in bytes.
+                        "urlCitation": { # A URL citation annotation. # NOTE: We use these instead of the Citation message for historical reasons. A URL citation annotation.
+                          "title": "A String", # The title of the URL.
+                          "url": "A String", # The URL.
+                        },
+                        "wordInfo": { # Word-level ASR annotation for transcription output. Carries the word text, optional timing, and optional speaker attribution. # Word-level ASR annotation with timing and speaker info.
+                          "endOffset": "A String", # End offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                          "speaker": "A String", # Optional. Speaker label for this word (e.g. "spk_1", "spk_2"). Present when diarization_mode is set in TranscriptionConfig.
+                          "startOffset": "A String", # Start offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                          "text": "A String", # The transcribed word.
+                        },
+                      },
+                    ],
+                    "text": "A String", # Required. The text content.
+                  },
+                  "video": { # A video content block.
+                    "data": "A String", # The video content.
+                    "mimeTypeString": "A String", # Flexible MIME type string of the video, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                    "name": "A String", # A user-defined name for this content block. Can be referenced by the model in the final response.
+                    "processingConfig": {
+                      "static": {
+                        "endOffset": "A String", # Optional. Segment end time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "30s". Must be non-negative and greater than `start_offset` if `start_offset` is set.
+                        "fps": 3.14, # Optional. Video frame-rate sampling density.
+                        "startOffset": "A String", # Optional. Segment start time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "10.5s". Must be non-negative.
+                      },
+                    },
+                    "processingType": "A String",
+                    "resolution": "A String", # The resolution of the media.
+                    "uri": "A String", # The URI of the video.
+                  },
+                },
+              ],
+              "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.
+              },
+            },
+            "thought": { # A thought step.
+              "signature": "A String", # A signature hash for backend validation.
+              "summary": [ # A summary of the thought.
+                { # The content of the response.
+                  "audio": { # An audio content block.
+                    "channels": 42, # The number of audio channels.
+                    "data": "A String", # The audio content.
+                    "mimeTypeString": "A String", # Flexible MIME type string of the audio, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                    "sampleRate": 42, # The sample rate of the audio.
+                    "uri": "A String", # The URI of the audio.
+                  },
+                  "document": { # A document content block.
+                    "data": "A String", # The document content.
+                    "mimeTypeString": "A String", # Flexible MIME type string of the document, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                    "uri": "A String", # The URI of the document.
+                  },
+                  "image": { # An image content block.
+                    "data": "A String", # The image content.
+                    "mimeTypeString": "A String", # Flexible MIME type string of the image, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                    "resolution": "A String", # The resolution of the media.
+                    "uri": "A String", # The URI of the image.
+                  },
+                  "text": { # A text content block.
+                    "annotations": [ # Citation information for model-generated content.
+                      { # Citation information for model-generated content.
+                        "endIndex": 42, # End of the attributed segment, exclusive.
+                        "fileCitation": { # A file citation annotation. # A file citation annotation.
+                          "customMetadata": { # User provided metadata about the retrieved context.
+                            "a_key": "", # Properties of the object.
+                          },
+                          "documentUri": "A String", # The URI of the file.
+                          "fileName": "A String", # The name of the file.
+                          "mediaId": "A String", # Media ID in-case of image citations, if applicable.
+                          "pageNumber": 42, # Page number of the cited document, if applicable.
+                          "source": "A String", # Source attributed for a portion of the text.
+                        },
+                        "placeCitation": { # A place citation annotation. # A place citation annotation.
+                          "name": "A String", # Title of the place.
+                          "placeId": "A String", # The ID of the place, in `places/{place_id}` format.
+                          "reviewSnippets": [ # Snippets of reviews that are used to generate answers about the features of a given place in Google Maps.
+                            { # Encapsulates a snippet of a user review that answers a question about the features of a specific place in Google Maps.
+                              "reviewId": "A String", # The ID of the review snippet.
+                              "title": "A String", # Title of the review.
+                              "url": "A String", # A link that corresponds to the user review on Google Maps.
+                            },
+                          ],
+                          "url": "A String", # URI reference of the place.
+                        },
+                        "speechMetadata": { # Speech annotation for text content. # Speech annotation for text content.
+                          "speaker": "A String", # The speaker to associate with this turn.
+                          "style": "A String", # Style instruction for the speech synthesis.
+                        },
+                        "startIndex": 42, # Start of segment of the response that is attributed to this source. Index indicates the start of the segment, measured in bytes.
+                        "urlCitation": { # A URL citation annotation. # NOTE: We use these instead of the Citation message for historical reasons. A URL citation annotation.
+                          "title": "A String", # The title of the URL.
+                          "url": "A String", # The URL.
+                        },
+                        "wordInfo": { # Word-level ASR annotation for transcription output. Carries the word text, optional timing, and optional speaker attribution. # Word-level ASR annotation with timing and speaker info.
+                          "endOffset": "A String", # End offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                          "speaker": "A String", # Optional. Speaker label for this word (e.g. "spk_1", "spk_2"). Present when diarization_mode is set in TranscriptionConfig.
+                          "startOffset": "A String", # Start offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                          "text": "A String", # The transcribed word.
+                        },
+                      },
+                    ],
+                    "text": "A String", # Required. The text content.
+                  },
+                  "video": { # A video content block.
+                    "data": "A String", # The video content.
+                    "mimeTypeString": "A String", # Flexible MIME type string of the video, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                    "name": "A String", # A user-defined name for this content block. Can be referenced by the model in the final response.
+                    "processingConfig": {
+                      "static": {
+                        "endOffset": "A String", # Optional. Segment end time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "30s". Must be non-negative and greater than `start_offset` if `start_offset` is set.
+                        "fps": 3.14, # Optional. Video frame-rate sampling density.
+                        "startOffset": "A String", # Optional. Segment start time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "10.5s". Must be non-negative.
+                      },
+                    },
+                    "processingType": "A String",
+                    "resolution": "A String", # The resolution of the media.
+                    "uri": "A String", # The URI of the video.
+                  },
+                },
+              ],
+            },
+            "toolCall": { # Tool call step.
+              "codeExecutionCall": { # Code execution call step.
+                "arguments": { # The arguments to pass to the code execution. # Required. The arguments to pass to the code execution.
+                  "code": "A String", # The code to be executed.
+                  "language": "A String", # Programming language of the `code`.
+                },
+              },
+              "fileSearchCall": { # File Search call step.
+              },
+              "functionCall": { # A function tool call step.
+                "arguments": { # `Struct` represents a structured data value, consisting of fields which map to dynamically typed values. # Required. The arguments to pass to the function.
+                  "fields": [ # Dynamically typed fields. List instead of map because LLMs are sensitive to ordering, and we want to give users full control.
+                    { # Represents a single field in a struct.
+                      "name": "A String",
+                      "value": { # `Value` represents a dynamically typed value which can be either null, a number, a string, a boolean, a recursive struct value, or a list of values. A producer of value is expected to set one of these variants. Absence of any variant indicates an error.
+                        "boolValue": True or False, # Represents a boolean value.
+                        "contentValue": { # The content of the response. # Represents rich content (text, image, etc.).
+                          "audio": { # An audio content block.
+                            "channels": 42, # The number of audio channels.
+                            "data": "A String", # The audio content.
+                            "mimeTypeString": "A String", # Flexible MIME type string of the audio, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                            "sampleRate": 42, # The sample rate of the audio.
+                            "uri": "A String", # The URI of the audio.
+                          },
+                          "document": { # A document content block.
+                            "data": "A String", # The document content.
+                            "mimeTypeString": "A String", # Flexible MIME type string of the document, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                            "uri": "A String", # The URI of the document.
+                          },
+                          "image": { # An image content block.
+                            "data": "A String", # The image content.
+                            "mimeTypeString": "A String", # Flexible MIME type string of the image, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                            "resolution": "A String", # The resolution of the media.
+                            "uri": "A String", # The URI of the image.
+                          },
+                          "text": { # A text content block.
+                            "annotations": [ # Citation information for model-generated content.
+                              { # Citation information for model-generated content.
+                                "endIndex": 42, # End of the attributed segment, exclusive.
+                                "fileCitation": { # A file citation annotation. # A file citation annotation.
+                                  "customMetadata": { # User provided metadata about the retrieved context.
+                                    "a_key": "", # Properties of the object.
+                                  },
+                                  "documentUri": "A String", # The URI of the file.
+                                  "fileName": "A String", # The name of the file.
+                                  "mediaId": "A String", # Media ID in-case of image citations, if applicable.
+                                  "pageNumber": 42, # Page number of the cited document, if applicable.
+                                  "source": "A String", # Source attributed for a portion of the text.
+                                },
+                                "placeCitation": { # A place citation annotation. # A place citation annotation.
+                                  "name": "A String", # Title of the place.
+                                  "placeId": "A String", # The ID of the place, in `places/{place_id}` format.
+                                  "reviewSnippets": [ # Snippets of reviews that are used to generate answers about the features of a given place in Google Maps.
+                                    { # Encapsulates a snippet of a user review that answers a question about the features of a specific place in Google Maps.
+                                      "reviewId": "A String", # The ID of the review snippet.
+                                      "title": "A String", # Title of the review.
+                                      "url": "A String", # A link that corresponds to the user review on Google Maps.
+                                    },
+                                  ],
+                                  "url": "A String", # URI reference of the place.
+                                },
+                                "speechMetadata": { # Speech annotation for text content. # Speech annotation for text content.
+                                  "speaker": "A String", # The speaker to associate with this turn.
+                                  "style": "A String", # Style instruction for the speech synthesis.
+                                },
+                                "startIndex": 42, # Start of segment of the response that is attributed to this source. Index indicates the start of the segment, measured in bytes.
+                                "urlCitation": { # A URL citation annotation. # NOTE: We use these instead of the Citation message for historical reasons. A URL citation annotation.
+                                  "title": "A String", # The title of the URL.
+                                  "url": "A String", # The URL.
+                                },
+                                "wordInfo": { # Word-level ASR annotation for transcription output. Carries the word text, optional timing, and optional speaker attribution. # Word-level ASR annotation with timing and speaker info.
+                                  "endOffset": "A String", # End offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                                  "speaker": "A String", # Optional. Speaker label for this word (e.g. "spk_1", "spk_2"). Present when diarization_mode is set in TranscriptionConfig.
+                                  "startOffset": "A String", # Start offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                                  "text": "A String", # The transcribed word.
+                                },
+                              },
+                            ],
+                            "text": "A String", # Required. The text content.
+                          },
+                          "video": { # A video content block.
+                            "data": "A String", # The video content.
+                            "mimeTypeString": "A String", # Flexible MIME type string of the video, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                            "name": "A String", # A user-defined name for this content block. Can be referenced by the model in the final response.
+                            "processingConfig": {
+                              "static": {
+                                "endOffset": "A String", # Optional. Segment end time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "30s". Must be non-negative and greater than `start_offset` if `start_offset` is set.
+                                "fps": 3.14, # Optional. Video frame-rate sampling density.
+                                "startOffset": "A String", # Optional. Segment start time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "10.5s". Must be non-negative.
+                              },
+                            },
+                            "processingType": "A String",
+                            "resolution": "A String", # The resolution of the media.
+                            "uri": "A String", # The URI of the video.
+                          },
+                        },
+                        "listValue": { # `ListValue` is a wrapper around a repeated field of values. # Represents a repeated `Value`.
+                          "values": [ # Repeated field of dynamically typed values.
+                            # Object with schema name: GenaiVertexV1Value
+                          ],
+                        },
+                        "nullValue": "A String", # Represents a null value.
+                        "numberValue": 3.14, # Represents a double value.
+                        "stringValue": "A String", # Represents a string value.
+                        "structValue": # Object with schema name: GenaiVertexV1Struct # Represents a structured value.
+                      },
+                    },
+                  ],
+                },
+                "name": "A String", # Required. The name of the tool to call.
+              },
+              "googleMapsCall": { # Google Maps call step.
+                "arguments": { # The arguments to pass to the Google Maps tool. # The arguments to pass to the Google Maps tool.
+                  "queries": [ # The queries to be executed.
+                    "A String",
+                  ],
+                },
+              },
+              "googleSearchCall": { # Google Search call step.
+                "arguments": { # The arguments to pass to Google Search. # Required. The arguments to pass to Google Search.
+                  "queries": [ # Web search queries for the following-up web search.
+                    "A String",
+                  ],
+                },
+                "searchType": "A String", # The type of search grounding enabled.
+              },
+              "id": "A String", # Required. A unique ID for this specific tool call.
+              "processingCall": { # A server-initiated processing step for media analysis (e.g. video understanding).
+              },
+              "retrievalCall": { # Retrieval call step. Used by Vertex Retrieval tools such as Parallel AI, Exa AI, Vertex AI Search, etc. RetrievalType decides which tool is used.
+                "arguments": { # The arguments to pass to Retrieval tools. # Required. The arguments to pass to the retrieval tool.
+                  "queries": [ # Queries for Retrieval information.
+                    "A String",
+                  ],
+                },
+                "retrievalType": "A String", # The type of retrieval tools.
+              },
+              "signature": "A String", # A signature hash for backend validation.
+              "urlContextCall": { # URL context call step.
+                "arguments": { # The arguments to pass to the URL context. # Required. The arguments to pass to the URL context.
+                  "urls": [ # The URLs to fetch.
+                    "A String",
+                  ],
+                },
+              },
+            },
+            "toolResult": { # Tool result step.
+              "callId": "A String", # Required. ID to match the ID from the function call block.
+              "codeExecutionResult": { # Code execution result step.
+                "isError": True or False, # Whether the code execution resulted in an error.
+                "result": "A String", # Required. The output of the code execution.
+              },
+              "fileSearchResult": { # File Search result step.
+              },
+              "functionResult": { # Result of a function tool call.
+                "isError": True or False, # Whether the tool call resulted in an error.
+                "name": "A String", # The name of the tool that was called.
+                "result": { # `Value` represents a dynamically typed value which can be either null, a number, a string, a boolean, a recursive struct value, or a list of values. A producer of value is expected to set one of these variants. Absence of any variant indicates an error. # Required. The result of the tool call.
+                  "boolValue": True or False, # Represents a boolean value.
+                  "contentValue": { # The content of the response. # Represents rich content (text, image, etc.).
+                    "audio": { # An audio content block.
+                      "channels": 42, # The number of audio channels.
+                      "data": "A String", # The audio content.
+                      "mimeTypeString": "A String", # Flexible MIME type string of the audio, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                      "sampleRate": 42, # The sample rate of the audio.
+                      "uri": "A String", # The URI of the audio.
+                    },
+                    "document": { # A document content block.
+                      "data": "A String", # The document content.
+                      "mimeTypeString": "A String", # Flexible MIME type string of the document, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                      "uri": "A String", # The URI of the document.
+                    },
+                    "image": { # An image content block.
+                      "data": "A String", # The image content.
+                      "mimeTypeString": "A String", # Flexible MIME type string of the image, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                      "resolution": "A String", # The resolution of the media.
+                      "uri": "A String", # The URI of the image.
+                    },
+                    "text": { # A text content block.
+                      "annotations": [ # Citation information for model-generated content.
+                        { # Citation information for model-generated content.
+                          "endIndex": 42, # End of the attributed segment, exclusive.
+                          "fileCitation": { # A file citation annotation. # A file citation annotation.
+                            "customMetadata": { # User provided metadata about the retrieved context.
+                              "a_key": "", # Properties of the object.
+                            },
+                            "documentUri": "A String", # The URI of the file.
+                            "fileName": "A String", # The name of the file.
+                            "mediaId": "A String", # Media ID in-case of image citations, if applicable.
+                            "pageNumber": 42, # Page number of the cited document, if applicable.
+                            "source": "A String", # Source attributed for a portion of the text.
+                          },
+                          "placeCitation": { # A place citation annotation. # A place citation annotation.
+                            "name": "A String", # Title of the place.
+                            "placeId": "A String", # The ID of the place, in `places/{place_id}` format.
+                            "reviewSnippets": [ # Snippets of reviews that are used to generate answers about the features of a given place in Google Maps.
+                              { # Encapsulates a snippet of a user review that answers a question about the features of a specific place in Google Maps.
+                                "reviewId": "A String", # The ID of the review snippet.
+                                "title": "A String", # Title of the review.
+                                "url": "A String", # A link that corresponds to the user review on Google Maps.
+                              },
+                            ],
+                            "url": "A String", # URI reference of the place.
+                          },
+                          "speechMetadata": { # Speech annotation for text content. # Speech annotation for text content.
+                            "speaker": "A String", # The speaker to associate with this turn.
+                            "style": "A String", # Style instruction for the speech synthesis.
+                          },
+                          "startIndex": 42, # Start of segment of the response that is attributed to this source. Index indicates the start of the segment, measured in bytes.
+                          "urlCitation": { # A URL citation annotation. # NOTE: We use these instead of the Citation message for historical reasons. A URL citation annotation.
+                            "title": "A String", # The title of the URL.
+                            "url": "A String", # The URL.
+                          },
+                          "wordInfo": { # Word-level ASR annotation for transcription output. Carries the word text, optional timing, and optional speaker attribution. # Word-level ASR annotation with timing and speaker info.
+                            "endOffset": "A String", # End offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                            "speaker": "A String", # Optional. Speaker label for this word (e.g. "spk_1", "spk_2"). Present when diarization_mode is set in TranscriptionConfig.
+                            "startOffset": "A String", # Start offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                            "text": "A String", # The transcribed word.
+                          },
+                        },
+                      ],
+                      "text": "A String", # Required. The text content.
+                    },
+                    "video": { # A video content block.
+                      "data": "A String", # The video content.
+                      "mimeTypeString": "A String", # Flexible MIME type string of the video, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                      "name": "A String", # A user-defined name for this content block. Can be referenced by the model in the final response.
+                      "processingConfig": {
+                        "static": {
+                          "endOffset": "A String", # Optional. Segment end time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "30s". Must be non-negative and greater than `start_offset` if `start_offset` is set.
+                          "fps": 3.14, # Optional. Video frame-rate sampling density.
+                          "startOffset": "A String", # Optional. Segment start time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "10.5s". Must be non-negative.
+                        },
+                      },
+                      "processingType": "A String",
+                      "resolution": "A String", # The resolution of the media.
+                      "uri": "A String", # The URI of the video.
+                    },
+                  },
+                  "listValue": { # `ListValue` is a wrapper around a repeated field of values. # Represents a repeated `Value`.
+                    "values": [ # Repeated field of dynamically typed values.
+                      # Object with schema name: GenaiVertexV1Value
+                    ],
+                  },
+                  "nullValue": "A String", # Represents a null value.
+                  "numberValue": 3.14, # Represents a double value.
+                  "stringValue": "A String", # Represents a string value.
+                  "structValue": # Object with schema name: GenaiVertexV1Struct # Represents a structured value.
+                },
+              },
+              "googleMapsResult": { # Google Maps result step.
+                "result": [
+                  { # The result of the Google Maps.
+                    "places": [
+                      {
+                        "name": "A String",
+                        "placeId": "A String",
+                        "reviewSnippets": [
+                          { # Encapsulates a snippet of a user review that answers a question about the features of a specific place in Google Maps.
+                            "reviewId": "A String", # The ID of the review snippet.
+                            "title": "A String", # Title of the review.
+                            "url": "A String", # A link that corresponds to the user review on Google Maps.
+                          },
+                        ],
+                        "url": "A String",
+                      },
+                    ],
+                    "widgetContextToken": "A String",
+                  },
+                ],
+              },
+              "googleSearchResult": { # Google Search result step.
+                "isError": True or False, # Whether the Google Search resulted in an error.
+                "result": [ # Required. The results of the Google Search.
+                  { # The result of the Google Search.
+                    "searchSuggestions": "A String", # Web content snippet that can be embedded in a web page or an app webview.
+                  },
+                ],
+              },
+              "processingResult": { # The result of a server-initiated media processing step.
+              },
+              "retrievalResult": { # Vertex Retrieval result step. Used by Vertex Retrieval tools such as Parallel AI, Exa AI, Vertex AI Search, etc.
+                "isError": True or False, # Whether the retrieval resulted in an error.
+              },
+              "signature": "A String", # A signature hash for backend validation.
+              "urlContextResult": { # URL context result step.
+                "isError": True or False, # Whether the URL context resulted in an error.
+                "result": [ # Required. The results of the URL context.
+                  { # The result of the URL context.
+                    "status": "A String", # The status of the URL retrieval.
+                    "url": "A String", # The URL that was fetched.
+                  },
+                ],
+              },
+            },
+            "userInput": { # Input provided by the user. # DO NOT USE -- These are for 3P JSON only
+              "contentList": { # A list of Content. # The content of the step. An array of Content objects.
+                "contents": [ # The contents of the list.
+                  { # The content of the response.
+                    "audio": { # An audio content block.
+                      "channels": 42, # The number of audio channels.
+                      "data": "A String", # The audio content.
+                      "mimeTypeString": "A String", # Flexible MIME type string of the audio, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                      "sampleRate": 42, # The sample rate of the audio.
+                      "uri": "A String", # The URI of the audio.
+                    },
+                    "document": { # A document content block.
+                      "data": "A String", # The document content.
+                      "mimeTypeString": "A String", # Flexible MIME type string of the document, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                      "uri": "A String", # The URI of the document.
+                    },
+                    "image": { # An image content block.
+                      "data": "A String", # The image content.
+                      "mimeTypeString": "A String", # Flexible MIME type string of the image, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                      "resolution": "A String", # The resolution of the media.
+                      "uri": "A String", # The URI of the image.
+                    },
+                    "text": { # A text content block.
+                      "annotations": [ # Citation information for model-generated content.
+                        { # Citation information for model-generated content.
+                          "endIndex": 42, # End of the attributed segment, exclusive.
+                          "fileCitation": { # A file citation annotation. # A file citation annotation.
+                            "customMetadata": { # User provided metadata about the retrieved context.
+                              "a_key": "", # Properties of the object.
+                            },
+                            "documentUri": "A String", # The URI of the file.
+                            "fileName": "A String", # The name of the file.
+                            "mediaId": "A String", # Media ID in-case of image citations, if applicable.
+                            "pageNumber": 42, # Page number of the cited document, if applicable.
+                            "source": "A String", # Source attributed for a portion of the text.
+                          },
+                          "placeCitation": { # A place citation annotation. # A place citation annotation.
+                            "name": "A String", # Title of the place.
+                            "placeId": "A String", # The ID of the place, in `places/{place_id}` format.
+                            "reviewSnippets": [ # Snippets of reviews that are used to generate answers about the features of a given place in Google Maps.
+                              { # Encapsulates a snippet of a user review that answers a question about the features of a specific place in Google Maps.
+                                "reviewId": "A String", # The ID of the review snippet.
+                                "title": "A String", # Title of the review.
+                                "url": "A String", # A link that corresponds to the user review on Google Maps.
+                              },
+                            ],
+                            "url": "A String", # URI reference of the place.
+                          },
+                          "speechMetadata": { # Speech annotation for text content. # Speech annotation for text content.
+                            "speaker": "A String", # The speaker to associate with this turn.
+                            "style": "A String", # Style instruction for the speech synthesis.
+                          },
+                          "startIndex": 42, # Start of segment of the response that is attributed to this source. Index indicates the start of the segment, measured in bytes.
+                          "urlCitation": { # A URL citation annotation. # NOTE: We use these instead of the Citation message for historical reasons. A URL citation annotation.
+                            "title": "A String", # The title of the URL.
+                            "url": "A String", # The URL.
+                          },
+                          "wordInfo": { # Word-level ASR annotation for transcription output. Carries the word text, optional timing, and optional speaker attribution. # Word-level ASR annotation with timing and speaker info.
+                            "endOffset": "A String", # End offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                            "speaker": "A String", # Optional. Speaker label for this word (e.g. "spk_1", "spk_2"). Present when diarization_mode is set in TranscriptionConfig.
+                            "startOffset": "A String", # Start offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                            "text": "A String", # The transcribed word.
+                          },
+                        },
+                      ],
+                      "text": "A String", # Required. The text content.
+                    },
+                    "video": { # A video content block.
+                      "data": "A String", # The video content.
+                      "mimeTypeString": "A String", # Flexible MIME type string of the video, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                      "name": "A String", # A user-defined name for this content block. Can be referenced by the model in the final response.
+                      "processingConfig": {
+                        "static": {
+                          "endOffset": "A String", # Optional. Segment end time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "30s". Must be non-negative and greater than `start_offset` if `start_offset` is set.
+                          "fps": 3.14, # Optional. Video frame-rate sampling density.
+                          "startOffset": "A String", # Optional. Segment start time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "10.5s". Must be non-negative.
+                        },
+                      },
+                      "processingType": "A String",
+                      "resolution": "A String", # The resolution of the media.
+                      "uri": "A String", # The URI of the video.
+                    },
+                  },
+                ],
+              },
+              "contentString": "A String", # The content of the step. A single string.
+            },
+          },
+        ],
+      },
+      "steps": [ # Required. Output only. The steps that make up the interaction, when included in the response.
+        { # A step in the interaction.
+          "modelOutput": { # Output generated by the model.
+            "content": [
+              { # The content of the response.
+                "audio": { # An audio content block.
+                  "channels": 42, # The number of audio channels.
+                  "data": "A String", # The audio content.
+                  "mimeTypeString": "A String", # Flexible MIME type string of the audio, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                  "sampleRate": 42, # The sample rate of the audio.
+                  "uri": "A String", # The URI of the audio.
+                },
+                "document": { # A document content block.
+                  "data": "A String", # The document content.
+                  "mimeTypeString": "A String", # Flexible MIME type string of the document, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                  "uri": "A String", # The URI of the document.
+                },
+                "image": { # An image content block.
+                  "data": "A String", # The image content.
+                  "mimeTypeString": "A String", # Flexible MIME type string of the image, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                  "resolution": "A String", # The resolution of the media.
+                  "uri": "A String", # The URI of the image.
+                },
+                "text": { # A text content block.
+                  "annotations": [ # Citation information for model-generated content.
+                    { # Citation information for model-generated content.
+                      "endIndex": 42, # End of the attributed segment, exclusive.
+                      "fileCitation": { # A file citation annotation. # A file citation annotation.
+                        "customMetadata": { # User provided metadata about the retrieved context.
+                          "a_key": "", # Properties of the object.
+                        },
+                        "documentUri": "A String", # The URI of the file.
+                        "fileName": "A String", # The name of the file.
+                        "mediaId": "A String", # Media ID in-case of image citations, if applicable.
+                        "pageNumber": 42, # Page number of the cited document, if applicable.
+                        "source": "A String", # Source attributed for a portion of the text.
+                      },
+                      "placeCitation": { # A place citation annotation. # A place citation annotation.
+                        "name": "A String", # Title of the place.
+                        "placeId": "A String", # The ID of the place, in `places/{place_id}` format.
+                        "reviewSnippets": [ # Snippets of reviews that are used to generate answers about the features of a given place in Google Maps.
+                          { # Encapsulates a snippet of a user review that answers a question about the features of a specific place in Google Maps.
+                            "reviewId": "A String", # The ID of the review snippet.
+                            "title": "A String", # Title of the review.
+                            "url": "A String", # A link that corresponds to the user review on Google Maps.
+                          },
+                        ],
+                        "url": "A String", # URI reference of the place.
+                      },
+                      "speechMetadata": { # Speech annotation for text content. # Speech annotation for text content.
+                        "speaker": "A String", # The speaker to associate with this turn.
+                        "style": "A String", # Style instruction for the speech synthesis.
+                      },
+                      "startIndex": 42, # Start of segment of the response that is attributed to this source. Index indicates the start of the segment, measured in bytes.
+                      "urlCitation": { # A URL citation annotation. # NOTE: We use these instead of the Citation message for historical reasons. A URL citation annotation.
+                        "title": "A String", # The title of the URL.
+                        "url": "A String", # The URL.
+                      },
+                      "wordInfo": { # Word-level ASR annotation for transcription output. Carries the word text, optional timing, and optional speaker attribution. # Word-level ASR annotation with timing and speaker info.
+                        "endOffset": "A String", # End offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                        "speaker": "A String", # Optional. Speaker label for this word (e.g. "spk_1", "spk_2"). Present when diarization_mode is set in TranscriptionConfig.
+                        "startOffset": "A String", # Start offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                        "text": "A String", # The transcribed word.
+                      },
+                    },
+                  ],
+                  "text": "A String", # Required. The text content.
+                },
+                "video": { # A video content block.
+                  "data": "A String", # The video content.
+                  "mimeTypeString": "A String", # Flexible MIME type string of the video, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                  "name": "A String", # A user-defined name for this content block. Can be referenced by the model in the final response.
+                  "processingConfig": {
+                    "static": {
+                      "endOffset": "A String", # Optional. Segment end time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "30s". Must be non-negative and greater than `start_offset` if `start_offset` is set.
+                      "fps": 3.14, # Optional. Video frame-rate sampling density.
+                      "startOffset": "A String", # Optional. Segment start time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "10.5s". Must be non-negative.
+                    },
+                  },
+                  "processingType": "A String",
+                  "resolution": "A String", # The resolution of the media.
+                  "uri": "A String", # The URI of the video.
+                },
+              },
+            ],
+            "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.
+            },
+          },
+          "thought": { # A thought step.
+            "signature": "A String", # A signature hash for backend validation.
+            "summary": [ # A summary of the thought.
+              { # The content of the response.
+                "audio": { # An audio content block.
+                  "channels": 42, # The number of audio channels.
+                  "data": "A String", # The audio content.
+                  "mimeTypeString": "A String", # Flexible MIME type string of the audio, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                  "sampleRate": 42, # The sample rate of the audio.
+                  "uri": "A String", # The URI of the audio.
+                },
+                "document": { # A document content block.
+                  "data": "A String", # The document content.
+                  "mimeTypeString": "A String", # Flexible MIME type string of the document, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                  "uri": "A String", # The URI of the document.
+                },
+                "image": { # An image content block.
+                  "data": "A String", # The image content.
+                  "mimeTypeString": "A String", # Flexible MIME type string of the image, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                  "resolution": "A String", # The resolution of the media.
+                  "uri": "A String", # The URI of the image.
+                },
+                "text": { # A text content block.
+                  "annotations": [ # Citation information for model-generated content.
+                    { # Citation information for model-generated content.
+                      "endIndex": 42, # End of the attributed segment, exclusive.
+                      "fileCitation": { # A file citation annotation. # A file citation annotation.
+                        "customMetadata": { # User provided metadata about the retrieved context.
+                          "a_key": "", # Properties of the object.
+                        },
+                        "documentUri": "A String", # The URI of the file.
+                        "fileName": "A String", # The name of the file.
+                        "mediaId": "A String", # Media ID in-case of image citations, if applicable.
+                        "pageNumber": 42, # Page number of the cited document, if applicable.
+                        "source": "A String", # Source attributed for a portion of the text.
+                      },
+                      "placeCitation": { # A place citation annotation. # A place citation annotation.
+                        "name": "A String", # Title of the place.
+                        "placeId": "A String", # The ID of the place, in `places/{place_id}` format.
+                        "reviewSnippets": [ # Snippets of reviews that are used to generate answers about the features of a given place in Google Maps.
+                          { # Encapsulates a snippet of a user review that answers a question about the features of a specific place in Google Maps.
+                            "reviewId": "A String", # The ID of the review snippet.
+                            "title": "A String", # Title of the review.
+                            "url": "A String", # A link that corresponds to the user review on Google Maps.
+                          },
+                        ],
+                        "url": "A String", # URI reference of the place.
+                      },
+                      "speechMetadata": { # Speech annotation for text content. # Speech annotation for text content.
+                        "speaker": "A String", # The speaker to associate with this turn.
+                        "style": "A String", # Style instruction for the speech synthesis.
+                      },
+                      "startIndex": 42, # Start of segment of the response that is attributed to this source. Index indicates the start of the segment, measured in bytes.
+                      "urlCitation": { # A URL citation annotation. # NOTE: We use these instead of the Citation message for historical reasons. A URL citation annotation.
+                        "title": "A String", # The title of the URL.
+                        "url": "A String", # The URL.
+                      },
+                      "wordInfo": { # Word-level ASR annotation for transcription output. Carries the word text, optional timing, and optional speaker attribution. # Word-level ASR annotation with timing and speaker info.
+                        "endOffset": "A String", # End offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                        "speaker": "A String", # Optional. Speaker label for this word (e.g. "spk_1", "spk_2"). Present when diarization_mode is set in TranscriptionConfig.
+                        "startOffset": "A String", # Start offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                        "text": "A String", # The transcribed word.
+                      },
+                    },
+                  ],
+                  "text": "A String", # Required. The text content.
+                },
+                "video": { # A video content block.
+                  "data": "A String", # The video content.
+                  "mimeTypeString": "A String", # Flexible MIME type string of the video, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                  "name": "A String", # A user-defined name for this content block. Can be referenced by the model in the final response.
+                  "processingConfig": {
+                    "static": {
+                      "endOffset": "A String", # Optional. Segment end time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "30s". Must be non-negative and greater than `start_offset` if `start_offset` is set.
+                      "fps": 3.14, # Optional. Video frame-rate sampling density.
+                      "startOffset": "A String", # Optional. Segment start time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "10.5s". Must be non-negative.
+                    },
+                  },
+                  "processingType": "A String",
+                  "resolution": "A String", # The resolution of the media.
+                  "uri": "A String", # The URI of the video.
+                },
+              },
+            ],
+          },
+          "toolCall": { # Tool call step.
+            "codeExecutionCall": { # Code execution call step.
+              "arguments": { # The arguments to pass to the code execution. # Required. The arguments to pass to the code execution.
+                "code": "A String", # The code to be executed.
+                "language": "A String", # Programming language of the `code`.
+              },
+            },
+            "fileSearchCall": { # File Search call step.
+            },
+            "functionCall": { # A function tool call step.
+              "arguments": { # `Struct` represents a structured data value, consisting of fields which map to dynamically typed values. # Required. The arguments to pass to the function.
+                "fields": [ # Dynamically typed fields. List instead of map because LLMs are sensitive to ordering, and we want to give users full control.
+                  { # Represents a single field in a struct.
+                    "name": "A String",
+                    "value": { # `Value` represents a dynamically typed value which can be either null, a number, a string, a boolean, a recursive struct value, or a list of values. A producer of value is expected to set one of these variants. Absence of any variant indicates an error.
+                      "boolValue": True or False, # Represents a boolean value.
+                      "contentValue": { # The content of the response. # Represents rich content (text, image, etc.).
+                        "audio": { # An audio content block.
+                          "channels": 42, # The number of audio channels.
+                          "data": "A String", # The audio content.
+                          "mimeTypeString": "A String", # Flexible MIME type string of the audio, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                          "sampleRate": 42, # The sample rate of the audio.
+                          "uri": "A String", # The URI of the audio.
+                        },
+                        "document": { # A document content block.
+                          "data": "A String", # The document content.
+                          "mimeTypeString": "A String", # Flexible MIME type string of the document, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                          "uri": "A String", # The URI of the document.
+                        },
+                        "image": { # An image content block.
+                          "data": "A String", # The image content.
+                          "mimeTypeString": "A String", # Flexible MIME type string of the image, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                          "resolution": "A String", # The resolution of the media.
+                          "uri": "A String", # The URI of the image.
+                        },
+                        "text": { # A text content block.
+                          "annotations": [ # Citation information for model-generated content.
+                            { # Citation information for model-generated content.
+                              "endIndex": 42, # End of the attributed segment, exclusive.
+                              "fileCitation": { # A file citation annotation. # A file citation annotation.
+                                "customMetadata": { # User provided metadata about the retrieved context.
+                                  "a_key": "", # Properties of the object.
+                                },
+                                "documentUri": "A String", # The URI of the file.
+                                "fileName": "A String", # The name of the file.
+                                "mediaId": "A String", # Media ID in-case of image citations, if applicable.
+                                "pageNumber": 42, # Page number of the cited document, if applicable.
+                                "source": "A String", # Source attributed for a portion of the text.
+                              },
+                              "placeCitation": { # A place citation annotation. # A place citation annotation.
+                                "name": "A String", # Title of the place.
+                                "placeId": "A String", # The ID of the place, in `places/{place_id}` format.
+                                "reviewSnippets": [ # Snippets of reviews that are used to generate answers about the features of a given place in Google Maps.
+                                  { # Encapsulates a snippet of a user review that answers a question about the features of a specific place in Google Maps.
+                                    "reviewId": "A String", # The ID of the review snippet.
+                                    "title": "A String", # Title of the review.
+                                    "url": "A String", # A link that corresponds to the user review on Google Maps.
+                                  },
+                                ],
+                                "url": "A String", # URI reference of the place.
+                              },
+                              "speechMetadata": { # Speech annotation for text content. # Speech annotation for text content.
+                                "speaker": "A String", # The speaker to associate with this turn.
+                                "style": "A String", # Style instruction for the speech synthesis.
+                              },
+                              "startIndex": 42, # Start of segment of the response that is attributed to this source. Index indicates the start of the segment, measured in bytes.
+                              "urlCitation": { # A URL citation annotation. # NOTE: We use these instead of the Citation message for historical reasons. A URL citation annotation.
+                                "title": "A String", # The title of the URL.
+                                "url": "A String", # The URL.
+                              },
+                              "wordInfo": { # Word-level ASR annotation for transcription output. Carries the word text, optional timing, and optional speaker attribution. # Word-level ASR annotation with timing and speaker info.
+                                "endOffset": "A String", # End offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                                "speaker": "A String", # Optional. Speaker label for this word (e.g. "spk_1", "spk_2"). Present when diarization_mode is set in TranscriptionConfig.
+                                "startOffset": "A String", # Start offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                                "text": "A String", # The transcribed word.
+                              },
+                            },
+                          ],
+                          "text": "A String", # Required. The text content.
+                        },
+                        "video": { # A video content block.
+                          "data": "A String", # The video content.
+                          "mimeTypeString": "A String", # Flexible MIME type string of the video, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                          "name": "A String", # A user-defined name for this content block. Can be referenced by the model in the final response.
+                          "processingConfig": {
+                            "static": {
+                              "endOffset": "A String", # Optional. Segment end time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "30s". Must be non-negative and greater than `start_offset` if `start_offset` is set.
+                              "fps": 3.14, # Optional. Video frame-rate sampling density.
+                              "startOffset": "A String", # Optional. Segment start time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "10.5s". Must be non-negative.
+                            },
+                          },
+                          "processingType": "A String",
+                          "resolution": "A String", # The resolution of the media.
+                          "uri": "A String", # The URI of the video.
+                        },
+                      },
+                      "listValue": { # `ListValue` is a wrapper around a repeated field of values. # Represents a repeated `Value`.
+                        "values": [ # Repeated field of dynamically typed values.
+                          # Object with schema name: GenaiVertexV1Value
+                        ],
+                      },
+                      "nullValue": "A String", # Represents a null value.
+                      "numberValue": 3.14, # Represents a double value.
+                      "stringValue": "A String", # Represents a string value.
+                      "structValue": # Object with schema name: GenaiVertexV1Struct # Represents a structured value.
+                    },
+                  },
+                ],
+              },
+              "name": "A String", # Required. The name of the tool to call.
+            },
+            "googleMapsCall": { # Google Maps call step.
+              "arguments": { # The arguments to pass to the Google Maps tool. # The arguments to pass to the Google Maps tool.
+                "queries": [ # The queries to be executed.
+                  "A String",
+                ],
+              },
+            },
+            "googleSearchCall": { # Google Search call step.
+              "arguments": { # The arguments to pass to Google Search. # Required. The arguments to pass to Google Search.
+                "queries": [ # Web search queries for the following-up web search.
+                  "A String",
+                ],
+              },
+              "searchType": "A String", # The type of search grounding enabled.
+            },
+            "id": "A String", # Required. A unique ID for this specific tool call.
+            "processingCall": { # A server-initiated processing step for media analysis (e.g. video understanding).
+            },
+            "retrievalCall": { # Retrieval call step. Used by Vertex Retrieval tools such as Parallel AI, Exa AI, Vertex AI Search, etc. RetrievalType decides which tool is used.
+              "arguments": { # The arguments to pass to Retrieval tools. # Required. The arguments to pass to the retrieval tool.
+                "queries": [ # Queries for Retrieval information.
+                  "A String",
+                ],
+              },
+              "retrievalType": "A String", # The type of retrieval tools.
+            },
+            "signature": "A String", # A signature hash for backend validation.
+            "urlContextCall": { # URL context call step.
+              "arguments": { # The arguments to pass to the URL context. # Required. The arguments to pass to the URL context.
+                "urls": [ # The URLs to fetch.
+                  "A String",
+                ],
+              },
+            },
+          },
+          "toolResult": { # Tool result step.
+            "callId": "A String", # Required. ID to match the ID from the function call block.
+            "codeExecutionResult": { # Code execution result step.
+              "isError": True or False, # Whether the code execution resulted in an error.
+              "result": "A String", # Required. The output of the code execution.
+            },
+            "fileSearchResult": { # File Search result step.
+            },
+            "functionResult": { # Result of a function tool call.
+              "isError": True or False, # Whether the tool call resulted in an error.
+              "name": "A String", # The name of the tool that was called.
+              "result": { # `Value` represents a dynamically typed value which can be either null, a number, a string, a boolean, a recursive struct value, or a list of values. A producer of value is expected to set one of these variants. Absence of any variant indicates an error. # Required. The result of the tool call.
+                "boolValue": True or False, # Represents a boolean value.
+                "contentValue": { # The content of the response. # Represents rich content (text, image, etc.).
+                  "audio": { # An audio content block.
+                    "channels": 42, # The number of audio channels.
+                    "data": "A String", # The audio content.
+                    "mimeTypeString": "A String", # Flexible MIME type string of the audio, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                    "sampleRate": 42, # The sample rate of the audio.
+                    "uri": "A String", # The URI of the audio.
+                  },
+                  "document": { # A document content block.
+                    "data": "A String", # The document content.
+                    "mimeTypeString": "A String", # Flexible MIME type string of the document, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                    "uri": "A String", # The URI of the document.
+                  },
+                  "image": { # An image content block.
+                    "data": "A String", # The image content.
+                    "mimeTypeString": "A String", # Flexible MIME type string of the image, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                    "resolution": "A String", # The resolution of the media.
+                    "uri": "A String", # The URI of the image.
+                  },
+                  "text": { # A text content block.
+                    "annotations": [ # Citation information for model-generated content.
+                      { # Citation information for model-generated content.
+                        "endIndex": 42, # End of the attributed segment, exclusive.
+                        "fileCitation": { # A file citation annotation. # A file citation annotation.
+                          "customMetadata": { # User provided metadata about the retrieved context.
+                            "a_key": "", # Properties of the object.
+                          },
+                          "documentUri": "A String", # The URI of the file.
+                          "fileName": "A String", # The name of the file.
+                          "mediaId": "A String", # Media ID in-case of image citations, if applicable.
+                          "pageNumber": 42, # Page number of the cited document, if applicable.
+                          "source": "A String", # Source attributed for a portion of the text.
+                        },
+                        "placeCitation": { # A place citation annotation. # A place citation annotation.
+                          "name": "A String", # Title of the place.
+                          "placeId": "A String", # The ID of the place, in `places/{place_id}` format.
+                          "reviewSnippets": [ # Snippets of reviews that are used to generate answers about the features of a given place in Google Maps.
+                            { # Encapsulates a snippet of a user review that answers a question about the features of a specific place in Google Maps.
+                              "reviewId": "A String", # The ID of the review snippet.
+                              "title": "A String", # Title of the review.
+                              "url": "A String", # A link that corresponds to the user review on Google Maps.
+                            },
+                          ],
+                          "url": "A String", # URI reference of the place.
+                        },
+                        "speechMetadata": { # Speech annotation for text content. # Speech annotation for text content.
+                          "speaker": "A String", # The speaker to associate with this turn.
+                          "style": "A String", # Style instruction for the speech synthesis.
+                        },
+                        "startIndex": 42, # Start of segment of the response that is attributed to this source. Index indicates the start of the segment, measured in bytes.
+                        "urlCitation": { # A URL citation annotation. # NOTE: We use these instead of the Citation message for historical reasons. A URL citation annotation.
+                          "title": "A String", # The title of the URL.
+                          "url": "A String", # The URL.
+                        },
+                        "wordInfo": { # Word-level ASR annotation for transcription output. Carries the word text, optional timing, and optional speaker attribution. # Word-level ASR annotation with timing and speaker info.
+                          "endOffset": "A String", # End offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                          "speaker": "A String", # Optional. Speaker label for this word (e.g. "spk_1", "spk_2"). Present when diarization_mode is set in TranscriptionConfig.
+                          "startOffset": "A String", # Start offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                          "text": "A String", # The transcribed word.
+                        },
+                      },
+                    ],
+                    "text": "A String", # Required. The text content.
+                  },
+                  "video": { # A video content block.
+                    "data": "A String", # The video content.
+                    "mimeTypeString": "A String", # Flexible MIME type string of the video, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                    "name": "A String", # A user-defined name for this content block. Can be referenced by the model in the final response.
+                    "processingConfig": {
+                      "static": {
+                        "endOffset": "A String", # Optional. Segment end time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "30s". Must be non-negative and greater than `start_offset` if `start_offset` is set.
+                        "fps": 3.14, # Optional. Video frame-rate sampling density.
+                        "startOffset": "A String", # Optional. Segment start time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "10.5s". Must be non-negative.
+                      },
+                    },
+                    "processingType": "A String",
+                    "resolution": "A String", # The resolution of the media.
+                    "uri": "A String", # The URI of the video.
+                  },
+                },
+                "listValue": { # `ListValue` is a wrapper around a repeated field of values. # Represents a repeated `Value`.
+                  "values": [ # Repeated field of dynamically typed values.
+                    # Object with schema name: GenaiVertexV1Value
+                  ],
+                },
+                "nullValue": "A String", # Represents a null value.
+                "numberValue": 3.14, # Represents a double value.
+                "stringValue": "A String", # Represents a string value.
+                "structValue": # Object with schema name: GenaiVertexV1Struct # Represents a structured value.
+              },
+            },
+            "googleMapsResult": { # Google Maps result step.
+              "result": [
+                { # The result of the Google Maps.
+                  "places": [
+                    {
+                      "name": "A String",
+                      "placeId": "A String",
+                      "reviewSnippets": [
+                        { # Encapsulates a snippet of a user review that answers a question about the features of a specific place in Google Maps.
+                          "reviewId": "A String", # The ID of the review snippet.
+                          "title": "A String", # Title of the review.
+                          "url": "A String", # A link that corresponds to the user review on Google Maps.
+                        },
+                      ],
+                      "url": "A String",
+                    },
+                  ],
+                  "widgetContextToken": "A String",
+                },
+              ],
+            },
+            "googleSearchResult": { # Google Search result step.
+              "isError": True or False, # Whether the Google Search resulted in an error.
+              "result": [ # Required. The results of the Google Search.
+                { # The result of the Google Search.
+                  "searchSuggestions": "A String", # Web content snippet that can be embedded in a web page or an app webview.
+                },
+              ],
+            },
+            "processingResult": { # The result of a server-initiated media processing step.
+            },
+            "retrievalResult": { # Vertex Retrieval result step. Used by Vertex Retrieval tools such as Parallel AI, Exa AI, Vertex AI Search, etc.
+              "isError": True or False, # Whether the retrieval resulted in an error.
+            },
+            "signature": "A String", # A signature hash for backend validation.
+            "urlContextResult": { # URL context result step.
+              "isError": True or False, # Whether the URL context resulted in an error.
+              "result": [ # Required. The results of the URL context.
+                { # The result of the URL context.
+                  "status": "A String", # The status of the URL retrieval.
+                  "url": "A String", # The URL that was fetched.
+                },
+              ],
+            },
+          },
+          "userInput": { # Input provided by the user. # DO NOT USE -- These are for 3P JSON only
+            "contentList": { # A list of Content. # The content of the step. An array of Content objects.
+              "contents": [ # The contents of the list.
+                { # The content of the response.
+                  "audio": { # An audio content block.
+                    "channels": 42, # The number of audio channels.
+                    "data": "A String", # The audio content.
+                    "mimeTypeString": "A String", # Flexible MIME type string of the audio, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                    "sampleRate": 42, # The sample rate of the audio.
+                    "uri": "A String", # The URI of the audio.
+                  },
+                  "document": { # A document content block.
+                    "data": "A String", # The document content.
+                    "mimeTypeString": "A String", # Flexible MIME type string of the document, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                    "uri": "A String", # The URI of the document.
+                  },
+                  "image": { # An image content block.
+                    "data": "A String", # The image content.
+                    "mimeTypeString": "A String", # Flexible MIME type string of the image, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                    "resolution": "A String", # The resolution of the media.
+                    "uri": "A String", # The URI of the image.
+                  },
+                  "text": { # A text content block.
+                    "annotations": [ # Citation information for model-generated content.
+                      { # Citation information for model-generated content.
+                        "endIndex": 42, # End of the attributed segment, exclusive.
+                        "fileCitation": { # A file citation annotation. # A file citation annotation.
+                          "customMetadata": { # User provided metadata about the retrieved context.
+                            "a_key": "", # Properties of the object.
+                          },
+                          "documentUri": "A String", # The URI of the file.
+                          "fileName": "A String", # The name of the file.
+                          "mediaId": "A String", # Media ID in-case of image citations, if applicable.
+                          "pageNumber": 42, # Page number of the cited document, if applicable.
+                          "source": "A String", # Source attributed for a portion of the text.
+                        },
+                        "placeCitation": { # A place citation annotation. # A place citation annotation.
+                          "name": "A String", # Title of the place.
+                          "placeId": "A String", # The ID of the place, in `places/{place_id}` format.
+                          "reviewSnippets": [ # Snippets of reviews that are used to generate answers about the features of a given place in Google Maps.
+                            { # Encapsulates a snippet of a user review that answers a question about the features of a specific place in Google Maps.
+                              "reviewId": "A String", # The ID of the review snippet.
+                              "title": "A String", # Title of the review.
+                              "url": "A String", # A link that corresponds to the user review on Google Maps.
+                            },
+                          ],
+                          "url": "A String", # URI reference of the place.
+                        },
+                        "speechMetadata": { # Speech annotation for text content. # Speech annotation for text content.
+                          "speaker": "A String", # The speaker to associate with this turn.
+                          "style": "A String", # Style instruction for the speech synthesis.
+                        },
+                        "startIndex": 42, # Start of segment of the response that is attributed to this source. Index indicates the start of the segment, measured in bytes.
+                        "urlCitation": { # A URL citation annotation. # NOTE: We use these instead of the Citation message for historical reasons. A URL citation annotation.
+                          "title": "A String", # The title of the URL.
+                          "url": "A String", # The URL.
+                        },
+                        "wordInfo": { # Word-level ASR annotation for transcription output. Carries the word text, optional timing, and optional speaker attribution. # Word-level ASR annotation with timing and speaker info.
+                          "endOffset": "A String", # End offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                          "speaker": "A String", # Optional. Speaker label for this word (e.g. "spk_1", "spk_2"). Present when diarization_mode is set in TranscriptionConfig.
+                          "startOffset": "A String", # Start offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                          "text": "A String", # The transcribed word.
+                        },
+                      },
+                    ],
+                    "text": "A String", # Required. The text content.
+                  },
+                  "video": { # A video content block.
+                    "data": "A String", # The video content.
+                    "mimeTypeString": "A String", # Flexible MIME type string of the video, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                    "name": "A String", # A user-defined name for this content block. Can be referenced by the model in the final response.
+                    "processingConfig": {
+                      "static": {
+                        "endOffset": "A String", # Optional. Segment end time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "30s". Must be non-negative and greater than `start_offset` if `start_offset` is set.
+                        "fps": 3.14, # Optional. Video frame-rate sampling density.
+                        "startOffset": "A String", # Optional. Segment start time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "10.5s". Must be non-negative.
+                      },
+                    },
+                    "processingType": "A String",
+                    "resolution": "A String", # The resolution of the media.
+                    "uri": "A String", # The URI of the video.
+                  },
+                },
+              ],
+            },
+            "contentString": "A String", # The content of the step. A single string.
+          },
+        },
+      ],
+      "stringContent": "A String", # A string input for the interaction, it will be processed as a single text input.
+      "systemInstruction": "A String", # System instruction for the interaction.
+      "tools": [ # A list of tool declarations the model may call during interaction.
+        { # A tool that can be used by the model.
+          "codeExecution": { # A tool that can be used by the model to execute code. # A tool that can be used by the model to execute code.
+          },
+          "computerUse": { # A tool that can be used by the model to interact with the computer. # Tool to support the model interacting directly with the computer.
+            "disabledSafetyPolicies": [ # Optional. Disabled safety policies for computer use.
+              "A String",
+            ],
+            "enablePromptInjectionDetection": True or False, # Whether enable the prompt injection detection check on computer-use request.
+            "environment": "A String", # The environment being operated.
+            "excludedPredefinedFunctions": [ # The list of predefined functions that are excluded from the model call.
+              "A String",
+            ],
+          },
+          "fileSearch": { # A tool that can be used by the model to search files. # A tool that can be used by the model to search files.
+            "fileSearchStoreNames": [ # The file search store names to search.
+              "A String",
+            ],
+            "metadataFilter": "A String", # Metadata filter to apply to the semantic retrieval documents and chunks.
+            "topK": 42, # The number of semantic retrieval chunks to retrieve.
+          },
+          "function": { # A tool that can be used by the model. # A function that can be used by the model.
+            "description": "A String", # A description of the function.
+            "name": "A String", # The name of the function.
+            "parameters": { # `Value` represents a dynamically typed value which can be either null, a number, a string, a boolean, a recursive struct value, or a list of values. A producer of value is expected to set one of these variants. Absence of any variant indicates an error. # The JSON Schema for the function's parameters.
+              "boolValue": True or False, # Represents a boolean value.
+              "contentValue": { # The content of the response. # Represents rich content (text, image, etc.).
+                "audio": { # An audio content block.
+                  "channels": 42, # The number of audio channels.
+                  "data": "A String", # The audio content.
+                  "mimeTypeString": "A String", # Flexible MIME type string of the audio, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                  "sampleRate": 42, # The sample rate of the audio.
+                  "uri": "A String", # The URI of the audio.
+                },
+                "document": { # A document content block.
+                  "data": "A String", # The document content.
+                  "mimeTypeString": "A String", # Flexible MIME type string of the document, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                  "uri": "A String", # The URI of the document.
+                },
+                "image": { # An image content block.
+                  "data": "A String", # The image content.
+                  "mimeTypeString": "A String", # Flexible MIME type string of the image, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                  "resolution": "A String", # The resolution of the media.
+                  "uri": "A String", # The URI of the image.
+                },
+                "text": { # A text content block.
+                  "annotations": [ # Citation information for model-generated content.
+                    { # Citation information for model-generated content.
+                      "endIndex": 42, # End of the attributed segment, exclusive.
+                      "fileCitation": { # A file citation annotation. # A file citation annotation.
+                        "customMetadata": { # User provided metadata about the retrieved context.
+                          "a_key": "", # Properties of the object.
+                        },
+                        "documentUri": "A String", # The URI of the file.
+                        "fileName": "A String", # The name of the file.
+                        "mediaId": "A String", # Media ID in-case of image citations, if applicable.
+                        "pageNumber": 42, # Page number of the cited document, if applicable.
+                        "source": "A String", # Source attributed for a portion of the text.
+                      },
+                      "placeCitation": { # A place citation annotation. # A place citation annotation.
+                        "name": "A String", # Title of the place.
+                        "placeId": "A String", # The ID of the place, in `places/{place_id}` format.
+                        "reviewSnippets": [ # Snippets of reviews that are used to generate answers about the features of a given place in Google Maps.
+                          { # Encapsulates a snippet of a user review that answers a question about the features of a specific place in Google Maps.
+                            "reviewId": "A String", # The ID of the review snippet.
+                            "title": "A String", # Title of the review.
+                            "url": "A String", # A link that corresponds to the user review on Google Maps.
+                          },
+                        ],
+                        "url": "A String", # URI reference of the place.
+                      },
+                      "speechMetadata": { # Speech annotation for text content. # Speech annotation for text content.
+                        "speaker": "A String", # The speaker to associate with this turn.
+                        "style": "A String", # Style instruction for the speech synthesis.
+                      },
+                      "startIndex": 42, # Start of segment of the response that is attributed to this source. Index indicates the start of the segment, measured in bytes.
+                      "urlCitation": { # A URL citation annotation. # NOTE: We use these instead of the Citation message for historical reasons. A URL citation annotation.
+                        "title": "A String", # The title of the URL.
+                        "url": "A String", # The URL.
+                      },
+                      "wordInfo": { # Word-level ASR annotation for transcription output. Carries the word text, optional timing, and optional speaker attribution. # Word-level ASR annotation with timing and speaker info.
+                        "endOffset": "A String", # End offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                        "speaker": "A String", # Optional. Speaker label for this word (e.g. "spk_1", "spk_2"). Present when diarization_mode is set in TranscriptionConfig.
+                        "startOffset": "A String", # Start offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                        "text": "A String", # The transcribed word.
+                      },
+                    },
+                  ],
+                  "text": "A String", # Required. The text content.
+                },
+                "video": { # A video content block.
+                  "data": "A String", # The video content.
+                  "mimeTypeString": "A String", # Flexible MIME type string of the video, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                  "name": "A String", # A user-defined name for this content block. Can be referenced by the model in the final response.
+                  "processingConfig": {
+                    "static": {
+                      "endOffset": "A String", # Optional. Segment end time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "30s". Must be non-negative and greater than `start_offset` if `start_offset` is set.
+                      "fps": 3.14, # Optional. Video frame-rate sampling density.
+                      "startOffset": "A String", # Optional. Segment start time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "10.5s". Must be non-negative.
+                    },
+                  },
+                  "processingType": "A String",
+                  "resolution": "A String", # The resolution of the media.
+                  "uri": "A String", # The URI of the video.
+                },
+              },
+              "listValue": { # `ListValue` is a wrapper around a repeated field of values. # Represents a repeated `Value`.
+                "values": [ # Repeated field of dynamically typed values.
+                  # Object with schema name: GenaiVertexV1Value
+                ],
+              },
+              "nullValue": "A String", # Represents a null value.
+              "numberValue": 3.14, # Represents a double value.
+              "stringValue": "A String", # Represents a string value.
+              "structValue": # Object with schema name: GenaiVertexV1Struct # Represents a structured value.
+            },
+          },
+          "googleMaps": { # A tool that can be used by the model to call Google Maps. # A tool that can be used by the model to search Google Maps.
+            "enableWidget": True or False, # Whether to return a widget context token in the tool call result of the response.
+            "latitude": 3.14, # The latitude of the user's location.
+            "longitude": 3.14, # The longitude of the user's location.
+          },
+          "googleSearch": { # A tool that can be used by the model to search Google. # A tool that can be used by the model to search Google.
+            "searchTypes": [ # The types of search grounding to enable.
+              "A String",
+            ],
+          },
+          "mcpServer": { # A MCPServer is a server that can be called by the model to perform actions. # A MCPServer is a server that can be called by the model to perform actions.
+            "allowedTools": [ # The allowed tools.
+              { # The configuration for allowed tools.
+                "mode": "A String", # The mode of the tool choice.
+                "tools": [ # The names of the allowed tools.
+                  "A String",
+                ],
+              },
+            ],
+            "headers": { # Optional: Fields for authentication headers, timeouts, etc., if needed.
+              "a_key": "A String",
+            },
+            "name": "A String", # The name of the MCPServer.
+            "url": "A String", # The full URL for the MCPServer endpoint. Example: "https://api.example.com/mcp"
+          },
+          "retrieval": { # A tool that can be used by the model to retrieve files. # A tool that can be used by the model to retrieve files.
+            "exaAiSearchConfig": { # Used to specify configuration for ExaAISearch. # Used to specify configuration for ExaAISearch.
+              "apiKey": "A String", # Required. The API key for ExaAiSearch.
+              "customConfig": { # Optional. This field can be used to pass any parameter from the Exa.ai Search API.
+                "a_key": "", # Properties of the object.
+              },
+            },
+            "parallelAiSearchConfig": { # Used to specify configuration for ParallelAISearch. # Used to specify configuration for ParallelAISearch.
+              "apiKey": "A String", # Optional. The API key for ParallelAiSearch.
+              "customConfig": { # Optional. Custom configs for ParallelAiSearch.
+                "a_key": "", # Properties of the object.
+              },
+            },
+            "ragStoreConfig": { # Use to specify configuration for RAG Store. # Used to specify configuration for RagStore.
+              "ragResources": [ # Optional. The representation of the rag source.
+                { # The definition of the Rag resource.
+                  "ragCorpus": "A String", # Optional. RagCorpora resource name.
+                  "ragFileIds": [ # Optional. rag_file_id. The files should be in the same rag_corpus set in rag_corpus field.
+                    "A String",
+                  ],
+                },
+              ],
+              "ragRetrievalConfig": { # Specifies the context retrieval config. # Optional. The retrieval config for the Rag query.
+                "filter": { # Config for filters. # Optional. Config for filters.
+                  "metadataFilter": "A String", # Optional. String for metadata filtering.
+                  "vectorDistanceThreshold": 3.14, # Optional. Only returns contexts with vector distance smaller than the threshold.
+                  "vectorSimilarityThreshold": 3.14, # Optional. Only returns contexts with vector similarity larger than the threshold.
+                },
+                "hybridSearch": { # Config for Hybrid Search. # Optional. Config for Hybrid Search.
+                  "alpha": 3.14, # Optional. Alpha value controls the weight between dense and sparse vector search results.
+                },
+                "ranking": { # Config for ranking and reranking. # Optional. Config for ranking and reranking.
+                  "rankService": { # Config for Rank Service. # Config for Rank Service.
+                    "modelName": "A String", # Optional. The model name of the rank service.
+                  },
+                },
+                "topK": 42, # Optional. The number of contexts to retrieve.
+              },
+            },
+            "retrievalTypes": [ # The types of file retrieval to enable.
+              "A String",
+            ],
+            "vertexAiSearchConfig": { # Used to specify configuration for VertexAISearch. # Used to specify configuration for VertexAISearch.
+              "datastores": [ # Optional. Used to specify Vertex AI Search datastores.
+                "A String",
+              ],
+              "engine": "A String", # Optional. Used to specify Vertex AI Search engine.
+            },
+          },
+          "urlContext": { # A tool that can be used by the model to fetch URL context. # A tool that can be used by the model to fetch URL context.
+          },
+        },
+      ],
+      "updated": "A String", # Required. Output only. The time at which the response was last updated in ISO 8601 format (YYYY-MM-DDThh:mm:ssZ).
+      "usage": { # Statistics on the interaction request's token usage. # Output only. Statistics on the interaction request's token usage.
+        "cachedTokensByModality": [ # A breakdown of cached token usage by modality.
+          { # The token count for a single response modality.
+            "modality": "A String", # The modality associated with the token count.
+            "tokens": 42, # Number of tokens for the modality.
+          },
+        ],
+        "groundingToolCount": [ # Grounding tool count.
+          { # The number of grounding tool counts.
+            "count": 42, # The number of grounding tool counts.
+            "type": "A String", # The grounding tool type associated with the count.
+          },
+        ],
+        "inputTokensByModality": [ # A breakdown of input token usage by modality.
+          { # The token count for a single response modality.
+            "modality": "A String", # The modality associated with the token count.
+            "tokens": 42, # Number of tokens for the modality.
+          },
+        ],
+        "outputTokensByModality": [ # A breakdown of output token usage by modality.
+          { # The token count for a single response modality.
+            "modality": "A String", # The modality associated with the token count.
+            "tokens": 42, # Number of tokens for the modality.
+          },
+        ],
+        "toolUseTokensByModality": [ # A breakdown of tool-use token usage by modality.
+          { # The token count for a single response modality.
+            "modality": "A String", # The modality associated with the token count.
+            "tokens": 42, # Number of tokens for the modality.
+          },
+        ],
+        "totalCachedTokens": 42, # Number of tokens in the cached part of the prompt (the cached content).
+        "totalInputTokens": 42, # Number of tokens in the prompt (context).
+        "totalOutputTokens": 42, # Total number of tokens across all the generated responses.
+        "totalThoughtTokens": 42, # Number of tokens of thoughts for thinking models.
+        "totalTokens": 42, # Total token count for the interaction request (prompt + responses + other internal tokens).
+        "totalToolUseTokens": 42, # Number of tokens present in tool-use prompt(s).
+      },
+    },
+  },
+  "interactionCreatedEvent": { # Server response confirming that a new interaction was created. # The interaction data, used for interaction.created events. Used when steps are enabled.
+    "interaction": { # Response for InteractionService.CreateInteraction. # Required. Partial interaction resource emitted when the stream is created.
+      "agentInteraction": { # Interaction for generating the completion using agents. # Interaction for generating the completion using agents.
+        "agent": "A String", # The name of the `Agent` used for generating the completion.
+        "antigravityConfig": { # Configuration for the Antigravity agent runtime. Provides server-side control over the agent's execution environment and tool configuration. # Antigravity agent configuration. This configuration is session-level settings that are passed to the agent runtime on a per-request basis.
+          "maxTotalTokens": "A String", # Max total tokens for the agent run.
+          "model": "A String", # The model to use for agent reasoning.
+        },
+        "codeMenderConfig": { # Configuration for the CodeMender agent.
+          "findRequest": { # Request parameters specific to FIND sessions, used for discovering vulnerabilities in a codebase. # Parameters for finding vulnerabilities.
+            "description": "A String", # Additional context or custom instructions provided by the user to guide the vulnerability analysis.
+            "findingId": "A String", # The identifier of a specific finding to verify. This is primarily used in VERIFY mode to focus the agent's execution-based validation on a single vulnerability.
+            "mode": "A String", # The mode of the find session.
+            "sourceFiles": [ # A list of source files to provide as context for the scan.
+              { # Content of a single file in the codebase.
+                "content": "A String", # The UTF-8 encoded text content of the file.
+                "path": "A String", # The relative path of the file from the project root.
+              },
+            ],
+          },
+          "fixRequest": { # Request parameters specific to FIX sessions, used for generating and validating security patches. # Parameters for fixing vulnerabilities.
+            "description": "A String", # Additional context or custom instructions provided by the user to guide the patch generation process.
+            "findingId": "A String", # The identifier of the specific security finding to be remediated. This ID maps to a previously discovered vulnerability.
+            "sourceFiles": [ # A list of source files providing context for the remediation. These files are typically the ones containing the identified vulnerability.
+              { # Content of a single file in the codebase.
+                "content": "A String", # The UTF-8 encoded text content of the file.
+                "path": "A String", # The relative path of the file from the project root.
+              },
+            ],
+          },
+          "model": "A String", # The name of the model to use for the CodeMender agent. One CodeMender session will only use one model.
+          "sessionConfig": { # The configuration of CodeMender sessions. # Optional session-specific configurations to override default agent behavior.
+            "maxRounds": 42, # The maximum number of interaction rounds the agent is allowed to perform before reaching a timeout.
+          },
+          "sessionId": "A String", # Parameter for grouping multiple interactions that belong to the same CodeMender session.
+        },
+        "deepResearchConfig": { # Configuration for the Deep Research agent.
+          "collaborativePlanning": True or False, # Enables human-in-the-loop planning for the Deep Research agent. If set to true, the Deep Research agent will provide a research plan in its response. The agent will then proceed only if the user confirms the plan in the next turn.
+          "enableBigqueryTool": True or False, # Enables bigquery tool for the Deep Research agent.
+          "thinkingSummaries": "A String", # Whether to include thought summaries in the response.
+          "visualization": "A String", # Whether to include visualizations in the response.
+        },
+        "dynamicConfig": { # Configuration for dynamic agents.
+          "config": { # `Struct` represents a structured data value, consisting of fields which map to dynamically typed values. # For agents that are not supported statically in the API definition.
+            "fields": [ # Dynamically typed fields. List instead of map because LLMs are sensitive to ordering, and we want to give users full control.
+              { # Represents a single field in a struct.
+                "name": "A String",
+                "value": { # `Value` represents a dynamically typed value which can be either null, a number, a string, a boolean, a recursive struct value, or a list of values. A producer of value is expected to set one of these variants. Absence of any variant indicates an error.
+                  "boolValue": True or False, # Represents a boolean value.
+                  "contentValue": { # The content of the response. # Represents rich content (text, image, etc.).
+                    "audio": { # An audio content block.
+                      "channels": 42, # The number of audio channels.
+                      "data": "A String", # The audio content.
+                      "mimeTypeString": "A String", # Flexible MIME type string of the audio, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                      "sampleRate": 42, # The sample rate of the audio.
+                      "uri": "A String", # The URI of the audio.
+                    },
+                    "document": { # A document content block.
+                      "data": "A String", # The document content.
+                      "mimeTypeString": "A String", # Flexible MIME type string of the document, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                      "uri": "A String", # The URI of the document.
+                    },
+                    "image": { # An image content block.
+                      "data": "A String", # The image content.
+                      "mimeTypeString": "A String", # Flexible MIME type string of the image, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                      "resolution": "A String", # The resolution of the media.
+                      "uri": "A String", # The URI of the image.
+                    },
+                    "text": { # A text content block.
+                      "annotations": [ # Citation information for model-generated content.
+                        { # Citation information for model-generated content.
+                          "endIndex": 42, # End of the attributed segment, exclusive.
+                          "fileCitation": { # A file citation annotation. # A file citation annotation.
+                            "customMetadata": { # User provided metadata about the retrieved context.
+                              "a_key": "", # Properties of the object.
+                            },
+                            "documentUri": "A String", # The URI of the file.
+                            "fileName": "A String", # The name of the file.
+                            "mediaId": "A String", # Media ID in-case of image citations, if applicable.
+                            "pageNumber": 42, # Page number of the cited document, if applicable.
+                            "source": "A String", # Source attributed for a portion of the text.
+                          },
+                          "placeCitation": { # A place citation annotation. # A place citation annotation.
+                            "name": "A String", # Title of the place.
+                            "placeId": "A String", # The ID of the place, in `places/{place_id}` format.
+                            "reviewSnippets": [ # Snippets of reviews that are used to generate answers about the features of a given place in Google Maps.
+                              { # Encapsulates a snippet of a user review that answers a question about the features of a specific place in Google Maps.
+                                "reviewId": "A String", # The ID of the review snippet.
+                                "title": "A String", # Title of the review.
+                                "url": "A String", # A link that corresponds to the user review on Google Maps.
+                              },
+                            ],
+                            "url": "A String", # URI reference of the place.
+                          },
+                          "speechMetadata": { # Speech annotation for text content. # Speech annotation for text content.
+                            "speaker": "A String", # The speaker to associate with this turn.
+                            "style": "A String", # Style instruction for the speech synthesis.
+                          },
+                          "startIndex": 42, # Start of segment of the response that is attributed to this source. Index indicates the start of the segment, measured in bytes.
+                          "urlCitation": { # A URL citation annotation. # NOTE: We use these instead of the Citation message for historical reasons. A URL citation annotation.
+                            "title": "A String", # The title of the URL.
+                            "url": "A String", # The URL.
+                          },
+                          "wordInfo": { # Word-level ASR annotation for transcription output. Carries the word text, optional timing, and optional speaker attribution. # Word-level ASR annotation with timing and speaker info.
+                            "endOffset": "A String", # End offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                            "speaker": "A String", # Optional. Speaker label for this word (e.g. "spk_1", "spk_2"). Present when diarization_mode is set in TranscriptionConfig.
+                            "startOffset": "A String", # Start offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                            "text": "A String", # The transcribed word.
+                          },
+                        },
+                      ],
+                      "text": "A String", # Required. The text content.
+                    },
+                    "video": { # A video content block.
+                      "data": "A String", # The video content.
+                      "mimeTypeString": "A String", # Flexible MIME type string of the video, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                      "name": "A String", # A user-defined name for this content block. Can be referenced by the model in the final response.
+                      "processingConfig": {
+                        "static": {
+                          "endOffset": "A String", # Optional. Segment end time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "30s". Must be non-negative and greater than `start_offset` if `start_offset` is set.
+                          "fps": 3.14, # Optional. Video frame-rate sampling density.
+                          "startOffset": "A String", # Optional. Segment start time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "10.5s". Must be non-negative.
+                        },
+                      },
+                      "processingType": "A String",
+                      "resolution": "A String", # The resolution of the media.
+                      "uri": "A String", # The URI of the video.
+                    },
+                  },
+                  "listValue": { # `ListValue` is a wrapper around a repeated field of values. # Represents a repeated `Value`.
+                    "values": [ # Repeated field of dynamically typed values.
+                      # Object with schema name: GenaiVertexV1Value
+                    ],
+                  },
+                  "nullValue": "A String", # Represents a null value.
+                  "numberValue": 3.14, # Represents a double value.
+                  "stringValue": "A String", # Represents a string value.
+                  "structValue": # Object with schema name: GenaiVertexV1Struct # Represents a structured value.
+                },
+              },
+            ],
+          },
+        },
+      },
+      "content": { # The content of the response. # The content for the interaction.
+        "audio": { # An audio content block.
+          "channels": 42, # The number of audio channels.
+          "data": "A String", # The audio content.
+          "mimeTypeString": "A String", # Flexible MIME type string of the audio, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+          "sampleRate": 42, # The sample rate of the audio.
+          "uri": "A String", # The URI of the audio.
+        },
+        "document": { # A document content block.
+          "data": "A String", # The document content.
+          "mimeTypeString": "A String", # Flexible MIME type string of the document, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+          "uri": "A String", # The URI of the document.
+        },
+        "image": { # An image content block.
+          "data": "A String", # The image content.
+          "mimeTypeString": "A String", # Flexible MIME type string of the image, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+          "resolution": "A String", # The resolution of the media.
+          "uri": "A String", # The URI of the image.
+        },
+        "text": { # A text content block.
+          "annotations": [ # Citation information for model-generated content.
+            { # Citation information for model-generated content.
+              "endIndex": 42, # End of the attributed segment, exclusive.
+              "fileCitation": { # A file citation annotation. # A file citation annotation.
+                "customMetadata": { # User provided metadata about the retrieved context.
+                  "a_key": "", # Properties of the object.
+                },
+                "documentUri": "A String", # The URI of the file.
+                "fileName": "A String", # The name of the file.
+                "mediaId": "A String", # Media ID in-case of image citations, if applicable.
+                "pageNumber": 42, # Page number of the cited document, if applicable.
+                "source": "A String", # Source attributed for a portion of the text.
+              },
+              "placeCitation": { # A place citation annotation. # A place citation annotation.
+                "name": "A String", # Title of the place.
+                "placeId": "A String", # The ID of the place, in `places/{place_id}` format.
+                "reviewSnippets": [ # Snippets of reviews that are used to generate answers about the features of a given place in Google Maps.
+                  { # Encapsulates a snippet of a user review that answers a question about the features of a specific place in Google Maps.
+                    "reviewId": "A String", # The ID of the review snippet.
+                    "title": "A String", # Title of the review.
+                    "url": "A String", # A link that corresponds to the user review on Google Maps.
+                  },
+                ],
+                "url": "A String", # URI reference of the place.
+              },
+              "speechMetadata": { # Speech annotation for text content. # Speech annotation for text content.
+                "speaker": "A String", # The speaker to associate with this turn.
+                "style": "A String", # Style instruction for the speech synthesis.
+              },
+              "startIndex": 42, # Start of segment of the response that is attributed to this source. Index indicates the start of the segment, measured in bytes.
+              "urlCitation": { # A URL citation annotation. # NOTE: We use these instead of the Citation message for historical reasons. A URL citation annotation.
+                "title": "A String", # The title of the URL.
+                "url": "A String", # The URL.
+              },
+              "wordInfo": { # Word-level ASR annotation for transcription output. Carries the word text, optional timing, and optional speaker attribution. # Word-level ASR annotation with timing and speaker info.
+                "endOffset": "A String", # End offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                "speaker": "A String", # Optional. Speaker label for this word (e.g. "spk_1", "spk_2"). Present when diarization_mode is set in TranscriptionConfig.
+                "startOffset": "A String", # Start offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                "text": "A String", # The transcribed word.
+              },
+            },
+          ],
+          "text": "A String", # Required. The text content.
+        },
+        "video": { # A video content block.
+          "data": "A String", # The video content.
+          "mimeTypeString": "A String", # Flexible MIME type string of the video, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+          "name": "A String", # A user-defined name for this content block. Can be referenced by the model in the final response.
+          "processingConfig": {
+            "static": {
+              "endOffset": "A String", # Optional. Segment end time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "30s". Must be non-negative and greater than `start_offset` if `start_offset` is set.
+              "fps": 3.14, # Optional. Video frame-rate sampling density.
+              "startOffset": "A String", # Optional. Segment start time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "10.5s". Must be non-negative.
+            },
+          },
+          "processingType": "A String",
+          "resolution": "A String", # The resolution of the media.
+          "uri": "A String", # The URI of the video.
+        },
+      },
+      "created": "A String", # Required. Output only. The time at which the response was created in ISO 8601 format (YYYY-MM-DDThh:mm:ssZ).
+      "envId": "A String", # The environment ID for the interaction. Can be 'remote' for default environment.
+      "environmentId": "A String", # Output only. The environment ID for the interaction. Only populated if environment config is set in the request.
+      "errors": [ # Output only. Diagnostic faults / platform errors recorded on the interaction.
+        { # Error message from an interaction.
+          "code": "A String", # A URI that identifies the error type.
+          "message": "A String", # A human-readable error message.
+        },
+      ],
+      "id": "A String", # Required. Output only. A unique identifier for the interaction completion.
+      "labels": { # The labels with user-defined metadata for the request. 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",
+      },
+      "modelInteraction": { # Interaction for generating the completion using models. # Interaction for generating the completion using models.
+        "generationConfig": { # Configuration parameters for model interactions. # Input only. Configuration parameters for the model interaction.
+          "maxOutputTokens": 42, # The maximum number of tokens to include in the response.
+          "seed": 42, # Seed used in decoding for reproducibility.
+          "stopSequences": [ # A list of character sequences that will stop output interaction.
+            "A String",
+          ],
+          "structuredSpeechConfig": { # Configuration for multi-speaker and speech generation. # Speech and multi-speaker configuration.
+            "speakers": [ # Individual speaker configurations.
+              { # The configuration for speech interaction.
+                "language": "A String", # The language of the speech.
+                "speaker": "A String", # The speaker's name, it should match the speaker name given in the prompt.
+                "voice": "A String", # The voice of the speaker.
+              },
+            ],
+          },
+          "temperature": 3.14, # Controls the randomness of the output.
+          "thinkingLevel": "A String", # The level of thought tokens that the model should generate.
+          "thinkingSummaries": "A String", # Whether to include thought summaries in the response.
+          "toolChoiceConfig": { # The tool choice configuration containing allowed tools. # The config for the tool choice.
+            "allowedTools": { # The configuration for allowed tools. # The allowed tools.
+              "mode": "A String", # The mode of the tool choice.
+              "tools": [ # The names of the allowed tools.
+                "A String",
+              ],
+            },
+          },
+          "toolChoiceMode": "A String", # The mode of the tool choice.
+          "topP": 3.14, # The maximum cumulative probability of tokens to consider when sampling.
+          "transcriptionConfig": { # Configuration for speech recognition (transcription). # Optional. Configuration for speech recognition (transcription). If present, ASR is enabled.
+            "adaptationPhrases": [ # Optional. A list of phrases to bias the ASR model towards.
+              "A String",
+            ],
+            "customVocabulary": [ # Optional. A list of custom vocabulary phrases to bias the speech recognition model toward recognizing specific terms.
+              "A String",
+            ],
+            "diarizationMode": "A String", # Optional. Configures speaker diarization. Supported values: "speaker".
+            "languageCodes": [ # Optional. BCP-47 language codes providing hints about the languages present in the audio. If omitted or empty, defaults to automatic language detection.
+              "A String",
+            ],
+            "timestampGranularities": [ # Optional. The granularity of timestamps to include in the transcription output. Supported values: "word". If empty, no timestamps are generated.
+              "A String",
+            ],
+          },
+          "videoConfig": { # Configuration options for video generation. # Configuration for video generation.
+            "task": "A String", # Optional task mode for video generation. If not specified, the model automatically determines the appropriate mode based on the provided text prompt and input media.
+          },
+        },
+        "model": "A String", # The name of the `Model` used for generating the completion.
+      },
+      "previousInteractionId": "A String", # The ID of the previous interaction, if any.
+      "responseFormatList": {
+        "responseFormats": [
+          {
+            "audio": { # Configuration for audio output format.
+              "bitRate": 42, # Bit rate in bits per second (bps). Only applicable for compressed formats (MP3, Opus).
+              "delivery": "A String", # The delivery mode for the audio output.
+              "mimeType": "A String", # The MIME type of the audio output.
+              "sampleRate": 42, # Sample rate in Hz.
+            },
+            "image": { # Configuration for image output format.
+              "aspectRatio": "A String", # The aspect ratio for the image output.
+              "delivery": "A String", # The delivery mode for the image output.
+              "imageSize": "A String", # The size of the image output.
+              "mimeType": "A String", # The MIME type of the image output.
+            },
+            "structValue": { # `Struct` represents a structured data value, consisting of fields which map to dynamically typed values. # Multi-discriminator values is already enabled in GAOS
+              "fields": [ # Dynamically typed fields. List instead of map because LLMs are sensitive to ordering, and we want to give users full control.
+                { # Represents a single field in a struct.
+                  "name": "A String",
+                  "value": { # `Value` represents a dynamically typed value which can be either null, a number, a string, a boolean, a recursive struct value, or a list of values. A producer of value is expected to set one of these variants. Absence of any variant indicates an error.
+                    "boolValue": True or False, # Represents a boolean value.
+                    "contentValue": { # The content of the response. # Represents rich content (text, image, etc.).
+                      "audio": { # An audio content block.
+                        "channels": 42, # The number of audio channels.
+                        "data": "A String", # The audio content.
+                        "mimeTypeString": "A String", # Flexible MIME type string of the audio, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                        "sampleRate": 42, # The sample rate of the audio.
+                        "uri": "A String", # The URI of the audio.
+                      },
+                      "document": { # A document content block.
+                        "data": "A String", # The document content.
+                        "mimeTypeString": "A String", # Flexible MIME type string of the document, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                        "uri": "A String", # The URI of the document.
+                      },
+                      "image": { # An image content block.
+                        "data": "A String", # The image content.
+                        "mimeTypeString": "A String", # Flexible MIME type string of the image, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                        "resolution": "A String", # The resolution of the media.
+                        "uri": "A String", # The URI of the image.
+                      },
+                      "text": { # A text content block.
+                        "annotations": [ # Citation information for model-generated content.
+                          { # Citation information for model-generated content.
+                            "endIndex": 42, # End of the attributed segment, exclusive.
+                            "fileCitation": { # A file citation annotation. # A file citation annotation.
+                              "customMetadata": { # User provided metadata about the retrieved context.
+                                "a_key": "", # Properties of the object.
+                              },
+                              "documentUri": "A String", # The URI of the file.
+                              "fileName": "A String", # The name of the file.
+                              "mediaId": "A String", # Media ID in-case of image citations, if applicable.
+                              "pageNumber": 42, # Page number of the cited document, if applicable.
+                              "source": "A String", # Source attributed for a portion of the text.
+                            },
+                            "placeCitation": { # A place citation annotation. # A place citation annotation.
+                              "name": "A String", # Title of the place.
+                              "placeId": "A String", # The ID of the place, in `places/{place_id}` format.
+                              "reviewSnippets": [ # Snippets of reviews that are used to generate answers about the features of a given place in Google Maps.
+                                { # Encapsulates a snippet of a user review that answers a question about the features of a specific place in Google Maps.
+                                  "reviewId": "A String", # The ID of the review snippet.
+                                  "title": "A String", # Title of the review.
+                                  "url": "A String", # A link that corresponds to the user review on Google Maps.
+                                },
+                              ],
+                              "url": "A String", # URI reference of the place.
+                            },
+                            "speechMetadata": { # Speech annotation for text content. # Speech annotation for text content.
+                              "speaker": "A String", # The speaker to associate with this turn.
+                              "style": "A String", # Style instruction for the speech synthesis.
+                            },
+                            "startIndex": 42, # Start of segment of the response that is attributed to this source. Index indicates the start of the segment, measured in bytes.
+                            "urlCitation": { # A URL citation annotation. # NOTE: We use these instead of the Citation message for historical reasons. A URL citation annotation.
+                              "title": "A String", # The title of the URL.
+                              "url": "A String", # The URL.
+                            },
+                            "wordInfo": { # Word-level ASR annotation for transcription output. Carries the word text, optional timing, and optional speaker attribution. # Word-level ASR annotation with timing and speaker info.
+                              "endOffset": "A String", # End offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                              "speaker": "A String", # Optional. Speaker label for this word (e.g. "spk_1", "spk_2"). Present when diarization_mode is set in TranscriptionConfig.
+                              "startOffset": "A String", # Start offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                              "text": "A String", # The transcribed word.
+                            },
+                          },
+                        ],
+                        "text": "A String", # Required. The text content.
+                      },
+                      "video": { # A video content block.
+                        "data": "A String", # The video content.
+                        "mimeTypeString": "A String", # Flexible MIME type string of the video, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                        "name": "A String", # A user-defined name for this content block. Can be referenced by the model in the final response.
+                        "processingConfig": {
+                          "static": {
+                            "endOffset": "A String", # Optional. Segment end time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "30s". Must be non-negative and greater than `start_offset` if `start_offset` is set.
+                            "fps": 3.14, # Optional. Video frame-rate sampling density.
+                            "startOffset": "A String", # Optional. Segment start time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "10.5s". Must be non-negative.
+                          },
+                        },
+                        "processingType": "A String",
+                        "resolution": "A String", # The resolution of the media.
+                        "uri": "A String", # The URI of the video.
+                      },
+                    },
+                    "listValue": { # `ListValue` is a wrapper around a repeated field of values. # Represents a repeated `Value`.
+                      "values": [ # Repeated field of dynamically typed values.
+                        # Object with schema name: GenaiVertexV1Value
+                      ],
+                    },
+                    "nullValue": "A String", # Represents a null value.
+                    "numberValue": 3.14, # Represents a double value.
+                    "stringValue": "A String", # Represents a string value.
+                    "structValue": # Object with schema name: GenaiVertexV1Struct # Represents a structured value.
+                  },
+                },
+              ],
+            },
+            "text": { # Configuration for text output format.
+              "mimeType": "A String", # The MIME type of the text output.
+              "schema": { # `Struct` represents a structured data value, consisting of fields which map to dynamically typed values. # The JSON schema that the output should conform to. Only applicable when mime_type is application/json.
+                "fields": [ # Dynamically typed fields. List instead of map because LLMs are sensitive to ordering, and we want to give users full control.
+                  { # Represents a single field in a struct.
+                    "name": "A String",
+                    "value": { # `Value` represents a dynamically typed value which can be either null, a number, a string, a boolean, a recursive struct value, or a list of values. A producer of value is expected to set one of these variants. Absence of any variant indicates an error.
+                      "boolValue": True or False, # Represents a boolean value.
+                      "contentValue": { # The content of the response. # Represents rich content (text, image, etc.).
+                        "audio": { # An audio content block.
+                          "channels": 42, # The number of audio channels.
+                          "data": "A String", # The audio content.
+                          "mimeTypeString": "A String", # Flexible MIME type string of the audio, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                          "sampleRate": 42, # The sample rate of the audio.
+                          "uri": "A String", # The URI of the audio.
+                        },
+                        "document": { # A document content block.
+                          "data": "A String", # The document content.
+                          "mimeTypeString": "A String", # Flexible MIME type string of the document, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                          "uri": "A String", # The URI of the document.
+                        },
+                        "image": { # An image content block.
+                          "data": "A String", # The image content.
+                          "mimeTypeString": "A String", # Flexible MIME type string of the image, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                          "resolution": "A String", # The resolution of the media.
+                          "uri": "A String", # The URI of the image.
+                        },
+                        "text": { # A text content block.
+                          "annotations": [ # Citation information for model-generated content.
+                            { # Citation information for model-generated content.
+                              "endIndex": 42, # End of the attributed segment, exclusive.
+                              "fileCitation": { # A file citation annotation. # A file citation annotation.
+                                "customMetadata": { # User provided metadata about the retrieved context.
+                                  "a_key": "", # Properties of the object.
+                                },
+                                "documentUri": "A String", # The URI of the file.
+                                "fileName": "A String", # The name of the file.
+                                "mediaId": "A String", # Media ID in-case of image citations, if applicable.
+                                "pageNumber": 42, # Page number of the cited document, if applicable.
+                                "source": "A String", # Source attributed for a portion of the text.
+                              },
+                              "placeCitation": { # A place citation annotation. # A place citation annotation.
+                                "name": "A String", # Title of the place.
+                                "placeId": "A String", # The ID of the place, in `places/{place_id}` format.
+                                "reviewSnippets": [ # Snippets of reviews that are used to generate answers about the features of a given place in Google Maps.
+                                  { # Encapsulates a snippet of a user review that answers a question about the features of a specific place in Google Maps.
+                                    "reviewId": "A String", # The ID of the review snippet.
+                                    "title": "A String", # Title of the review.
+                                    "url": "A String", # A link that corresponds to the user review on Google Maps.
+                                  },
+                                ],
+                                "url": "A String", # URI reference of the place.
+                              },
+                              "speechMetadata": { # Speech annotation for text content. # Speech annotation for text content.
+                                "speaker": "A String", # The speaker to associate with this turn.
+                                "style": "A String", # Style instruction for the speech synthesis.
+                              },
+                              "startIndex": 42, # Start of segment of the response that is attributed to this source. Index indicates the start of the segment, measured in bytes.
+                              "urlCitation": { # A URL citation annotation. # NOTE: We use these instead of the Citation message for historical reasons. A URL citation annotation.
+                                "title": "A String", # The title of the URL.
+                                "url": "A String", # The URL.
+                              },
+                              "wordInfo": { # Word-level ASR annotation for transcription output. Carries the word text, optional timing, and optional speaker attribution. # Word-level ASR annotation with timing and speaker info.
+                                "endOffset": "A String", # End offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                                "speaker": "A String", # Optional. Speaker label for this word (e.g. "spk_1", "spk_2"). Present when diarization_mode is set in TranscriptionConfig.
+                                "startOffset": "A String", # Start offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                                "text": "A String", # The transcribed word.
+                              },
+                            },
+                          ],
+                          "text": "A String", # Required. The text content.
+                        },
+                        "video": { # A video content block.
+                          "data": "A String", # The video content.
+                          "mimeTypeString": "A String", # Flexible MIME type string of the video, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                          "name": "A String", # A user-defined name for this content block. Can be referenced by the model in the final response.
+                          "processingConfig": {
+                            "static": {
+                              "endOffset": "A String", # Optional. Segment end time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "30s". Must be non-negative and greater than `start_offset` if `start_offset` is set.
+                              "fps": 3.14, # Optional. Video frame-rate sampling density.
+                              "startOffset": "A String", # Optional. Segment start time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "10.5s". Must be non-negative.
+                            },
+                          },
+                          "processingType": "A String",
+                          "resolution": "A String", # The resolution of the media.
+                          "uri": "A String", # The URI of the video.
+                        },
+                      },
+                      "listValue": { # `ListValue` is a wrapper around a repeated field of values. # Represents a repeated `Value`.
+                        "values": [ # Repeated field of dynamically typed values.
+                          # Object with schema name: GenaiVertexV1Value
+                        ],
+                      },
+                      "nullValue": "A String", # Represents a null value.
+                      "numberValue": 3.14, # Represents a double value.
+                      "stringValue": "A String", # Represents a string value.
+                      "structValue": # Object with schema name: GenaiVertexV1Struct # Represents a structured value.
+                    },
+                  },
+                ],
+              },
+            },
+            "video": { # Configuration for video output format.
+              "aspectRatio": "A String", # The aspect ratio for the video output.
+              "delivery": "A String", # The delivery mode for the video output.
+              "duration": "A String", # The duration for the video output.
+              "gcsUri": "A String", # The Cloud Storage URI to store the video output. Required for Vertex if delivery mode is URI.
+              "resolution": "A String", # The video output resolution. Defaults to 720p.
+            },
+          },
+        ],
+      },
+      "responseFormatSingleton": {
+        "audio": { # Configuration for audio output format.
+          "bitRate": 42, # Bit rate in bits per second (bps). Only applicable for compressed formats (MP3, Opus).
+          "delivery": "A String", # The delivery mode for the audio output.
+          "mimeType": "A String", # The MIME type of the audio output.
+          "sampleRate": 42, # Sample rate in Hz.
+        },
+        "image": { # Configuration for image output format.
+          "aspectRatio": "A String", # The aspect ratio for the image output.
+          "delivery": "A String", # The delivery mode for the image output.
+          "imageSize": "A String", # The size of the image output.
+          "mimeType": "A String", # The MIME type of the image output.
+        },
+        "structValue": { # `Struct` represents a structured data value, consisting of fields which map to dynamically typed values. # Multi-discriminator values is already enabled in GAOS
+          "fields": [ # Dynamically typed fields. List instead of map because LLMs are sensitive to ordering, and we want to give users full control.
+            { # Represents a single field in a struct.
+              "name": "A String",
+              "value": { # `Value` represents a dynamically typed value which can be either null, a number, a string, a boolean, a recursive struct value, or a list of values. A producer of value is expected to set one of these variants. Absence of any variant indicates an error.
+                "boolValue": True or False, # Represents a boolean value.
+                "contentValue": { # The content of the response. # Represents rich content (text, image, etc.).
+                  "audio": { # An audio content block.
+                    "channels": 42, # The number of audio channels.
+                    "data": "A String", # The audio content.
+                    "mimeTypeString": "A String", # Flexible MIME type string of the audio, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                    "sampleRate": 42, # The sample rate of the audio.
+                    "uri": "A String", # The URI of the audio.
+                  },
+                  "document": { # A document content block.
+                    "data": "A String", # The document content.
+                    "mimeTypeString": "A String", # Flexible MIME type string of the document, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                    "uri": "A String", # The URI of the document.
+                  },
+                  "image": { # An image content block.
+                    "data": "A String", # The image content.
+                    "mimeTypeString": "A String", # Flexible MIME type string of the image, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                    "resolution": "A String", # The resolution of the media.
+                    "uri": "A String", # The URI of the image.
+                  },
+                  "text": { # A text content block.
+                    "annotations": [ # Citation information for model-generated content.
+                      { # Citation information for model-generated content.
+                        "endIndex": 42, # End of the attributed segment, exclusive.
+                        "fileCitation": { # A file citation annotation. # A file citation annotation.
+                          "customMetadata": { # User provided metadata about the retrieved context.
+                            "a_key": "", # Properties of the object.
+                          },
+                          "documentUri": "A String", # The URI of the file.
+                          "fileName": "A String", # The name of the file.
+                          "mediaId": "A String", # Media ID in-case of image citations, if applicable.
+                          "pageNumber": 42, # Page number of the cited document, if applicable.
+                          "source": "A String", # Source attributed for a portion of the text.
+                        },
+                        "placeCitation": { # A place citation annotation. # A place citation annotation.
+                          "name": "A String", # Title of the place.
+                          "placeId": "A String", # The ID of the place, in `places/{place_id}` format.
+                          "reviewSnippets": [ # Snippets of reviews that are used to generate answers about the features of a given place in Google Maps.
+                            { # Encapsulates a snippet of a user review that answers a question about the features of a specific place in Google Maps.
+                              "reviewId": "A String", # The ID of the review snippet.
+                              "title": "A String", # Title of the review.
+                              "url": "A String", # A link that corresponds to the user review on Google Maps.
+                            },
+                          ],
+                          "url": "A String", # URI reference of the place.
+                        },
+                        "speechMetadata": { # Speech annotation for text content. # Speech annotation for text content.
+                          "speaker": "A String", # The speaker to associate with this turn.
+                          "style": "A String", # Style instruction for the speech synthesis.
+                        },
+                        "startIndex": 42, # Start of segment of the response that is attributed to this source. Index indicates the start of the segment, measured in bytes.
+                        "urlCitation": { # A URL citation annotation. # NOTE: We use these instead of the Citation message for historical reasons. A URL citation annotation.
+                          "title": "A String", # The title of the URL.
+                          "url": "A String", # The URL.
+                        },
+                        "wordInfo": { # Word-level ASR annotation for transcription output. Carries the word text, optional timing, and optional speaker attribution. # Word-level ASR annotation with timing and speaker info.
+                          "endOffset": "A String", # End offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                          "speaker": "A String", # Optional. Speaker label for this word (e.g. "spk_1", "spk_2"). Present when diarization_mode is set in TranscriptionConfig.
+                          "startOffset": "A String", # Start offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                          "text": "A String", # The transcribed word.
+                        },
+                      },
+                    ],
+                    "text": "A String", # Required. The text content.
+                  },
+                  "video": { # A video content block.
+                    "data": "A String", # The video content.
+                    "mimeTypeString": "A String", # Flexible MIME type string of the video, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                    "name": "A String", # A user-defined name for this content block. Can be referenced by the model in the final response.
+                    "processingConfig": {
+                      "static": {
+                        "endOffset": "A String", # Optional. Segment end time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "30s". Must be non-negative and greater than `start_offset` if `start_offset` is set.
+                        "fps": 3.14, # Optional. Video frame-rate sampling density.
+                        "startOffset": "A String", # Optional. Segment start time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "10.5s". Must be non-negative.
+                      },
+                    },
+                    "processingType": "A String",
+                    "resolution": "A String", # The resolution of the media.
+                    "uri": "A String", # The URI of the video.
+                  },
+                },
+                "listValue": { # `ListValue` is a wrapper around a repeated field of values. # Represents a repeated `Value`.
+                  "values": [ # Repeated field of dynamically typed values.
+                    # Object with schema name: GenaiVertexV1Value
+                  ],
+                },
+                "nullValue": "A String", # Represents a null value.
+                "numberValue": 3.14, # Represents a double value.
+                "stringValue": "A String", # Represents a string value.
+                "structValue": # Object with schema name: GenaiVertexV1Struct # Represents a structured value.
+              },
+            },
+          ],
+        },
+        "text": { # Configuration for text output format.
+          "mimeType": "A String", # The MIME type of the text output.
+          "schema": { # `Struct` represents a structured data value, consisting of fields which map to dynamically typed values. # The JSON schema that the output should conform to. Only applicable when mime_type is application/json.
+            "fields": [ # Dynamically typed fields. List instead of map because LLMs are sensitive to ordering, and we want to give users full control.
+              { # Represents a single field in a struct.
+                "name": "A String",
+                "value": { # `Value` represents a dynamically typed value which can be either null, a number, a string, a boolean, a recursive struct value, or a list of values. A producer of value is expected to set one of these variants. Absence of any variant indicates an error.
+                  "boolValue": True or False, # Represents a boolean value.
+                  "contentValue": { # The content of the response. # Represents rich content (text, image, etc.).
+                    "audio": { # An audio content block.
+                      "channels": 42, # The number of audio channels.
+                      "data": "A String", # The audio content.
+                      "mimeTypeString": "A String", # Flexible MIME type string of the audio, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                      "sampleRate": 42, # The sample rate of the audio.
+                      "uri": "A String", # The URI of the audio.
+                    },
+                    "document": { # A document content block.
+                      "data": "A String", # The document content.
+                      "mimeTypeString": "A String", # Flexible MIME type string of the document, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                      "uri": "A String", # The URI of the document.
+                    },
+                    "image": { # An image content block.
+                      "data": "A String", # The image content.
+                      "mimeTypeString": "A String", # Flexible MIME type string of the image, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                      "resolution": "A String", # The resolution of the media.
+                      "uri": "A String", # The URI of the image.
+                    },
+                    "text": { # A text content block.
+                      "annotations": [ # Citation information for model-generated content.
+                        { # Citation information for model-generated content.
+                          "endIndex": 42, # End of the attributed segment, exclusive.
+                          "fileCitation": { # A file citation annotation. # A file citation annotation.
+                            "customMetadata": { # User provided metadata about the retrieved context.
+                              "a_key": "", # Properties of the object.
+                            },
+                            "documentUri": "A String", # The URI of the file.
+                            "fileName": "A String", # The name of the file.
+                            "mediaId": "A String", # Media ID in-case of image citations, if applicable.
+                            "pageNumber": 42, # Page number of the cited document, if applicable.
+                            "source": "A String", # Source attributed for a portion of the text.
+                          },
+                          "placeCitation": { # A place citation annotation. # A place citation annotation.
+                            "name": "A String", # Title of the place.
+                            "placeId": "A String", # The ID of the place, in `places/{place_id}` format.
+                            "reviewSnippets": [ # Snippets of reviews that are used to generate answers about the features of a given place in Google Maps.
+                              { # Encapsulates a snippet of a user review that answers a question about the features of a specific place in Google Maps.
+                                "reviewId": "A String", # The ID of the review snippet.
+                                "title": "A String", # Title of the review.
+                                "url": "A String", # A link that corresponds to the user review on Google Maps.
+                              },
+                            ],
+                            "url": "A String", # URI reference of the place.
+                          },
+                          "speechMetadata": { # Speech annotation for text content. # Speech annotation for text content.
+                            "speaker": "A String", # The speaker to associate with this turn.
+                            "style": "A String", # Style instruction for the speech synthesis.
+                          },
+                          "startIndex": 42, # Start of segment of the response that is attributed to this source. Index indicates the start of the segment, measured in bytes.
+                          "urlCitation": { # A URL citation annotation. # NOTE: We use these instead of the Citation message for historical reasons. A URL citation annotation.
+                            "title": "A String", # The title of the URL.
+                            "url": "A String", # The URL.
+                          },
+                          "wordInfo": { # Word-level ASR annotation for transcription output. Carries the word text, optional timing, and optional speaker attribution. # Word-level ASR annotation with timing and speaker info.
+                            "endOffset": "A String", # End offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                            "speaker": "A String", # Optional. Speaker label for this word (e.g. "spk_1", "spk_2"). Present when diarization_mode is set in TranscriptionConfig.
+                            "startOffset": "A String", # Start offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                            "text": "A String", # The transcribed word.
+                          },
+                        },
+                      ],
+                      "text": "A String", # Required. The text content.
+                    },
+                    "video": { # A video content block.
+                      "data": "A String", # The video content.
+                      "mimeTypeString": "A String", # Flexible MIME type string of the video, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                      "name": "A String", # A user-defined name for this content block. Can be referenced by the model in the final response.
+                      "processingConfig": {
+                        "static": {
+                          "endOffset": "A String", # Optional. Segment end time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "30s". Must be non-negative and greater than `start_offset` if `start_offset` is set.
+                          "fps": 3.14, # Optional. Video frame-rate sampling density.
+                          "startOffset": "A String", # Optional. Segment start time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "10.5s". Must be non-negative.
+                        },
+                      },
+                      "processingType": "A String",
+                      "resolution": "A String", # The resolution of the media.
+                      "uri": "A String", # The URI of the video.
+                    },
+                  },
+                  "listValue": { # `ListValue` is a wrapper around a repeated field of values. # Represents a repeated `Value`.
+                    "values": [ # Repeated field of dynamically typed values.
+                      # Object with schema name: GenaiVertexV1Value
+                    ],
+                  },
+                  "nullValue": "A String", # Represents a null value.
+                  "numberValue": 3.14, # Represents a double value.
+                  "stringValue": "A String", # Represents a string value.
+                  "structValue": # Object with schema name: GenaiVertexV1Struct # Represents a structured value.
+                },
+              },
+            ],
+          },
+        },
+        "video": { # Configuration for video output format.
+          "aspectRatio": "A String", # The aspect ratio for the video output.
+          "delivery": "A String", # The delivery mode for the video output.
+          "duration": "A String", # The duration for the video output.
+          "gcsUri": "A String", # The Cloud Storage URI to store the video output. Required for Vertex if delivery mode is URI.
+          "resolution": "A String", # The video output resolution. Defaults to 720p.
+        },
+      },
+      "safetySettings": [ # Safety settings for the interaction.
+        { # A safety setting that affects the safety-blocking behavior. A SafetySetting consists of a harm category and a threshold for that category.
+          "method": "A String", # Optional. The method for blocking content. If not specified, the default behavior is to use the probability score.
+          "threshold": "A String", # Required. The threshold for blocking content. If the harm probability exceeds this threshold, the content will be blocked.
+          "type": "A String", # Required. The type of harm category to be blocked.
+        },
+      ],
+      "serviceTier": "A String", # The service tier for the interaction.
+      "status": "A String", # Required. Output only. The status of the interaction.
+      "stepList": { # A list of Steps. # Input only. The steps for the interaction.
+        "steps": [ # The steps of the list.
+          { # A step in the interaction.
+            "modelOutput": { # Output generated by the model.
+              "content": [
+                { # The content of the response.
+                  "audio": { # An audio content block.
+                    "channels": 42, # The number of audio channels.
+                    "data": "A String", # The audio content.
+                    "mimeTypeString": "A String", # Flexible MIME type string of the audio, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                    "sampleRate": 42, # The sample rate of the audio.
+                    "uri": "A String", # The URI of the audio.
+                  },
+                  "document": { # A document content block.
+                    "data": "A String", # The document content.
+                    "mimeTypeString": "A String", # Flexible MIME type string of the document, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                    "uri": "A String", # The URI of the document.
+                  },
+                  "image": { # An image content block.
+                    "data": "A String", # The image content.
+                    "mimeTypeString": "A String", # Flexible MIME type string of the image, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                    "resolution": "A String", # The resolution of the media.
+                    "uri": "A String", # The URI of the image.
+                  },
+                  "text": { # A text content block.
+                    "annotations": [ # Citation information for model-generated content.
+                      { # Citation information for model-generated content.
+                        "endIndex": 42, # End of the attributed segment, exclusive.
+                        "fileCitation": { # A file citation annotation. # A file citation annotation.
+                          "customMetadata": { # User provided metadata about the retrieved context.
+                            "a_key": "", # Properties of the object.
+                          },
+                          "documentUri": "A String", # The URI of the file.
+                          "fileName": "A String", # The name of the file.
+                          "mediaId": "A String", # Media ID in-case of image citations, if applicable.
+                          "pageNumber": 42, # Page number of the cited document, if applicable.
+                          "source": "A String", # Source attributed for a portion of the text.
+                        },
+                        "placeCitation": { # A place citation annotation. # A place citation annotation.
+                          "name": "A String", # Title of the place.
+                          "placeId": "A String", # The ID of the place, in `places/{place_id}` format.
+                          "reviewSnippets": [ # Snippets of reviews that are used to generate answers about the features of a given place in Google Maps.
+                            { # Encapsulates a snippet of a user review that answers a question about the features of a specific place in Google Maps.
+                              "reviewId": "A String", # The ID of the review snippet.
+                              "title": "A String", # Title of the review.
+                              "url": "A String", # A link that corresponds to the user review on Google Maps.
+                            },
+                          ],
+                          "url": "A String", # URI reference of the place.
+                        },
+                        "speechMetadata": { # Speech annotation for text content. # Speech annotation for text content.
+                          "speaker": "A String", # The speaker to associate with this turn.
+                          "style": "A String", # Style instruction for the speech synthesis.
+                        },
+                        "startIndex": 42, # Start of segment of the response that is attributed to this source. Index indicates the start of the segment, measured in bytes.
+                        "urlCitation": { # A URL citation annotation. # NOTE: We use these instead of the Citation message for historical reasons. A URL citation annotation.
+                          "title": "A String", # The title of the URL.
+                          "url": "A String", # The URL.
+                        },
+                        "wordInfo": { # Word-level ASR annotation for transcription output. Carries the word text, optional timing, and optional speaker attribution. # Word-level ASR annotation with timing and speaker info.
+                          "endOffset": "A String", # End offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                          "speaker": "A String", # Optional. Speaker label for this word (e.g. "spk_1", "spk_2"). Present when diarization_mode is set in TranscriptionConfig.
+                          "startOffset": "A String", # Start offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                          "text": "A String", # The transcribed word.
+                        },
+                      },
+                    ],
+                    "text": "A String", # Required. The text content.
+                  },
+                  "video": { # A video content block.
+                    "data": "A String", # The video content.
+                    "mimeTypeString": "A String", # Flexible MIME type string of the video, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                    "name": "A String", # A user-defined name for this content block. Can be referenced by the model in the final response.
+                    "processingConfig": {
+                      "static": {
+                        "endOffset": "A String", # Optional. Segment end time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "30s". Must be non-negative and greater than `start_offset` if `start_offset` is set.
+                        "fps": 3.14, # Optional. Video frame-rate sampling density.
+                        "startOffset": "A String", # Optional. Segment start time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "10.5s". Must be non-negative.
+                      },
+                    },
+                    "processingType": "A String",
+                    "resolution": "A String", # The resolution of the media.
+                    "uri": "A String", # The URI of the video.
+                  },
+                },
+              ],
+              "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.
+              },
+            },
+            "thought": { # A thought step.
+              "signature": "A String", # A signature hash for backend validation.
+              "summary": [ # A summary of the thought.
+                { # The content of the response.
+                  "audio": { # An audio content block.
+                    "channels": 42, # The number of audio channels.
+                    "data": "A String", # The audio content.
+                    "mimeTypeString": "A String", # Flexible MIME type string of the audio, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                    "sampleRate": 42, # The sample rate of the audio.
+                    "uri": "A String", # The URI of the audio.
+                  },
+                  "document": { # A document content block.
+                    "data": "A String", # The document content.
+                    "mimeTypeString": "A String", # Flexible MIME type string of the document, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                    "uri": "A String", # The URI of the document.
+                  },
+                  "image": { # An image content block.
+                    "data": "A String", # The image content.
+                    "mimeTypeString": "A String", # Flexible MIME type string of the image, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                    "resolution": "A String", # The resolution of the media.
+                    "uri": "A String", # The URI of the image.
+                  },
+                  "text": { # A text content block.
+                    "annotations": [ # Citation information for model-generated content.
+                      { # Citation information for model-generated content.
+                        "endIndex": 42, # End of the attributed segment, exclusive.
+                        "fileCitation": { # A file citation annotation. # A file citation annotation.
+                          "customMetadata": { # User provided metadata about the retrieved context.
+                            "a_key": "", # Properties of the object.
+                          },
+                          "documentUri": "A String", # The URI of the file.
+                          "fileName": "A String", # The name of the file.
+                          "mediaId": "A String", # Media ID in-case of image citations, if applicable.
+                          "pageNumber": 42, # Page number of the cited document, if applicable.
+                          "source": "A String", # Source attributed for a portion of the text.
+                        },
+                        "placeCitation": { # A place citation annotation. # A place citation annotation.
+                          "name": "A String", # Title of the place.
+                          "placeId": "A String", # The ID of the place, in `places/{place_id}` format.
+                          "reviewSnippets": [ # Snippets of reviews that are used to generate answers about the features of a given place in Google Maps.
+                            { # Encapsulates a snippet of a user review that answers a question about the features of a specific place in Google Maps.
+                              "reviewId": "A String", # The ID of the review snippet.
+                              "title": "A String", # Title of the review.
+                              "url": "A String", # A link that corresponds to the user review on Google Maps.
+                            },
+                          ],
+                          "url": "A String", # URI reference of the place.
+                        },
+                        "speechMetadata": { # Speech annotation for text content. # Speech annotation for text content.
+                          "speaker": "A String", # The speaker to associate with this turn.
+                          "style": "A String", # Style instruction for the speech synthesis.
+                        },
+                        "startIndex": 42, # Start of segment of the response that is attributed to this source. Index indicates the start of the segment, measured in bytes.
+                        "urlCitation": { # A URL citation annotation. # NOTE: We use these instead of the Citation message for historical reasons. A URL citation annotation.
+                          "title": "A String", # The title of the URL.
+                          "url": "A String", # The URL.
+                        },
+                        "wordInfo": { # Word-level ASR annotation for transcription output. Carries the word text, optional timing, and optional speaker attribution. # Word-level ASR annotation with timing and speaker info.
+                          "endOffset": "A String", # End offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                          "speaker": "A String", # Optional. Speaker label for this word (e.g. "spk_1", "spk_2"). Present when diarization_mode is set in TranscriptionConfig.
+                          "startOffset": "A String", # Start offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                          "text": "A String", # The transcribed word.
+                        },
+                      },
+                    ],
+                    "text": "A String", # Required. The text content.
+                  },
+                  "video": { # A video content block.
+                    "data": "A String", # The video content.
+                    "mimeTypeString": "A String", # Flexible MIME type string of the video, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                    "name": "A String", # A user-defined name for this content block. Can be referenced by the model in the final response.
+                    "processingConfig": {
+                      "static": {
+                        "endOffset": "A String", # Optional. Segment end time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "30s". Must be non-negative and greater than `start_offset` if `start_offset` is set.
+                        "fps": 3.14, # Optional. Video frame-rate sampling density.
+                        "startOffset": "A String", # Optional. Segment start time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "10.5s". Must be non-negative.
+                      },
+                    },
+                    "processingType": "A String",
+                    "resolution": "A String", # The resolution of the media.
+                    "uri": "A String", # The URI of the video.
+                  },
+                },
+              ],
+            },
+            "toolCall": { # Tool call step.
+              "codeExecutionCall": { # Code execution call step.
+                "arguments": { # The arguments to pass to the code execution. # Required. The arguments to pass to the code execution.
+                  "code": "A String", # The code to be executed.
+                  "language": "A String", # Programming language of the `code`.
+                },
+              },
+              "fileSearchCall": { # File Search call step.
+              },
+              "functionCall": { # A function tool call step.
+                "arguments": { # `Struct` represents a structured data value, consisting of fields which map to dynamically typed values. # Required. The arguments to pass to the function.
+                  "fields": [ # Dynamically typed fields. List instead of map because LLMs are sensitive to ordering, and we want to give users full control.
+                    { # Represents a single field in a struct.
+                      "name": "A String",
+                      "value": { # `Value` represents a dynamically typed value which can be either null, a number, a string, a boolean, a recursive struct value, or a list of values. A producer of value is expected to set one of these variants. Absence of any variant indicates an error.
+                        "boolValue": True or False, # Represents a boolean value.
+                        "contentValue": { # The content of the response. # Represents rich content (text, image, etc.).
+                          "audio": { # An audio content block.
+                            "channels": 42, # The number of audio channels.
+                            "data": "A String", # The audio content.
+                            "mimeTypeString": "A String", # Flexible MIME type string of the audio, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                            "sampleRate": 42, # The sample rate of the audio.
+                            "uri": "A String", # The URI of the audio.
+                          },
+                          "document": { # A document content block.
+                            "data": "A String", # The document content.
+                            "mimeTypeString": "A String", # Flexible MIME type string of the document, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                            "uri": "A String", # The URI of the document.
+                          },
+                          "image": { # An image content block.
+                            "data": "A String", # The image content.
+                            "mimeTypeString": "A String", # Flexible MIME type string of the image, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                            "resolution": "A String", # The resolution of the media.
+                            "uri": "A String", # The URI of the image.
+                          },
+                          "text": { # A text content block.
+                            "annotations": [ # Citation information for model-generated content.
+                              { # Citation information for model-generated content.
+                                "endIndex": 42, # End of the attributed segment, exclusive.
+                                "fileCitation": { # A file citation annotation. # A file citation annotation.
+                                  "customMetadata": { # User provided metadata about the retrieved context.
+                                    "a_key": "", # Properties of the object.
+                                  },
+                                  "documentUri": "A String", # The URI of the file.
+                                  "fileName": "A String", # The name of the file.
+                                  "mediaId": "A String", # Media ID in-case of image citations, if applicable.
+                                  "pageNumber": 42, # Page number of the cited document, if applicable.
+                                  "source": "A String", # Source attributed for a portion of the text.
+                                },
+                                "placeCitation": { # A place citation annotation. # A place citation annotation.
+                                  "name": "A String", # Title of the place.
+                                  "placeId": "A String", # The ID of the place, in `places/{place_id}` format.
+                                  "reviewSnippets": [ # Snippets of reviews that are used to generate answers about the features of a given place in Google Maps.
+                                    { # Encapsulates a snippet of a user review that answers a question about the features of a specific place in Google Maps.
+                                      "reviewId": "A String", # The ID of the review snippet.
+                                      "title": "A String", # Title of the review.
+                                      "url": "A String", # A link that corresponds to the user review on Google Maps.
+                                    },
+                                  ],
+                                  "url": "A String", # URI reference of the place.
+                                },
+                                "speechMetadata": { # Speech annotation for text content. # Speech annotation for text content.
+                                  "speaker": "A String", # The speaker to associate with this turn.
+                                  "style": "A String", # Style instruction for the speech synthesis.
+                                },
+                                "startIndex": 42, # Start of segment of the response that is attributed to this source. Index indicates the start of the segment, measured in bytes.
+                                "urlCitation": { # A URL citation annotation. # NOTE: We use these instead of the Citation message for historical reasons. A URL citation annotation.
+                                  "title": "A String", # The title of the URL.
+                                  "url": "A String", # The URL.
+                                },
+                                "wordInfo": { # Word-level ASR annotation for transcription output. Carries the word text, optional timing, and optional speaker attribution. # Word-level ASR annotation with timing and speaker info.
+                                  "endOffset": "A String", # End offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                                  "speaker": "A String", # Optional. Speaker label for this word (e.g. "spk_1", "spk_2"). Present when diarization_mode is set in TranscriptionConfig.
+                                  "startOffset": "A String", # Start offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                                  "text": "A String", # The transcribed word.
+                                },
+                              },
+                            ],
+                            "text": "A String", # Required. The text content.
+                          },
+                          "video": { # A video content block.
+                            "data": "A String", # The video content.
+                            "mimeTypeString": "A String", # Flexible MIME type string of the video, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                            "name": "A String", # A user-defined name for this content block. Can be referenced by the model in the final response.
+                            "processingConfig": {
+                              "static": {
+                                "endOffset": "A String", # Optional. Segment end time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "30s". Must be non-negative and greater than `start_offset` if `start_offset` is set.
+                                "fps": 3.14, # Optional. Video frame-rate sampling density.
+                                "startOffset": "A String", # Optional. Segment start time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "10.5s". Must be non-negative.
+                              },
+                            },
+                            "processingType": "A String",
+                            "resolution": "A String", # The resolution of the media.
+                            "uri": "A String", # The URI of the video.
+                          },
+                        },
+                        "listValue": { # `ListValue` is a wrapper around a repeated field of values. # Represents a repeated `Value`.
+                          "values": [ # Repeated field of dynamically typed values.
+                            # Object with schema name: GenaiVertexV1Value
+                          ],
+                        },
+                        "nullValue": "A String", # Represents a null value.
+                        "numberValue": 3.14, # Represents a double value.
+                        "stringValue": "A String", # Represents a string value.
+                        "structValue": # Object with schema name: GenaiVertexV1Struct # Represents a structured value.
+                      },
+                    },
+                  ],
+                },
+                "name": "A String", # Required. The name of the tool to call.
+              },
+              "googleMapsCall": { # Google Maps call step.
+                "arguments": { # The arguments to pass to the Google Maps tool. # The arguments to pass to the Google Maps tool.
+                  "queries": [ # The queries to be executed.
+                    "A String",
+                  ],
+                },
+              },
+              "googleSearchCall": { # Google Search call step.
+                "arguments": { # The arguments to pass to Google Search. # Required. The arguments to pass to Google Search.
+                  "queries": [ # Web search queries for the following-up web search.
+                    "A String",
+                  ],
+                },
+                "searchType": "A String", # The type of search grounding enabled.
+              },
+              "id": "A String", # Required. A unique ID for this specific tool call.
+              "processingCall": { # A server-initiated processing step for media analysis (e.g. video understanding).
+              },
+              "retrievalCall": { # Retrieval call step. Used by Vertex Retrieval tools such as Parallel AI, Exa AI, Vertex AI Search, etc. RetrievalType decides which tool is used.
+                "arguments": { # The arguments to pass to Retrieval tools. # Required. The arguments to pass to the retrieval tool.
+                  "queries": [ # Queries for Retrieval information.
+                    "A String",
+                  ],
+                },
+                "retrievalType": "A String", # The type of retrieval tools.
+              },
+              "signature": "A String", # A signature hash for backend validation.
+              "urlContextCall": { # URL context call step.
+                "arguments": { # The arguments to pass to the URL context. # Required. The arguments to pass to the URL context.
+                  "urls": [ # The URLs to fetch.
+                    "A String",
+                  ],
+                },
+              },
+            },
+            "toolResult": { # Tool result step.
+              "callId": "A String", # Required. ID to match the ID from the function call block.
+              "codeExecutionResult": { # Code execution result step.
+                "isError": True or False, # Whether the code execution resulted in an error.
+                "result": "A String", # Required. The output of the code execution.
+              },
+              "fileSearchResult": { # File Search result step.
+              },
+              "functionResult": { # Result of a function tool call.
+                "isError": True or False, # Whether the tool call resulted in an error.
+                "name": "A String", # The name of the tool that was called.
+                "result": { # `Value` represents a dynamically typed value which can be either null, a number, a string, a boolean, a recursive struct value, or a list of values. A producer of value is expected to set one of these variants. Absence of any variant indicates an error. # Required. The result of the tool call.
+                  "boolValue": True or False, # Represents a boolean value.
+                  "contentValue": { # The content of the response. # Represents rich content (text, image, etc.).
+                    "audio": { # An audio content block.
+                      "channels": 42, # The number of audio channels.
+                      "data": "A String", # The audio content.
+                      "mimeTypeString": "A String", # Flexible MIME type string of the audio, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                      "sampleRate": 42, # The sample rate of the audio.
+                      "uri": "A String", # The URI of the audio.
+                    },
+                    "document": { # A document content block.
+                      "data": "A String", # The document content.
+                      "mimeTypeString": "A String", # Flexible MIME type string of the document, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                      "uri": "A String", # The URI of the document.
+                    },
+                    "image": { # An image content block.
+                      "data": "A String", # The image content.
+                      "mimeTypeString": "A String", # Flexible MIME type string of the image, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                      "resolution": "A String", # The resolution of the media.
+                      "uri": "A String", # The URI of the image.
+                    },
+                    "text": { # A text content block.
+                      "annotations": [ # Citation information for model-generated content.
+                        { # Citation information for model-generated content.
+                          "endIndex": 42, # End of the attributed segment, exclusive.
+                          "fileCitation": { # A file citation annotation. # A file citation annotation.
+                            "customMetadata": { # User provided metadata about the retrieved context.
+                              "a_key": "", # Properties of the object.
+                            },
+                            "documentUri": "A String", # The URI of the file.
+                            "fileName": "A String", # The name of the file.
+                            "mediaId": "A String", # Media ID in-case of image citations, if applicable.
+                            "pageNumber": 42, # Page number of the cited document, if applicable.
+                            "source": "A String", # Source attributed for a portion of the text.
+                          },
+                          "placeCitation": { # A place citation annotation. # A place citation annotation.
+                            "name": "A String", # Title of the place.
+                            "placeId": "A String", # The ID of the place, in `places/{place_id}` format.
+                            "reviewSnippets": [ # Snippets of reviews that are used to generate answers about the features of a given place in Google Maps.
+                              { # Encapsulates a snippet of a user review that answers a question about the features of a specific place in Google Maps.
+                                "reviewId": "A String", # The ID of the review snippet.
+                                "title": "A String", # Title of the review.
+                                "url": "A String", # A link that corresponds to the user review on Google Maps.
+                              },
+                            ],
+                            "url": "A String", # URI reference of the place.
+                          },
+                          "speechMetadata": { # Speech annotation for text content. # Speech annotation for text content.
+                            "speaker": "A String", # The speaker to associate with this turn.
+                            "style": "A String", # Style instruction for the speech synthesis.
+                          },
+                          "startIndex": 42, # Start of segment of the response that is attributed to this source. Index indicates the start of the segment, measured in bytes.
+                          "urlCitation": { # A URL citation annotation. # NOTE: We use these instead of the Citation message for historical reasons. A URL citation annotation.
+                            "title": "A String", # The title of the URL.
+                            "url": "A String", # The URL.
+                          },
+                          "wordInfo": { # Word-level ASR annotation for transcription output. Carries the word text, optional timing, and optional speaker attribution. # Word-level ASR annotation with timing and speaker info.
+                            "endOffset": "A String", # End offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                            "speaker": "A String", # Optional. Speaker label for this word (e.g. "spk_1", "spk_2"). Present when diarization_mode is set in TranscriptionConfig.
+                            "startOffset": "A String", # Start offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                            "text": "A String", # The transcribed word.
+                          },
+                        },
+                      ],
+                      "text": "A String", # Required. The text content.
+                    },
+                    "video": { # A video content block.
+                      "data": "A String", # The video content.
+                      "mimeTypeString": "A String", # Flexible MIME type string of the video, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                      "name": "A String", # A user-defined name for this content block. Can be referenced by the model in the final response.
+                      "processingConfig": {
+                        "static": {
+                          "endOffset": "A String", # Optional. Segment end time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "30s". Must be non-negative and greater than `start_offset` if `start_offset` is set.
+                          "fps": 3.14, # Optional. Video frame-rate sampling density.
+                          "startOffset": "A String", # Optional. Segment start time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "10.5s". Must be non-negative.
+                        },
+                      },
+                      "processingType": "A String",
+                      "resolution": "A String", # The resolution of the media.
+                      "uri": "A String", # The URI of the video.
+                    },
+                  },
+                  "listValue": { # `ListValue` is a wrapper around a repeated field of values. # Represents a repeated `Value`.
+                    "values": [ # Repeated field of dynamically typed values.
+                      # Object with schema name: GenaiVertexV1Value
+                    ],
+                  },
+                  "nullValue": "A String", # Represents a null value.
+                  "numberValue": 3.14, # Represents a double value.
+                  "stringValue": "A String", # Represents a string value.
+                  "structValue": # Object with schema name: GenaiVertexV1Struct # Represents a structured value.
+                },
+              },
+              "googleMapsResult": { # Google Maps result step.
+                "result": [
+                  { # The result of the Google Maps.
+                    "places": [
+                      {
+                        "name": "A String",
+                        "placeId": "A String",
+                        "reviewSnippets": [
+                          { # Encapsulates a snippet of a user review that answers a question about the features of a specific place in Google Maps.
+                            "reviewId": "A String", # The ID of the review snippet.
+                            "title": "A String", # Title of the review.
+                            "url": "A String", # A link that corresponds to the user review on Google Maps.
+                          },
+                        ],
+                        "url": "A String",
+                      },
+                    ],
+                    "widgetContextToken": "A String",
+                  },
+                ],
+              },
+              "googleSearchResult": { # Google Search result step.
+                "isError": True or False, # Whether the Google Search resulted in an error.
+                "result": [ # Required. The results of the Google Search.
+                  { # The result of the Google Search.
+                    "searchSuggestions": "A String", # Web content snippet that can be embedded in a web page or an app webview.
+                  },
+                ],
+              },
+              "processingResult": { # The result of a server-initiated media processing step.
+              },
+              "retrievalResult": { # Vertex Retrieval result step. Used by Vertex Retrieval tools such as Parallel AI, Exa AI, Vertex AI Search, etc.
+                "isError": True or False, # Whether the retrieval resulted in an error.
+              },
+              "signature": "A String", # A signature hash for backend validation.
+              "urlContextResult": { # URL context result step.
+                "isError": True or False, # Whether the URL context resulted in an error.
+                "result": [ # Required. The results of the URL context.
+                  { # The result of the URL context.
+                    "status": "A String", # The status of the URL retrieval.
+                    "url": "A String", # The URL that was fetched.
+                  },
+                ],
+              },
+            },
+            "userInput": { # Input provided by the user. # DO NOT USE -- These are for 3P JSON only
+              "contentList": { # A list of Content. # The content of the step. An array of Content objects.
+                "contents": [ # The contents of the list.
+                  { # The content of the response.
+                    "audio": { # An audio content block.
+                      "channels": 42, # The number of audio channels.
+                      "data": "A String", # The audio content.
+                      "mimeTypeString": "A String", # Flexible MIME type string of the audio, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                      "sampleRate": 42, # The sample rate of the audio.
+                      "uri": "A String", # The URI of the audio.
+                    },
+                    "document": { # A document content block.
+                      "data": "A String", # The document content.
+                      "mimeTypeString": "A String", # Flexible MIME type string of the document, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                      "uri": "A String", # The URI of the document.
+                    },
+                    "image": { # An image content block.
+                      "data": "A String", # The image content.
+                      "mimeTypeString": "A String", # Flexible MIME type string of the image, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                      "resolution": "A String", # The resolution of the media.
+                      "uri": "A String", # The URI of the image.
+                    },
+                    "text": { # A text content block.
+                      "annotations": [ # Citation information for model-generated content.
+                        { # Citation information for model-generated content.
+                          "endIndex": 42, # End of the attributed segment, exclusive.
+                          "fileCitation": { # A file citation annotation. # A file citation annotation.
+                            "customMetadata": { # User provided metadata about the retrieved context.
+                              "a_key": "", # Properties of the object.
+                            },
+                            "documentUri": "A String", # The URI of the file.
+                            "fileName": "A String", # The name of the file.
+                            "mediaId": "A String", # Media ID in-case of image citations, if applicable.
+                            "pageNumber": 42, # Page number of the cited document, if applicable.
+                            "source": "A String", # Source attributed for a portion of the text.
+                          },
+                          "placeCitation": { # A place citation annotation. # A place citation annotation.
+                            "name": "A String", # Title of the place.
+                            "placeId": "A String", # The ID of the place, in `places/{place_id}` format.
+                            "reviewSnippets": [ # Snippets of reviews that are used to generate answers about the features of a given place in Google Maps.
+                              { # Encapsulates a snippet of a user review that answers a question about the features of a specific place in Google Maps.
+                                "reviewId": "A String", # The ID of the review snippet.
+                                "title": "A String", # Title of the review.
+                                "url": "A String", # A link that corresponds to the user review on Google Maps.
+                              },
+                            ],
+                            "url": "A String", # URI reference of the place.
+                          },
+                          "speechMetadata": { # Speech annotation for text content. # Speech annotation for text content.
+                            "speaker": "A String", # The speaker to associate with this turn.
+                            "style": "A String", # Style instruction for the speech synthesis.
+                          },
+                          "startIndex": 42, # Start of segment of the response that is attributed to this source. Index indicates the start of the segment, measured in bytes.
+                          "urlCitation": { # A URL citation annotation. # NOTE: We use these instead of the Citation message for historical reasons. A URL citation annotation.
+                            "title": "A String", # The title of the URL.
+                            "url": "A String", # The URL.
+                          },
+                          "wordInfo": { # Word-level ASR annotation for transcription output. Carries the word text, optional timing, and optional speaker attribution. # Word-level ASR annotation with timing and speaker info.
+                            "endOffset": "A String", # End offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                            "speaker": "A String", # Optional. Speaker label for this word (e.g. "spk_1", "spk_2"). Present when diarization_mode is set in TranscriptionConfig.
+                            "startOffset": "A String", # Start offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                            "text": "A String", # The transcribed word.
+                          },
+                        },
+                      ],
+                      "text": "A String", # Required. The text content.
+                    },
+                    "video": { # A video content block.
+                      "data": "A String", # The video content.
+                      "mimeTypeString": "A String", # Flexible MIME type string of the video, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                      "name": "A String", # A user-defined name for this content block. Can be referenced by the model in the final response.
+                      "processingConfig": {
+                        "static": {
+                          "endOffset": "A String", # Optional. Segment end time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "30s". Must be non-negative and greater than `start_offset` if `start_offset` is set.
+                          "fps": 3.14, # Optional. Video frame-rate sampling density.
+                          "startOffset": "A String", # Optional. Segment start time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "10.5s". Must be non-negative.
+                        },
+                      },
+                      "processingType": "A String",
+                      "resolution": "A String", # The resolution of the media.
+                      "uri": "A String", # The URI of the video.
+                    },
+                  },
+                ],
+              },
+              "contentString": "A String", # The content of the step. A single string.
+            },
+          },
+        ],
+      },
+      "steps": [ # Required. Output only. The steps that make up the interaction, when included in the response.
+        { # A step in the interaction.
+          "modelOutput": { # Output generated by the model.
+            "content": [
+              { # The content of the response.
+                "audio": { # An audio content block.
+                  "channels": 42, # The number of audio channels.
+                  "data": "A String", # The audio content.
+                  "mimeTypeString": "A String", # Flexible MIME type string of the audio, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                  "sampleRate": 42, # The sample rate of the audio.
+                  "uri": "A String", # The URI of the audio.
+                },
+                "document": { # A document content block.
+                  "data": "A String", # The document content.
+                  "mimeTypeString": "A String", # Flexible MIME type string of the document, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                  "uri": "A String", # The URI of the document.
+                },
+                "image": { # An image content block.
+                  "data": "A String", # The image content.
+                  "mimeTypeString": "A String", # Flexible MIME type string of the image, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                  "resolution": "A String", # The resolution of the media.
+                  "uri": "A String", # The URI of the image.
+                },
+                "text": { # A text content block.
+                  "annotations": [ # Citation information for model-generated content.
+                    { # Citation information for model-generated content.
+                      "endIndex": 42, # End of the attributed segment, exclusive.
+                      "fileCitation": { # A file citation annotation. # A file citation annotation.
+                        "customMetadata": { # User provided metadata about the retrieved context.
+                          "a_key": "", # Properties of the object.
+                        },
+                        "documentUri": "A String", # The URI of the file.
+                        "fileName": "A String", # The name of the file.
+                        "mediaId": "A String", # Media ID in-case of image citations, if applicable.
+                        "pageNumber": 42, # Page number of the cited document, if applicable.
+                        "source": "A String", # Source attributed for a portion of the text.
+                      },
+                      "placeCitation": { # A place citation annotation. # A place citation annotation.
+                        "name": "A String", # Title of the place.
+                        "placeId": "A String", # The ID of the place, in `places/{place_id}` format.
+                        "reviewSnippets": [ # Snippets of reviews that are used to generate answers about the features of a given place in Google Maps.
+                          { # Encapsulates a snippet of a user review that answers a question about the features of a specific place in Google Maps.
+                            "reviewId": "A String", # The ID of the review snippet.
+                            "title": "A String", # Title of the review.
+                            "url": "A String", # A link that corresponds to the user review on Google Maps.
+                          },
+                        ],
+                        "url": "A String", # URI reference of the place.
+                      },
+                      "speechMetadata": { # Speech annotation for text content. # Speech annotation for text content.
+                        "speaker": "A String", # The speaker to associate with this turn.
+                        "style": "A String", # Style instruction for the speech synthesis.
+                      },
+                      "startIndex": 42, # Start of segment of the response that is attributed to this source. Index indicates the start of the segment, measured in bytes.
+                      "urlCitation": { # A URL citation annotation. # NOTE: We use these instead of the Citation message for historical reasons. A URL citation annotation.
+                        "title": "A String", # The title of the URL.
+                        "url": "A String", # The URL.
+                      },
+                      "wordInfo": { # Word-level ASR annotation for transcription output. Carries the word text, optional timing, and optional speaker attribution. # Word-level ASR annotation with timing and speaker info.
+                        "endOffset": "A String", # End offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                        "speaker": "A String", # Optional. Speaker label for this word (e.g. "spk_1", "spk_2"). Present when diarization_mode is set in TranscriptionConfig.
+                        "startOffset": "A String", # Start offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                        "text": "A String", # The transcribed word.
+                      },
+                    },
+                  ],
+                  "text": "A String", # Required. The text content.
+                },
+                "video": { # A video content block.
+                  "data": "A String", # The video content.
+                  "mimeTypeString": "A String", # Flexible MIME type string of the video, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                  "name": "A String", # A user-defined name for this content block. Can be referenced by the model in the final response.
+                  "processingConfig": {
+                    "static": {
+                      "endOffset": "A String", # Optional. Segment end time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "30s". Must be non-negative and greater than `start_offset` if `start_offset` is set.
+                      "fps": 3.14, # Optional. Video frame-rate sampling density.
+                      "startOffset": "A String", # Optional. Segment start time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "10.5s". Must be non-negative.
+                    },
+                  },
+                  "processingType": "A String",
+                  "resolution": "A String", # The resolution of the media.
+                  "uri": "A String", # The URI of the video.
+                },
+              },
+            ],
+            "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.
+            },
+          },
+          "thought": { # A thought step.
+            "signature": "A String", # A signature hash for backend validation.
+            "summary": [ # A summary of the thought.
+              { # The content of the response.
+                "audio": { # An audio content block.
+                  "channels": 42, # The number of audio channels.
+                  "data": "A String", # The audio content.
+                  "mimeTypeString": "A String", # Flexible MIME type string of the audio, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                  "sampleRate": 42, # The sample rate of the audio.
+                  "uri": "A String", # The URI of the audio.
+                },
+                "document": { # A document content block.
+                  "data": "A String", # The document content.
+                  "mimeTypeString": "A String", # Flexible MIME type string of the document, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                  "uri": "A String", # The URI of the document.
+                },
+                "image": { # An image content block.
+                  "data": "A String", # The image content.
+                  "mimeTypeString": "A String", # Flexible MIME type string of the image, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                  "resolution": "A String", # The resolution of the media.
+                  "uri": "A String", # The URI of the image.
+                },
+                "text": { # A text content block.
+                  "annotations": [ # Citation information for model-generated content.
+                    { # Citation information for model-generated content.
+                      "endIndex": 42, # End of the attributed segment, exclusive.
+                      "fileCitation": { # A file citation annotation. # A file citation annotation.
+                        "customMetadata": { # User provided metadata about the retrieved context.
+                          "a_key": "", # Properties of the object.
+                        },
+                        "documentUri": "A String", # The URI of the file.
+                        "fileName": "A String", # The name of the file.
+                        "mediaId": "A String", # Media ID in-case of image citations, if applicable.
+                        "pageNumber": 42, # Page number of the cited document, if applicable.
+                        "source": "A String", # Source attributed for a portion of the text.
+                      },
+                      "placeCitation": { # A place citation annotation. # A place citation annotation.
+                        "name": "A String", # Title of the place.
+                        "placeId": "A String", # The ID of the place, in `places/{place_id}` format.
+                        "reviewSnippets": [ # Snippets of reviews that are used to generate answers about the features of a given place in Google Maps.
+                          { # Encapsulates a snippet of a user review that answers a question about the features of a specific place in Google Maps.
+                            "reviewId": "A String", # The ID of the review snippet.
+                            "title": "A String", # Title of the review.
+                            "url": "A String", # A link that corresponds to the user review on Google Maps.
+                          },
+                        ],
+                        "url": "A String", # URI reference of the place.
+                      },
+                      "speechMetadata": { # Speech annotation for text content. # Speech annotation for text content.
+                        "speaker": "A String", # The speaker to associate with this turn.
+                        "style": "A String", # Style instruction for the speech synthesis.
+                      },
+                      "startIndex": 42, # Start of segment of the response that is attributed to this source. Index indicates the start of the segment, measured in bytes.
+                      "urlCitation": { # A URL citation annotation. # NOTE: We use these instead of the Citation message for historical reasons. A URL citation annotation.
+                        "title": "A String", # The title of the URL.
+                        "url": "A String", # The URL.
+                      },
+                      "wordInfo": { # Word-level ASR annotation for transcription output. Carries the word text, optional timing, and optional speaker attribution. # Word-level ASR annotation with timing and speaker info.
+                        "endOffset": "A String", # End offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                        "speaker": "A String", # Optional. Speaker label for this word (e.g. "spk_1", "spk_2"). Present when diarization_mode is set in TranscriptionConfig.
+                        "startOffset": "A String", # Start offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                        "text": "A String", # The transcribed word.
+                      },
+                    },
+                  ],
+                  "text": "A String", # Required. The text content.
+                },
+                "video": { # A video content block.
+                  "data": "A String", # The video content.
+                  "mimeTypeString": "A String", # Flexible MIME type string of the video, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                  "name": "A String", # A user-defined name for this content block. Can be referenced by the model in the final response.
+                  "processingConfig": {
+                    "static": {
+                      "endOffset": "A String", # Optional. Segment end time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "30s". Must be non-negative and greater than `start_offset` if `start_offset` is set.
+                      "fps": 3.14, # Optional. Video frame-rate sampling density.
+                      "startOffset": "A String", # Optional. Segment start time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "10.5s". Must be non-negative.
+                    },
+                  },
+                  "processingType": "A String",
+                  "resolution": "A String", # The resolution of the media.
+                  "uri": "A String", # The URI of the video.
+                },
+              },
+            ],
+          },
+          "toolCall": { # Tool call step.
+            "codeExecutionCall": { # Code execution call step.
+              "arguments": { # The arguments to pass to the code execution. # Required. The arguments to pass to the code execution.
+                "code": "A String", # The code to be executed.
+                "language": "A String", # Programming language of the `code`.
+              },
+            },
+            "fileSearchCall": { # File Search call step.
+            },
+            "functionCall": { # A function tool call step.
+              "arguments": { # `Struct` represents a structured data value, consisting of fields which map to dynamically typed values. # Required. The arguments to pass to the function.
+                "fields": [ # Dynamically typed fields. List instead of map because LLMs are sensitive to ordering, and we want to give users full control.
+                  { # Represents a single field in a struct.
+                    "name": "A String",
+                    "value": { # `Value` represents a dynamically typed value which can be either null, a number, a string, a boolean, a recursive struct value, or a list of values. A producer of value is expected to set one of these variants. Absence of any variant indicates an error.
+                      "boolValue": True or False, # Represents a boolean value.
+                      "contentValue": { # The content of the response. # Represents rich content (text, image, etc.).
+                        "audio": { # An audio content block.
+                          "channels": 42, # The number of audio channels.
+                          "data": "A String", # The audio content.
+                          "mimeTypeString": "A String", # Flexible MIME type string of the audio, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                          "sampleRate": 42, # The sample rate of the audio.
+                          "uri": "A String", # The URI of the audio.
+                        },
+                        "document": { # A document content block.
+                          "data": "A String", # The document content.
+                          "mimeTypeString": "A String", # Flexible MIME type string of the document, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                          "uri": "A String", # The URI of the document.
+                        },
+                        "image": { # An image content block.
+                          "data": "A String", # The image content.
+                          "mimeTypeString": "A String", # Flexible MIME type string of the image, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                          "resolution": "A String", # The resolution of the media.
+                          "uri": "A String", # The URI of the image.
+                        },
+                        "text": { # A text content block.
+                          "annotations": [ # Citation information for model-generated content.
+                            { # Citation information for model-generated content.
+                              "endIndex": 42, # End of the attributed segment, exclusive.
+                              "fileCitation": { # A file citation annotation. # A file citation annotation.
+                                "customMetadata": { # User provided metadata about the retrieved context.
+                                  "a_key": "", # Properties of the object.
+                                },
+                                "documentUri": "A String", # The URI of the file.
+                                "fileName": "A String", # The name of the file.
+                                "mediaId": "A String", # Media ID in-case of image citations, if applicable.
+                                "pageNumber": 42, # Page number of the cited document, if applicable.
+                                "source": "A String", # Source attributed for a portion of the text.
+                              },
+                              "placeCitation": { # A place citation annotation. # A place citation annotation.
+                                "name": "A String", # Title of the place.
+                                "placeId": "A String", # The ID of the place, in `places/{place_id}` format.
+                                "reviewSnippets": [ # Snippets of reviews that are used to generate answers about the features of a given place in Google Maps.
+                                  { # Encapsulates a snippet of a user review that answers a question about the features of a specific place in Google Maps.
+                                    "reviewId": "A String", # The ID of the review snippet.
+                                    "title": "A String", # Title of the review.
+                                    "url": "A String", # A link that corresponds to the user review on Google Maps.
+                                  },
+                                ],
+                                "url": "A String", # URI reference of the place.
+                              },
+                              "speechMetadata": { # Speech annotation for text content. # Speech annotation for text content.
+                                "speaker": "A String", # The speaker to associate with this turn.
+                                "style": "A String", # Style instruction for the speech synthesis.
+                              },
+                              "startIndex": 42, # Start of segment of the response that is attributed to this source. Index indicates the start of the segment, measured in bytes.
+                              "urlCitation": { # A URL citation annotation. # NOTE: We use these instead of the Citation message for historical reasons. A URL citation annotation.
+                                "title": "A String", # The title of the URL.
+                                "url": "A String", # The URL.
+                              },
+                              "wordInfo": { # Word-level ASR annotation for transcription output. Carries the word text, optional timing, and optional speaker attribution. # Word-level ASR annotation with timing and speaker info.
+                                "endOffset": "A String", # End offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                                "speaker": "A String", # Optional. Speaker label for this word (e.g. "spk_1", "spk_2"). Present when diarization_mode is set in TranscriptionConfig.
+                                "startOffset": "A String", # Start offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                                "text": "A String", # The transcribed word.
+                              },
+                            },
+                          ],
+                          "text": "A String", # Required. The text content.
+                        },
+                        "video": { # A video content block.
+                          "data": "A String", # The video content.
+                          "mimeTypeString": "A String", # Flexible MIME type string of the video, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                          "name": "A String", # A user-defined name for this content block. Can be referenced by the model in the final response.
+                          "processingConfig": {
+                            "static": {
+                              "endOffset": "A String", # Optional. Segment end time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "30s". Must be non-negative and greater than `start_offset` if `start_offset` is set.
+                              "fps": 3.14, # Optional. Video frame-rate sampling density.
+                              "startOffset": "A String", # Optional. Segment start time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "10.5s". Must be non-negative.
+                            },
+                          },
+                          "processingType": "A String",
+                          "resolution": "A String", # The resolution of the media.
+                          "uri": "A String", # The URI of the video.
+                        },
+                      },
+                      "listValue": { # `ListValue` is a wrapper around a repeated field of values. # Represents a repeated `Value`.
+                        "values": [ # Repeated field of dynamically typed values.
+                          # Object with schema name: GenaiVertexV1Value
+                        ],
+                      },
+                      "nullValue": "A String", # Represents a null value.
+                      "numberValue": 3.14, # Represents a double value.
+                      "stringValue": "A String", # Represents a string value.
+                      "structValue": # Object with schema name: GenaiVertexV1Struct # Represents a structured value.
+                    },
+                  },
+                ],
+              },
+              "name": "A String", # Required. The name of the tool to call.
+            },
+            "googleMapsCall": { # Google Maps call step.
+              "arguments": { # The arguments to pass to the Google Maps tool. # The arguments to pass to the Google Maps tool.
+                "queries": [ # The queries to be executed.
+                  "A String",
+                ],
+              },
+            },
+            "googleSearchCall": { # Google Search call step.
+              "arguments": { # The arguments to pass to Google Search. # Required. The arguments to pass to Google Search.
+                "queries": [ # Web search queries for the following-up web search.
+                  "A String",
+                ],
+              },
+              "searchType": "A String", # The type of search grounding enabled.
+            },
+            "id": "A String", # Required. A unique ID for this specific tool call.
+            "processingCall": { # A server-initiated processing step for media analysis (e.g. video understanding).
+            },
+            "retrievalCall": { # Retrieval call step. Used by Vertex Retrieval tools such as Parallel AI, Exa AI, Vertex AI Search, etc. RetrievalType decides which tool is used.
+              "arguments": { # The arguments to pass to Retrieval tools. # Required. The arguments to pass to the retrieval tool.
+                "queries": [ # Queries for Retrieval information.
+                  "A String",
+                ],
+              },
+              "retrievalType": "A String", # The type of retrieval tools.
+            },
+            "signature": "A String", # A signature hash for backend validation.
+            "urlContextCall": { # URL context call step.
+              "arguments": { # The arguments to pass to the URL context. # Required. The arguments to pass to the URL context.
+                "urls": [ # The URLs to fetch.
+                  "A String",
+                ],
+              },
+            },
+          },
+          "toolResult": { # Tool result step.
+            "callId": "A String", # Required. ID to match the ID from the function call block.
+            "codeExecutionResult": { # Code execution result step.
+              "isError": True or False, # Whether the code execution resulted in an error.
+              "result": "A String", # Required. The output of the code execution.
+            },
+            "fileSearchResult": { # File Search result step.
+            },
+            "functionResult": { # Result of a function tool call.
+              "isError": True or False, # Whether the tool call resulted in an error.
+              "name": "A String", # The name of the tool that was called.
+              "result": { # `Value` represents a dynamically typed value which can be either null, a number, a string, a boolean, a recursive struct value, or a list of values. A producer of value is expected to set one of these variants. Absence of any variant indicates an error. # Required. The result of the tool call.
+                "boolValue": True or False, # Represents a boolean value.
+                "contentValue": { # The content of the response. # Represents rich content (text, image, etc.).
+                  "audio": { # An audio content block.
+                    "channels": 42, # The number of audio channels.
+                    "data": "A String", # The audio content.
+                    "mimeTypeString": "A String", # Flexible MIME type string of the audio, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                    "sampleRate": 42, # The sample rate of the audio.
+                    "uri": "A String", # The URI of the audio.
+                  },
+                  "document": { # A document content block.
+                    "data": "A String", # The document content.
+                    "mimeTypeString": "A String", # Flexible MIME type string of the document, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                    "uri": "A String", # The URI of the document.
+                  },
+                  "image": { # An image content block.
+                    "data": "A String", # The image content.
+                    "mimeTypeString": "A String", # Flexible MIME type string of the image, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                    "resolution": "A String", # The resolution of the media.
+                    "uri": "A String", # The URI of the image.
+                  },
+                  "text": { # A text content block.
+                    "annotations": [ # Citation information for model-generated content.
+                      { # Citation information for model-generated content.
+                        "endIndex": 42, # End of the attributed segment, exclusive.
+                        "fileCitation": { # A file citation annotation. # A file citation annotation.
+                          "customMetadata": { # User provided metadata about the retrieved context.
+                            "a_key": "", # Properties of the object.
+                          },
+                          "documentUri": "A String", # The URI of the file.
+                          "fileName": "A String", # The name of the file.
+                          "mediaId": "A String", # Media ID in-case of image citations, if applicable.
+                          "pageNumber": 42, # Page number of the cited document, if applicable.
+                          "source": "A String", # Source attributed for a portion of the text.
+                        },
+                        "placeCitation": { # A place citation annotation. # A place citation annotation.
+                          "name": "A String", # Title of the place.
+                          "placeId": "A String", # The ID of the place, in `places/{place_id}` format.
+                          "reviewSnippets": [ # Snippets of reviews that are used to generate answers about the features of a given place in Google Maps.
+                            { # Encapsulates a snippet of a user review that answers a question about the features of a specific place in Google Maps.
+                              "reviewId": "A String", # The ID of the review snippet.
+                              "title": "A String", # Title of the review.
+                              "url": "A String", # A link that corresponds to the user review on Google Maps.
+                            },
+                          ],
+                          "url": "A String", # URI reference of the place.
+                        },
+                        "speechMetadata": { # Speech annotation for text content. # Speech annotation for text content.
+                          "speaker": "A String", # The speaker to associate with this turn.
+                          "style": "A String", # Style instruction for the speech synthesis.
+                        },
+                        "startIndex": 42, # Start of segment of the response that is attributed to this source. Index indicates the start of the segment, measured in bytes.
+                        "urlCitation": { # A URL citation annotation. # NOTE: We use these instead of the Citation message for historical reasons. A URL citation annotation.
+                          "title": "A String", # The title of the URL.
+                          "url": "A String", # The URL.
+                        },
+                        "wordInfo": { # Word-level ASR annotation for transcription output. Carries the word text, optional timing, and optional speaker attribution. # Word-level ASR annotation with timing and speaker info.
+                          "endOffset": "A String", # End offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                          "speaker": "A String", # Optional. Speaker label for this word (e.g. "spk_1", "spk_2"). Present when diarization_mode is set in TranscriptionConfig.
+                          "startOffset": "A String", # Start offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                          "text": "A String", # The transcribed word.
+                        },
+                      },
+                    ],
+                    "text": "A String", # Required. The text content.
+                  },
+                  "video": { # A video content block.
+                    "data": "A String", # The video content.
+                    "mimeTypeString": "A String", # Flexible MIME type string of the video, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                    "name": "A String", # A user-defined name for this content block. Can be referenced by the model in the final response.
+                    "processingConfig": {
+                      "static": {
+                        "endOffset": "A String", # Optional. Segment end time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "30s". Must be non-negative and greater than `start_offset` if `start_offset` is set.
+                        "fps": 3.14, # Optional. Video frame-rate sampling density.
+                        "startOffset": "A String", # Optional. Segment start time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "10.5s". Must be non-negative.
+                      },
+                    },
+                    "processingType": "A String",
+                    "resolution": "A String", # The resolution of the media.
+                    "uri": "A String", # The URI of the video.
+                  },
+                },
+                "listValue": { # `ListValue` is a wrapper around a repeated field of values. # Represents a repeated `Value`.
+                  "values": [ # Repeated field of dynamically typed values.
+                    # Object with schema name: GenaiVertexV1Value
+                  ],
+                },
+                "nullValue": "A String", # Represents a null value.
+                "numberValue": 3.14, # Represents a double value.
+                "stringValue": "A String", # Represents a string value.
+                "structValue": # Object with schema name: GenaiVertexV1Struct # Represents a structured value.
+              },
+            },
+            "googleMapsResult": { # Google Maps result step.
+              "result": [
+                { # The result of the Google Maps.
+                  "places": [
+                    {
+                      "name": "A String",
+                      "placeId": "A String",
+                      "reviewSnippets": [
+                        { # Encapsulates a snippet of a user review that answers a question about the features of a specific place in Google Maps.
+                          "reviewId": "A String", # The ID of the review snippet.
+                          "title": "A String", # Title of the review.
+                          "url": "A String", # A link that corresponds to the user review on Google Maps.
+                        },
+                      ],
+                      "url": "A String",
+                    },
+                  ],
+                  "widgetContextToken": "A String",
+                },
+              ],
+            },
+            "googleSearchResult": { # Google Search result step.
+              "isError": True or False, # Whether the Google Search resulted in an error.
+              "result": [ # Required. The results of the Google Search.
+                { # The result of the Google Search.
+                  "searchSuggestions": "A String", # Web content snippet that can be embedded in a web page or an app webview.
+                },
+              ],
+            },
+            "processingResult": { # The result of a server-initiated media processing step.
+            },
+            "retrievalResult": { # Vertex Retrieval result step. Used by Vertex Retrieval tools such as Parallel AI, Exa AI, Vertex AI Search, etc.
+              "isError": True or False, # Whether the retrieval resulted in an error.
+            },
+            "signature": "A String", # A signature hash for backend validation.
+            "urlContextResult": { # URL context result step.
+              "isError": True or False, # Whether the URL context resulted in an error.
+              "result": [ # Required. The results of the URL context.
+                { # The result of the URL context.
+                  "status": "A String", # The status of the URL retrieval.
+                  "url": "A String", # The URL that was fetched.
+                },
+              ],
+            },
+          },
+          "userInput": { # Input provided by the user. # DO NOT USE -- These are for 3P JSON only
+            "contentList": { # A list of Content. # The content of the step. An array of Content objects.
+              "contents": [ # The contents of the list.
+                { # The content of the response.
+                  "audio": { # An audio content block.
+                    "channels": 42, # The number of audio channels.
+                    "data": "A String", # The audio content.
+                    "mimeTypeString": "A String", # Flexible MIME type string of the audio, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                    "sampleRate": 42, # The sample rate of the audio.
+                    "uri": "A String", # The URI of the audio.
+                  },
+                  "document": { # A document content block.
+                    "data": "A String", # The document content.
+                    "mimeTypeString": "A String", # Flexible MIME type string of the document, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                    "uri": "A String", # The URI of the document.
+                  },
+                  "image": { # An image content block.
+                    "data": "A String", # The image content.
+                    "mimeTypeString": "A String", # Flexible MIME type string of the image, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                    "resolution": "A String", # The resolution of the media.
+                    "uri": "A String", # The URI of the image.
+                  },
+                  "text": { # A text content block.
+                    "annotations": [ # Citation information for model-generated content.
+                      { # Citation information for model-generated content.
+                        "endIndex": 42, # End of the attributed segment, exclusive.
+                        "fileCitation": { # A file citation annotation. # A file citation annotation.
+                          "customMetadata": { # User provided metadata about the retrieved context.
+                            "a_key": "", # Properties of the object.
+                          },
+                          "documentUri": "A String", # The URI of the file.
+                          "fileName": "A String", # The name of the file.
+                          "mediaId": "A String", # Media ID in-case of image citations, if applicable.
+                          "pageNumber": 42, # Page number of the cited document, if applicable.
+                          "source": "A String", # Source attributed for a portion of the text.
+                        },
+                        "placeCitation": { # A place citation annotation. # A place citation annotation.
+                          "name": "A String", # Title of the place.
+                          "placeId": "A String", # The ID of the place, in `places/{place_id}` format.
+                          "reviewSnippets": [ # Snippets of reviews that are used to generate answers about the features of a given place in Google Maps.
+                            { # Encapsulates a snippet of a user review that answers a question about the features of a specific place in Google Maps.
+                              "reviewId": "A String", # The ID of the review snippet.
+                              "title": "A String", # Title of the review.
+                              "url": "A String", # A link that corresponds to the user review on Google Maps.
+                            },
+                          ],
+                          "url": "A String", # URI reference of the place.
+                        },
+                        "speechMetadata": { # Speech annotation for text content. # Speech annotation for text content.
+                          "speaker": "A String", # The speaker to associate with this turn.
+                          "style": "A String", # Style instruction for the speech synthesis.
+                        },
+                        "startIndex": 42, # Start of segment of the response that is attributed to this source. Index indicates the start of the segment, measured in bytes.
+                        "urlCitation": { # A URL citation annotation. # NOTE: We use these instead of the Citation message for historical reasons. A URL citation annotation.
+                          "title": "A String", # The title of the URL.
+                          "url": "A String", # The URL.
+                        },
+                        "wordInfo": { # Word-level ASR annotation for transcription output. Carries the word text, optional timing, and optional speaker attribution. # Word-level ASR annotation with timing and speaker info.
+                          "endOffset": "A String", # End offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                          "speaker": "A String", # Optional. Speaker label for this word (e.g. "spk_1", "spk_2"). Present when diarization_mode is set in TranscriptionConfig.
+                          "startOffset": "A String", # Start offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                          "text": "A String", # The transcribed word.
+                        },
+                      },
+                    ],
+                    "text": "A String", # Required. The text content.
+                  },
+                  "video": { # A video content block.
+                    "data": "A String", # The video content.
+                    "mimeTypeString": "A String", # Flexible MIME type string of the video, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                    "name": "A String", # A user-defined name for this content block. Can be referenced by the model in the final response.
+                    "processingConfig": {
+                      "static": {
+                        "endOffset": "A String", # Optional. Segment end time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "30s". Must be non-negative and greater than `start_offset` if `start_offset` is set.
+                        "fps": 3.14, # Optional. Video frame-rate sampling density.
+                        "startOffset": "A String", # Optional. Segment start time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "10.5s". Must be non-negative.
+                      },
+                    },
+                    "processingType": "A String",
+                    "resolution": "A String", # The resolution of the media.
+                    "uri": "A String", # The URI of the video.
+                  },
+                },
+              ],
+            },
+            "contentString": "A String", # The content of the step. A single string.
+          },
+        },
+      ],
+      "stringContent": "A String", # A string input for the interaction, it will be processed as a single text input.
+      "systemInstruction": "A String", # System instruction for the interaction.
+      "tools": [ # A list of tool declarations the model may call during interaction.
+        { # A tool that can be used by the model.
+          "codeExecution": { # A tool that can be used by the model to execute code. # A tool that can be used by the model to execute code.
+          },
+          "computerUse": { # A tool that can be used by the model to interact with the computer. # Tool to support the model interacting directly with the computer.
+            "disabledSafetyPolicies": [ # Optional. Disabled safety policies for computer use.
+              "A String",
+            ],
+            "enablePromptInjectionDetection": True or False, # Whether enable the prompt injection detection check on computer-use request.
+            "environment": "A String", # The environment being operated.
+            "excludedPredefinedFunctions": [ # The list of predefined functions that are excluded from the model call.
+              "A String",
+            ],
+          },
+          "fileSearch": { # A tool that can be used by the model to search files. # A tool that can be used by the model to search files.
+            "fileSearchStoreNames": [ # The file search store names to search.
+              "A String",
+            ],
+            "metadataFilter": "A String", # Metadata filter to apply to the semantic retrieval documents and chunks.
+            "topK": 42, # The number of semantic retrieval chunks to retrieve.
+          },
+          "function": { # A tool that can be used by the model. # A function that can be used by the model.
+            "description": "A String", # A description of the function.
+            "name": "A String", # The name of the function.
+            "parameters": { # `Value` represents a dynamically typed value which can be either null, a number, a string, a boolean, a recursive struct value, or a list of values. A producer of value is expected to set one of these variants. Absence of any variant indicates an error. # The JSON Schema for the function's parameters.
+              "boolValue": True or False, # Represents a boolean value.
+              "contentValue": { # The content of the response. # Represents rich content (text, image, etc.).
+                "audio": { # An audio content block.
+                  "channels": 42, # The number of audio channels.
+                  "data": "A String", # The audio content.
+                  "mimeTypeString": "A String", # Flexible MIME type string of the audio, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                  "sampleRate": 42, # The sample rate of the audio.
+                  "uri": "A String", # The URI of the audio.
+                },
+                "document": { # A document content block.
+                  "data": "A String", # The document content.
+                  "mimeTypeString": "A String", # Flexible MIME type string of the document, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                  "uri": "A String", # The URI of the document.
+                },
+                "image": { # An image content block.
+                  "data": "A String", # The image content.
+                  "mimeTypeString": "A String", # Flexible MIME type string of the image, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                  "resolution": "A String", # The resolution of the media.
+                  "uri": "A String", # The URI of the image.
+                },
+                "text": { # A text content block.
+                  "annotations": [ # Citation information for model-generated content.
+                    { # Citation information for model-generated content.
+                      "endIndex": 42, # End of the attributed segment, exclusive.
+                      "fileCitation": { # A file citation annotation. # A file citation annotation.
+                        "customMetadata": { # User provided metadata about the retrieved context.
+                          "a_key": "", # Properties of the object.
+                        },
+                        "documentUri": "A String", # The URI of the file.
+                        "fileName": "A String", # The name of the file.
+                        "mediaId": "A String", # Media ID in-case of image citations, if applicable.
+                        "pageNumber": 42, # Page number of the cited document, if applicable.
+                        "source": "A String", # Source attributed for a portion of the text.
+                      },
+                      "placeCitation": { # A place citation annotation. # A place citation annotation.
+                        "name": "A String", # Title of the place.
+                        "placeId": "A String", # The ID of the place, in `places/{place_id}` format.
+                        "reviewSnippets": [ # Snippets of reviews that are used to generate answers about the features of a given place in Google Maps.
+                          { # Encapsulates a snippet of a user review that answers a question about the features of a specific place in Google Maps.
+                            "reviewId": "A String", # The ID of the review snippet.
+                            "title": "A String", # Title of the review.
+                            "url": "A String", # A link that corresponds to the user review on Google Maps.
+                          },
+                        ],
+                        "url": "A String", # URI reference of the place.
+                      },
+                      "speechMetadata": { # Speech annotation for text content. # Speech annotation for text content.
+                        "speaker": "A String", # The speaker to associate with this turn.
+                        "style": "A String", # Style instruction for the speech synthesis.
+                      },
+                      "startIndex": 42, # Start of segment of the response that is attributed to this source. Index indicates the start of the segment, measured in bytes.
+                      "urlCitation": { # A URL citation annotation. # NOTE: We use these instead of the Citation message for historical reasons. A URL citation annotation.
+                        "title": "A String", # The title of the URL.
+                        "url": "A String", # The URL.
+                      },
+                      "wordInfo": { # Word-level ASR annotation for transcription output. Carries the word text, optional timing, and optional speaker attribution. # Word-level ASR annotation with timing and speaker info.
+                        "endOffset": "A String", # End offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                        "speaker": "A String", # Optional. Speaker label for this word (e.g. "spk_1", "spk_2"). Present when diarization_mode is set in TranscriptionConfig.
+                        "startOffset": "A String", # Start offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                        "text": "A String", # The transcribed word.
+                      },
+                    },
+                  ],
+                  "text": "A String", # Required. The text content.
+                },
+                "video": { # A video content block.
+                  "data": "A String", # The video content.
+                  "mimeTypeString": "A String", # Flexible MIME type string of the video, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                  "name": "A String", # A user-defined name for this content block. Can be referenced by the model in the final response.
+                  "processingConfig": {
+                    "static": {
+                      "endOffset": "A String", # Optional. Segment end time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "30s". Must be non-negative and greater than `start_offset` if `start_offset` is set.
+                      "fps": 3.14, # Optional. Video frame-rate sampling density.
+                      "startOffset": "A String", # Optional. Segment start time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "10.5s". Must be non-negative.
+                    },
+                  },
+                  "processingType": "A String",
+                  "resolution": "A String", # The resolution of the media.
+                  "uri": "A String", # The URI of the video.
+                },
+              },
+              "listValue": { # `ListValue` is a wrapper around a repeated field of values. # Represents a repeated `Value`.
+                "values": [ # Repeated field of dynamically typed values.
+                  # Object with schema name: GenaiVertexV1Value
+                ],
+              },
+              "nullValue": "A String", # Represents a null value.
+              "numberValue": 3.14, # Represents a double value.
+              "stringValue": "A String", # Represents a string value.
+              "structValue": # Object with schema name: GenaiVertexV1Struct # Represents a structured value.
+            },
+          },
+          "googleMaps": { # A tool that can be used by the model to call Google Maps. # A tool that can be used by the model to search Google Maps.
+            "enableWidget": True or False, # Whether to return a widget context token in the tool call result of the response.
+            "latitude": 3.14, # The latitude of the user's location.
+            "longitude": 3.14, # The longitude of the user's location.
+          },
+          "googleSearch": { # A tool that can be used by the model to search Google. # A tool that can be used by the model to search Google.
+            "searchTypes": [ # The types of search grounding to enable.
+              "A String",
+            ],
+          },
+          "mcpServer": { # A MCPServer is a server that can be called by the model to perform actions. # A MCPServer is a server that can be called by the model to perform actions.
+            "allowedTools": [ # The allowed tools.
+              { # The configuration for allowed tools.
+                "mode": "A String", # The mode of the tool choice.
+                "tools": [ # The names of the allowed tools.
+                  "A String",
+                ],
+              },
+            ],
+            "headers": { # Optional: Fields for authentication headers, timeouts, etc., if needed.
+              "a_key": "A String",
+            },
+            "name": "A String", # The name of the MCPServer.
+            "url": "A String", # The full URL for the MCPServer endpoint. Example: "https://api.example.com/mcp"
+          },
+          "retrieval": { # A tool that can be used by the model to retrieve files. # A tool that can be used by the model to retrieve files.
+            "exaAiSearchConfig": { # Used to specify configuration for ExaAISearch. # Used to specify configuration for ExaAISearch.
+              "apiKey": "A String", # Required. The API key for ExaAiSearch.
+              "customConfig": { # Optional. This field can be used to pass any parameter from the Exa.ai Search API.
+                "a_key": "", # Properties of the object.
+              },
+            },
+            "parallelAiSearchConfig": { # Used to specify configuration for ParallelAISearch. # Used to specify configuration for ParallelAISearch.
+              "apiKey": "A String", # Optional. The API key for ParallelAiSearch.
+              "customConfig": { # Optional. Custom configs for ParallelAiSearch.
+                "a_key": "", # Properties of the object.
+              },
+            },
+            "ragStoreConfig": { # Use to specify configuration for RAG Store. # Used to specify configuration for RagStore.
+              "ragResources": [ # Optional. The representation of the rag source.
+                { # The definition of the Rag resource.
+                  "ragCorpus": "A String", # Optional. RagCorpora resource name.
+                  "ragFileIds": [ # Optional. rag_file_id. The files should be in the same rag_corpus set in rag_corpus field.
+                    "A String",
+                  ],
+                },
+              ],
+              "ragRetrievalConfig": { # Specifies the context retrieval config. # Optional. The retrieval config for the Rag query.
+                "filter": { # Config for filters. # Optional. Config for filters.
+                  "metadataFilter": "A String", # Optional. String for metadata filtering.
+                  "vectorDistanceThreshold": 3.14, # Optional. Only returns contexts with vector distance smaller than the threshold.
+                  "vectorSimilarityThreshold": 3.14, # Optional. Only returns contexts with vector similarity larger than the threshold.
+                },
+                "hybridSearch": { # Config for Hybrid Search. # Optional. Config for Hybrid Search.
+                  "alpha": 3.14, # Optional. Alpha value controls the weight between dense and sparse vector search results.
+                },
+                "ranking": { # Config for ranking and reranking. # Optional. Config for ranking and reranking.
+                  "rankService": { # Config for Rank Service. # Config for Rank Service.
+                    "modelName": "A String", # Optional. The model name of the rank service.
+                  },
+                },
+                "topK": 42, # Optional. The number of contexts to retrieve.
+              },
+            },
+            "retrievalTypes": [ # The types of file retrieval to enable.
+              "A String",
+            ],
+            "vertexAiSearchConfig": { # Used to specify configuration for VertexAISearch. # Used to specify configuration for VertexAISearch.
+              "datastores": [ # Optional. Used to specify Vertex AI Search datastores.
+                "A String",
+              ],
+              "engine": "A String", # Optional. Used to specify Vertex AI Search engine.
+            },
+          },
+          "urlContext": { # A tool that can be used by the model to fetch URL context. # A tool that can be used by the model to fetch URL context.
+          },
+        },
+      ],
+      "updated": "A String", # Required. Output only. The time at which the response was last updated in ISO 8601 format (YYYY-MM-DDThh:mm:ssZ).
+      "usage": { # Statistics on the interaction request's token usage. # Output only. Statistics on the interaction request's token usage.
+        "cachedTokensByModality": [ # A breakdown of cached token usage by modality.
+          { # The token count for a single response modality.
+            "modality": "A String", # The modality associated with the token count.
+            "tokens": 42, # Number of tokens for the modality.
+          },
+        ],
+        "groundingToolCount": [ # Grounding tool count.
+          { # The number of grounding tool counts.
+            "count": 42, # The number of grounding tool counts.
+            "type": "A String", # The grounding tool type associated with the count.
+          },
+        ],
+        "inputTokensByModality": [ # A breakdown of input token usage by modality.
+          { # The token count for a single response modality.
+            "modality": "A String", # The modality associated with the token count.
+            "tokens": 42, # Number of tokens for the modality.
+          },
+        ],
+        "outputTokensByModality": [ # A breakdown of output token usage by modality.
+          { # The token count for a single response modality.
+            "modality": "A String", # The modality associated with the token count.
+            "tokens": 42, # Number of tokens for the modality.
+          },
+        ],
+        "toolUseTokensByModality": [ # A breakdown of tool-use token usage by modality.
+          { # The token count for a single response modality.
+            "modality": "A String", # The modality associated with the token count.
+            "tokens": 42, # Number of tokens for the modality.
+          },
+        ],
+        "totalCachedTokens": 42, # Number of tokens in the cached part of the prompt (the cached content).
+        "totalInputTokens": 42, # Number of tokens in the prompt (context).
+        "totalOutputTokens": 42, # Total number of tokens across all the generated responses.
+        "totalThoughtTokens": 42, # Number of tokens of thoughts for thinking models.
+        "totalTokens": 42, # Total token count for the interaction request (prompt + responses + other internal tokens).
+        "totalToolUseTokens": 42, # Number of tokens present in tool-use prompt(s).
+      },
+    },
+  },
+  "interactionStatusUpdate": { # The interaction status data, used for interaction.status_update events.
+    "interactionId": "A String",
+    "status": "A String",
+    "usage": { # Statistics on the interaction request's token usage. # Model usage statistics up to this checkpoint.
+      "cachedTokensByModality": [ # A breakdown of cached token usage by modality.
+        { # The token count for a single response modality.
+          "modality": "A String", # The modality associated with the token count.
+          "tokens": 42, # Number of tokens for the modality.
+        },
+      ],
+      "groundingToolCount": [ # Grounding tool count.
+        { # The number of grounding tool counts.
+          "count": 42, # The number of grounding tool counts.
+          "type": "A String", # The grounding tool type associated with the count.
+        },
+      ],
+      "inputTokensByModality": [ # A breakdown of input token usage by modality.
+        { # The token count for a single response modality.
+          "modality": "A String", # The modality associated with the token count.
+          "tokens": 42, # Number of tokens for the modality.
+        },
+      ],
+      "outputTokensByModality": [ # A breakdown of output token usage by modality.
+        { # The token count for a single response modality.
+          "modality": "A String", # The modality associated with the token count.
+          "tokens": 42, # Number of tokens for the modality.
+        },
+      ],
+      "toolUseTokensByModality": [ # A breakdown of tool-use token usage by modality.
+        { # The token count for a single response modality.
+          "modality": "A String", # The modality associated with the token count.
+          "tokens": 42, # Number of tokens for the modality.
+        },
+      ],
+      "totalCachedTokens": 42, # Number of tokens in the cached part of the prompt (the cached content).
+      "totalInputTokens": 42, # Number of tokens in the prompt (context).
+      "totalOutputTokens": 42, # Total number of tokens across all the generated responses.
+      "totalThoughtTokens": 42, # Number of tokens of thoughts for thinking models.
+      "totalTokens": 42, # Total token count for the interaction request (prompt + responses + other internal tokens).
+      "totalToolUseTokens": 42, # Number of tokens present in tool-use prompt(s).
+    },
+  },
+  "stepDelta": { # The step delta data, used for step.delta events. Step-based streaming event, used when steps are enabled.
+    "delta": {
+      "argumentsDelta": {
+        "arguments": "A String",
+      },
+      "audio": {
+        "channels": 42, # The number of audio channels.
+        "data": "A String",
+        "mimeType": "A String",
+        "sampleRate": 42, # The sample rate of the audio.
+        "uri": "A String",
+      },
+      "document": {
+        "data": "A String",
+        "mimeType": "A String",
+        "uri": "A String",
+      },
+      "functionResult": {
+        "isError": True or False,
+        "name": "A String",
+        "result": { # `Value` represents a dynamically typed value which can be either null, a number, a string, a boolean, a recursive struct value, or a list of values. A producer of value is expected to set one of these variants. Absence of any variant indicates an error.
+          "boolValue": True or False, # Represents a boolean value.
+          "contentValue": { # The content of the response. # Represents rich content (text, image, etc.).
+            "audio": { # An audio content block.
+              "channels": 42, # The number of audio channels.
+              "data": "A String", # The audio content.
+              "mimeTypeString": "A String", # Flexible MIME type string of the audio, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+              "sampleRate": 42, # The sample rate of the audio.
+              "uri": "A String", # The URI of the audio.
+            },
+            "document": { # A document content block.
+              "data": "A String", # The document content.
+              "mimeTypeString": "A String", # Flexible MIME type string of the document, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+              "uri": "A String", # The URI of the document.
+            },
+            "image": { # An image content block.
+              "data": "A String", # The image content.
+              "mimeTypeString": "A String", # Flexible MIME type string of the image, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+              "resolution": "A String", # The resolution of the media.
+              "uri": "A String", # The URI of the image.
+            },
+            "text": { # A text content block.
+              "annotations": [ # Citation information for model-generated content.
+                { # Citation information for model-generated content.
+                  "endIndex": 42, # End of the attributed segment, exclusive.
+                  "fileCitation": { # A file citation annotation. # A file citation annotation.
+                    "customMetadata": { # User provided metadata about the retrieved context.
+                      "a_key": "", # Properties of the object.
+                    },
+                    "documentUri": "A String", # The URI of the file.
+                    "fileName": "A String", # The name of the file.
+                    "mediaId": "A String", # Media ID in-case of image citations, if applicable.
+                    "pageNumber": 42, # Page number of the cited document, if applicable.
+                    "source": "A String", # Source attributed for a portion of the text.
+                  },
+                  "placeCitation": { # A place citation annotation. # A place citation annotation.
+                    "name": "A String", # Title of the place.
+                    "placeId": "A String", # The ID of the place, in `places/{place_id}` format.
+                    "reviewSnippets": [ # Snippets of reviews that are used to generate answers about the features of a given place in Google Maps.
+                      { # Encapsulates a snippet of a user review that answers a question about the features of a specific place in Google Maps.
+                        "reviewId": "A String", # The ID of the review snippet.
+                        "title": "A String", # Title of the review.
+                        "url": "A String", # A link that corresponds to the user review on Google Maps.
+                      },
+                    ],
+                    "url": "A String", # URI reference of the place.
+                  },
+                  "speechMetadata": { # Speech annotation for text content. # Speech annotation for text content.
+                    "speaker": "A String", # The speaker to associate with this turn.
+                    "style": "A String", # Style instruction for the speech synthesis.
+                  },
+                  "startIndex": 42, # Start of segment of the response that is attributed to this source. Index indicates the start of the segment, measured in bytes.
+                  "urlCitation": { # A URL citation annotation. # NOTE: We use these instead of the Citation message for historical reasons. A URL citation annotation.
+                    "title": "A String", # The title of the URL.
+                    "url": "A String", # The URL.
+                  },
+                  "wordInfo": { # Word-level ASR annotation for transcription output. Carries the word text, optional timing, and optional speaker attribution. # Word-level ASR annotation with timing and speaker info.
+                    "endOffset": "A String", # End offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                    "speaker": "A String", # Optional. Speaker label for this word (e.g. "spk_1", "spk_2"). Present when diarization_mode is set in TranscriptionConfig.
+                    "startOffset": "A String", # Start offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                    "text": "A String", # The transcribed word.
+                  },
+                },
+              ],
+              "text": "A String", # Required. The text content.
+            },
+            "video": { # A video content block.
+              "data": "A String", # The video content.
+              "mimeTypeString": "A String", # Flexible MIME type string of the video, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+              "name": "A String", # A user-defined name for this content block. Can be referenced by the model in the final response.
+              "processingConfig": {
+                "static": {
+                  "endOffset": "A String", # Optional. Segment end time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "30s". Must be non-negative and greater than `start_offset` if `start_offset` is set.
+                  "fps": 3.14, # Optional. Video frame-rate sampling density.
+                  "startOffset": "A String", # Optional. Segment start time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "10.5s". Must be non-negative.
+                },
+              },
+              "processingType": "A String",
+              "resolution": "A String", # The resolution of the media.
+              "uri": "A String", # The URI of the video.
+            },
+          },
+          "listValue": { # `ListValue` is a wrapper around a repeated field of values. # Represents a repeated `Value`.
+            "values": [ # Repeated field of dynamically typed values.
+              # Object with schema name: GenaiVertexV1Value
+            ],
+          },
+          "nullValue": "A String", # Represents a null value.
+          "numberValue": 3.14, # Represents a double value.
+          "stringValue": "A String", # Represents a string value.
+          "structValue": # Object with schema name: GenaiVertexV1Struct # Represents a structured value.
+        },
+      },
+      "image": {
+        "data": "A String",
+        "mimeType": "A String",
+        "resolution": "A String", # The resolution of the media.
+        "uri": "A String",
+      },
+      "serverToolCall": {
+        "codeExecutionCall": {
+          "arguments": { # The arguments to pass to the code execution.
+            "code": "A String", # The code to be executed.
+            "language": "A String", # Programming language of the `code`.
+          },
+        },
+        "fileSearchCall": {
+        },
+        "googleMapsCall": {
+          "arguments": { # The arguments to pass to the Google Maps tool. # The arguments to pass to the Google Maps tool.
+            "queries": [ # The queries to be executed.
+              "A String",
+            ],
+          },
+        },
+        "googleSearchCall": {
+          "arguments": { # The arguments to pass to Google Search.
+            "queries": [ # Web search queries for the following-up web search.
+              "A String",
+            ],
+          },
+        },
+        "processingCall": { # Streaming delta for a server-initiated media processing step.
+        },
+        "retrievalCall": { # Used by Vertex Retrieval tools such as Parallel AI, Exa AI, Vertex AI Search, etc. RetrievalType decides which tool is used.
+          "arguments": { # The arguments to pass to Retrieval tools. # Required. The arguments to pass to the Retrieval tool.
+            "queries": [ # Queries for Retrieval information.
+              "A String",
+            ],
+          },
+          "retrievalType": "A String", # The type of retrieval tools.
+        },
+        "signature": "A String", # A signature hash for backend validation.
+        "urlContextCall": {
+          "arguments": { # The arguments to pass to the URL context.
+            "urls": [ # The URLs to fetch.
+              "A String",
+            ],
+          },
+        },
+      },
+      "serverToolResult": {
+        "codeExecutionResult": {
+          "isError": True or False,
+          "result": "A String",
+        },
+        "fileSearchResult": {
+          "result": [
+            { # The result of the File Search.
+            },
+          ],
+        },
+        "googleMapsResult": {
+          "result": [ # The results of the Google Maps.
+            { # The result of the Google Maps.
+              "places": [ # The places that were found.
+                {
+                  "name": "A String", # Title of the place.
+                  "placeId": "A String", # The ID of the place, in `places/{place_id}` format.
+                  "reviewSnippets": [ # Snippets of reviews that are used to generate answers about the features of a given place in Google Maps.
+                    { # Encapsulates a snippet of a user review that answers a question about the features of a specific place in Google Maps.
+                      "reviewId": "A String", # The ID of the review snippet.
+                      "title": "A String", # Title of the review.
+                      "url": "A String", # A link that corresponds to the user review on Google Maps.
+                    },
+                  ],
+                  "url": "A String", # URI reference of the place.
+                },
+              ],
+              "widgetContextToken": "A String", # Resource name of the Google Maps widget context token.
+            },
+          ],
+        },
+        "googleSearchResult": {
+          "isError": True or False,
+          "result": [
+            { # The result of the Google Search.
+              "searchSuggestions": "A String", # Web content snippet that can be embedded in a web page or an app webview.
+            },
+          ],
+        },
+        "processingResult": { # Streaming delta for the result of a server-initiated media processing step.
+        },
+        "retrievalResult": { # Used by Vertex Retrieval tools such as Parallel AI, Exa AI, Vertex AI Search, etc. ToolResultDelta.type
+          "isError": True or False, # Whether the retrieval resulted in an error.
+        },
+        "signature": "A String", # A signature hash for backend validation.
+        "urlContextResult": {
+          "isError": True or False,
+          "result": [
+            { # The result of the URL context.
+              "status": "A String", # The status of the URL retrieval.
+              "url": "A String", # The URL that was fetched.
+            },
+          ],
+        },
+      },
+      "text": {
+        "text": "A String",
+      },
+      "textAnnotationDelta": {
+        "annotations": [ # Citation information for model-generated content.
+          { # Citation information for model-generated content.
+            "endIndex": 42, # End of the attributed segment, exclusive.
+            "fileCitation": { # A file citation annotation. # A file citation annotation.
+              "customMetadata": { # User provided metadata about the retrieved context.
+                "a_key": "", # Properties of the object.
+              },
+              "documentUri": "A String", # The URI of the file.
+              "fileName": "A String", # The name of the file.
+              "mediaId": "A String", # Media ID in-case of image citations, if applicable.
+              "pageNumber": 42, # Page number of the cited document, if applicable.
+              "source": "A String", # Source attributed for a portion of the text.
+            },
+            "placeCitation": { # A place citation annotation. # A place citation annotation.
+              "name": "A String", # Title of the place.
+              "placeId": "A String", # The ID of the place, in `places/{place_id}` format.
+              "reviewSnippets": [ # Snippets of reviews that are used to generate answers about the features of a given place in Google Maps.
+                { # Encapsulates a snippet of a user review that answers a question about the features of a specific place in Google Maps.
+                  "reviewId": "A String", # The ID of the review snippet.
+                  "title": "A String", # Title of the review.
+                  "url": "A String", # A link that corresponds to the user review on Google Maps.
+                },
+              ],
+              "url": "A String", # URI reference of the place.
+            },
+            "speechMetadata": { # Speech annotation for text content. # Speech annotation for text content.
+              "speaker": "A String", # The speaker to associate with this turn.
+              "style": "A String", # Style instruction for the speech synthesis.
+            },
+            "startIndex": 42, # Start of segment of the response that is attributed to this source. Index indicates the start of the segment, measured in bytes.
+            "urlCitation": { # A URL citation annotation. # NOTE: We use these instead of the Citation message for historical reasons. A URL citation annotation.
+              "title": "A String", # The title of the URL.
+              "url": "A String", # The URL.
+            },
+            "wordInfo": { # Word-level ASR annotation for transcription output. Carries the word text, optional timing, and optional speaker attribution. # Word-level ASR annotation with timing and speaker info.
+              "endOffset": "A String", # End offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+              "speaker": "A String", # Optional. Speaker label for this word (e.g. "spk_1", "spk_2"). Present when diarization_mode is set in TranscriptionConfig.
+              "startOffset": "A String", # Start offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+              "text": "A String", # The transcribed word.
+            },
+          },
+        ],
+      },
+      "thoughtSignature": {
+        "signature": "A String", # Signature to match the backend source to be part of the generation.
+      },
+      "thoughtSummary": {
+        "content": { # The content of the response. # A new summary item to be added to the thought.
+          "audio": { # An audio content block.
+            "channels": 42, # The number of audio channels.
+            "data": "A String", # The audio content.
+            "mimeTypeString": "A String", # Flexible MIME type string of the audio, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+            "sampleRate": 42, # The sample rate of the audio.
+            "uri": "A String", # The URI of the audio.
+          },
+          "document": { # A document content block.
+            "data": "A String", # The document content.
+            "mimeTypeString": "A String", # Flexible MIME type string of the document, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+            "uri": "A String", # The URI of the document.
+          },
+          "image": { # An image content block.
+            "data": "A String", # The image content.
+            "mimeTypeString": "A String", # Flexible MIME type string of the image, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+            "resolution": "A String", # The resolution of the media.
+            "uri": "A String", # The URI of the image.
+          },
+          "text": { # A text content block.
+            "annotations": [ # Citation information for model-generated content.
+              { # Citation information for model-generated content.
+                "endIndex": 42, # End of the attributed segment, exclusive.
+                "fileCitation": { # A file citation annotation. # A file citation annotation.
+                  "customMetadata": { # User provided metadata about the retrieved context.
+                    "a_key": "", # Properties of the object.
+                  },
+                  "documentUri": "A String", # The URI of the file.
+                  "fileName": "A String", # The name of the file.
+                  "mediaId": "A String", # Media ID in-case of image citations, if applicable.
+                  "pageNumber": 42, # Page number of the cited document, if applicable.
+                  "source": "A String", # Source attributed for a portion of the text.
+                },
+                "placeCitation": { # A place citation annotation. # A place citation annotation.
+                  "name": "A String", # Title of the place.
+                  "placeId": "A String", # The ID of the place, in `places/{place_id}` format.
+                  "reviewSnippets": [ # Snippets of reviews that are used to generate answers about the features of a given place in Google Maps.
+                    { # Encapsulates a snippet of a user review that answers a question about the features of a specific place in Google Maps.
+                      "reviewId": "A String", # The ID of the review snippet.
+                      "title": "A String", # Title of the review.
+                      "url": "A String", # A link that corresponds to the user review on Google Maps.
+                    },
+                  ],
+                  "url": "A String", # URI reference of the place.
+                },
+                "speechMetadata": { # Speech annotation for text content. # Speech annotation for text content.
+                  "speaker": "A String", # The speaker to associate with this turn.
+                  "style": "A String", # Style instruction for the speech synthesis.
+                },
+                "startIndex": 42, # Start of segment of the response that is attributed to this source. Index indicates the start of the segment, measured in bytes.
+                "urlCitation": { # A URL citation annotation. # NOTE: We use these instead of the Citation message for historical reasons. A URL citation annotation.
+                  "title": "A String", # The title of the URL.
+                  "url": "A String", # The URL.
+                },
+                "wordInfo": { # Word-level ASR annotation for transcription output. Carries the word text, optional timing, and optional speaker attribution. # Word-level ASR annotation with timing and speaker info.
+                  "endOffset": "A String", # End offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                  "speaker": "A String", # Optional. Speaker label for this word (e.g. "spk_1", "spk_2"). Present when diarization_mode is set in TranscriptionConfig.
+                  "startOffset": "A String", # Start offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                  "text": "A String", # The transcribed word.
+                },
+              },
+            ],
+            "text": "A String", # Required. The text content.
+          },
+          "video": { # A video content block.
+            "data": "A String", # The video content.
+            "mimeTypeString": "A String", # Flexible MIME type string of the video, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+            "name": "A String", # A user-defined name for this content block. Can be referenced by the model in the final response.
+            "processingConfig": {
+              "static": {
+                "endOffset": "A String", # Optional. Segment end time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "30s". Must be non-negative and greater than `start_offset` if `start_offset` is set.
+                "fps": 3.14, # Optional. Video frame-rate sampling density.
+                "startOffset": "A String", # Optional. Segment start time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "10.5s". Must be non-negative.
+              },
+            },
+            "processingType": "A String",
+            "resolution": "A String", # The resolution of the media.
+            "uri": "A String", # The URI of the video.
+          },
+        },
+      },
+      "video": {
+        "data": "A String",
+        "mimeType": "A String",
+        "resolution": "A String", # The resolution of the media.
+        "uri": "A String",
+      },
+    },
+    "index": 42,
+  },
+  "stepStart": { # The step start data, used for step.start events. Step-based streaming event, used when steps are enabled.
+    "index": 42,
+    "step": { # A step in the interaction.
+      "modelOutput": { # Output generated by the model.
+        "content": [
+          { # The content of the response.
+            "audio": { # An audio content block.
+              "channels": 42, # The number of audio channels.
+              "data": "A String", # The audio content.
+              "mimeTypeString": "A String", # Flexible MIME type string of the audio, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+              "sampleRate": 42, # The sample rate of the audio.
+              "uri": "A String", # The URI of the audio.
+            },
+            "document": { # A document content block.
+              "data": "A String", # The document content.
+              "mimeTypeString": "A String", # Flexible MIME type string of the document, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+              "uri": "A String", # The URI of the document.
+            },
+            "image": { # An image content block.
+              "data": "A String", # The image content.
+              "mimeTypeString": "A String", # Flexible MIME type string of the image, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+              "resolution": "A String", # The resolution of the media.
+              "uri": "A String", # The URI of the image.
+            },
+            "text": { # A text content block.
+              "annotations": [ # Citation information for model-generated content.
+                { # Citation information for model-generated content.
+                  "endIndex": 42, # End of the attributed segment, exclusive.
+                  "fileCitation": { # A file citation annotation. # A file citation annotation.
+                    "customMetadata": { # User provided metadata about the retrieved context.
+                      "a_key": "", # Properties of the object.
+                    },
+                    "documentUri": "A String", # The URI of the file.
+                    "fileName": "A String", # The name of the file.
+                    "mediaId": "A String", # Media ID in-case of image citations, if applicable.
+                    "pageNumber": 42, # Page number of the cited document, if applicable.
+                    "source": "A String", # Source attributed for a portion of the text.
+                  },
+                  "placeCitation": { # A place citation annotation. # A place citation annotation.
+                    "name": "A String", # Title of the place.
+                    "placeId": "A String", # The ID of the place, in `places/{place_id}` format.
+                    "reviewSnippets": [ # Snippets of reviews that are used to generate answers about the features of a given place in Google Maps.
+                      { # Encapsulates a snippet of a user review that answers a question about the features of a specific place in Google Maps.
+                        "reviewId": "A String", # The ID of the review snippet.
+                        "title": "A String", # Title of the review.
+                        "url": "A String", # A link that corresponds to the user review on Google Maps.
+                      },
+                    ],
+                    "url": "A String", # URI reference of the place.
+                  },
+                  "speechMetadata": { # Speech annotation for text content. # Speech annotation for text content.
+                    "speaker": "A String", # The speaker to associate with this turn.
+                    "style": "A String", # Style instruction for the speech synthesis.
+                  },
+                  "startIndex": 42, # Start of segment of the response that is attributed to this source. Index indicates the start of the segment, measured in bytes.
+                  "urlCitation": { # A URL citation annotation. # NOTE: We use these instead of the Citation message for historical reasons. A URL citation annotation.
+                    "title": "A String", # The title of the URL.
+                    "url": "A String", # The URL.
+                  },
+                  "wordInfo": { # Word-level ASR annotation for transcription output. Carries the word text, optional timing, and optional speaker attribution. # Word-level ASR annotation with timing and speaker info.
+                    "endOffset": "A String", # End offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                    "speaker": "A String", # Optional. Speaker label for this word (e.g. "spk_1", "spk_2"). Present when diarization_mode is set in TranscriptionConfig.
+                    "startOffset": "A String", # Start offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                    "text": "A String", # The transcribed word.
+                  },
+                },
+              ],
+              "text": "A String", # Required. The text content.
+            },
+            "video": { # A video content block.
+              "data": "A String", # The video content.
+              "mimeTypeString": "A String", # Flexible MIME type string of the video, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+              "name": "A String", # A user-defined name for this content block. Can be referenced by the model in the final response.
+              "processingConfig": {
+                "static": {
+                  "endOffset": "A String", # Optional. Segment end time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "30s". Must be non-negative and greater than `start_offset` if `start_offset` is set.
+                  "fps": 3.14, # Optional. Video frame-rate sampling density.
+                  "startOffset": "A String", # Optional. Segment start time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "10.5s". Must be non-negative.
+                },
+              },
+              "processingType": "A String",
+              "resolution": "A String", # The resolution of the media.
+              "uri": "A String", # The URI of the video.
+            },
+          },
+        ],
+        "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.
+        },
+      },
+      "thought": { # A thought step.
+        "signature": "A String", # A signature hash for backend validation.
+        "summary": [ # A summary of the thought.
+          { # The content of the response.
+            "audio": { # An audio content block.
+              "channels": 42, # The number of audio channels.
+              "data": "A String", # The audio content.
+              "mimeTypeString": "A String", # Flexible MIME type string of the audio, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+              "sampleRate": 42, # The sample rate of the audio.
+              "uri": "A String", # The URI of the audio.
+            },
+            "document": { # A document content block.
+              "data": "A String", # The document content.
+              "mimeTypeString": "A String", # Flexible MIME type string of the document, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+              "uri": "A String", # The URI of the document.
+            },
+            "image": { # An image content block.
+              "data": "A String", # The image content.
+              "mimeTypeString": "A String", # Flexible MIME type string of the image, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+              "resolution": "A String", # The resolution of the media.
+              "uri": "A String", # The URI of the image.
+            },
+            "text": { # A text content block.
+              "annotations": [ # Citation information for model-generated content.
+                { # Citation information for model-generated content.
+                  "endIndex": 42, # End of the attributed segment, exclusive.
+                  "fileCitation": { # A file citation annotation. # A file citation annotation.
+                    "customMetadata": { # User provided metadata about the retrieved context.
+                      "a_key": "", # Properties of the object.
+                    },
+                    "documentUri": "A String", # The URI of the file.
+                    "fileName": "A String", # The name of the file.
+                    "mediaId": "A String", # Media ID in-case of image citations, if applicable.
+                    "pageNumber": 42, # Page number of the cited document, if applicable.
+                    "source": "A String", # Source attributed for a portion of the text.
+                  },
+                  "placeCitation": { # A place citation annotation. # A place citation annotation.
+                    "name": "A String", # Title of the place.
+                    "placeId": "A String", # The ID of the place, in `places/{place_id}` format.
+                    "reviewSnippets": [ # Snippets of reviews that are used to generate answers about the features of a given place in Google Maps.
+                      { # Encapsulates a snippet of a user review that answers a question about the features of a specific place in Google Maps.
+                        "reviewId": "A String", # The ID of the review snippet.
+                        "title": "A String", # Title of the review.
+                        "url": "A String", # A link that corresponds to the user review on Google Maps.
+                      },
+                    ],
+                    "url": "A String", # URI reference of the place.
+                  },
+                  "speechMetadata": { # Speech annotation for text content. # Speech annotation for text content.
+                    "speaker": "A String", # The speaker to associate with this turn.
+                    "style": "A String", # Style instruction for the speech synthesis.
+                  },
+                  "startIndex": 42, # Start of segment of the response that is attributed to this source. Index indicates the start of the segment, measured in bytes.
+                  "urlCitation": { # A URL citation annotation. # NOTE: We use these instead of the Citation message for historical reasons. A URL citation annotation.
+                    "title": "A String", # The title of the URL.
+                    "url": "A String", # The URL.
+                  },
+                  "wordInfo": { # Word-level ASR annotation for transcription output. Carries the word text, optional timing, and optional speaker attribution. # Word-level ASR annotation with timing and speaker info.
+                    "endOffset": "A String", # End offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                    "speaker": "A String", # Optional. Speaker label for this word (e.g. "spk_1", "spk_2"). Present when diarization_mode is set in TranscriptionConfig.
+                    "startOffset": "A String", # Start offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                    "text": "A String", # The transcribed word.
+                  },
+                },
+              ],
+              "text": "A String", # Required. The text content.
+            },
+            "video": { # A video content block.
+              "data": "A String", # The video content.
+              "mimeTypeString": "A String", # Flexible MIME type string of the video, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+              "name": "A String", # A user-defined name for this content block. Can be referenced by the model in the final response.
+              "processingConfig": {
+                "static": {
+                  "endOffset": "A String", # Optional. Segment end time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "30s". Must be non-negative and greater than `start_offset` if `start_offset` is set.
+                  "fps": 3.14, # Optional. Video frame-rate sampling density.
+                  "startOffset": "A String", # Optional. Segment start time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "10.5s". Must be non-negative.
+                },
+              },
+              "processingType": "A String",
+              "resolution": "A String", # The resolution of the media.
+              "uri": "A String", # The URI of the video.
+            },
+          },
+        ],
+      },
+      "toolCall": { # Tool call step.
+        "codeExecutionCall": { # Code execution call step.
+          "arguments": { # The arguments to pass to the code execution. # Required. The arguments to pass to the code execution.
+            "code": "A String", # The code to be executed.
+            "language": "A String", # Programming language of the `code`.
+          },
+        },
+        "fileSearchCall": { # File Search call step.
+        },
+        "functionCall": { # A function tool call step.
+          "arguments": { # `Struct` represents a structured data value, consisting of fields which map to dynamically typed values. # Required. The arguments to pass to the function.
+            "fields": [ # Dynamically typed fields. List instead of map because LLMs are sensitive to ordering, and we want to give users full control.
+              { # Represents a single field in a struct.
+                "name": "A String",
+                "value": { # `Value` represents a dynamically typed value which can be either null, a number, a string, a boolean, a recursive struct value, or a list of values. A producer of value is expected to set one of these variants. Absence of any variant indicates an error.
+                  "boolValue": True or False, # Represents a boolean value.
+                  "contentValue": { # The content of the response. # Represents rich content (text, image, etc.).
+                    "audio": { # An audio content block.
+                      "channels": 42, # The number of audio channels.
+                      "data": "A String", # The audio content.
+                      "mimeTypeString": "A String", # Flexible MIME type string of the audio, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                      "sampleRate": 42, # The sample rate of the audio.
+                      "uri": "A String", # The URI of the audio.
+                    },
+                    "document": { # A document content block.
+                      "data": "A String", # The document content.
+                      "mimeTypeString": "A String", # Flexible MIME type string of the document, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                      "uri": "A String", # The URI of the document.
+                    },
+                    "image": { # An image content block.
+                      "data": "A String", # The image content.
+                      "mimeTypeString": "A String", # Flexible MIME type string of the image, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                      "resolution": "A String", # The resolution of the media.
+                      "uri": "A String", # The URI of the image.
+                    },
+                    "text": { # A text content block.
+                      "annotations": [ # Citation information for model-generated content.
+                        { # Citation information for model-generated content.
+                          "endIndex": 42, # End of the attributed segment, exclusive.
+                          "fileCitation": { # A file citation annotation. # A file citation annotation.
+                            "customMetadata": { # User provided metadata about the retrieved context.
+                              "a_key": "", # Properties of the object.
+                            },
+                            "documentUri": "A String", # The URI of the file.
+                            "fileName": "A String", # The name of the file.
+                            "mediaId": "A String", # Media ID in-case of image citations, if applicable.
+                            "pageNumber": 42, # Page number of the cited document, if applicable.
+                            "source": "A String", # Source attributed for a portion of the text.
+                          },
+                          "placeCitation": { # A place citation annotation. # A place citation annotation.
+                            "name": "A String", # Title of the place.
+                            "placeId": "A String", # The ID of the place, in `places/{place_id}` format.
+                            "reviewSnippets": [ # Snippets of reviews that are used to generate answers about the features of a given place in Google Maps.
+                              { # Encapsulates a snippet of a user review that answers a question about the features of a specific place in Google Maps.
+                                "reviewId": "A String", # The ID of the review snippet.
+                                "title": "A String", # Title of the review.
+                                "url": "A String", # A link that corresponds to the user review on Google Maps.
+                              },
+                            ],
+                            "url": "A String", # URI reference of the place.
+                          },
+                          "speechMetadata": { # Speech annotation for text content. # Speech annotation for text content.
+                            "speaker": "A String", # The speaker to associate with this turn.
+                            "style": "A String", # Style instruction for the speech synthesis.
+                          },
+                          "startIndex": 42, # Start of segment of the response that is attributed to this source. Index indicates the start of the segment, measured in bytes.
+                          "urlCitation": { # A URL citation annotation. # NOTE: We use these instead of the Citation message for historical reasons. A URL citation annotation.
+                            "title": "A String", # The title of the URL.
+                            "url": "A String", # The URL.
+                          },
+                          "wordInfo": { # Word-level ASR annotation for transcription output. Carries the word text, optional timing, and optional speaker attribution. # Word-level ASR annotation with timing and speaker info.
+                            "endOffset": "A String", # End offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                            "speaker": "A String", # Optional. Speaker label for this word (e.g. "spk_1", "spk_2"). Present when diarization_mode is set in TranscriptionConfig.
+                            "startOffset": "A String", # Start offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                            "text": "A String", # The transcribed word.
+                          },
+                        },
+                      ],
+                      "text": "A String", # Required. The text content.
+                    },
+                    "video": { # A video content block.
+                      "data": "A String", # The video content.
+                      "mimeTypeString": "A String", # Flexible MIME type string of the video, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                      "name": "A String", # A user-defined name for this content block. Can be referenced by the model in the final response.
+                      "processingConfig": {
+                        "static": {
+                          "endOffset": "A String", # Optional. Segment end time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "30s". Must be non-negative and greater than `start_offset` if `start_offset` is set.
+                          "fps": 3.14, # Optional. Video frame-rate sampling density.
+                          "startOffset": "A String", # Optional. Segment start time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "10.5s". Must be non-negative.
+                        },
+                      },
+                      "processingType": "A String",
+                      "resolution": "A String", # The resolution of the media.
+                      "uri": "A String", # The URI of the video.
+                    },
+                  },
+                  "listValue": { # `ListValue` is a wrapper around a repeated field of values. # Represents a repeated `Value`.
+                    "values": [ # Repeated field of dynamically typed values.
+                      # Object with schema name: GenaiVertexV1Value
+                    ],
+                  },
+                  "nullValue": "A String", # Represents a null value.
+                  "numberValue": 3.14, # Represents a double value.
+                  "stringValue": "A String", # Represents a string value.
+                  "structValue": # Object with schema name: GenaiVertexV1Struct # Represents a structured value.
+                },
+              },
+            ],
+          },
+          "name": "A String", # Required. The name of the tool to call.
+        },
+        "googleMapsCall": { # Google Maps call step.
+          "arguments": { # The arguments to pass to the Google Maps tool. # The arguments to pass to the Google Maps tool.
+            "queries": [ # The queries to be executed.
+              "A String",
+            ],
+          },
+        },
+        "googleSearchCall": { # Google Search call step.
+          "arguments": { # The arguments to pass to Google Search. # Required. The arguments to pass to Google Search.
+            "queries": [ # Web search queries for the following-up web search.
+              "A String",
+            ],
+          },
+          "searchType": "A String", # The type of search grounding enabled.
+        },
+        "id": "A String", # Required. A unique ID for this specific tool call.
+        "processingCall": { # A server-initiated processing step for media analysis (e.g. video understanding).
+        },
+        "retrievalCall": { # Retrieval call step. Used by Vertex Retrieval tools such as Parallel AI, Exa AI, Vertex AI Search, etc. RetrievalType decides which tool is used.
+          "arguments": { # The arguments to pass to Retrieval tools. # Required. The arguments to pass to the retrieval tool.
+            "queries": [ # Queries for Retrieval information.
+              "A String",
+            ],
+          },
+          "retrievalType": "A String", # The type of retrieval tools.
+        },
+        "signature": "A String", # A signature hash for backend validation.
+        "urlContextCall": { # URL context call step.
+          "arguments": { # The arguments to pass to the URL context. # Required. The arguments to pass to the URL context.
+            "urls": [ # The URLs to fetch.
+              "A String",
+            ],
+          },
+        },
+      },
+      "toolResult": { # Tool result step.
+        "callId": "A String", # Required. ID to match the ID from the function call block.
+        "codeExecutionResult": { # Code execution result step.
+          "isError": True or False, # Whether the code execution resulted in an error.
+          "result": "A String", # Required. The output of the code execution.
+        },
+        "fileSearchResult": { # File Search result step.
+        },
+        "functionResult": { # Result of a function tool call.
+          "isError": True or False, # Whether the tool call resulted in an error.
+          "name": "A String", # The name of the tool that was called.
+          "result": { # `Value` represents a dynamically typed value which can be either null, a number, a string, a boolean, a recursive struct value, or a list of values. A producer of value is expected to set one of these variants. Absence of any variant indicates an error. # Required. The result of the tool call.
+            "boolValue": True or False, # Represents a boolean value.
+            "contentValue": { # The content of the response. # Represents rich content (text, image, etc.).
+              "audio": { # An audio content block.
+                "channels": 42, # The number of audio channels.
+                "data": "A String", # The audio content.
+                "mimeTypeString": "A String", # Flexible MIME type string of the audio, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                "sampleRate": 42, # The sample rate of the audio.
+                "uri": "A String", # The URI of the audio.
+              },
+              "document": { # A document content block.
+                "data": "A String", # The document content.
+                "mimeTypeString": "A String", # Flexible MIME type string of the document, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                "uri": "A String", # The URI of the document.
+              },
+              "image": { # An image content block.
+                "data": "A String", # The image content.
+                "mimeTypeString": "A String", # Flexible MIME type string of the image, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                "resolution": "A String", # The resolution of the media.
+                "uri": "A String", # The URI of the image.
+              },
+              "text": { # A text content block.
+                "annotations": [ # Citation information for model-generated content.
+                  { # Citation information for model-generated content.
+                    "endIndex": 42, # End of the attributed segment, exclusive.
+                    "fileCitation": { # A file citation annotation. # A file citation annotation.
+                      "customMetadata": { # User provided metadata about the retrieved context.
+                        "a_key": "", # Properties of the object.
+                      },
+                      "documentUri": "A String", # The URI of the file.
+                      "fileName": "A String", # The name of the file.
+                      "mediaId": "A String", # Media ID in-case of image citations, if applicable.
+                      "pageNumber": 42, # Page number of the cited document, if applicable.
+                      "source": "A String", # Source attributed for a portion of the text.
+                    },
+                    "placeCitation": { # A place citation annotation. # A place citation annotation.
+                      "name": "A String", # Title of the place.
+                      "placeId": "A String", # The ID of the place, in `places/{place_id}` format.
+                      "reviewSnippets": [ # Snippets of reviews that are used to generate answers about the features of a given place in Google Maps.
+                        { # Encapsulates a snippet of a user review that answers a question about the features of a specific place in Google Maps.
+                          "reviewId": "A String", # The ID of the review snippet.
+                          "title": "A String", # Title of the review.
+                          "url": "A String", # A link that corresponds to the user review on Google Maps.
+                        },
+                      ],
+                      "url": "A String", # URI reference of the place.
+                    },
+                    "speechMetadata": { # Speech annotation for text content. # Speech annotation for text content.
+                      "speaker": "A String", # The speaker to associate with this turn.
+                      "style": "A String", # Style instruction for the speech synthesis.
+                    },
+                    "startIndex": 42, # Start of segment of the response that is attributed to this source. Index indicates the start of the segment, measured in bytes.
+                    "urlCitation": { # A URL citation annotation. # NOTE: We use these instead of the Citation message for historical reasons. A URL citation annotation.
+                      "title": "A String", # The title of the URL.
+                      "url": "A String", # The URL.
+                    },
+                    "wordInfo": { # Word-level ASR annotation for transcription output. Carries the word text, optional timing, and optional speaker attribution. # Word-level ASR annotation with timing and speaker info.
+                      "endOffset": "A String", # End offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                      "speaker": "A String", # Optional. Speaker label for this word (e.g. "spk_1", "spk_2"). Present when diarization_mode is set in TranscriptionConfig.
+                      "startOffset": "A String", # Start offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                      "text": "A String", # The transcribed word.
+                    },
+                  },
+                ],
+                "text": "A String", # Required. The text content.
+              },
+              "video": { # A video content block.
+                "data": "A String", # The video content.
+                "mimeTypeString": "A String", # Flexible MIME type string of the video, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                "name": "A String", # A user-defined name for this content block. Can be referenced by the model in the final response.
+                "processingConfig": {
+                  "static": {
+                    "endOffset": "A String", # Optional. Segment end time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "30s". Must be non-negative and greater than `start_offset` if `start_offset` is set.
+                    "fps": 3.14, # Optional. Video frame-rate sampling density.
+                    "startOffset": "A String", # Optional. Segment start time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "10.5s". Must be non-negative.
+                  },
+                },
+                "processingType": "A String",
+                "resolution": "A String", # The resolution of the media.
+                "uri": "A String", # The URI of the video.
+              },
+            },
+            "listValue": { # `ListValue` is a wrapper around a repeated field of values. # Represents a repeated `Value`.
+              "values": [ # Repeated field of dynamically typed values.
+                # Object with schema name: GenaiVertexV1Value
+              ],
+            },
+            "nullValue": "A String", # Represents a null value.
+            "numberValue": 3.14, # Represents a double value.
+            "stringValue": "A String", # Represents a string value.
+            "structValue": # Object with schema name: GenaiVertexV1Struct # Represents a structured value.
+          },
+        },
+        "googleMapsResult": { # Google Maps result step.
+          "result": [
+            { # The result of the Google Maps.
+              "places": [
+                {
+                  "name": "A String",
+                  "placeId": "A String",
+                  "reviewSnippets": [
+                    { # Encapsulates a snippet of a user review that answers a question about the features of a specific place in Google Maps.
+                      "reviewId": "A String", # The ID of the review snippet.
+                      "title": "A String", # Title of the review.
+                      "url": "A String", # A link that corresponds to the user review on Google Maps.
+                    },
+                  ],
+                  "url": "A String",
+                },
+              ],
+              "widgetContextToken": "A String",
+            },
+          ],
+        },
+        "googleSearchResult": { # Google Search result step.
+          "isError": True or False, # Whether the Google Search resulted in an error.
+          "result": [ # Required. The results of the Google Search.
+            { # The result of the Google Search.
+              "searchSuggestions": "A String", # Web content snippet that can be embedded in a web page or an app webview.
+            },
+          ],
+        },
+        "processingResult": { # The result of a server-initiated media processing step.
+        },
+        "retrievalResult": { # Vertex Retrieval result step. Used by Vertex Retrieval tools such as Parallel AI, Exa AI, Vertex AI Search, etc.
+          "isError": True or False, # Whether the retrieval resulted in an error.
+        },
+        "signature": "A String", # A signature hash for backend validation.
+        "urlContextResult": { # URL context result step.
+          "isError": True or False, # Whether the URL context resulted in an error.
+          "result": [ # Required. The results of the URL context.
+            { # The result of the URL context.
+              "status": "A String", # The status of the URL retrieval.
+              "url": "A String", # The URL that was fetched.
+            },
+          ],
+        },
+      },
+      "userInput": { # Input provided by the user. # DO NOT USE -- These are for 3P JSON only
+        "contentList": { # A list of Content. # The content of the step. An array of Content objects.
+          "contents": [ # The contents of the list.
+            { # The content of the response.
+              "audio": { # An audio content block.
+                "channels": 42, # The number of audio channels.
+                "data": "A String", # The audio content.
+                "mimeTypeString": "A String", # Flexible MIME type string of the audio, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                "sampleRate": 42, # The sample rate of the audio.
+                "uri": "A String", # The URI of the audio.
+              },
+              "document": { # A document content block.
+                "data": "A String", # The document content.
+                "mimeTypeString": "A String", # Flexible MIME type string of the document, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                "uri": "A String", # The URI of the document.
+              },
+              "image": { # An image content block.
+                "data": "A String", # The image content.
+                "mimeTypeString": "A String", # Flexible MIME type string of the image, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                "resolution": "A String", # The resolution of the media.
+                "uri": "A String", # The URI of the image.
+              },
+              "text": { # A text content block.
+                "annotations": [ # Citation information for model-generated content.
+                  { # Citation information for model-generated content.
+                    "endIndex": 42, # End of the attributed segment, exclusive.
+                    "fileCitation": { # A file citation annotation. # A file citation annotation.
+                      "customMetadata": { # User provided metadata about the retrieved context.
+                        "a_key": "", # Properties of the object.
+                      },
+                      "documentUri": "A String", # The URI of the file.
+                      "fileName": "A String", # The name of the file.
+                      "mediaId": "A String", # Media ID in-case of image citations, if applicable.
+                      "pageNumber": 42, # Page number of the cited document, if applicable.
+                      "source": "A String", # Source attributed for a portion of the text.
+                    },
+                    "placeCitation": { # A place citation annotation. # A place citation annotation.
+                      "name": "A String", # Title of the place.
+                      "placeId": "A String", # The ID of the place, in `places/{place_id}` format.
+                      "reviewSnippets": [ # Snippets of reviews that are used to generate answers about the features of a given place in Google Maps.
+                        { # Encapsulates a snippet of a user review that answers a question about the features of a specific place in Google Maps.
+                          "reviewId": "A String", # The ID of the review snippet.
+                          "title": "A String", # Title of the review.
+                          "url": "A String", # A link that corresponds to the user review on Google Maps.
+                        },
+                      ],
+                      "url": "A String", # URI reference of the place.
+                    },
+                    "speechMetadata": { # Speech annotation for text content. # Speech annotation for text content.
+                      "speaker": "A String", # The speaker to associate with this turn.
+                      "style": "A String", # Style instruction for the speech synthesis.
+                    },
+                    "startIndex": 42, # Start of segment of the response that is attributed to this source. Index indicates the start of the segment, measured in bytes.
+                    "urlCitation": { # A URL citation annotation. # NOTE: We use these instead of the Citation message for historical reasons. A URL citation annotation.
+                      "title": "A String", # The title of the URL.
+                      "url": "A String", # The URL.
+                    },
+                    "wordInfo": { # Word-level ASR annotation for transcription output. Carries the word text, optional timing, and optional speaker attribution. # Word-level ASR annotation with timing and speaker info.
+                      "endOffset": "A String", # End offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                      "speaker": "A String", # Optional. Speaker label for this word (e.g. "spk_1", "spk_2"). Present when diarization_mode is set in TranscriptionConfig.
+                      "startOffset": "A String", # Start offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".
+                      "text": "A String", # The transcribed word.
+                    },
+                  },
+                ],
+                "text": "A String", # Required. The text content.
+              },
+              "video": { # A video content block.
+                "data": "A String", # The video content.
+                "mimeTypeString": "A String", # Flexible MIME type string of the video, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the "mime_type" JSON key.
+                "name": "A String", # A user-defined name for this content block. Can be referenced by the model in the final response.
+                "processingConfig": {
+                  "static": {
+                    "endOffset": "A String", # Optional. Segment end time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "30s". Must be non-negative and greater than `start_offset` if `start_offset` is set.
+                    "fps": 3.14, # Optional. Video frame-rate sampling density.
+                    "startOffset": "A String", # Optional. Segment start time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., "10.5s". Must be non-negative.
+                  },
+                },
+                "processingType": "A String",
+                "resolution": "A String", # The resolution of the media.
+                "uri": "A String", # The URI of the video.
+              },
+            },
+          ],
+        },
+        "contentString": "A String", # The content of the step. A single string.
+      },
+    },
+  },
+  "stepStop": { # The step stop data, used for step.stop events. Step-based streaming event, used when steps are enabled.
+    "index": 42,
+    "stepUsage": { # Statistics on the interaction request's token usage. # Model usage stats for this specific step.
+      "cachedTokensByModality": [ # A breakdown of cached token usage by modality.
+        { # The token count for a single response modality.
+          "modality": "A String", # The modality associated with the token count.
+          "tokens": 42, # Number of tokens for the modality.
+        },
+      ],
+      "groundingToolCount": [ # Grounding tool count.
+        { # The number of grounding tool counts.
+          "count": 42, # The number of grounding tool counts.
+          "type": "A String", # The grounding tool type associated with the count.
+        },
+      ],
+      "inputTokensByModality": [ # A breakdown of input token usage by modality.
+        { # The token count for a single response modality.
+          "modality": "A String", # The modality associated with the token count.
+          "tokens": 42, # Number of tokens for the modality.
+        },
+      ],
+      "outputTokensByModality": [ # A breakdown of output token usage by modality.
+        { # The token count for a single response modality.
+          "modality": "A String", # The modality associated with the token count.
+          "tokens": 42, # Number of tokens for the modality.
+        },
+      ],
+      "toolUseTokensByModality": [ # A breakdown of tool-use token usage by modality.
+        { # The token count for a single response modality.
+          "modality": "A String", # The modality associated with the token count.
+          "tokens": 42, # Number of tokens for the modality.
+        },
+      ],
+      "totalCachedTokens": 42, # Number of tokens in the cached part of the prompt (the cached content).
+      "totalInputTokens": 42, # Number of tokens in the prompt (context).
+      "totalOutputTokens": 42, # Total number of tokens across all the generated responses.
+      "totalThoughtTokens": 42, # Number of tokens of thoughts for thinking models.
+      "totalTokens": 42, # Total token count for the interaction request (prompt + responses + other internal tokens).
+      "totalToolUseTokens": 42, # Number of tokens present in tool-use prompt(s).
+    },
+    "usage": { # Statistics on the interaction request's token usage. # Cumulative model usage stats from the start of the session.
+      "cachedTokensByModality": [ # A breakdown of cached token usage by modality.
+        { # The token count for a single response modality.
+          "modality": "A String", # The modality associated with the token count.
+          "tokens": 42, # Number of tokens for the modality.
+        },
+      ],
+      "groundingToolCount": [ # Grounding tool count.
+        { # The number of grounding tool counts.
+          "count": 42, # The number of grounding tool counts.
+          "type": "A String", # The grounding tool type associated with the count.
+        },
+      ],
+      "inputTokensByModality": [ # A breakdown of input token usage by modality.
+        { # The token count for a single response modality.
+          "modality": "A String", # The modality associated with the token count.
+          "tokens": 42, # Number of tokens for the modality.
+        },
+      ],
+      "outputTokensByModality": [ # A breakdown of output token usage by modality.
+        { # The token count for a single response modality.
+          "modality": "A String", # The modality associated with the token count.
+          "tokens": 42, # Number of tokens for the modality.
+        },
+      ],
+      "toolUseTokensByModality": [ # A breakdown of tool-use token usage by modality.
+        { # The token count for a single response modality.
+          "modality": "A String", # The modality associated with the token count.
+          "tokens": 42, # Number of tokens for the modality.
+        },
+      ],
+      "totalCachedTokens": 42, # Number of tokens in the cached part of the prompt (the cached content).
+      "totalInputTokens": 42, # Number of tokens in the prompt (context).
+      "totalOutputTokens": 42, # Total number of tokens across all the generated responses.
+      "totalThoughtTokens": 42, # Number of tokens of thoughts for thinking models.
+      "totalTokens": 42, # Total token count for the interaction request (prompt + responses + other internal tokens).
+      "totalToolUseTokens": 42, # Number of tokens present in tool-use prompt(s).
+    },
+  },
+}
+
+ +
+ delete(name, x__xgafv=None) + 
Deletes an interaction.
+
+Args:
+  name: string, Required. The name of the interaction to delete. Format: interactions/{interaction} (required)
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # Response for InteractionService.DeleteInteraction.
+}
+
+ + \ No newline at end of file diff --git a/docs/dyn/aiplatform_v1.projects.locations.interactionsHttp.html b/docs/dyn/aiplatform_v1.projects.locations.interactionsHttp.html new file mode 100644 index 0000000000..24e79a2fc9 --- /dev/null +++ b/docs/dyn/aiplatform_v1.projects.locations.interactionsHttp.html @@ -0,0 +1,187 @@ + + + +

Agent Platform API . projects . locations . interactionsHttp

+

Instance Methods

+

+ cancel(name, x__xgafv=None)

+

Cancels an interaction by id. This only applies to background interactions that are still running.

+

+ close()

+

Close httplib2 connections.

+

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

+

Creates a new interaction.

+

+ get(name, lastEventId=None, stream=None, x__xgafv=None)

+

Retrieves the full details of a single interaction based on its `Interaction.id`.

+

Method Details

+
+ cancel(name, x__xgafv=None) + 
Cancels an interaction by id. This only applies to background interactions that are still running.
+
+Args:
+  name: string, Required. The name of the interaction to cancel. Format: `interactions/{interaction}`. (required)
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # Message that represents an arbitrary HTTP body. It should only be used for payload formats that can't be represented as JSON, such as raw binary or an HTML page. This message can be used both in streaming and non-streaming API methods in the request as well as the response. It can be used as a top-level request field, which is convenient if one wants to extract parameters from either the URL or HTTP template into the request fields and also want access to the raw HTTP body. Example: message GetResourceRequest { // A unique request id. string request_id = 1; // The raw HTTP body is bound to this field. google.api.HttpBody http_body = 2; } service ResourceService { rpc GetResource(GetResourceRequest) returns (google.api.HttpBody); rpc UpdateResource(google.api.HttpBody) returns (google.protobuf.Empty); } Example with streaming methods: service CaldavService { rpc GetCalendar(stream google.api.HttpBody) returns (stream google.api.HttpBody); rpc UpdateCalendar(stream google.api.HttpBody) returns (stream google.api.HttpBody); } Use of this type only changes how the request and response bodies are handled, all other features will continue to work unchanged.
+  "contentType": "A String", # The HTTP Content-Type header value specifying the content type of the body.
+  "data": "A String", # The HTTP request/response body as raw binary.
+  "extensions": [ # Application specific response metadata. Must be set in the first response for streaming APIs.
+    {
+      "a_key": "", # Properties of the object. Contains field @type with type URL.
+    },
+  ],
+}
+
+ +
+ close() + 
Close httplib2 connections.
+
+ +
+ create(parent, body=None, x__xgafv=None) + 
Creates a new interaction.
+
+Args:
+  parent: string, Required. The parent resource where this interaction will be created. Format: `projects/{project}/locations/{location}` Supported only by the Vertex API only. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # Request message for [InteractionsService.CreateInteractionHttp].
+  "httpBody": { # Message that represents an arbitrary HTTP body. It should only be used for payload formats that can't be represented as JSON, such as raw binary or an HTML page. This message can be used both in streaming and non-streaming API methods in the request as well as the response. It can be used as a top-level request field, which is convenient if one wants to extract parameters from either the URL or HTTP template into the request fields and also want access to the raw HTTP body. Example: message GetResourceRequest { // A unique request id. string request_id = 1; // The raw HTTP body is bound to this field. google.api.HttpBody http_body = 2; } service ResourceService { rpc GetResource(GetResourceRequest) returns (google.api.HttpBody); rpc UpdateResource(google.api.HttpBody) returns (google.protobuf.Empty); } Example with streaming methods: service CaldavService { rpc GetCalendar(stream google.api.HttpBody) returns (stream google.api.HttpBody); rpc UpdateCalendar(stream google.api.HttpBody) returns (stream google.api.HttpBody); } Use of this type only changes how the request and response bodies are handled, all other features will continue to work unchanged. # Required. The interaction to create.
+    "contentType": "A String", # The HTTP Content-Type header value specifying the content type of the body.
+    "data": "A String", # The HTTP request/response body as raw binary.
+    "extensions": [ # Application specific response metadata. Must be set in the first response for streaming APIs.
+      {
+        "a_key": "", # Properties of the object. Contains field @type with type URL.
+      },
+    ],
+  },
+}
+
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # Message that represents an arbitrary HTTP body. It should only be used for payload formats that can't be represented as JSON, such as raw binary or an HTML page. This message can be used both in streaming and non-streaming API methods in the request as well as the response. It can be used as a top-level request field, which is convenient if one wants to extract parameters from either the URL or HTTP template into the request fields and also want access to the raw HTTP body. Example: message GetResourceRequest { // A unique request id. string request_id = 1; // The raw HTTP body is bound to this field. google.api.HttpBody http_body = 2; } service ResourceService { rpc GetResource(GetResourceRequest) returns (google.api.HttpBody); rpc UpdateResource(google.api.HttpBody) returns (google.protobuf.Empty); } Example with streaming methods: service CaldavService { rpc GetCalendar(stream google.api.HttpBody) returns (stream google.api.HttpBody); rpc UpdateCalendar(stream google.api.HttpBody) returns (stream google.api.HttpBody); } Use of this type only changes how the request and response bodies are handled, all other features will continue to work unchanged.
+  "contentType": "A String", # The HTTP Content-Type header value specifying the content type of the body.
+  "data": "A String", # The HTTP request/response body as raw binary.
+  "extensions": [ # Application specific response metadata. Must be set in the first response for streaming APIs.
+    {
+      "a_key": "", # Properties of the object. Contains field @type with type URL.
+    },
+  ],
+}
+
+ +
+ get(name, lastEventId=None, stream=None, x__xgafv=None) + 
Retrieves the full details of a single interaction based on its `Interaction.id`.
+
+Args:
+  name: string, Required. The name of the interaction to retrieve. Format: interactions/{interaction} (required)
+  lastEventId: string, If set, resumes the interaction stream from the chunk after the event marked by the event id. Can only be used if `stream` is true.
+  stream: boolean, If true, streams the interaction events as Server-Sent Events.
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # Message that represents an arbitrary HTTP body. It should only be used for payload formats that can't be represented as JSON, such as raw binary or an HTML page. This message can be used both in streaming and non-streaming API methods in the request as well as the response. It can be used as a top-level request field, which is convenient if one wants to extract parameters from either the URL or HTTP template into the request fields and also want access to the raw HTTP body. Example: message GetResourceRequest { // A unique request id. string request_id = 1; // The raw HTTP body is bound to this field. google.api.HttpBody http_body = 2; } service ResourceService { rpc GetResource(GetResourceRequest) returns (google.api.HttpBody); rpc UpdateResource(google.api.HttpBody) returns (google.protobuf.Empty); } Example with streaming methods: service CaldavService { rpc GetCalendar(stream google.api.HttpBody) returns (stream google.api.HttpBody); rpc UpdateCalendar(stream google.api.HttpBody) returns (stream google.api.HttpBody); } Use of this type only changes how the request and response bodies are handled, all other features will continue to work unchanged.
+  "contentType": "A String", # The HTTP Content-Type header value specifying the content type of the body.
+  "data": "A String", # The HTTP request/response body as raw binary.
+  "extensions": [ # Application specific response metadata. Must be set in the first response for streaming APIs.
+    {
+      "a_key": "", # Properties of the object. Contains field @type with type URL.
+    },
+  ],
+}
+
+ + \ No newline at end of file diff --git a/docs/dyn/aiplatform_v1.projects.locations.memoryBanks.html b/docs/dyn/aiplatform_v1.projects.locations.memoryBanks.html index 083707b635..662db4453d 100644 --- a/docs/dyn/aiplatform_v1.projects.locations.memoryBanks.html +++ b/docs/dyn/aiplatform_v1.projects.locations.memoryBanks.html @@ -111,7 +111,7 @@

Method Details

{ # A single event to ingest. "content": { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. # Required. The content of the event. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. diff --git a/docs/dyn/aiplatform_v1.projects.locations.memoryBanks.memories.html b/docs/dyn/aiplatform_v1.projects.locations.memoryBanks.memories.html index a70ee7686f..b47599371d 100644 --- a/docs/dyn/aiplatform_v1.projects.locations.memoryBanks.memories.html +++ b/docs/dyn/aiplatform_v1.projects.locations.memoryBanks.memories.html @@ -253,7 +253,7 @@

Method Details

{ # A single piece of conversation from which to generate memories. "content": { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. # Required. A single piece of content from which to generate memories. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. diff --git a/docs/dyn/aiplatform_v1.projects.locations.models.html b/docs/dyn/aiplatform_v1.projects.locations.models.html index bbbfd54c73..3bdc0bb26c 100644 --- a/docs/dyn/aiplatform_v1.projects.locations.models.html +++ b/docs/dyn/aiplatform_v1.projects.locations.models.html @@ -356,7 +356,7 @@

Method Details

"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). + "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). At most 200 environment variables can be specified. Each variable (`NAME=value`) must be smaller than 128 KiB, and the total size of all variables must not exceed 512 KiB. { # 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. @@ -739,7 +739,7 @@

Method Details

"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). + "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). At most 200 environment variables can be specified. Each variable (`NAME=value`) must be smaller than 128 KiB, and the total size of all variables must not exceed 512 KiB. { # 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. @@ -1132,7 +1132,7 @@

Method Details

"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). + "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). At most 200 environment variables can be specified. Each variable (`NAME=value`) must be smaller than 128 KiB, and the total size of all variables must not exceed 512 KiB. { # 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. @@ -1513,7 +1513,7 @@

Method Details

"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). + "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). At most 200 environment variables can be specified. Each variable (`NAME=value`) must be smaller than 128 KiB, and the total size of all variables must not exceed 512 KiB. { # 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. @@ -1849,7 +1849,7 @@

Method Details

"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). + "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). At most 200 environment variables can be specified. Each variable (`NAME=value`) must be smaller than 128 KiB, and the total size of all variables must not exceed 512 KiB. { # 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. @@ -2184,7 +2184,7 @@

Method Details

"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). + "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). At most 200 environment variables can be specified. Each variable (`NAME=value`) must be smaller than 128 KiB, and the total size of all variables must not exceed 512 KiB. { # 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. @@ -2658,7 +2658,7 @@

Method Details

"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). + "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). At most 200 environment variables can be specified. Each variable (`NAME=value`) must be smaller than 128 KiB, and the total size of all variables must not exceed 512 KiB. { # 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. diff --git a/docs/dyn/aiplatform_v1.projects.locations.onlineEvaluators.html b/docs/dyn/aiplatform_v1.projects.locations.onlineEvaluators.html index 512f39ac9e..33f45fe32c 100644 --- a/docs/dyn/aiplatform_v1.projects.locations.onlineEvaluators.html +++ b/docs/dyn/aiplatform_v1.projects.locations.onlineEvaluators.html @@ -184,6 +184,11 @@

Method Details

"comparisonOperator": "A String", # Required. The comparison operator to apply. "value": 3.14, # Required. The value to compare against. }, + "serviceVersion": { # Defines a predicate for filtering based on a string value. # Filter on the versions that served a session (`service.version` OTel resource attribute); matches if any of them is listed. At most one is allowed. On Vertex AI Agent Engine, this is the runtime revision id, currently set only for agents created via v1beta1. + "values": [ # Required. The values to match exactly (case-sensitive). Requires 1 to 20 values, each at most 128 characters long. + "A String", + ], + }, "toolCallErrors": { # Defines a predicate for filtering based on a numeric value. # Filter on the number of tool call errors within a session. "comparisonOperator": "A String", # Required. The comparison operator to apply. "value": 3.14, # Required. The value to compare against. @@ -213,6 +218,11 @@

Method Details

"comparisonOperator": "A String", # Required. The comparison operator to apply. "value": 3.14, # Required. The value to compare against. }, + "serviceVersion": { # Defines a predicate for filtering based on a string value. # Filter on the version that served a trace (`service.version` OTel resource attribute). At most one is allowed. On Vertex AI Agent Engine, this is the runtime revision id, currently set only for agents created via v1beta1. + "values": [ # Required. The values to match exactly (case-sensitive). Requires 1 to 20 values, each at most 128 characters long. + "A String", + ], + }, "totalTokenUsage": { # Defines a predicate for filtering based on a numeric value. # Filter on the total token usage within a trace. "comparisonOperator": "A String", # Required. The comparison operator to apply. "value": 3.14, # Required. The value to compare against. @@ -773,6 +783,11 @@

Method Details

"comparisonOperator": "A String", # Required. The comparison operator to apply. "value": 3.14, # Required. The value to compare against. }, + "serviceVersion": { # Defines a predicate for filtering based on a string value. # Filter on the versions that served a session (`service.version` OTel resource attribute); matches if any of them is listed. At most one is allowed. On Vertex AI Agent Engine, this is the runtime revision id, currently set only for agents created via v1beta1. + "values": [ # Required. The values to match exactly (case-sensitive). Requires 1 to 20 values, each at most 128 characters long. + "A String", + ], + }, "toolCallErrors": { # Defines a predicate for filtering based on a numeric value. # Filter on the number of tool call errors within a session. "comparisonOperator": "A String", # Required. The comparison operator to apply. "value": 3.14, # Required. The value to compare against. @@ -802,6 +817,11 @@

Method Details

"comparisonOperator": "A String", # Required. The comparison operator to apply. "value": 3.14, # Required. The value to compare against. }, + "serviceVersion": { # Defines a predicate for filtering based on a string value. # Filter on the version that served a trace (`service.version` OTel resource attribute). At most one is allowed. On Vertex AI Agent Engine, this is the runtime revision id, currently set only for agents created via v1beta1. + "values": [ # Required. The values to match exactly (case-sensitive). Requires 1 to 20 values, each at most 128 characters long. + "A String", + ], + }, "totalTokenUsage": { # Defines a predicate for filtering based on a numeric value. # Filter on the total token usage within a trace. "comparisonOperator": "A String", # Required. The comparison operator to apply. "value": 3.14, # Required. The value to compare against. @@ -1306,6 +1326,11 @@

Method Details

"comparisonOperator": "A String", # Required. The comparison operator to apply. "value": 3.14, # Required. The value to compare against. }, + "serviceVersion": { # Defines a predicate for filtering based on a string value. # Filter on the versions that served a session (`service.version` OTel resource attribute); matches if any of them is listed. At most one is allowed. On Vertex AI Agent Engine, this is the runtime revision id, currently set only for agents created via v1beta1. + "values": [ # Required. The values to match exactly (case-sensitive). Requires 1 to 20 values, each at most 128 characters long. + "A String", + ], + }, "toolCallErrors": { # Defines a predicate for filtering based on a numeric value. # Filter on the number of tool call errors within a session. "comparisonOperator": "A String", # Required. The comparison operator to apply. "value": 3.14, # Required. The value to compare against. @@ -1335,6 +1360,11 @@

Method Details

"comparisonOperator": "A String", # Required. The comparison operator to apply. "value": 3.14, # Required. The value to compare against. }, + "serviceVersion": { # Defines a predicate for filtering based on a string value. # Filter on the version that served a trace (`service.version` OTel resource attribute). At most one is allowed. On Vertex AI Agent Engine, this is the runtime revision id, currently set only for agents created via v1beta1. + "values": [ # Required. The values to match exactly (case-sensitive). Requires 1 to 20 values, each at most 128 characters long. + "A String", + ], + }, "totalTokenUsage": { # Defines a predicate for filtering based on a numeric value. # Filter on the total token usage within a trace. "comparisonOperator": "A String", # Required. The comparison operator to apply. "value": 3.14, # Required. The value to compare against. @@ -1843,6 +1873,11 @@

Method Details

"comparisonOperator": "A String", # Required. The comparison operator to apply. "value": 3.14, # Required. The value to compare against. }, + "serviceVersion": { # Defines a predicate for filtering based on a string value. # Filter on the versions that served a session (`service.version` OTel resource attribute); matches if any of them is listed. At most one is allowed. On Vertex AI Agent Engine, this is the runtime revision id, currently set only for agents created via v1beta1. + "values": [ # Required. The values to match exactly (case-sensitive). Requires 1 to 20 values, each at most 128 characters long. + "A String", + ], + }, "toolCallErrors": { # Defines a predicate for filtering based on a numeric value. # Filter on the number of tool call errors within a session. "comparisonOperator": "A String", # Required. The comparison operator to apply. "value": 3.14, # Required. The value to compare against. @@ -1872,6 +1907,11 @@

Method Details

"comparisonOperator": "A String", # Required. The comparison operator to apply. "value": 3.14, # Required. The value to compare against. }, + "serviceVersion": { # Defines a predicate for filtering based on a string value. # Filter on the version that served a trace (`service.version` OTel resource attribute). At most one is allowed. On Vertex AI Agent Engine, this is the runtime revision id, currently set only for agents created via v1beta1. + "values": [ # Required. The values to match exactly (case-sensitive). Requires 1 to 20 values, each at most 128 characters long. + "A String", + ], + }, "totalTokenUsage": { # Defines a predicate for filtering based on a numeric value. # Filter on the total token usage within a trace. "comparisonOperator": "A String", # Required. The comparison operator to apply. "value": 3.14, # Required. The value to compare against. diff --git a/docs/dyn/aiplatform_v1.projects.locations.publishers.models.html b/docs/dyn/aiplatform_v1.projects.locations.publishers.models.html index 1ec1a77554..ada4d3be4e 100644 --- a/docs/dyn/aiplatform_v1.projects.locations.publishers.models.html +++ b/docs/dyn/aiplatform_v1.projects.locations.publishers.models.html @@ -134,7 +134,7 @@

Method Details

"contents": [ # Optional. Input content. { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -268,7 +268,7 @@

Method Details

"contents": [ # Optional. Input content. { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -533,7 +533,7 @@

Method Details

"model": "A String", # Optional. The name of the publisher model requested to serve the prediction. Format: `projects/{project}/locations/{location}/publishers/*/models/*` "systemInstruction": { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. # Optional. The user provided system instructions for the model. Note: only text should be used in parts and content in each part will be in a separate paragraph. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -894,7 +894,7 @@

Method Details

"autoTruncate": True or False, # Optional. Deprecated: Please use EmbedContentConfig.auto_truncate instead. Whether to silently truncate the input content if it's longer than the maximum sequence length. "content": { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. # Required. The content to be embedded. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -1105,7 +1105,7 @@

Method Details

"contents": [ # Required. The content of the current conversation with the model. For single-turn queries, this is a single instance. For multi-turn queries, this is a repeated field that contains conversation history + latest request. { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -1380,7 +1380,7 @@

Method Details

], "systemInstruction": { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. # Optional. The user provided system instructions for the model. Note: only text should be used in parts and content in each part will be in a separate paragraph. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -1754,7 +1754,7 @@

Method Details

}, "content": { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. # Output only. The content of the candidate. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -1845,6 +1845,7 @@

Method Details

], "role": "A String", # Optional. The producer of the content. Must be either 'user' or 'model'. If not set, the service will default to 'user'. }, + "continuationToken": "A String", # Output only. An optional opaque continuation token returned when `finish_reason` is `CONTINUATION`. Clients can pass this token in a subsequent `GenerateContentRequest` to continue generation. "finishMessage": "A String", # Output only. Describes the reason the model stopped generating tokens in more detail. This field is returned only when `finish_reason` is set. "finishReason": "A String", # Output only. The reason why the model stopped generating tokens. If empty, the model has not stopped generating. "groundingMetadata": { # Information about the sources that support the content of a response. When grounding is enabled, the model returns citations for claims in the response. This object contains the retrieved sources. # Output only. Metadata returned when grounding is enabled. It contains the sources used to ground the generated content. @@ -2366,7 +2367,7 @@

Method Details

"contents": [ # Required. The content of the current conversation with the model. For single-turn queries, this is a single instance. For multi-turn queries, this is a repeated field that contains conversation history + latest request. { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -2641,7 +2642,7 @@

Method Details

], "systemInstruction": { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. # Optional. The user provided system instructions for the model. Note: only text should be used in parts and content in each part will be in a separate paragraph. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -3015,7 +3016,7 @@

Method Details

}, "content": { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. # Output only. The content of the candidate. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -3106,6 +3107,7 @@

Method Details

], "role": "A String", # Optional. The producer of the content. Must be either 'user' or 'model'. If not set, the service will default to 'user'. }, + "continuationToken": "A String", # Output only. An optional opaque continuation token returned when `finish_reason` is `CONTINUATION`. Clients can pass this token in a subsequent `GenerateContentRequest` to continue generation. "finishMessage": "A String", # Output only. Describes the reason the model stopped generating tokens in more detail. This field is returned only when `finish_reason` is set. "finishReason": "A String", # Output only. The reason why the model stopped generating tokens. If empty, the model has not stopped generating. "groundingMetadata": { # Information about the sources that support the content of a response. When grounding is enabled, the model returns citations for claims in the response. This object contains the retrieved sources. # Output only. Metadata returned when grounding is enabled. It contains the sources used to ground the generated content. diff --git a/docs/dyn/aiplatform_v1.projects.locations.reasoningEngines.html b/docs/dyn/aiplatform_v1.projects.locations.reasoningEngines.html index 932f65c131..a3bd3a75ee 100644 --- a/docs/dyn/aiplatform_v1.projects.locations.reasoningEngines.html +++ b/docs/dyn/aiplatform_v1.projects.locations.reasoningEngines.html @@ -254,7 +254,7 @@

Method Details

{ # A single conversation event. "content": { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. # Required. Represents the content of the event. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -665,7 +665,7 @@

Method Details

{ # A single conversation event. "content": { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. # Required. Represents the content of the event. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -1007,7 +1007,7 @@

Method Details

{ # A single conversation event. "content": { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. # Required. Represents the content of the event. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -1319,7 +1319,7 @@

Method Details

{ # A single conversation event. "content": { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. # Required. Represents the content of the event. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. diff --git a/docs/dyn/aiplatform_v1.projects.locations.reasoningEngines.memories.html b/docs/dyn/aiplatform_v1.projects.locations.reasoningEngines.memories.html index 4f13275cc3..74f5215f7e 100644 --- a/docs/dyn/aiplatform_v1.projects.locations.reasoningEngines.memories.html +++ b/docs/dyn/aiplatform_v1.projects.locations.reasoningEngines.memories.html @@ -256,7 +256,7 @@

Method Details

{ # A single piece of conversation from which to generate memories. "content": { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. # Required. A single piece of content from which to generate memories. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -484,7 +484,7 @@

Method Details

{ # A single event to ingest. "content": { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. # Required. The content of the event. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. diff --git a/docs/dyn/aiplatform_v1.projects.locations.reasoningEngines.sessions.events.html b/docs/dyn/aiplatform_v1.projects.locations.reasoningEngines.sessions.events.html index 9837adadd9..68303a91e6 100644 --- a/docs/dyn/aiplatform_v1.projects.locations.reasoningEngines.sessions.events.html +++ b/docs/dyn/aiplatform_v1.projects.locations.reasoningEngines.sessions.events.html @@ -128,7 +128,7 @@

Method Details

"author": "A String", # Required. The name of the agent that sent the event, or user. "content": { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. # Optional. Content of the event provided by the author. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. diff --git a/docs/dyn/aiplatform_v1.projects.locations.reasoningEngines.sessions.html b/docs/dyn/aiplatform_v1.projects.locations.reasoningEngines.sessions.html index 07a19e42d2..c5647079ed 100644 --- a/docs/dyn/aiplatform_v1.projects.locations.reasoningEngines.sessions.html +++ b/docs/dyn/aiplatform_v1.projects.locations.reasoningEngines.sessions.html @@ -139,7 +139,7 @@

Method Details

"author": "A String", # Required. The name of the agent that sent the event, or user. "content": { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. # Optional. Content of the event provided by the author. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. diff --git a/docs/dyn/aiplatform_v1.projects.locations.trainingPipelines.html b/docs/dyn/aiplatform_v1.projects.locations.trainingPipelines.html index 4eddb57eb1..390f2d6c54 100644 --- a/docs/dyn/aiplatform_v1.projects.locations.trainingPipelines.html +++ b/docs/dyn/aiplatform_v1.projects.locations.trainingPipelines.html @@ -224,7 +224,7 @@

Method Details

"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). + "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). At most 200 environment variables can be specified. Each variable (`NAME=value`) must be smaller than 128 KiB, and the total size of all variables must not exceed 512 KiB. { # 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. @@ -625,7 +625,7 @@

Method Details

"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). + "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). At most 200 environment variables can be specified. Each variable (`NAME=value`) must be smaller than 128 KiB, and the total size of all variables must not exceed 512 KiB. { # 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. @@ -1068,7 +1068,7 @@

Method Details

"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). + "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). At most 200 environment variables can be specified. Each variable (`NAME=value`) must be smaller than 128 KiB, and the total size of all variables must not exceed 512 KiB. { # 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. @@ -1483,7 +1483,7 @@

Method Details

"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). + "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). At most 200 environment variables can be specified. Each variable (`NAME=value`) must be smaller than 128 KiB, and the total size of all variables must not exceed 512 KiB. { # 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. diff --git a/docs/dyn/aiplatform_v1.projects.locations.tuningJobs.html b/docs/dyn/aiplatform_v1.projects.locations.tuningJobs.html index 669687e261..35962ddfce 100644 --- a/docs/dyn/aiplatform_v1.projects.locations.tuningJobs.html +++ b/docs/dyn/aiplatform_v1.projects.locations.tuningJobs.html @@ -1107,7 +1107,7 @@

Method Details

{ # Completion and its preference score. "completion": { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. # Single turn completion for the given prompt. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -1204,7 +1204,7 @@

Method Details

"contents": [ # Multi-turn contents that represents the Prompt. { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -1347,7 +1347,7 @@

Method Details

"userDatasetExamples": [ # Output only. Sample user messages in the training dataset uri. { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -2471,7 +2471,7 @@

Method Details

{ # Completion and its preference score. "completion": { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. # Single turn completion for the given prompt. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -2568,7 +2568,7 @@

Method Details

"contents": [ # Multi-turn contents that represents the Prompt. { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -2711,7 +2711,7 @@

Method Details

"userDatasetExamples": [ # Output only. Sample user messages in the training dataset uri. { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -3842,7 +3842,7 @@

Method Details

{ # Completion and its preference score. "completion": { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. # Single turn completion for the given prompt. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -3939,7 +3939,7 @@

Method Details

"contents": [ # Multi-turn contents that represents the Prompt. { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -4082,7 +4082,7 @@

Method Details

"userDatasetExamples": [ # Output only. Sample user messages in the training dataset uri. { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -5219,7 +5219,7 @@

Method Details

{ # Completion and its preference score. "completion": { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. # Single turn completion for the given prompt. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -5316,7 +5316,7 @@

Method Details

"contents": [ # Multi-turn contents that represents the Prompt. { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -5459,7 +5459,7 @@

Method Details

"userDatasetExamples": [ # Output only. Sample user messages in the training dataset uri. { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -6611,7 +6611,7 @@

Method Details

{ # Completion and its preference score. "completion": { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. # Single turn completion for the given prompt. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -6708,7 +6708,7 @@

Method Details

"contents": [ # Multi-turn contents that represents the Prompt. { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -6851,7 +6851,7 @@

Method Details

"userDatasetExamples": [ # Output only. Sample user messages in the training dataset uri. { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. diff --git a/docs/dyn/aiplatform_v1.publishers.models.html b/docs/dyn/aiplatform_v1.publishers.models.html index 079feb45b2..bf1edea159 100644 --- a/docs/dyn/aiplatform_v1.publishers.models.html +++ b/docs/dyn/aiplatform_v1.publishers.models.html @@ -120,7 +120,7 @@

Method Details

"contents": [ # Optional. Input content. { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -254,7 +254,7 @@

Method Details

"contents": [ # Optional. Input content. { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -519,7 +519,7 @@

Method Details

"model": "A String", # Optional. The name of the publisher model requested to serve the prediction. Format: `projects/{project}/locations/{location}/publishers/*/models/*` "systemInstruction": { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. # Optional. The user provided system instructions for the model. Note: only text should be used in parts and content in each part will be in a separate paragraph. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -923,7 +923,7 @@

Method Details

"contents": [ # Required. The content of the current conversation with the model. For single-turn queries, this is a single instance. For multi-turn queries, this is a repeated field that contains conversation history + latest request. { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -1198,7 +1198,7 @@

Method Details

], "systemInstruction": { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. # Optional. The user provided system instructions for the model. Note: only text should be used in parts and content in each part will be in a separate paragraph. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -1572,7 +1572,7 @@

Method Details

}, "content": { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. # Output only. The content of the candidate. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -1663,6 +1663,7 @@

Method Details

], "role": "A String", # Optional. The producer of the content. Must be either 'user' or 'model'. If not set, the service will default to 'user'. }, + "continuationToken": "A String", # Output only. An optional opaque continuation token returned when `finish_reason` is `CONTINUATION`. Clients can pass this token in a subsequent `GenerateContentRequest` to continue generation. "finishMessage": "A String", # Output only. Describes the reason the model stopped generating tokens in more detail. This field is returned only when `finish_reason` is set. "finishReason": "A String", # Output only. The reason why the model stopped generating tokens. If empty, the model has not stopped generating. "groundingMetadata": { # Information about the sources that support the content of a response. When grounding is enabled, the model returns citations for claims in the response. This object contains the retrieved sources. # Output only. Metadata returned when grounding is enabled. It contains the sources used to ground the generated content. @@ -1922,7 +1923,7 @@

Method Details

"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). + "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). At most 200 environment variables can be specified. Each variable (`NAME=value`) must be smaller than 128 KiB, and the total size of all variables must not exceed 512 KiB. { # 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. @@ -2102,7 +2103,7 @@

Method Details

"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). + "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). At most 200 environment variables can be specified. Each variable (`NAME=value`) must be smaller than 128 KiB, and the total size of all variables must not exceed 512 KiB. { # 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. @@ -2531,7 +2532,7 @@

Method Details

"contents": [ # Required. The content of the current conversation with the model. For single-turn queries, this is a single instance. For multi-turn queries, this is a repeated field that contains conversation history + latest request. { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -2806,7 +2807,7 @@

Method Details

], "systemInstruction": { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. # Optional. The user provided system instructions for the model. Note: only text should be used in parts and content in each part will be in a separate paragraph. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -3180,7 +3181,7 @@

Method Details

}, "content": { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. # Output only. The content of the candidate. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -3271,6 +3272,7 @@

Method Details

], "role": "A String", # Optional. The producer of the content. Must be either 'user' or 'model'. If not set, the service will default to 'user'. }, + "continuationToken": "A String", # Output only. An optional opaque continuation token returned when `finish_reason` is `CONTINUATION`. Clients can pass this token in a subsequent `GenerateContentRequest` to continue generation. "finishMessage": "A String", # Output only. Describes the reason the model stopped generating tokens in more detail. This field is returned only when `finish_reason` is set. "finishReason": "A String", # Output only. The reason why the model stopped generating tokens. If empty, the model has not stopped generating. "groundingMetadata": { # Information about the sources that support the content of a response. When grounding is enabled, the model returns citations for claims in the response. This object contains the retrieved sources. # Output only. Metadata returned when grounding is enabled. It contains the sources used to ground the generated content. diff --git a/docs/dyn/aiplatform_v1.reasoningEngines.html b/docs/dyn/aiplatform_v1.reasoningEngines.html index c606219dc3..be05f70c3b 100644 --- a/docs/dyn/aiplatform_v1.reasoningEngines.html +++ b/docs/dyn/aiplatform_v1.reasoningEngines.html @@ -244,7 +244,7 @@

Method Details

{ # A single conversation event. "content": { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. # Required. Represents the content of the event. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -656,7 +656,7 @@

Method Details

{ # A single conversation event. "content": { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. # Required. Represents the content of the event. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -963,7 +963,7 @@

Method Details

{ # A single conversation event. "content": { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. # Required. Represents the content of the event. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -1275,7 +1275,7 @@

Method Details

{ # A single conversation event. "content": { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. # Required. Represents the content of the event. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. diff --git a/docs/dyn/aiplatform_v1.v1.html b/docs/dyn/aiplatform_v1.v1.html index 9f4b083d7a..33759361de 100644 --- a/docs/dyn/aiplatform_v1.v1.html +++ b/docs/dyn/aiplatform_v1.v1.html @@ -1009,7 +1009,7 @@

Method Details

"contents": [ # Optional. Repeated contents. { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -1356,7 +1356,7 @@

Method Details

"contents": [ # Optional. Repeated contents. { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -1699,7 +1699,7 @@

Method Details

"contents": [ # Optional. Repeated contents. { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -1798,7 +1798,7 @@

Method Details

"event": [ # Optional. A list of events. { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -2371,7 +2371,598 @@

Method Details

"author": "A String", # Required. The ID of the agent or entity that generated this event. "content": { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. # Required. The content of the event (e.g., text response, tool call, tool response). "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. + "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. + "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. + "text": "A String", # Required. The transcription text of this audio segment. + "words": [ # Optional. Detailed word-level transcriptions and timing details. Present when `word_timestamp` is set. + { # Information about a single recognized word. + "endOffset": "A String", # Optional. End offset in time of the word relative to the start of the audio. + "startOffset": "A String", # Optional. Start offset in time of the word relative to the start of the audio. + "word": "A String", # Required. Transcript of the word. + }, + ], + }, + "codeExecutionResult": { # Result of executing the ExecutableCode. Generated only when the `CodeExecution` tool is used. # Optional. The result of executing the ExecutableCode. + "id": "A String", # Optional. The identifier of the `ExecutableCode` part this result is for. Only populated if the corresponding `ExecutableCode` has an id. + "outcome": "A String", # Required. Outcome of the code execution. + "output": "A String", # Optional. Contains stdout when code execution is successful, stderr or other description otherwise. + }, + "executableCode": { # Code generated by the model that is meant to be executed, and the result returned to the model. Generated when using the `CodeExecution` tool, in which the code will be automatically executed, and a corresponding CodeExecutionResult will also be generated. # Optional. Code generated by the model that is intended to be executed. + "code": "A String", # Required. The code to be executed. + "id": "A String", # Optional. Unique identifier of the `ExecutableCode` part. The server returns the `CodeExecutionResult` with the matching `id`. + "language": "A String", # Required. Programming language of the `code`. + }, + "fileData": { # URI-based data. A FileData message contains a URI pointing to data of a specific media type. It is used to represent images, audio, and video stored in Google Cloud Storage. # Optional. The URI-based data of the part. This can be used to include files from Google Cloud Storage. + "displayName": "A String", # Optional. The display name of the file. Used to provide a label or filename to distinguish files. This field is only returned in `PromptMessage` for prompt management. It is used in the Gemini calls only when server side tools (`code_execution`, `google_search`, and `url_context`) are enabled. + "fileUri": "A String", # Required. The URI of the file in Google Cloud Storage. + "mimeType": "A String", # Required. The IANA standard MIME type of the source data. + }, + "functionCall": { # A predicted FunctionCall returned from the model that contains a string representing the FunctionDeclaration.name and a structured JSON object containing the parameters and their values. # Optional. A predicted function call returned from the model. This contains the name of the function to call and the arguments to pass to the function. + "args": { # Optional. The function parameters and values in JSON object format. See FunctionDeclaration.parameters for parameter details. + "a_key": "", # Properties of the object. + }, + "id": "A String", # Optional. The unique id of the function call. If populated, the client to execute the `function_call` and return the response with the matching `id`. + "name": "A String", # Optional. The name of the function to call. Matches FunctionDeclaration.name. + "partialArgs": [ # Optional. The partial argument value of the function call. If provided, represents the arguments/fields that are streamed incrementally. + { # Partial argument value of the function call. + "boolValue": True or False, # Optional. Represents a boolean value. + "jsonPath": "A String", # Required. A JSON Path (RFC 9535) to the argument being streamed. https://datatracker.ietf.org/doc/html/rfc9535. e.g. "$.foo.bar[0].data". + "nullValue": "A String", # Optional. Represents a null value. + "numberValue": 3.14, # Optional. Represents a double value. + "stringValue": "A String", # Optional. Represents a string value. + "willContinue": True or False, # Optional. Whether this is not the last part of the same json_path. If true, another PartialArg message for the current json_path is expected to follow. + }, + ], + "willContinue": True or False, # Optional. Whether this is the last part of the FunctionCall. If true, another partial message for the current FunctionCall is expected to follow. + }, + "functionResponse": { # The result output from a FunctionCall that contains a string representing the FunctionDeclaration.name and a structured JSON object containing any output from the function is used as context to the model. This should contain the result of a `FunctionCall` made based on model prediction. # Optional. The result of a function call. This is used to provide the model with the result of a function call that it predicted. + "id": "A String", # Optional. The id of the function call this response is for. Populated by the client to match the corresponding function call `id`. + "name": "A String", # Required. The name of the function to call. Matches FunctionDeclaration.name and FunctionCall.name. + "parts": [ # Optional. Ordered `Parts` that constitute a function response. Parts may have different IANA MIME types. + { # A datatype containing media that is part of a `FunctionResponse` message. A `FunctionResponsePart` consists of data which has an associated datatype. A `FunctionResponsePart` can only contain one of the accepted types in `FunctionResponsePart.data`. A `FunctionResponsePart` must have a fixed IANA MIME type identifying the type and subtype of the media if the `inline_data` field is filled with raw bytes. + "fileData": { # URI based data for function response. # URI based data. + "displayName": "A String", # Optional. Display name of the file data. Used to provide a label or filename to distinguish file datas. This field is only returned in PromptMessage for prompt management. It is currently used in the Gemini GenerateContent calls only when server side tools (code_execution, google_search, and url_context) are enabled. + "fileUri": "A String", # Required. URI. + "mimeType": "A String", # Required. The IANA standard MIME type of the source data. + }, + "inlineData": { # Raw media bytes for function response. Text should not be sent as raw bytes, use the 'text' field. # Inline media bytes. + "data": "A String", # Required. Raw bytes. + "displayName": "A String", # Optional. Display name of the blob. Used to provide a label or filename to distinguish blobs. This field is only returned in PromptMessage for prompt management. It is currently used in the Gemini GenerateContent calls only when server side tools (code_execution, google_search, and url_context) are enabled. + "mimeType": "A String", # Required. The IANA standard MIME type of the source data. + }, + }, + ], + "response": { # Required. The function response in JSON object format. Use "output" key to specify function output and "error" key to specify error details (if any). If "output" and "error" keys are not specified, then whole "response" is treated as function output. + "a_key": "", # Properties of the object. + }, + "scheduling": "A String", # Optional. Specifies how the response should be scheduled in the conversation. Only applicable to NON_BLOCKING function calls, is ignored otherwise. Defaults to WHEN_IDLE. + }, + "inlineData": { # A content blob. A Blob contains data of a specific media type. It is used to represent images, audio, and video. # Optional. The inline data content of the part. This can be used to include images, audio, or video in a request. + "data": "A String", # Required. The raw bytes of the data. + "displayName": "A String", # Optional. The display name of the blob. Used to provide a label or filename to distinguish blobs. This field is only returned in `PromptMessage` for prompt management. It is used in the Gemini calls only when server-side tools (`code_execution`, `google_search`, and `url_context`) are enabled. + "mimeType": "A String", # Required. The IANA standard MIME type of the source data. + }, + "mediaResolution": { # per part media resolution. Media resolution for the input media. # per part media resolution. Media resolution for the input media. + "level": "A String", # The tokenization quality used for given media. + }, + "speechMetadata": { # Structured Metadata Sub-Message for Part # Optional. Turn-level metadata for speech generation (e.g. Daikon speaker/style). May be set alongside `text` to attach speaker and style information to a text part. + "speaker": "A String", # Optional. Identifies which speaker is speaking this turn. + "style": "A String", # Optional. Natural language description of the vocal style (e.g., "cheerful"). + }, + "text": "A String", # Optional. The text content of the part. When sent from the VSCode Gemini Code Assist extension, references to @mentioned items will be converted to markdown boldface text. For example `@my-repo` will be converted to and sent as `**my-repo**` by the IDE agent. + "thought": True or False, # Optional. Indicates whether the `part` represents the model's thought process or reasoning. + "thoughtSignature": "A String", # Optional. An opaque signature for the thought so it can be reused in subsequent requests. + "videoMetadata": { # Provides metadata for a video, including the start and end offsets for clipping and the frame rate. # Optional. Video metadata. The metadata should only be specified while the video data is presented in inline_data or file_data. + "endOffset": "A String", # Optional. The end offset of the video. + "fps": 3.14, # Optional. The frame rate of the video sent to the model. If not specified, the default value is 1.0. The valid range is (0.0, 24.0]. + "startOffset": "A String", # Optional. The start offset of the video. + }, + }, + ], + "role": "A String", # Optional. The producer of the content. Must be either 'user' or 'model'. If not set, the service will default to 'user'. + }, + "eventTime": "A String", # Optional. The timestamp when the event occurred. + "stateDelta": { # Optional. The change in the session state caused by this event. This is a key-value map of fields that were modified or added by the event. + "a_key": "", # Properties of the object. + }, + }, + ], + "turnId": "A String", # Optional. A unique identifier for the turn. Useful for referencing specific turns across systems. + "turnIndex": 42, # Required. The 0-based index of the turn in the conversation sequence. + }, + ], + }, + "agentEvalData": { # Represents data specific to multi-turn agent evaluations. # Optional. Data used for agent evaluation. + "agents": { # Optional. A map containing the static configurations for each agent in the system. Key: agent_id (matches the `author` field in events). Value: The static configuration of the agent. + "a_key": { # Represents configuration for an Agent. + "agentId": "A String", # Required. Unique identifier of the agent. This ID is used to refer to this agent, e.g., in AgentEvent.author, or in the `sub_agents` field. It must be unique within the `agents` map. + "agentType": "A String", # Optional. The type or class of the agent (e.g., "LlmAgent", "RouterAgent", "ToolUseAgent"). Useful for the autorater to understand the expected behavior of the agent. + "description": "A String", # Optional. A high-level description of the agent's role and responsibilities. Critical for evaluating if the agent is routing tasks correctly. + "instruction": "A String", # Optional. Provides instructions for the LLM model, guiding the agent's behavior. Can be static or dynamic. Dynamic instructions can contain placeholders like {variable_name} that will be resolved at runtime using the `AgentEvent.state_delta` field. + "subAgents": [ # Optional. The list of valid agent IDs that this agent can delegate to. This defines the directed edges in the multi-agent system graph topology. + "A String", + ], + "tools": [ # Optional. The list of tools available to this agent. + { # Tool details that the model may use to generate response. A `Tool` is a piece of code that enables the system to interact with external systems to perform an action, or set of actions, outside of knowledge and scope of the model. A Tool object should contain exactly one type of Tool (e.g FunctionDeclaration, Retrieval or GoogleSearchRetrieval). + "codeExecution": { # Tool that executes code generated by the model, and automatically returns the result to the model. See also ExecutableCode and CodeExecutionResult, which are input and output to this tool. # Optional. CodeExecution tool type. Enables the model to execute code as part of generation. + }, + "computerUse": { # A tool that enables the model to interact directly with a computer environment. # Optional. Tool to support the model interacting directly with the computer. If enabled, it automatically populates computer-use specific Function Declarations. + "disabledSafetyPolicies": [ # Optional. A list of safety policies to disable for the computer use tool. + "A String", + ], + "enablePromptInjectionDetection": True or False, # Optional. Whether to enable the prompt injection detection check on the computer use request. + "environment": "A String", # Required. The target environment where the computer use tool operates. + "excludedPredefinedFunctions": [ # Optional. A list of predefined functions to explicitly exclude from the model call. By default, [predefined functions](https://cloud.google.com/vertex-ai/generative-ai/docs/computer-use#supported-actions) are included. Excluding functions allows for a more restricted action space or custom definitions for predefined functions. + "A String", + ], + }, + "enterpriseWebSearch": { # Tool to search public web data, powered by Vertex AI Search and Sec4 compliance. # Optional. Tool to support searching public web data, powered by Vertex AI Search and Sec4 compliance. + "blockingConfidence": "A String", # Optional. Sites with confidence level chosen & above this value will be blocked from the search results. + "excludeDomains": [ # Optional. List of domains to be excluded from the search results. The default limit is 2000 domains. + "A String", + ], + }, + "exaAiSearch": { # ExaAiSearch tool type. A tool that uses the Exa.ai search engine for grounding. # Optional. Uses Exa.ai to search for information to answer user queries. The search results will be grounded on Exa.ai and presented to the model for response generation + "apiKey": "A String", # Required. The API key for ExaAiSearch. + "customConfigs": { # Optional. This field can be used to pass any parameter from the Exa.ai Search API. + "a_key": "", # Properties of the object. + }, + }, + "functionDeclarations": [ # Optional. Function tool type. One or more function declarations to be passed to the model along with the current user query. Model may decide to call a subset of these functions by populating FunctionCall in the response. User should provide a FunctionResponse for each function call in the next turn. Based on the function responses, Model will generate the final response back to the user. Maximum 512 function declarations can be provided. + { # Structured representation of a function declaration as defined by the [OpenAPI 3.0 specification](https://spec.openapis.org/oas/v3.0.3). Included in this declaration are the function name, description, parameters and response type. This FunctionDeclaration is a representation of a block of code that can be used as a `Tool` by the model and executed by the client. + "behavior": "A String", # Optional. Specifies the function Behavior. If not specified, the system keeps the current function call behavior. This field is currently only supported by the BidiGenerateContent method. + "description": "A String", # Optional. Description and purpose of the function. Model uses it to decide how and whether to call the function. + "name": "A String", # Required. The name of the function to call. Must start with a letter or an underscore. Must be a-z, A-Z, 0-9, or contain underscores, dots, colons and dashes, with a maximum length of 128. + "parameters": { # Defines the schema of input and output data. This is a subset of the [OpenAPI 3.0 Schema Object](https://spec.openapis.org/oas/v3.0.3#schema-object). # Optional. Describes the parameters to this function in JSON Schema Object format. Reflects the Open API 3.03 Parameter Object. string Key: the name of the parameter. Parameter names are case sensitive. Schema Value: the Schema defining the type used for the parameter. For function with no parameters, this can be left unset. Parameter names must start with a letter or an underscore and must only contain chars a-z, A-Z, 0-9, or underscores with a maximum length of 64. Example with 1 required and 1 optional parameter: type: OBJECT properties: param1: type: STRING param2: type: INTEGER required: - param1 + "additionalProperties": "", # Optional. If `type` is `OBJECT`, specifies how to handle properties not defined in `properties`. If it is a boolean `false`, no additional properties are allowed. If it is a schema, additional properties are allowed if they conform to the schema. + "anyOf": [ # Optional. The instance must be valid against any (one or more) of the subschemas listed in `any_of`. + # Object with schema name: GoogleCloudAiplatformV1Schema + ], + "default": "", # Optional. Default value to use if the field is not specified. + "defs": { # Optional. `defs` provides a map of schema definitions that can be reused by `ref` elsewhere in the schema. Only allowed at root level of the schema. + "a_key": # Object with schema name: GoogleCloudAiplatformV1Schema + }, + "description": "A String", # Optional. Describes the data. The model uses this field to understand the purpose of the schema and how to use it. It is a best practice to provide a clear and descriptive explanation for the schema and its properties here, rather than in the prompt. + "enum": [ # Optional. Possible values of the field. This field can be used to restrict a value to a fixed set of values. To mark a field as an enum, set `format` to `enum` and provide the list of possible values in `enum`. For example: 1. To define directions: `{type:STRING, format:enum, enum:["EAST", "NORTH", "SOUTH", "WEST"]}` 2. To define apartment numbers: `{type:INTEGER, format:enum, enum:["101", "201", "301"]}` + "A String", + ], + "example": "", # Optional. Example of an instance of this schema. + "format": "A String", # Optional. The format of the data. For `NUMBER` type, format can be `float` or `double`. For `INTEGER` type, format can be `int32` or `int64`. For `STRING` type, format can be `email`, `byte`, `date`, `date-time`, `password`, and other formats to further refine the data type. + "items": # Object with schema name: GoogleCloudAiplatformV1Schema # Optional. If type is `ARRAY`, `items` specifies the schema of elements in the array. + "maxItems": "A String", # Optional. If type is `ARRAY`, `max_items` specifies the maximum number of items in an array. + "maxLength": "A String", # Optional. If type is `STRING`, `max_length` specifies the maximum length of the string. + "maxProperties": "A String", # Optional. If type is `OBJECT`, `max_properties` specifies the maximum number of properties that can be provided. + "maximum": 3.14, # Optional. If type is `INTEGER` or `NUMBER`, `maximum` specifies the maximum allowed value. + "minItems": "A String", # Optional. If type is `ARRAY`, `min_items` specifies the minimum number of items in an array. + "minLength": "A String", # Optional. If type is `STRING`, `min_length` specifies the minimum length of the string. + "minProperties": "A String", # Optional. If type is `OBJECT`, `min_properties` specifies the minimum number of properties that can be provided. + "minimum": 3.14, # Optional. If type is `INTEGER` or `NUMBER`, `minimum` specifies the minimum allowed value. + "nullable": True or False, # Optional. Indicates if the value of this field can be null. + "pattern": "A String", # Optional. If type is `STRING`, `pattern` specifies a regular expression that the string must match. + "properties": { # Optional. If type is `OBJECT`, `properties` is a map of property names to schema definitions for each property of the object. + "a_key": # Object with schema name: GoogleCloudAiplatformV1Schema + }, + "propertyOrdering": [ # Optional. Order of properties displayed or used where order matters. This is not a standard field in OpenAPI specification, but can be used to control the order of properties. + "A String", + ], + "ref": "A String", # Optional. Allows referencing another schema definition to use in place of this schema. The value must be a valid reference to a schema in `defs`. For example, the following schema defines a reference to a schema node named "Pet": type: object properties: pet: ref: #/defs/Pet defs: Pet: type: object properties: name: type: string The value of the "pet" property is a reference to the schema node named "Pet". See details in https://json-schema.org/understanding-json-schema/structuring + "required": [ # Optional. If type is `OBJECT`, `required` lists the names of properties that must be present. + "A String", + ], + "title": "A String", # Optional. Title for the schema. + "type": "A String", # Optional. Data type of the schema field. + }, + "parametersJsonSchema": "", # Optional. Describes the parameters to the function in JSON Schema format. The schema must describe an object where the properties are the parameters to the function. For example: ``` { "type": "object", "properties": { "name": { "type": "string" }, "age": { "type": "integer" } }, "additionalProperties": false, "required": ["name", "age"], "propertyOrdering": ["name", "age"] } ``` This field is mutually exclusive with `parameters`. + "response": { # Defines the schema of input and output data. This is a subset of the [OpenAPI 3.0 Schema Object](https://spec.openapis.org/oas/v3.0.3#schema-object). # Optional. Describes the output from this function in JSON Schema format. Reflects the Open API 3.03 Response Object. The Schema defines the type used for the response value of the function. + "additionalProperties": "", # Optional. If `type` is `OBJECT`, specifies how to handle properties not defined in `properties`. If it is a boolean `false`, no additional properties are allowed. If it is a schema, additional properties are allowed if they conform to the schema. + "anyOf": [ # Optional. The instance must be valid against any (one or more) of the subschemas listed in `any_of`. + # Object with schema name: GoogleCloudAiplatformV1Schema + ], + "default": "", # Optional. Default value to use if the field is not specified. + "defs": { # Optional. `defs` provides a map of schema definitions that can be reused by `ref` elsewhere in the schema. Only allowed at root level of the schema. + "a_key": # Object with schema name: GoogleCloudAiplatformV1Schema + }, + "description": "A String", # Optional. Describes the data. The model uses this field to understand the purpose of the schema and how to use it. It is a best practice to provide a clear and descriptive explanation for the schema and its properties here, rather than in the prompt. + "enum": [ # Optional. Possible values of the field. This field can be used to restrict a value to a fixed set of values. To mark a field as an enum, set `format` to `enum` and provide the list of possible values in `enum`. For example: 1. To define directions: `{type:STRING, format:enum, enum:["EAST", "NORTH", "SOUTH", "WEST"]}` 2. To define apartment numbers: `{type:INTEGER, format:enum, enum:["101", "201", "301"]}` + "A String", + ], + "example": "", # Optional. Example of an instance of this schema. + "format": "A String", # Optional. The format of the data. For `NUMBER` type, format can be `float` or `double`. For `INTEGER` type, format can be `int32` or `int64`. For `STRING` type, format can be `email`, `byte`, `date`, `date-time`, `password`, and other formats to further refine the data type. + "items": # Object with schema name: GoogleCloudAiplatformV1Schema # Optional. If type is `ARRAY`, `items` specifies the schema of elements in the array. + "maxItems": "A String", # Optional. If type is `ARRAY`, `max_items` specifies the maximum number of items in an array. + "maxLength": "A String", # Optional. If type is `STRING`, `max_length` specifies the maximum length of the string. + "maxProperties": "A String", # Optional. If type is `OBJECT`, `max_properties` specifies the maximum number of properties that can be provided. + "maximum": 3.14, # Optional. If type is `INTEGER` or `NUMBER`, `maximum` specifies the maximum allowed value. + "minItems": "A String", # Optional. If type is `ARRAY`, `min_items` specifies the minimum number of items in an array. + "minLength": "A String", # Optional. If type is `STRING`, `min_length` specifies the minimum length of the string. + "minProperties": "A String", # Optional. If type is `OBJECT`, `min_properties` specifies the minimum number of properties that can be provided. + "minimum": 3.14, # Optional. If type is `INTEGER` or `NUMBER`, `minimum` specifies the minimum allowed value. + "nullable": True or False, # Optional. Indicates if the value of this field can be null. + "pattern": "A String", # Optional. If type is `STRING`, `pattern` specifies a regular expression that the string must match. + "properties": { # Optional. If type is `OBJECT`, `properties` is a map of property names to schema definitions for each property of the object. + "a_key": # Object with schema name: GoogleCloudAiplatformV1Schema + }, + "propertyOrdering": [ # Optional. Order of properties displayed or used where order matters. This is not a standard field in OpenAPI specification, but can be used to control the order of properties. + "A String", + ], + "ref": "A String", # Optional. Allows referencing another schema definition to use in place of this schema. The value must be a valid reference to a schema in `defs`. For example, the following schema defines a reference to a schema node named "Pet": type: object properties: pet: ref: #/defs/Pet defs: Pet: type: object properties: name: type: string The value of the "pet" property is a reference to the schema node named "Pet". See details in https://json-schema.org/understanding-json-schema/structuring + "required": [ # Optional. If type is `OBJECT`, `required` lists the names of properties that must be present. + "A String", + ], + "title": "A String", # Optional. Title for the schema. + "type": "A String", # Optional. Data type of the schema field. + }, + "responseJsonSchema": "", # Optional. Describes the output from this function in JSON Schema format. The value specified by the schema is the response value of the function. This field is mutually exclusive with `response`. + }, + ], + "googleMaps": { # Tool to retrieve public maps data for grounding, powered by Google. # Optional. GoogleMaps tool type. Tool to support Google Maps in Model. + "enableWidget": True or False, # Optional. Deprecated: The Google Maps contextual widget behavior in Grounding with Google Maps is being deprecated; this field is planned for removal and no longer has any effect once removed. If true, include the widget context token in the response. + "groundingTypes": { # Defines the types of Google Maps grounding that can be enabled and their configurations. # Optional. Specifies the types of Google Maps grounding to enable. Defaults to `places` when unset. + "places": { # Grounding with Google Maps Places data (e.g. QueryPlaces). This is the default Google Maps grounding type when no other type is specified. # Optional. Enables grounding with Google Maps Places. This is the default grounding type when no `GroundingTypes` are specified. + }, + "routing": { # Grounding with Google Maps Routing APIs (ComputeRoutes and SearchAlongRoute). # Optional. Enables grounding with Google Maps Routing APIs (ComputeRoutes and SearchAlongRoute). + }, + }, + }, + "googleSearch": { # GoogleSearch tool type. Tool to support Google Search in Model. Powered by Google. # Optional. GoogleSearch tool type. Tool to support Google Search in Model. Powered by Google. + "blockingConfidence": "A String", # Optional. Sites with confidence level chosen & above this value will be blocked from the search results. + "excludeDomains": [ # Optional. List of domains to be excluded from the search results. The default limit is 2000 domains. Example: ["amazon.com", "facebook.com"]. + "A String", + ], + "searchTypes": { # Different types of search that can be enabled on the GoogleSearch tool. # Optional. The set of search types to enable. If not set, web search is enabled by default. + "imageSearch": { # Image search for grounding and related configurations. # Optional. Setting this field enables image search. Image bytes are returned. + }, + "webSearch": { # Standard web search for grounding and related configurations. Only text results are returned. # Optional. Setting this field enables web search. Only text results are returned. + }, + }, + }, + "googleSearchRetrieval": { # Tool to retrieve public web data for grounding, powered by Google. # Optional. Specialized retrieval tool that is powered by Google Search. + "dynamicRetrievalConfig": { # Describes the options to customize dynamic retrieval. # Specifies the dynamic retrieval configuration for the given source. + "dynamicThreshold": 3.14, # Optional. The threshold to be used in dynamic retrieval. If not set, a system default value is used. + "mode": "A String", # The mode of the predictor to be used in dynamic retrieval. + }, + }, + "parallelAiSearch": { # ParallelAiSearch tool type. A tool that uses the Parallel.ai search engine for grounding. # Optional. If specified, Vertex AI will use Parallel.ai to search for information to answer user queries. The search results will be grounded on Parallel.ai and presented to the model for response generation + "apiKey": "A String", # Optional. The API key for ParallelAiSearch. If an API key is not provided, the system will attempt to verify access by checking for an active Parallel.ai subscription through the Google Cloud Marketplace. See https://docs.parallel.ai/search/search-quickstart for more details. + "customConfigs": { # Optional. Custom configs for ParallelAiSearch. This field can be used to pass any parameter from the Parallel.ai Search API. See the Parallel.ai documentation for the full list of available parameters and their usage: https://docs.parallel.ai/api-reference/search-beta/search Currently only `source_policy`, `excerpts`, `max_results`, `mode`, `fetch_policy` can be set via this field. For example: { "source_policy": { "include_domains": ["google.com", "wikipedia.org"], "exclude_domains": ["example.com"] }, "fetch_policy": { "max_age_seconds": 3600 } } + "a_key": "", # Properties of the object. + }, + "enableDataRetention": True or False, # Optional. Deprecated: Use `enable_zero_data_retention` instead. Instructs Vertex Grounding to use Parallel's Zero Data Retention Marketplace product. If this value is "false" or omitted, the Parallel Web Search for Grounding standard subscription will be used. If this value is "true", the Parallel Web Search for Grounding - ZDR subscription will be used. + "enableZeroDataRetention": True or False, # Optional. Instructs Vertex Grounding to use Parallel's Zero Data Retention Marketplace product. If this value is "false" or omitted, the Parallel Web Search for Grounding standard subscription will be used. If this value is "true", the Parallel Web Search for Grounding - ZDR subscription will be used. + }, + "retrieval": { # Defines a retrieval tool that model can call to access external knowledge. # Optional. Retrieval tool type. System will always execute the provided retrieval tool(s) to get external knowledge to answer the prompt. Retrieval results are presented to the model for generation. + "disableAttribution": True or False, # Optional. Deprecated. This option is no longer supported. + "externalApi": { # Retrieve from data source powered by external API for grounding. The external API is not owned by Google, but need to follow the pre-defined API spec. # Use data source powered by external API for grounding. + "apiAuth": { # The generic reusable api auth config. Deprecated. Please use AuthConfig (google/cloud/aiplatform/master/auth.proto) instead. # The authentication config to access the API. Deprecated. Please use auth_config instead. + "apiKeyConfig": { # The API secret. # The API secret. + "apiKeySecretVersion": "A String", # Required. The SecretManager secret version resource name storing API key. e.g. projects/{project}/secrets/{secret}/versions/{version} + "apiKeyString": "A String", # The API key string. Either this or `api_key_secret_version` must be set. + }, + }, + "apiSpec": "A String", # The API spec that the external API implements. + "authConfig": { # Auth configuration to run the extension. # The authentication config to access the API. + "apiKeyConfig": { # Config for authentication with API key. # Config for API key auth. + "apiKeySecret": "A String", # Optional. The name of the SecretManager secret version resource storing the API key. Format: `projects/{project}/secrets/{secrete}/versions/{version}` - If both `api_key_secret` and `api_key_string` are specified, this field takes precedence over `api_key_string`. - If specified, the `secretmanager.versions.access` permission should be granted to Vertex AI Extension Service Agent (https://cloud.google.com/vertex-ai/docs/general/access-control#service-agents) on the specified resource. + "apiKeyString": "A String", # Optional. The API key to be used in the request directly. + "httpElementLocation": "A String", # Optional. The location of the API key. + "name": "A String", # Optional. The parameter name of the API key. E.g. If the API request is "https://example.com/act?api_key=", "api_key" would be the parameter name. + }, + "authType": "A String", # Type of auth scheme. + "googleServiceAccountConfig": { # Config for Google Service Account Authentication. # Config for Google Service Account auth. + "serviceAccount": "A String", # Optional. The service account that the extension execution service runs as. - If the service account is specified, the `iam.serviceAccounts.getAccessToken` permission should be granted to Vertex AI Extension Service Agent (https://cloud.google.com/vertex-ai/docs/general/access-control#service-agents) on the specified service account. - If not specified, the Vertex AI Extension Service Agent will be used to execute the Extension. + }, + "httpBasicAuthConfig": { # Config for HTTP Basic Authentication. # Config for HTTP Basic auth. + "credentialSecret": "A String", # Required. The name of the SecretManager secret version resource storing the base64 encoded credentials. Format: `projects/{project}/secrets/{secrete}/versions/{version}` - If specified, the `secretmanager.versions.access` permission should be granted to Vertex AI Extension Service Agent (https://cloud.google.com/vertex-ai/docs/general/access-control#service-agents) on the specified resource. + }, + "oauthConfig": { # Config for user oauth. # Config for user oauth. + "accessToken": "A String", # Access token for extension endpoint. Only used to propagate token from [[ExecuteExtensionRequest.runtime_auth_config]] at request time. + "serviceAccount": "A String", # The service account used to generate access tokens for executing the Extension. - If the service account is specified, the `iam.serviceAccounts.getAccessToken` permission should be granted to Vertex AI Extension Service Agent (https://cloud.google.com/vertex-ai/docs/general/access-control#service-agents) on the provided service account. + }, + "oidcConfig": { # Config for user OIDC auth. # Config for user OIDC auth. + "idToken": "A String", # OpenID Connect formatted ID token for extension endpoint. Only used to propagate token from [[ExecuteExtensionRequest.runtime_auth_config]] at request time. + "serviceAccount": "A String", # The service account used to generate an OpenID Connect (OIDC)-compatible JWT token signed by the Google OIDC Provider (accounts.google.com) for extension endpoint (https://cloud.google.com/iam/docs/create-short-lived-credentials-direct#sa-credentials-oidc). - The audience for the token will be set to the URL in the server url defined in the OpenApi spec. - If the service account is provided, the service account should grant `iam.serviceAccounts.getOpenIdToken` permission to Vertex AI Extension Service Agent (https://cloud.google.com/vertex-ai/docs/general/access-control#service-agents). + }, + }, + "elasticSearchParams": { # The search parameters to use for the ELASTIC_SEARCH spec. # Parameters for the elastic search API. + "index": "A String", # The ElasticSearch index to use. + "numHits": 42, # Optional. Number of hits (chunks) to request. When specified, it is passed to Elasticsearch as the `num_hits` param. + "searchTemplate": "A String", # The ElasticSearch search template to use. + }, + "endpoint": "A String", # The endpoint of the external API. The system will call the API at this endpoint to retrieve the data for grounding. Example: https://acme.com:443/search + "simpleSearchParams": { # The search parameters to use for SIMPLE_SEARCH spec. # Parameters for the simple search API. + }, + }, + "vertexAiSearch": { # Retrieve from Vertex AI Search datastore or engine for grounding. datastore and engine are mutually exclusive. See https://cloud.google.com/products/agent-builder # Set to use data source powered by Vertex AI Search. + "dataStoreSpecs": [ # Specifications that define the specific DataStores to be searched, along with configurations for those data stores. This is only considered for Engines with multiple data stores. It should only be set if engine is used. + { # Define data stores within engine to filter on in a search call and configurations for those data stores. For more information, see https://cloud.google.com/generative-ai-app-builder/docs/reference/rpc/google.cloud.discoveryengine.v1#datastorespec + "dataStore": "A String", # Full resource name of DataStore, such as Format: `projects/{project}/locations/{location}/collections/{collection}/dataStores/{dataStore}` + "filter": "A String", # Optional. Filter specification to filter documents in the data store specified by data_store field. For more information on filtering, see [Filtering](https://cloud.google.com/generative-ai-app-builder/docs/filter-search-metadata) + }, + ], + "datastore": "A String", # Optional. Fully-qualified Vertex AI Search data store resource ID. Format: `projects/{project}/locations/{location}/collections/{collection}/dataStores/{dataStore}` + "engine": "A String", # Optional. Fully-qualified Vertex AI Search engine resource ID. Format: `projects/{project}/locations/{location}/collections/{collection}/engines/{engine}` + "filter": "A String", # Optional. Filter strings to be passed to the search API. + "maxResults": 42, # Optional. Number of search results to return per query. The default value is 10. The maximumm allowed value is 10. + }, + "vertexRagStore": { # Retrieve from Vertex RAG Store for grounding. # Set to use data source powered by Vertex RAG store. User data is uploaded via the VertexRagDataService. + "ragResources": [ # Optional. The representation of the rag source. It can be used to specify corpus only or ragfiles. Currently only support one corpus or multiple files from one corpus. In the future we may open up multiple corpora support. + { # The definition of the Rag resource. + "ragCorpus": "A String", # Optional. RagCorpora resource name. Format: `projects/{project}/locations/{location}/ragCorpora/{rag_corpus}` + "ragFileIds": [ # Optional. rag_file_id. The files should be in the same rag_corpus set in rag_corpus field. + "A String", + ], + }, + ], + "ragRetrievalConfig": { # Specifies the context retrieval config. # Optional. The retrieval config for the Rag query. + "filter": { # Config for filters. # Optional. Config for filters. + "metadataFilter": "A String", # Optional. String for metadata filtering. + "vectorDistanceThreshold": 3.14, # Optional. Only returns contexts with vector distance smaller than the threshold. + "vectorSimilarityThreshold": 3.14, # Optional. Only returns contexts with vector similarity larger than the threshold. + }, + "ranking": { # Config for ranking and reranking. # Optional. Config for ranking and reranking. + "llmRanker": { # Config for LlmRanker. # Optional. Config for LlmRanker. + "modelName": "A String", # Optional. The model name used for ranking. See [Supported models](https://cloud.google.com/vertex-ai/generative-ai/docs/model-reference/inference#supported-models). + }, + "rankService": { # Config for Rank Service. # Optional. Config for Rank Service. + "modelName": "A String", # Optional. The model name of the rank service. Format: `semantic-ranker-512@latest` + }, + }, + "topK": 42, # Optional. The number of contexts to retrieve. + }, + "similarityTopK": 42, # Optional. Number of top k results to return from the selected corpora. + "vectorDistanceThreshold": 3.14, # Optional. Only return results with vector distance smaller than the threshold. + }, + }, + "urlContext": { # Tool to support URL context. # Optional. Tool to support URL context retrieval. + }, + }, + ], + }, + }, + "turns": [ # Optional. A chronological list of conversation turns. Each turn represents a logical execution cycle (e.g., User Input -> Agent Response). + { # Represents a single turn/invocation in the conversation. + "events": [ # Optional. The list of events that occurred during this turn. + { # Represents a single event in the execution trace. + "activeTools": [ # Optional. The list of tools that were active/available to the agent at the time of this event. This overrides the `AgentConfig.tools` if set. + { # Tool details that the model may use to generate response. A `Tool` is a piece of code that enables the system to interact with external systems to perform an action, or set of actions, outside of knowledge and scope of the model. A Tool object should contain exactly one type of Tool (e.g FunctionDeclaration, Retrieval or GoogleSearchRetrieval). + "codeExecution": { # Tool that executes code generated by the model, and automatically returns the result to the model. See also ExecutableCode and CodeExecutionResult, which are input and output to this tool. # Optional. CodeExecution tool type. Enables the model to execute code as part of generation. + }, + "computerUse": { # A tool that enables the model to interact directly with a computer environment. # Optional. Tool to support the model interacting directly with the computer. If enabled, it automatically populates computer-use specific Function Declarations. + "disabledSafetyPolicies": [ # Optional. A list of safety policies to disable for the computer use tool. + "A String", + ], + "enablePromptInjectionDetection": True or False, # Optional. Whether to enable the prompt injection detection check on the computer use request. + "environment": "A String", # Required. The target environment where the computer use tool operates. + "excludedPredefinedFunctions": [ # Optional. A list of predefined functions to explicitly exclude from the model call. By default, [predefined functions](https://cloud.google.com/vertex-ai/generative-ai/docs/computer-use#supported-actions) are included. Excluding functions allows for a more restricted action space or custom definitions for predefined functions. + "A String", + ], + }, + "enterpriseWebSearch": { # Tool to search public web data, powered by Vertex AI Search and Sec4 compliance. # Optional. Tool to support searching public web data, powered by Vertex AI Search and Sec4 compliance. + "blockingConfidence": "A String", # Optional. Sites with confidence level chosen & above this value will be blocked from the search results. + "excludeDomains": [ # Optional. List of domains to be excluded from the search results. The default limit is 2000 domains. + "A String", + ], + }, + "exaAiSearch": { # ExaAiSearch tool type. A tool that uses the Exa.ai search engine for grounding. # Optional. Uses Exa.ai to search for information to answer user queries. The search results will be grounded on Exa.ai and presented to the model for response generation + "apiKey": "A String", # Required. The API key for ExaAiSearch. + "customConfigs": { # Optional. This field can be used to pass any parameter from the Exa.ai Search API. + "a_key": "", # Properties of the object. + }, + }, + "functionDeclarations": [ # Optional. Function tool type. One or more function declarations to be passed to the model along with the current user query. Model may decide to call a subset of these functions by populating FunctionCall in the response. User should provide a FunctionResponse for each function call in the next turn. Based on the function responses, Model will generate the final response back to the user. Maximum 512 function declarations can be provided. + { # Structured representation of a function declaration as defined by the [OpenAPI 3.0 specification](https://spec.openapis.org/oas/v3.0.3). Included in this declaration are the function name, description, parameters and response type. This FunctionDeclaration is a representation of a block of code that can be used as a `Tool` by the model and executed by the client. + "behavior": "A String", # Optional. Specifies the function Behavior. If not specified, the system keeps the current function call behavior. This field is currently only supported by the BidiGenerateContent method. + "description": "A String", # Optional. Description and purpose of the function. Model uses it to decide how and whether to call the function. + "name": "A String", # Required. The name of the function to call. Must start with a letter or an underscore. Must be a-z, A-Z, 0-9, or contain underscores, dots, colons and dashes, with a maximum length of 128. + "parameters": { # Defines the schema of input and output data. This is a subset of the [OpenAPI 3.0 Schema Object](https://spec.openapis.org/oas/v3.0.3#schema-object). # Optional. Describes the parameters to this function in JSON Schema Object format. Reflects the Open API 3.03 Parameter Object. string Key: the name of the parameter. Parameter names are case sensitive. Schema Value: the Schema defining the type used for the parameter. For function with no parameters, this can be left unset. Parameter names must start with a letter or an underscore and must only contain chars a-z, A-Z, 0-9, or underscores with a maximum length of 64. Example with 1 required and 1 optional parameter: type: OBJECT properties: param1: type: STRING param2: type: INTEGER required: - param1 + "additionalProperties": "", # Optional. If `type` is `OBJECT`, specifies how to handle properties not defined in `properties`. If it is a boolean `false`, no additional properties are allowed. If it is a schema, additional properties are allowed if they conform to the schema. + "anyOf": [ # Optional. The instance must be valid against any (one or more) of the subschemas listed in `any_of`. + # Object with schema name: GoogleCloudAiplatformV1Schema + ], + "default": "", # Optional. Default value to use if the field is not specified. + "defs": { # Optional. `defs` provides a map of schema definitions that can be reused by `ref` elsewhere in the schema. Only allowed at root level of the schema. + "a_key": # Object with schema name: GoogleCloudAiplatformV1Schema + }, + "description": "A String", # Optional. Describes the data. The model uses this field to understand the purpose of the schema and how to use it. It is a best practice to provide a clear and descriptive explanation for the schema and its properties here, rather than in the prompt. + "enum": [ # Optional. Possible values of the field. This field can be used to restrict a value to a fixed set of values. To mark a field as an enum, set `format` to `enum` and provide the list of possible values in `enum`. For example: 1. To define directions: `{type:STRING, format:enum, enum:["EAST", "NORTH", "SOUTH", "WEST"]}` 2. To define apartment numbers: `{type:INTEGER, format:enum, enum:["101", "201", "301"]}` + "A String", + ], + "example": "", # Optional. Example of an instance of this schema. + "format": "A String", # Optional. The format of the data. For `NUMBER` type, format can be `float` or `double`. For `INTEGER` type, format can be `int32` or `int64`. For `STRING` type, format can be `email`, `byte`, `date`, `date-time`, `password`, and other formats to further refine the data type. + "items": # Object with schema name: GoogleCloudAiplatformV1Schema # Optional. If type is `ARRAY`, `items` specifies the schema of elements in the array. + "maxItems": "A String", # Optional. If type is `ARRAY`, `max_items` specifies the maximum number of items in an array. + "maxLength": "A String", # Optional. If type is `STRING`, `max_length` specifies the maximum length of the string. + "maxProperties": "A String", # Optional. If type is `OBJECT`, `max_properties` specifies the maximum number of properties that can be provided. + "maximum": 3.14, # Optional. If type is `INTEGER` or `NUMBER`, `maximum` specifies the maximum allowed value. + "minItems": "A String", # Optional. If type is `ARRAY`, `min_items` specifies the minimum number of items in an array. + "minLength": "A String", # Optional. If type is `STRING`, `min_length` specifies the minimum length of the string. + "minProperties": "A String", # Optional. If type is `OBJECT`, `min_properties` specifies the minimum number of properties that can be provided. + "minimum": 3.14, # Optional. If type is `INTEGER` or `NUMBER`, `minimum` specifies the minimum allowed value. + "nullable": True or False, # Optional. Indicates if the value of this field can be null. + "pattern": "A String", # Optional. If type is `STRING`, `pattern` specifies a regular expression that the string must match. + "properties": { # Optional. If type is `OBJECT`, `properties` is a map of property names to schema definitions for each property of the object. + "a_key": # Object with schema name: GoogleCloudAiplatformV1Schema + }, + "propertyOrdering": [ # Optional. Order of properties displayed or used where order matters. This is not a standard field in OpenAPI specification, but can be used to control the order of properties. + "A String", + ], + "ref": "A String", # Optional. Allows referencing another schema definition to use in place of this schema. The value must be a valid reference to a schema in `defs`. For example, the following schema defines a reference to a schema node named "Pet": type: object properties: pet: ref: #/defs/Pet defs: Pet: type: object properties: name: type: string The value of the "pet" property is a reference to the schema node named "Pet". See details in https://json-schema.org/understanding-json-schema/structuring + "required": [ # Optional. If type is `OBJECT`, `required` lists the names of properties that must be present. + "A String", + ], + "title": "A String", # Optional. Title for the schema. + "type": "A String", # Optional. Data type of the schema field. + }, + "parametersJsonSchema": "", # Optional. Describes the parameters to the function in JSON Schema format. The schema must describe an object where the properties are the parameters to the function. For example: ``` { "type": "object", "properties": { "name": { "type": "string" }, "age": { "type": "integer" } }, "additionalProperties": false, "required": ["name", "age"], "propertyOrdering": ["name", "age"] } ``` This field is mutually exclusive with `parameters`. + "response": { # Defines the schema of input and output data. This is a subset of the [OpenAPI 3.0 Schema Object](https://spec.openapis.org/oas/v3.0.3#schema-object). # Optional. Describes the output from this function in JSON Schema format. Reflects the Open API 3.03 Response Object. The Schema defines the type used for the response value of the function. + "additionalProperties": "", # Optional. If `type` is `OBJECT`, specifies how to handle properties not defined in `properties`. If it is a boolean `false`, no additional properties are allowed. If it is a schema, additional properties are allowed if they conform to the schema. + "anyOf": [ # Optional. The instance must be valid against any (one or more) of the subschemas listed in `any_of`. + # Object with schema name: GoogleCloudAiplatformV1Schema + ], + "default": "", # Optional. Default value to use if the field is not specified. + "defs": { # Optional. `defs` provides a map of schema definitions that can be reused by `ref` elsewhere in the schema. Only allowed at root level of the schema. + "a_key": # Object with schema name: GoogleCloudAiplatformV1Schema + }, + "description": "A String", # Optional. Describes the data. The model uses this field to understand the purpose of the schema and how to use it. It is a best practice to provide a clear and descriptive explanation for the schema and its properties here, rather than in the prompt. + "enum": [ # Optional. Possible values of the field. This field can be used to restrict a value to a fixed set of values. To mark a field as an enum, set `format` to `enum` and provide the list of possible values in `enum`. For example: 1. To define directions: `{type:STRING, format:enum, enum:["EAST", "NORTH", "SOUTH", "WEST"]}` 2. To define apartment numbers: `{type:INTEGER, format:enum, enum:["101", "201", "301"]}` + "A String", + ], + "example": "", # Optional. Example of an instance of this schema. + "format": "A String", # Optional. The format of the data. For `NUMBER` type, format can be `float` or `double`. For `INTEGER` type, format can be `int32` or `int64`. For `STRING` type, format can be `email`, `byte`, `date`, `date-time`, `password`, and other formats to further refine the data type. + "items": # Object with schema name: GoogleCloudAiplatformV1Schema # Optional. If type is `ARRAY`, `items` specifies the schema of elements in the array. + "maxItems": "A String", # Optional. If type is `ARRAY`, `max_items` specifies the maximum number of items in an array. + "maxLength": "A String", # Optional. If type is `STRING`, `max_length` specifies the maximum length of the string. + "maxProperties": "A String", # Optional. If type is `OBJECT`, `max_properties` specifies the maximum number of properties that can be provided. + "maximum": 3.14, # Optional. If type is `INTEGER` or `NUMBER`, `maximum` specifies the maximum allowed value. + "minItems": "A String", # Optional. If type is `ARRAY`, `min_items` specifies the minimum number of items in an array. + "minLength": "A String", # Optional. If type is `STRING`, `min_length` specifies the minimum length of the string. + "minProperties": "A String", # Optional. If type is `OBJECT`, `min_properties` specifies the minimum number of properties that can be provided. + "minimum": 3.14, # Optional. If type is `INTEGER` or `NUMBER`, `minimum` specifies the minimum allowed value. + "nullable": True or False, # Optional. Indicates if the value of this field can be null. + "pattern": "A String", # Optional. If type is `STRING`, `pattern` specifies a regular expression that the string must match. + "properties": { # Optional. If type is `OBJECT`, `properties` is a map of property names to schema definitions for each property of the object. + "a_key": # Object with schema name: GoogleCloudAiplatformV1Schema + }, + "propertyOrdering": [ # Optional. Order of properties displayed or used where order matters. This is not a standard field in OpenAPI specification, but can be used to control the order of properties. + "A String", + ], + "ref": "A String", # Optional. Allows referencing another schema definition to use in place of this schema. The value must be a valid reference to a schema in `defs`. For example, the following schema defines a reference to a schema node named "Pet": type: object properties: pet: ref: #/defs/Pet defs: Pet: type: object properties: name: type: string The value of the "pet" property is a reference to the schema node named "Pet". See details in https://json-schema.org/understanding-json-schema/structuring + "required": [ # Optional. If type is `OBJECT`, `required` lists the names of properties that must be present. + "A String", + ], + "title": "A String", # Optional. Title for the schema. + "type": "A String", # Optional. Data type of the schema field. + }, + "responseJsonSchema": "", # Optional. Describes the output from this function in JSON Schema format. The value specified by the schema is the response value of the function. This field is mutually exclusive with `response`. + }, + ], + "googleMaps": { # Tool to retrieve public maps data for grounding, powered by Google. # Optional. GoogleMaps tool type. Tool to support Google Maps in Model. + "enableWidget": True or False, # Optional. Deprecated: The Google Maps contextual widget behavior in Grounding with Google Maps is being deprecated; this field is planned for removal and no longer has any effect once removed. If true, include the widget context token in the response. + "groundingTypes": { # Defines the types of Google Maps grounding that can be enabled and their configurations. # Optional. Specifies the types of Google Maps grounding to enable. Defaults to `places` when unset. + "places": { # Grounding with Google Maps Places data (e.g. QueryPlaces). This is the default Google Maps grounding type when no other type is specified. # Optional. Enables grounding with Google Maps Places. This is the default grounding type when no `GroundingTypes` are specified. + }, + "routing": { # Grounding with Google Maps Routing APIs (ComputeRoutes and SearchAlongRoute). # Optional. Enables grounding with Google Maps Routing APIs (ComputeRoutes and SearchAlongRoute). + }, + }, + }, + "googleSearch": { # GoogleSearch tool type. Tool to support Google Search in Model. Powered by Google. # Optional. GoogleSearch tool type. Tool to support Google Search in Model. Powered by Google. + "blockingConfidence": "A String", # Optional. Sites with confidence level chosen & above this value will be blocked from the search results. + "excludeDomains": [ # Optional. List of domains to be excluded from the search results. The default limit is 2000 domains. Example: ["amazon.com", "facebook.com"]. + "A String", + ], + "searchTypes": { # Different types of search that can be enabled on the GoogleSearch tool. # Optional. The set of search types to enable. If not set, web search is enabled by default. + "imageSearch": { # Image search for grounding and related configurations. # Optional. Setting this field enables image search. Image bytes are returned. + }, + "webSearch": { # Standard web search for grounding and related configurations. Only text results are returned. # Optional. Setting this field enables web search. Only text results are returned. + }, + }, + }, + "googleSearchRetrieval": { # Tool to retrieve public web data for grounding, powered by Google. # Optional. Specialized retrieval tool that is powered by Google Search. + "dynamicRetrievalConfig": { # Describes the options to customize dynamic retrieval. # Specifies the dynamic retrieval configuration for the given source. + "dynamicThreshold": 3.14, # Optional. The threshold to be used in dynamic retrieval. If not set, a system default value is used. + "mode": "A String", # The mode of the predictor to be used in dynamic retrieval. + }, + }, + "parallelAiSearch": { # ParallelAiSearch tool type. A tool that uses the Parallel.ai search engine for grounding. # Optional. If specified, Vertex AI will use Parallel.ai to search for information to answer user queries. The search results will be grounded on Parallel.ai and presented to the model for response generation + "apiKey": "A String", # Optional. The API key for ParallelAiSearch. If an API key is not provided, the system will attempt to verify access by checking for an active Parallel.ai subscription through the Google Cloud Marketplace. See https://docs.parallel.ai/search/search-quickstart for more details. + "customConfigs": { # Optional. Custom configs for ParallelAiSearch. This field can be used to pass any parameter from the Parallel.ai Search API. See the Parallel.ai documentation for the full list of available parameters and their usage: https://docs.parallel.ai/api-reference/search-beta/search Currently only `source_policy`, `excerpts`, `max_results`, `mode`, `fetch_policy` can be set via this field. For example: { "source_policy": { "include_domains": ["google.com", "wikipedia.org"], "exclude_domains": ["example.com"] }, "fetch_policy": { "max_age_seconds": 3600 } } + "a_key": "", # Properties of the object. + }, + "enableDataRetention": True or False, # Optional. Deprecated: Use `enable_zero_data_retention` instead. Instructs Vertex Grounding to use Parallel's Zero Data Retention Marketplace product. If this value is "false" or omitted, the Parallel Web Search for Grounding standard subscription will be used. If this value is "true", the Parallel Web Search for Grounding - ZDR subscription will be used. + "enableZeroDataRetention": True or False, # Optional. Instructs Vertex Grounding to use Parallel's Zero Data Retention Marketplace product. If this value is "false" or omitted, the Parallel Web Search for Grounding standard subscription will be used. If this value is "true", the Parallel Web Search for Grounding - ZDR subscription will be used. + }, + "retrieval": { # Defines a retrieval tool that model can call to access external knowledge. # Optional. Retrieval tool type. System will always execute the provided retrieval tool(s) to get external knowledge to answer the prompt. Retrieval results are presented to the model for generation. + "disableAttribution": True or False, # Optional. Deprecated. This option is no longer supported. + "externalApi": { # Retrieve from data source powered by external API for grounding. The external API is not owned by Google, but need to follow the pre-defined API spec. # Use data source powered by external API for grounding. + "apiAuth": { # The generic reusable api auth config. Deprecated. Please use AuthConfig (google/cloud/aiplatform/master/auth.proto) instead. # The authentication config to access the API. Deprecated. Please use auth_config instead. + "apiKeyConfig": { # The API secret. # The API secret. + "apiKeySecretVersion": "A String", # Required. The SecretManager secret version resource name storing API key. e.g. projects/{project}/secrets/{secret}/versions/{version} + "apiKeyString": "A String", # The API key string. Either this or `api_key_secret_version` must be set. + }, + }, + "apiSpec": "A String", # The API spec that the external API implements. + "authConfig": { # Auth configuration to run the extension. # The authentication config to access the API. + "apiKeyConfig": { # Config for authentication with API key. # Config for API key auth. + "apiKeySecret": "A String", # Optional. The name of the SecretManager secret version resource storing the API key. Format: `projects/{project}/secrets/{secrete}/versions/{version}` - If both `api_key_secret` and `api_key_string` are specified, this field takes precedence over `api_key_string`. - If specified, the `secretmanager.versions.access` permission should be granted to Vertex AI Extension Service Agent (https://cloud.google.com/vertex-ai/docs/general/access-control#service-agents) on the specified resource. + "apiKeyString": "A String", # Optional. The API key to be used in the request directly. + "httpElementLocation": "A String", # Optional. The location of the API key. + "name": "A String", # Optional. The parameter name of the API key. E.g. If the API request is "https://example.com/act?api_key=", "api_key" would be the parameter name. + }, + "authType": "A String", # Type of auth scheme. + "googleServiceAccountConfig": { # Config for Google Service Account Authentication. # Config for Google Service Account auth. + "serviceAccount": "A String", # Optional. The service account that the extension execution service runs as. - If the service account is specified, the `iam.serviceAccounts.getAccessToken` permission should be granted to Vertex AI Extension Service Agent (https://cloud.google.com/vertex-ai/docs/general/access-control#service-agents) on the specified service account. - If not specified, the Vertex AI Extension Service Agent will be used to execute the Extension. + }, + "httpBasicAuthConfig": { # Config for HTTP Basic Authentication. # Config for HTTP Basic auth. + "credentialSecret": "A String", # Required. The name of the SecretManager secret version resource storing the base64 encoded credentials. Format: `projects/{project}/secrets/{secrete}/versions/{version}` - If specified, the `secretmanager.versions.access` permission should be granted to Vertex AI Extension Service Agent (https://cloud.google.com/vertex-ai/docs/general/access-control#service-agents) on the specified resource. + }, + "oauthConfig": { # Config for user oauth. # Config for user oauth. + "accessToken": "A String", # Access token for extension endpoint. Only used to propagate token from [[ExecuteExtensionRequest.runtime_auth_config]] at request time. + "serviceAccount": "A String", # The service account used to generate access tokens for executing the Extension. - If the service account is specified, the `iam.serviceAccounts.getAccessToken` permission should be granted to Vertex AI Extension Service Agent (https://cloud.google.com/vertex-ai/docs/general/access-control#service-agents) on the provided service account. + }, + "oidcConfig": { # Config for user OIDC auth. # Config for user OIDC auth. + "idToken": "A String", # OpenID Connect formatted ID token for extension endpoint. Only used to propagate token from [[ExecuteExtensionRequest.runtime_auth_config]] at request time. + "serviceAccount": "A String", # The service account used to generate an OpenID Connect (OIDC)-compatible JWT token signed by the Google OIDC Provider (accounts.google.com) for extension endpoint (https://cloud.google.com/iam/docs/create-short-lived-credentials-direct#sa-credentials-oidc). - The audience for the token will be set to the URL in the server url defined in the OpenApi spec. - If the service account is provided, the service account should grant `iam.serviceAccounts.getOpenIdToken` permission to Vertex AI Extension Service Agent (https://cloud.google.com/vertex-ai/docs/general/access-control#service-agents). + }, + }, + "elasticSearchParams": { # The search parameters to use for the ELASTIC_SEARCH spec. # Parameters for the elastic search API. + "index": "A String", # The ElasticSearch index to use. + "numHits": 42, # Optional. Number of hits (chunks) to request. When specified, it is passed to Elasticsearch as the `num_hits` param. + "searchTemplate": "A String", # The ElasticSearch search template to use. + }, + "endpoint": "A String", # The endpoint of the external API. The system will call the API at this endpoint to retrieve the data for grounding. Example: https://acme.com:443/search + "simpleSearchParams": { # The search parameters to use for SIMPLE_SEARCH spec. # Parameters for the simple search API. + }, + }, + "vertexAiSearch": { # Retrieve from Vertex AI Search datastore or engine for grounding. datastore and engine are mutually exclusive. See https://cloud.google.com/products/agent-builder # Set to use data source powered by Vertex AI Search. + "dataStoreSpecs": [ # Specifications that define the specific DataStores to be searched, along with configurations for those data stores. This is only considered for Engines with multiple data stores. It should only be set if engine is used. + { # Define data stores within engine to filter on in a search call and configurations for those data stores. For more information, see https://cloud.google.com/generative-ai-app-builder/docs/reference/rpc/google.cloud.discoveryengine.v1#datastorespec + "dataStore": "A String", # Full resource name of DataStore, such as Format: `projects/{project}/locations/{location}/collections/{collection}/dataStores/{dataStore}` + "filter": "A String", # Optional. Filter specification to filter documents in the data store specified by data_store field. For more information on filtering, see [Filtering](https://cloud.google.com/generative-ai-app-builder/docs/filter-search-metadata) + }, + ], + "datastore": "A String", # Optional. Fully-qualified Vertex AI Search data store resource ID. Format: `projects/{project}/locations/{location}/collections/{collection}/dataStores/{dataStore}` + "engine": "A String", # Optional. Fully-qualified Vertex AI Search engine resource ID. Format: `projects/{project}/locations/{location}/collections/{collection}/engines/{engine}` + "filter": "A String", # Optional. Filter strings to be passed to the search API. + "maxResults": 42, # Optional. Number of search results to return per query. The default value is 10. The maximumm allowed value is 10. + }, + "vertexRagStore": { # Retrieve from Vertex RAG Store for grounding. # Set to use data source powered by Vertex RAG store. User data is uploaded via the VertexRagDataService. + "ragResources": [ # Optional. The representation of the rag source. It can be used to specify corpus only or ragfiles. Currently only support one corpus or multiple files from one corpus. In the future we may open up multiple corpora support. + { # The definition of the Rag resource. + "ragCorpus": "A String", # Optional. RagCorpora resource name. Format: `projects/{project}/locations/{location}/ragCorpora/{rag_corpus}` + "ragFileIds": [ # Optional. rag_file_id. The files should be in the same rag_corpus set in rag_corpus field. + "A String", + ], + }, + ], + "ragRetrievalConfig": { # Specifies the context retrieval config. # Optional. The retrieval config for the Rag query. + "filter": { # Config for filters. # Optional. Config for filters. + "metadataFilter": "A String", # Optional. String for metadata filtering. + "vectorDistanceThreshold": 3.14, # Optional. Only returns contexts with vector distance smaller than the threshold. + "vectorSimilarityThreshold": 3.14, # Optional. Only returns contexts with vector similarity larger than the threshold. + }, + "ranking": { # Config for ranking and reranking. # Optional. Config for ranking and reranking. + "llmRanker": { # Config for LlmRanker. # Optional. Config for LlmRanker. + "modelName": "A String", # Optional. The model name used for ranking. See [Supported models](https://cloud.google.com/vertex-ai/generative-ai/docs/model-reference/inference#supported-models). + }, + "rankService": { # Config for Rank Service. # Optional. Config for Rank Service. + "modelName": "A String", # Optional. The model name of the rank service. Format: `semantic-ranker-512@latest` + }, + }, + "topK": 42, # Optional. The number of contexts to retrieve. + }, + "similarityTopK": 42, # Optional. Number of top k results to return from the selected corpora. + "vectorDistanceThreshold": 3.14, # Optional. Only return results with vector distance smaller than the threshold. + }, + }, + "urlContext": { # Tool to support URL context. # Optional. Tool to support URL context retrieval. + }, + }, + ], + "author": "A String", # Required. The ID of the agent or entity that generated this event. Use "user" to denote events generated by the end-user. + "content": { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. # Required. The content of the event (e.g., text response, tool call, tool response). + "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -2486,7 +3077,7 @@

Method Details

"contents": [ # Optional. Repeated contents. { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -2588,7 +3179,7 @@

Method Details

"contents": [ # Optional. Repeated contents. { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -2688,7 +3279,7 @@

Method Details

"contents": [ # Optional. Repeated contents. { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -2788,7 +3379,7 @@

Method Details

"contents": [ # Optional. Repeated contents. { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -3786,7 +4377,7 @@

Method Details

"contents": [ # Optional. Repeated contents. { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -3927,7 +4518,7 @@

Method Details

"contents": [ # Optional. Repeated contents. { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -4583,7 +5174,7 @@

Method Details

"contents": [ # Optional. Repeated contents. { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -4923,7 +5514,7 @@

Method Details

"contents": [ # Required. The prompt to generate rubrics from. For single-turn queries, this is a single instance. For multi-turn queries, this is a repeated field that contains conversation history + latest request. { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. diff --git a/docs/dyn/aiplatform_v1beta1.batchPredictionJobs.html b/docs/dyn/aiplatform_v1beta1.batchPredictionJobs.html index 5b537e8215..4dd041a3a8 100644 --- a/docs/dyn/aiplatform_v1beta1.batchPredictionJobs.html +++ b/docs/dyn/aiplatform_v1beta1.batchPredictionJobs.html @@ -474,7 +474,7 @@

Method Details

"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). + "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). At most 200 environment variables can be specified. Each variable (`NAME=value`) must be smaller than 128 KiB, and the total size of all variables must not exceed 512 KiB. { # 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. @@ -981,7 +981,7 @@

Method Details

"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). + "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). At most 200 environment variables can be specified. Each variable (`NAME=value`) must be smaller than 128 KiB, and the total size of all variables must not exceed 512 KiB. { # 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. @@ -1494,7 +1494,7 @@

Method Details

"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). + "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). At most 200 environment variables can be specified. Each variable (`NAME=value`) must be smaller than 128 KiB, and the total size of all variables must not exceed 512 KiB. { # 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. @@ -2013,7 +2013,7 @@

Method Details

"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). + "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). At most 200 environment variables can be specified. Each variable (`NAME=value`) must be smaller than 128 KiB, and the total size of all variables must not exceed 512 KiB. { # 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. diff --git a/docs/dyn/aiplatform_v1beta1.endpoints.html b/docs/dyn/aiplatform_v1beta1.endpoints.html index 2c2a6c69ab..7eb2480da8 100644 --- a/docs/dyn/aiplatform_v1beta1.endpoints.html +++ b/docs/dyn/aiplatform_v1beta1.endpoints.html @@ -127,7 +127,7 @@

Method Details

"contents": [ # Optional. Input content. { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -262,7 +262,7 @@

Method Details

"contents": [ # Optional. Input content. { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -531,7 +531,7 @@

Method Details

"model": "A String", # Optional. The name of the publisher model requested to serve the prediction. Format: `projects/{project}/locations/{location}/publishers/*/models/*` "systemInstruction": { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. # Optional. The user provided system instructions for the model. Note: only text should be used in parts and content in each part will be in a separate paragraph. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -943,7 +943,7 @@

Method Details

"contents": [ # Required. The content of the current conversation with the model. For single-turn queries, this is a single instance. For multi-turn queries, this is a repeated field that contains conversation history + latest request. { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -1036,6 +1036,7 @@

Method Details

"role": "A String", # Optional. The producer of the content. Must be either 'user' or 'model'. If not set, the service will default to 'user'. }, ], + "continuationToken": "A String", # Optional. An opaque continuation token used to resume generation from a previous `GenerateContent` or `StreamGenerateContent` response that stopped with `finish_reason` set to `CONTINUATION`. "generationConfig": { # Configuration for content generation. This message contains all the parameters that control how the model generates content. It allows you to influence the randomness, length, and structure of the output. # Optional. Generation config. "audioTimestamp": True or False, # Optional. If enabled, audio timestamps will be included in the request to the model. This can be useful for synchronizing audio with other modalities in the response. "audioTranscriptionConfig": { # Configuration for speech recognition (transcription). # Optional. Configuration for audio transcription (speech recognition). @@ -1222,7 +1223,7 @@

Method Details

], "systemInstruction": { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. # Optional. The user provided system instructions for the model. Note: only text should be used in parts and content in each part will be in a separate paragraph. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -1604,7 +1605,7 @@

Method Details

}, "content": { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. # Output only. The content of the candidate. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -1696,6 +1697,7 @@

Method Details

], "role": "A String", # Optional. The producer of the content. Must be either 'user' or 'model'. If not set, the service will default to 'user'. }, + "continuationToken": "A String", # Output only. An optional opaque continuation token returned when `finish_reason` is `CONTINUATION`. Clients can pass this token in a subsequent `GenerateContentRequest` to continue generation. "finishMessage": "A String", # Output only. Describes the reason the model stopped generating tokens in more detail. This field is returned only when `finish_reason` is set. "finishReason": "A String", # Output only. The reason why the model stopped generating tokens. If empty, the model has not stopped generating. "groundingMetadata": { # Information about the sources that support the content of a response. When grounding is enabled, the model returns citations for claims in the response. This object contains the retrieved sources. # Output only. Metadata returned when grounding is enabled. It contains the sources used to ground the generated content. @@ -1989,7 +1991,7 @@

Method Details

"contents": [ # Required. The content of the current conversation with the model. For single-turn queries, this is a single instance. For multi-turn queries, this is a repeated field that contains conversation history + latest request. { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -2082,6 +2084,7 @@

Method Details

"role": "A String", # Optional. The producer of the content. Must be either 'user' or 'model'. If not set, the service will default to 'user'. }, ], + "continuationToken": "A String", # Optional. An opaque continuation token used to resume generation from a previous `GenerateContent` or `StreamGenerateContent` response that stopped with `finish_reason` set to `CONTINUATION`. "generationConfig": { # Configuration for content generation. This message contains all the parameters that control how the model generates content. It allows you to influence the randomness, length, and structure of the output. # Optional. Generation config. "audioTimestamp": True or False, # Optional. If enabled, audio timestamps will be included in the request to the model. This can be useful for synchronizing audio with other modalities in the response. "audioTranscriptionConfig": { # Configuration for speech recognition (transcription). # Optional. Configuration for audio transcription (speech recognition). @@ -2268,7 +2271,7 @@

Method Details

], "systemInstruction": { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. # Optional. The user provided system instructions for the model. Note: only text should be used in parts and content in each part will be in a separate paragraph. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -2650,7 +2653,7 @@

Method Details

}, "content": { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. # Output only. The content of the candidate. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -2742,6 +2745,7 @@

Method Details

], "role": "A String", # Optional. The producer of the content. Must be either 'user' or 'model'. If not set, the service will default to 'user'. }, + "continuationToken": "A String", # Output only. An optional opaque continuation token returned when `finish_reason` is `CONTINUATION`. Clients can pass this token in a subsequent `GenerateContentRequest` to continue generation. "finishMessage": "A String", # Output only. Describes the reason the model stopped generating tokens in more detail. This field is returned only when `finish_reason` is set. "finishReason": "A String", # Output only. The reason why the model stopped generating tokens. If empty, the model has not stopped generating. "groundingMetadata": { # Information about the sources that support the content of a response. When grounding is enabled, the model returns citations for claims in the response. This object contains the retrieved sources. # Output only. Metadata returned when grounding is enabled. It contains the sources used to ground the generated content. diff --git a/docs/dyn/aiplatform_v1beta1.interactions.html b/docs/dyn/aiplatform_v1beta1.interactions.html index e6e839f9c7..7bac20a2ec 100644 --- a/docs/dyn/aiplatform_v1beta1.interactions.html +++ b/docs/dyn/aiplatform_v1beta1.interactions.html @@ -173,7 +173,9 @@

Method Details

{ # Citation information for model-generated content. "endIndex": 42, # End of the attributed segment, exclusive. "fileCitation": { # A file citation annotation. # A file citation annotation. - "customMetadata": # Object with schema name: GenaiVertexV1beta1Struct # User provided metadata about the retrieved context. + "customMetadata": { # User provided metadata about the retrieved context. + "a_key": "", # Properties of the object. + }, "documentUri": "A String", # The URI of the file. "fileName": "A String", # The name of the file. "mediaId": "A String", # Media ID in-case of image citations, if applicable. @@ -266,7 +268,9 @@

Method Details

{ # Citation information for model-generated content. "endIndex": 42, # End of the attributed segment, exclusive. "fileCitation": { # A file citation annotation. # A file citation annotation. - "customMetadata": # Object with schema name: GenaiVertexV1beta1Struct # User provided metadata about the retrieved context. + "customMetadata": { # User provided metadata about the retrieved context. + "a_key": "", # Properties of the object. + }, "documentUri": "A String", # The URI of the file. "fileName": "A String", # The name of the file. "mediaId": "A String", # Media ID in-case of image citations, if applicable. @@ -320,6 +324,7 @@

Method Details

"uri": "A String", # The URI of the video. }, }, + "continuationToken": "A String", # Opaque token to resume a long decode. Output: set when status is INCOMPLETE and decoding can be resumed. Input: pass the latest token back unchanged in CreateInteraction to continue decoding. "created": "A String", # Required. Output only. The time at which the response was created in ISO 8601 format (YYYY-MM-DDThh:mm:ssZ). "envId": "A String", # The environment ID for the interaction. Can be 'remote' for default environment. "environmentId": "A String", # Output only. The environment ID for the interaction. Only populated if environment config is set in the request. @@ -393,9 +398,10 @@

Method Details

"remoteEnvironment": { # Configuration for a custom environment. "environmentId": "A String", # Optional. The environment ID for the interaction. If specified, the request will update the existing environment instead of creating a new one. "networkAllowlist": { # Network egress configuration for the environment. # Allow only specific domains. - "allowlist": [ # List of allowed domains and their configurations. + "allowlist": [ # List of allowed domains and their configurations. Set to `"disabled"` to block all network egress. { # A single domain allowlist rule with optional header injection. "domain": "A String", # Domain to allow outbound requests to. Supports wildcards (e.g. '*.googleapis.com'). Use '*' to allow all domains. + "mode": "A String", # Network egress mode. Set via the `"allowlist": "disabled"` short form; must be the only rule in the allowlist and cannot be combined with `domain`, `transform` or `credential`. "transform": { # Headers to inject into requests matching this rule. Key: header name (e.g., "Authorization"). Value: header value (e.g., "Bearer your-token"). "a_key": "A String", }, @@ -458,7 +464,9 @@

Method Details

{ # Citation information for model-generated content. "endIndex": 42, # End of the attributed segment, exclusive. "fileCitation": { # A file citation annotation. # A file citation annotation. - "customMetadata": # Object with schema name: GenaiVertexV1beta1Struct # User provided metadata about the retrieved context. + "customMetadata": { # User provided metadata about the retrieved context. + "a_key": "", # Properties of the object. + }, "documentUri": "A String", # The URI of the file. "fileName": "A String", # The name of the file. "mediaId": "A String", # Media ID in-case of image citations, if applicable. @@ -557,7 +565,9 @@

Method Details

{ # Citation information for model-generated content. "endIndex": 42, # End of the attributed segment, exclusive. "fileCitation": { # A file citation annotation. # A file citation annotation. - "customMetadata": # Object with schema name: GenaiVertexV1beta1Struct # User provided metadata about the retrieved context. + "customMetadata": { # User provided metadata about the retrieved context. + "a_key": "", # Properties of the object. + }, "documentUri": "A String", # The URI of the file. "fileName": "A String", # The name of the file. "mediaId": "A String", # Media ID in-case of image citations, if applicable. @@ -678,7 +688,9 @@

Method Details

{ # Citation information for model-generated content. "endIndex": 42, # End of the attributed segment, exclusive. "fileCitation": { # A file citation annotation. # A file citation annotation. - "customMetadata": # Object with schema name: GenaiVertexV1beta1Struct # User provided metadata about the retrieved context. + "customMetadata": { # User provided metadata about the retrieved context. + "a_key": "", # Properties of the object. + }, "documentUri": "A String", # The URI of the file. "fileName": "A String", # The name of the file. "mediaId": "A String", # Media ID in-case of image citations, if applicable. @@ -777,7 +789,9 @@

Method Details

{ # Citation information for model-generated content. "endIndex": 42, # End of the attributed segment, exclusive. "fileCitation": { # A file citation annotation. # A file citation annotation. - "customMetadata": # Object with schema name: GenaiVertexV1beta1Struct # User provided metadata about the retrieved context. + "customMetadata": { # User provided metadata about the retrieved context. + "a_key": "", # Properties of the object. + }, "documentUri": "A String", # The URI of the file. "fileName": "A String", # The name of the file. "mediaId": "A String", # Media ID in-case of image citations, if applicable. @@ -895,7 +909,9 @@

Method Details

{ # Citation information for model-generated content. "endIndex": 42, # End of the attributed segment, exclusive. "fileCitation": { # A file citation annotation. # A file citation annotation. - "customMetadata": # Object with schema name: GenaiVertexV1beta1Struct # User provided metadata about the retrieved context. + "customMetadata": { # User provided metadata about the retrieved context. + "a_key": "", # Properties of the object. + }, "documentUri": "A String", # The URI of the file. "fileName": "A String", # The name of the file. "mediaId": "A String", # Media ID in-case of image citations, if applicable. @@ -987,7 +1003,9 @@

Method Details

{ # Citation information for model-generated content. "endIndex": 42, # End of the attributed segment, exclusive. "fileCitation": { # A file citation annotation. # A file citation annotation. - "customMetadata": # Object with schema name: GenaiVertexV1beta1Struct # User provided metadata about the retrieved context. + "customMetadata": { # User provided metadata about the retrieved context. + "a_key": "", # Properties of the object. + }, "documentUri": "A String", # The URI of the file. "fileName": "A String", # The name of the file. "mediaId": "A String", # Media ID in-case of image citations, if applicable. @@ -1083,7 +1101,9 @@

Method Details

{ # Citation information for model-generated content. "endIndex": 42, # End of the attributed segment, exclusive. "fileCitation": { # A file citation annotation. # A file citation annotation. - "customMetadata": # Object with schema name: GenaiVertexV1beta1Struct # User provided metadata about the retrieved context. + "customMetadata": { # User provided metadata about the retrieved context. + "a_key": "", # Properties of the object. + }, "documentUri": "A String", # The URI of the file. "fileName": "A String", # The name of the file. "mediaId": "A String", # Media ID in-case of image citations, if applicable. @@ -1199,7 +1219,9 @@

Method Details

{ # Citation information for model-generated content. "endIndex": 42, # End of the attributed segment, exclusive. "fileCitation": { # A file citation annotation. # A file citation annotation. - "customMetadata": # Object with schema name: GenaiVertexV1beta1Struct # User provided metadata about the retrieved context. + "customMetadata": { # User provided metadata about the retrieved context. + "a_key": "", # Properties of the object. + }, "documentUri": "A String", # The URI of the file. "fileName": "A String", # The name of the file. "mediaId": "A String", # Media ID in-case of image citations, if applicable. @@ -1325,7 +1347,9 @@

Method Details

{ # Citation information for model-generated content. "endIndex": 42, # End of the attributed segment, exclusive. "fileCitation": { # A file citation annotation. # A file citation annotation. - "customMetadata": # Object with schema name: GenaiVertexV1beta1Struct # User provided metadata about the retrieved context. + "customMetadata": { # User provided metadata about the retrieved context. + "a_key": "", # Properties of the object. + }, "documentUri": "A String", # The URI of the file. "fileName": "A String", # The name of the file. "mediaId": "A String", # Media ID in-case of image citations, if applicable. @@ -1447,7 +1471,9 @@

Method Details

{ # Citation information for model-generated content. "endIndex": 42, # End of the attributed segment, exclusive. "fileCitation": { # A file citation annotation. # A file citation annotation. - "customMetadata": # Object with schema name: GenaiVertexV1beta1Struct # User provided metadata about the retrieved context. + "customMetadata": { # User provided metadata about the retrieved context. + "a_key": "", # Properties of the object. + }, "documentUri": "A String", # The URI of the file. "fileName": "A String", # The name of the file. "mediaId": "A String", # Media ID in-case of image citations, if applicable. @@ -1556,7 +1582,9 @@

Method Details

{ # Citation information for model-generated content. "endIndex": 42, # End of the attributed segment, exclusive. "fileCitation": { # A file citation annotation. # A file citation annotation. - "customMetadata": # Object with schema name: GenaiVertexV1beta1Struct # User provided metadata about the retrieved context. + "customMetadata": { # User provided metadata about the retrieved context. + "a_key": "", # Properties of the object. + }, "documentUri": "A String", # The URI of the file. "fileName": "A String", # The name of the file. "mediaId": "A String", # Media ID in-case of image citations, if applicable. @@ -1645,7 +1673,9 @@

Method Details

{ # Citation information for model-generated content. "endIndex": 42, # End of the attributed segment, exclusive. "fileCitation": { # A file citation annotation. # A file citation annotation. - "customMetadata": # Object with schema name: GenaiVertexV1beta1Struct # User provided metadata about the retrieved context. + "customMetadata": { # User provided metadata about the retrieved context. + "a_key": "", # Properties of the object. + }, "documentUri": "A String", # The URI of the file. "fileName": "A String", # The name of the file. "mediaId": "A String", # Media ID in-case of image citations, if applicable. @@ -1737,7 +1767,9 @@

Method Details

{ # Citation information for model-generated content. "endIndex": 42, # End of the attributed segment, exclusive. "fileCitation": { # A file citation annotation. # A file citation annotation. - "customMetadata": # Object with schema name: GenaiVertexV1beta1Struct # User provided metadata about the retrieved context. + "customMetadata": { # User provided metadata about the retrieved context. + "a_key": "", # Properties of the object. + }, "documentUri": "A String", # The URI of the file. "fileName": "A String", # The name of the file. "mediaId": "A String", # Media ID in-case of image citations, if applicable. @@ -1833,7 +1865,9 @@

Method Details

{ # Citation information for model-generated content. "endIndex": 42, # End of the attributed segment, exclusive. "fileCitation": { # A file citation annotation. # A file citation annotation. - "customMetadata": # Object with schema name: GenaiVertexV1beta1Struct # User provided metadata about the retrieved context. + "customMetadata": { # User provided metadata about the retrieved context. + "a_key": "", # Properties of the object. + }, "documentUri": "A String", # The URI of the file. "fileName": "A String", # The name of the file. "mediaId": "A String", # Media ID in-case of image citations, if applicable. @@ -1949,7 +1983,9 @@

Method Details

{ # Citation information for model-generated content. "endIndex": 42, # End of the attributed segment, exclusive. "fileCitation": { # A file citation annotation. # A file citation annotation. - "customMetadata": # Object with schema name: GenaiVertexV1beta1Struct # User provided metadata about the retrieved context. + "customMetadata": { # User provided metadata about the retrieved context. + "a_key": "", # Properties of the object. + }, "documentUri": "A String", # The URI of the file. "fileName": "A String", # The name of the file. "mediaId": "A String", # Media ID in-case of image citations, if applicable. @@ -2075,7 +2111,9 @@

Method Details

{ # Citation information for model-generated content. "endIndex": 42, # End of the attributed segment, exclusive. "fileCitation": { # A file citation annotation. # A file citation annotation. - "customMetadata": # Object with schema name: GenaiVertexV1beta1Struct # User provided metadata about the retrieved context. + "customMetadata": { # User provided metadata about the retrieved context. + "a_key": "", # Properties of the object. + }, "documentUri": "A String", # The URI of the file. "fileName": "A String", # The name of the file. "mediaId": "A String", # Media ID in-case of image citations, if applicable. @@ -2197,7 +2235,9 @@

Method Details

{ # Citation information for model-generated content. "endIndex": 42, # End of the attributed segment, exclusive. "fileCitation": { # A file citation annotation. # A file citation annotation. - "customMetadata": # Object with schema name: GenaiVertexV1beta1Struct # User provided metadata about the retrieved context. + "customMetadata": { # User provided metadata about the retrieved context. + "a_key": "", # Properties of the object. + }, "documentUri": "A String", # The URI of the file. "fileName": "A String", # The name of the file. "mediaId": "A String", # Media ID in-case of image citations, if applicable. @@ -2306,7 +2346,9 @@

Method Details

{ # Citation information for model-generated content. "endIndex": 42, # End of the attributed segment, exclusive. "fileCitation": { # A file citation annotation. # A file citation annotation. - "customMetadata": # Object with schema name: GenaiVertexV1beta1Struct # User provided metadata about the retrieved context. + "customMetadata": { # User provided metadata about the retrieved context. + "a_key": "", # Properties of the object. + }, "documentUri": "A String", # The URI of the file. "fileName": "A String", # The name of the file. "mediaId": "A String", # Media ID in-case of image citations, if applicable. @@ -2418,7 +2460,9 @@

Method Details

{ # Citation information for model-generated content. "endIndex": 42, # End of the attributed segment, exclusive. "fileCitation": { # A file citation annotation. # A file citation annotation. - "customMetadata": # Object with schema name: GenaiVertexV1beta1Struct # User provided metadata about the retrieved context. + "customMetadata": { # User provided metadata about the retrieved context. + "a_key": "", # Properties of the object. + }, "documentUri": "A String", # The URI of the file. "fileName": "A String", # The name of the file. "mediaId": "A String", # Media ID in-case of image citations, if applicable. @@ -2699,7 +2743,9 @@

Method Details

{ # Citation information for model-generated content. "endIndex": 42, # End of the attributed segment, exclusive. "fileCitation": { # A file citation annotation. # A file citation annotation. - "customMetadata": # Object with schema name: GenaiVertexV1beta1Struct # User provided metadata about the retrieved context. + "customMetadata": { # User provided metadata about the retrieved context. + "a_key": "", # Properties of the object. + }, "documentUri": "A String", # The URI of the file. "fileName": "A String", # The name of the file. "mediaId": "A String", # Media ID in-case of image citations, if applicable. @@ -2792,7 +2838,9 @@

Method Details

{ # Citation information for model-generated content. "endIndex": 42, # End of the attributed segment, exclusive. "fileCitation": { # A file citation annotation. # A file citation annotation. - "customMetadata": # Object with schema name: GenaiVertexV1beta1Struct # User provided metadata about the retrieved context. + "customMetadata": { # User provided metadata about the retrieved context. + "a_key": "", # Properties of the object. + }, "documentUri": "A String", # The URI of the file. "fileName": "A String", # The name of the file. "mediaId": "A String", # Media ID in-case of image citations, if applicable. @@ -2846,6 +2894,7 @@

Method Details

"uri": "A String", # The URI of the video. }, }, + "continuationToken": "A String", # Opaque token to resume a long decode. Output: set when status is INCOMPLETE and decoding can be resumed. Input: pass the latest token back unchanged in CreateInteraction to continue decoding. "created": "A String", # Required. Output only. The time at which the response was created in ISO 8601 format (YYYY-MM-DDThh:mm:ssZ). "envId": "A String", # The environment ID for the interaction. Can be 'remote' for default environment. "environmentId": "A String", # Output only. The environment ID for the interaction. Only populated if environment config is set in the request. @@ -2919,9 +2968,10 @@

Method Details

"remoteEnvironment": { # Configuration for a custom environment. "environmentId": "A String", # Optional. The environment ID for the interaction. If specified, the request will update the existing environment instead of creating a new one. "networkAllowlist": { # Network egress configuration for the environment. # Allow only specific domains. - "allowlist": [ # List of allowed domains and their configurations. + "allowlist": [ # List of allowed domains and their configurations. Set to `"disabled"` to block all network egress. { # A single domain allowlist rule with optional header injection. "domain": "A String", # Domain to allow outbound requests to. Supports wildcards (e.g. '*.googleapis.com'). Use '*' to allow all domains. + "mode": "A String", # Network egress mode. Set via the `"allowlist": "disabled"` short form; must be the only rule in the allowlist and cannot be combined with `domain`, `transform` or `credential`. "transform": { # Headers to inject into requests matching this rule. Key: header name (e.g., "Authorization"). Value: header value (e.g., "Bearer your-token"). "a_key": "A String", }, @@ -2984,7 +3034,9 @@

Method Details

{ # Citation information for model-generated content. "endIndex": 42, # End of the attributed segment, exclusive. "fileCitation": { # A file citation annotation. # A file citation annotation. - "customMetadata": # Object with schema name: GenaiVertexV1beta1Struct # User provided metadata about the retrieved context. + "customMetadata": { # User provided metadata about the retrieved context. + "a_key": "", # Properties of the object. + }, "documentUri": "A String", # The URI of the file. "fileName": "A String", # The name of the file. "mediaId": "A String", # Media ID in-case of image citations, if applicable. @@ -3083,7 +3135,9 @@

Method Details

{ # Citation information for model-generated content. "endIndex": 42, # End of the attributed segment, exclusive. "fileCitation": { # A file citation annotation. # A file citation annotation. - "customMetadata": # Object with schema name: GenaiVertexV1beta1Struct # User provided metadata about the retrieved context. + "customMetadata": { # User provided metadata about the retrieved context. + "a_key": "", # Properties of the object. + }, "documentUri": "A String", # The URI of the file. "fileName": "A String", # The name of the file. "mediaId": "A String", # Media ID in-case of image citations, if applicable. @@ -3204,7 +3258,9 @@

Method Details

{ # Citation information for model-generated content. "endIndex": 42, # End of the attributed segment, exclusive. "fileCitation": { # A file citation annotation. # A file citation annotation. - "customMetadata": # Object with schema name: GenaiVertexV1beta1Struct # User provided metadata about the retrieved context. + "customMetadata": { # User provided metadata about the retrieved context. + "a_key": "", # Properties of the object. + }, "documentUri": "A String", # The URI of the file. "fileName": "A String", # The name of the file. "mediaId": "A String", # Media ID in-case of image citations, if applicable. @@ -3303,7 +3359,9 @@

Method Details

{ # Citation information for model-generated content. "endIndex": 42, # End of the attributed segment, exclusive. "fileCitation": { # A file citation annotation. # A file citation annotation. - "customMetadata": # Object with schema name: GenaiVertexV1beta1Struct # User provided metadata about the retrieved context. + "customMetadata": { # User provided metadata about the retrieved context. + "a_key": "", # Properties of the object. + }, "documentUri": "A String", # The URI of the file. "fileName": "A String", # The name of the file. "mediaId": "A String", # Media ID in-case of image citations, if applicable. @@ -3421,7 +3479,9 @@

Method Details

{ # Citation information for model-generated content. "endIndex": 42, # End of the attributed segment, exclusive. "fileCitation": { # A file citation annotation. # A file citation annotation. - "customMetadata": # Object with schema name: GenaiVertexV1beta1Struct # User provided metadata about the retrieved context. + "customMetadata": { # User provided metadata about the retrieved context. + "a_key": "", # Properties of the object. + }, "documentUri": "A String", # The URI of the file. "fileName": "A String", # The name of the file. "mediaId": "A String", # Media ID in-case of image citations, if applicable. @@ -3513,7 +3573,9 @@

Method Details

{ # Citation information for model-generated content. "endIndex": 42, # End of the attributed segment, exclusive. "fileCitation": { # A file citation annotation. # A file citation annotation. - "customMetadata": # Object with schema name: GenaiVertexV1beta1Struct # User provided metadata about the retrieved context. + "customMetadata": { # User provided metadata about the retrieved context. + "a_key": "", # Properties of the object. + }, "documentUri": "A String", # The URI of the file. "fileName": "A String", # The name of the file. "mediaId": "A String", # Media ID in-case of image citations, if applicable. @@ -3609,7 +3671,9 @@

Method Details

{ # Citation information for model-generated content. "endIndex": 42, # End of the attributed segment, exclusive. "fileCitation": { # A file citation annotation. # A file citation annotation. - "customMetadata": # Object with schema name: GenaiVertexV1beta1Struct # User provided metadata about the retrieved context. + "customMetadata": { # User provided metadata about the retrieved context. + "a_key": "", # Properties of the object. + }, "documentUri": "A String", # The URI of the file. "fileName": "A String", # The name of the file. "mediaId": "A String", # Media ID in-case of image citations, if applicable. @@ -3725,7 +3789,9 @@

Method Details

{ # Citation information for model-generated content. "endIndex": 42, # End of the attributed segment, exclusive. "fileCitation": { # A file citation annotation. # A file citation annotation. - "customMetadata": # Object with schema name: GenaiVertexV1beta1Struct # User provided metadata about the retrieved context. + "customMetadata": { # User provided metadata about the retrieved context. + "a_key": "", # Properties of the object. + }, "documentUri": "A String", # The URI of the file. "fileName": "A String", # The name of the file. "mediaId": "A String", # Media ID in-case of image citations, if applicable. @@ -3851,7 +3917,9 @@

Method Details

{ # Citation information for model-generated content. "endIndex": 42, # End of the attributed segment, exclusive. "fileCitation": { # A file citation annotation. # A file citation annotation. - "customMetadata": # Object with schema name: GenaiVertexV1beta1Struct # User provided metadata about the retrieved context. + "customMetadata": { # User provided metadata about the retrieved context. + "a_key": "", # Properties of the object. + }, "documentUri": "A String", # The URI of the file. "fileName": "A String", # The name of the file. "mediaId": "A String", # Media ID in-case of image citations, if applicable. @@ -3973,7 +4041,9 @@

Method Details

{ # Citation information for model-generated content. "endIndex": 42, # End of the attributed segment, exclusive. "fileCitation": { # A file citation annotation. # A file citation annotation. - "customMetadata": # Object with schema name: GenaiVertexV1beta1Struct # User provided metadata about the retrieved context. + "customMetadata": { # User provided metadata about the retrieved context. + "a_key": "", # Properties of the object. + }, "documentUri": "A String", # The URI of the file. "fileName": "A String", # The name of the file. "mediaId": "A String", # Media ID in-case of image citations, if applicable. @@ -4082,7 +4152,9 @@

Method Details

{ # Citation information for model-generated content. "endIndex": 42, # End of the attributed segment, exclusive. "fileCitation": { # A file citation annotation. # A file citation annotation. - "customMetadata": # Object with schema name: GenaiVertexV1beta1Struct # User provided metadata about the retrieved context. + "customMetadata": { # User provided metadata about the retrieved context. + "a_key": "", # Properties of the object. + }, "documentUri": "A String", # The URI of the file. "fileName": "A String", # The name of the file. "mediaId": "A String", # Media ID in-case of image citations, if applicable. @@ -4171,7 +4243,9 @@

Method Details

{ # Citation information for model-generated content. "endIndex": 42, # End of the attributed segment, exclusive. "fileCitation": { # A file citation annotation. # A file citation annotation. - "customMetadata": # Object with schema name: GenaiVertexV1beta1Struct # User provided metadata about the retrieved context. + "customMetadata": { # User provided metadata about the retrieved context. + "a_key": "", # Properties of the object. + }, "documentUri": "A String", # The URI of the file. "fileName": "A String", # The name of the file. "mediaId": "A String", # Media ID in-case of image citations, if applicable. @@ -4263,7 +4337,9 @@

Method Details

{ # Citation information for model-generated content. "endIndex": 42, # End of the attributed segment, exclusive. "fileCitation": { # A file citation annotation. # A file citation annotation. - "customMetadata": # Object with schema name: GenaiVertexV1beta1Struct # User provided metadata about the retrieved context. + "customMetadata": { # User provided metadata about the retrieved context. + "a_key": "", # Properties of the object. + }, "documentUri": "A String", # The URI of the file. "fileName": "A String", # The name of the file. "mediaId": "A String", # Media ID in-case of image citations, if applicable. @@ -4359,7 +4435,9 @@

Method Details

{ # Citation information for model-generated content. "endIndex": 42, # End of the attributed segment, exclusive. "fileCitation": { # A file citation annotation. # A file citation annotation. - "customMetadata": # Object with schema name: GenaiVertexV1beta1Struct # User provided metadata about the retrieved context. + "customMetadata": { # User provided metadata about the retrieved context. + "a_key": "", # Properties of the object. + }, "documentUri": "A String", # The URI of the file. "fileName": "A String", # The name of the file. "mediaId": "A String", # Media ID in-case of image citations, if applicable. @@ -4475,7 +4553,9 @@

Method Details

{ # Citation information for model-generated content. "endIndex": 42, # End of the attributed segment, exclusive. "fileCitation": { # A file citation annotation. # A file citation annotation. - "customMetadata": # Object with schema name: GenaiVertexV1beta1Struct # User provided metadata about the retrieved context. + "customMetadata": { # User provided metadata about the retrieved context. + "a_key": "", # Properties of the object. + }, "documentUri": "A String", # The URI of the file. "fileName": "A String", # The name of the file. "mediaId": "A String", # Media ID in-case of image citations, if applicable. @@ -4601,7 +4681,9 @@

Method Details

{ # Citation information for model-generated content. "endIndex": 42, # End of the attributed segment, exclusive. "fileCitation": { # A file citation annotation. # A file citation annotation. - "customMetadata": # Object with schema name: GenaiVertexV1beta1Struct # User provided metadata about the retrieved context. + "customMetadata": { # User provided metadata about the retrieved context. + "a_key": "", # Properties of the object. + }, "documentUri": "A String", # The URI of the file. "fileName": "A String", # The name of the file. "mediaId": "A String", # Media ID in-case of image citations, if applicable. @@ -4723,7 +4805,9 @@

Method Details

{ # Citation information for model-generated content. "endIndex": 42, # End of the attributed segment, exclusive. "fileCitation": { # A file citation annotation. # A file citation annotation. - "customMetadata": # Object with schema name: GenaiVertexV1beta1Struct # User provided metadata about the retrieved context. + "customMetadata": { # User provided metadata about the retrieved context. + "a_key": "", # Properties of the object. + }, "documentUri": "A String", # The URI of the file. "fileName": "A String", # The name of the file. "mediaId": "A String", # Media ID in-case of image citations, if applicable. @@ -4832,7 +4916,9 @@

Method Details

{ # Citation information for model-generated content. "endIndex": 42, # End of the attributed segment, exclusive. "fileCitation": { # A file citation annotation. # A file citation annotation. - "customMetadata": # Object with schema name: GenaiVertexV1beta1Struct # User provided metadata about the retrieved context. + "customMetadata": { # User provided metadata about the retrieved context. + "a_key": "", # Properties of the object. + }, "documentUri": "A String", # The URI of the file. "fileName": "A String", # The name of the file. "mediaId": "A String", # Media ID in-case of image citations, if applicable. @@ -4944,7 +5030,9 @@

Method Details

{ # Citation information for model-generated content. "endIndex": 42, # End of the attributed segment, exclusive. "fileCitation": { # A file citation annotation. # A file citation annotation. - "customMetadata": # Object with schema name: GenaiVertexV1beta1Struct # User provided metadata about the retrieved context. + "customMetadata": { # User provided metadata about the retrieved context. + "a_key": "", # Properties of the object. + }, "documentUri": "A String", # The URI of the file. "fileName": "A String", # The name of the file. "mediaId": "A String", # Media ID in-case of image citations, if applicable. @@ -5229,7 +5317,9 @@

Method Details

{ # Citation information for model-generated content. "endIndex": 42, # End of the attributed segment, exclusive. "fileCitation": { # A file citation annotation. # A file citation annotation. - "customMetadata": # Object with schema name: GenaiVertexV1beta1Struct # User provided metadata about the retrieved context. + "customMetadata": { # User provided metadata about the retrieved context. + "a_key": "", # Properties of the object. + }, "documentUri": "A String", # The URI of the file. "fileName": "A String", # The name of the file. "mediaId": "A String", # Media ID in-case of image citations, if applicable. @@ -5322,7 +5412,9 @@

Method Details

{ # Citation information for model-generated content. "endIndex": 42, # End of the attributed segment, exclusive. "fileCitation": { # A file citation annotation. # A file citation annotation. - "customMetadata": # Object with schema name: GenaiVertexV1beta1Struct # User provided metadata about the retrieved context. + "customMetadata": { # User provided metadata about the retrieved context. + "a_key": "", # Properties of the object. + }, "documentUri": "A String", # The URI of the file. "fileName": "A String", # The name of the file. "mediaId": "A String", # Media ID in-case of image citations, if applicable. @@ -5376,6 +5468,7 @@

Method Details

"uri": "A String", # The URI of the video. }, }, + "continuationToken": "A String", # Opaque token to resume a long decode. Output: set when status is INCOMPLETE and decoding can be resumed. Input: pass the latest token back unchanged in CreateInteraction to continue decoding. "created": "A String", # Required. Output only. The time at which the response was created in ISO 8601 format (YYYY-MM-DDThh:mm:ssZ). "envId": "A String", # The environment ID for the interaction. Can be 'remote' for default environment. "environmentId": "A String", # Output only. The environment ID for the interaction. Only populated if environment config is set in the request. @@ -5449,9 +5542,10 @@

Method Details

"remoteEnvironment": { # Configuration for a custom environment. "environmentId": "A String", # Optional. The environment ID for the interaction. If specified, the request will update the existing environment instead of creating a new one. "networkAllowlist": { # Network egress configuration for the environment. # Allow only specific domains. - "allowlist": [ # List of allowed domains and their configurations. + "allowlist": [ # List of allowed domains and their configurations. Set to `"disabled"` to block all network egress. { # A single domain allowlist rule with optional header injection. "domain": "A String", # Domain to allow outbound requests to. Supports wildcards (e.g. '*.googleapis.com'). Use '*' to allow all domains. + "mode": "A String", # Network egress mode. Set via the `"allowlist": "disabled"` short form; must be the only rule in the allowlist and cannot be combined with `domain`, `transform` or `credential`. "transform": { # Headers to inject into requests matching this rule. Key: header name (e.g., "Authorization"). Value: header value (e.g., "Bearer your-token"). "a_key": "A String", }, @@ -5514,7 +5608,9 @@

Method Details

{ # Citation information for model-generated content. "endIndex": 42, # End of the attributed segment, exclusive. "fileCitation": { # A file citation annotation. # A file citation annotation. - "customMetadata": # Object with schema name: GenaiVertexV1beta1Struct # User provided metadata about the retrieved context. + "customMetadata": { # User provided metadata about the retrieved context. + "a_key": "", # Properties of the object. + }, "documentUri": "A String", # The URI of the file. "fileName": "A String", # The name of the file. "mediaId": "A String", # Media ID in-case of image citations, if applicable. @@ -5613,7 +5709,9 @@

Method Details

{ # Citation information for model-generated content. "endIndex": 42, # End of the attributed segment, exclusive. "fileCitation": { # A file citation annotation. # A file citation annotation. - "customMetadata": # Object with schema name: GenaiVertexV1beta1Struct # User provided metadata about the retrieved context. + "customMetadata": { # User provided metadata about the retrieved context. + "a_key": "", # Properties of the object. + }, "documentUri": "A String", # The URI of the file. "fileName": "A String", # The name of the file. "mediaId": "A String", # Media ID in-case of image citations, if applicable. @@ -5734,7 +5832,9 @@

Method Details

{ # Citation information for model-generated content. "endIndex": 42, # End of the attributed segment, exclusive. "fileCitation": { # A file citation annotation. # A file citation annotation. - "customMetadata": # Object with schema name: GenaiVertexV1beta1Struct # User provided metadata about the retrieved context. + "customMetadata": { # User provided metadata about the retrieved context. + "a_key": "", # Properties of the object. + }, "documentUri": "A String", # The URI of the file. "fileName": "A String", # The name of the file. "mediaId": "A String", # Media ID in-case of image citations, if applicable. @@ -5833,7 +5933,9 @@

Method Details

{ # Citation information for model-generated content. "endIndex": 42, # End of the attributed segment, exclusive. "fileCitation": { # A file citation annotation. # A file citation annotation. - "customMetadata": # Object with schema name: GenaiVertexV1beta1Struct # User provided metadata about the retrieved context. + "customMetadata": { # User provided metadata about the retrieved context. + "a_key": "", # Properties of the object. + }, "documentUri": "A String", # The URI of the file. "fileName": "A String", # The name of the file. "mediaId": "A String", # Media ID in-case of image citations, if applicable. @@ -5951,7 +6053,9 @@

Method Details

{ # Citation information for model-generated content. "endIndex": 42, # End of the attributed segment, exclusive. "fileCitation": { # A file citation annotation. # A file citation annotation. - "customMetadata": # Object with schema name: GenaiVertexV1beta1Struct # User provided metadata about the retrieved context. + "customMetadata": { # User provided metadata about the retrieved context. + "a_key": "", # Properties of the object. + }, "documentUri": "A String", # The URI of the file. "fileName": "A String", # The name of the file. "mediaId": "A String", # Media ID in-case of image citations, if applicable. @@ -6043,7 +6147,9 @@

Method Details

{ # Citation information for model-generated content. "endIndex": 42, # End of the attributed segment, exclusive. "fileCitation": { # A file citation annotation. # A file citation annotation. - "customMetadata": # Object with schema name: GenaiVertexV1beta1Struct # User provided metadata about the retrieved context. + "customMetadata": { # User provided metadata about the retrieved context. + "a_key": "", # Properties of the object. + }, "documentUri": "A String", # The URI of the file. "fileName": "A String", # The name of the file. "mediaId": "A String", # Media ID in-case of image citations, if applicable. @@ -6139,7 +6245,9 @@

Method Details

{ # Citation information for model-generated content. "endIndex": 42, # End of the attributed segment, exclusive. "fileCitation": { # A file citation annotation. # A file citation annotation. - "customMetadata": # Object with schema name: GenaiVertexV1beta1Struct # User provided metadata about the retrieved context. + "customMetadata": { # User provided metadata about the retrieved context. + "a_key": "", # Properties of the object. + }, "documentUri": "A String", # The URI of the file. "fileName": "A String", # The name of the file. "mediaId": "A String", # Media ID in-case of image citations, if applicable. @@ -6255,7 +6363,9 @@

Method Details

{ # Citation information for model-generated content. "endIndex": 42, # End of the attributed segment, exclusive. "fileCitation": { # A file citation annotation. # A file citation annotation. - "customMetadata": # Object with schema name: GenaiVertexV1beta1Struct # User provided metadata about the retrieved context. + "customMetadata": { # User provided metadata about the retrieved context. + "a_key": "", # Properties of the object. + }, "documentUri": "A String", # The URI of the file. "fileName": "A String", # The name of the file. "mediaId": "A String", # Media ID in-case of image citations, if applicable. @@ -6381,7 +6491,9 @@

Method Details

{ # Citation information for model-generated content. "endIndex": 42, # End of the attributed segment, exclusive. "fileCitation": { # A file citation annotation. # A file citation annotation. - "customMetadata": # Object with schema name: GenaiVertexV1beta1Struct # User provided metadata about the retrieved context. + "customMetadata": { # User provided metadata about the retrieved context. + "a_key": "", # Properties of the object. + }, "documentUri": "A String", # The URI of the file. "fileName": "A String", # The name of the file. "mediaId": "A String", # Media ID in-case of image citations, if applicable. @@ -6503,7 +6615,9 @@

Method Details

{ # Citation information for model-generated content. "endIndex": 42, # End of the attributed segment, exclusive. "fileCitation": { # A file citation annotation. # A file citation annotation. - "customMetadata": # Object with schema name: GenaiVertexV1beta1Struct # User provided metadata about the retrieved context. + "customMetadata": { # User provided metadata about the retrieved context. + "a_key": "", # Properties of the object. + }, "documentUri": "A String", # The URI of the file. "fileName": "A String", # The name of the file. "mediaId": "A String", # Media ID in-case of image citations, if applicable. @@ -6612,7 +6726,9 @@

Method Details

{ # Citation information for model-generated content. "endIndex": 42, # End of the attributed segment, exclusive. "fileCitation": { # A file citation annotation. # A file citation annotation. - "customMetadata": # Object with schema name: GenaiVertexV1beta1Struct # User provided metadata about the retrieved context. + "customMetadata": { # User provided metadata about the retrieved context. + "a_key": "", # Properties of the object. + }, "documentUri": "A String", # The URI of the file. "fileName": "A String", # The name of the file. "mediaId": "A String", # Media ID in-case of image citations, if applicable. @@ -6701,7 +6817,9 @@

Method Details

{ # Citation information for model-generated content. "endIndex": 42, # End of the attributed segment, exclusive. "fileCitation": { # A file citation annotation. # A file citation annotation. - "customMetadata": # Object with schema name: GenaiVertexV1beta1Struct # User provided metadata about the retrieved context. + "customMetadata": { # User provided metadata about the retrieved context. + "a_key": "", # Properties of the object. + }, "documentUri": "A String", # The URI of the file. "fileName": "A String", # The name of the file. "mediaId": "A String", # Media ID in-case of image citations, if applicable. @@ -6793,7 +6911,9 @@

Method Details

{ # Citation information for model-generated content. "endIndex": 42, # End of the attributed segment, exclusive. "fileCitation": { # A file citation annotation. # A file citation annotation. - "customMetadata": # Object with schema name: GenaiVertexV1beta1Struct # User provided metadata about the retrieved context. + "customMetadata": { # User provided metadata about the retrieved context. + "a_key": "", # Properties of the object. + }, "documentUri": "A String", # The URI of the file. "fileName": "A String", # The name of the file. "mediaId": "A String", # Media ID in-case of image citations, if applicable. @@ -6889,7 +7009,9 @@

Method Details

{ # Citation information for model-generated content. "endIndex": 42, # End of the attributed segment, exclusive. "fileCitation": { # A file citation annotation. # A file citation annotation. - "customMetadata": # Object with schema name: GenaiVertexV1beta1Struct # User provided metadata about the retrieved context. + "customMetadata": { # User provided metadata about the retrieved context. + "a_key": "", # Properties of the object. + }, "documentUri": "A String", # The URI of the file. "fileName": "A String", # The name of the file. "mediaId": "A String", # Media ID in-case of image citations, if applicable. @@ -7005,7 +7127,9 @@

Method Details

{ # Citation information for model-generated content. "endIndex": 42, # End of the attributed segment, exclusive. "fileCitation": { # A file citation annotation. # A file citation annotation. - "customMetadata": # Object with schema name: GenaiVertexV1beta1Struct # User provided metadata about the retrieved context. + "customMetadata": { # User provided metadata about the retrieved context. + "a_key": "", # Properties of the object. + }, "documentUri": "A String", # The URI of the file. "fileName": "A String", # The name of the file. "mediaId": "A String", # Media ID in-case of image citations, if applicable. @@ -7131,7 +7255,9 @@

Method Details

{ # Citation information for model-generated content. "endIndex": 42, # End of the attributed segment, exclusive. "fileCitation": { # A file citation annotation. # A file citation annotation. - "customMetadata": # Object with schema name: GenaiVertexV1beta1Struct # User provided metadata about the retrieved context. + "customMetadata": { # User provided metadata about the retrieved context. + "a_key": "", # Properties of the object. + }, "documentUri": "A String", # The URI of the file. "fileName": "A String", # The name of the file. "mediaId": "A String", # Media ID in-case of image citations, if applicable. @@ -7253,7 +7379,9 @@

Method Details

{ # Citation information for model-generated content. "endIndex": 42, # End of the attributed segment, exclusive. "fileCitation": { # A file citation annotation. # A file citation annotation. - "customMetadata": # Object with schema name: GenaiVertexV1beta1Struct # User provided metadata about the retrieved context. + "customMetadata": { # User provided metadata about the retrieved context. + "a_key": "", # Properties of the object. + }, "documentUri": "A String", # The URI of the file. "fileName": "A String", # The name of the file. "mediaId": "A String", # Media ID in-case of image citations, if applicable. @@ -7362,7 +7490,9 @@

Method Details

{ # Citation information for model-generated content. "endIndex": 42, # End of the attributed segment, exclusive. "fileCitation": { # A file citation annotation. # A file citation annotation. - "customMetadata": # Object with schema name: GenaiVertexV1beta1Struct # User provided metadata about the retrieved context. + "customMetadata": { # User provided metadata about the retrieved context. + "a_key": "", # Properties of the object. + }, "documentUri": "A String", # The URI of the file. "fileName": "A String", # The name of the file. "mediaId": "A String", # Media ID in-case of image citations, if applicable. @@ -7474,7 +7604,9 @@

Method Details

{ # Citation information for model-generated content. "endIndex": 42, # End of the attributed segment, exclusive. "fileCitation": { # A file citation annotation. # A file citation annotation. - "customMetadata": # Object with schema name: GenaiVertexV1beta1Struct # User provided metadata about the retrieved context. + "customMetadata": { # User provided metadata about the retrieved context. + "a_key": "", # Properties of the object. + }, "documentUri": "A String", # The URI of the file. "fileName": "A String", # The name of the file. "mediaId": "A String", # Media ID in-case of image citations, if applicable. @@ -7733,7 +7865,9 @@

Method Details

{ # Citation information for model-generated content. "endIndex": 42, # End of the attributed segment, exclusive. "fileCitation": { # A file citation annotation. # A file citation annotation. - "customMetadata": # Object with schema name: GenaiVertexV1beta1Struct # User provided metadata about the retrieved context. + "customMetadata": { # User provided metadata about the retrieved context. + "a_key": "", # Properties of the object. + }, "documentUri": "A String", # The URI of the file. "fileName": "A String", # The name of the file. "mediaId": "A String", # Media ID in-case of image citations, if applicable. @@ -7826,7 +7960,9 @@

Method Details

{ # Citation information for model-generated content. "endIndex": 42, # End of the attributed segment, exclusive. "fileCitation": { # A file citation annotation. # A file citation annotation. - "customMetadata": # Object with schema name: GenaiVertexV1beta1Struct # User provided metadata about the retrieved context. + "customMetadata": { # User provided metadata about the retrieved context. + "a_key": "", # Properties of the object. + }, "documentUri": "A String", # The URI of the file. "fileName": "A String", # The name of the file. "mediaId": "A String", # Media ID in-case of image citations, if applicable. @@ -7880,6 +8016,7 @@

Method Details

"uri": "A String", # The URI of the video. }, }, + "continuationToken": "A String", # Opaque token to resume a long decode. Output: set when status is INCOMPLETE and decoding can be resumed. Input: pass the latest token back unchanged in CreateInteraction to continue decoding. "created": "A String", # Required. Output only. The time at which the response was created in ISO 8601 format (YYYY-MM-DDThh:mm:ssZ). "envId": "A String", # The environment ID for the interaction. Can be 'remote' for default environment. "environmentId": "A String", # Output only. The environment ID for the interaction. Only populated if environment config is set in the request. @@ -7953,9 +8090,10 @@

Method Details

"remoteEnvironment": { # Configuration for a custom environment. "environmentId": "A String", # Optional. The environment ID for the interaction. If specified, the request will update the existing environment instead of creating a new one. "networkAllowlist": { # Network egress configuration for the environment. # Allow only specific domains. - "allowlist": [ # List of allowed domains and their configurations. + "allowlist": [ # List of allowed domains and their configurations. Set to `"disabled"` to block all network egress. { # A single domain allowlist rule with optional header injection. "domain": "A String", # Domain to allow outbound requests to. Supports wildcards (e.g. '*.googleapis.com'). Use '*' to allow all domains. + "mode": "A String", # Network egress mode. Set via the `"allowlist": "disabled"` short form; must be the only rule in the allowlist and cannot be combined with `domain`, `transform` or `credential`. "transform": { # Headers to inject into requests matching this rule. Key: header name (e.g., "Authorization"). Value: header value (e.g., "Bearer your-token"). "a_key": "A String", }, @@ -8018,7 +8156,9 @@

Method Details

{ # Citation information for model-generated content. "endIndex": 42, # End of the attributed segment, exclusive. "fileCitation": { # A file citation annotation. # A file citation annotation. - "customMetadata": # Object with schema name: GenaiVertexV1beta1Struct # User provided metadata about the retrieved context. + "customMetadata": { # User provided metadata about the retrieved context. + "a_key": "", # Properties of the object. + }, "documentUri": "A String", # The URI of the file. "fileName": "A String", # The name of the file. "mediaId": "A String", # Media ID in-case of image citations, if applicable. @@ -8117,7 +8257,9 @@

Method Details

{ # Citation information for model-generated content. "endIndex": 42, # End of the attributed segment, exclusive. "fileCitation": { # A file citation annotation. # A file citation annotation. - "customMetadata": # Object with schema name: GenaiVertexV1beta1Struct # User provided metadata about the retrieved context. + "customMetadata": { # User provided metadata about the retrieved context. + "a_key": "", # Properties of the object. + }, "documentUri": "A String", # The URI of the file. "fileName": "A String", # The name of the file. "mediaId": "A String", # Media ID in-case of image citations, if applicable. @@ -8238,7 +8380,9 @@

Method Details

{ # Citation information for model-generated content. "endIndex": 42, # End of the attributed segment, exclusive. "fileCitation": { # A file citation annotation. # A file citation annotation. - "customMetadata": # Object with schema name: GenaiVertexV1beta1Struct # User provided metadata about the retrieved context. + "customMetadata": { # User provided metadata about the retrieved context. + "a_key": "", # Properties of the object. + }, "documentUri": "A String", # The URI of the file. "fileName": "A String", # The name of the file. "mediaId": "A String", # Media ID in-case of image citations, if applicable. @@ -8337,7 +8481,9 @@

Method Details

{ # Citation information for model-generated content. "endIndex": 42, # End of the attributed segment, exclusive. "fileCitation": { # A file citation annotation. # A file citation annotation. - "customMetadata": # Object with schema name: GenaiVertexV1beta1Struct # User provided metadata about the retrieved context. + "customMetadata": { # User provided metadata about the retrieved context. + "a_key": "", # Properties of the object. + }, "documentUri": "A String", # The URI of the file. "fileName": "A String", # The name of the file. "mediaId": "A String", # Media ID in-case of image citations, if applicable. @@ -8455,7 +8601,9 @@

Method Details

{ # Citation information for model-generated content. "endIndex": 42, # End of the attributed segment, exclusive. "fileCitation": { # A file citation annotation. # A file citation annotation. - "customMetadata": # Object with schema name: GenaiVertexV1beta1Struct # User provided metadata about the retrieved context. + "customMetadata": { # User provided metadata about the retrieved context. + "a_key": "", # Properties of the object. + }, "documentUri": "A String", # The URI of the file. "fileName": "A String", # The name of the file. "mediaId": "A String", # Media ID in-case of image citations, if applicable. @@ -8547,7 +8695,9 @@

Method Details

{ # Citation information for model-generated content. "endIndex": 42, # End of the attributed segment, exclusive. "fileCitation": { # A file citation annotation. # A file citation annotation. - "customMetadata": # Object with schema name: GenaiVertexV1beta1Struct # User provided metadata about the retrieved context. + "customMetadata": { # User provided metadata about the retrieved context. + "a_key": "", # Properties of the object. + }, "documentUri": "A String", # The URI of the file. "fileName": "A String", # The name of the file. "mediaId": "A String", # Media ID in-case of image citations, if applicable. @@ -8643,7 +8793,9 @@

Method Details

{ # Citation information for model-generated content. "endIndex": 42, # End of the attributed segment, exclusive. "fileCitation": { # A file citation annotation. # A file citation annotation. - "customMetadata": # Object with schema name: GenaiVertexV1beta1Struct # User provided metadata about the retrieved context. + "customMetadata": { # User provided metadata about the retrieved context. + "a_key": "", # Properties of the object. + }, "documentUri": "A String", # The URI of the file. "fileName": "A String", # The name of the file. "mediaId": "A String", # Media ID in-case of image citations, if applicable. @@ -8759,7 +8911,9 @@

Method Details

{ # Citation information for model-generated content. "endIndex": 42, # End of the attributed segment, exclusive. "fileCitation": { # A file citation annotation. # A file citation annotation. - "customMetadata": # Object with schema name: GenaiVertexV1beta1Struct # User provided metadata about the retrieved context. + "customMetadata": { # User provided metadata about the retrieved context. + "a_key": "", # Properties of the object. + }, "documentUri": "A String", # The URI of the file. "fileName": "A String", # The name of the file. "mediaId": "A String", # Media ID in-case of image citations, if applicable. @@ -8885,7 +9039,9 @@

Method Details

{ # Citation information for model-generated content. "endIndex": 42, # End of the attributed segment, exclusive. "fileCitation": { # A file citation annotation. # A file citation annotation. - "customMetadata": # Object with schema name: GenaiVertexV1beta1Struct # User provided metadata about the retrieved context. + "customMetadata": { # User provided metadata about the retrieved context. + "a_key": "", # Properties of the object. + }, "documentUri": "A String", # The URI of the file. "fileName": "A String", # The name of the file. "mediaId": "A String", # Media ID in-case of image citations, if applicable. @@ -9007,7 +9163,9 @@

Method Details

{ # Citation information for model-generated content. "endIndex": 42, # End of the attributed segment, exclusive. "fileCitation": { # A file citation annotation. # A file citation annotation. - "customMetadata": # Object with schema name: GenaiVertexV1beta1Struct # User provided metadata about the retrieved context. + "customMetadata": { # User provided metadata about the retrieved context. + "a_key": "", # Properties of the object. + }, "documentUri": "A String", # The URI of the file. "fileName": "A String", # The name of the file. "mediaId": "A String", # Media ID in-case of image citations, if applicable. @@ -9116,7 +9274,9 @@

Method Details

{ # Citation information for model-generated content. "endIndex": 42, # End of the attributed segment, exclusive. "fileCitation": { # A file citation annotation. # A file citation annotation. - "customMetadata": # Object with schema name: GenaiVertexV1beta1Struct # User provided metadata about the retrieved context. + "customMetadata": { # User provided metadata about the retrieved context. + "a_key": "", # Properties of the object. + }, "documentUri": "A String", # The URI of the file. "fileName": "A String", # The name of the file. "mediaId": "A String", # Media ID in-case of image citations, if applicable. @@ -9205,7 +9365,9 @@

Method Details

{ # Citation information for model-generated content. "endIndex": 42, # End of the attributed segment, exclusive. "fileCitation": { # A file citation annotation. # A file citation annotation. - "customMetadata": # Object with schema name: GenaiVertexV1beta1Struct # User provided metadata about the retrieved context. + "customMetadata": { # User provided metadata about the retrieved context. + "a_key": "", # Properties of the object. + }, "documentUri": "A String", # The URI of the file. "fileName": "A String", # The name of the file. "mediaId": "A String", # Media ID in-case of image citations, if applicable. @@ -9297,7 +9459,9 @@

Method Details

{ # Citation information for model-generated content. "endIndex": 42, # End of the attributed segment, exclusive. "fileCitation": { # A file citation annotation. # A file citation annotation. - "customMetadata": # Object with schema name: GenaiVertexV1beta1Struct # User provided metadata about the retrieved context. + "customMetadata": { # User provided metadata about the retrieved context. + "a_key": "", # Properties of the object. + }, "documentUri": "A String", # The URI of the file. "fileName": "A String", # The name of the file. "mediaId": "A String", # Media ID in-case of image citations, if applicable. @@ -9393,7 +9557,9 @@

Method Details

{ # Citation information for model-generated content. "endIndex": 42, # End of the attributed segment, exclusive. "fileCitation": { # A file citation annotation. # A file citation annotation. - "customMetadata": # Object with schema name: GenaiVertexV1beta1Struct # User provided metadata about the retrieved context. + "customMetadata": { # User provided metadata about the retrieved context. + "a_key": "", # Properties of the object. + }, "documentUri": "A String", # The URI of the file. "fileName": "A String", # The name of the file. "mediaId": "A String", # Media ID in-case of image citations, if applicable. @@ -9509,7 +9675,9 @@

Method Details

{ # Citation information for model-generated content. "endIndex": 42, # End of the attributed segment, exclusive. "fileCitation": { # A file citation annotation. # A file citation annotation. - "customMetadata": # Object with schema name: GenaiVertexV1beta1Struct # User provided metadata about the retrieved context. + "customMetadata": { # User provided metadata about the retrieved context. + "a_key": "", # Properties of the object. + }, "documentUri": "A String", # The URI of the file. "fileName": "A String", # The name of the file. "mediaId": "A String", # Media ID in-case of image citations, if applicable. @@ -9635,7 +9803,9 @@

Method Details

{ # Citation information for model-generated content. "endIndex": 42, # End of the attributed segment, exclusive. "fileCitation": { # A file citation annotation. # A file citation annotation. - "customMetadata": # Object with schema name: GenaiVertexV1beta1Struct # User provided metadata about the retrieved context. + "customMetadata": { # User provided metadata about the retrieved context. + "a_key": "", # Properties of the object. + }, "documentUri": "A String", # The URI of the file. "fileName": "A String", # The name of the file. "mediaId": "A String", # Media ID in-case of image citations, if applicable. @@ -9757,7 +9927,9 @@

Method Details

{ # Citation information for model-generated content. "endIndex": 42, # End of the attributed segment, exclusive. "fileCitation": { # A file citation annotation. # A file citation annotation. - "customMetadata": # Object with schema name: GenaiVertexV1beta1Struct # User provided metadata about the retrieved context. + "customMetadata": { # User provided metadata about the retrieved context. + "a_key": "", # Properties of the object. + }, "documentUri": "A String", # The URI of the file. "fileName": "A String", # The name of the file. "mediaId": "A String", # Media ID in-case of image citations, if applicable. @@ -9866,7 +10038,9 @@

Method Details

{ # Citation information for model-generated content. "endIndex": 42, # End of the attributed segment, exclusive. "fileCitation": { # A file citation annotation. # A file citation annotation. - "customMetadata": # Object with schema name: GenaiVertexV1beta1Struct # User provided metadata about the retrieved context. + "customMetadata": { # User provided metadata about the retrieved context. + "a_key": "", # Properties of the object. + }, "documentUri": "A String", # The URI of the file. "fileName": "A String", # The name of the file. "mediaId": "A String", # Media ID in-case of image citations, if applicable. @@ -9978,7 +10152,9 @@

Method Details

{ # Citation information for model-generated content. "endIndex": 42, # End of the attributed segment, exclusive. "fileCitation": { # A file citation annotation. # A file citation annotation. - "customMetadata": # Object with schema name: GenaiVertexV1beta1Struct # User provided metadata about the retrieved context. + "customMetadata": { # User provided metadata about the retrieved context. + "a_key": "", # Properties of the object. + }, "documentUri": "A String", # The URI of the file. "fileName": "A String", # The name of the file. "mediaId": "A String", # Media ID in-case of image citations, if applicable. @@ -10165,8 +10341,47 @@

Method Details

}, }, "interactionStatusUpdate": { # The interaction status data, used for interaction.status_update events. + "continuationToken": "A String", # An optional opaque continuation token used to resume decoding from the latest checkpoint after a disconnected stream. "interactionId": "A String", "status": "A String", + "usage": { # Statistics on the interaction request's token usage. # Model usage statistics up to this checkpoint. + "cachedTokensByModality": [ # A breakdown of cached token usage by modality. + { # The token count for a single response modality. + "modality": "A String", # The modality associated with the token count. + "tokens": 42, # Number of tokens for the modality. + }, + ], + "groundingToolCount": [ # Grounding tool count. + { # The number of grounding tool counts. + "count": 42, # The number of grounding tool counts. + "type": "A String", # The grounding tool type associated with the count. + }, + ], + "inputTokensByModality": [ # A breakdown of input token usage by modality. + { # The token count for a single response modality. + "modality": "A String", # The modality associated with the token count. + "tokens": 42, # Number of tokens for the modality. + }, + ], + "outputTokensByModality": [ # A breakdown of output token usage by modality. + { # The token count for a single response modality. + "modality": "A String", # The modality associated with the token count. + "tokens": 42, # Number of tokens for the modality. + }, + ], + "toolUseTokensByModality": [ # A breakdown of tool-use token usage by modality. + { # The token count for a single response modality. + "modality": "A String", # The modality associated with the token count. + "tokens": 42, # Number of tokens for the modality. + }, + ], + "totalCachedTokens": 42, # Number of tokens in the cached part of the prompt (the cached content). + "totalInputTokens": 42, # Number of tokens in the prompt (context). + "totalOutputTokens": 42, # Total number of tokens across all the generated responses. + "totalThoughtTokens": 42, # Number of tokens of thoughts for thinking models. + "totalTokens": 42, # Total token count for the interaction request (prompt + responses + other internal tokens). + "totalToolUseTokens": 42, # Number of tokens present in tool-use prompt(s). + }, }, "stepDelta": { # The step delta data, used for step.delta events. Step-based streaming event, used when steps are enabled. "delta": { @@ -10215,7 +10430,9 @@

Method Details

{ # Citation information for model-generated content. "endIndex": 42, # End of the attributed segment, exclusive. "fileCitation": { # A file citation annotation. # A file citation annotation. - "customMetadata": # Object with schema name: GenaiVertexV1beta1Struct # User provided metadata about the retrieved context. + "customMetadata": { # User provided metadata about the retrieved context. + "a_key": "", # Properties of the object. + }, "documentUri": "A String", # The URI of the file. "fileName": "A String", # The name of the file. "mediaId": "A String", # Media ID in-case of image citations, if applicable. @@ -10340,7 +10557,9 @@

Method Details

{ # Citation information for model-generated content. "endIndex": 42, # End of the attributed segment, exclusive. "fileCitation": { # A file citation annotation. # A file citation annotation. - "customMetadata": # Object with schema name: GenaiVertexV1beta1Struct # User provided metadata about the retrieved context. + "customMetadata": { # User provided metadata about the retrieved context. + "a_key": "", # Properties of the object. + }, "documentUri": "A String", # The URI of the file. "fileName": "A String", # The name of the file. "mediaId": "A String", # Media ID in-case of image citations, if applicable. @@ -10497,7 +10716,9 @@

Method Details

{ # Citation information for model-generated content. "endIndex": 42, # End of the attributed segment, exclusive. "fileCitation": { # A file citation annotation. # A file citation annotation. - "customMetadata": # Object with schema name: GenaiVertexV1beta1Struct # User provided metadata about the retrieved context. + "customMetadata": { # User provided metadata about the retrieved context. + "a_key": "", # Properties of the object. + }, "documentUri": "A String", # The URI of the file. "fileName": "A String", # The name of the file. "mediaId": "A String", # Media ID in-case of image citations, if applicable. @@ -10587,7 +10808,9 @@

Method Details

{ # Citation information for model-generated content. "endIndex": 42, # End of the attributed segment, exclusive. "fileCitation": { # A file citation annotation. # A file citation annotation. - "customMetadata": # Object with schema name: GenaiVertexV1beta1Struct # User provided metadata about the retrieved context. + "customMetadata": { # User provided metadata about the retrieved context. + "a_key": "", # Properties of the object. + }, "documentUri": "A String", # The URI of the file. "fileName": "A String", # The name of the file. "mediaId": "A String", # Media ID in-case of image citations, if applicable. @@ -10652,7 +10875,9 @@

Method Details

{ # Citation information for model-generated content. "endIndex": 42, # End of the attributed segment, exclusive. "fileCitation": { # A file citation annotation. # A file citation annotation. - "customMetadata": # Object with schema name: GenaiVertexV1beta1Struct # User provided metadata about the retrieved context. + "customMetadata": { # User provided metadata about the retrieved context. + "a_key": "", # Properties of the object. + }, "documentUri": "A String", # The URI of the file. "fileName": "A String", # The name of the file. "mediaId": "A String", # Media ID in-case of image citations, if applicable. @@ -10745,7 +10970,9 @@

Method Details

{ # Citation information for model-generated content. "endIndex": 42, # End of the attributed segment, exclusive. "fileCitation": { # A file citation annotation. # A file citation annotation. - "customMetadata": # Object with schema name: GenaiVertexV1beta1Struct # User provided metadata about the retrieved context. + "customMetadata": { # User provided metadata about the retrieved context. + "a_key": "", # Properties of the object. + }, "documentUri": "A String", # The URI of the file. "fileName": "A String", # The name of the file. "mediaId": "A String", # Media ID in-case of image citations, if applicable. @@ -10837,7 +11064,9 @@

Method Details

{ # Citation information for model-generated content. "endIndex": 42, # End of the attributed segment, exclusive. "fileCitation": { # A file citation annotation. # A file citation annotation. - "customMetadata": # Object with schema name: GenaiVertexV1beta1Struct # User provided metadata about the retrieved context. + "customMetadata": { # User provided metadata about the retrieved context. + "a_key": "", # Properties of the object. + }, "documentUri": "A String", # The URI of the file. "fileName": "A String", # The name of the file. "mediaId": "A String", # Media ID in-case of image citations, if applicable. @@ -10933,7 +11162,9 @@

Method Details

{ # Citation information for model-generated content. "endIndex": 42, # End of the attributed segment, exclusive. "fileCitation": { # A file citation annotation. # A file citation annotation. - "customMetadata": # Object with schema name: GenaiVertexV1beta1Struct # User provided metadata about the retrieved context. + "customMetadata": { # User provided metadata about the retrieved context. + "a_key": "", # Properties of the object. + }, "documentUri": "A String", # The URI of the file. "fileName": "A String", # The name of the file. "mediaId": "A String", # Media ID in-case of image citations, if applicable. @@ -11049,7 +11280,9 @@

Method Details

{ # Citation information for model-generated content. "endIndex": 42, # End of the attributed segment, exclusive. "fileCitation": { # A file citation annotation. # A file citation annotation. - "customMetadata": # Object with schema name: GenaiVertexV1beta1Struct # User provided metadata about the retrieved context. + "customMetadata": { # User provided metadata about the retrieved context. + "a_key": "", # Properties of the object. + }, "documentUri": "A String", # The URI of the file. "fileName": "A String", # The name of the file. "mediaId": "A String", # Media ID in-case of image citations, if applicable. @@ -11175,7 +11408,9 @@

Method Details

{ # Citation information for model-generated content. "endIndex": 42, # End of the attributed segment, exclusive. "fileCitation": { # A file citation annotation. # A file citation annotation. - "customMetadata": # Object with schema name: GenaiVertexV1beta1Struct # User provided metadata about the retrieved context. + "customMetadata": { # User provided metadata about the retrieved context. + "a_key": "", # Properties of the object. + }, "documentUri": "A String", # The URI of the file. "fileName": "A String", # The name of the file. "mediaId": "A String", # Media ID in-case of image citations, if applicable. @@ -11297,7 +11532,9 @@

Method Details

{ # Citation information for model-generated content. "endIndex": 42, # End of the attributed segment, exclusive. "fileCitation": { # A file citation annotation. # A file citation annotation. - "customMetadata": # Object with schema name: GenaiVertexV1beta1Struct # User provided metadata about the retrieved context. + "customMetadata": { # User provided metadata about the retrieved context. + "a_key": "", # Properties of the object. + }, "documentUri": "A String", # The URI of the file. "fileName": "A String", # The name of the file. "mediaId": "A String", # Media ID in-case of image citations, if applicable. @@ -11406,7 +11643,9 @@

Method Details

{ # Citation information for model-generated content. "endIndex": 42, # End of the attributed segment, exclusive. "fileCitation": { # A file citation annotation. # A file citation annotation. - "customMetadata": # Object with schema name: GenaiVertexV1beta1Struct # User provided metadata about the retrieved context. + "customMetadata": { # User provided metadata about the retrieved context. + "a_key": "", # Properties of the object. + }, "documentUri": "A String", # The URI of the file. "fileName": "A String", # The name of the file. "mediaId": "A String", # Media ID in-case of image citations, if applicable. diff --git a/docs/dyn/aiplatform_v1beta1.memoryBanks.html b/docs/dyn/aiplatform_v1beta1.memoryBanks.html index 9eba77319e..63cb0bb9e0 100644 --- a/docs/dyn/aiplatform_v1beta1.memoryBanks.html +++ b/docs/dyn/aiplatform_v1beta1.memoryBanks.html @@ -111,7 +111,7 @@

Method Details

{ # A single event to ingest. "content": { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. # Required. The content of the event. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. diff --git a/docs/dyn/aiplatform_v1beta1.memoryBanks.memories.html b/docs/dyn/aiplatform_v1beta1.memoryBanks.memories.html index aa0d6530c7..5328f8ffed 100644 --- a/docs/dyn/aiplatform_v1beta1.memoryBanks.memories.html +++ b/docs/dyn/aiplatform_v1beta1.memoryBanks.memories.html @@ -263,7 +263,7 @@

Method Details

{ # A single piece of conversation from which to generate memories. "content": { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. # Required. A single piece of content from which to generate memories. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. diff --git a/docs/dyn/aiplatform_v1beta1.projects.locations.agentAnomalyDetectionScopes.html b/docs/dyn/aiplatform_v1beta1.projects.locations.agentAnomalyDetectionScopes.html index fa84cfd5cd..759bdd2fc0 100644 --- a/docs/dyn/aiplatform_v1beta1.projects.locations.agentAnomalyDetectionScopes.html +++ b/docs/dyn/aiplatform_v1beta1.projects.locations.agentAnomalyDetectionScopes.html @@ -110,6 +110,9 @@

Method Details

{ # Represents an Agent Anomaly Detection Scope. "autoEnroll": True or False, # Optional. When true, agents created in Agent Engine that share log and observability buckets with this scope are automatically enrolled as MonitoredAgents. When false, agents must be enrolled explicitly via MonitoredAgent operations. "displayName": "A String", # Optional. User-provided display name of the AgentAnomalyDetectionScope. + "encryptionSpec": { # Represents a customer-managed encryption key specification that can be applied to a Vertex AI resource. # Optional. Immutable. Specifies the customer-managed encryption key spec for a Scope. If set, this Scope and all sub-resources will be secured by this key. The key is immutable after the Scope is created and must be a multi-region (`us` or `eu`) key in the same region as the Scope. + "kmsKeyName": "A String", # Required. Resource name of the Cloud KMS key used to protect the resource. The Cloud KMS key must be in the same region as the resource. It must have the format `projects/{project}/locations/{location}/keyRings/{key_ring}/cryptoKeys/{crypto_key}`. + }, "logBuckets": [ # Required. Customer-owned Cloud Logging bucket resource names attached to this scope. Format: `projects/{project}/locations/{location}/buckets/{bucket}`. "A String", ], @@ -202,6 +205,9 @@

Method Details

{ # Represents an Agent Anomaly Detection Scope. "autoEnroll": True or False, # Optional. When true, agents created in Agent Engine that share log and observability buckets with this scope are automatically enrolled as MonitoredAgents. When false, agents must be enrolled explicitly via MonitoredAgent operations. "displayName": "A String", # Optional. User-provided display name of the AgentAnomalyDetectionScope. + "encryptionSpec": { # Represents a customer-managed encryption key specification that can be applied to a Vertex AI resource. # Optional. Immutable. Specifies the customer-managed encryption key spec for a Scope. If set, this Scope and all sub-resources will be secured by this key. The key is immutable after the Scope is created and must be a multi-region (`us` or `eu`) key in the same region as the Scope. + "kmsKeyName": "A String", # Required. Resource name of the Cloud KMS key used to protect the resource. The Cloud KMS key must be in the same region as the resource. It must have the format `projects/{project}/locations/{location}/keyRings/{key_ring}/cryptoKeys/{crypto_key}`. + }, "logBuckets": [ # Required. Customer-owned Cloud Logging bucket resource names attached to this scope. Format: `projects/{project}/locations/{location}/buckets/{bucket}`. "A String", ], @@ -234,6 +240,9 @@

Method Details

{ # Represents an Agent Anomaly Detection Scope. "autoEnroll": True or False, # Optional. When true, agents created in Agent Engine that share log and observability buckets with this scope are automatically enrolled as MonitoredAgents. When false, agents must be enrolled explicitly via MonitoredAgent operations. "displayName": "A String", # Optional. User-provided display name of the AgentAnomalyDetectionScope. + "encryptionSpec": { # Represents a customer-managed encryption key specification that can be applied to a Vertex AI resource. # Optional. Immutable. Specifies the customer-managed encryption key spec for a Scope. If set, this Scope and all sub-resources will be secured by this key. The key is immutable after the Scope is created and must be a multi-region (`us` or `eu`) key in the same region as the Scope. + "kmsKeyName": "A String", # Required. Resource name of the Cloud KMS key used to protect the resource. The Cloud KMS key must be in the same region as the resource. It must have the format `projects/{project}/locations/{location}/keyRings/{key_ring}/cryptoKeys/{crypto_key}`. + }, "logBuckets": [ # Required. Customer-owned Cloud Logging bucket resource names attached to this scope. Format: `projects/{project}/locations/{location}/buckets/{bucket}`. "A String", ], diff --git a/docs/dyn/aiplatform_v1beta1.projects.locations.agents.html b/docs/dyn/aiplatform_v1beta1.projects.locations.agents.html index bb09bc3823..894ea8144a 100644 --- a/docs/dyn/aiplatform_v1beta1.projects.locations.agents.html +++ b/docs/dyn/aiplatform_v1beta1.projects.locations.agents.html @@ -129,6 +129,7 @@

Method Details

"base_environment": "", # Optional. The base environment configuration for the agent. Valid types: * A string value for the environment ID, or `remote` for the default. * A struct value for the `environment_config`. "created": "A String", # Output only. The time the agent was created. "description": "A String", # Optional. The description of the agent. + "effectiveIdentity": "A String", # Output only. The resolved Agent Identity (SPIFFE principal) of the agent. "id": "A String", # Immutable. The user-specified ID for the agent. This ID becomes the final component of the agent resource name. If not provided, Vertex AI will generate a value for this ID. The ID can be up to 63 characters and must match the regular expression `[a-z]([a-z0-9-]{0,61}[a-z0-9])?`. "metadata": { # Optional. The metadata for the agent. "a_key": "A String", @@ -241,6 +242,7 @@

Method Details

"base_environment": "", # Optional. The base environment configuration for the agent. Valid types: * A string value for the environment ID, or `remote` for the default. * A struct value for the `environment_config`. "created": "A String", # Output only. The time the agent was created. "description": "A String", # Optional. The description of the agent. + "effectiveIdentity": "A String", # Output only. The resolved Agent Identity (SPIFFE principal) of the agent. "id": "A String", # Immutable. The user-specified ID for the agent. This ID becomes the final component of the agent resource name. If not provided, Vertex AI will generate a value for this ID. The ID can be up to 63 characters and must match the regular expression `[a-z]([a-z0-9-]{0,61}[a-z0-9])?`. "metadata": { # Optional. The metadata for the agent. "a_key": "A String", @@ -330,6 +332,7 @@

Method Details

"base_environment": "", # Optional. The base environment configuration for the agent. Valid types: * A string value for the environment ID, or `remote` for the default. * A struct value for the `environment_config`. "created": "A String", # Output only. The time the agent was created. "description": "A String", # Optional. The description of the agent. + "effectiveIdentity": "A String", # Output only. The resolved Agent Identity (SPIFFE principal) of the agent. "id": "A String", # Immutable. The user-specified ID for the agent. This ID becomes the final component of the agent resource name. If not provided, Vertex AI will generate a value for this ID. The ID can be up to 63 characters and must match the regular expression `[a-z]([a-z0-9-]{0,61}[a-z0-9])?`. "metadata": { # Optional. The metadata for the agent. "a_key": "A String", @@ -390,6 +393,7 @@

Method Details

"base_environment": "", # Optional. The base environment configuration for the agent. Valid types: * A string value for the environment ID, or `remote` for the default. * A struct value for the `environment_config`. "created": "A String", # Output only. The time the agent was created. "description": "A String", # Optional. The description of the agent. + "effectiveIdentity": "A String", # Output only. The resolved Agent Identity (SPIFFE principal) of the agent. "id": "A String", # Immutable. The user-specified ID for the agent. This ID becomes the final component of the agent resource name. If not provided, Vertex AI will generate a value for this ID. The ID can be up to 63 characters and must match the regular expression `[a-z]([a-z0-9-]{0,61}[a-z0-9])?`. "metadata": { # Optional. The metadata for the agent. "a_key": "A String", diff --git a/docs/dyn/aiplatform_v1beta1.projects.locations.batchPredictionJobs.html b/docs/dyn/aiplatform_v1beta1.projects.locations.batchPredictionJobs.html index e5e46c2f45..11a9f96bb2 100644 --- a/docs/dyn/aiplatform_v1beta1.projects.locations.batchPredictionJobs.html +++ b/docs/dyn/aiplatform_v1beta1.projects.locations.batchPredictionJobs.html @@ -505,7 +505,7 @@

Method Details

"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). + "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). At most 200 environment variables can be specified. Each variable (`NAME=value`) must be smaller than 128 KiB, and the total size of all variables must not exceed 512 KiB. { # 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. @@ -1011,7 +1011,7 @@

Method Details

"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). + "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). At most 200 environment variables can be specified. Each variable (`NAME=value`) must be smaller than 128 KiB, and the total size of all variables must not exceed 512 KiB. { # 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. @@ -1559,7 +1559,7 @@

Method Details

"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). + "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). At most 200 environment variables can be specified. Each variable (`NAME=value`) must be smaller than 128 KiB, and the total size of all variables must not exceed 512 KiB. { # 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. @@ -2078,7 +2078,7 @@

Method Details

"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). + "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). At most 200 environment variables can be specified. Each variable (`NAME=value`) must be smaller than 128 KiB, and the total size of all variables must not exceed 512 KiB. { # 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. diff --git a/docs/dyn/aiplatform_v1beta1.projects.locations.cachedContents.html b/docs/dyn/aiplatform_v1beta1.projects.locations.cachedContents.html index 24c86e2a06..a654d90cdb 100644 --- a/docs/dyn/aiplatform_v1beta1.projects.locations.cachedContents.html +++ b/docs/dyn/aiplatform_v1beta1.projects.locations.cachedContents.html @@ -114,7 +114,7 @@

Method Details

"contents": [ # Optional. Input only. Immutable. The content to cache { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -217,7 +217,7 @@

Method Details

"name": "A String", # Immutable. Identifier. The server-generated resource name of the cached content Format: projects/{project}/locations/{location}/cachedContents/{cached_content} "systemInstruction": { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. # Optional. Input only. Immutable. Developer set system instruction. Currently, text only "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -590,7 +590,7 @@

Method Details

"contents": [ # Optional. Input only. Immutable. The content to cache { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -693,7 +693,7 @@

Method Details

"name": "A String", # Immutable. Identifier. The server-generated resource name of the cached content Format: projects/{project}/locations/{location}/cachedContents/{cached_content} "systemInstruction": { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. # Optional. Input only. Immutable. Developer set system instruction. Currently, text only "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -1091,7 +1091,7 @@

Method Details

"contents": [ # Optional. Input only. Immutable. The content to cache { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -1194,7 +1194,7 @@

Method Details

"name": "A String", # Immutable. Identifier. The server-generated resource name of the cached content Format: projects/{project}/locations/{location}/cachedContents/{cached_content} "systemInstruction": { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. # Optional. Input only. Immutable. Developer set system instruction. Currently, text only "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -1578,7 +1578,7 @@

Method Details

"contents": [ # Optional. Input only. Immutable. The content to cache { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -1681,7 +1681,7 @@

Method Details

"name": "A String", # Immutable. Identifier. The server-generated resource name of the cached content Format: projects/{project}/locations/{location}/cachedContents/{cached_content} "systemInstruction": { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. # Optional. Input only. Immutable. Developer set system instruction. Currently, text only "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -2073,7 +2073,7 @@

Method Details

"contents": [ # Optional. Input only. Immutable. The content to cache { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -2176,7 +2176,7 @@

Method Details

"name": "A String", # Immutable. Identifier. The server-generated resource name of the cached content Format: projects/{project}/locations/{location}/cachedContents/{cached_content} "systemInstruction": { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. # Optional. Input only. Immutable. Developer set system instruction. Currently, text only "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -2550,7 +2550,7 @@

Method Details

"contents": [ # Optional. Input only. Immutable. The content to cache { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -2653,7 +2653,7 @@

Method Details

"name": "A String", # Immutable. Identifier. The server-generated resource name of the cached content Format: projects/{project}/locations/{location}/cachedContents/{cached_content} "systemInstruction": { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. # Optional. Input only. Immutable. Developer set system instruction. Currently, text only "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. diff --git a/docs/dyn/aiplatform_v1beta1.projects.locations.datasets.html b/docs/dyn/aiplatform_v1beta1.projects.locations.datasets.html index 3b8515aed3..3d3d014406 100644 --- a/docs/dyn/aiplatform_v1beta1.projects.locations.datasets.html +++ b/docs/dyn/aiplatform_v1beta1.projects.locations.datasets.html @@ -169,7 +169,7 @@

Method Details

"contents": [ # Required. The content of the current conversation with the model. For single-turn queries, this is a single instance. For multi-turn queries, this is a repeated field that contains conversation history + latest request. { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -449,7 +449,7 @@

Method Details

], "systemInstruction": { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. # Optional. The user provided system instructions for the model. Note: only text should be used in parts and content in each part will be in a separate paragraph. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -860,7 +860,7 @@

Method Details

"contents": [ # Required. The content of the current conversation with the model. For single-turn queries, this is a single instance. For multi-turn queries, this is a repeated field that contains conversation history + latest request. { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -1140,7 +1140,7 @@

Method Details

], "systemInstruction": { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. # Optional. The user provided system instructions for the model. Note: only text should be used in parts and content in each part will be in a separate paragraph. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. diff --git a/docs/dyn/aiplatform_v1beta1.projects.locations.endpoints.html b/docs/dyn/aiplatform_v1beta1.projects.locations.endpoints.html index b18932bdba..29eb2ff4d7 100644 --- a/docs/dyn/aiplatform_v1beta1.projects.locations.endpoints.html +++ b/docs/dyn/aiplatform_v1beta1.projects.locations.endpoints.html @@ -209,7 +209,7 @@

Method Details

"contents": [ # Optional. Input content. { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -344,7 +344,7 @@

Method Details

"contents": [ # Optional. Input content. { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -613,7 +613,7 @@

Method Details

"model": "A String", # Optional. The name of the publisher model requested to serve the prediction. Format: `projects/{project}/locations/{location}/publishers/*/models/*` "systemInstruction": { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. # Optional. The user provided system instructions for the model. Note: only text should be used in parts and content in each part will be in a separate paragraph. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -2135,7 +2135,7 @@

Method Details

"contents": [ # Required. The content of the current conversation with the model. For single-turn queries, this is a single instance. For multi-turn queries, this is a repeated field that contains conversation history + latest request. { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -2228,6 +2228,7 @@

Method Details

"role": "A String", # Optional. The producer of the content. Must be either 'user' or 'model'. If not set, the service will default to 'user'. }, ], + "continuationToken": "A String", # Optional. An opaque continuation token used to resume generation from a previous `GenerateContent` or `StreamGenerateContent` response that stopped with `finish_reason` set to `CONTINUATION`. "generationConfig": { # Configuration for content generation. This message contains all the parameters that control how the model generates content. It allows you to influence the randomness, length, and structure of the output. # Optional. Generation config. "audioTimestamp": True or False, # Optional. If enabled, audio timestamps will be included in the request to the model. This can be useful for synchronizing audio with other modalities in the response. "audioTranscriptionConfig": { # Configuration for speech recognition (transcription). # Optional. Configuration for audio transcription (speech recognition). @@ -2414,7 +2415,7 @@

Method Details

], "systemInstruction": { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. # Optional. The user provided system instructions for the model. Note: only text should be used in parts and content in each part will be in a separate paragraph. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -2796,7 +2797,7 @@

Method Details

}, "content": { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. # Output only. The content of the candidate. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -2888,6 +2889,7 @@

Method Details

], "role": "A String", # Optional. The producer of the content. Must be either 'user' or 'model'. If not set, the service will default to 'user'. }, + "continuationToken": "A String", # Output only. An optional opaque continuation token returned when `finish_reason` is `CONTINUATION`. Clients can pass this token in a subsequent `GenerateContentRequest` to continue generation. "finishMessage": "A String", # Output only. Describes the reason the model stopped generating tokens in more detail. This field is returned only when `finish_reason` is set. "finishReason": "A String", # Output only. The reason why the model stopped generating tokens. If empty, the model has not stopped generating. "groundingMetadata": { # Information about the sources that support the content of a response. When grounding is enabled, the model returns citations for claims in the response. This object contains the retrieved sources. # Output only. Metadata returned when grounding is enabled. It contains the sources used to ground the generated content. @@ -5006,7 +5008,7 @@

Method Details

"contents": [ # Required. The content of the current conversation with the model. For single-turn queries, this is a single instance. For multi-turn queries, this is a repeated field that contains conversation history + latest request. { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -5099,6 +5101,7 @@

Method Details

"role": "A String", # Optional. The producer of the content. Must be either 'user' or 'model'. If not set, the service will default to 'user'. }, ], + "continuationToken": "A String", # Optional. An opaque continuation token used to resume generation from a previous `GenerateContent` or `StreamGenerateContent` response that stopped with `finish_reason` set to `CONTINUATION`. "generationConfig": { # Configuration for content generation. This message contains all the parameters that control how the model generates content. It allows you to influence the randomness, length, and structure of the output. # Optional. Generation config. "audioTimestamp": True or False, # Optional. If enabled, audio timestamps will be included in the request to the model. This can be useful for synchronizing audio with other modalities in the response. "audioTranscriptionConfig": { # Configuration for speech recognition (transcription). # Optional. Configuration for audio transcription (speech recognition). @@ -5285,7 +5288,7 @@

Method Details

], "systemInstruction": { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. # Optional. The user provided system instructions for the model. Note: only text should be used in parts and content in each part will be in a separate paragraph. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -5667,7 +5670,7 @@

Method Details

}, "content": { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. # Output only. The content of the candidate. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -5759,6 +5762,7 @@

Method Details

], "role": "A String", # Optional. The producer of the content. Must be either 'user' or 'model'. If not set, the service will default to 'user'. }, + "continuationToken": "A String", # Output only. An optional opaque continuation token returned when `finish_reason` is `CONTINUATION`. Clients can pass this token in a subsequent `GenerateContentRequest` to continue generation. "finishMessage": "A String", # Output only. Describes the reason the model stopped generating tokens in more detail. This field is returned only when `finish_reason` is set. "finishReason": "A String", # Output only. The reason why the model stopped generating tokens. If empty, the model has not stopped generating. "groundingMetadata": { # Information about the sources that support the content of a response. When grounding is enabled, the model returns citations for claims in the response. This object contains the retrieved sources. # Output only. Metadata returned when grounding is enabled. It contains the sources used to ground the generated content. diff --git a/docs/dyn/aiplatform_v1beta1.projects.locations.evaluationItems.html b/docs/dyn/aiplatform_v1beta1.projects.locations.evaluationItems.html index e807a2b018..d5d011bb14 100644 --- a/docs/dyn/aiplatform_v1beta1.projects.locations.evaluationItems.html +++ b/docs/dyn/aiplatform_v1beta1.projects.locations.evaluationItems.html @@ -631,7 +631,7 @@

Method Details

"author": "A String", # Required. The ID of the agent or entity that generated this event. Use "user" to denote events generated by the end-user. "content": { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. # Required. The content of the event (e.g., text response, tool call, tool response). "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -747,7 +747,7 @@

Method Details

"events": [ # Optional. Intermediate events (such as tool calls and responses) that led to the final response. { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -1348,7 +1348,7 @@

Method Details

"author": "A String", # Required. The ID of the agent or entity that generated this event. Use "user" to denote events generated by the end-user. "content": { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. # Required. The content of the event (e.g., text response, tool call, tool response). "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -1464,7 +1464,7 @@

Method Details

"events": [ # Optional. Intermediate events (such as tool calls and responses) that led to the final response. { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -2064,7 +2064,7 @@

Method Details

"author": "A String", # Required. The ID of the agent or entity that generated this event. Use "user" to denote events generated by the end-user. "content": { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. # Required. The content of the event (e.g., text response, tool call, tool response). "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -2171,7 +2171,7 @@

Method Details

"values": { # The values for fields in the prompt template. "a_key": { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -2836,7 +2836,7 @@

Method Details

"author": "A String", # Required. The ID of the agent or entity that generated this event. Use "user" to denote events generated by the end-user. "content": { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. # Required. The content of the event (e.g., text response, tool call, tool response). "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -2952,7 +2952,7 @@

Method Details

"events": [ # Optional. Intermediate events (such as tool calls and responses) that led to the final response. { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -3553,7 +3553,7 @@

Method Details

"author": "A String", # Required. The ID of the agent or entity that generated this event. Use "user" to denote events generated by the end-user. "content": { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. # Required. The content of the event (e.g., text response, tool call, tool response). "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -3669,7 +3669,7 @@

Method Details

"events": [ # Optional. Intermediate events (such as tool calls and responses) that led to the final response. { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -4269,7 +4269,7 @@

Method Details

"author": "A String", # Required. The ID of the agent or entity that generated this event. Use "user" to denote events generated by the end-user. "content": { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. # Required. The content of the event (e.g., text response, tool call, tool response). "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -4376,7 +4376,7 @@

Method Details

"values": { # The values for fields in the prompt template. "a_key": { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -5032,7 +5032,7 @@

Method Details

"author": "A String", # Required. The ID of the agent or entity that generated this event. Use "user" to denote events generated by the end-user. "content": { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. # Required. The content of the event (e.g., text response, tool call, tool response). "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -5148,7 +5148,7 @@

Method Details

"events": [ # Optional. Intermediate events (such as tool calls and responses) that led to the final response. { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -5749,7 +5749,7 @@

Method Details

"author": "A String", # Required. The ID of the agent or entity that generated this event. Use "user" to denote events generated by the end-user. "content": { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. # Required. The content of the event (e.g., text response, tool call, tool response). "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -5865,7 +5865,7 @@

Method Details

"events": [ # Optional. Intermediate events (such as tool calls and responses) that led to the final response. { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -6465,7 +6465,7 @@

Method Details

"author": "A String", # Required. The ID of the agent or entity that generated this event. Use "user" to denote events generated by the end-user. "content": { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. # Required. The content of the event (e.g., text response, tool call, tool response). "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -6572,7 +6572,7 @@

Method Details

"values": { # The values for fields in the prompt template. "a_key": { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -7237,7 +7237,7 @@

Method Details

"author": "A String", # Required. The ID of the agent or entity that generated this event. Use "user" to denote events generated by the end-user. "content": { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. # Required. The content of the event (e.g., text response, tool call, tool response). "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -7353,7 +7353,7 @@

Method Details

"events": [ # Optional. Intermediate events (such as tool calls and responses) that led to the final response. { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -7954,7 +7954,7 @@

Method Details

"author": "A String", # Required. The ID of the agent or entity that generated this event. Use "user" to denote events generated by the end-user. "content": { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. # Required. The content of the event (e.g., text response, tool call, tool response). "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -8070,7 +8070,7 @@

Method Details

"events": [ # Optional. Intermediate events (such as tool calls and responses) that led to the final response. { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -8670,7 +8670,7 @@

Method Details

"author": "A String", # Required. The ID of the agent or entity that generated this event. Use "user" to denote events generated by the end-user. "content": { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. # Required. The content of the event (e.g., text response, tool call, tool response). "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -8777,7 +8777,7 @@

Method Details

"values": { # The values for fields in the prompt template. "a_key": { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -9475,7 +9475,7 @@

Method Details

"author": "A String", # Required. The ID of the agent or entity that generated this event. Use "user" to denote events generated by the end-user. "content": { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. # Required. The content of the event (e.g., text response, tool call, tool response). "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -9591,7 +9591,7 @@

Method Details

"events": [ # Optional. Intermediate events (such as tool calls and responses) that led to the final response. { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -10192,7 +10192,7 @@

Method Details

"author": "A String", # Required. The ID of the agent or entity that generated this event. Use "user" to denote events generated by the end-user. "content": { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. # Required. The content of the event (e.g., text response, tool call, tool response). "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -10308,7 +10308,7 @@

Method Details

"events": [ # Optional. Intermediate events (such as tool calls and responses) that led to the final response. { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -10908,7 +10908,7 @@

Method Details

"author": "A String", # Required. The ID of the agent or entity that generated this event. Use "user" to denote events generated by the end-user. "content": { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. # Required. The content of the event (e.g., text response, tool call, tool response). "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -11015,7 +11015,7 @@

Method Details

"values": { # The values for fields in the prompt template. "a_key": { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -11680,7 +11680,7 @@

Method Details

"author": "A String", # Required. The ID of the agent or entity that generated this event. Use "user" to denote events generated by the end-user. "content": { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. # Required. The content of the event (e.g., text response, tool call, tool response). "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -11796,7 +11796,7 @@

Method Details

"events": [ # Optional. Intermediate events (such as tool calls and responses) that led to the final response. { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -12397,7 +12397,7 @@

Method Details

"author": "A String", # Required. The ID of the agent or entity that generated this event. Use "user" to denote events generated by the end-user. "content": { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. # Required. The content of the event (e.g., text response, tool call, tool response). "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -12513,7 +12513,7 @@

Method Details

"events": [ # Optional. Intermediate events (such as tool calls and responses) that led to the final response. { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -13113,7 +13113,7 @@

Method Details

"author": "A String", # Required. The ID of the agent or entity that generated this event. Use "user" to denote events generated by the end-user. "content": { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. # Required. The content of the event (e.g., text response, tool call, tool response). "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -13220,7 +13220,7 @@

Method Details

"values": { # The values for fields in the prompt template. "a_key": { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -13889,7 +13889,7 @@

Method Details

"author": "A String", # Required. The ID of the agent or entity that generated this event. Use "user" to denote events generated by the end-user. "content": { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. # Required. The content of the event (e.g., text response, tool call, tool response). "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -14005,7 +14005,7 @@

Method Details

"events": [ # Optional. Intermediate events (such as tool calls and responses) that led to the final response. { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -14606,7 +14606,7 @@

Method Details

"author": "A String", # Required. The ID of the agent or entity that generated this event. Use "user" to denote events generated by the end-user. "content": { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. # Required. The content of the event (e.g., text response, tool call, tool response). "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -14722,7 +14722,7 @@

Method Details

"events": [ # Optional. Intermediate events (such as tool calls and responses) that led to the final response. { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -15322,7 +15322,7 @@

Method Details

"author": "A String", # Required. The ID of the agent or entity that generated this event. Use "user" to denote events generated by the end-user. "content": { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. # Required. The content of the event (e.g., text response, tool call, tool response). "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -15429,7 +15429,7 @@

Method Details

"values": { # The values for fields in the prompt template. "a_key": { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -16094,7 +16094,7 @@

Method Details

"author": "A String", # Required. The ID of the agent or entity that generated this event. Use "user" to denote events generated by the end-user. "content": { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. # Required. The content of the event (e.g., text response, tool call, tool response). "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -16210,7 +16210,7 @@

Method Details

"events": [ # Optional. Intermediate events (such as tool calls and responses) that led to the final response. { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -16811,7 +16811,7 @@

Method Details

"author": "A String", # Required. The ID of the agent or entity that generated this event. Use "user" to denote events generated by the end-user. "content": { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. # Required. The content of the event (e.g., text response, tool call, tool response). "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -16927,7 +16927,7 @@

Method Details

"events": [ # Optional. Intermediate events (such as tool calls and responses) that led to the final response. { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -17527,7 +17527,7 @@

Method Details

"author": "A String", # Required. The ID of the agent or entity that generated this event. Use "user" to denote events generated by the end-user. "content": { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. # Required. The content of the event (e.g., text response, tool call, tool response). "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -17634,7 +17634,7 @@

Method Details

"values": { # The values for fields in the prompt template. "a_key": { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. diff --git a/docs/dyn/aiplatform_v1beta1.projects.locations.evaluationRuns.html b/docs/dyn/aiplatform_v1beta1.projects.locations.evaluationRuns.html index 11fd783610..d93675df32 100644 --- a/docs/dyn/aiplatform_v1beta1.projects.locations.evaluationRuns.html +++ b/docs/dyn/aiplatform_v1beta1.projects.locations.evaluationRuns.html @@ -3214,7 +3214,7 @@

Method Details

"author": "A String", # Required. The ID of the agent or entity that generated this event. Use "user" to denote events generated by the end-user. "content": { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. # Required. The content of the event (e.g., text response, tool call, tool response). "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -3330,7 +3330,7 @@

Method Details

"events": [ # Optional. Intermediate events (such as tool calls and responses) that led to the final response. { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -3931,7 +3931,7 @@

Method Details

"author": "A String", # Required. The ID of the agent or entity that generated this event. Use "user" to denote events generated by the end-user. "content": { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. # Required. The content of the event (e.g., text response, tool call, tool response). "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -4047,7 +4047,7 @@

Method Details

"events": [ # Optional. Intermediate events (such as tool calls and responses) that led to the final response. { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -4647,7 +4647,7 @@

Method Details

"author": "A String", # Required. The ID of the agent or entity that generated this event. Use "user" to denote events generated by the end-user. "content": { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. # Required. The content of the event (e.g., text response, tool call, tool response). "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -4754,7 +4754,7 @@

Method Details

"values": { # The values for fields in the prompt template. "a_key": { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -4911,7 +4911,7 @@

Method Details

"agentConfig": { # Configuration that describes an agent. # Optional. Deprecated: Use `agents` instead. Agent config used to generate responses. "developerInstruction": { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. # Optional. The developer instruction for the agent. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -8960,7 +8960,7 @@

Method Details

"author": "A String", # Required. The ID of the agent or entity that generated this event. Use "user" to denote events generated by the end-user. "content": { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. # Required. The content of the event (e.g., text response, tool call, tool response). "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -9076,7 +9076,7 @@

Method Details

"events": [ # Optional. Intermediate events (such as tool calls and responses) that led to the final response. { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -9677,7 +9677,7 @@

Method Details

"author": "A String", # Required. The ID of the agent or entity that generated this event. Use "user" to denote events generated by the end-user. "content": { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. # Required. The content of the event (e.g., text response, tool call, tool response). "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -9793,7 +9793,7 @@

Method Details

"events": [ # Optional. Intermediate events (such as tool calls and responses) that led to the final response. { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -10393,7 +10393,7 @@

Method Details

"author": "A String", # Required. The ID of the agent or entity that generated this event. Use "user" to denote events generated by the end-user. "content": { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. # Required. The content of the event (e.g., text response, tool call, tool response). "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -10500,7 +10500,7 @@

Method Details

"values": { # The values for fields in the prompt template. "a_key": { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -10657,7 +10657,7 @@

Method Details

"agentConfig": { # Configuration that describes an agent. # Optional. Deprecated: Use `agents` instead. Agent config used to generate responses. "developerInstruction": { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. # Optional. The developer instruction for the agent. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -14748,7 +14748,7 @@

Method Details

"author": "A String", # Required. The ID of the agent or entity that generated this event. Use "user" to denote events generated by the end-user. "content": { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. # Required. The content of the event (e.g., text response, tool call, tool response). "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -14864,7 +14864,7 @@

Method Details

"events": [ # Optional. Intermediate events (such as tool calls and responses) that led to the final response. { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -15465,7 +15465,7 @@

Method Details

"author": "A String", # Required. The ID of the agent or entity that generated this event. Use "user" to denote events generated by the end-user. "content": { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. # Required. The content of the event (e.g., text response, tool call, tool response). "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -15581,7 +15581,7 @@

Method Details

"events": [ # Optional. Intermediate events (such as tool calls and responses) that led to the final response. { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -16181,7 +16181,7 @@

Method Details

"author": "A String", # Required. The ID of the agent or entity that generated this event. Use "user" to denote events generated by the end-user. "content": { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. # Required. The content of the event (e.g., text response, tool call, tool response). "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -16288,7 +16288,7 @@

Method Details

"values": { # The values for fields in the prompt template. "a_key": { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -16445,7 +16445,7 @@

Method Details

"agentConfig": { # Configuration that describes an agent. # Optional. Deprecated: Use `agents` instead. Agent config used to generate responses. "developerInstruction": { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. # Optional. The developer instruction for the agent. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -20507,7 +20507,7 @@

Method Details

"author": "A String", # Required. The ID of the agent or entity that generated this event. Use "user" to denote events generated by the end-user. "content": { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. # Required. The content of the event (e.g., text response, tool call, tool response). "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -20623,7 +20623,7 @@

Method Details

"events": [ # Optional. Intermediate events (such as tool calls and responses) that led to the final response. { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -21224,7 +21224,7 @@

Method Details

"author": "A String", # Required. The ID of the agent or entity that generated this event. Use "user" to denote events generated by the end-user. "content": { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. # Required. The content of the event (e.g., text response, tool call, tool response). "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -21340,7 +21340,7 @@

Method Details

"events": [ # Optional. Intermediate events (such as tool calls and responses) that led to the final response. { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -21940,7 +21940,7 @@

Method Details

"author": "A String", # Required. The ID of the agent or entity that generated this event. Use "user" to denote events generated by the end-user. "content": { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. # Required. The content of the event (e.g., text response, tool call, tool response). "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -22047,7 +22047,7 @@

Method Details

"values": { # The values for fields in the prompt template. "a_key": { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -22204,7 +22204,7 @@

Method Details

"agentConfig": { # Configuration that describes an agent. # Optional. Deprecated: Use `agents` instead. Agent config used to generate responses. "developerInstruction": { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. # Optional. The developer instruction for the agent. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. diff --git a/docs/dyn/aiplatform_v1beta1.projects.locations.exampleStores.html b/docs/dyn/aiplatform_v1beta1.projects.locations.exampleStores.html index 9da8ff94ba..656fde77c4 100644 --- a/docs/dyn/aiplatform_v1beta1.projects.locations.exampleStores.html +++ b/docs/dyn/aiplatform_v1beta1.projects.locations.exampleStores.html @@ -244,7 +244,7 @@

Method Details

"contents": [ # Required. The content of the conversation with the model that resulted in the expected output. { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -341,7 +341,7 @@

Method Details

{ # A single step of the expected output. "content": { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. # Required. A single step's content. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -642,7 +642,7 @@

Method Details

"contents": [ # Required. The conversation for generating a search key. { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -771,7 +771,7 @@

Method Details

"contents": [ # Required. The content of the conversation with the model that resulted in the expected output. { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -868,7 +868,7 @@

Method Details

{ # A single step of the expected output. "content": { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. # Required. A single step's content. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -996,7 +996,7 @@

Method Details

"contents": [ # Required. The content of the conversation with the model that resulted in the expected output. { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -1093,7 +1093,7 @@

Method Details

{ # A single step of the expected output. "content": { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. # Required. A single step's content. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -1219,7 +1219,7 @@

Method Details

"contents": [ # Required. The content of the conversation with the model that resulted in the expected output. { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -1316,7 +1316,7 @@

Method Details

{ # A single step of the expected output. "content": { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. # Required. A single step's content. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. diff --git a/docs/dyn/aiplatform_v1beta1.projects.locations.extensions.html b/docs/dyn/aiplatform_v1beta1.projects.locations.extensions.html index daa1a7a932..590cbdfaa1 100644 --- a/docs/dyn/aiplatform_v1beta1.projects.locations.extensions.html +++ b/docs/dyn/aiplatform_v1beta1.projects.locations.extensions.html @@ -1152,7 +1152,7 @@

Method Details

"contents": [ # Required. The content of the current conversation with the model. For single-turn queries, this is a single instance. For multi-turn queries, this is a repeated field that contains conversation history + latest request. { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -1260,7 +1260,7 @@

Method Details

"steps": [ # Steps of extension or LLM interaction, can contain function call, function response, or text response. The last step contains the final response to the query. { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. diff --git a/docs/dyn/aiplatform_v1beta1.projects.locations.html b/docs/dyn/aiplatform_v1beta1.projects.locations.html index d89ddb43b4..b930541798 100644 --- a/docs/dyn/aiplatform_v1beta1.projects.locations.html +++ b/docs/dyn/aiplatform_v1beta1.projects.locations.html @@ -1077,7 +1077,7 @@

Method Details

"contents": [ # Optional. Input content to augment, only text format is supported for now. { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -1223,7 +1223,7 @@

Method Details

"augmentedPrompt": [ # Augmented prompt, only text format is supported for now. { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -1355,7 +1355,7 @@

Method Details

{ # Request message for CorroborateContent. "content": { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. # Optional. Input content to corroborate, only text format is supported for now. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -1591,7 +1591,7 @@

Method Details

"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). + "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). At most 200 environment variables can be specified. Each variable (`NAME=value`) must be smaller than 128 KiB, and the total size of all variables must not exceed 512 KiB. { # 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. @@ -3119,7 +3119,7 @@

Method Details

"contents": [ # Optional. Repeated contents. { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -3474,7 +3474,7 @@

Method Details

"contents": [ # Optional. Repeated contents. { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -3825,7 +3825,7 @@

Method Details

"contents": [ # Optional. Repeated contents. { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -3925,7 +3925,7 @@

Method Details

"event": [ # Optional. A list of events. { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -4513,7 +4513,7 @@

Method Details

"author": "A String", # Required. The ID of the agent or entity that generated this event. "content": { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. # Required. The content of the event (e.g., text response, tool call, tool response). "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -5119,7 +5119,7 @@

Method Details

"author": "A String", # Required. The ID of the agent or entity that generated this event. Use "user" to denote events generated by the end-user. "content": { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. # Required. The content of the event (e.g., text response, tool call, tool response). "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -5235,7 +5235,7 @@

Method Details

"contents": [ # Optional. Repeated contents. { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -5338,7 +5338,7 @@

Method Details

"contents": [ # Optional. Repeated contents. { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -5439,7 +5439,7 @@

Method Details

"contents": [ # Optional. Repeated contents. { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -5540,7 +5540,7 @@

Method Details

"contents": [ # Optional. Repeated contents. { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -7263,7 +7263,7 @@

Method Details

"contents": [ # Optional. Repeated contents. { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -7405,7 +7405,7 @@

Method Details

"contents": [ # Optional. Repeated contents. { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -8063,7 +8063,7 @@

Method Details

"contents": [ # Optional. Repeated contents. { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -8411,7 +8411,7 @@

Method Details

"contents": [ # Required. The prompt to generate rubrics from. For single-turn queries, this is a single instance. For multi-turn queries, this is a repeated field that contains conversation history + latest request. { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -9461,7 +9461,7 @@

Method Details

"author": "A String", # Required. The ID of the agent or entity that generated this event. Use "user" to denote events generated by the end-user. "content": { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. # Required. The content of the event (e.g., text response, tool call, tool response). "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -9577,7 +9577,7 @@

Method Details

"events": [ # Optional. Intermediate events (such as tool calls and responses) that led to the final response. { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -10178,7 +10178,7 @@

Method Details

"author": "A String", # Required. The ID of the agent or entity that generated this event. Use "user" to denote events generated by the end-user. "content": { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. # Required. The content of the event (e.g., text response, tool call, tool response). "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -10294,7 +10294,7 @@

Method Details

"events": [ # Optional. Intermediate events (such as tool calls and responses) that led to the final response. { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -10894,7 +10894,7 @@

Method Details

"author": "A String", # Required. The ID of the agent or entity that generated this event. Use "user" to denote events generated by the end-user. "content": { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. # Required. The content of the event (e.g., text response, tool call, tool response). "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -11001,7 +11001,7 @@

Method Details

"values": { # The values for fields in the prompt template. "a_key": { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -11172,7 +11172,7 @@

Method Details

{ # Represents a single named field within a synthetic example, consisting of a name and the actual content. "content": { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. # Required. The actual content or value for this field. This can be text, images, or other types of data. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -11296,7 +11296,7 @@

Method Details

{ # Represents a single named field within a synthetic example, consisting of a name and the actual content. "content": { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. # Required. The actual content or value for this field. This can be text, images, or other types of data. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -11883,7 +11883,7 @@

Method Details

"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). + "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). At most 200 environment variables can be specified. Each variable (`NAME=value`) must be smaller than 128 KiB, and the total size of all variables must not exceed 512 KiB. { # 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. @@ -12031,7 +12031,7 @@

Method Details

"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). + "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). At most 200 environment variables can be specified. Each variable (`NAME=value`) must be smaller than 128 KiB, and the total size of all variables must not exceed 512 KiB. { # 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. diff --git a/docs/dyn/aiplatform_v1beta1.projects.locations.interactions.html b/docs/dyn/aiplatform_v1beta1.projects.locations.interactions.html index a42f1a350c..13235c71fe 100644 --- a/docs/dyn/aiplatform_v1beta1.projects.locations.interactions.html +++ b/docs/dyn/aiplatform_v1beta1.projects.locations.interactions.html @@ -176,7 +176,9 @@

Method Details

{ # Citation information for model-generated content. "endIndex": 42, # End of the attributed segment, exclusive. "fileCitation": { # A file citation annotation. # A file citation annotation. - "customMetadata": # Object with schema name: GenaiVertexV1beta1Struct # User provided metadata about the retrieved context. + "customMetadata": { # User provided metadata about the retrieved context. + "a_key": "", # Properties of the object. + }, "documentUri": "A String", # The URI of the file. "fileName": "A String", # The name of the file. "mediaId": "A String", # Media ID in-case of image citations, if applicable. @@ -269,7 +271,9 @@

Method Details

{ # Citation information for model-generated content. "endIndex": 42, # End of the attributed segment, exclusive. "fileCitation": { # A file citation annotation. # A file citation annotation. - "customMetadata": # Object with schema name: GenaiVertexV1beta1Struct # User provided metadata about the retrieved context. + "customMetadata": { # User provided metadata about the retrieved context. + "a_key": "", # Properties of the object. + }, "documentUri": "A String", # The URI of the file. "fileName": "A String", # The name of the file. "mediaId": "A String", # Media ID in-case of image citations, if applicable. @@ -323,6 +327,7 @@

Method Details

"uri": "A String", # The URI of the video. }, }, + "continuationToken": "A String", # Opaque token to resume a long decode. Output: set when status is INCOMPLETE and decoding can be resumed. Input: pass the latest token back unchanged in CreateInteraction to continue decoding. "created": "A String", # Required. Output only. The time at which the response was created in ISO 8601 format (YYYY-MM-DDThh:mm:ssZ). "envId": "A String", # The environment ID for the interaction. Can be 'remote' for default environment. "environmentId": "A String", # Output only. The environment ID for the interaction. Only populated if environment config is set in the request. @@ -396,9 +401,10 @@

Method Details

"remoteEnvironment": { # Configuration for a custom environment. "environmentId": "A String", # Optional. The environment ID for the interaction. If specified, the request will update the existing environment instead of creating a new one. "networkAllowlist": { # Network egress configuration for the environment. # Allow only specific domains. - "allowlist": [ # List of allowed domains and their configurations. + "allowlist": [ # List of allowed domains and their configurations. Set to `"disabled"` to block all network egress. { # A single domain allowlist rule with optional header injection. "domain": "A String", # Domain to allow outbound requests to. Supports wildcards (e.g. '*.googleapis.com'). Use '*' to allow all domains. + "mode": "A String", # Network egress mode. Set via the `"allowlist": "disabled"` short form; must be the only rule in the allowlist and cannot be combined with `domain`, `transform` or `credential`. "transform": { # Headers to inject into requests matching this rule. Key: header name (e.g., "Authorization"). Value: header value (e.g., "Bearer your-token"). "a_key": "A String", }, @@ -461,7 +467,9 @@

Method Details

{ # Citation information for model-generated content. "endIndex": 42, # End of the attributed segment, exclusive. "fileCitation": { # A file citation annotation. # A file citation annotation. - "customMetadata": # Object with schema name: GenaiVertexV1beta1Struct # User provided metadata about the retrieved context. + "customMetadata": { # User provided metadata about the retrieved context. + "a_key": "", # Properties of the object. + }, "documentUri": "A String", # The URI of the file. "fileName": "A String", # The name of the file. "mediaId": "A String", # Media ID in-case of image citations, if applicable. @@ -560,7 +568,9 @@

Method Details

{ # Citation information for model-generated content. "endIndex": 42, # End of the attributed segment, exclusive. "fileCitation": { # A file citation annotation. # A file citation annotation. - "customMetadata": # Object with schema name: GenaiVertexV1beta1Struct # User provided metadata about the retrieved context. + "customMetadata": { # User provided metadata about the retrieved context. + "a_key": "", # Properties of the object. + }, "documentUri": "A String", # The URI of the file. "fileName": "A String", # The name of the file. "mediaId": "A String", # Media ID in-case of image citations, if applicable. @@ -681,7 +691,9 @@

Method Details

{ # Citation information for model-generated content. "endIndex": 42, # End of the attributed segment, exclusive. "fileCitation": { # A file citation annotation. # A file citation annotation. - "customMetadata": # Object with schema name: GenaiVertexV1beta1Struct # User provided metadata about the retrieved context. + "customMetadata": { # User provided metadata about the retrieved context. + "a_key": "", # Properties of the object. + }, "documentUri": "A String", # The URI of the file. "fileName": "A String", # The name of the file. "mediaId": "A String", # Media ID in-case of image citations, if applicable. @@ -780,7 +792,9 @@

Method Details

{ # Citation information for model-generated content. "endIndex": 42, # End of the attributed segment, exclusive. "fileCitation": { # A file citation annotation. # A file citation annotation. - "customMetadata": # Object with schema name: GenaiVertexV1beta1Struct # User provided metadata about the retrieved context. + "customMetadata": { # User provided metadata about the retrieved context. + "a_key": "", # Properties of the object. + }, "documentUri": "A String", # The URI of the file. "fileName": "A String", # The name of the file. "mediaId": "A String", # Media ID in-case of image citations, if applicable. @@ -898,7 +912,9 @@

Method Details

{ # Citation information for model-generated content. "endIndex": 42, # End of the attributed segment, exclusive. "fileCitation": { # A file citation annotation. # A file citation annotation. - "customMetadata": # Object with schema name: GenaiVertexV1beta1Struct # User provided metadata about the retrieved context. + "customMetadata": { # User provided metadata about the retrieved context. + "a_key": "", # Properties of the object. + }, "documentUri": "A String", # The URI of the file. "fileName": "A String", # The name of the file. "mediaId": "A String", # Media ID in-case of image citations, if applicable. @@ -990,7 +1006,9 @@

Method Details

{ # Citation information for model-generated content. "endIndex": 42, # End of the attributed segment, exclusive. "fileCitation": { # A file citation annotation. # A file citation annotation. - "customMetadata": # Object with schema name: GenaiVertexV1beta1Struct # User provided metadata about the retrieved context. + "customMetadata": { # User provided metadata about the retrieved context. + "a_key": "", # Properties of the object. + }, "documentUri": "A String", # The URI of the file. "fileName": "A String", # The name of the file. "mediaId": "A String", # Media ID in-case of image citations, if applicable. @@ -1086,7 +1104,9 @@

Method Details

{ # Citation information for model-generated content. "endIndex": 42, # End of the attributed segment, exclusive. "fileCitation": { # A file citation annotation. # A file citation annotation. - "customMetadata": # Object with schema name: GenaiVertexV1beta1Struct # User provided metadata about the retrieved context. + "customMetadata": { # User provided metadata about the retrieved context. + "a_key": "", # Properties of the object. + }, "documentUri": "A String", # The URI of the file. "fileName": "A String", # The name of the file. "mediaId": "A String", # Media ID in-case of image citations, if applicable. @@ -1202,7 +1222,9 @@

Method Details

{ # Citation information for model-generated content. "endIndex": 42, # End of the attributed segment, exclusive. "fileCitation": { # A file citation annotation. # A file citation annotation. - "customMetadata": # Object with schema name: GenaiVertexV1beta1Struct # User provided metadata about the retrieved context. + "customMetadata": { # User provided metadata about the retrieved context. + "a_key": "", # Properties of the object. + }, "documentUri": "A String", # The URI of the file. "fileName": "A String", # The name of the file. "mediaId": "A String", # Media ID in-case of image citations, if applicable. @@ -1328,7 +1350,9 @@

Method Details

{ # Citation information for model-generated content. "endIndex": 42, # End of the attributed segment, exclusive. "fileCitation": { # A file citation annotation. # A file citation annotation. - "customMetadata": # Object with schema name: GenaiVertexV1beta1Struct # User provided metadata about the retrieved context. + "customMetadata": { # User provided metadata about the retrieved context. + "a_key": "", # Properties of the object. + }, "documentUri": "A String", # The URI of the file. "fileName": "A String", # The name of the file. "mediaId": "A String", # Media ID in-case of image citations, if applicable. @@ -1450,7 +1474,9 @@

Method Details

{ # Citation information for model-generated content. "endIndex": 42, # End of the attributed segment, exclusive. "fileCitation": { # A file citation annotation. # A file citation annotation. - "customMetadata": # Object with schema name: GenaiVertexV1beta1Struct # User provided metadata about the retrieved context. + "customMetadata": { # User provided metadata about the retrieved context. + "a_key": "", # Properties of the object. + }, "documentUri": "A String", # The URI of the file. "fileName": "A String", # The name of the file. "mediaId": "A String", # Media ID in-case of image citations, if applicable. @@ -1559,7 +1585,9 @@

Method Details

{ # Citation information for model-generated content. "endIndex": 42, # End of the attributed segment, exclusive. "fileCitation": { # A file citation annotation. # A file citation annotation. - "customMetadata": # Object with schema name: GenaiVertexV1beta1Struct # User provided metadata about the retrieved context. + "customMetadata": { # User provided metadata about the retrieved context. + "a_key": "", # Properties of the object. + }, "documentUri": "A String", # The URI of the file. "fileName": "A String", # The name of the file. "mediaId": "A String", # Media ID in-case of image citations, if applicable. @@ -1648,7 +1676,9 @@

Method Details

{ # Citation information for model-generated content. "endIndex": 42, # End of the attributed segment, exclusive. "fileCitation": { # A file citation annotation. # A file citation annotation. - "customMetadata": # Object with schema name: GenaiVertexV1beta1Struct # User provided metadata about the retrieved context. + "customMetadata": { # User provided metadata about the retrieved context. + "a_key": "", # Properties of the object. + }, "documentUri": "A String", # The URI of the file. "fileName": "A String", # The name of the file. "mediaId": "A String", # Media ID in-case of image citations, if applicable. @@ -1740,7 +1770,9 @@

Method Details

{ # Citation information for model-generated content. "endIndex": 42, # End of the attributed segment, exclusive. "fileCitation": { # A file citation annotation. # A file citation annotation. - "customMetadata": # Object with schema name: GenaiVertexV1beta1Struct # User provided metadata about the retrieved context. + "customMetadata": { # User provided metadata about the retrieved context. + "a_key": "", # Properties of the object. + }, "documentUri": "A String", # The URI of the file. "fileName": "A String", # The name of the file. "mediaId": "A String", # Media ID in-case of image citations, if applicable. @@ -1836,7 +1868,9 @@

Method Details

{ # Citation information for model-generated content. "endIndex": 42, # End of the attributed segment, exclusive. "fileCitation": { # A file citation annotation. # A file citation annotation. - "customMetadata": # Object with schema name: GenaiVertexV1beta1Struct # User provided metadata about the retrieved context. + "customMetadata": { # User provided metadata about the retrieved context. + "a_key": "", # Properties of the object. + }, "documentUri": "A String", # The URI of the file. "fileName": "A String", # The name of the file. "mediaId": "A String", # Media ID in-case of image citations, if applicable. @@ -1952,7 +1986,9 @@

Method Details

{ # Citation information for model-generated content. "endIndex": 42, # End of the attributed segment, exclusive. "fileCitation": { # A file citation annotation. # A file citation annotation. - "customMetadata": # Object with schema name: GenaiVertexV1beta1Struct # User provided metadata about the retrieved context. + "customMetadata": { # User provided metadata about the retrieved context. + "a_key": "", # Properties of the object. + }, "documentUri": "A String", # The URI of the file. "fileName": "A String", # The name of the file. "mediaId": "A String", # Media ID in-case of image citations, if applicable. @@ -2078,7 +2114,9 @@

Method Details

{ # Citation information for model-generated content. "endIndex": 42, # End of the attributed segment, exclusive. "fileCitation": { # A file citation annotation. # A file citation annotation. - "customMetadata": # Object with schema name: GenaiVertexV1beta1Struct # User provided metadata about the retrieved context. + "customMetadata": { # User provided metadata about the retrieved context. + "a_key": "", # Properties of the object. + }, "documentUri": "A String", # The URI of the file. "fileName": "A String", # The name of the file. "mediaId": "A String", # Media ID in-case of image citations, if applicable. @@ -2200,7 +2238,9 @@

Method Details

{ # Citation information for model-generated content. "endIndex": 42, # End of the attributed segment, exclusive. "fileCitation": { # A file citation annotation. # A file citation annotation. - "customMetadata": # Object with schema name: GenaiVertexV1beta1Struct # User provided metadata about the retrieved context. + "customMetadata": { # User provided metadata about the retrieved context. + "a_key": "", # Properties of the object. + }, "documentUri": "A String", # The URI of the file. "fileName": "A String", # The name of the file. "mediaId": "A String", # Media ID in-case of image citations, if applicable. @@ -2309,7 +2349,9 @@

Method Details

{ # Citation information for model-generated content. "endIndex": 42, # End of the attributed segment, exclusive. "fileCitation": { # A file citation annotation. # A file citation annotation. - "customMetadata": # Object with schema name: GenaiVertexV1beta1Struct # User provided metadata about the retrieved context. + "customMetadata": { # User provided metadata about the retrieved context. + "a_key": "", # Properties of the object. + }, "documentUri": "A String", # The URI of the file. "fileName": "A String", # The name of the file. "mediaId": "A String", # Media ID in-case of image citations, if applicable. @@ -2421,7 +2463,9 @@

Method Details

{ # Citation information for model-generated content. "endIndex": 42, # End of the attributed segment, exclusive. "fileCitation": { # A file citation annotation. # A file citation annotation. - "customMetadata": # Object with schema name: GenaiVertexV1beta1Struct # User provided metadata about the retrieved context. + "customMetadata": { # User provided metadata about the retrieved context. + "a_key": "", # Properties of the object. + }, "documentUri": "A String", # The URI of the file. "fileName": "A String", # The name of the file. "mediaId": "A String", # Media ID in-case of image citations, if applicable. @@ -2690,7 +2734,9 @@

Method Details

{ # Citation information for model-generated content. "endIndex": 42, # End of the attributed segment, exclusive. "fileCitation": { # A file citation annotation. # A file citation annotation. - "customMetadata": # Object with schema name: GenaiVertexV1beta1Struct # User provided metadata about the retrieved context. + "customMetadata": { # User provided metadata about the retrieved context. + "a_key": "", # Properties of the object. + }, "documentUri": "A String", # The URI of the file. "fileName": "A String", # The name of the file. "mediaId": "A String", # Media ID in-case of image citations, if applicable. @@ -2783,7 +2829,9 @@

Method Details

{ # Citation information for model-generated content. "endIndex": 42, # End of the attributed segment, exclusive. "fileCitation": { # A file citation annotation. # A file citation annotation. - "customMetadata": # Object with schema name: GenaiVertexV1beta1Struct # User provided metadata about the retrieved context. + "customMetadata": { # User provided metadata about the retrieved context. + "a_key": "", # Properties of the object. + }, "documentUri": "A String", # The URI of the file. "fileName": "A String", # The name of the file. "mediaId": "A String", # Media ID in-case of image citations, if applicable. @@ -2837,6 +2885,7 @@

Method Details

"uri": "A String", # The URI of the video. }, }, + "continuationToken": "A String", # Opaque token to resume a long decode. Output: set when status is INCOMPLETE and decoding can be resumed. Input: pass the latest token back unchanged in CreateInteraction to continue decoding. "created": "A String", # Required. Output only. The time at which the response was created in ISO 8601 format (YYYY-MM-DDThh:mm:ssZ). "envId": "A String", # The environment ID for the interaction. Can be 'remote' for default environment. "environmentId": "A String", # Output only. The environment ID for the interaction. Only populated if environment config is set in the request. @@ -2910,9 +2959,10 @@

Method Details

"remoteEnvironment": { # Configuration for a custom environment. "environmentId": "A String", # Optional. The environment ID for the interaction. If specified, the request will update the existing environment instead of creating a new one. "networkAllowlist": { # Network egress configuration for the environment. # Allow only specific domains. - "allowlist": [ # List of allowed domains and their configurations. + "allowlist": [ # List of allowed domains and their configurations. Set to `"disabled"` to block all network egress. { # A single domain allowlist rule with optional header injection. "domain": "A String", # Domain to allow outbound requests to. Supports wildcards (e.g. '*.googleapis.com'). Use '*' to allow all domains. + "mode": "A String", # Network egress mode. Set via the `"allowlist": "disabled"` short form; must be the only rule in the allowlist and cannot be combined with `domain`, `transform` or `credential`. "transform": { # Headers to inject into requests matching this rule. Key: header name (e.g., "Authorization"). Value: header value (e.g., "Bearer your-token"). "a_key": "A String", }, @@ -2975,7 +3025,9 @@

Method Details

{ # Citation information for model-generated content. "endIndex": 42, # End of the attributed segment, exclusive. "fileCitation": { # A file citation annotation. # A file citation annotation. - "customMetadata": # Object with schema name: GenaiVertexV1beta1Struct # User provided metadata about the retrieved context. + "customMetadata": { # User provided metadata about the retrieved context. + "a_key": "", # Properties of the object. + }, "documentUri": "A String", # The URI of the file. "fileName": "A String", # The name of the file. "mediaId": "A String", # Media ID in-case of image citations, if applicable. @@ -3074,7 +3126,9 @@

Method Details

{ # Citation information for model-generated content. "endIndex": 42, # End of the attributed segment, exclusive. "fileCitation": { # A file citation annotation. # A file citation annotation. - "customMetadata": # Object with schema name: GenaiVertexV1beta1Struct # User provided metadata about the retrieved context. + "customMetadata": { # User provided metadata about the retrieved context. + "a_key": "", # Properties of the object. + }, "documentUri": "A String", # The URI of the file. "fileName": "A String", # The name of the file. "mediaId": "A String", # Media ID in-case of image citations, if applicable. @@ -3195,7 +3249,9 @@

Method Details

{ # Citation information for model-generated content. "endIndex": 42, # End of the attributed segment, exclusive. "fileCitation": { # A file citation annotation. # A file citation annotation. - "customMetadata": # Object with schema name: GenaiVertexV1beta1Struct # User provided metadata about the retrieved context. + "customMetadata": { # User provided metadata about the retrieved context. + "a_key": "", # Properties of the object. + }, "documentUri": "A String", # The URI of the file. "fileName": "A String", # The name of the file. "mediaId": "A String", # Media ID in-case of image citations, if applicable. @@ -3294,7 +3350,9 @@

Method Details

{ # Citation information for model-generated content. "endIndex": 42, # End of the attributed segment, exclusive. "fileCitation": { # A file citation annotation. # A file citation annotation. - "customMetadata": # Object with schema name: GenaiVertexV1beta1Struct # User provided metadata about the retrieved context. + "customMetadata": { # User provided metadata about the retrieved context. + "a_key": "", # Properties of the object. + }, "documentUri": "A String", # The URI of the file. "fileName": "A String", # The name of the file. "mediaId": "A String", # Media ID in-case of image citations, if applicable. @@ -3412,7 +3470,9 @@

Method Details

{ # Citation information for model-generated content. "endIndex": 42, # End of the attributed segment, exclusive. "fileCitation": { # A file citation annotation. # A file citation annotation. - "customMetadata": # Object with schema name: GenaiVertexV1beta1Struct # User provided metadata about the retrieved context. + "customMetadata": { # User provided metadata about the retrieved context. + "a_key": "", # Properties of the object. + }, "documentUri": "A String", # The URI of the file. "fileName": "A String", # The name of the file. "mediaId": "A String", # Media ID in-case of image citations, if applicable. @@ -3504,7 +3564,9 @@

Method Details

{ # Citation information for model-generated content. "endIndex": 42, # End of the attributed segment, exclusive. "fileCitation": { # A file citation annotation. # A file citation annotation. - "customMetadata": # Object with schema name: GenaiVertexV1beta1Struct # User provided metadata about the retrieved context. + "customMetadata": { # User provided metadata about the retrieved context. + "a_key": "", # Properties of the object. + }, "documentUri": "A String", # The URI of the file. "fileName": "A String", # The name of the file. "mediaId": "A String", # Media ID in-case of image citations, if applicable. @@ -3600,7 +3662,9 @@

Method Details

{ # Citation information for model-generated content. "endIndex": 42, # End of the attributed segment, exclusive. "fileCitation": { # A file citation annotation. # A file citation annotation. - "customMetadata": # Object with schema name: GenaiVertexV1beta1Struct # User provided metadata about the retrieved context. + "customMetadata": { # User provided metadata about the retrieved context. + "a_key": "", # Properties of the object. + }, "documentUri": "A String", # The URI of the file. "fileName": "A String", # The name of the file. "mediaId": "A String", # Media ID in-case of image citations, if applicable. @@ -3716,7 +3780,9 @@

Method Details

{ # Citation information for model-generated content. "endIndex": 42, # End of the attributed segment, exclusive. "fileCitation": { # A file citation annotation. # A file citation annotation. - "customMetadata": # Object with schema name: GenaiVertexV1beta1Struct # User provided metadata about the retrieved context. + "customMetadata": { # User provided metadata about the retrieved context. + "a_key": "", # Properties of the object. + }, "documentUri": "A String", # The URI of the file. "fileName": "A String", # The name of the file. "mediaId": "A String", # Media ID in-case of image citations, if applicable. @@ -3842,7 +3908,9 @@

Method Details

{ # Citation information for model-generated content. "endIndex": 42, # End of the attributed segment, exclusive. "fileCitation": { # A file citation annotation. # A file citation annotation. - "customMetadata": # Object with schema name: GenaiVertexV1beta1Struct # User provided metadata about the retrieved context. + "customMetadata": { # User provided metadata about the retrieved context. + "a_key": "", # Properties of the object. + }, "documentUri": "A String", # The URI of the file. "fileName": "A String", # The name of the file. "mediaId": "A String", # Media ID in-case of image citations, if applicable. @@ -3964,7 +4032,9 @@

Method Details

{ # Citation information for model-generated content. "endIndex": 42, # End of the attributed segment, exclusive. "fileCitation": { # A file citation annotation. # A file citation annotation. - "customMetadata": # Object with schema name: GenaiVertexV1beta1Struct # User provided metadata about the retrieved context. + "customMetadata": { # User provided metadata about the retrieved context. + "a_key": "", # Properties of the object. + }, "documentUri": "A String", # The URI of the file. "fileName": "A String", # The name of the file. "mediaId": "A String", # Media ID in-case of image citations, if applicable. @@ -4073,7 +4143,9 @@

Method Details

{ # Citation information for model-generated content. "endIndex": 42, # End of the attributed segment, exclusive. "fileCitation": { # A file citation annotation. # A file citation annotation. - "customMetadata": # Object with schema name: GenaiVertexV1beta1Struct # User provided metadata about the retrieved context. + "customMetadata": { # User provided metadata about the retrieved context. + "a_key": "", # Properties of the object. + }, "documentUri": "A String", # The URI of the file. "fileName": "A String", # The name of the file. "mediaId": "A String", # Media ID in-case of image citations, if applicable. @@ -4162,7 +4234,9 @@

Method Details

{ # Citation information for model-generated content. "endIndex": 42, # End of the attributed segment, exclusive. "fileCitation": { # A file citation annotation. # A file citation annotation. - "customMetadata": # Object with schema name: GenaiVertexV1beta1Struct # User provided metadata about the retrieved context. + "customMetadata": { # User provided metadata about the retrieved context. + "a_key": "", # Properties of the object. + }, "documentUri": "A String", # The URI of the file. "fileName": "A String", # The name of the file. "mediaId": "A String", # Media ID in-case of image citations, if applicable. @@ -4254,7 +4328,9 @@

Method Details

{ # Citation information for model-generated content. "endIndex": 42, # End of the attributed segment, exclusive. "fileCitation": { # A file citation annotation. # A file citation annotation. - "customMetadata": # Object with schema name: GenaiVertexV1beta1Struct # User provided metadata about the retrieved context. + "customMetadata": { # User provided metadata about the retrieved context. + "a_key": "", # Properties of the object. + }, "documentUri": "A String", # The URI of the file. "fileName": "A String", # The name of the file. "mediaId": "A String", # Media ID in-case of image citations, if applicable. @@ -4350,7 +4426,9 @@

Method Details

{ # Citation information for model-generated content. "endIndex": 42, # End of the attributed segment, exclusive. "fileCitation": { # A file citation annotation. # A file citation annotation. - "customMetadata": # Object with schema name: GenaiVertexV1beta1Struct # User provided metadata about the retrieved context. + "customMetadata": { # User provided metadata about the retrieved context. + "a_key": "", # Properties of the object. + }, "documentUri": "A String", # The URI of the file. "fileName": "A String", # The name of the file. "mediaId": "A String", # Media ID in-case of image citations, if applicable. @@ -4466,7 +4544,9 @@

Method Details

{ # Citation information for model-generated content. "endIndex": 42, # End of the attributed segment, exclusive. "fileCitation": { # A file citation annotation. # A file citation annotation. - "customMetadata": # Object with schema name: GenaiVertexV1beta1Struct # User provided metadata about the retrieved context. + "customMetadata": { # User provided metadata about the retrieved context. + "a_key": "", # Properties of the object. + }, "documentUri": "A String", # The URI of the file. "fileName": "A String", # The name of the file. "mediaId": "A String", # Media ID in-case of image citations, if applicable. @@ -4592,7 +4672,9 @@

Method Details

{ # Citation information for model-generated content. "endIndex": 42, # End of the attributed segment, exclusive. "fileCitation": { # A file citation annotation. # A file citation annotation. - "customMetadata": # Object with schema name: GenaiVertexV1beta1Struct # User provided metadata about the retrieved context. + "customMetadata": { # User provided metadata about the retrieved context. + "a_key": "", # Properties of the object. + }, "documentUri": "A String", # The URI of the file. "fileName": "A String", # The name of the file. "mediaId": "A String", # Media ID in-case of image citations, if applicable. @@ -4714,7 +4796,9 @@

Method Details

{ # Citation information for model-generated content. "endIndex": 42, # End of the attributed segment, exclusive. "fileCitation": { # A file citation annotation. # A file citation annotation. - "customMetadata": # Object with schema name: GenaiVertexV1beta1Struct # User provided metadata about the retrieved context. + "customMetadata": { # User provided metadata about the retrieved context. + "a_key": "", # Properties of the object. + }, "documentUri": "A String", # The URI of the file. "fileName": "A String", # The name of the file. "mediaId": "A String", # Media ID in-case of image citations, if applicable. @@ -4823,7 +4907,9 @@

Method Details

{ # Citation information for model-generated content. "endIndex": 42, # End of the attributed segment, exclusive. "fileCitation": { # A file citation annotation. # A file citation annotation. - "customMetadata": # Object with schema name: GenaiVertexV1beta1Struct # User provided metadata about the retrieved context. + "customMetadata": { # User provided metadata about the retrieved context. + "a_key": "", # Properties of the object. + }, "documentUri": "A String", # The URI of the file. "fileName": "A String", # The name of the file. "mediaId": "A String", # Media ID in-case of image citations, if applicable. @@ -4935,7 +5021,9 @@

Method Details

{ # Citation information for model-generated content. "endIndex": 42, # End of the attributed segment, exclusive. "fileCitation": { # A file citation annotation. # A file citation annotation. - "customMetadata": # Object with schema name: GenaiVertexV1beta1Struct # User provided metadata about the retrieved context. + "customMetadata": { # User provided metadata about the retrieved context. + "a_key": "", # Properties of the object. + }, "documentUri": "A String", # The URI of the file. "fileName": "A String", # The name of the file. "mediaId": "A String", # Media ID in-case of image citations, if applicable. @@ -5206,7 +5294,9 @@

Method Details

{ # Citation information for model-generated content. "endIndex": 42, # End of the attributed segment, exclusive. "fileCitation": { # A file citation annotation. # A file citation annotation. - "customMetadata": # Object with schema name: GenaiVertexV1beta1Struct # User provided metadata about the retrieved context. + "customMetadata": { # User provided metadata about the retrieved context. + "a_key": "", # Properties of the object. + }, "documentUri": "A String", # The URI of the file. "fileName": "A String", # The name of the file. "mediaId": "A String", # Media ID in-case of image citations, if applicable. @@ -5299,7 +5389,9 @@

Method Details

{ # Citation information for model-generated content. "endIndex": 42, # End of the attributed segment, exclusive. "fileCitation": { # A file citation annotation. # A file citation annotation. - "customMetadata": # Object with schema name: GenaiVertexV1beta1Struct # User provided metadata about the retrieved context. + "customMetadata": { # User provided metadata about the retrieved context. + "a_key": "", # Properties of the object. + }, "documentUri": "A String", # The URI of the file. "fileName": "A String", # The name of the file. "mediaId": "A String", # Media ID in-case of image citations, if applicable. @@ -5353,6 +5445,7 @@

Method Details

"uri": "A String", # The URI of the video. }, }, + "continuationToken": "A String", # Opaque token to resume a long decode. Output: set when status is INCOMPLETE and decoding can be resumed. Input: pass the latest token back unchanged in CreateInteraction to continue decoding. "created": "A String", # Required. Output only. The time at which the response was created in ISO 8601 format (YYYY-MM-DDThh:mm:ssZ). "envId": "A String", # The environment ID for the interaction. Can be 'remote' for default environment. "environmentId": "A String", # Output only. The environment ID for the interaction. Only populated if environment config is set in the request. @@ -5426,9 +5519,10 @@

Method Details

"remoteEnvironment": { # Configuration for a custom environment. "environmentId": "A String", # Optional. The environment ID for the interaction. If specified, the request will update the existing environment instead of creating a new one. "networkAllowlist": { # Network egress configuration for the environment. # Allow only specific domains. - "allowlist": [ # List of allowed domains and their configurations. + "allowlist": [ # List of allowed domains and their configurations. Set to `"disabled"` to block all network egress. { # A single domain allowlist rule with optional header injection. "domain": "A String", # Domain to allow outbound requests to. Supports wildcards (e.g. '*.googleapis.com'). Use '*' to allow all domains. + "mode": "A String", # Network egress mode. Set via the `"allowlist": "disabled"` short form; must be the only rule in the allowlist and cannot be combined with `domain`, `transform` or `credential`. "transform": { # Headers to inject into requests matching this rule. Key: header name (e.g., "Authorization"). Value: header value (e.g., "Bearer your-token"). "a_key": "A String", }, @@ -5491,7 +5585,9 @@

Method Details

{ # Citation information for model-generated content. "endIndex": 42, # End of the attributed segment, exclusive. "fileCitation": { # A file citation annotation. # A file citation annotation. - "customMetadata": # Object with schema name: GenaiVertexV1beta1Struct # User provided metadata about the retrieved context. + "customMetadata": { # User provided metadata about the retrieved context. + "a_key": "", # Properties of the object. + }, "documentUri": "A String", # The URI of the file. "fileName": "A String", # The name of the file. "mediaId": "A String", # Media ID in-case of image citations, if applicable. @@ -5590,7 +5686,9 @@

Method Details

{ # Citation information for model-generated content. "endIndex": 42, # End of the attributed segment, exclusive. "fileCitation": { # A file citation annotation. # A file citation annotation. - "customMetadata": # Object with schema name: GenaiVertexV1beta1Struct # User provided metadata about the retrieved context. + "customMetadata": { # User provided metadata about the retrieved context. + "a_key": "", # Properties of the object. + }, "documentUri": "A String", # The URI of the file. "fileName": "A String", # The name of the file. "mediaId": "A String", # Media ID in-case of image citations, if applicable. @@ -5711,7 +5809,9 @@

Method Details

{ # Citation information for model-generated content. "endIndex": 42, # End of the attributed segment, exclusive. "fileCitation": { # A file citation annotation. # A file citation annotation. - "customMetadata": # Object with schema name: GenaiVertexV1beta1Struct # User provided metadata about the retrieved context. + "customMetadata": { # User provided metadata about the retrieved context. + "a_key": "", # Properties of the object. + }, "documentUri": "A String", # The URI of the file. "fileName": "A String", # The name of the file. "mediaId": "A String", # Media ID in-case of image citations, if applicable. @@ -5810,7 +5910,9 @@

Method Details

{ # Citation information for model-generated content. "endIndex": 42, # End of the attributed segment, exclusive. "fileCitation": { # A file citation annotation. # A file citation annotation. - "customMetadata": # Object with schema name: GenaiVertexV1beta1Struct # User provided metadata about the retrieved context. + "customMetadata": { # User provided metadata about the retrieved context. + "a_key": "", # Properties of the object. + }, "documentUri": "A String", # The URI of the file. "fileName": "A String", # The name of the file. "mediaId": "A String", # Media ID in-case of image citations, if applicable. @@ -5928,7 +6030,9 @@

Method Details

{ # Citation information for model-generated content. "endIndex": 42, # End of the attributed segment, exclusive. "fileCitation": { # A file citation annotation. # A file citation annotation. - "customMetadata": # Object with schema name: GenaiVertexV1beta1Struct # User provided metadata about the retrieved context. + "customMetadata": { # User provided metadata about the retrieved context. + "a_key": "", # Properties of the object. + }, "documentUri": "A String", # The URI of the file. "fileName": "A String", # The name of the file. "mediaId": "A String", # Media ID in-case of image citations, if applicable. @@ -6020,7 +6124,9 @@

Method Details

{ # Citation information for model-generated content. "endIndex": 42, # End of the attributed segment, exclusive. "fileCitation": { # A file citation annotation. # A file citation annotation. - "customMetadata": # Object with schema name: GenaiVertexV1beta1Struct # User provided metadata about the retrieved context. + "customMetadata": { # User provided metadata about the retrieved context. + "a_key": "", # Properties of the object. + }, "documentUri": "A String", # The URI of the file. "fileName": "A String", # The name of the file. "mediaId": "A String", # Media ID in-case of image citations, if applicable. @@ -6116,7 +6222,9 @@

Method Details

{ # Citation information for model-generated content. "endIndex": 42, # End of the attributed segment, exclusive. "fileCitation": { # A file citation annotation. # A file citation annotation. - "customMetadata": # Object with schema name: GenaiVertexV1beta1Struct # User provided metadata about the retrieved context. + "customMetadata": { # User provided metadata about the retrieved context. + "a_key": "", # Properties of the object. + }, "documentUri": "A String", # The URI of the file. "fileName": "A String", # The name of the file. "mediaId": "A String", # Media ID in-case of image citations, if applicable. @@ -6232,7 +6340,9 @@

Method Details

{ # Citation information for model-generated content. "endIndex": 42, # End of the attributed segment, exclusive. "fileCitation": { # A file citation annotation. # A file citation annotation. - "customMetadata": # Object with schema name: GenaiVertexV1beta1Struct # User provided metadata about the retrieved context. + "customMetadata": { # User provided metadata about the retrieved context. + "a_key": "", # Properties of the object. + }, "documentUri": "A String", # The URI of the file. "fileName": "A String", # The name of the file. "mediaId": "A String", # Media ID in-case of image citations, if applicable. @@ -6358,7 +6468,9 @@

Method Details

{ # Citation information for model-generated content. "endIndex": 42, # End of the attributed segment, exclusive. "fileCitation": { # A file citation annotation. # A file citation annotation. - "customMetadata": # Object with schema name: GenaiVertexV1beta1Struct # User provided metadata about the retrieved context. + "customMetadata": { # User provided metadata about the retrieved context. + "a_key": "", # Properties of the object. + }, "documentUri": "A String", # The URI of the file. "fileName": "A String", # The name of the file. "mediaId": "A String", # Media ID in-case of image citations, if applicable. @@ -6480,7 +6592,9 @@

Method Details

{ # Citation information for model-generated content. "endIndex": 42, # End of the attributed segment, exclusive. "fileCitation": { # A file citation annotation. # A file citation annotation. - "customMetadata": # Object with schema name: GenaiVertexV1beta1Struct # User provided metadata about the retrieved context. + "customMetadata": { # User provided metadata about the retrieved context. + "a_key": "", # Properties of the object. + }, "documentUri": "A String", # The URI of the file. "fileName": "A String", # The name of the file. "mediaId": "A String", # Media ID in-case of image citations, if applicable. @@ -6589,7 +6703,9 @@

Method Details

{ # Citation information for model-generated content. "endIndex": 42, # End of the attributed segment, exclusive. "fileCitation": { # A file citation annotation. # A file citation annotation. - "customMetadata": # Object with schema name: GenaiVertexV1beta1Struct # User provided metadata about the retrieved context. + "customMetadata": { # User provided metadata about the retrieved context. + "a_key": "", # Properties of the object. + }, "documentUri": "A String", # The URI of the file. "fileName": "A String", # The name of the file. "mediaId": "A String", # Media ID in-case of image citations, if applicable. @@ -6678,7 +6794,9 @@

Method Details

{ # Citation information for model-generated content. "endIndex": 42, # End of the attributed segment, exclusive. "fileCitation": { # A file citation annotation. # A file citation annotation. - "customMetadata": # Object with schema name: GenaiVertexV1beta1Struct # User provided metadata about the retrieved context. + "customMetadata": { # User provided metadata about the retrieved context. + "a_key": "", # Properties of the object. + }, "documentUri": "A String", # The URI of the file. "fileName": "A String", # The name of the file. "mediaId": "A String", # Media ID in-case of image citations, if applicable. @@ -6770,7 +6888,9 @@

Method Details

{ # Citation information for model-generated content. "endIndex": 42, # End of the attributed segment, exclusive. "fileCitation": { # A file citation annotation. # A file citation annotation. - "customMetadata": # Object with schema name: GenaiVertexV1beta1Struct # User provided metadata about the retrieved context. + "customMetadata": { # User provided metadata about the retrieved context. + "a_key": "", # Properties of the object. + }, "documentUri": "A String", # The URI of the file. "fileName": "A String", # The name of the file. "mediaId": "A String", # Media ID in-case of image citations, if applicable. @@ -6866,7 +6986,9 @@

Method Details

{ # Citation information for model-generated content. "endIndex": 42, # End of the attributed segment, exclusive. "fileCitation": { # A file citation annotation. # A file citation annotation. - "customMetadata": # Object with schema name: GenaiVertexV1beta1Struct # User provided metadata about the retrieved context. + "customMetadata": { # User provided metadata about the retrieved context. + "a_key": "", # Properties of the object. + }, "documentUri": "A String", # The URI of the file. "fileName": "A String", # The name of the file. "mediaId": "A String", # Media ID in-case of image citations, if applicable. @@ -6982,7 +7104,9 @@

Method Details

{ # Citation information for model-generated content. "endIndex": 42, # End of the attributed segment, exclusive. "fileCitation": { # A file citation annotation. # A file citation annotation. - "customMetadata": # Object with schema name: GenaiVertexV1beta1Struct # User provided metadata about the retrieved context. + "customMetadata": { # User provided metadata about the retrieved context. + "a_key": "", # Properties of the object. + }, "documentUri": "A String", # The URI of the file. "fileName": "A String", # The name of the file. "mediaId": "A String", # Media ID in-case of image citations, if applicable. @@ -7108,7 +7232,9 @@

Method Details

{ # Citation information for model-generated content. "endIndex": 42, # End of the attributed segment, exclusive. "fileCitation": { # A file citation annotation. # A file citation annotation. - "customMetadata": # Object with schema name: GenaiVertexV1beta1Struct # User provided metadata about the retrieved context. + "customMetadata": { # User provided metadata about the retrieved context. + "a_key": "", # Properties of the object. + }, "documentUri": "A String", # The URI of the file. "fileName": "A String", # The name of the file. "mediaId": "A String", # Media ID in-case of image citations, if applicable. @@ -7230,7 +7356,9 @@

Method Details

{ # Citation information for model-generated content. "endIndex": 42, # End of the attributed segment, exclusive. "fileCitation": { # A file citation annotation. # A file citation annotation. - "customMetadata": # Object with schema name: GenaiVertexV1beta1Struct # User provided metadata about the retrieved context. + "customMetadata": { # User provided metadata about the retrieved context. + "a_key": "", # Properties of the object. + }, "documentUri": "A String", # The URI of the file. "fileName": "A String", # The name of the file. "mediaId": "A String", # Media ID in-case of image citations, if applicable. @@ -7339,7 +7467,9 @@

Method Details

{ # Citation information for model-generated content. "endIndex": 42, # End of the attributed segment, exclusive. "fileCitation": { # A file citation annotation. # A file citation annotation. - "customMetadata": # Object with schema name: GenaiVertexV1beta1Struct # User provided metadata about the retrieved context. + "customMetadata": { # User provided metadata about the retrieved context. + "a_key": "", # Properties of the object. + }, "documentUri": "A String", # The URI of the file. "fileName": "A String", # The name of the file. "mediaId": "A String", # Media ID in-case of image citations, if applicable. @@ -7451,7 +7581,9 @@

Method Details

{ # Citation information for model-generated content. "endIndex": 42, # End of the attributed segment, exclusive. "fileCitation": { # A file citation annotation. # A file citation annotation. - "customMetadata": # Object with schema name: GenaiVertexV1beta1Struct # User provided metadata about the retrieved context. + "customMetadata": { # User provided metadata about the retrieved context. + "a_key": "", # Properties of the object. + }, "documentUri": "A String", # The URI of the file. "fileName": "A String", # The name of the file. "mediaId": "A String", # Media ID in-case of image citations, if applicable. @@ -7729,7 +7861,9 @@

Method Details

{ # Citation information for model-generated content. "endIndex": 42, # End of the attributed segment, exclusive. "fileCitation": { # A file citation annotation. # A file citation annotation. - "customMetadata": # Object with schema name: GenaiVertexV1beta1Struct # User provided metadata about the retrieved context. + "customMetadata": { # User provided metadata about the retrieved context. + "a_key": "", # Properties of the object. + }, "documentUri": "A String", # The URI of the file. "fileName": "A String", # The name of the file. "mediaId": "A String", # Media ID in-case of image citations, if applicable. @@ -7822,7 +7956,9 @@

Method Details

{ # Citation information for model-generated content. "endIndex": 42, # End of the attributed segment, exclusive. "fileCitation": { # A file citation annotation. # A file citation annotation. - "customMetadata": # Object with schema name: GenaiVertexV1beta1Struct # User provided metadata about the retrieved context. + "customMetadata": { # User provided metadata about the retrieved context. + "a_key": "", # Properties of the object. + }, "documentUri": "A String", # The URI of the file. "fileName": "A String", # The name of the file. "mediaId": "A String", # Media ID in-case of image citations, if applicable. @@ -7876,6 +8012,7 @@

Method Details

"uri": "A String", # The URI of the video. }, }, + "continuationToken": "A String", # Opaque token to resume a long decode. Output: set when status is INCOMPLETE and decoding can be resumed. Input: pass the latest token back unchanged in CreateInteraction to continue decoding. "created": "A String", # Required. Output only. The time at which the response was created in ISO 8601 format (YYYY-MM-DDThh:mm:ssZ). "envId": "A String", # The environment ID for the interaction. Can be 'remote' for default environment. "environmentId": "A String", # Output only. The environment ID for the interaction. Only populated if environment config is set in the request. @@ -7949,9 +8086,10 @@

Method Details

"remoteEnvironment": { # Configuration for a custom environment. "environmentId": "A String", # Optional. The environment ID for the interaction. If specified, the request will update the existing environment instead of creating a new one. "networkAllowlist": { # Network egress configuration for the environment. # Allow only specific domains. - "allowlist": [ # List of allowed domains and their configurations. + "allowlist": [ # List of allowed domains and their configurations. Set to `"disabled"` to block all network egress. { # A single domain allowlist rule with optional header injection. "domain": "A String", # Domain to allow outbound requests to. Supports wildcards (e.g. '*.googleapis.com'). Use '*' to allow all domains. + "mode": "A String", # Network egress mode. Set via the `"allowlist": "disabled"` short form; must be the only rule in the allowlist and cannot be combined with `domain`, `transform` or `credential`. "transform": { # Headers to inject into requests matching this rule. Key: header name (e.g., "Authorization"). Value: header value (e.g., "Bearer your-token"). "a_key": "A String", }, @@ -8014,7 +8152,9 @@

Method Details

{ # Citation information for model-generated content. "endIndex": 42, # End of the attributed segment, exclusive. "fileCitation": { # A file citation annotation. # A file citation annotation. - "customMetadata": # Object with schema name: GenaiVertexV1beta1Struct # User provided metadata about the retrieved context. + "customMetadata": { # User provided metadata about the retrieved context. + "a_key": "", # Properties of the object. + }, "documentUri": "A String", # The URI of the file. "fileName": "A String", # The name of the file. "mediaId": "A String", # Media ID in-case of image citations, if applicable. @@ -8113,7 +8253,9 @@

Method Details

{ # Citation information for model-generated content. "endIndex": 42, # End of the attributed segment, exclusive. "fileCitation": { # A file citation annotation. # A file citation annotation. - "customMetadata": # Object with schema name: GenaiVertexV1beta1Struct # User provided metadata about the retrieved context. + "customMetadata": { # User provided metadata about the retrieved context. + "a_key": "", # Properties of the object. + }, "documentUri": "A String", # The URI of the file. "fileName": "A String", # The name of the file. "mediaId": "A String", # Media ID in-case of image citations, if applicable. @@ -8234,7 +8376,9 @@

Method Details

{ # Citation information for model-generated content. "endIndex": 42, # End of the attributed segment, exclusive. "fileCitation": { # A file citation annotation. # A file citation annotation. - "customMetadata": # Object with schema name: GenaiVertexV1beta1Struct # User provided metadata about the retrieved context. + "customMetadata": { # User provided metadata about the retrieved context. + "a_key": "", # Properties of the object. + }, "documentUri": "A String", # The URI of the file. "fileName": "A String", # The name of the file. "mediaId": "A String", # Media ID in-case of image citations, if applicable. @@ -8333,7 +8477,9 @@

Method Details

{ # Citation information for model-generated content. "endIndex": 42, # End of the attributed segment, exclusive. "fileCitation": { # A file citation annotation. # A file citation annotation. - "customMetadata": # Object with schema name: GenaiVertexV1beta1Struct # User provided metadata about the retrieved context. + "customMetadata": { # User provided metadata about the retrieved context. + "a_key": "", # Properties of the object. + }, "documentUri": "A String", # The URI of the file. "fileName": "A String", # The name of the file. "mediaId": "A String", # Media ID in-case of image citations, if applicable. @@ -8451,7 +8597,9 @@

Method Details

{ # Citation information for model-generated content. "endIndex": 42, # End of the attributed segment, exclusive. "fileCitation": { # A file citation annotation. # A file citation annotation. - "customMetadata": # Object with schema name: GenaiVertexV1beta1Struct # User provided metadata about the retrieved context. + "customMetadata": { # User provided metadata about the retrieved context. + "a_key": "", # Properties of the object. + }, "documentUri": "A String", # The URI of the file. "fileName": "A String", # The name of the file. "mediaId": "A String", # Media ID in-case of image citations, if applicable. @@ -8543,7 +8691,9 @@

Method Details

{ # Citation information for model-generated content. "endIndex": 42, # End of the attributed segment, exclusive. "fileCitation": { # A file citation annotation. # A file citation annotation. - "customMetadata": # Object with schema name: GenaiVertexV1beta1Struct # User provided metadata about the retrieved context. + "customMetadata": { # User provided metadata about the retrieved context. + "a_key": "", # Properties of the object. + }, "documentUri": "A String", # The URI of the file. "fileName": "A String", # The name of the file. "mediaId": "A String", # Media ID in-case of image citations, if applicable. @@ -8639,7 +8789,9 @@

Method Details

{ # Citation information for model-generated content. "endIndex": 42, # End of the attributed segment, exclusive. "fileCitation": { # A file citation annotation. # A file citation annotation. - "customMetadata": # Object with schema name: GenaiVertexV1beta1Struct # User provided metadata about the retrieved context. + "customMetadata": { # User provided metadata about the retrieved context. + "a_key": "", # Properties of the object. + }, "documentUri": "A String", # The URI of the file. "fileName": "A String", # The name of the file. "mediaId": "A String", # Media ID in-case of image citations, if applicable. @@ -8755,7 +8907,9 @@

Method Details

{ # Citation information for model-generated content. "endIndex": 42, # End of the attributed segment, exclusive. "fileCitation": { # A file citation annotation. # A file citation annotation. - "customMetadata": # Object with schema name: GenaiVertexV1beta1Struct # User provided metadata about the retrieved context. + "customMetadata": { # User provided metadata about the retrieved context. + "a_key": "", # Properties of the object. + }, "documentUri": "A String", # The URI of the file. "fileName": "A String", # The name of the file. "mediaId": "A String", # Media ID in-case of image citations, if applicable. @@ -8881,7 +9035,9 @@

Method Details

{ # Citation information for model-generated content. "endIndex": 42, # End of the attributed segment, exclusive. "fileCitation": { # A file citation annotation. # A file citation annotation. - "customMetadata": # Object with schema name: GenaiVertexV1beta1Struct # User provided metadata about the retrieved context. + "customMetadata": { # User provided metadata about the retrieved context. + "a_key": "", # Properties of the object. + }, "documentUri": "A String", # The URI of the file. "fileName": "A String", # The name of the file. "mediaId": "A String", # Media ID in-case of image citations, if applicable. @@ -9003,7 +9159,9 @@

Method Details

{ # Citation information for model-generated content. "endIndex": 42, # End of the attributed segment, exclusive. "fileCitation": { # A file citation annotation. # A file citation annotation. - "customMetadata": # Object with schema name: GenaiVertexV1beta1Struct # User provided metadata about the retrieved context. + "customMetadata": { # User provided metadata about the retrieved context. + "a_key": "", # Properties of the object. + }, "documentUri": "A String", # The URI of the file. "fileName": "A String", # The name of the file. "mediaId": "A String", # Media ID in-case of image citations, if applicable. @@ -9112,7 +9270,9 @@

Method Details

{ # Citation information for model-generated content. "endIndex": 42, # End of the attributed segment, exclusive. "fileCitation": { # A file citation annotation. # A file citation annotation. - "customMetadata": # Object with schema name: GenaiVertexV1beta1Struct # User provided metadata about the retrieved context. + "customMetadata": { # User provided metadata about the retrieved context. + "a_key": "", # Properties of the object. + }, "documentUri": "A String", # The URI of the file. "fileName": "A String", # The name of the file. "mediaId": "A String", # Media ID in-case of image citations, if applicable. @@ -9201,7 +9361,9 @@

Method Details

{ # Citation information for model-generated content. "endIndex": 42, # End of the attributed segment, exclusive. "fileCitation": { # A file citation annotation. # A file citation annotation. - "customMetadata": # Object with schema name: GenaiVertexV1beta1Struct # User provided metadata about the retrieved context. + "customMetadata": { # User provided metadata about the retrieved context. + "a_key": "", # Properties of the object. + }, "documentUri": "A String", # The URI of the file. "fileName": "A String", # The name of the file. "mediaId": "A String", # Media ID in-case of image citations, if applicable. @@ -9293,7 +9455,9 @@

Method Details

{ # Citation information for model-generated content. "endIndex": 42, # End of the attributed segment, exclusive. "fileCitation": { # A file citation annotation. # A file citation annotation. - "customMetadata": # Object with schema name: GenaiVertexV1beta1Struct # User provided metadata about the retrieved context. + "customMetadata": { # User provided metadata about the retrieved context. + "a_key": "", # Properties of the object. + }, "documentUri": "A String", # The URI of the file. "fileName": "A String", # The name of the file. "mediaId": "A String", # Media ID in-case of image citations, if applicable. @@ -9389,7 +9553,9 @@

Method Details

{ # Citation information for model-generated content. "endIndex": 42, # End of the attributed segment, exclusive. "fileCitation": { # A file citation annotation. # A file citation annotation. - "customMetadata": # Object with schema name: GenaiVertexV1beta1Struct # User provided metadata about the retrieved context. + "customMetadata": { # User provided metadata about the retrieved context. + "a_key": "", # Properties of the object. + }, "documentUri": "A String", # The URI of the file. "fileName": "A String", # The name of the file. "mediaId": "A String", # Media ID in-case of image citations, if applicable. @@ -9505,7 +9671,9 @@

Method Details

{ # Citation information for model-generated content. "endIndex": 42, # End of the attributed segment, exclusive. "fileCitation": { # A file citation annotation. # A file citation annotation. - "customMetadata": # Object with schema name: GenaiVertexV1beta1Struct # User provided metadata about the retrieved context. + "customMetadata": { # User provided metadata about the retrieved context. + "a_key": "", # Properties of the object. + }, "documentUri": "A String", # The URI of the file. "fileName": "A String", # The name of the file. "mediaId": "A String", # Media ID in-case of image citations, if applicable. @@ -9631,7 +9799,9 @@

Method Details

{ # Citation information for model-generated content. "endIndex": 42, # End of the attributed segment, exclusive. "fileCitation": { # A file citation annotation. # A file citation annotation. - "customMetadata": # Object with schema name: GenaiVertexV1beta1Struct # User provided metadata about the retrieved context. + "customMetadata": { # User provided metadata about the retrieved context. + "a_key": "", # Properties of the object. + }, "documentUri": "A String", # The URI of the file. "fileName": "A String", # The name of the file. "mediaId": "A String", # Media ID in-case of image citations, if applicable. @@ -9753,7 +9923,9 @@

Method Details

{ # Citation information for model-generated content. "endIndex": 42, # End of the attributed segment, exclusive. "fileCitation": { # A file citation annotation. # A file citation annotation. - "customMetadata": # Object with schema name: GenaiVertexV1beta1Struct # User provided metadata about the retrieved context. + "customMetadata": { # User provided metadata about the retrieved context. + "a_key": "", # Properties of the object. + }, "documentUri": "A String", # The URI of the file. "fileName": "A String", # The name of the file. "mediaId": "A String", # Media ID in-case of image citations, if applicable. @@ -9862,7 +10034,9 @@

Method Details

{ # Citation information for model-generated content. "endIndex": 42, # End of the attributed segment, exclusive. "fileCitation": { # A file citation annotation. # A file citation annotation. - "customMetadata": # Object with schema name: GenaiVertexV1beta1Struct # User provided metadata about the retrieved context. + "customMetadata": { # User provided metadata about the retrieved context. + "a_key": "", # Properties of the object. + }, "documentUri": "A String", # The URI of the file. "fileName": "A String", # The name of the file. "mediaId": "A String", # Media ID in-case of image citations, if applicable. @@ -9974,7 +10148,9 @@

Method Details

{ # Citation information for model-generated content. "endIndex": 42, # End of the attributed segment, exclusive. "fileCitation": { # A file citation annotation. # A file citation annotation. - "customMetadata": # Object with schema name: GenaiVertexV1beta1Struct # User provided metadata about the retrieved context. + "customMetadata": { # User provided metadata about the retrieved context. + "a_key": "", # Properties of the object. + }, "documentUri": "A String", # The URI of the file. "fileName": "A String", # The name of the file. "mediaId": "A String", # Media ID in-case of image citations, if applicable. @@ -10233,7 +10409,9 @@

Method Details

{ # Citation information for model-generated content. "endIndex": 42, # End of the attributed segment, exclusive. "fileCitation": { # A file citation annotation. # A file citation annotation. - "customMetadata": # Object with schema name: GenaiVertexV1beta1Struct # User provided metadata about the retrieved context. + "customMetadata": { # User provided metadata about the retrieved context. + "a_key": "", # Properties of the object. + }, "documentUri": "A String", # The URI of the file. "fileName": "A String", # The name of the file. "mediaId": "A String", # Media ID in-case of image citations, if applicable. @@ -10326,7 +10504,9 @@

Method Details

{ # Citation information for model-generated content. "endIndex": 42, # End of the attributed segment, exclusive. "fileCitation": { # A file citation annotation. # A file citation annotation. - "customMetadata": # Object with schema name: GenaiVertexV1beta1Struct # User provided metadata about the retrieved context. + "customMetadata": { # User provided metadata about the retrieved context. + "a_key": "", # Properties of the object. + }, "documentUri": "A String", # The URI of the file. "fileName": "A String", # The name of the file. "mediaId": "A String", # Media ID in-case of image citations, if applicable. @@ -10380,6 +10560,7 @@

Method Details

"uri": "A String", # The URI of the video. }, }, + "continuationToken": "A String", # Opaque token to resume a long decode. Output: set when status is INCOMPLETE and decoding can be resumed. Input: pass the latest token back unchanged in CreateInteraction to continue decoding. "created": "A String", # Required. Output only. The time at which the response was created in ISO 8601 format (YYYY-MM-DDThh:mm:ssZ). "envId": "A String", # The environment ID for the interaction. Can be 'remote' for default environment. "environmentId": "A String", # Output only. The environment ID for the interaction. Only populated if environment config is set in the request. @@ -10453,9 +10634,10 @@

Method Details

"remoteEnvironment": { # Configuration for a custom environment. "environmentId": "A String", # Optional. The environment ID for the interaction. If specified, the request will update the existing environment instead of creating a new one. "networkAllowlist": { # Network egress configuration for the environment. # Allow only specific domains. - "allowlist": [ # List of allowed domains and their configurations. + "allowlist": [ # List of allowed domains and their configurations. Set to `"disabled"` to block all network egress. { # A single domain allowlist rule with optional header injection. "domain": "A String", # Domain to allow outbound requests to. Supports wildcards (e.g. '*.googleapis.com'). Use '*' to allow all domains. + "mode": "A String", # Network egress mode. Set via the `"allowlist": "disabled"` short form; must be the only rule in the allowlist and cannot be combined with `domain`, `transform` or `credential`. "transform": { # Headers to inject into requests matching this rule. Key: header name (e.g., "Authorization"). Value: header value (e.g., "Bearer your-token"). "a_key": "A String", }, @@ -10518,7 +10700,9 @@

Method Details

{ # Citation information for model-generated content. "endIndex": 42, # End of the attributed segment, exclusive. "fileCitation": { # A file citation annotation. # A file citation annotation. - "customMetadata": # Object with schema name: GenaiVertexV1beta1Struct # User provided metadata about the retrieved context. + "customMetadata": { # User provided metadata about the retrieved context. + "a_key": "", # Properties of the object. + }, "documentUri": "A String", # The URI of the file. "fileName": "A String", # The name of the file. "mediaId": "A String", # Media ID in-case of image citations, if applicable. @@ -10617,7 +10801,9 @@

Method Details

{ # Citation information for model-generated content. "endIndex": 42, # End of the attributed segment, exclusive. "fileCitation": { # A file citation annotation. # A file citation annotation. - "customMetadata": # Object with schema name: GenaiVertexV1beta1Struct # User provided metadata about the retrieved context. + "customMetadata": { # User provided metadata about the retrieved context. + "a_key": "", # Properties of the object. + }, "documentUri": "A String", # The URI of the file. "fileName": "A String", # The name of the file. "mediaId": "A String", # Media ID in-case of image citations, if applicable. @@ -10738,7 +10924,9 @@

Method Details

{ # Citation information for model-generated content. "endIndex": 42, # End of the attributed segment, exclusive. "fileCitation": { # A file citation annotation. # A file citation annotation. - "customMetadata": # Object with schema name: GenaiVertexV1beta1Struct # User provided metadata about the retrieved context. + "customMetadata": { # User provided metadata about the retrieved context. + "a_key": "", # Properties of the object. + }, "documentUri": "A String", # The URI of the file. "fileName": "A String", # The name of the file. "mediaId": "A String", # Media ID in-case of image citations, if applicable. @@ -10837,7 +11025,9 @@

Method Details

{ # Citation information for model-generated content. "endIndex": 42, # End of the attributed segment, exclusive. "fileCitation": { # A file citation annotation. # A file citation annotation. - "customMetadata": # Object with schema name: GenaiVertexV1beta1Struct # User provided metadata about the retrieved context. + "customMetadata": { # User provided metadata about the retrieved context. + "a_key": "", # Properties of the object. + }, "documentUri": "A String", # The URI of the file. "fileName": "A String", # The name of the file. "mediaId": "A String", # Media ID in-case of image citations, if applicable. @@ -10955,7 +11145,9 @@

Method Details

{ # Citation information for model-generated content. "endIndex": 42, # End of the attributed segment, exclusive. "fileCitation": { # A file citation annotation. # A file citation annotation. - "customMetadata": # Object with schema name: GenaiVertexV1beta1Struct # User provided metadata about the retrieved context. + "customMetadata": { # User provided metadata about the retrieved context. + "a_key": "", # Properties of the object. + }, "documentUri": "A String", # The URI of the file. "fileName": "A String", # The name of the file. "mediaId": "A String", # Media ID in-case of image citations, if applicable. @@ -11047,7 +11239,9 @@

Method Details

{ # Citation information for model-generated content. "endIndex": 42, # End of the attributed segment, exclusive. "fileCitation": { # A file citation annotation. # A file citation annotation. - "customMetadata": # Object with schema name: GenaiVertexV1beta1Struct # User provided metadata about the retrieved context. + "customMetadata": { # User provided metadata about the retrieved context. + "a_key": "", # Properties of the object. + }, "documentUri": "A String", # The URI of the file. "fileName": "A String", # The name of the file. "mediaId": "A String", # Media ID in-case of image citations, if applicable. @@ -11143,7 +11337,9 @@

Method Details

{ # Citation information for model-generated content. "endIndex": 42, # End of the attributed segment, exclusive. "fileCitation": { # A file citation annotation. # A file citation annotation. - "customMetadata": # Object with schema name: GenaiVertexV1beta1Struct # User provided metadata about the retrieved context. + "customMetadata": { # User provided metadata about the retrieved context. + "a_key": "", # Properties of the object. + }, "documentUri": "A String", # The URI of the file. "fileName": "A String", # The name of the file. "mediaId": "A String", # Media ID in-case of image citations, if applicable. @@ -11259,7 +11455,9 @@

Method Details

{ # Citation information for model-generated content. "endIndex": 42, # End of the attributed segment, exclusive. "fileCitation": { # A file citation annotation. # A file citation annotation. - "customMetadata": # Object with schema name: GenaiVertexV1beta1Struct # User provided metadata about the retrieved context. + "customMetadata": { # User provided metadata about the retrieved context. + "a_key": "", # Properties of the object. + }, "documentUri": "A String", # The URI of the file. "fileName": "A String", # The name of the file. "mediaId": "A String", # Media ID in-case of image citations, if applicable. @@ -11385,7 +11583,9 @@

Method Details

{ # Citation information for model-generated content. "endIndex": 42, # End of the attributed segment, exclusive. "fileCitation": { # A file citation annotation. # A file citation annotation. - "customMetadata": # Object with schema name: GenaiVertexV1beta1Struct # User provided metadata about the retrieved context. + "customMetadata": { # User provided metadata about the retrieved context. + "a_key": "", # Properties of the object. + }, "documentUri": "A String", # The URI of the file. "fileName": "A String", # The name of the file. "mediaId": "A String", # Media ID in-case of image citations, if applicable. @@ -11507,7 +11707,9 @@

Method Details

{ # Citation information for model-generated content. "endIndex": 42, # End of the attributed segment, exclusive. "fileCitation": { # A file citation annotation. # A file citation annotation. - "customMetadata": # Object with schema name: GenaiVertexV1beta1Struct # User provided metadata about the retrieved context. + "customMetadata": { # User provided metadata about the retrieved context. + "a_key": "", # Properties of the object. + }, "documentUri": "A String", # The URI of the file. "fileName": "A String", # The name of the file. "mediaId": "A String", # Media ID in-case of image citations, if applicable. @@ -11616,7 +11818,9 @@

Method Details

{ # Citation information for model-generated content. "endIndex": 42, # End of the attributed segment, exclusive. "fileCitation": { # A file citation annotation. # A file citation annotation. - "customMetadata": # Object with schema name: GenaiVertexV1beta1Struct # User provided metadata about the retrieved context. + "customMetadata": { # User provided metadata about the retrieved context. + "a_key": "", # Properties of the object. + }, "documentUri": "A String", # The URI of the file. "fileName": "A String", # The name of the file. "mediaId": "A String", # Media ID in-case of image citations, if applicable. @@ -11705,7 +11909,9 @@

Method Details

{ # Citation information for model-generated content. "endIndex": 42, # End of the attributed segment, exclusive. "fileCitation": { # A file citation annotation. # A file citation annotation. - "customMetadata": # Object with schema name: GenaiVertexV1beta1Struct # User provided metadata about the retrieved context. + "customMetadata": { # User provided metadata about the retrieved context. + "a_key": "", # Properties of the object. + }, "documentUri": "A String", # The URI of the file. "fileName": "A String", # The name of the file. "mediaId": "A String", # Media ID in-case of image citations, if applicable. @@ -11797,7 +12003,9 @@

Method Details

{ # Citation information for model-generated content. "endIndex": 42, # End of the attributed segment, exclusive. "fileCitation": { # A file citation annotation. # A file citation annotation. - "customMetadata": # Object with schema name: GenaiVertexV1beta1Struct # User provided metadata about the retrieved context. + "customMetadata": { # User provided metadata about the retrieved context. + "a_key": "", # Properties of the object. + }, "documentUri": "A String", # The URI of the file. "fileName": "A String", # The name of the file. "mediaId": "A String", # Media ID in-case of image citations, if applicable. @@ -11893,7 +12101,9 @@

Method Details

{ # Citation information for model-generated content. "endIndex": 42, # End of the attributed segment, exclusive. "fileCitation": { # A file citation annotation. # A file citation annotation. - "customMetadata": # Object with schema name: GenaiVertexV1beta1Struct # User provided metadata about the retrieved context. + "customMetadata": { # User provided metadata about the retrieved context. + "a_key": "", # Properties of the object. + }, "documentUri": "A String", # The URI of the file. "fileName": "A String", # The name of the file. "mediaId": "A String", # Media ID in-case of image citations, if applicable. @@ -12009,7 +12219,9 @@

Method Details

{ # Citation information for model-generated content. "endIndex": 42, # End of the attributed segment, exclusive. "fileCitation": { # A file citation annotation. # A file citation annotation. - "customMetadata": # Object with schema name: GenaiVertexV1beta1Struct # User provided metadata about the retrieved context. + "customMetadata": { # User provided metadata about the retrieved context. + "a_key": "", # Properties of the object. + }, "documentUri": "A String", # The URI of the file. "fileName": "A String", # The name of the file. "mediaId": "A String", # Media ID in-case of image citations, if applicable. @@ -12135,7 +12347,9 @@

Method Details

{ # Citation information for model-generated content. "endIndex": 42, # End of the attributed segment, exclusive. "fileCitation": { # A file citation annotation. # A file citation annotation. - "customMetadata": # Object with schema name: GenaiVertexV1beta1Struct # User provided metadata about the retrieved context. + "customMetadata": { # User provided metadata about the retrieved context. + "a_key": "", # Properties of the object. + }, "documentUri": "A String", # The URI of the file. "fileName": "A String", # The name of the file. "mediaId": "A String", # Media ID in-case of image citations, if applicable. @@ -12257,7 +12471,9 @@

Method Details

{ # Citation information for model-generated content. "endIndex": 42, # End of the attributed segment, exclusive. "fileCitation": { # A file citation annotation. # A file citation annotation. - "customMetadata": # Object with schema name: GenaiVertexV1beta1Struct # User provided metadata about the retrieved context. + "customMetadata": { # User provided metadata about the retrieved context. + "a_key": "", # Properties of the object. + }, "documentUri": "A String", # The URI of the file. "fileName": "A String", # The name of the file. "mediaId": "A String", # Media ID in-case of image citations, if applicable. @@ -12366,7 +12582,9 @@

Method Details

{ # Citation information for model-generated content. "endIndex": 42, # End of the attributed segment, exclusive. "fileCitation": { # A file citation annotation. # A file citation annotation. - "customMetadata": # Object with schema name: GenaiVertexV1beta1Struct # User provided metadata about the retrieved context. + "customMetadata": { # User provided metadata about the retrieved context. + "a_key": "", # Properties of the object. + }, "documentUri": "A String", # The URI of the file. "fileName": "A String", # The name of the file. "mediaId": "A String", # Media ID in-case of image citations, if applicable. @@ -12478,7 +12696,9 @@

Method Details

{ # Citation information for model-generated content. "endIndex": 42, # End of the attributed segment, exclusive. "fileCitation": { # A file citation annotation. # A file citation annotation. - "customMetadata": # Object with schema name: GenaiVertexV1beta1Struct # User provided metadata about the retrieved context. + "customMetadata": { # User provided metadata about the retrieved context. + "a_key": "", # Properties of the object. + }, "documentUri": "A String", # The URI of the file. "fileName": "A String", # The name of the file. "mediaId": "A String", # Media ID in-case of image citations, if applicable. @@ -12665,8 +12885,47 @@

Method Details

}, }, "interactionStatusUpdate": { # The interaction status data, used for interaction.status_update events. + "continuationToken": "A String", # An optional opaque continuation token used to resume decoding from the latest checkpoint after a disconnected stream. "interactionId": "A String", "status": "A String", + "usage": { # Statistics on the interaction request's token usage. # Model usage statistics up to this checkpoint. + "cachedTokensByModality": [ # A breakdown of cached token usage by modality. + { # The token count for a single response modality. + "modality": "A String", # The modality associated with the token count. + "tokens": 42, # Number of tokens for the modality. + }, + ], + "groundingToolCount": [ # Grounding tool count. + { # The number of grounding tool counts. + "count": 42, # The number of grounding tool counts. + "type": "A String", # The grounding tool type associated with the count. + }, + ], + "inputTokensByModality": [ # A breakdown of input token usage by modality. + { # The token count for a single response modality. + "modality": "A String", # The modality associated with the token count. + "tokens": 42, # Number of tokens for the modality. + }, + ], + "outputTokensByModality": [ # A breakdown of output token usage by modality. + { # The token count for a single response modality. + "modality": "A String", # The modality associated with the token count. + "tokens": 42, # Number of tokens for the modality. + }, + ], + "toolUseTokensByModality": [ # A breakdown of tool-use token usage by modality. + { # The token count for a single response modality. + "modality": "A String", # The modality associated with the token count. + "tokens": 42, # Number of tokens for the modality. + }, + ], + "totalCachedTokens": 42, # Number of tokens in the cached part of the prompt (the cached content). + "totalInputTokens": 42, # Number of tokens in the prompt (context). + "totalOutputTokens": 42, # Total number of tokens across all the generated responses. + "totalThoughtTokens": 42, # Number of tokens of thoughts for thinking models. + "totalTokens": 42, # Total token count for the interaction request (prompt + responses + other internal tokens). + "totalToolUseTokens": 42, # Number of tokens present in tool-use prompt(s). + }, }, "stepDelta": { # The step delta data, used for step.delta events. Step-based streaming event, used when steps are enabled. "delta": { @@ -12715,7 +12974,9 @@

Method Details

{ # Citation information for model-generated content. "endIndex": 42, # End of the attributed segment, exclusive. "fileCitation": { # A file citation annotation. # A file citation annotation. - "customMetadata": # Object with schema name: GenaiVertexV1beta1Struct # User provided metadata about the retrieved context. + "customMetadata": { # User provided metadata about the retrieved context. + "a_key": "", # Properties of the object. + }, "documentUri": "A String", # The URI of the file. "fileName": "A String", # The name of the file. "mediaId": "A String", # Media ID in-case of image citations, if applicable. @@ -12840,7 +13101,9 @@

Method Details

{ # Citation information for model-generated content. "endIndex": 42, # End of the attributed segment, exclusive. "fileCitation": { # A file citation annotation. # A file citation annotation. - "customMetadata": # Object with schema name: GenaiVertexV1beta1Struct # User provided metadata about the retrieved context. + "customMetadata": { # User provided metadata about the retrieved context. + "a_key": "", # Properties of the object. + }, "documentUri": "A String", # The URI of the file. "fileName": "A String", # The name of the file. "mediaId": "A String", # Media ID in-case of image citations, if applicable. @@ -12997,7 +13260,9 @@

Method Details

{ # Citation information for model-generated content. "endIndex": 42, # End of the attributed segment, exclusive. "fileCitation": { # A file citation annotation. # A file citation annotation. - "customMetadata": # Object with schema name: GenaiVertexV1beta1Struct # User provided metadata about the retrieved context. + "customMetadata": { # User provided metadata about the retrieved context. + "a_key": "", # Properties of the object. + }, "documentUri": "A String", # The URI of the file. "fileName": "A String", # The name of the file. "mediaId": "A String", # Media ID in-case of image citations, if applicable. @@ -13087,7 +13352,9 @@

Method Details

{ # Citation information for model-generated content. "endIndex": 42, # End of the attributed segment, exclusive. "fileCitation": { # A file citation annotation. # A file citation annotation. - "customMetadata": # Object with schema name: GenaiVertexV1beta1Struct # User provided metadata about the retrieved context. + "customMetadata": { # User provided metadata about the retrieved context. + "a_key": "", # Properties of the object. + }, "documentUri": "A String", # The URI of the file. "fileName": "A String", # The name of the file. "mediaId": "A String", # Media ID in-case of image citations, if applicable. @@ -13152,7 +13419,9 @@

Method Details

{ # Citation information for model-generated content. "endIndex": 42, # End of the attributed segment, exclusive. "fileCitation": { # A file citation annotation. # A file citation annotation. - "customMetadata": # Object with schema name: GenaiVertexV1beta1Struct # User provided metadata about the retrieved context. + "customMetadata": { # User provided metadata about the retrieved context. + "a_key": "", # Properties of the object. + }, "documentUri": "A String", # The URI of the file. "fileName": "A String", # The name of the file. "mediaId": "A String", # Media ID in-case of image citations, if applicable. @@ -13245,7 +13514,9 @@

Method Details

{ # Citation information for model-generated content. "endIndex": 42, # End of the attributed segment, exclusive. "fileCitation": { # A file citation annotation. # A file citation annotation. - "customMetadata": # Object with schema name: GenaiVertexV1beta1Struct # User provided metadata about the retrieved context. + "customMetadata": { # User provided metadata about the retrieved context. + "a_key": "", # Properties of the object. + }, "documentUri": "A String", # The URI of the file. "fileName": "A String", # The name of the file. "mediaId": "A String", # Media ID in-case of image citations, if applicable. @@ -13337,7 +13608,9 @@

Method Details

{ # Citation information for model-generated content. "endIndex": 42, # End of the attributed segment, exclusive. "fileCitation": { # A file citation annotation. # A file citation annotation. - "customMetadata": # Object with schema name: GenaiVertexV1beta1Struct # User provided metadata about the retrieved context. + "customMetadata": { # User provided metadata about the retrieved context. + "a_key": "", # Properties of the object. + }, "documentUri": "A String", # The URI of the file. "fileName": "A String", # The name of the file. "mediaId": "A String", # Media ID in-case of image citations, if applicable. @@ -13433,7 +13706,9 @@

Method Details

{ # Citation information for model-generated content. "endIndex": 42, # End of the attributed segment, exclusive. "fileCitation": { # A file citation annotation. # A file citation annotation. - "customMetadata": # Object with schema name: GenaiVertexV1beta1Struct # User provided metadata about the retrieved context. + "customMetadata": { # User provided metadata about the retrieved context. + "a_key": "", # Properties of the object. + }, "documentUri": "A String", # The URI of the file. "fileName": "A String", # The name of the file. "mediaId": "A String", # Media ID in-case of image citations, if applicable. @@ -13549,7 +13824,9 @@

Method Details

{ # Citation information for model-generated content. "endIndex": 42, # End of the attributed segment, exclusive. "fileCitation": { # A file citation annotation. # A file citation annotation. - "customMetadata": # Object with schema name: GenaiVertexV1beta1Struct # User provided metadata about the retrieved context. + "customMetadata": { # User provided metadata about the retrieved context. + "a_key": "", # Properties of the object. + }, "documentUri": "A String", # The URI of the file. "fileName": "A String", # The name of the file. "mediaId": "A String", # Media ID in-case of image citations, if applicable. @@ -13675,7 +13952,9 @@

Method Details

{ # Citation information for model-generated content. "endIndex": 42, # End of the attributed segment, exclusive. "fileCitation": { # A file citation annotation. # A file citation annotation. - "customMetadata": # Object with schema name: GenaiVertexV1beta1Struct # User provided metadata about the retrieved context. + "customMetadata": { # User provided metadata about the retrieved context. + "a_key": "", # Properties of the object. + }, "documentUri": "A String", # The URI of the file. "fileName": "A String", # The name of the file. "mediaId": "A String", # Media ID in-case of image citations, if applicable. @@ -13797,7 +14076,9 @@

Method Details

{ # Citation information for model-generated content. "endIndex": 42, # End of the attributed segment, exclusive. "fileCitation": { # A file citation annotation. # A file citation annotation. - "customMetadata": # Object with schema name: GenaiVertexV1beta1Struct # User provided metadata about the retrieved context. + "customMetadata": { # User provided metadata about the retrieved context. + "a_key": "", # Properties of the object. + }, "documentUri": "A String", # The URI of the file. "fileName": "A String", # The name of the file. "mediaId": "A String", # Media ID in-case of image citations, if applicable. @@ -13906,7 +14187,9 @@

Method Details

{ # Citation information for model-generated content. "endIndex": 42, # End of the attributed segment, exclusive. "fileCitation": { # A file citation annotation. # A file citation annotation. - "customMetadata": # Object with schema name: GenaiVertexV1beta1Struct # User provided metadata about the retrieved context. + "customMetadata": { # User provided metadata about the retrieved context. + "a_key": "", # Properties of the object. + }, "documentUri": "A String", # The URI of the file. "fileName": "A String", # The name of the file. "mediaId": "A String", # Media ID in-case of image citations, if applicable. diff --git a/docs/dyn/aiplatform_v1beta1.projects.locations.memoryBanks.html b/docs/dyn/aiplatform_v1beta1.projects.locations.memoryBanks.html index 94e2dfe83a..7ac493d560 100644 --- a/docs/dyn/aiplatform_v1beta1.projects.locations.memoryBanks.html +++ b/docs/dyn/aiplatform_v1beta1.projects.locations.memoryBanks.html @@ -111,7 +111,7 @@

Method Details

{ # A single event to ingest. "content": { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. # Required. The content of the event. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. diff --git a/docs/dyn/aiplatform_v1beta1.projects.locations.memoryBanks.memories.html b/docs/dyn/aiplatform_v1beta1.projects.locations.memoryBanks.memories.html index ff53202b82..d04c87f1ad 100644 --- a/docs/dyn/aiplatform_v1beta1.projects.locations.memoryBanks.memories.html +++ b/docs/dyn/aiplatform_v1beta1.projects.locations.memoryBanks.memories.html @@ -263,7 +263,7 @@

Method Details

{ # A single piece of conversation from which to generate memories. "content": { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. # Required. A single piece of content from which to generate memories. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. diff --git a/docs/dyn/aiplatform_v1beta1.projects.locations.models.html b/docs/dyn/aiplatform_v1beta1.projects.locations.models.html index c5aa07b863..63c83285dc 100644 --- a/docs/dyn/aiplatform_v1beta1.projects.locations.models.html +++ b/docs/dyn/aiplatform_v1beta1.projects.locations.models.html @@ -356,7 +356,7 @@

Method Details

"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). + "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). At most 200 environment variables can be specified. Each variable (`NAME=value`) must be smaller than 128 KiB, and the total size of all variables must not exceed 512 KiB. { # 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. @@ -734,7 +734,7 @@

Method Details

"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). + "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). At most 200 environment variables can be specified. Each variable (`NAME=value`) must be smaller than 128 KiB, and the total size of all variables must not exceed 512 KiB. { # 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. @@ -1123,7 +1123,7 @@

Method Details

"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). + "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). At most 200 environment variables can be specified. Each variable (`NAME=value`) must be smaller than 128 KiB, and the total size of all variables must not exceed 512 KiB. { # 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. @@ -1500,7 +1500,7 @@

Method Details

"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). + "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). At most 200 environment variables can be specified. Each variable (`NAME=value`) must be smaller than 128 KiB, and the total size of all variables must not exceed 512 KiB. { # 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. @@ -1832,7 +1832,7 @@

Method Details

"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). + "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). At most 200 environment variables can be specified. Each variable (`NAME=value`) must be smaller than 128 KiB, and the total size of all variables must not exceed 512 KiB. { # 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. @@ -2163,7 +2163,7 @@

Method Details

"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). + "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). At most 200 environment variables can be specified. Each variable (`NAME=value`) must be smaller than 128 KiB, and the total size of all variables must not exceed 512 KiB. { # 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. @@ -2638,7 +2638,7 @@

Method Details

"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). + "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). At most 200 environment variables can be specified. Each variable (`NAME=value`) must be smaller than 128 KiB, and the total size of all variables must not exceed 512 KiB. { # 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. diff --git a/docs/dyn/aiplatform_v1beta1.projects.locations.onlineEvaluators.html b/docs/dyn/aiplatform_v1beta1.projects.locations.onlineEvaluators.html index 41893c41cf..6ad6af6293 100644 --- a/docs/dyn/aiplatform_v1beta1.projects.locations.onlineEvaluators.html +++ b/docs/dyn/aiplatform_v1beta1.projects.locations.onlineEvaluators.html @@ -184,6 +184,11 @@

Method Details

"comparisonOperator": "A String", # Required. The comparison operator to apply. "value": 3.14, # Required. The value to compare against. }, + "serviceVersion": { # Defines a predicate for filtering based on a string value. # Filter on the versions that served a session (`service.version` OTel resource attribute); matches if any of them is listed. At most one is allowed. On Vertex AI Agent Engine, this is the runtime revision id, currently set only for agents created via v1beta1. + "values": [ # Required. The values to match exactly (case-sensitive). Requires 1 to 20 values, each at most 128 characters long. + "A String", + ], + }, "toolCallErrors": { # Defines a predicate for filtering based on a numeric value. # Filter on the number of tool call errors within a session. "comparisonOperator": "A String", # Required. The comparison operator to apply. "value": 3.14, # Required. The value to compare against. @@ -213,6 +218,11 @@

Method Details

"comparisonOperator": "A String", # Required. The comparison operator to apply. "value": 3.14, # Required. The value to compare against. }, + "serviceVersion": { # Defines a predicate for filtering based on a string value. # Filter on the version that served a trace (`service.version` OTel resource attribute). At most one is allowed. On Vertex AI Agent Engine, this is the runtime revision id, currently set only for agents created via v1beta1. + "values": [ # Required. The values to match exactly (case-sensitive). Requires 1 to 20 values, each at most 128 characters long. + "A String", + ], + }, "totalTokenUsage": { # Defines a predicate for filtering based on a numeric value. # Filter on the total token usage within a trace. "comparisonOperator": "A String", # Required. The comparison operator to apply. "value": 3.14, # Required. The value to compare against. @@ -1135,6 +1145,11 @@

Method Details

"comparisonOperator": "A String", # Required. The comparison operator to apply. "value": 3.14, # Required. The value to compare against. }, + "serviceVersion": { # Defines a predicate for filtering based on a string value. # Filter on the versions that served a session (`service.version` OTel resource attribute); matches if any of them is listed. At most one is allowed. On Vertex AI Agent Engine, this is the runtime revision id, currently set only for agents created via v1beta1. + "values": [ # Required. The values to match exactly (case-sensitive). Requires 1 to 20 values, each at most 128 characters long. + "A String", + ], + }, "toolCallErrors": { # Defines a predicate for filtering based on a numeric value. # Filter on the number of tool call errors within a session. "comparisonOperator": "A String", # Required. The comparison operator to apply. "value": 3.14, # Required. The value to compare against. @@ -1164,6 +1179,11 @@

Method Details

"comparisonOperator": "A String", # Required. The comparison operator to apply. "value": 3.14, # Required. The value to compare against. }, + "serviceVersion": { # Defines a predicate for filtering based on a string value. # Filter on the version that served a trace (`service.version` OTel resource attribute). At most one is allowed. On Vertex AI Agent Engine, this is the runtime revision id, currently set only for agents created via v1beta1. + "values": [ # Required. The values to match exactly (case-sensitive). Requires 1 to 20 values, each at most 128 characters long. + "A String", + ], + }, "totalTokenUsage": { # Defines a predicate for filtering based on a numeric value. # Filter on the total token usage within a trace. "comparisonOperator": "A String", # Required. The comparison operator to apply. "value": 3.14, # Required. The value to compare against. @@ -2030,6 +2050,11 @@

Method Details

"comparisonOperator": "A String", # Required. The comparison operator to apply. "value": 3.14, # Required. The value to compare against. }, + "serviceVersion": { # Defines a predicate for filtering based on a string value. # Filter on the versions that served a session (`service.version` OTel resource attribute); matches if any of them is listed. At most one is allowed. On Vertex AI Agent Engine, this is the runtime revision id, currently set only for agents created via v1beta1. + "values": [ # Required. The values to match exactly (case-sensitive). Requires 1 to 20 values, each at most 128 characters long. + "A String", + ], + }, "toolCallErrors": { # Defines a predicate for filtering based on a numeric value. # Filter on the number of tool call errors within a session. "comparisonOperator": "A String", # Required. The comparison operator to apply. "value": 3.14, # Required. The value to compare against. @@ -2059,6 +2084,11 @@

Method Details

"comparisonOperator": "A String", # Required. The comparison operator to apply. "value": 3.14, # Required. The value to compare against. }, + "serviceVersion": { # Defines a predicate for filtering based on a string value. # Filter on the version that served a trace (`service.version` OTel resource attribute). At most one is allowed. On Vertex AI Agent Engine, this is the runtime revision id, currently set only for agents created via v1beta1. + "values": [ # Required. The values to match exactly (case-sensitive). Requires 1 to 20 values, each at most 128 characters long. + "A String", + ], + }, "totalTokenUsage": { # Defines a predicate for filtering based on a numeric value. # Filter on the total token usage within a trace. "comparisonOperator": "A String", # Required. The comparison operator to apply. "value": 3.14, # Required. The value to compare against. @@ -2929,6 +2959,11 @@

Method Details

"comparisonOperator": "A String", # Required. The comparison operator to apply. "value": 3.14, # Required. The value to compare against. }, + "serviceVersion": { # Defines a predicate for filtering based on a string value. # Filter on the versions that served a session (`service.version` OTel resource attribute); matches if any of them is listed. At most one is allowed. On Vertex AI Agent Engine, this is the runtime revision id, currently set only for agents created via v1beta1. + "values": [ # Required. The values to match exactly (case-sensitive). Requires 1 to 20 values, each at most 128 characters long. + "A String", + ], + }, "toolCallErrors": { # Defines a predicate for filtering based on a numeric value. # Filter on the number of tool call errors within a session. "comparisonOperator": "A String", # Required. The comparison operator to apply. "value": 3.14, # Required. The value to compare against. @@ -2958,6 +2993,11 @@

Method Details

"comparisonOperator": "A String", # Required. The comparison operator to apply. "value": 3.14, # Required. The value to compare against. }, + "serviceVersion": { # Defines a predicate for filtering based on a string value. # Filter on the version that served a trace (`service.version` OTel resource attribute). At most one is allowed. On Vertex AI Agent Engine, this is the runtime revision id, currently set only for agents created via v1beta1. + "values": [ # Required. The values to match exactly (case-sensitive). Requires 1 to 20 values, each at most 128 characters long. + "A String", + ], + }, "totalTokenUsage": { # Defines a predicate for filtering based on a numeric value. # Filter on the total token usage within a trace. "comparisonOperator": "A String", # Required. The comparison operator to apply. "value": 3.14, # Required. The value to compare against. diff --git a/docs/dyn/aiplatform_v1beta1.projects.locations.publishers.models.html b/docs/dyn/aiplatform_v1beta1.projects.locations.publishers.models.html index 19ed6148a1..a3c0eec4cf 100644 --- a/docs/dyn/aiplatform_v1beta1.projects.locations.publishers.models.html +++ b/docs/dyn/aiplatform_v1beta1.projects.locations.publishers.models.html @@ -146,7 +146,7 @@

Method Details

"contents": [ # Optional. Input content. { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -281,7 +281,7 @@

Method Details

"contents": [ # Optional. Input content. { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -550,7 +550,7 @@

Method Details

"model": "A String", # Optional. The name of the publisher model requested to serve the prediction. Format: `projects/{project}/locations/{location}/publishers/*/models/*` "systemInstruction": { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. # Optional. The user provided system instructions for the model. Note: only text should be used in parts and content in each part will be in a separate paragraph. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -919,7 +919,7 @@

Method Details

"autoTruncate": True or False, # Optional. Deprecated: Please use EmbedContentConfig.auto_truncate instead. Whether to silently truncate the input content if it's longer than the maximum sequence length. "content": { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. # Required. The content to be embedded. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -1212,7 +1212,7 @@

Method Details

"contents": [ # Required. The content of the current conversation with the model. For single-turn queries, this is a single instance. For multi-turn queries, this is a repeated field that contains conversation history + latest request. { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -1305,6 +1305,7 @@

Method Details

"role": "A String", # Optional. The producer of the content. Must be either 'user' or 'model'. If not set, the service will default to 'user'. }, ], + "continuationToken": "A String", # Optional. An opaque continuation token used to resume generation from a previous `GenerateContent` or `StreamGenerateContent` response that stopped with `finish_reason` set to `CONTINUATION`. "generationConfig": { # Configuration for content generation. This message contains all the parameters that control how the model generates content. It allows you to influence the randomness, length, and structure of the output. # Optional. Generation config. "audioTimestamp": True or False, # Optional. If enabled, audio timestamps will be included in the request to the model. This can be useful for synchronizing audio with other modalities in the response. "audioTranscriptionConfig": { # Configuration for speech recognition (transcription). # Optional. Configuration for audio transcription (speech recognition). @@ -1491,7 +1492,7 @@

Method Details

], "systemInstruction": { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. # Optional. The user provided system instructions for the model. Note: only text should be used in parts and content in each part will be in a separate paragraph. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -1873,7 +1874,7 @@

Method Details

}, "content": { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. # Output only. The content of the candidate. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -1965,6 +1966,7 @@

Method Details

], "role": "A String", # Optional. The producer of the content. Must be either 'user' or 'model'. If not set, the service will default to 'user'. }, + "continuationToken": "A String", # Output only. An optional opaque continuation token returned when `finish_reason` is `CONTINUATION`. Clients can pass this token in a subsequent `GenerateContentRequest` to continue generation. "finishMessage": "A String", # Output only. Describes the reason the model stopped generating tokens in more detail. This field is returned only when `finish_reason` is set. "finishReason": "A String", # Output only. The reason why the model stopped generating tokens. If empty, the model has not stopped generating. "groundingMetadata": { # Information about the sources that support the content of a response. When grounding is enabled, the model returns citations for claims in the response. This object contains the retrieved sources. # Output only. Metadata returned when grounding is enabled. It contains the sources used to ground the generated content. @@ -2583,7 +2585,7 @@

Method Details

"contents": [ # Required. The content of the current conversation with the model. For single-turn queries, this is a single instance. For multi-turn queries, this is a repeated field that contains conversation history + latest request. { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -2676,6 +2678,7 @@

Method Details

"role": "A String", # Optional. The producer of the content. Must be either 'user' or 'model'. If not set, the service will default to 'user'. }, ], + "continuationToken": "A String", # Optional. An opaque continuation token used to resume generation from a previous `GenerateContent` or `StreamGenerateContent` response that stopped with `finish_reason` set to `CONTINUATION`. "generationConfig": { # Configuration for content generation. This message contains all the parameters that control how the model generates content. It allows you to influence the randomness, length, and structure of the output. # Optional. Generation config. "audioTimestamp": True or False, # Optional. If enabled, audio timestamps will be included in the request to the model. This can be useful for synchronizing audio with other modalities in the response. "audioTranscriptionConfig": { # Configuration for speech recognition (transcription). # Optional. Configuration for audio transcription (speech recognition). @@ -2862,7 +2865,7 @@

Method Details

], "systemInstruction": { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. # Optional. The user provided system instructions for the model. Note: only text should be used in parts and content in each part will be in a separate paragraph. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -3244,7 +3247,7 @@

Method Details

}, "content": { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. # Output only. The content of the candidate. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -3336,6 +3339,7 @@

Method Details

], "role": "A String", # Optional. The producer of the content. Must be either 'user' or 'model'. If not set, the service will default to 'user'. }, + "continuationToken": "A String", # Output only. An optional opaque continuation token returned when `finish_reason` is `CONTINUATION`. Clients can pass this token in a subsequent `GenerateContentRequest` to continue generation. "finishMessage": "A String", # Output only. Describes the reason the model stopped generating tokens in more detail. This field is returned only when `finish_reason` is set. "finishReason": "A String", # Output only. The reason why the model stopped generating tokens. If empty, the model has not stopped generating. "groundingMetadata": { # Information about the sources that support the content of a response. When grounding is enabled, the model returns citations for claims in the response. This object contains the retrieved sources. # Output only. Metadata returned when grounding is enabled. It contains the sources used to ground the generated content. diff --git a/docs/dyn/aiplatform_v1beta1.projects.locations.reasoningEngines.a2aTasks.events.html b/docs/dyn/aiplatform_v1beta1.projects.locations.reasoningEngines.a2aTasks.events.html index 98c85bc5ff..41f8b3cc78 100644 --- a/docs/dyn/aiplatform_v1beta1.projects.locations.reasoningEngines.a2aTasks.events.html +++ b/docs/dyn/aiplatform_v1beta1.projects.locations.reasoningEngines.a2aTasks.events.html @@ -239,7 +239,7 @@

Method Details

"a_key": "", # Properties of the object. }, "parts": [ # Required. The content of the artifact. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -343,7 +343,7 @@

Method Details

"a_key": "", # Properties of the object. }, "parts": [ # Required. The content of the artifact. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -448,7 +448,7 @@

Method Details

"a_key": "", # Properties of the object. }, "parts": [ # Required. The parts of the message. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. diff --git a/docs/dyn/aiplatform_v1beta1.projects.locations.reasoningEngines.a2aTasks.html b/docs/dyn/aiplatform_v1beta1.projects.locations.reasoningEngines.a2aTasks.html index efaedeae66..f36450fcf9 100644 --- a/docs/dyn/aiplatform_v1beta1.projects.locations.reasoningEngines.a2aTasks.html +++ b/docs/dyn/aiplatform_v1beta1.projects.locations.reasoningEngines.a2aTasks.html @@ -242,7 +242,7 @@

Method Details

"a_key": "", # Properties of the object. }, "parts": [ # Required. The content of the artifact. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -346,7 +346,7 @@

Method Details

"a_key": "", # Properties of the object. }, "parts": [ # Required. The content of the artifact. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -451,7 +451,7 @@

Method Details

"a_key": "", # Properties of the object. }, "parts": [ # Required. The parts of the message. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -657,7 +657,7 @@

Method Details

"a_key": "", # Properties of the object. }, "parts": [ # Required. The content of the artifact. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -790,7 +790,7 @@

Method Details

"a_key": "", # Properties of the object. }, "parts": [ # Required. The parts of the message. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -976,7 +976,7 @@

Method Details

"a_key": "", # Properties of the object. }, "parts": [ # Required. The content of the artifact. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -1109,7 +1109,7 @@

Method Details

"a_key": "", # Properties of the object. }, "parts": [ # Required. The parts of the message. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -1324,7 +1324,7 @@

Method Details

"a_key": "", # Properties of the object. }, "parts": [ # Required. The content of the artifact. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -1457,7 +1457,7 @@

Method Details

"a_key": "", # Properties of the object. }, "parts": [ # Required. The parts of the message. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -1655,7 +1655,7 @@

Method Details

"a_key": "", # Properties of the object. }, "parts": [ # Required. The content of the artifact. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -1788,7 +1788,7 @@

Method Details

"a_key": "", # Properties of the object. }, "parts": [ # Required. The parts of the message. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. diff --git a/docs/dyn/aiplatform_v1beta1.projects.locations.reasoningEngines.feedbackEntries.html b/docs/dyn/aiplatform_v1beta1.projects.locations.reasoningEngines.feedbackEntries.html index f791da74ca..054b4e1644 100644 --- a/docs/dyn/aiplatform_v1beta1.projects.locations.reasoningEngines.feedbackEntries.html +++ b/docs/dyn/aiplatform_v1beta1.projects.locations.reasoningEngines.feedbackEntries.html @@ -270,7 +270,7 @@

Method Details

"author": "A String", # Required. The name of the agent that sent the event, or user. "content": { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. # Optional. Content of the event provided by the author. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -632,7 +632,7 @@

Method Details

"author": "A String", # Required. The name of the agent that sent the event, or user. "content": { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. # Optional. Content of the event provided by the author. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. diff --git a/docs/dyn/aiplatform_v1beta1.projects.locations.reasoningEngines.html b/docs/dyn/aiplatform_v1beta1.projects.locations.reasoningEngines.html index 052c345b5b..f3f3289caa 100644 --- a/docs/dyn/aiplatform_v1beta1.projects.locations.reasoningEngines.html +++ b/docs/dyn/aiplatform_v1beta1.projects.locations.reasoningEngines.html @@ -274,7 +274,7 @@

Method Details

{ # A single conversation event. "content": { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. # Required. Represents the content of the event. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -760,7 +760,7 @@

Method Details

{ # A single conversation event. "content": { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. # Required. Represents the content of the event. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -1177,7 +1177,7 @@

Method Details

{ # A single conversation event. "content": { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. # Required. Represents the content of the event. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -1564,7 +1564,7 @@

Method Details

{ # A single conversation event. "content": { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. # Required. Represents the content of the event. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. diff --git a/docs/dyn/aiplatform_v1beta1.projects.locations.reasoningEngines.memories.html b/docs/dyn/aiplatform_v1beta1.projects.locations.reasoningEngines.memories.html index 360e2edf32..9b031f5da5 100644 --- a/docs/dyn/aiplatform_v1beta1.projects.locations.reasoningEngines.memories.html +++ b/docs/dyn/aiplatform_v1beta1.projects.locations.reasoningEngines.memories.html @@ -266,7 +266,7 @@

Method Details

{ # A single piece of conversation from which to generate memories. "content": { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. # Required. A single piece of content from which to generate memories. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -502,7 +502,7 @@

Method Details

{ # A single event to ingest. "content": { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. # Required. The content of the event. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. 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 5508da395a..92cd68878e 100644 --- a/docs/dyn/aiplatform_v1beta1.projects.locations.reasoningEngines.sessions.events.html +++ b/docs/dyn/aiplatform_v1beta1.projects.locations.reasoningEngines.sessions.events.html @@ -128,7 +128,7 @@

Method Details

"author": "A String", # Required. The name of the agent that sent the event, or user. "content": { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. # Optional. Content of the event provided by the author. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. diff --git a/docs/dyn/aiplatform_v1beta1.projects.locations.reasoningEngines.sessions.html b/docs/dyn/aiplatform_v1beta1.projects.locations.reasoningEngines.sessions.html index 1cd55f10f8..b4e86bbb70 100644 --- a/docs/dyn/aiplatform_v1beta1.projects.locations.reasoningEngines.sessions.html +++ b/docs/dyn/aiplatform_v1beta1.projects.locations.reasoningEngines.sessions.html @@ -139,7 +139,7 @@

Method Details

"author": "A String", # Required. The name of the agent that sent the event, or user. "content": { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. # Optional. Content of the event provided by the author. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. diff --git a/docs/dyn/aiplatform_v1beta1.projects.locations.trainingPipelines.html b/docs/dyn/aiplatform_v1beta1.projects.locations.trainingPipelines.html index b416a92c85..6f900134cb 100644 --- a/docs/dyn/aiplatform_v1beta1.projects.locations.trainingPipelines.html +++ b/docs/dyn/aiplatform_v1beta1.projects.locations.trainingPipelines.html @@ -224,7 +224,7 @@

Method Details

"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). + "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). At most 200 environment variables can be specified. Each variable (`NAME=value`) must be smaller than 128 KiB, and the total size of all variables must not exceed 512 KiB. { # 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. @@ -621,7 +621,7 @@

Method Details

"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). + "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). At most 200 environment variables can be specified. Each variable (`NAME=value`) must be smaller than 128 KiB, and the total size of all variables must not exceed 512 KiB. { # 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. @@ -1060,7 +1060,7 @@

Method Details

"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). + "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). At most 200 environment variables can be specified. Each variable (`NAME=value`) must be smaller than 128 KiB, and the total size of all variables must not exceed 512 KiB. { # 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. @@ -1471,7 +1471,7 @@

Method Details

"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). + "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). At most 200 environment variables can be specified. Each variable (`NAME=value`) must be smaller than 128 KiB, and the total size of all variables must not exceed 512 KiB. { # 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. diff --git a/docs/dyn/aiplatform_v1beta1.projects.locations.tuningJobs.html b/docs/dyn/aiplatform_v1beta1.projects.locations.tuningJobs.html index 9f44fb1b94..be2a2514e9 100644 --- a/docs/dyn/aiplatform_v1beta1.projects.locations.tuningJobs.html +++ b/docs/dyn/aiplatform_v1beta1.projects.locations.tuningJobs.html @@ -1967,7 +1967,7 @@

Method Details

"contents": [ # Multi-turn contents that represents the Prompt. { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -2065,7 +2065,7 @@

Method Details

}, "systemInstruction": { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. # Corresponds to system_instruction in user-facing GenerateContentRequest. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -2410,7 +2410,7 @@

Method Details

"userDatasetExamples": [ # Output only. Sample user messages in the training dataset uri. { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -2601,7 +2601,7 @@

Method Details

{ # Completion and its preference score. "completion": { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. # Single turn completion for the given prompt. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -2699,7 +2699,7 @@

Method Details

"contents": [ # Multi-turn contents that represents the Prompt. { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -2856,7 +2856,7 @@

Method Details

"contents": [ # Multi-turn contents that represents the Prompt. { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -2954,7 +2954,7 @@

Method Details

}, "systemInstruction": { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. # Corresponds to system_instruction in user-facing GenerateContentRequest. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -3299,7 +3299,7 @@

Method Details

"userDatasetExamples": [ # Output only. Sample user messages in the training dataset uri. { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -3457,7 +3457,7 @@

Method Details

"userDatasetExamples": [ # Output only. Sample user messages in the training dataset uri. { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -5463,7 +5463,7 @@

Method Details

"contents": [ # Multi-turn contents that represents the Prompt. { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -5561,7 +5561,7 @@

Method Details

}, "systemInstruction": { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. # Corresponds to system_instruction in user-facing GenerateContentRequest. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -5906,7 +5906,7 @@

Method Details

"userDatasetExamples": [ # Output only. Sample user messages in the training dataset uri. { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -6097,7 +6097,7 @@

Method Details

{ # Completion and its preference score. "completion": { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. # Single turn completion for the given prompt. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -6195,7 +6195,7 @@

Method Details

"contents": [ # Multi-turn contents that represents the Prompt. { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -6352,7 +6352,7 @@

Method Details

"contents": [ # Multi-turn contents that represents the Prompt. { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -6450,7 +6450,7 @@

Method Details

}, "systemInstruction": { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. # Corresponds to system_instruction in user-facing GenerateContentRequest. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -6795,7 +6795,7 @@

Method Details

"userDatasetExamples": [ # Output only. Sample user messages in the training dataset uri. { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -6953,7 +6953,7 @@

Method Details

"userDatasetExamples": [ # Output only. Sample user messages in the training dataset uri. { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -8966,7 +8966,7 @@

Method Details

"contents": [ # Multi-turn contents that represents the Prompt. { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -9064,7 +9064,7 @@

Method Details

}, "systemInstruction": { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. # Corresponds to system_instruction in user-facing GenerateContentRequest. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -9409,7 +9409,7 @@

Method Details

"userDatasetExamples": [ # Output only. Sample user messages in the training dataset uri. { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -9600,7 +9600,7 @@

Method Details

{ # Completion and its preference score. "completion": { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. # Single turn completion for the given prompt. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -9698,7 +9698,7 @@

Method Details

"contents": [ # Multi-turn contents that represents the Prompt. { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -9855,7 +9855,7 @@

Method Details

"contents": [ # Multi-turn contents that represents the Prompt. { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -9953,7 +9953,7 @@

Method Details

}, "systemInstruction": { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. # Corresponds to system_instruction in user-facing GenerateContentRequest. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -10298,7 +10298,7 @@

Method Details

"userDatasetExamples": [ # Output only. Sample user messages in the training dataset uri. { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -10456,7 +10456,7 @@

Method Details

"userDatasetExamples": [ # Output only. Sample user messages in the training dataset uri. { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -12475,7 +12475,7 @@

Method Details

"contents": [ # Multi-turn contents that represents the Prompt. { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -12573,7 +12573,7 @@

Method Details

}, "systemInstruction": { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. # Corresponds to system_instruction in user-facing GenerateContentRequest. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -12918,7 +12918,7 @@

Method Details

"userDatasetExamples": [ # Output only. Sample user messages in the training dataset uri. { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -13109,7 +13109,7 @@

Method Details

{ # Completion and its preference score. "completion": { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. # Single turn completion for the given prompt. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -13207,7 +13207,7 @@

Method Details

"contents": [ # Multi-turn contents that represents the Prompt. { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -13364,7 +13364,7 @@

Method Details

"contents": [ # Multi-turn contents that represents the Prompt. { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -13462,7 +13462,7 @@

Method Details

}, "systemInstruction": { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. # Corresponds to system_instruction in user-facing GenerateContentRequest. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -13807,7 +13807,7 @@

Method Details

"userDatasetExamples": [ # Output only. Sample user messages in the training dataset uri. { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -13965,7 +13965,7 @@

Method Details

"userDatasetExamples": [ # Output only. Sample user messages in the training dataset uri. { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -14173,7 +14173,7 @@

Method Details

{ # Request message for GenAiTuningService.OptimizePrompt. "content": { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. # Required. The content of the prompt to optimize. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -14279,7 +14279,7 @@

Method Details

{ # Response message for GenAiTuningService.OptimizePrompt "content": { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. # Output only. The optimized prompt. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -16267,7 +16267,7 @@

Method Details

"contents": [ # Multi-turn contents that represents the Prompt. { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -16365,7 +16365,7 @@

Method Details

}, "systemInstruction": { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. # Corresponds to system_instruction in user-facing GenerateContentRequest. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -16710,7 +16710,7 @@

Method Details

"userDatasetExamples": [ # Output only. Sample user messages in the training dataset uri. { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -16901,7 +16901,7 @@

Method Details

{ # Completion and its preference score. "completion": { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. # Single turn completion for the given prompt. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -16999,7 +16999,7 @@

Method Details

"contents": [ # Multi-turn contents that represents the Prompt. { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -17156,7 +17156,7 @@

Method Details

"contents": [ # Multi-turn contents that represents the Prompt. { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -17254,7 +17254,7 @@

Method Details

}, "systemInstruction": { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. # Corresponds to system_instruction in user-facing GenerateContentRequest. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -17599,7 +17599,7 @@

Method Details

"userDatasetExamples": [ # Output only. Sample user messages in the training dataset uri. { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -17757,7 +17757,7 @@

Method Details

"userDatasetExamples": [ # Output only. Sample user messages in the training dataset uri. { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -18204,7 +18204,7 @@

Method Details

"contents": [ # Multi-turn contents that represents the Prompt. { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -18302,7 +18302,7 @@

Method Details

}, "systemInstruction": { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. # Corresponds to system_instruction in user-facing GenerateContentRequest. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -18639,7 +18639,7 @@

Method Details

}, "sampleResponse": { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. # Required. The sample response for validating the reward configuration. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. diff --git a/docs/dyn/aiplatform_v1beta1.publishers.models.html b/docs/dyn/aiplatform_v1beta1.publishers.models.html index 4b46b80748..e3e2da84cc 100644 --- a/docs/dyn/aiplatform_v1beta1.publishers.models.html +++ b/docs/dyn/aiplatform_v1beta1.publishers.models.html @@ -126,7 +126,7 @@

Method Details

"contents": [ # Optional. Input content. { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -261,7 +261,7 @@

Method Details

"contents": [ # Optional. Input content. { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -530,7 +530,7 @@

Method Details

"model": "A String", # Optional. The name of the publisher model requested to serve the prediction. Format: `projects/{project}/locations/{location}/publishers/*/models/*` "systemInstruction": { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. # Optional. The user provided system instructions for the model. Note: only text should be used in parts and content in each part will be in a separate paragraph. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -942,7 +942,7 @@

Method Details

"contents": [ # Required. The content of the current conversation with the model. For single-turn queries, this is a single instance. For multi-turn queries, this is a repeated field that contains conversation history + latest request. { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -1035,6 +1035,7 @@

Method Details

"role": "A String", # Optional. The producer of the content. Must be either 'user' or 'model'. If not set, the service will default to 'user'. }, ], + "continuationToken": "A String", # Optional. An opaque continuation token used to resume generation from a previous `GenerateContent` or `StreamGenerateContent` response that stopped with `finish_reason` set to `CONTINUATION`. "generationConfig": { # Configuration for content generation. This message contains all the parameters that control how the model generates content. It allows you to influence the randomness, length, and structure of the output. # Optional. Generation config. "audioTimestamp": True or False, # Optional. If enabled, audio timestamps will be included in the request to the model. This can be useful for synchronizing audio with other modalities in the response. "audioTranscriptionConfig": { # Configuration for speech recognition (transcription). # Optional. Configuration for audio transcription (speech recognition). @@ -1221,7 +1222,7 @@

Method Details

], "systemInstruction": { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. # Optional. The user provided system instructions for the model. Note: only text should be used in parts and content in each part will be in a separate paragraph. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -1603,7 +1604,7 @@

Method Details

}, "content": { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. # Output only. The content of the candidate. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -1695,6 +1696,7 @@

Method Details

], "role": "A String", # Optional. The producer of the content. Must be either 'user' or 'model'. If not set, the service will default to 'user'. }, + "continuationToken": "A String", # Output only. An optional opaque continuation token returned when `finish_reason` is `CONTINUATION`. Clients can pass this token in a subsequent `GenerateContentRequest` to continue generation. "finishMessage": "A String", # Output only. Describes the reason the model stopped generating tokens in more detail. This field is returned only when `finish_reason` is set. "finishReason": "A String", # Output only. The reason why the model stopped generating tokens. If empty, the model has not stopped generating. "groundingMetadata": { # Information about the sources that support the content of a response. When grounding is enabled, the model returns citations for claims in the response. This object contains the retrieved sources. # Output only. Metadata returned when grounding is enabled. It contains the sources used to ground the generated content. @@ -1964,7 +1966,7 @@

Method Details

"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). + "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). At most 200 environment variables can be specified. Each variable (`NAME=value`) must be smaller than 128 KiB, and the total size of all variables must not exceed 512 KiB. { # 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. @@ -2157,7 +2159,7 @@

Method Details

"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). + "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). At most 200 environment variables can be specified. Each variable (`NAME=value`) must be smaller than 128 KiB, and the total size of all variables must not exceed 512 KiB. { # 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. @@ -2580,7 +2582,7 @@

Method Details

"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). + "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). At most 200 environment variables can be specified. Each variable (`NAME=value`) must be smaller than 128 KiB, and the total size of all variables must not exceed 512 KiB. { # 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. @@ -2773,7 +2775,7 @@

Method Details

"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). + "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). At most 200 environment variables can be specified. Each variable (`NAME=value`) must be smaller than 128 KiB, and the total size of all variables must not exceed 512 KiB. { # 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. @@ -3231,7 +3233,7 @@

Method Details

"contents": [ # Required. The content of the current conversation with the model. For single-turn queries, this is a single instance. For multi-turn queries, this is a repeated field that contains conversation history + latest request. { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -3324,6 +3326,7 @@

Method Details

"role": "A String", # Optional. The producer of the content. Must be either 'user' or 'model'. If not set, the service will default to 'user'. }, ], + "continuationToken": "A String", # Optional. An opaque continuation token used to resume generation from a previous `GenerateContent` or `StreamGenerateContent` response that stopped with `finish_reason` set to `CONTINUATION`. "generationConfig": { # Configuration for content generation. This message contains all the parameters that control how the model generates content. It allows you to influence the randomness, length, and structure of the output. # Optional. Generation config. "audioTimestamp": True or False, # Optional. If enabled, audio timestamps will be included in the request to the model. This can be useful for synchronizing audio with other modalities in the response. "audioTranscriptionConfig": { # Configuration for speech recognition (transcription). # Optional. Configuration for audio transcription (speech recognition). @@ -3510,7 +3513,7 @@

Method Details

], "systemInstruction": { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. # Optional. The user provided system instructions for the model. Note: only text should be used in parts and content in each part will be in a separate paragraph. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -3892,7 +3895,7 @@

Method Details

}, "content": { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. # Output only. The content of the candidate. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -3984,6 +3987,7 @@

Method Details

], "role": "A String", # Optional. The producer of the content. Must be either 'user' or 'model'. If not set, the service will default to 'user'. }, + "continuationToken": "A String", # Output only. An optional opaque continuation token returned when `finish_reason` is `CONTINUATION`. Clients can pass this token in a subsequent `GenerateContentRequest` to continue generation. "finishMessage": "A String", # Output only. Describes the reason the model stopped generating tokens in more detail. This field is returned only when `finish_reason` is set. "finishReason": "A String", # Output only. The reason why the model stopped generating tokens. If empty, the model has not stopped generating. "groundingMetadata": { # Information about the sources that support the content of a response. When grounding is enabled, the model returns citations for claims in the response. This object contains the retrieved sources. # Output only. Metadata returned when grounding is enabled. It contains the sources used to ground the generated content. diff --git a/docs/dyn/aiplatform_v1beta1.reasoningEngines.html b/docs/dyn/aiplatform_v1beta1.reasoningEngines.html index c4e5dad926..967a3f9e7c 100644 --- a/docs/dyn/aiplatform_v1beta1.reasoningEngines.html +++ b/docs/dyn/aiplatform_v1beta1.reasoningEngines.html @@ -259,7 +259,7 @@

Method Details

{ # A single conversation event. "content": { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. # Required. Represents the content of the event. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -746,7 +746,7 @@

Method Details

{ # A single conversation event. "content": { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. # Required. Represents the content of the event. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -1128,7 +1128,7 @@

Method Details

{ # A single conversation event. "content": { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. # Required. Represents the content of the event. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -1515,7 +1515,7 @@

Method Details

{ # A single conversation event. "content": { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. # Required. Represents the content of the event. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. diff --git a/docs/dyn/aiplatform_v1beta1.reasoningEngines.memories.html b/docs/dyn/aiplatform_v1beta1.reasoningEngines.memories.html index a58c092d45..c98d0090e5 100644 --- a/docs/dyn/aiplatform_v1beta1.reasoningEngines.memories.html +++ b/docs/dyn/aiplatform_v1beta1.reasoningEngines.memories.html @@ -266,7 +266,7 @@

Method Details

{ # A single piece of conversation from which to generate memories. "content": { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. # Required. A single piece of content from which to generate memories. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -502,7 +502,7 @@

Method Details

{ # A single event to ingest. "content": { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. # Required. The content of the event. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. diff --git a/docs/dyn/aiplatform_v1beta1.reasoningEngines.sessions.events.html b/docs/dyn/aiplatform_v1beta1.reasoningEngines.sessions.events.html index 989946d177..d0aebe32e9 100644 --- a/docs/dyn/aiplatform_v1beta1.reasoningEngines.sessions.events.html +++ b/docs/dyn/aiplatform_v1beta1.reasoningEngines.sessions.events.html @@ -128,7 +128,7 @@

Method Details

"author": "A String", # Required. The name of the agent that sent the event, or user. "content": { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. # Optional. Content of the event provided by the author. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. diff --git a/docs/dyn/aiplatform_v1beta1.reasoningEngines.sessions.html b/docs/dyn/aiplatform_v1beta1.reasoningEngines.sessions.html index a29a9cebdc..850d8dbe80 100644 --- a/docs/dyn/aiplatform_v1beta1.reasoningEngines.sessions.html +++ b/docs/dyn/aiplatform_v1beta1.reasoningEngines.sessions.html @@ -136,7 +136,7 @@

Method Details

"author": "A String", # Required. The name of the agent that sent the event, or user. "content": { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. # Optional. Content of the event provided by the author. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. diff --git a/docs/dyn/aiplatform_v1beta1.v1beta1.html b/docs/dyn/aiplatform_v1beta1.v1beta1.html index 280508c362..d92af7c747 100644 --- a/docs/dyn/aiplatform_v1beta1.v1beta1.html +++ b/docs/dyn/aiplatform_v1beta1.v1beta1.html @@ -1378,7 +1378,7 @@

Method Details

"contents": [ # Optional. Repeated contents. { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -1733,7 +1733,7 @@

Method Details

"contents": [ # Optional. Repeated contents. { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -2084,7 +2084,7 @@

Method Details

"contents": [ # Optional. Repeated contents. { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -2184,7 +2184,7 @@

Method Details

"event": [ # Optional. A list of events. { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -2772,7 +2772,7 @@

Method Details

"author": "A String", # Required. The ID of the agent or entity that generated this event. "content": { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. # Required. The content of the event (e.g., text response, tool call, tool response). "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -3378,7 +3378,7 @@

Method Details

"author": "A String", # Required. The ID of the agent or entity that generated this event. Use "user" to denote events generated by the end-user. "content": { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. # Required. The content of the event (e.g., text response, tool call, tool response). "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -3494,7 +3494,7 @@

Method Details

"contents": [ # Optional. Repeated contents. { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -3597,7 +3597,7 @@

Method Details

"contents": [ # Optional. Repeated contents. { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -3698,7 +3698,7 @@

Method Details

"contents": [ # Optional. Repeated contents. { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -3799,7 +3799,7 @@

Method Details

"contents": [ # Optional. Repeated contents. { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -5522,7 +5522,7 @@

Method Details

"contents": [ # Optional. Repeated contents. { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -5664,7 +5664,7 @@

Method Details

"contents": [ # Optional. Repeated contents. { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -6321,7 +6321,7 @@

Method Details

"contents": [ # Optional. Repeated contents. { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. @@ -6669,7 +6669,7 @@

Method Details

"contents": [ # Required. The prompt to generate rubrics from. For single-turn queries, this is a single instance. For multi-turn queries, this is a repeated field that contains conversation history + latest request. { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part. - { # 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`. For media types that are not text, `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. + { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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. "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data. "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set. "text": "A String", # Required. The transcription text of this audio segment. diff --git a/googleapiclient/discovery_cache/documents/aiplatform.v1.json b/googleapiclient/discovery_cache/documents/aiplatform.v1.json index c1bf5c511e..d7855f8b32 100644 --- a/googleapiclient/discovery_cache/documents/aiplatform.v1.json +++ b/googleapiclient/discovery_cache/documents/aiplatform.v1.json @@ -4087,6 +4087,105 @@ } } }, +"interactions": { +"methods": { +"cancel": { +"description": "Cancels an interaction.", +"flatPath": "v1/interactions/{interactionsId}:cancel", +"httpMethod": "POST", +"id": "aiplatform.interactions.cancel", +"parameterOrder": [ +"name" +], +"parameters": { +"name": { +"description": "Required. The name of the interaction to cancel. Format: `interactions/{interaction}`.", +"location": "path", +"pattern": "^interactions/[^/]+$", +"required": true, +"type": "string" +} +}, +"path": "v1/{+name}:cancel", +"response": { +"$ref": "GenaiVertexV1Interaction" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform" +] +}, +"getPoll": { +"description": "Fully typed proto, unary version of GetInteraction that returns Interaction proto.", +"flatPath": "v1/interactions/{interactionsId}:poll", +"httpMethod": "GET", +"id": "aiplatform.interactions.getPoll", +"parameterOrder": [ +"name" +], +"parameters": { +"lastEventId": { +"description": "If set, resumes the interaction stream from the chunk after the event marked by the event id. Can only be used if `stream` is true.", +"location": "query", +"type": "string" +}, +"name": { +"description": "Required. The name of the interaction to retrieve. Format: interactions/{interaction}", +"location": "path", +"pattern": "^interactions/[^/]+$", +"required": true, +"type": "string" +}, +"stream": { +"description": "If true, streams the interaction events as Server-Sent Events.", +"location": "query", +"type": "boolean" +} +}, +"path": "v1/{+name}:poll", +"response": { +"$ref": "GenaiVertexV1Interaction" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform" +] +}, +"getStream": { +"description": "Fully typed proto, streaming version of GetInteraction that returns Interaction proto.", +"flatPath": "v1/interactions/{interactionsId}:stream", +"httpMethod": "GET", +"id": "aiplatform.interactions.getStream", +"parameterOrder": [ +"name" +], +"parameters": { +"lastEventId": { +"description": "If set, resumes the interaction stream from the chunk after the event marked by the event id. Can only be used if `stream` is true.", +"location": "query", +"type": "string" +}, +"name": { +"description": "Required. The name of the interaction to retrieve. Format: interactions/{interaction}", +"location": "path", +"pattern": "^interactions/[^/]+$", +"required": true, +"type": "string" +}, +"stream": { +"description": "If true, streams the interaction events as Server-Sent Events.", +"location": "query", +"type": "boolean" +} +}, +"path": "v1/{+name}:stream", +"response": { +"$ref": "GenaiVertexV1InteractionStreamingEvent" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform" +] +} +} +}, "media": { "methods": { "upload": { @@ -16928,6 +17027,192 @@ } } }, +"interactions": { +"methods": { +"create": { +"description": "Creates an interaction.", +"flatPath": "v1/projects/{projectsId}/locations/{locationsId}/interactions:create", +"httpMethod": "POST", +"id": "aiplatform.projects.locations.interactions.create", +"parameterOrder": [ +"projectsId", +"locationsId" +], +"parameters": { +"locationsId": { +"location": "path", +"required": true, +"type": "string" +}, +"projectsId": { +"location": "path", +"required": true, +"type": "string" +} +}, +"path": "v1/projects/{projectsId}/locations/{locationsId}/interactions:create", +"request": { +"$ref": "GenaiVertexV1CreateInteractionRequest" +}, +"response": { +"$ref": "GenaiVertexV1Interaction" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform" +] +}, +"createStream": { +"description": "Creates an interaction and streams the response.", +"flatPath": "v1/projects/{projectsId}/locations/{locationsId}/interactions:createStream", +"httpMethod": "POST", +"id": "aiplatform.projects.locations.interactions.createStream", +"parameterOrder": [ +"projectsId", +"locationsId" +], +"parameters": { +"locationsId": { +"location": "path", +"required": true, +"type": "string" +}, +"projectsId": { +"location": "path", +"required": true, +"type": "string" +} +}, +"path": "v1/projects/{projectsId}/locations/{locationsId}/interactions:createStream", +"request": { +"$ref": "GenaiVertexV1CreateInteractionRequest" +}, +"response": { +"$ref": "GenaiVertexV1InteractionStreamingEvent" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform" +] +}, +"delete": { +"deprecated": true, +"description": "Deletes an interaction.", +"flatPath": "v1/projects/{projectsId}/locations/{locationsId}/interactions/{interactionsId}", +"httpMethod": "DELETE", +"id": "aiplatform.projects.locations.interactions.delete", +"parameterOrder": [ +"name" +], +"parameters": { +"name": { +"description": "Required. The name of the interaction to delete. Format: interactions/{interaction}", +"location": "path", +"pattern": "^projects/[^/]+/locations/[^/]+/interactions/[^/]+$", +"required": true, +"type": "string" +} +}, +"path": "v1/{+name}", +"response": { +"$ref": "GenaiVertexV1DeleteInteractionResponse" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform" +] +} +} +}, +"interactionsHttp": { +"methods": { +"cancel": { +"description": "Cancels an interaction by id. This only applies to background interactions that are still running.", +"flatPath": "v1/projects/{projectsId}/locations/{locationsId}/interactionsHttp/{interactionsHttpId}/cancel", +"httpMethod": "POST", +"id": "aiplatform.projects.locations.interactionsHttp.cancel", +"parameterOrder": [ +"name" +], +"parameters": { +"name": { +"description": "Required. The name of the interaction to cancel. Format: `interactions/{interaction}`.", +"location": "path", +"pattern": "^projects/[^/]+/locations/[^/]+/interactionsHttp/[^/]+$", +"required": true, +"type": "string" +} +}, +"path": "v1/{+name}/cancel", +"response": { +"$ref": "GoogleApiHttpBody" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform" +] +}, +"create": { +"description": "Creates a new interaction.", +"flatPath": "v1/projects/{projectsId}/locations/{locationsId}/interactionsHttp", +"httpMethod": "POST", +"id": "aiplatform.projects.locations.interactionsHttp.create", +"parameterOrder": [ +"parent" +], +"parameters": { +"parent": { +"description": "Required. The parent resource where this interaction will be created. Format: `projects/{project}/locations/{location}` Supported only by the Vertex API only.", +"location": "path", +"pattern": "^projects/[^/]+/locations/[^/]+$", +"required": true, +"type": "string" +} +}, +"path": "v1/{+parent}/interactionsHttp", +"request": { +"$ref": "GenaiVertexV1CreateInteractionHttpRequest" +}, +"response": { +"$ref": "GoogleApiHttpBody" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform" +] +}, +"get": { +"description": "Retrieves the full details of a single interaction based on its `Interaction.id`.", +"flatPath": "v1/projects/{projectsId}/locations/{locationsId}/interactionsHttp/{interactionsHttpId}", +"httpMethod": "GET", +"id": "aiplatform.projects.locations.interactionsHttp.get", +"parameterOrder": [ +"name" +], +"parameters": { +"lastEventId": { +"description": "If set, resumes the interaction stream from the chunk after the event marked by the event id. Can only be used if `stream` is true.", +"location": "query", +"type": "string" +}, +"name": { +"description": "Required. The name of the interaction to retrieve. Format: interactions/{interaction}", +"location": "path", +"pattern": "^projects/[^/]+/locations/[^/]+/interactionsHttp/[^/]+$", +"required": true, +"type": "string" +}, +"stream": { +"description": "If true, streams the interaction events as Server-Sent Events.", +"location": "query", +"type": "boolean" +} +}, +"path": "v1/{+name}", +"response": { +"$ref": "GoogleApiHttpBody" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform" +] +} +} +}, "memoryBanks": { "methods": { "ingestEvents": { @@ -36860,7 +37145,7 @@ } } }, -"revision": "20261007", +"revision": "20261012", "rootUrl": "https://aiplatform.googleapis.com/", "schemas": { "CloudAiLargeModelsVisionExperimentsResponse": { @@ -37220,6 +37505,10 @@ "\"8K UDiT, downsampled 2x in the decoder." ], "type": "string" +}, +"tileSmoothing": { +"description": "Smooths the seams between the tiles the model upscales separately.", +"type": "boolean" } }, "type": "object" @@ -37807,269 +38096,3745 @@ }, "type": "object" }, -"GoogleApiHttpBody": { -"description": "Message that represents an arbitrary HTTP body. It should only be used for payload formats that can't be represented as JSON, such as raw binary or an HTML page. This message can be used both in streaming and non-streaming API methods in the request as well as the response. It can be used as a top-level request field, which is convenient if one wants to extract parameters from either the URL or HTTP template into the request fields and also want access to the raw HTTP body. Example: message GetResourceRequest { // A unique request id. string request_id = 1; // The raw HTTP body is bound to this field. google.api.HttpBody http_body = 2; } service ResourceService { rpc GetResource(GetResourceRequest) returns (google.api.HttpBody); rpc UpdateResource(google.api.HttpBody) returns (google.protobuf.Empty); } Example with streaming methods: service CaldavService { rpc GetCalendar(stream google.api.HttpBody) returns (stream google.api.HttpBody); rpc UpdateCalendar(stream google.api.HttpBody) returns (stream google.api.HttpBody); } Use of this type only changes how the request and response bodies are handled, all other features will continue to work unchanged.", -"id": "GoogleApiHttpBody", +"GenaiVertexV1AgentInteraction": { +"description": "Interaction for generating the completion using agents.", +"id": "GenaiVertexV1AgentInteraction", "properties": { -"contentType": { -"description": "The HTTP Content-Type header value specifying the content type of the body.", +"agent": { +"description": "The name of the `Agent` used for generating the completion.", "type": "string" }, -"data": { -"description": "The HTTP request/response body as raw binary.", -"format": "byte", -"type": "string" +"antigravityConfig": { +"$ref": "GenaiVertexV1AntigravityAgentConfig", +"description": "Antigravity agent configuration. This configuration is session-level settings that are passed to the agent runtime on a per-request basis." }, -"extensions": { -"description": "Application specific response metadata. Must be set in the first response for streaming APIs.", -"items": { -"additionalProperties": { -"description": "Properties of the object. Contains field @type with type URL.", -"type": "any" +"codeMenderConfig": { +"$ref": "GenaiVertexV1CodeMenderAgentConfig" +}, +"deepResearchConfig": { +"$ref": "GenaiVertexV1DeepResearchAgentConfig" +}, +"dynamicConfig": { +"$ref": "GenaiVertexV1DynamicAgentConfig" +} }, "type": "object" }, +"GenaiVertexV1AllowedTools": { +"description": "The configuration for allowed tools.", +"id": "GenaiVertexV1AllowedTools", +"properties": { +"mode": { +"description": "The mode of the tool choice.", +"enum": [ +"TOOL_CHOICE_TYPE_UNSPECIFIED", +"AUTO", +"ANY", +"NONE", +"VALIDATED" +], +"enumDescriptions": [ +"Default value. This value is unused.", +"Auto tool choice.", +"Any tool choice.", +"No tool choice.", +"Validated tool choice." +], +"type": "string" +}, +"tools": { +"description": "The names of the allowed tools.", +"items": { +"type": "string" +}, "type": "array" } }, "type": "object" }, -"GoogleCloudAiplatformV1ActivateOnlineEvaluatorOperationMetadata": { -"description": "Metadata for the ActivateOnlineEvaluator operation.", -"id": "GoogleCloudAiplatformV1ActivateOnlineEvaluatorOperationMetadata", +"GenaiVertexV1AntigravityAgentConfig": { +"description": "Configuration for the Antigravity agent runtime. Provides server-side control over the agent's execution environment and tool configuration.", +"id": "GenaiVertexV1AntigravityAgentConfig", "properties": { -"genericMetadata": { -"$ref": "GoogleCloudAiplatformV1GenericOperationMetadata", -"description": "Common part of operation metadata." +"maxTotalTokens": { +"description": "Max total tokens for the agent run.", +"format": "int64", +"type": "string" +}, +"model": { +"description": "The model to use for agent reasoning.", +"type": "string" } }, "type": "object" }, -"GoogleCloudAiplatformV1ActivateOnlineEvaluatorRequest": { -"description": "Request message for ActivateOnlineEvaluator.", -"id": "GoogleCloudAiplatformV1ActivateOnlineEvaluatorRequest", -"properties": {}, +"GenaiVertexV1ArgumentsDelta": { +"id": "GenaiVertexV1ArgumentsDelta", +"properties": { +"arguments": { +"type": "string" +} +}, "type": "object" }, -"GoogleCloudAiplatformV1ActiveLearningConfig": { -"description": "Parameters that configure the active learning pipeline. Active learning will label the data incrementally by several iterations. For every iteration, it will select a batch of data based on the sampling strategy.", -"id": "GoogleCloudAiplatformV1ActiveLearningConfig", +"GenaiVertexV1AudioContent": { +"description": "An audio content block. ", +"id": "GenaiVertexV1AudioContent", "properties": { -"maxDataItemCount": { -"description": "Max number of human labeled DataItems.", -"format": "int64", +"channels": { +"description": "The number of audio channels.", +"format": "int32", +"type": "integer" +}, +"data": { +"description": "The audio content.", +"format": "byte", "type": "string" }, -"maxDataItemPercentage": { -"description": "Max percent of total DataItems for human labeling.", +"mimeTypeString": { +"description": "Flexible MIME type string of the audio, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the \"mime_type\" JSON key.", +"type": "string" +}, +"sampleRate": { +"description": "The sample rate of the audio.", "format": "int32", "type": "integer" }, -"sampleConfig": { -"$ref": "GoogleCloudAiplatformV1SampleConfig", -"description": "Active learning data sampling config. For every active learning labeling iteration, it will select a batch of data based on the sampling strategy." -}, -"trainingConfig": { -"$ref": "GoogleCloudAiplatformV1TrainingConfig", -"description": "CMLE training config. For every active learning labeling iteration, system will train a machine learning model on CMLE. The trained model will be used by data sampling algorithm to select DataItems." +"uri": { +"description": "The URI of the audio.", +"type": "string" } }, "type": "object" }, -"GoogleCloudAiplatformV1AddContextArtifactsAndExecutionsRequest": { -"description": "Request message for MetadataService.AddContextArtifactsAndExecutions.", -"id": "GoogleCloudAiplatformV1AddContextArtifactsAndExecutionsRequest", +"GenaiVertexV1AudioDelta": { +"id": "GenaiVertexV1AudioDelta", "properties": { -"artifacts": { -"description": "The resource names of the Artifacts to attribute to the Context. Format: `projects/{project}/locations/{location}/metadataStores/{metadatastore}/artifacts/{artifact}`", -"items": { -"type": "string" +"channels": { +"description": "The number of audio channels.", +"format": "int32", +"type": "integer" }, -"type": "array" +"data": { +"format": "byte", +"type": "string" }, -"executions": { -"description": "The resource names of the Executions to associate with the Context. Format: `projects/{project}/locations/{location}/metadataStores/{metadatastore}/executions/{execution}`", -"items": { +"mimeType": { +"enum": [ +"TYPE_UNSPECIFIED", +"TYPE_WAV", +"TYPE_MP3", +"TYPE_AIFF", +"TYPE_AAC", +"TYPE_OGG", +"TYPE_FLAC", +"TYPE_MPEG", +"TYPE_M4A", +"TYPE_L16", +"TYPE_OPUS", +"TYPE_ALAW", +"TYPE_MULAW", +"TYPE_WEBM" +], +"enumDescriptions": [ +"", +"WAV audio format", +"MP3 audio format", +"AIFF audio format", +"AAC audio format", +"OGG audio format", +"FLAC audio format", +"MPEG audio format", +"M4A audio format", +"L16 audio format", +"OPUS audio format", +"ALAW audio format", +"MULAW audio format", +"WEBM audio format" +], "type": "string" }, -"type": "array" -} +"sampleRate": { +"description": "The sample rate of the audio.", +"format": "int32", +"type": "integer" }, -"type": "object" +"uri": { +"type": "string" +} }, -"GoogleCloudAiplatformV1AddContextArtifactsAndExecutionsResponse": { -"description": "Response message for MetadataService.AddContextArtifactsAndExecutions.", -"id": "GoogleCloudAiplatformV1AddContextArtifactsAndExecutionsResponse", -"properties": {}, "type": "object" }, -"GoogleCloudAiplatformV1AddContextChildrenRequest": { -"description": "Request message for MetadataService.AddContextChildren.", -"id": "GoogleCloudAiplatformV1AddContextChildrenRequest", +"GenaiVertexV1AudioResponseFormat": { +"description": "Configuration for audio output format.", +"id": "GenaiVertexV1AudioResponseFormat", "properties": { -"childContexts": { -"description": "The resource names of the child Contexts.", -"items": { +"bitRate": { +"description": "Bit rate in bits per second (bps). Only applicable for compressed formats (MP3, Opus).", +"format": "int32", +"type": "integer" +}, +"delivery": { +"description": "The delivery mode for the audio output.", +"enum": [ +"DELIVERY_UNSPECIFIED", +"INLINE", +"URI" +], +"enumDescriptions": [ +"Default value. This value is unused.", +"Audio data is returned inline in the response.", +"Audio data is returned as a URI." +], "type": "string" }, -"type": "array" +"mimeType": { +"description": "The MIME type of the audio output.", +"enum": [ +"TYPE_UNSPECIFIED", +"TYPE_MP3", +"TYPE_OGG_OPUS", +"TYPE_L16", +"TYPE_WAV", +"TYPE_ALAW", +"TYPE_MULAW" +], +"enumDescriptions": [ +"Default value. This value is unused.", +"MP3 audio format.", +"OGG Opus audio format.", +"Raw PCM (L16) audio format.", +"WAV audio format.", +"A-law audio format.", +"Mu-law audio format." +], +"type": "string" +}, +"sampleRate": { +"description": "Sample rate in Hz.", +"format": "int32", +"type": "integer" } }, "type": "object" }, -"GoogleCloudAiplatformV1AddContextChildrenResponse": { -"description": "Response message for MetadataService.AddContextChildren.", -"id": "GoogleCloudAiplatformV1AddContextChildrenResponse", +"GenaiVertexV1CodeExecution": { +"description": "A tool that can be used by the model to execute code.", +"id": "GenaiVertexV1CodeExecution", "properties": {}, "type": "object" }, -"GoogleCloudAiplatformV1AddExecutionEventsRequest": { -"description": "Request message for MetadataService.AddExecutionEvents.", -"id": "GoogleCloudAiplatformV1AddExecutionEventsRequest", +"GenaiVertexV1CodeExecutionCallContentCodeExecutionCallArguments": { +"description": "The arguments to pass to the code execution.", +"id": "GenaiVertexV1CodeExecutionCallContentCodeExecutionCallArguments", "properties": { -"events": { -"description": "The Events to create and add.", -"items": { -"$ref": "GoogleCloudAiplatformV1Event" +"code": { +"description": "The code to be executed.", +"type": "string" }, -"type": "array" +"language": { +"description": "Programming language of the `code`.", +"enum": [ +"LANGUAGE_UNSPECIFIED", +"PYTHON" +], +"enumDescriptions": [ +"Unspecified language. This value should not be used.", +"Python >= 3.10, with numpy and simpy available." +], +"type": "string" } }, "type": "object" }, -"GoogleCloudAiplatformV1AddExecutionEventsResponse": { -"description": "Response message for MetadataService.AddExecutionEvents.", -"id": "GoogleCloudAiplatformV1AddExecutionEventsResponse", -"properties": {}, +"GenaiVertexV1CodeExecutionCallDelta": { +"id": "GenaiVertexV1CodeExecutionCallDelta", +"properties": { +"arguments": { +"$ref": "GenaiVertexV1CodeExecutionCallContentCodeExecutionCallArguments" +} +}, "type": "object" }, -"GoogleCloudAiplatformV1AddTrialMeasurementRequest": { -"description": "Request message for VizierService.AddTrialMeasurement.", -"id": "GoogleCloudAiplatformV1AddTrialMeasurementRequest", +"GenaiVertexV1CodeExecutionCallStep": { +"description": "Code execution call step.", +"id": "GenaiVertexV1CodeExecutionCallStep", "properties": { -"measurement": { -"$ref": "GoogleCloudAiplatformV1Measurement", -"description": "Required. The measurement to be added to a Trial." +"arguments": { +"$ref": "GenaiVertexV1CodeExecutionCallStepCodeExecutionCallStepArguments", +"description": "Required. The arguments to pass to the code execution." } }, "type": "object" }, -"GoogleCloudAiplatformV1Agent": { -"description": "A Vertex agent contains instructions and configurations for the LLM to execute a certain task.", -"id": "GoogleCloudAiplatformV1Agent", +"GenaiVertexV1CodeExecutionCallStepCodeExecutionCallStepArguments": { +"description": "The arguments to pass to the code execution.", +"id": "GenaiVertexV1CodeExecutionCallStepCodeExecutionCallStepArguments", "properties": { -"base_agent": { -"description": "Required. Immutable. The base agent for the agent. Supported values: * `antigravity-preview-05-2026` Immutable: `UpdateAgent` rejects a change, including clearing it. The kind of agent this is gets derived from this field when the agent is created and is recorded then; nothing recomputes it afterwards, so a later change would leave the agent described as one kind and behaving as another. Create a new agent instead.", +"code": { +"description": "The code to be executed.", "type": "string" }, -"base_environment": { -"description": "Optional. The base environment configuration for the agent. Valid types: * A string value for the environment ID, or `remote` for the default. * A struct value for the `environment_config`.", -"type": "any" -}, -"created": { -"description": "Output only. The time the agent was created.", -"format": "google-datetime", -"readOnly": true, +"language": { +"description": "Programming language of the `code`.", +"enum": [ +"LANGUAGE_UNSPECIFIED", +"PYTHON" +], +"enumDescriptions": [ +"Unspecified language. This value should not be used.", +"Python >= 3.10, with numpy and simpy available." +], "type": "string" +} }, -"description": { -"description": "Optional. The description of the agent.", -"type": "string" +"type": "object" }, -"id": { -"description": "Immutable. The user-specified ID for the agent. This ID becomes the final component of the agent resource name. If not provided, Vertex AI will generate a value for this ID. The ID can be up to 63 characters and must match the regular expression `[a-z]([a-z0-9-]{0,61}[a-z0-9])?`.", -"type": "string" +"GenaiVertexV1CodeExecutionResultDelta": { +"id": "GenaiVertexV1CodeExecutionResultDelta", +"properties": { +"isError": { +"type": "boolean" }, -"metadata": { -"additionalProperties": { +"result": { "type": "string" +} }, -"description": "Optional. The metadata for the agent.", "type": "object" }, -"modelConfig": { -"$ref": "GoogleCloudAiplatformV1AgentModelConfig", -"description": "Optional. Model configuration for the agent. When set, tasks running under this agent default to this model configuration if they do not specify their own." +"GenaiVertexV1CodeExecutionResultStep": { +"description": "Code execution result step.", +"id": "GenaiVertexV1CodeExecutionResultStep", +"properties": { +"isError": { +"description": "Whether the code execution resulted in an error.", +"type": "boolean" }, -"name": { -"description": "Identifier. The resource name of the agent. Format: `projects/{project}/locations/{location}/agents/{agent}`.", +"result": { +"description": "Required. The output of the code execution.", "type": "string" +} }, -"object": { -"description": "Output only. The object type of the resource. For agents, the value is `agent`.", -"readOnly": true, -"type": "string" +"type": "object" }, -"observabilityConfig": { -"$ref": "GoogleCloudAiplatformV1ObservabilityConfig", -"description": "Optional. Observability settings for this agent's sessions." +"GenaiVertexV1CodeMenderAgentConfig": { +"description": "Configuration for the CodeMender agent.", +"id": "GenaiVertexV1CodeMenderAgentConfig", +"properties": { +"findRequest": { +"$ref": "GenaiVertexV1CodeMenderAgentConfigFindRequest", +"description": "Parameters for finding vulnerabilities." }, -"system_instruction": { -"description": "Optional. The instructions for the agent to follow. These instructions are passed to the LLM as a system instruction.", -"type": "string" +"fixRequest": { +"$ref": "GenaiVertexV1CodeMenderAgentConfigFixRequest", +"description": "Parameters for fixing vulnerabilities." }, -"tools": { -"description": "Optional. The tools available to the agent.", -"items": { -"$ref": "GoogleCloudAiplatformV1AgentTool" +"model": { +"description": "The name of the model to use for the CodeMender agent. One CodeMender session will only use one model.", +"type": "string" }, -"type": "array" +"sessionConfig": { +"$ref": "GenaiVertexV1CodeMenderAgentConfigSessionConfig", +"description": "Optional session-specific configurations to override default agent behavior." }, -"updated": { -"description": "Output only. The time the agent was last updated.", -"format": "google-datetime", -"readOnly": true, +"sessionId": { +"description": "Parameter for grouping multiple interactions that belong to the same CodeMender session.", "type": "string" } }, "type": "object" }, -"GoogleCloudAiplatformV1AgentConfig": { -"description": "Represents configuration for an Agent.", -"id": "GoogleCloudAiplatformV1AgentConfig", +"GenaiVertexV1CodeMenderAgentConfigFileContent": { +"description": "Content of a single file in the codebase.", +"id": "GenaiVertexV1CodeMenderAgentConfigFileContent", "properties": { -"agentId": { -"description": "Required. Unique identifier of the agent. This ID is used to refer to this agent, e.g., in AgentEvent.author, or in the `sub_agents` field. It must be unique within the `agents` map.", +"content": { +"description": "The UTF-8 encoded text content of the file.", "type": "string" }, -"agentType": { -"description": "Optional. The type or class of the agent (e.g., \"LlmAgent\", \"RouterAgent\", \"ToolUseAgent\"). Useful for the autorater to understand the expected behavior of the agent.", +"path": { +"description": "The relative path of the file from the project root.", "type": "string" +} +}, +"type": "object" }, +"GenaiVertexV1CodeMenderAgentConfigFindRequest": { +"description": "Request parameters specific to FIND sessions, used for discovering vulnerabilities in a codebase.", +"id": "GenaiVertexV1CodeMenderAgentConfigFindRequest", +"properties": { "description": { -"description": "Optional. A high-level description of the agent's role and responsibilities. Critical for evaluating if the agent is routing tasks correctly.", +"description": "Additional context or custom instructions provided by the user to guide the vulnerability analysis.", "type": "string" }, -"instruction": { -"description": "Optional. Provides instructions for the LLM model, guiding the agent's behavior. Can be static or dynamic. Dynamic instructions can contain placeholders like {variable_name} that will be resolved at runtime using the `AgentEvent.state_delta` field.", +"findingId": { +"description": "The identifier of a specific finding to verify. This is primarily used in VERIFY mode to focus the agent's execution-based validation on a single vulnerability.", "type": "string" }, -"subAgents": { -"description": "Optional. The list of valid agent IDs that this agent can delegate to. This defines the directed edges in the multi-agent system graph topology.", -"items": { +"mode": { +"description": "The mode of the find session.", +"enum": [ +"MODE_UNSPECIFIED", +"MODE_SCAN", +"MODE_VERIFY" +], +"enumDescriptions": [ +"Default value. This value is unused.", +"Fast scan using only the initial classifier.", +"Performs classification followed by detailed investigation." +], "type": "string" }, -"type": "array" -}, -"tools": { -"description": "Optional. The list of tools available to this agent.", +"sourceFiles": { +"description": "A list of source files to provide as context for the scan.", "items": { -"$ref": "GoogleCloudAiplatformV1Tool" +"$ref": "GenaiVertexV1CodeMenderAgentConfigFileContent" }, "type": "array" } }, "type": "object" }, -"GoogleCloudAiplatformV1AgentData": { -"description": "Represents data specific to multi-turn agent evaluations.", -"id": "GoogleCloudAiplatformV1AgentData", +"GenaiVertexV1CodeMenderAgentConfigFixRequest": { +"description": "Request parameters specific to FIX sessions, used for generating and validating security patches.", +"id": "GenaiVertexV1CodeMenderAgentConfigFixRequest", "properties": { -"agents": { -"additionalProperties": { -"$ref": "GoogleCloudAiplatformV1AgentConfig" +"description": { +"description": "Additional context or custom instructions provided by the user to guide the patch generation process.", +"type": "string" }, -"description": "Optional. A map containing the static configurations for each agent in the system. Key: agent_id (matches the `author` field in events). Value: The static configuration of the agent.", +"findingId": { +"description": "The identifier of the specific security finding to be remediated. This ID maps to a previously discovered vulnerability.", +"type": "string" +}, +"sourceFiles": { +"description": "A list of source files providing context for the remediation. These files are typically the ones containing the identified vulnerability.", +"items": { +"$ref": "GenaiVertexV1CodeMenderAgentConfigFileContent" +}, +"type": "array" +} +}, +"type": "object" +}, +"GenaiVertexV1CodeMenderAgentConfigSessionConfig": { +"description": "The configuration of CodeMender sessions.", +"id": "GenaiVertexV1CodeMenderAgentConfigSessionConfig", +"properties": { +"maxRounds": { +"description": "The maximum number of interaction rounds the agent is allowed to perform before reaching a timeout.", +"format": "int32", +"type": "integer" +} +}, +"type": "object" +}, +"GenaiVertexV1ComputerUse": { +"description": "A tool that can be used by the model to interact with the computer.", +"id": "GenaiVertexV1ComputerUse", +"properties": { +"disabledSafetyPolicies": { +"description": "Optional. Disabled safety policies for computer use.", +"items": { +"enum": [ +"SAFETY_POLICY_UNSPECIFIED", +"FINANCIAL_TRANSACTIONS", +"SENSITIVE_DATA_MODIFICATION", +"COMMUNICATION_TOOL", +"ACCOUNT_CREATION", +"DATA_MODIFICATION", +"USER_CONSENT_MANAGEMENT", +"LEGAL_TERMS_AND_AGREEMENTS" +], +"enumDescriptions": [ +"Unspecified safety policy.", +"Safety policy for financial transactions.", +"Safety policy for sensitive data modification.", +"Safety policy for communication tools (e.g. Gmail, Chat, Meet).", +"Safety policy for account creation.", +"Safety policy for data modification.", +"Safety policy for user consent management.", +"Safety policy for legal terms and agreements." +], +"type": "string" +}, +"type": "array" +}, +"enablePromptInjectionDetection": { +"description": "Whether enable the prompt injection detection check on computer-use request.", +"type": "boolean" +}, +"environment": { +"description": "The environment being operated.", +"enum": [ +"ENVIRONMENT_UNSPECIFIED", +"BROWSER", +"MOBILE", +"DESKTOP" +], +"enumDescriptions": [ +"Defaults to browser.", +"Operates in a web browser.", +"Operates in a mobile environment.", +"Operates in a desktop environment." +], +"type": "string" +}, +"excludedPredefinedFunctions": { +"description": "The list of predefined functions that are excluded from the model call.", +"items": { +"type": "string" +}, +"type": "array" +} +}, +"type": "object" +}, +"GenaiVertexV1Content": { +"description": "The content of the response.", +"id": "GenaiVertexV1Content", +"properties": { +"audio": { +"$ref": "GenaiVertexV1AudioContent" +}, +"document": { +"$ref": "GenaiVertexV1DocumentContent" +}, +"image": { +"$ref": "GenaiVertexV1ImageContent" +}, +"text": { +"$ref": "GenaiVertexV1TextContent" +}, +"video": { +"$ref": "GenaiVertexV1VideoContent" +} +}, +"type": "object" +}, +"GenaiVertexV1ContentList": { +"description": "A list of Content.", +"id": "GenaiVertexV1ContentList", +"properties": { +"contents": { +"description": "The contents of the list.", +"items": { +"$ref": "GenaiVertexV1Content" +}, +"type": "array" +} +}, +"type": "object" +}, +"GenaiVertexV1CreateInteractionHttpRequest": { +"description": "Request message for [InteractionsService.CreateInteractionHttp].", +"id": "GenaiVertexV1CreateInteractionHttpRequest", +"properties": { +"httpBody": { +"$ref": "GoogleApiHttpBody", +"description": "Required. The interaction to create." +} +}, +"type": "object" +}, +"GenaiVertexV1CreateInteractionRequest": { +"description": "Configuration parameters for creating an interaction.", +"id": "GenaiVertexV1CreateInteractionRequest", +"properties": { +"background": { +"description": "Input only. Whether to run the model interaction in the background.", +"type": "boolean" +}, +"interaction": { +"$ref": "GenaiVertexV1Interaction", +"description": "The interaction to create." +}, +"store": { +"description": "Input only. Whether to store the response and request for later retrieval.", +"type": "boolean" +}, +"stream": { +"description": "Input only. Whether the interaction will be streamed.", +"type": "boolean" +} +}, +"type": "object" +}, +"GenaiVertexV1DeepResearchAgentConfig": { +"description": "Configuration for the Deep Research agent.", +"id": "GenaiVertexV1DeepResearchAgentConfig", +"properties": { +"collaborativePlanning": { +"description": "Enables human-in-the-loop planning for the Deep Research agent. If set to true, the Deep Research agent will provide a research plan in its response. The agent will then proceed only if the user confirms the plan in the next turn.", +"type": "boolean" +}, +"enableBigqueryTool": { +"description": "Enables bigquery tool for the Deep Research agent.", +"type": "boolean" +}, +"thinkingSummaries": { +"description": "Whether to include thought summaries in the response.", +"enum": [ +"THINKING_SUMMARIES_UNSPECIFIED", +"THINKING_SUMMARIES_AUTO", +"THINKING_SUMMARIES_NONE" +], +"enumDescriptions": [ +"Default value. This value is unused.", +"Auto thinking summaries.", +"No thinking summaries." +], +"type": "string" +}, +"visualization": { +"description": "Whether to include visualizations in the response.", +"enum": [ +"UNSPECIFIED", +"OFF", +"AUTO" +], +"enumDescriptions": [ +"The default visualization mode. Will default to AUTO.", +"Do not include visualizations.", +"Automatically include visualizations." +], +"type": "string" +} +}, +"type": "object" +}, +"GenaiVertexV1DeleteInteractionResponse": { +"description": "Response for InteractionService.DeleteInteraction.", +"id": "GenaiVertexV1DeleteInteractionResponse", +"properties": {}, +"type": "object" +}, +"GenaiVertexV1DocumentContent": { +"description": "A document content block. ", +"id": "GenaiVertexV1DocumentContent", +"properties": { +"data": { +"description": "The document content.", +"format": "byte", +"type": "string" +}, +"mimeTypeString": { +"description": "Flexible MIME type string of the document, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the \"mime_type\" JSON key.", +"type": "string" +}, +"uri": { +"description": "The URI of the document.", +"type": "string" +} +}, +"type": "object" +}, +"GenaiVertexV1DocumentDelta": { +"id": "GenaiVertexV1DocumentDelta", +"properties": { +"data": { +"format": "byte", +"type": "string" +}, +"mimeType": { +"enum": [ +"TYPE_UNSPECIFIED", +"TYPE_PDF", +"TYPE_CSV" +], +"enumDescriptions": [ +"", +"PDF document format", +"CSV document format" +], +"type": "string" +}, +"uri": { +"type": "string" +} +}, +"type": "object" +}, +"GenaiVertexV1DynamicAgentConfig": { +"description": "Configuration for dynamic agents.", +"id": "GenaiVertexV1DynamicAgentConfig", +"properties": { +"config": { +"$ref": "GenaiVertexV1Struct", +"description": "For agents that are not supported statically in the API definition." +} +}, +"type": "object" +}, +"GenaiVertexV1Error": { +"description": "Error message from an interaction.", +"id": "GenaiVertexV1Error", +"properties": { +"code": { +"description": "A URI that identifies the error type.", +"type": "string" +}, +"message": { +"description": "A human-readable error message.", +"type": "string" +} +}, +"type": "object" +}, +"GenaiVertexV1ErrorEvent": { +"id": "GenaiVertexV1ErrorEvent", +"properties": { +"error": { +"$ref": "GenaiVertexV1Error" +} +}, +"type": "object" +}, +"GenaiVertexV1ExaAISearchConfig": { +"description": "Used to specify configuration for ExaAISearch.", +"id": "GenaiVertexV1ExaAISearchConfig", +"properties": { +"apiKey": { +"description": "Required. The API key for ExaAiSearch.", +"type": "string" +}, +"customConfig": { +"additionalProperties": { +"description": "Properties of the object.", +"type": "any" +}, +"description": "Optional. This field can be used to pass any parameter from the Exa.ai Search API.", +"type": "object" +} +}, +"type": "object" +}, +"GenaiVertexV1Field": { +"description": "Represents a single field in a struct.", +"id": "GenaiVertexV1Field", +"properties": { +"name": { +"type": "string" +}, +"value": { +"$ref": "GenaiVertexV1Value" +} +}, +"type": "object" +}, +"GenaiVertexV1FileCitation": { +"description": "A file citation annotation.", +"id": "GenaiVertexV1FileCitation", +"properties": { +"customMetadata": { +"additionalProperties": { +"description": "Properties of the object.", +"type": "any" +}, +"description": "User provided metadata about the retrieved context.", +"type": "object" +}, +"documentUri": { +"description": "The URI of the file.", +"type": "string" +}, +"fileName": { +"description": "The name of the file.", +"type": "string" +}, +"mediaId": { +"description": "Media ID in-case of image citations, if applicable.", +"type": "string" +}, +"pageNumber": { +"description": "Page number of the cited document, if applicable.", +"format": "int32", +"type": "integer" +}, +"source": { +"description": "Source attributed for a portion of the text.", +"type": "string" +} +}, +"type": "object" +}, +"GenaiVertexV1FileSearch": { +"description": "A tool that can be used by the model to search files.", +"id": "GenaiVertexV1FileSearch", +"properties": { +"fileSearchStoreNames": { +"description": "The file search store names to search.", +"items": { +"type": "string" +}, +"type": "array" +}, +"metadataFilter": { +"description": "Metadata filter to apply to the semantic retrieval documents and chunks.", +"type": "string" +}, +"topK": { +"description": "The number of semantic retrieval chunks to retrieve.", +"format": "int32", +"type": "integer" +} +}, +"type": "object" +}, +"GenaiVertexV1FileSearchCallDelta": { +"id": "GenaiVertexV1FileSearchCallDelta", +"properties": {}, +"type": "object" +}, +"GenaiVertexV1FileSearchCallStep": { +"description": "File Search call step.", +"id": "GenaiVertexV1FileSearchCallStep", +"properties": {}, +"type": "object" +}, +"GenaiVertexV1FileSearchResultContentFileSearchResult": { +"description": "The result of the File Search.", +"id": "GenaiVertexV1FileSearchResultContentFileSearchResult", +"properties": {}, +"type": "object" +}, +"GenaiVertexV1FileSearchResultDelta": { +"id": "GenaiVertexV1FileSearchResultDelta", +"properties": { +"result": { +"items": { +"$ref": "GenaiVertexV1FileSearchResultContentFileSearchResult" +}, +"type": "array" +} +}, +"type": "object" +}, +"GenaiVertexV1FileSearchResultStep": { +"description": "File Search result step.", +"id": "GenaiVertexV1FileSearchResultStep", +"properties": {}, +"type": "object" +}, +"GenaiVertexV1Function": { +"description": "A tool that can be used by the model.", +"id": "GenaiVertexV1Function", +"properties": { +"description": { +"description": "A description of the function.", +"type": "string" +}, +"name": { +"description": "The name of the function.", +"type": "string" +}, +"parameters": { +"$ref": "GenaiVertexV1Value", +"description": "The JSON Schema for the function's parameters." +} +}, +"type": "object" +}, +"GenaiVertexV1FunctionCallStep": { +"description": "A function tool call step.", +"id": "GenaiVertexV1FunctionCallStep", +"properties": { +"arguments": { +"$ref": "GenaiVertexV1Struct", +"description": "Required. The arguments to pass to the function." +}, +"name": { +"description": "Required. The name of the tool to call.", +"type": "string" +} +}, +"type": "object" +}, +"GenaiVertexV1FunctionResultDelta": { +"id": "GenaiVertexV1FunctionResultDelta", +"properties": { +"isError": { +"type": "boolean" +}, +"name": { +"type": "string" +}, +"result": { +"$ref": "GenaiVertexV1Value" +} +}, +"type": "object" +}, +"GenaiVertexV1FunctionResultStep": { +"description": "Result of a function tool call.", +"id": "GenaiVertexV1FunctionResultStep", +"properties": { +"isError": { +"description": "Whether the tool call resulted in an error.", +"type": "boolean" +}, +"name": { +"description": "The name of the tool that was called.", +"type": "string" +}, +"result": { +"$ref": "GenaiVertexV1Value", +"description": "Required. The result of the tool call." +} +}, +"type": "object" +}, +"GenaiVertexV1GenerationConfig": { +"description": "Configuration parameters for model interactions.", +"id": "GenaiVertexV1GenerationConfig", +"properties": { +"maxOutputTokens": { +"description": "The maximum number of tokens to include in the response.", +"format": "int32", +"type": "integer" +}, +"seed": { +"description": "Seed used in decoding for reproducibility.", +"format": "int32", +"type": "integer" +}, +"stopSequences": { +"description": "A list of character sequences that will stop output interaction.", +"items": { +"type": "string" +}, +"type": "array" +}, +"structuredSpeechConfig": { +"$ref": "GenaiVertexV1SpeakerConfig", +"description": "Speech and multi-speaker configuration." +}, +"temperature": { +"deprecated": true, +"description": "Controls the randomness of the output.", +"format": "float", +"type": "number" +}, +"thinkingLevel": { +"description": "The level of thought tokens that the model should generate.", +"enum": [ +"THINKING_LEVEL_UNSPECIFIED", +"THINKING_LEVEL_MINIMAL", +"THINKING_LEVEL_LOW", +"THINKING_LEVEL_MEDIUM", +"THINKING_LEVEL_HIGH" +], +"enumDescriptions": [ +"Default value. This value is unused.", +"Little to no thinking.", +"Low thinking level.", +"Medium thinking level.", +"High thinking level." +], +"type": "string" +}, +"thinkingSummaries": { +"description": "Whether to include thought summaries in the response.", +"enum": [ +"THINKING_SUMMARIES_UNSPECIFIED", +"THINKING_SUMMARIES_AUTO", +"THINKING_SUMMARIES_NONE" +], +"enumDescriptions": [ +"Default value. This value is unused.", +"Auto thinking summaries.", +"No thinking summaries." +], +"type": "string" +}, +"toolChoiceConfig": { +"$ref": "GenaiVertexV1ToolChoiceConfig", +"description": "The config for the tool choice." +}, +"toolChoiceMode": { +"description": "The mode of the tool choice.", +"enum": [ +"TOOL_CHOICE_TYPE_UNSPECIFIED", +"AUTO", +"ANY", +"NONE", +"VALIDATED" +], +"enumDescriptions": [ +"Default value. This value is unused.", +"Auto tool choice.", +"Any tool choice.", +"No tool choice.", +"Validated tool choice." +], +"type": "string" +}, +"topP": { +"deprecated": true, +"description": "The maximum cumulative probability of tokens to consider when sampling.", +"format": "float", +"type": "number" +}, +"transcriptionConfig": { +"$ref": "GenaiVertexV1TranscriptionConfig", +"description": "Optional. Configuration for speech recognition (transcription). If present, ASR is enabled." +}, +"videoConfig": { +"$ref": "GenaiVertexV1VideoConfig", +"description": "Configuration for video generation." +} +}, +"type": "object" +}, +"GenaiVertexV1GoogleMaps": { +"description": "A tool that can be used by the model to call Google Maps.", +"id": "GenaiVertexV1GoogleMaps", +"properties": { +"enableWidget": { +"description": "Whether to return a widget context token in the tool call result of the response.", +"type": "boolean" +}, +"latitude": { +"description": "The latitude of the user's location.", +"format": "double", +"type": "number" +}, +"longitude": { +"description": "The longitude of the user's location.", +"format": "double", +"type": "number" +} +}, +"type": "object" +}, +"GenaiVertexV1GoogleMapsCallContentGoogleMapsCallArguments": { +"description": "The arguments to pass to the Google Maps tool.", +"id": "GenaiVertexV1GoogleMapsCallContentGoogleMapsCallArguments", +"properties": { +"queries": { +"description": "The queries to be executed.", +"items": { +"type": "string" +}, +"type": "array" +} +}, +"type": "object" +}, +"GenaiVertexV1GoogleMapsCallDelta": { +"id": "GenaiVertexV1GoogleMapsCallDelta", +"properties": { +"arguments": { +"$ref": "GenaiVertexV1GoogleMapsCallContentGoogleMapsCallArguments", +"description": "The arguments to pass to the Google Maps tool." +} +}, +"type": "object" +}, +"GenaiVertexV1GoogleMapsCallStep": { +"description": "Google Maps call step.", +"id": "GenaiVertexV1GoogleMapsCallStep", +"properties": { +"arguments": { +"$ref": "GenaiVertexV1GoogleMapsCallStepGoogleMapsCallStepArguments", +"description": "The arguments to pass to the Google Maps tool." +} +}, +"type": "object" +}, +"GenaiVertexV1GoogleMapsCallStepGoogleMapsCallStepArguments": { +"description": "The arguments to pass to the Google Maps tool.", +"id": "GenaiVertexV1GoogleMapsCallStepGoogleMapsCallStepArguments", +"properties": { +"queries": { +"description": "The queries to be executed.", +"items": { +"type": "string" +}, +"type": "array" +} +}, +"type": "object" +}, +"GenaiVertexV1GoogleMapsResultContentGoogleMapsResult": { +"description": "The result of the Google Maps.", +"id": "GenaiVertexV1GoogleMapsResultContentGoogleMapsResult", +"properties": { +"places": { +"description": "The places that were found.", +"items": { +"$ref": "GenaiVertexV1GoogleMapsResultContentGoogleMapsResultPlaces" +}, +"type": "array" +}, +"widgetContextToken": { +"description": "Resource name of the Google Maps widget context token.", +"type": "string" +} +}, +"type": "object" +}, +"GenaiVertexV1GoogleMapsResultContentGoogleMapsResultPlaces": { +"id": "GenaiVertexV1GoogleMapsResultContentGoogleMapsResultPlaces", +"properties": { +"name": { +"description": "Title of the place.", +"type": "string" +}, +"placeId": { +"description": "The ID of the place, in `places/{place_id}` format.", +"type": "string" +}, +"reviewSnippets": { +"description": "Snippets of reviews that are used to generate answers about the features of a given place in Google Maps.", +"items": { +"$ref": "GenaiVertexV1ReviewSnippet" +}, +"type": "array" +}, +"url": { +"description": "URI reference of the place.", +"type": "string" +} +}, +"type": "object" +}, +"GenaiVertexV1GoogleMapsResultDelta": { +"id": "GenaiVertexV1GoogleMapsResultDelta", +"properties": { +"result": { +"description": "The results of the Google Maps.", +"items": { +"$ref": "GenaiVertexV1GoogleMapsResultContentGoogleMapsResult" +}, +"type": "array" +} +}, +"type": "object" +}, +"GenaiVertexV1GoogleMapsResultStep": { +"description": "Google Maps result step.", +"id": "GenaiVertexV1GoogleMapsResultStep", +"properties": { +"result": { +"items": { +"$ref": "GenaiVertexV1GoogleMapsResultStepGoogleMapsResultItem" +}, +"type": "array" +} +}, +"type": "object" +}, +"GenaiVertexV1GoogleMapsResultStepGoogleMapsResultItem": { +"description": "The result of the Google Maps.", +"id": "GenaiVertexV1GoogleMapsResultStepGoogleMapsResultItem", +"properties": { +"places": { +"items": { +"$ref": "GenaiVertexV1GoogleMapsResultStepGoogleMapsResultItemGoogleMapsResultPlaces" +}, +"type": "array" +}, +"widgetContextToken": { +"type": "string" +} +}, +"type": "object" +}, +"GenaiVertexV1GoogleMapsResultStepGoogleMapsResultItemGoogleMapsResultPlaces": { +"id": "GenaiVertexV1GoogleMapsResultStepGoogleMapsResultItemGoogleMapsResultPlaces", +"properties": { +"name": { +"type": "string" +}, +"placeId": { +"type": "string" +}, +"reviewSnippets": { +"items": { +"$ref": "GenaiVertexV1ReviewSnippet" +}, +"type": "array" +}, +"url": { +"type": "string" +} +}, +"type": "object" +}, +"GenaiVertexV1GoogleSearch": { +"description": "A tool that can be used by the model to search Google.", +"id": "GenaiVertexV1GoogleSearch", +"properties": { +"searchTypes": { +"description": "The types of search grounding to enable.", +"items": { +"enum": [ +"SEARCH_TYPE_UNSPECIFIED", +"SEARCH_TYPE_WEB_SEARCH", +"SEARCH_TYPE_IMAGE_SEARCH", +"SEARCH_TYPE_ENTERPRISE_WEB_SEARCH" +], +"enumDescriptions": [ +"Unspecified search type. This value should not be used.", +"Setting this field enables web search. Only text results are returned.", +"Setting this field enables image search. Image bytes are returned.", +"Setting this field enables enterprise web search." +], +"type": "string" +}, +"type": "array" +} +}, +"type": "object" +}, +"GenaiVertexV1GoogleSearchCallContentGoogleSearchCallArguments": { +"description": "The arguments to pass to Google Search.", +"id": "GenaiVertexV1GoogleSearchCallContentGoogleSearchCallArguments", +"properties": { +"queries": { +"description": "Web search queries for the following-up web search.", +"items": { +"type": "string" +}, +"type": "array" +} +}, +"type": "object" +}, +"GenaiVertexV1GoogleSearchCallDelta": { +"id": "GenaiVertexV1GoogleSearchCallDelta", +"properties": { +"arguments": { +"$ref": "GenaiVertexV1GoogleSearchCallContentGoogleSearchCallArguments" +} +}, +"type": "object" +}, +"GenaiVertexV1GoogleSearchCallStep": { +"description": "Google Search call step.", +"id": "GenaiVertexV1GoogleSearchCallStep", +"properties": { +"arguments": { +"$ref": "GenaiVertexV1GoogleSearchCallStepGoogleSearchCallStepArguments", +"description": "Required. The arguments to pass to Google Search." +}, +"searchType": { +"description": "The type of search grounding enabled.", +"enum": [ +"SEARCH_TYPE_UNSPECIFIED", +"SEARCH_TYPE_WEB_SEARCH", +"SEARCH_TYPE_IMAGE_SEARCH", +"SEARCH_TYPE_ENTERPRISE_WEB_SEARCH" +], +"enumDescriptions": [ +"Unspecified search type. This value should not be used.", +"Setting this field enables web search. Only text results are returned.", +"Setting this field enables image search. Image bytes are returned.", +"Setting this field enables enterprise web search." +], +"type": "string" +} +}, +"type": "object" +}, +"GenaiVertexV1GoogleSearchCallStepGoogleSearchCallStepArguments": { +"description": "The arguments to pass to Google Search.", +"id": "GenaiVertexV1GoogleSearchCallStepGoogleSearchCallStepArguments", +"properties": { +"queries": { +"description": "Web search queries for the following-up web search.", +"items": { +"type": "string" +}, +"type": "array" +} +}, +"type": "object" +}, +"GenaiVertexV1GoogleSearchResultContentGoogleSearchResult": { +"description": "The result of the Google Search.", +"id": "GenaiVertexV1GoogleSearchResultContentGoogleSearchResult", +"properties": { +"searchSuggestions": { +"description": "Web content snippet that can be embedded in a web page or an app webview.", +"type": "string" +} +}, +"type": "object" +}, +"GenaiVertexV1GoogleSearchResultDelta": { +"id": "GenaiVertexV1GoogleSearchResultDelta", +"properties": { +"isError": { +"type": "boolean" +}, +"result": { +"items": { +"$ref": "GenaiVertexV1GoogleSearchResultContentGoogleSearchResult" +}, +"type": "array" +} +}, +"type": "object" +}, +"GenaiVertexV1GoogleSearchResultStep": { +"description": "Google Search result step.", +"id": "GenaiVertexV1GoogleSearchResultStep", +"properties": { +"isError": { +"description": "Whether the Google Search resulted in an error.", +"type": "boolean" +}, +"result": { +"description": "Required. The results of the Google Search.", +"items": { +"$ref": "GenaiVertexV1GoogleSearchResultStepGoogleSearchResultItem" +}, +"type": "array" +} +}, +"type": "object" +}, +"GenaiVertexV1GoogleSearchResultStepGoogleSearchResultItem": { +"description": "The result of the Google Search.", +"id": "GenaiVertexV1GoogleSearchResultStepGoogleSearchResultItem", +"properties": { +"searchSuggestions": { +"description": "Web content snippet that can be embedded in a web page or an app webview.", +"type": "string" +} +}, +"type": "object" +}, +"GenaiVertexV1ImageContent": { +"description": "An image content block. ", +"id": "GenaiVertexV1ImageContent", +"properties": { +"data": { +"description": "The image content.", +"format": "byte", +"type": "string" +}, +"mimeTypeString": { +"description": "Flexible MIME type string of the image, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the \"mime_type\" JSON key.", +"type": "string" +}, +"resolution": { +"description": "The resolution of the media.", +"enum": [ +"MEDIA_RESOLUTION_UNSPECIFIED", +"LOW", +"MEDIUM", +"HIGH", +"ULTRA_HIGH" +], +"enumDescriptions": [ +"Default value. This value is unused.", +"Low resolution.", +"Medium resolution.", +"High resolution.", +"Ultra high resolution." +], +"type": "string" +}, +"uri": { +"description": "The URI of the image.", +"type": "string" +} +}, +"type": "object" +}, +"GenaiVertexV1ImageDelta": { +"id": "GenaiVertexV1ImageDelta", +"properties": { +"data": { +"format": "byte", +"type": "string" +}, +"mimeType": { +"enum": [ +"TYPE_UNSPECIFIED", +"TYPE_PNG", +"TYPE_JPEG", +"TYPE_WEBP", +"TYPE_HEIC", +"TYPE_HEIF", +"TYPE_GIF", +"TYPE_BMP", +"TYPE_TIFF" +], +"enumDescriptions": [ +"", +"PNG image format", +"JPEG image format", +"WebP image format", +"HEIC image format", +"HEIF image format", +"GIF image format", +"BMP image format", +"TIFF image format" +], +"type": "string" +}, +"resolution": { +"description": "The resolution of the media.", +"enum": [ +"MEDIA_RESOLUTION_UNSPECIFIED", +"LOW", +"MEDIUM", +"HIGH", +"ULTRA_HIGH" +], +"enumDescriptions": [ +"Default value. This value is unused.", +"Low resolution.", +"Medium resolution.", +"High resolution.", +"Ultra high resolution." +], +"type": "string" +}, +"uri": { +"type": "string" +} +}, +"type": "object" +}, +"GenaiVertexV1ImageResponseFormat": { +"description": "Configuration for image output format.", +"id": "GenaiVertexV1ImageResponseFormat", +"properties": { +"aspectRatio": { +"description": "The aspect ratio for the image output.", +"enum": [ +"ASPECT_RATIO_UNSPECIFIED", +"ASPECT_RATIO_ONE_BY_ONE", +"ASPECT_RATIO_TWO_BY_THREE", +"ASPECT_RATIO_THREE_BY_TWO", +"ASPECT_RATIO_THREE_BY_FOUR", +"ASPECT_RATIO_FOUR_BY_THREE", +"ASPECT_RATIO_FOUR_BY_FIVE", +"ASPECT_RATIO_FIVE_BY_FOUR", +"ASPECT_RATIO_NINE_BY_SIXTEEN", +"ASPECT_RATIO_SIXTEEN_BY_NINE", +"ASPECT_RATIO_TWENTY_ONE_BY_NINE", +"ASPECT_RATIO_ONE_BY_EIGHT", +"ASPECT_RATIO_EIGHT_BY_ONE", +"ASPECT_RATIO_ONE_BY_FOUR", +"ASPECT_RATIO_FOUR_BY_ONE" +], +"enumDescriptions": [ +"Default value. This value is unused.", +"1:1 aspect ratio.", +"2:3 aspect ratio.", +"3:2 aspect ratio.", +"3:4 aspect ratio.", +"4:3 aspect ratio.", +"4:5 aspect ratio.", +"5:4 aspect ratio.", +"9:16 aspect ratio.", +"16:9 aspect ratio.", +"21:9 aspect ratio.", +"1:8 aspect ratio.", +"8:1 aspect ratio.", +"1:4 aspect ratio.", +"4:1 aspect ratio." +], +"type": "string" +}, +"delivery": { +"description": "The delivery mode for the image output.", +"enum": [ +"DELIVERY_UNSPECIFIED", +"INLINE", +"URI" +], +"enumDescriptions": [ +"Default value. This value is unused.", +"Image data is returned inline in the response.", +"Image data is returned as a URI." +], +"type": "string" +}, +"imageSize": { +"description": "The size of the image output.", +"enum": [ +"IMAGE_SIZE_UNSPECIFIED", +"IMAGE_SIZE_FIVE_TWELVE", +"IMAGE_SIZE_ONE_K", +"IMAGE_SIZE_TWO_K", +"IMAGE_SIZE_FOUR_K" +], +"enumDescriptions": [ +"Default value. This value is unused.", +"512px image size.", +"1K image size.", +"2K image size.", +"4K image size." +], +"type": "string" +}, +"mimeType": { +"description": "The MIME type of the image output.", +"enum": [ +"TYPE_UNSPECIFIED", +"TYPE_JPEG" +], +"enumDescriptions": [ +"Default value. This value is unused.", +"JPEG image format." +], +"type": "string" +} +}, +"type": "object" +}, +"GenaiVertexV1Interaction": { +"description": "Response for InteractionService.CreateInteraction.", +"id": "GenaiVertexV1Interaction", +"properties": { +"agentInteraction": { +"$ref": "GenaiVertexV1AgentInteraction", +"description": "Interaction for generating the completion using agents." +}, +"content": { +"$ref": "GenaiVertexV1Content", +"description": "The content for the interaction." +}, +"created": { +"description": "Required. Output only. The time at which the response was created in ISO 8601 format (YYYY-MM-DDThh:mm:ssZ).", +"readOnly": true, +"type": "string" +}, +"envId": { +"description": "The environment ID for the interaction. Can be 'remote' for default environment.", +"type": "string" +}, +"environmentId": { +"description": "Output only. The environment ID for the interaction. Only populated if environment config is set in the request.", +"readOnly": true, +"type": "string" +}, +"errors": { +"description": "Output only. Diagnostic faults / platform errors recorded on the interaction.", +"items": { +"$ref": "GenaiVertexV1Error" +}, +"readOnly": true, +"type": "array" +}, +"id": { +"description": "Required. Output only. A unique identifier for the interaction completion.", +"readOnly": true, +"type": "string" +}, +"labels": { +"additionalProperties": { +"type": "string" +}, +"description": "The labels with user-defined metadata for the request. 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" +}, +"modelInteraction": { +"$ref": "GenaiVertexV1ModelInteraction", +"description": "Interaction for generating the completion using models." +}, +"previousInteractionId": { +"description": "The ID of the previous interaction, if any.", +"type": "string" +}, +"responseFormatList": { +"$ref": "GenaiVertexV1ResponseFormatList" +}, +"responseFormatSingleton": { +"$ref": "GenaiVertexV1ResponseFormat" +}, +"safetySettings": { +"description": "Safety settings for the interaction.", +"items": { +"$ref": "GenaiVertexV1SafetySetting" +}, +"type": "array" +}, +"serviceTier": { +"description": "The service tier for the interaction.", +"enum": [ +"SERVICE_TIER_UNSPECIFIED", +"SERVICE_TIER_FLEX", +"SERVICE_TIER_STANDARD", +"SERVICE_TIER_PRIORITY", +"SERVICE_TIER_DEFERRED" +], +"enumDescriptions": [ +"Default service tier, which is standard.", +"Flex service tier.", +"Standard service tier.", +"Priority service tier.", +"Deferred service tier." +], +"type": "string" +}, +"status": { +"description": "Required. Output only. The status of the interaction.", +"enum": [ +"UNSPECIFIED", +"IN_PROGRESS", +"REQUIRES_ACTION", +"COMPLETED", +"FAILED", +"CANCELLED", +"INCOMPLETE", +"QUEUED" +], +"enumDescriptions": [ +"Default value. This value is unused.", +"The interaction is in progress.", +"The interaction requires action/input from the user.", +"The interaction is completed.", +"The interaction failed.", +"The interaction was cancelled.", +"The interaction is completed, but contains incomplete results (e.g. hitting max_tokens).", +"The interaction is queued, waiting for processing (e.g. waiting for off-peak capacity)." +], +"readOnly": true, +"type": "string" +}, +"stepList": { +"$ref": "GenaiVertexV1StepList", +"description": "Input only. The steps for the interaction." +}, +"steps": { +"description": "Required. Output only. The steps that make up the interaction, when included in the response.", +"items": { +"$ref": "GenaiVertexV1Step" +}, +"readOnly": true, +"type": "array" +}, +"stringContent": { +"description": "A string input for the interaction, it will be processed as a single text input.", +"type": "string" +}, +"systemInstruction": { +"description": "System instruction for the interaction.", +"type": "string" +}, +"tools": { +"description": "A list of tool declarations the model may call during interaction.", +"items": { +"$ref": "GenaiVertexV1Tool" +}, +"type": "array" +}, +"updated": { +"description": "Required. Output only. The time at which the response was last updated in ISO 8601 format (YYYY-MM-DDThh:mm:ssZ).", +"readOnly": true, +"type": "string" +}, +"usage": { +"$ref": "GenaiVertexV1InteractionUsage", +"description": "Output only. Statistics on the interaction request's token usage.", +"readOnly": true +} +}, +"type": "object" +}, +"GenaiVertexV1InteractionCompletedSseEvent": { +"description": "Signals that the Interaction completed. Sent when the Interaction receives Complete/Cancel or naturally terminates. No more input can be sent to the Interaction after this.", +"id": "GenaiVertexV1InteractionCompletedSseEvent", +"properties": { +"interaction": { +"$ref": "GenaiVertexV1Interaction", +"description": "Required. Partial completed interaction resource emitted at the end of the stream." +} +}, +"type": "object" +}, +"GenaiVertexV1InteractionCreatedSseEvent": { +"description": "Server response confirming that a new interaction was created.", +"id": "GenaiVertexV1InteractionCreatedSseEvent", +"properties": { +"interaction": { +"$ref": "GenaiVertexV1Interaction", +"description": "Required. Partial interaction resource emitted when the stream is created." +} +}, +"type": "object" +}, +"GenaiVertexV1InteractionStatusUpdate": { +"id": "GenaiVertexV1InteractionStatusUpdate", +"properties": { +"interactionId": { +"type": "string" +}, +"status": { +"enum": [ +"UNSPECIFIED", +"IN_PROGRESS", +"REQUIRES_ACTION", +"COMPLETED", +"FAILED", +"CANCELLED", +"INCOMPLETE", +"QUEUED" +], +"enumDescriptions": [ +"Default value. This value is unused.", +"The interaction is in progress.", +"The interaction requires action/input from the user.", +"The interaction is completed.", +"The interaction failed.", +"The interaction was cancelled.", +"The interaction is completed, but contains incomplete results (e.g. hitting max_tokens).", +"The interaction is queued, waiting for processing (e.g. waiting for off-peak capacity)." +], +"type": "string" +}, +"usage": { +"$ref": "GenaiVertexV1InteractionUsage", +"description": "Model usage statistics up to this checkpoint." +} +}, +"type": "object" +}, +"GenaiVertexV1InteractionStreamingEvent": { +"id": "GenaiVertexV1InteractionStreamingEvent", +"properties": { +"errorEvent": { +"$ref": "GenaiVertexV1ErrorEvent", +"description": "The error event data, used for error events." +}, +"eventId": { +"description": "The event_id token to be used to resume the interaction stream, from this event.", +"type": "string" +}, +"interactionCompletedEvent": { +"$ref": "GenaiVertexV1InteractionCompletedSseEvent", +"description": "The interaction data, used for interaction.completed events. Used when steps are enabled." +}, +"interactionCreatedEvent": { +"$ref": "GenaiVertexV1InteractionCreatedSseEvent", +"description": "The interaction data, used for interaction.created events. Used when steps are enabled." +}, +"interactionStatusUpdate": { +"$ref": "GenaiVertexV1InteractionStatusUpdate", +"description": "The interaction status data, used for interaction.status_update events." +}, +"stepDelta": { +"$ref": "GenaiVertexV1StepDelta", +"description": "The step delta data, used for step.delta events. Step-based streaming event, used when steps are enabled." +}, +"stepStart": { +"$ref": "GenaiVertexV1StepStart", +"description": "The step start data, used for step.start events. Step-based streaming event, used when steps are enabled." +}, +"stepStop": { +"$ref": "GenaiVertexV1StepStop", +"description": "The step stop data, used for step.stop events. Step-based streaming event, used when steps are enabled." +} +}, +"type": "object" +}, +"GenaiVertexV1InteractionUsage": { +"description": "Statistics on the interaction request's token usage.", +"id": "GenaiVertexV1InteractionUsage", +"properties": { +"cachedTokensByModality": { +"description": "A breakdown of cached token usage by modality.", +"items": { +"$ref": "GenaiVertexV1InteractionUsageModalityTokens" +}, +"type": "array" +}, +"groundingToolCount": { +"description": "Grounding tool count.", +"items": { +"$ref": "GenaiVertexV1InteractionUsageGroundingToolCount" +}, +"type": "array" +}, +"inputTokensByModality": { +"description": "A breakdown of input token usage by modality.", +"items": { +"$ref": "GenaiVertexV1InteractionUsageModalityTokens" +}, +"type": "array" +}, +"outputTokensByModality": { +"description": "A breakdown of output token usage by modality.", +"items": { +"$ref": "GenaiVertexV1InteractionUsageModalityTokens" +}, +"type": "array" +}, +"toolUseTokensByModality": { +"description": "A breakdown of tool-use token usage by modality.", +"items": { +"$ref": "GenaiVertexV1InteractionUsageModalityTokens" +}, +"type": "array" +}, +"totalCachedTokens": { +"description": "Number of tokens in the cached part of the prompt (the cached content).", +"format": "int32", +"type": "integer" +}, +"totalInputTokens": { +"description": "Number of tokens in the prompt (context).", +"format": "int32", +"type": "integer" +}, +"totalOutputTokens": { +"description": "Total number of tokens across all the generated responses.", +"format": "int32", +"type": "integer" +}, +"totalThoughtTokens": { +"description": "Number of tokens of thoughts for thinking models.", +"format": "int32", +"type": "integer" +}, +"totalTokens": { +"description": "Total token count for the interaction request (prompt + responses + other internal tokens).", +"format": "int32", +"type": "integer" +}, +"totalToolUseTokens": { +"description": "Number of tokens present in tool-use prompt(s).", +"format": "int32", +"type": "integer" +} +}, +"type": "object" +}, +"GenaiVertexV1InteractionUsageGroundingToolCount": { +"description": "The number of grounding tool counts.", +"id": "GenaiVertexV1InteractionUsageGroundingToolCount", +"properties": { +"count": { +"description": "The number of grounding tool counts.", +"format": "int32", +"type": "integer" +}, +"type": { +"description": "The grounding tool type associated with the count.", +"enum": [ +"TYPE_UNSPECIFIED", +"GOOGLE_SEARCH", +"GOOGLE_MAPS", +"RETRIEVAL" +], +"enumDescriptions": [ +"Default value. This value is unused.", +"Grounding with Google Web Search and Image Search, & Web Grounding for Enterprise.", +"Grounding with Google Maps.", +"Grounding with customer's data, for example, VertexAISearch." +], +"type": "string" +} +}, +"type": "object" +}, +"GenaiVertexV1InteractionUsageModalityTokens": { +"description": "The token count for a single response modality.", +"id": "GenaiVertexV1InteractionUsageModalityTokens", +"properties": { +"modality": { +"description": "The modality associated with the token count.", +"enum": [ +"RESPONSE_MODALITY_UNSPECIFIED", +"TEXT", +"IMAGE", +"AUDIO", +"VIDEO", +"DOCUMENT" +], +"enumDescriptions": [ +"Default value. This value is unused.", +"Indicates the model should return text.", +"Indicates the model should return images.", +"Indicates the model should return audio.", +"Indicates the model should return video.", +"Indicates the model should return documents." +], +"type": "string" +}, +"tokens": { +"description": "Number of tokens for the modality.", +"format": "int32", +"type": "integer" +} +}, +"type": "object" +}, +"GenaiVertexV1ListValue": { +"description": "`ListValue` is a wrapper around a repeated field of values.", +"id": "GenaiVertexV1ListValue", +"properties": { +"values": { +"description": "Repeated field of dynamically typed values.", +"items": { +"$ref": "GenaiVertexV1Value" +}, +"type": "array" +} +}, +"type": "object" +}, +"GenaiVertexV1McpServer": { +"description": "A MCPServer is a server that can be called by the model to perform actions.", +"id": "GenaiVertexV1McpServer", +"properties": { +"allowedTools": { +"description": "The allowed tools.", +"items": { +"$ref": "GenaiVertexV1AllowedTools" +}, +"type": "array" +}, +"headers": { +"additionalProperties": { +"type": "string" +}, +"description": "Optional: Fields for authentication headers, timeouts, etc., if needed.", +"type": "object" +}, +"name": { +"description": "The name of the MCPServer.", +"type": "string" +}, +"url": { +"description": "The full URL for the MCPServer endpoint. Example: \"https://api.example.com/mcp\"", +"type": "string" +} +}, +"type": "object" +}, +"GenaiVertexV1ModelInteraction": { +"description": "Interaction for generating the completion using models.", +"id": "GenaiVertexV1ModelInteraction", +"properties": { +"generationConfig": { +"$ref": "GenaiVertexV1GenerationConfig", +"description": "Input only. Configuration parameters for the model interaction." +}, +"model": { +"description": "The name of the `Model` used for generating the completion.", +"type": "string" +} +}, +"type": "object" +}, +"GenaiVertexV1ModelOutputStep": { +"description": "Output generated by the model.", +"id": "GenaiVertexV1ModelOutputStep", +"properties": { +"content": { +"items": { +"$ref": "GenaiVertexV1Content" +}, +"type": "array" +}, +"error": { +"$ref": "GoogleRpcStatus", +"deprecated": true, +"description": "The error result of the operation in case of failure or cancellation." +} +}, +"type": "object" +}, +"GenaiVertexV1ParallelAISearchConfig": { +"description": "Used to specify configuration for ParallelAISearch.", +"id": "GenaiVertexV1ParallelAISearchConfig", +"properties": { +"apiKey": { +"description": "Optional. The API key for ParallelAiSearch.", +"type": "string" +}, +"customConfig": { +"additionalProperties": { +"description": "Properties of the object.", +"type": "any" +}, +"description": "Optional. Custom configs for ParallelAiSearch.", +"type": "object" +} +}, +"type": "object" +}, +"GenaiVertexV1PlaceCitation": { +"description": "A place citation annotation.", +"id": "GenaiVertexV1PlaceCitation", +"properties": { +"name": { +"description": "Title of the place.", +"type": "string" +}, +"placeId": { +"description": "The ID of the place, in `places/{place_id}` format.", +"type": "string" +}, +"reviewSnippets": { +"description": "Snippets of reviews that are used to generate answers about the features of a given place in Google Maps.", +"items": { +"$ref": "GenaiVertexV1ReviewSnippet" +}, +"type": "array" +}, +"url": { +"description": "URI reference of the place.", +"type": "string" +} +}, +"type": "object" +}, +"GenaiVertexV1ProcessingCallDelta": { +"description": "Streaming delta for a server-initiated media processing step.", +"id": "GenaiVertexV1ProcessingCallDelta", +"properties": {}, +"type": "object" +}, +"GenaiVertexV1ProcessingCallStep": { +"description": "A server-initiated processing step for media analysis (e.g. video understanding).", +"id": "GenaiVertexV1ProcessingCallStep", +"properties": {}, +"type": "object" +}, +"GenaiVertexV1ProcessingResultDelta": { +"description": "Streaming delta for the result of a server-initiated media processing step.", +"id": "GenaiVertexV1ProcessingResultDelta", +"properties": {}, +"type": "object" +}, +"GenaiVertexV1ProcessingResultStep": { +"description": "The result of a server-initiated media processing step.", +"id": "GenaiVertexV1ProcessingResultStep", +"properties": {}, +"type": "object" +}, +"GenaiVertexV1RagStoreConfig": { +"description": "Use to specify configuration for RAG Store.", +"id": "GenaiVertexV1RagStoreConfig", +"properties": { +"ragResources": { +"description": "Optional. The representation of the rag source.", +"items": { +"$ref": "GenaiVertexV1RagStoreConfigRagResource" +}, +"type": "array" +}, +"ragRetrievalConfig": { +"$ref": "GenaiVertexV1RagStoreConfigRagRetrievalConfig", +"description": "Optional. The retrieval config for the Rag query." +} +}, +"type": "object" +}, +"GenaiVertexV1RagStoreConfigRagResource": { +"description": "The definition of the Rag resource.", +"id": "GenaiVertexV1RagStoreConfigRagResource", +"properties": { +"ragCorpus": { +"description": "Optional. RagCorpora resource name.", +"type": "string" +}, +"ragFileIds": { +"description": "Optional. rag_file_id. The files should be in the same rag_corpus set in rag_corpus field.", +"items": { +"type": "string" +}, +"type": "array" +} +}, +"type": "object" +}, +"GenaiVertexV1RagStoreConfigRagRetrievalConfig": { +"description": "Specifies the context retrieval config.", +"id": "GenaiVertexV1RagStoreConfigRagRetrievalConfig", +"properties": { +"filter": { +"$ref": "GenaiVertexV1RagStoreConfigRagRetrievalConfigFilter", +"description": "Optional. Config for filters." +}, +"hybridSearch": { +"$ref": "GenaiVertexV1RagStoreConfigRagRetrievalConfigHybridSearch", +"description": "Optional. Config for Hybrid Search." +}, +"ranking": { +"$ref": "GenaiVertexV1RagStoreConfigRagRetrievalConfigRanking", +"description": "Optional. Config for ranking and reranking." +}, +"topK": { +"description": "Optional. The number of contexts to retrieve.", +"format": "int32", +"type": "integer" +} +}, +"type": "object" +}, +"GenaiVertexV1RagStoreConfigRagRetrievalConfigFilter": { +"description": "Config for filters.", +"id": "GenaiVertexV1RagStoreConfigRagRetrievalConfigFilter", +"properties": { +"metadataFilter": { +"description": "Optional. String for metadata filtering.", +"type": "string" +}, +"vectorDistanceThreshold": { +"description": "Optional. Only returns contexts with vector distance smaller than the threshold.", +"format": "double", +"type": "number" +}, +"vectorSimilarityThreshold": { +"description": "Optional. Only returns contexts with vector similarity larger than the threshold.", +"format": "double", +"type": "number" +} +}, +"type": "object" +}, +"GenaiVertexV1RagStoreConfigRagRetrievalConfigHybridSearch": { +"description": "Config for Hybrid Search.", +"id": "GenaiVertexV1RagStoreConfigRagRetrievalConfigHybridSearch", +"properties": { +"alpha": { +"description": "Optional. Alpha value controls the weight between dense and sparse vector search results.", +"format": "float", +"type": "number" +} +}, +"type": "object" +}, +"GenaiVertexV1RagStoreConfigRagRetrievalConfigRanking": { +"description": "Config for ranking and reranking.", +"id": "GenaiVertexV1RagStoreConfigRagRetrievalConfigRanking", +"properties": { +"rankService": { +"$ref": "GenaiVertexV1RagStoreConfigRagRetrievalConfigRankingRankService", +"description": "Config for Rank Service." +} +}, +"type": "object" +}, +"GenaiVertexV1RagStoreConfigRagRetrievalConfigRankingRankService": { +"description": "Config for Rank Service.", +"id": "GenaiVertexV1RagStoreConfigRagRetrievalConfigRankingRankService", +"properties": { +"modelName": { +"description": "Optional. The model name of the rank service.", +"type": "string" +} +}, +"type": "object" +}, +"GenaiVertexV1ResponseFormat": { +"id": "GenaiVertexV1ResponseFormat", +"properties": { +"audio": { +"$ref": "GenaiVertexV1AudioResponseFormat" +}, +"image": { +"$ref": "GenaiVertexV1ImageResponseFormat" +}, +"structValue": { +"$ref": "GenaiVertexV1Struct", +"description": "Multi-discriminator values is already enabled in GAOS" +}, +"text": { +"$ref": "GenaiVertexV1TextResponseFormat" +}, +"video": { +"$ref": "GenaiVertexV1VideoResponseFormat" +} +}, +"type": "object" +}, +"GenaiVertexV1ResponseFormatList": { +"id": "GenaiVertexV1ResponseFormatList", +"properties": { +"responseFormats": { +"items": { +"$ref": "GenaiVertexV1ResponseFormat" +}, +"type": "array" +} +}, +"type": "object" +}, +"GenaiVertexV1Retrieval": { +"description": "A tool that can be used by the model to retrieve files.", +"id": "GenaiVertexV1Retrieval", +"properties": { +"exaAiSearchConfig": { +"$ref": "GenaiVertexV1ExaAISearchConfig", +"description": "Used to specify configuration for ExaAISearch." +}, +"parallelAiSearchConfig": { +"$ref": "GenaiVertexV1ParallelAISearchConfig", +"description": "Used to specify configuration for ParallelAISearch." +}, +"ragStoreConfig": { +"$ref": "GenaiVertexV1RagStoreConfig", +"description": "Used to specify configuration for RagStore." +}, +"retrievalTypes": { +"description": "The types of file retrieval to enable.", +"items": { +"enum": [ +"RETRIEVAL_TYPE_UNSPECIFIED", +"RETRIEVAL_TYPE_VERTEX_AI_SEARCH", +"RETRIEVAL_TYPE_RAG_STORE", +"RETRIEVAL_TYPE_EXA_AI_SEARCH", +"RETRIEVAL_TYPE_PARALLEL_AI_SEARCH" +], +"enumDescriptions": [ +"", +"", +"", +"", +"" +], +"type": "string" +}, +"type": "array" +}, +"vertexAiSearchConfig": { +"$ref": "GenaiVertexV1VertexAISearchConfig", +"description": "Used to specify configuration for VertexAISearch." +} +}, +"type": "object" +}, +"GenaiVertexV1RetrievalCallDelta": { +"description": "Used by Vertex Retrieval tools such as Parallel AI, Exa AI, Vertex AI Search, etc. RetrievalType decides which tool is used.", +"id": "GenaiVertexV1RetrievalCallDelta", +"properties": { +"arguments": { +"$ref": "GenaiVertexV1RetrievalCallStepRetrievalStepArguments", +"description": "Required. The arguments to pass to the Retrieval tool." +}, +"retrievalType": { +"description": "The type of retrieval tools.", +"enum": [ +"RETRIEVAL_TYPE_UNSPECIFIED", +"RETRIEVAL_TYPE_VERTEX_AI_SEARCH", +"RETRIEVAL_TYPE_RAG_STORE", +"RETRIEVAL_TYPE_EXA_AI_SEARCH", +"RETRIEVAL_TYPE_PARALLEL_AI_SEARCH" +], +"enumDescriptions": [ +"", +"", +"", +"", +"" +], +"type": "string" +} +}, +"type": "object" +}, +"GenaiVertexV1RetrievalCallStep": { +"description": "Retrieval call step. Used by Vertex Retrieval tools such as Parallel AI, Exa AI, Vertex AI Search, etc. RetrievalType decides which tool is used.", +"id": "GenaiVertexV1RetrievalCallStep", +"properties": { +"arguments": { +"$ref": "GenaiVertexV1RetrievalCallStepRetrievalStepArguments", +"description": "Required. The arguments to pass to the retrieval tool." +}, +"retrievalType": { +"description": "The type of retrieval tools.", +"enum": [ +"RETRIEVAL_TYPE_UNSPECIFIED", +"RETRIEVAL_TYPE_VERTEX_AI_SEARCH", +"RETRIEVAL_TYPE_RAG_STORE", +"RETRIEVAL_TYPE_EXA_AI_SEARCH", +"RETRIEVAL_TYPE_PARALLEL_AI_SEARCH" +], +"enumDescriptions": [ +"", +"", +"", +"", +"" +], +"type": "string" +} +}, +"type": "object" +}, +"GenaiVertexV1RetrievalCallStepRetrievalStepArguments": { +"description": "The arguments to pass to Retrieval tools.", +"id": "GenaiVertexV1RetrievalCallStepRetrievalStepArguments", +"properties": { +"queries": { +"description": "Queries for Retrieval information.", +"items": { +"type": "string" +}, +"type": "array" +} +}, +"type": "object" +}, +"GenaiVertexV1RetrievalResultDelta": { +"description": "Used by Vertex Retrieval tools such as Parallel AI, Exa AI, Vertex AI Search, etc. ToolResultDelta.type", +"id": "GenaiVertexV1RetrievalResultDelta", +"properties": { +"isError": { +"description": "Whether the retrieval resulted in an error.", +"type": "boolean" +} +}, +"type": "object" +}, +"GenaiVertexV1RetrievalResultStep": { +"description": "Vertex Retrieval result step. Used by Vertex Retrieval tools such as Parallel AI, Exa AI, Vertex AI Search, etc.", +"id": "GenaiVertexV1RetrievalResultStep", +"properties": { +"isError": { +"description": "Whether the retrieval resulted in an error.", +"type": "boolean" +} +}, +"type": "object" +}, +"GenaiVertexV1ReviewSnippet": { +"description": "Encapsulates a snippet of a user review that answers a question about the features of a specific place in Google Maps.", +"id": "GenaiVertexV1ReviewSnippet", +"properties": { +"reviewId": { +"description": "The ID of the review snippet.", +"type": "string" +}, +"title": { +"description": "Title of the review.", +"type": "string" +}, +"url": { +"description": "A link that corresponds to the user review on Google Maps.", +"type": "string" +} +}, +"type": "object" +}, +"GenaiVertexV1SafetySetting": { +"description": "A safety setting that affects the safety-blocking behavior. A SafetySetting consists of a harm category and a threshold for that category.", +"id": "GenaiVertexV1SafetySetting", +"properties": { +"method": { +"description": "Optional. The method for blocking content. If not specified, the default behavior is to use the probability score.", +"enum": [ +"HARM_BLOCK_METHOD_UNSPECIFIED", +"SEVERITY", +"PROBABILITY" +], +"enumDescriptions": [ +"The harm block method is unspecified.", +"The harm block method uses both probability and severity scores.", +"The harm block method uses the probability score." +], +"type": "string" +}, +"threshold": { +"description": "Required. The threshold for blocking content. If the harm probability exceeds this threshold, the content will be blocked.", +"enum": [ +"HARM_BLOCK_THRESHOLD_UNSPECIFIED", +"BLOCK_LOW_AND_ABOVE", +"BLOCK_MEDIUM_AND_ABOVE", +"BLOCK_ONLY_HIGH", +"BLOCK_NONE", +"OFF" +], +"enumDescriptions": [ +"The harm block threshold is unspecified.", +"Block content with a low harm probability or higher.", +"Block content with a medium harm probability or higher.", +"Block content with a high harm probability.", +"Do not block any content, regardless of its harm probability.", +"Turn off the safety filter entirely." +], +"type": "string" +}, +"type": { +"description": "Required. The type of harm category to be blocked.", +"enum": [ +"HARM_CATEGORY_UNSPECIFIED", +"HARM_CATEGORY_HATE_SPEECH", +"HARM_CATEGORY_DANGEROUS_CONTENT", +"HARM_CATEGORY_HARASSMENT", +"HARM_CATEGORY_SEXUALLY_EXPLICIT", +"HARM_CATEGORY_CIVIC_INTEGRITY", +"HARM_CATEGORY_IMAGE_HATE", +"HARM_CATEGORY_IMAGE_DANGEROUS_CONTENT", +"HARM_CATEGORY_IMAGE_HARASSMENT", +"HARM_CATEGORY_IMAGE_SEXUALLY_EXPLICIT", +"HARM_CATEGORY_JAILBREAK" +], +"enumDeprecated": [ +false, +false, +false, +false, +false, +true, +false, +false, +false, +false, +false +], +"enumDescriptions": [ +"Default value. This value is unused.", +"Content that promotes violence or incites hatred against individuals or groups based on certain attributes.", +"Content that promotes, facilitates, or enables dangerous activities.", +"Abusive, threatening, or content intended to bully, torment, or ridicule.", +"Content that contains sexually explicit material.", +"Deprecated: Election filter is not longer supported. The harm category is civic integrity.", +"Images that contain hate speech.", +"Images that contain dangerous content.", +"Images that contain harassment.", +"Images that contain sexually explicit content.", +"Prompts designed to bypass safety filters." +], +"type": "string" +} +}, +"type": "object" +}, +"GenaiVertexV1ServerToolCallDelta": { +"id": "GenaiVertexV1ServerToolCallDelta", +"properties": { +"codeExecutionCall": { +"$ref": "GenaiVertexV1CodeExecutionCallDelta" +}, +"fileSearchCall": { +"$ref": "GenaiVertexV1FileSearchCallDelta" +}, +"googleMapsCall": { +"$ref": "GenaiVertexV1GoogleMapsCallDelta" +}, +"googleSearchCall": { +"$ref": "GenaiVertexV1GoogleSearchCallDelta" +}, +"processingCall": { +"$ref": "GenaiVertexV1ProcessingCallDelta" +}, +"retrievalCall": { +"$ref": "GenaiVertexV1RetrievalCallDelta" +}, +"signature": { +"description": "A signature hash for backend validation.", +"format": "byte", +"type": "string" +}, +"urlContextCall": { +"$ref": "GenaiVertexV1UrlContextCallDelta" +} +}, +"type": "object" +}, +"GenaiVertexV1ServerToolResultDelta": { +"id": "GenaiVertexV1ServerToolResultDelta", +"properties": { +"codeExecutionResult": { +"$ref": "GenaiVertexV1CodeExecutionResultDelta" +}, +"fileSearchResult": { +"$ref": "GenaiVertexV1FileSearchResultDelta" +}, +"googleMapsResult": { +"$ref": "GenaiVertexV1GoogleMapsResultDelta" +}, +"googleSearchResult": { +"$ref": "GenaiVertexV1GoogleSearchResultDelta" +}, +"processingResult": { +"$ref": "GenaiVertexV1ProcessingResultDelta" +}, +"retrievalResult": { +"$ref": "GenaiVertexV1RetrievalResultDelta" +}, +"signature": { +"description": "A signature hash for backend validation.", +"format": "byte", +"type": "string" +}, +"urlContextResult": { +"$ref": "GenaiVertexV1UrlContextResultDelta" +} +}, +"type": "object" +}, +"GenaiVertexV1SpeakerConfig": { +"description": "Configuration for multi-speaker and speech generation.", +"id": "GenaiVertexV1SpeakerConfig", +"properties": { +"speakers": { +"description": "Individual speaker configurations.", +"items": { +"$ref": "GenaiVertexV1SpeechConfig" +}, +"type": "array" +} +}, +"type": "object" +}, +"GenaiVertexV1SpeechAnnotation": { +"description": "Speech annotation for text content.", +"id": "GenaiVertexV1SpeechAnnotation", +"properties": { +"speaker": { +"description": "The speaker to associate with this turn.", +"type": "string" +}, +"style": { +"description": "Style instruction for the speech synthesis.", +"type": "string" +} +}, +"type": "object" +}, +"GenaiVertexV1SpeechConfig": { +"description": "The configuration for speech interaction.", +"id": "GenaiVertexV1SpeechConfig", +"properties": { +"language": { +"description": "The language of the speech.", +"type": "string" +}, +"speaker": { +"description": "The speaker's name, it should match the speaker name given in the prompt.", +"type": "string" +}, +"voice": { +"description": "The voice of the speaker.", +"type": "string" +} +}, +"type": "object" +}, +"GenaiVertexV1Step": { +"description": "A step in the interaction.", +"id": "GenaiVertexV1Step", +"properties": { +"modelOutput": { +"$ref": "GenaiVertexV1ModelOutputStep" +}, +"thought": { +"$ref": "GenaiVertexV1ThoughtStep" +}, +"toolCall": { +"$ref": "GenaiVertexV1ToolCallStep" +}, +"toolResult": { +"$ref": "GenaiVertexV1ToolResultStep" +}, +"userInput": { +"$ref": "GenaiVertexV1UserInputStep", +"description": "DO NOT USE -- These are for 3P JSON only" +} +}, +"type": "object" +}, +"GenaiVertexV1StepDelta": { +"id": "GenaiVertexV1StepDelta", +"properties": { +"delta": { +"$ref": "GenaiVertexV1StepDeltaData" +}, +"index": { +"format": "int32", +"type": "integer" +} +}, +"type": "object" +}, +"GenaiVertexV1StepDeltaData": { +"id": "GenaiVertexV1StepDeltaData", +"properties": { +"argumentsDelta": { +"$ref": "GenaiVertexV1ArgumentsDelta" +}, +"audio": { +"$ref": "GenaiVertexV1AudioDelta" +}, +"document": { +"$ref": "GenaiVertexV1DocumentDelta" +}, +"functionResult": { +"$ref": "GenaiVertexV1FunctionResultDelta" +}, +"image": { +"$ref": "GenaiVertexV1ImageDelta" +}, +"serverToolCall": { +"$ref": "GenaiVertexV1ServerToolCallDelta" +}, +"serverToolResult": { +"$ref": "GenaiVertexV1ServerToolResultDelta" +}, +"text": { +"$ref": "GenaiVertexV1TextDelta" +}, +"textAnnotationDelta": { +"$ref": "GenaiVertexV1TextAnnotationDelta" +}, +"thoughtSignature": { +"$ref": "GenaiVertexV1ThoughtSignatureDelta" +}, +"thoughtSummary": { +"$ref": "GenaiVertexV1ThoughtSummaryDelta" +}, +"video": { +"$ref": "GenaiVertexV1VideoDelta" +} +}, +"type": "object" +}, +"GenaiVertexV1StepList": { +"description": "A list of Steps.", +"id": "GenaiVertexV1StepList", +"properties": { +"steps": { +"description": "The steps of the list.", +"items": { +"$ref": "GenaiVertexV1Step" +}, +"type": "array" +} +}, +"type": "object" +}, +"GenaiVertexV1StepStart": { +"id": "GenaiVertexV1StepStart", +"properties": { +"index": { +"format": "int32", +"type": "integer" +}, +"step": { +"$ref": "GenaiVertexV1Step" +} +}, +"type": "object" +}, +"GenaiVertexV1StepStop": { +"id": "GenaiVertexV1StepStop", +"properties": { +"index": { +"format": "int32", +"type": "integer" +}, +"stepUsage": { +"$ref": "GenaiVertexV1InteractionUsage", +"description": "Model usage stats for this specific step." +}, +"usage": { +"$ref": "GenaiVertexV1InteractionUsage", +"description": "Cumulative model usage stats from the start of the session." +} +}, +"type": "object" +}, +"GenaiVertexV1Struct": { +"description": "`Struct` represents a structured data value, consisting of fields which map to dynamically typed values.", +"id": "GenaiVertexV1Struct", +"properties": { +"fields": { +"description": "Dynamically typed fields. List instead of map because LLMs are sensitive to ordering, and we want to give users full control.", +"items": { +"$ref": "GenaiVertexV1Field" +}, +"type": "array" +} +}, +"type": "object" +}, +"GenaiVertexV1TextAnnotationDelta": { +"id": "GenaiVertexV1TextAnnotationDelta", +"properties": { +"annotations": { +"description": "Citation information for model-generated content.", +"items": { +"$ref": "GenaiVertexV1TextContentAnnotation" +}, +"type": "array" +} +}, +"type": "object" +}, +"GenaiVertexV1TextContent": { +"description": "A text content block. ", +"id": "GenaiVertexV1TextContent", +"properties": { +"annotations": { +"description": "Citation information for model-generated content.", +"items": { +"$ref": "GenaiVertexV1TextContentAnnotation" +}, +"type": "array" +}, +"text": { +"description": "Required. The text content.", +"type": "string" +} +}, +"type": "object" +}, +"GenaiVertexV1TextContentAnnotation": { +"description": "Citation information for model-generated content.", +"id": "GenaiVertexV1TextContentAnnotation", +"properties": { +"endIndex": { +"description": "End of the attributed segment, exclusive.", +"format": "int32", +"type": "integer" +}, +"fileCitation": { +"$ref": "GenaiVertexV1FileCitation", +"description": "A file citation annotation." +}, +"placeCitation": { +"$ref": "GenaiVertexV1PlaceCitation", +"description": "A place citation annotation." +}, +"speechMetadata": { +"$ref": "GenaiVertexV1SpeechAnnotation", +"description": "Speech annotation for text content." +}, +"startIndex": { +"description": "Start of segment of the response that is attributed to this source. Index indicates the start of the segment, measured in bytes.", +"format": "int32", +"type": "integer" +}, +"urlCitation": { +"$ref": "GenaiVertexV1UrlCitation", +"description": "NOTE: We use these instead of the Citation message for historical reasons. A URL citation annotation." +}, +"wordInfo": { +"$ref": "GenaiVertexV1WordInfo", +"description": "Word-level ASR annotation with timing and speaker info." +} +}, +"type": "object" +}, +"GenaiVertexV1TextDelta": { +"id": "GenaiVertexV1TextDelta", +"properties": { +"text": { +"type": "string" +} +}, +"type": "object" +}, +"GenaiVertexV1TextResponseFormat": { +"description": "Configuration for text output format.", +"id": "GenaiVertexV1TextResponseFormat", +"properties": { +"mimeType": { +"description": "The MIME type of the text output.", +"enum": [ +"TYPE_UNSPECIFIED", +"TYPE_APPLICATION_JSON", +"TYPE_TEXT_PLAIN" +], +"enumDescriptions": [ +"Default value. This value is unused.", +"JSON output format.", +"Plain text output format." +], +"type": "string" +}, +"schema": { +"$ref": "GenaiVertexV1Struct", +"description": "The JSON schema that the output should conform to. Only applicable when mime_type is application/json." +} +}, +"type": "object" +}, +"GenaiVertexV1ThoughtSignatureDelta": { +"id": "GenaiVertexV1ThoughtSignatureDelta", +"properties": { +"signature": { +"description": "Signature to match the backend source to be part of the generation.", +"format": "byte", +"type": "string" +} +}, +"type": "object" +}, +"GenaiVertexV1ThoughtStep": { +"description": "A thought step.", +"id": "GenaiVertexV1ThoughtStep", +"properties": { +"signature": { +"description": "A signature hash for backend validation.", +"format": "byte", +"type": "string" +}, +"summary": { +"description": "A summary of the thought.", +"items": { +"$ref": "GenaiVertexV1Content" +}, +"type": "array" +} +}, +"type": "object" +}, +"GenaiVertexV1ThoughtSummaryDelta": { +"id": "GenaiVertexV1ThoughtSummaryDelta", +"properties": { +"content": { +"$ref": "GenaiVertexV1Content", +"description": "A new summary item to be added to the thought." +} +}, +"type": "object" +}, +"GenaiVertexV1Tool": { +"description": "A tool that can be used by the model.", +"id": "GenaiVertexV1Tool", +"properties": { +"codeExecution": { +"$ref": "GenaiVertexV1CodeExecution", +"description": "A tool that can be used by the model to execute code." +}, +"computerUse": { +"$ref": "GenaiVertexV1ComputerUse", +"description": "Tool to support the model interacting directly with the computer." +}, +"fileSearch": { +"$ref": "GenaiVertexV1FileSearch", +"description": "A tool that can be used by the model to search files." +}, +"function": { +"$ref": "GenaiVertexV1Function", +"description": "A function that can be used by the model." +}, +"googleMaps": { +"$ref": "GenaiVertexV1GoogleMaps", +"description": "A tool that can be used by the model to search Google Maps." +}, +"googleSearch": { +"$ref": "GenaiVertexV1GoogleSearch", +"description": "A tool that can be used by the model to search Google." +}, +"mcpServer": { +"$ref": "GenaiVertexV1McpServer", +"description": "A MCPServer is a server that can be called by the model to perform actions." +}, +"retrieval": { +"$ref": "GenaiVertexV1Retrieval", +"description": "A tool that can be used by the model to retrieve files." +}, +"urlContext": { +"$ref": "GenaiVertexV1UrlContext", +"description": "A tool that can be used by the model to fetch URL context." +} +}, +"type": "object" +}, +"GenaiVertexV1ToolCallStep": { +"description": "Tool call step.", +"id": "GenaiVertexV1ToolCallStep", +"properties": { +"codeExecutionCall": { +"$ref": "GenaiVertexV1CodeExecutionCallStep" +}, +"fileSearchCall": { +"$ref": "GenaiVertexV1FileSearchCallStep" +}, +"functionCall": { +"$ref": "GenaiVertexV1FunctionCallStep" +}, +"googleMapsCall": { +"$ref": "GenaiVertexV1GoogleMapsCallStep" +}, +"googleSearchCall": { +"$ref": "GenaiVertexV1GoogleSearchCallStep" +}, +"id": { +"description": "Required. A unique ID for this specific tool call.", +"type": "string" +}, +"processingCall": { +"$ref": "GenaiVertexV1ProcessingCallStep" +}, +"retrievalCall": { +"$ref": "GenaiVertexV1RetrievalCallStep" +}, +"signature": { +"description": "A signature hash for backend validation.", +"format": "byte", +"type": "string" +}, +"urlContextCall": { +"$ref": "GenaiVertexV1UrlContextCallStep" +} +}, +"type": "object" +}, +"GenaiVertexV1ToolChoiceConfig": { +"description": "The tool choice configuration containing allowed tools.", +"id": "GenaiVertexV1ToolChoiceConfig", +"properties": { +"allowedTools": { +"$ref": "GenaiVertexV1AllowedTools", +"description": "The allowed tools." +} +}, +"type": "object" +}, +"GenaiVertexV1ToolResultStep": { +"description": "Tool result step.", +"id": "GenaiVertexV1ToolResultStep", +"properties": { +"callId": { +"description": "Required. ID to match the ID from the function call block.", +"type": "string" +}, +"codeExecutionResult": { +"$ref": "GenaiVertexV1CodeExecutionResultStep" +}, +"fileSearchResult": { +"$ref": "GenaiVertexV1FileSearchResultStep" +}, +"functionResult": { +"$ref": "GenaiVertexV1FunctionResultStep" +}, +"googleMapsResult": { +"$ref": "GenaiVertexV1GoogleMapsResultStep" +}, +"googleSearchResult": { +"$ref": "GenaiVertexV1GoogleSearchResultStep" +}, +"processingResult": { +"$ref": "GenaiVertexV1ProcessingResultStep" +}, +"retrievalResult": { +"$ref": "GenaiVertexV1RetrievalResultStep" +}, +"signature": { +"description": "A signature hash for backend validation.", +"format": "byte", +"type": "string" +}, +"urlContextResult": { +"$ref": "GenaiVertexV1UrlContextResultStep" +} +}, +"type": "object" +}, +"GenaiVertexV1TranscriptionConfig": { +"description": "Configuration for speech recognition (transcription).", +"id": "GenaiVertexV1TranscriptionConfig", +"properties": { +"adaptationPhrases": { +"deprecated": true, +"description": "Optional. A list of phrases to bias the ASR model towards.", +"items": { +"type": "string" +}, +"type": "array" +}, +"customVocabulary": { +"description": "Optional. A list of custom vocabulary phrases to bias the speech recognition model toward recognizing specific terms.", +"items": { +"type": "string" +}, +"type": "array" +}, +"diarizationMode": { +"deprecated": true, +"description": "Optional. Configures speaker diarization. Supported values: \"speaker\".", +"type": "string" +}, +"languageCodes": { +"description": "Optional. BCP-47 language codes providing hints about the languages present in the audio. If omitted or empty, defaults to automatic language detection.", +"items": { +"type": "string" +}, +"type": "array" +}, +"timestampGranularities": { +"deprecated": true, +"description": "Optional. The granularity of timestamps to include in the transcription output. Supported values: \"word\". If empty, no timestamps are generated.", +"items": { +"type": "string" +}, +"type": "array" +} +}, +"type": "object" +}, +"GenaiVertexV1UrlCitation": { +"description": "A URL citation annotation.", +"id": "GenaiVertexV1UrlCitation", +"properties": { +"title": { +"description": "The title of the URL.", +"type": "string" +}, +"url": { +"description": "The URL.", +"type": "string" +} +}, +"type": "object" +}, +"GenaiVertexV1UrlContext": { +"description": "A tool that can be used by the model to fetch URL context.", +"id": "GenaiVertexV1UrlContext", +"properties": {}, +"type": "object" +}, +"GenaiVertexV1UrlContextCallContentUrlContextCallArguments": { +"description": "The arguments to pass to the URL context.", +"id": "GenaiVertexV1UrlContextCallContentUrlContextCallArguments", +"properties": { +"urls": { +"description": "The URLs to fetch.", +"items": { +"type": "string" +}, +"type": "array" +} +}, +"type": "object" +}, +"GenaiVertexV1UrlContextCallDelta": { +"id": "GenaiVertexV1UrlContextCallDelta", +"properties": { +"arguments": { +"$ref": "GenaiVertexV1UrlContextCallContentUrlContextCallArguments" +} +}, +"type": "object" +}, +"GenaiVertexV1UrlContextCallStep": { +"description": "URL context call step.", +"id": "GenaiVertexV1UrlContextCallStep", +"properties": { +"arguments": { +"$ref": "GenaiVertexV1UrlContextCallStepUrlContextCallStepArguments", +"description": "Required. The arguments to pass to the URL context." +} +}, +"type": "object" +}, +"GenaiVertexV1UrlContextCallStepUrlContextCallStepArguments": { +"description": "The arguments to pass to the URL context.", +"id": "GenaiVertexV1UrlContextCallStepUrlContextCallStepArguments", +"properties": { +"urls": { +"description": "The URLs to fetch.", +"items": { +"type": "string" +}, +"type": "array" +} +}, +"type": "object" +}, +"GenaiVertexV1UrlContextResultContentUrlContextResult": { +"description": "The result of the URL context.", +"id": "GenaiVertexV1UrlContextResultContentUrlContextResult", +"properties": { +"status": { +"description": "The status of the URL retrieval.", +"enum": [ +"STATUS_UNSPECIFIED", +"SUCCESS", +"ERROR", +"PAYWALL", +"UNSAFE" +], +"enumDescriptions": [ +"Unspecified status. This value should not be used.", +"Url retrieval is successful.", +"Url retrieval is failed due to error.", +"Url retrieval is failed because the content is behind paywall.", +"Url retrieval is failed because the content is unsafe." +], +"type": "string" +}, +"url": { +"description": "The URL that was fetched.", +"type": "string" +} +}, +"type": "object" +}, +"GenaiVertexV1UrlContextResultDelta": { +"id": "GenaiVertexV1UrlContextResultDelta", +"properties": { +"isError": { +"type": "boolean" +}, +"result": { +"items": { +"$ref": "GenaiVertexV1UrlContextResultContentUrlContextResult" +}, +"type": "array" +} +}, +"type": "object" +}, +"GenaiVertexV1UrlContextResultStep": { +"description": "URL context result step.", +"id": "GenaiVertexV1UrlContextResultStep", +"properties": { +"isError": { +"description": "Whether the URL context resulted in an error.", +"type": "boolean" +}, +"result": { +"description": "Required. The results of the URL context.", +"items": { +"$ref": "GenaiVertexV1UrlContextResultStepUrlContextResultItem" +}, +"type": "array" +} +}, +"type": "object" +}, +"GenaiVertexV1UrlContextResultStepUrlContextResultItem": { +"description": "The result of the URL context.", +"id": "GenaiVertexV1UrlContextResultStepUrlContextResultItem", +"properties": { +"status": { +"description": "The status of the URL retrieval.", +"enum": [ +"STATUS_UNSPECIFIED", +"SUCCESS", +"ERROR", +"PAYWALL", +"UNSAFE" +], +"enumDescriptions": [ +"", +"", +"", +"", +"" +], +"type": "string" +}, +"url": { +"description": "The URL that was fetched.", +"type": "string" +} +}, +"type": "object" +}, +"GenaiVertexV1UserInputStep": { +"description": "Input provided by the user.", +"id": "GenaiVertexV1UserInputStep", +"properties": { +"contentList": { +"$ref": "GenaiVertexV1ContentList", +"description": "The content of the step. An array of Content objects." +}, +"contentString": { +"description": "The content of the step. A single string.", +"type": "string" +} +}, +"type": "object" +}, +"GenaiVertexV1Value": { +"description": "`Value` represents a dynamically typed value which can be either null, a number, a string, a boolean, a recursive struct value, or a list of values. A producer of value is expected to set one of these variants. Absence of any variant indicates an error.", +"id": "GenaiVertexV1Value", +"properties": { +"boolValue": { +"description": "Represents a boolean value.", +"type": "boolean" +}, +"contentValue": { +"$ref": "GenaiVertexV1Content", +"description": "Represents rich content (text, image, etc.)." +}, +"listValue": { +"$ref": "GenaiVertexV1ListValue", +"description": "Represents a repeated `Value`." +}, +"nullValue": { +"description": "Represents a null value.", +"enum": [ +"NULL_VALUE" +], +"enumDescriptions": [ +"Null value." +], +"type": "string" +}, +"numberValue": { +"description": "Represents a double value.", +"format": "double", +"type": "number" +}, +"stringValue": { +"description": "Represents a string value.", +"type": "string" +}, +"structValue": { +"$ref": "GenaiVertexV1Struct", +"description": "Represents a structured value." +} +}, +"type": "object" +}, +"GenaiVertexV1VertexAISearchConfig": { +"description": "Used to specify configuration for VertexAISearch.", +"id": "GenaiVertexV1VertexAISearchConfig", +"properties": { +"datastores": { +"description": "Optional. Used to specify Vertex AI Search datastores.", +"items": { +"type": "string" +}, +"type": "array" +}, +"engine": { +"description": "Optional. Used to specify Vertex AI Search engine.", +"type": "string" +} +}, +"type": "object" +}, +"GenaiVertexV1VideoConfig": { +"description": "Configuration options for video generation.", +"id": "GenaiVertexV1VideoConfig", +"properties": { +"task": { +"description": "Optional task mode for video generation. If not specified, the model automatically determines the appropriate mode based on the provided text prompt and input media.", +"enum": [ +"TASK_UNSPECIFIED", +"TEXT_TO_VIDEO", +"IMAGE_TO_VIDEO", +"REFERENCE_TO_VIDEO", +"EDIT", +"EXTEND" +], +"enumDescriptions": [ +"Unspecified task. The task is inferred from the input prompt and media.", +"Generates video solely from a text prompt.", +"Generates video from one or two source images. The first image defines the starting frame, and the optional second image defines the ending frame.", +"Generates video using reference media (such as images, audio, or video).", +"Modifies an existing input video.", +"Extends an existing input video." +], +"type": "string" +} +}, +"type": "object" +}, +"GenaiVertexV1VideoContent": { +"description": "A video content block. ", +"id": "GenaiVertexV1VideoContent", +"properties": { +"data": { +"description": "The video content.", +"format": "byte", +"type": "string" +}, +"mimeTypeString": { +"description": "Flexible MIME type string of the video, superseding mime_type = 1. Note: Bespoke logic in the GAOS parser/serializer maps this to the \"mime_type\" JSON key.", +"type": "string" +}, +"name": { +"description": "A user-defined name for this content block. Can be referenced by the model in the final response.", +"type": "string" +}, +"processingConfig": { +"$ref": "GenaiVertexV1VideoContentMediaProcessing" +}, +"processingType": { +"enum": [ +"PROCESSING_UNSPECIFIED", +"STATIC", +"AGENTIC" +], +"enumDescriptions": [ +"Default. Uses model-specific processing (3.5 Pro+ --> AGENTIC, older models --> STATIC)", +"Fixed-rate frame extraction. All frames placed in context.", +"Model-driven dynamic navigation." +], +"type": "string" +}, +"resolution": { +"description": "The resolution of the media.", +"enum": [ +"MEDIA_RESOLUTION_UNSPECIFIED", +"LOW", +"MEDIUM", +"HIGH", +"ULTRA_HIGH" +], +"enumDescriptions": [ +"Default value. This value is unused.", +"Low resolution.", +"Medium resolution.", +"High resolution.", +"Ultra high resolution." +], +"type": "string" +}, +"uri": { +"description": "The URI of the video.", +"type": "string" +} +}, +"type": "object" +}, +"GenaiVertexV1VideoContentMediaProcessing": { +"id": "GenaiVertexV1VideoContentMediaProcessing", +"properties": { +"static": { +"$ref": "GenaiVertexV1VideoContentStaticMediaProcessing" +} +}, +"type": "object" +}, +"GenaiVertexV1VideoContentStaticMediaProcessing": { +"id": "GenaiVertexV1VideoContentStaticMediaProcessing", +"properties": { +"endOffset": { +"description": "Optional. Segment end time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., \"30s\". Must be non-negative and greater than `start_offset` if `start_offset` is set.", +"format": "google-duration", +"type": "string" +}, +"fps": { +"description": "Optional. Video frame-rate sampling density.", +"format": "double", +"type": "number" +}, +"startOffset": { +"description": "Optional. Segment start time. Specified as a decimal number of seconds followed by an 's' suffix, e.g., \"10.5s\". Must be non-negative.", +"format": "google-duration", +"type": "string" +} +}, +"type": "object" +}, +"GenaiVertexV1VideoDelta": { +"id": "GenaiVertexV1VideoDelta", +"properties": { +"data": { +"format": "byte", +"type": "string" +}, +"mimeType": { +"enum": [ +"TYPE_UNSPECIFIED", +"TYPE_MP4", +"TYPE_MPEG", +"TYPE_MPG", +"TYPE_MOV", +"TYPE_AVI", +"TYPE_X_FLV", +"TYPE_WEBM", +"TYPE_WMV", +"TYPE_3GPP", +"TYPE_JPEG2000" +], +"enumDescriptions": [ +"", +"MP4 video format", +"MPEG video format", +"MPG video format", +"MOV video format", +"AVI video format", +"FLV video format", +"WebM video format", +"WMV video format", +"3GPP video format", +"JPEG 2000 video format" +], +"type": "string" +}, +"resolution": { +"description": "The resolution of the media.", +"enum": [ +"MEDIA_RESOLUTION_UNSPECIFIED", +"LOW", +"MEDIUM", +"HIGH", +"ULTRA_HIGH" +], +"enumDescriptions": [ +"Default value. This value is unused.", +"Low resolution.", +"Medium resolution.", +"High resolution.", +"Ultra high resolution." +], +"type": "string" +}, +"uri": { +"type": "string" +} +}, +"type": "object" +}, +"GenaiVertexV1VideoResponseFormat": { +"description": "Configuration for video output format.", +"id": "GenaiVertexV1VideoResponseFormat", +"properties": { +"aspectRatio": { +"description": "The aspect ratio for the video output.", +"enum": [ +"ASPECT_RATIO_UNSPECIFIED", +"ASPECT_RATIO_SIXTEEN_BY_NINE", +"ASPECT_RATIO_NINE_BY_SIXTEEN" +], +"enumDescriptions": [ +"Default value. This value is unused.", +"16:9 aspect ratio.", +"9:16 aspect ratio." +], +"type": "string" +}, +"delivery": { +"description": "The delivery mode for the video output.", +"enum": [ +"DELIVERY_UNSPECIFIED", +"INLINE", +"URI" +], +"enumDescriptions": [ +"Default value. This value is unused.", +"Video data is returned inline in the response.", +"Video data is returned as a URI." +], +"type": "string" +}, +"duration": { +"description": "The duration for the video output.", +"format": "google-duration", +"type": "string" +}, +"gcsUri": { +"description": "The Cloud Storage URI to store the video output. Required for Vertex if delivery mode is URI.", +"type": "string" +}, +"resolution": { +"description": "The video output resolution. Defaults to 720p.", +"enum": [ +"RESOLUTION_UNSPECIFIED", +"RESOLUTION_THREE_SIXTY_P", +"RESOLUTION_SEVEN_TWENTY_P", +"RESOLUTION_TEN_EIGHTY_P", +"RESOLUTION_FOUR_K" +], +"enumDescriptions": [ +"Default value. This value is unused.", +"360p resolution.", +"720p resolution.", +"1080p resolution.", +"4K resolution." +], +"type": "string" +} +}, +"type": "object" +}, +"GenaiVertexV1WordInfo": { +"description": "Word-level ASR annotation for transcription output. Carries the word text, optional timing, and optional speaker attribution.", +"id": "GenaiVertexV1WordInfo", +"properties": { +"endOffset": { +"description": "End offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains \"word\".", +"format": "google-duration", +"type": "string" +}, +"speaker": { +"description": "Optional. Speaker label for this word (e.g. \"spk_1\", \"spk_2\"). Present when diarization_mode is set in TranscriptionConfig.", +"type": "string" +}, +"startOffset": { +"description": "Start offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains \"word\".", +"format": "google-duration", +"type": "string" +}, +"text": { +"description": "The transcribed word.", +"type": "string" +} +}, +"type": "object" +}, +"GoogleApiHttpBody": { +"description": "Message that represents an arbitrary HTTP body. It should only be used for payload formats that can't be represented as JSON, such as raw binary or an HTML page. This message can be used both in streaming and non-streaming API methods in the request as well as the response. It can be used as a top-level request field, which is convenient if one wants to extract parameters from either the URL or HTTP template into the request fields and also want access to the raw HTTP body. Example: message GetResourceRequest { // A unique request id. string request_id = 1; // The raw HTTP body is bound to this field. google.api.HttpBody http_body = 2; } service ResourceService { rpc GetResource(GetResourceRequest) returns (google.api.HttpBody); rpc UpdateResource(google.api.HttpBody) returns (google.protobuf.Empty); } Example with streaming methods: service CaldavService { rpc GetCalendar(stream google.api.HttpBody) returns (stream google.api.HttpBody); rpc UpdateCalendar(stream google.api.HttpBody) returns (stream google.api.HttpBody); } Use of this type only changes how the request and response bodies are handled, all other features will continue to work unchanged.", +"id": "GoogleApiHttpBody", +"properties": { +"contentType": { +"description": "The HTTP Content-Type header value specifying the content type of the body.", +"type": "string" +}, +"data": { +"description": "The HTTP request/response body as raw binary.", +"format": "byte", +"type": "string" +}, +"extensions": { +"description": "Application specific response metadata. Must be set in the first response for streaming APIs.", +"items": { +"additionalProperties": { +"description": "Properties of the object. Contains field @type with type URL.", +"type": "any" +}, +"type": "object" +}, +"type": "array" +} +}, +"type": "object" +}, +"GoogleCloudAiplatformV1ActivateOnlineEvaluatorOperationMetadata": { +"description": "Metadata for the ActivateOnlineEvaluator operation.", +"id": "GoogleCloudAiplatformV1ActivateOnlineEvaluatorOperationMetadata", +"properties": { +"genericMetadata": { +"$ref": "GoogleCloudAiplatformV1GenericOperationMetadata", +"description": "Common part of operation metadata." +} +}, +"type": "object" +}, +"GoogleCloudAiplatformV1ActivateOnlineEvaluatorRequest": { +"description": "Request message for ActivateOnlineEvaluator.", +"id": "GoogleCloudAiplatformV1ActivateOnlineEvaluatorRequest", +"properties": {}, +"type": "object" +}, +"GoogleCloudAiplatformV1ActiveLearningConfig": { +"description": "Parameters that configure the active learning pipeline. Active learning will label the data incrementally by several iterations. For every iteration, it will select a batch of data based on the sampling strategy.", +"id": "GoogleCloudAiplatformV1ActiveLearningConfig", +"properties": { +"maxDataItemCount": { +"description": "Max number of human labeled DataItems.", +"format": "int64", +"type": "string" +}, +"maxDataItemPercentage": { +"description": "Max percent of total DataItems for human labeling.", +"format": "int32", +"type": "integer" +}, +"sampleConfig": { +"$ref": "GoogleCloudAiplatformV1SampleConfig", +"description": "Active learning data sampling config. For every active learning labeling iteration, it will select a batch of data based on the sampling strategy." +}, +"trainingConfig": { +"$ref": "GoogleCloudAiplatformV1TrainingConfig", +"description": "CMLE training config. For every active learning labeling iteration, system will train a machine learning model on CMLE. The trained model will be used by data sampling algorithm to select DataItems." +} +}, +"type": "object" +}, +"GoogleCloudAiplatformV1AddContextArtifactsAndExecutionsRequest": { +"description": "Request message for MetadataService.AddContextArtifactsAndExecutions.", +"id": "GoogleCloudAiplatformV1AddContextArtifactsAndExecutionsRequest", +"properties": { +"artifacts": { +"description": "The resource names of the Artifacts to attribute to the Context. Format: `projects/{project}/locations/{location}/metadataStores/{metadatastore}/artifacts/{artifact}`", +"items": { +"type": "string" +}, +"type": "array" +}, +"executions": { +"description": "The resource names of the Executions to associate with the Context. Format: `projects/{project}/locations/{location}/metadataStores/{metadatastore}/executions/{execution}`", +"items": { +"type": "string" +}, +"type": "array" +} +}, +"type": "object" +}, +"GoogleCloudAiplatformV1AddContextArtifactsAndExecutionsResponse": { +"description": "Response message for MetadataService.AddContextArtifactsAndExecutions.", +"id": "GoogleCloudAiplatformV1AddContextArtifactsAndExecutionsResponse", +"properties": {}, +"type": "object" +}, +"GoogleCloudAiplatformV1AddContextChildrenRequest": { +"description": "Request message for MetadataService.AddContextChildren.", +"id": "GoogleCloudAiplatformV1AddContextChildrenRequest", +"properties": { +"childContexts": { +"description": "The resource names of the child Contexts.", +"items": { +"type": "string" +}, +"type": "array" +} +}, +"type": "object" +}, +"GoogleCloudAiplatformV1AddContextChildrenResponse": { +"description": "Response message for MetadataService.AddContextChildren.", +"id": "GoogleCloudAiplatformV1AddContextChildrenResponse", +"properties": {}, +"type": "object" +}, +"GoogleCloudAiplatformV1AddExecutionEventsRequest": { +"description": "Request message for MetadataService.AddExecutionEvents.", +"id": "GoogleCloudAiplatformV1AddExecutionEventsRequest", +"properties": { +"events": { +"description": "The Events to create and add.", +"items": { +"$ref": "GoogleCloudAiplatformV1Event" +}, +"type": "array" +} +}, +"type": "object" +}, +"GoogleCloudAiplatformV1AddExecutionEventsResponse": { +"description": "Response message for MetadataService.AddExecutionEvents.", +"id": "GoogleCloudAiplatformV1AddExecutionEventsResponse", +"properties": {}, +"type": "object" +}, +"GoogleCloudAiplatformV1AddTrialMeasurementRequest": { +"description": "Request message for VizierService.AddTrialMeasurement.", +"id": "GoogleCloudAiplatformV1AddTrialMeasurementRequest", +"properties": { +"measurement": { +"$ref": "GoogleCloudAiplatformV1Measurement", +"description": "Required. The measurement to be added to a Trial." +} +}, +"type": "object" +}, +"GoogleCloudAiplatformV1Agent": { +"description": "A Vertex agent contains instructions and configurations for the LLM to execute a certain task.", +"id": "GoogleCloudAiplatformV1Agent", +"properties": { +"base_agent": { +"description": "Required. Immutable. The base agent for the agent. Supported values: * `antigravity-preview-05-2026` Immutable: `UpdateAgent` rejects a change, including clearing it. The kind of agent this is gets derived from this field when the agent is created and is recorded then; nothing recomputes it afterwards, so a later change would leave the agent described as one kind and behaving as another. Create a new agent instead.", +"type": "string" +}, +"base_environment": { +"description": "Optional. The base environment configuration for the agent. Valid types: * A string value for the environment ID, or `remote` for the default. * A struct value for the `environment_config`.", +"type": "any" +}, +"created": { +"description": "Output only. The time the agent was created.", +"format": "google-datetime", +"readOnly": true, +"type": "string" +}, +"description": { +"description": "Optional. The description of the agent.", +"type": "string" +}, +"effectiveIdentity": { +"description": "Output only. The resolved Agent Identity (SPIFFE principal) of the agent.", +"readOnly": true, +"type": "string" +}, +"id": { +"description": "Immutable. The user-specified ID for the agent. This ID becomes the final component of the agent resource name. If not provided, Vertex AI will generate a value for this ID. The ID can be up to 63 characters and must match the regular expression `[a-z]([a-z0-9-]{0,61}[a-z0-9])?`.", +"type": "string" +}, +"metadata": { +"additionalProperties": { +"type": "string" +}, +"description": "Optional. The metadata for the agent.", +"type": "object" +}, +"modelConfig": { +"$ref": "GoogleCloudAiplatformV1AgentModelConfig", +"description": "Optional. Model configuration for the agent. When set, tasks running under this agent default to this model configuration if they do not specify their own." +}, +"name": { +"description": "Identifier. The resource name of the agent. Format: `projects/{project}/locations/{location}/agents/{agent}`.", +"type": "string" +}, +"object": { +"description": "Output only. The object type of the resource. For agents, the value is `agent`.", +"readOnly": true, +"type": "string" +}, +"observabilityConfig": { +"$ref": "GoogleCloudAiplatformV1ObservabilityConfig", +"description": "Optional. Observability settings for this agent's sessions." +}, +"system_instruction": { +"description": "Optional. The instructions for the agent to follow. These instructions are passed to the LLM as a system instruction.", +"type": "string" +}, +"tools": { +"description": "Optional. The tools available to the agent.", +"items": { +"$ref": "GoogleCloudAiplatformV1AgentTool" +}, +"type": "array" +}, +"updated": { +"description": "Output only. The time the agent was last updated.", +"format": "google-datetime", +"readOnly": true, +"type": "string" +} +}, +"type": "object" +}, +"GoogleCloudAiplatformV1AgentConfig": { +"description": "Represents configuration for an Agent.", +"id": "GoogleCloudAiplatformV1AgentConfig", +"properties": { +"agentId": { +"description": "Required. Unique identifier of the agent. This ID is used to refer to this agent, e.g., in AgentEvent.author, or in the `sub_agents` field. It must be unique within the `agents` map.", +"type": "string" +}, +"agentType": { +"description": "Optional. The type or class of the agent (e.g., \"LlmAgent\", \"RouterAgent\", \"ToolUseAgent\"). Useful for the autorater to understand the expected behavior of the agent.", +"type": "string" +}, +"description": { +"description": "Optional. A high-level description of the agent's role and responsibilities. Critical for evaluating if the agent is routing tasks correctly.", +"type": "string" +}, +"instruction": { +"description": "Optional. Provides instructions for the LLM model, guiding the agent's behavior. Can be static or dynamic. Dynamic instructions can contain placeholders like {variable_name} that will be resolved at runtime using the `AgentEvent.state_delta` field.", +"type": "string" +}, +"subAgents": { +"description": "Optional. The list of valid agent IDs that this agent can delegate to. This defines the directed edges in the multi-agent system graph topology.", +"items": { +"type": "string" +}, +"type": "array" +}, +"tools": { +"description": "Optional. The list of tools available to this agent.", +"items": { +"$ref": "GoogleCloudAiplatformV1Tool" +}, +"type": "array" +} +}, +"type": "object" +}, +"GoogleCloudAiplatformV1AgentData": { +"description": "Represents data specific to multi-turn agent evaluations.", +"id": "GoogleCloudAiplatformV1AgentData", +"properties": { +"agents": { +"additionalProperties": { +"$ref": "GoogleCloudAiplatformV1AgentConfig" +}, +"description": "Optional. A map containing the static configurations for each agent in the system. Key: agent_id (matches the `author` field in events). Value: The static configuration of the agent.", "type": "object" }, "turns": { @@ -40127,6 +43892,12 @@ "description": "Output only. The content of the candidate.", "readOnly": true }, +"continuationToken": { +"description": "Output only. An optional opaque continuation token returned when `finish_reason` is `CONTINUATION`. Clients can pass this token in a subsequent `GenerateContentRequest` to continue generation.", +"format": "byte", +"readOnly": true, +"type": "string" +}, "finishMessage": { "description": "Output only. Describes the reason the model stopped generating tokens in more detail. This field is returned only when `finish_reason` is set.", "readOnly": true, @@ -40151,7 +43922,9 @@ "IMAGE_RECITATION", "IMAGE_OTHER", "UNEXPECTED_TOOL_CALL", -"NO_IMAGE" +"NO_IMAGE", +"MALFORMED_RESPONSE", +"CONTINUATION" ], "enumDescriptions": [ "The finish reason is unspecified.", @@ -40170,7 +43943,9 @@ "The generated image may be a recitation from a source.", "The image generation stopped for a reason not otherwise specified.", "The model generated a function call that is semantically invalid. This can happen, for example, if function calling is not enabled or the generated function is not in the function declaration.", -"The model was expected to generate an image, but didn't." +"The model was expected to generate an image, but didn't.", +"Finishes due to malformed response.", +"Token generation was stopped because the response reached the per-request token limit, but generation is not yet complete. The model response can be continued via a subsequent request using the returned `continuation_token`." ], "readOnly": true, "type": "string" @@ -44238,6 +48013,10 @@ "deprecated": true, "description": "Optional. Deprecated: Use `agent_eval_data` instead. Data used for agent evaluation." }, +"agentEvalData": { +"$ref": "GoogleCloudAiplatformV1AgentData", +"description": "Optional. Data used for agent evaluation." +}, "interactionsDataSource": { "$ref": "GoogleCloudAiplatformV1EvaluationInstanceInteractionsDataSource", "description": "Optional. Source for populating `AgentData` from an Interactions API interaction. If set, no other agent data source fields (`cloud_trace_agent_data_source`, `agent_eval_data`, `agent_data`) may be set. The request will be rejected with INVALID_ARGUMENT if multiple agent data sources are provided." @@ -54510,7 +58289,7 @@ false "type": "string" }, "env": { -"description": "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).", +"description": "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). At most 200 environment variables can be specified. Each variable (`NAME=value`) must be smaller than 128 KiB, and the total size of all variables must not exceed 512 KiB.", "items": { "$ref": "GoogleCloudAiplatformV1EnvVar" }, @@ -57105,6 +60884,10 @@ false "$ref": "GoogleCloudAiplatformV1OnlineEvaluatorCloudObservabilityNumericPredicate", "description": "Filter on the number of underlying LLM calls within a session." }, +"serviceVersion": { +"$ref": "GoogleCloudAiplatformV1OnlineEvaluatorCloudObservabilityStringPredicate", +"description": "Filter on the versions that served a session (`service.version` OTel resource attribute); matches if any of them is listed. At most one is allowed. On Vertex AI Agent Engine, this is the runtime revision id, currently set only for agents created via v1beta1." +}, "toolCallErrors": { "$ref": "GoogleCloudAiplatformV1OnlineEvaluatorCloudObservabilityNumericPredicate", "description": "Filter on the number of tool call errors within a session." @@ -57124,6 +60907,20 @@ false }, "type": "object" }, +"GoogleCloudAiplatformV1OnlineEvaluatorCloudObservabilityStringPredicate": { +"description": "Defines a predicate for filtering based on a string value.", +"id": "GoogleCloudAiplatformV1OnlineEvaluatorCloudObservabilityStringPredicate", +"properties": { +"values": { +"description": "Required. The values to match exactly (case-sensitive). Requires 1 to 20 values, each at most 128 characters long.", +"items": { +"type": "string" +}, +"type": "array" +} +}, +"type": "object" +}, "GoogleCloudAiplatformV1OnlineEvaluatorCloudObservabilityTraceScope": { "description": "If chosen, the online evaluator will evaluate single traces matching specified `filter`.", "id": "GoogleCloudAiplatformV1OnlineEvaluatorCloudObservabilityTraceScope", @@ -57146,6 +60943,10 @@ false "$ref": "GoogleCloudAiplatformV1OnlineEvaluatorCloudObservabilityNumericPredicate", "description": "Filter on the duration of a trace (in seconds)." }, +"serviceVersion": { +"$ref": "GoogleCloudAiplatformV1OnlineEvaluatorCloudObservabilityStringPredicate", +"description": "Filter on the version that served a trace (`service.version` OTel resource attribute). At most one is allowed. On Vertex AI Agent Engine, this is the runtime revision id, currently set only for agents created via v1beta1." +}, "totalTokenUsage": { "$ref": "GoogleCloudAiplatformV1OnlineEvaluatorCloudObservabilityNumericPredicate", "description": "Filter on the total token usage within a trace." @@ -57572,7 +61373,7 @@ false "type": "object" }, "GoogleCloudAiplatformV1Part": { -"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`. For media types that are not text, `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.", +"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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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": "GoogleCloudAiplatformV1Part", "properties": { "audioTranscription": { @@ -65320,6 +69121,21 @@ false }, "type": "object" }, +"GoogleCloudAiplatformV1SchemaPromptSpecContentMetadata": { +"description": "Metadata the model returned alongside the content it generated.", +"id": "GoogleCloudAiplatformV1SchemaPromptSpecContentMetadata", +"properties": { +"citationMetadata": { +"$ref": "GoogleCloudAiplatformV1CitationMetadata", +"description": "Optional. Citations that apply to the content." +}, +"groundingMetadata": { +"$ref": "GoogleCloudAiplatformV1GroundingMetadata", +"description": "Optional. Sources used to ground the content." +} +}, +"type": "object" +}, "GoogleCloudAiplatformV1SchemaPromptSpecInteractionData": { "description": "Defines data for an interaction prompt.", "id": "GoogleCloudAiplatformV1SchemaPromptSpecInteractionData", @@ -65440,6 +69256,13 @@ false "$ref": "GoogleCloudAiplatformV1SchemaPromptSpecAppBuilderData", "description": "Data for app builder use case." }, +"contentMetadata": { +"description": "Optional. Metadata the model returned with each of `prompt_message.contents`, such as citations and grounding sources. This maps 1:1 to PromptMessage.contents; an entry is empty when its content has no metadata.", +"items": { +"$ref": "GoogleCloudAiplatformV1SchemaPromptSpecContentMetadata" +}, +"type": "array" +}, "context": { "$ref": "GoogleCloudAiplatformV1Content", "description": "Preamble: The context of the prompt." diff --git a/googleapiclient/discovery_cache/documents/aiplatform.v1beta1.json b/googleapiclient/discovery_cache/documents/aiplatform.v1beta1.json index 1f5f3a4a7d..5c40d9de52 100644 --- a/googleapiclient/discovery_cache/documents/aiplatform.v1beta1.json +++ b/googleapiclient/discovery_cache/documents/aiplatform.v1beta1.json @@ -51276,7 +51276,7 @@ } } }, -"revision": "20261007", +"revision": "20261012", "rootUrl": "https://aiplatform.googleapis.com/", "schemas": { "CloudAiLargeModelsVisionExperimentsResponse": { @@ -51636,6 +51636,10 @@ "\"8K UDiT, downsampled 2x in the decoder." ], "type": "string" +}, +"tileSmoothing": { +"description": "Smooths the seams between the tiles the model upscales separately.", +"type": "boolean" } }, "type": "object" @@ -52956,6 +52960,18 @@ "description": "Domain to allow outbound requests to. Supports wildcards (e.g. '*.googleapis.com'). Use '*' to allow all domains.", "type": "string" }, +"mode": { +"description": "Network egress mode. Set via the `\"allowlist\": \"disabled\"` short form; must be the only rule in the allowlist and cannot be combined with `domain`, `transform` or `credential`.", +"enum": [ +"NETWORK_MODE_UNSPECIFIED", +"DISABLED" +], +"enumDescriptions": [ +"Default value. Unused.", +"All network egress is blocked." +], +"type": "string" +}, "transform": { "additionalProperties": { "type": "string" @@ -52971,7 +52987,7 @@ "id": "GenaiVertexV1beta1EnvironmentConfigEnvironmentNetworkEgressAllowlist", "properties": { "allowlist": { -"description": "List of allowed domains and their configurations.", +"description": "List of allowed domains and their configurations. Set to `\"disabled\"` to block all network egress.", "items": { "$ref": "GenaiVertexV1beta1EnvironmentConfigEgressRule" }, @@ -53081,8 +53097,12 @@ "id": "GenaiVertexV1beta1FileCitation", "properties": { "customMetadata": { -"$ref": "GenaiVertexV1beta1Struct", -"description": "User provided metadata about the retrieved context." +"additionalProperties": { +"description": "Properties of the object.", +"type": "any" +}, +"description": "User provided metadata about the retrieved context.", +"type": "object" }, "documentUri": { "description": "The URI of the file.", @@ -53873,6 +53893,11 @@ "$ref": "GenaiVertexV1beta1Content", "description": "The content for the interaction." }, +"continuationToken": { +"description": "Opaque token to resume a long decode. Output: set when status is INCOMPLETE and decoding can be resumed. Input: pass the latest token back unchanged in CreateInteraction to continue decoding.", +"format": "byte", +"type": "string" +}, "created": { "description": "Required. Output only. The time at which the response was created in ISO 8601 format (YYYY-MM-DDThh:mm:ssZ).", "readOnly": true, @@ -54085,6 +54110,11 @@ false "GenaiVertexV1beta1InteractionStatusUpdate": { "id": "GenaiVertexV1beta1InteractionStatusUpdate", "properties": { +"continuationToken": { +"description": "An optional opaque continuation token used to resume decoding from the latest checkpoint after a disconnected stream.", +"format": "byte", +"type": "string" +}, "interactionId": { "type": "string" }, @@ -54123,6 +54153,10 @@ false "The interaction is queued, waiting for processing (e.g. waiting for off-peak capacity)." ], "type": "string" +}, +"usage": { +"$ref": "GenaiVertexV1beta1InteractionUsage", +"description": "Model usage statistics up to this checkpoint." } }, "type": "object" @@ -57186,6 +57220,11 @@ false "description": "Optional. The description of the agent.", "type": "string" }, +"effectiveIdentity": { +"description": "Output only. The resolved Agent Identity (SPIFFE principal) of the agent.", +"readOnly": true, +"type": "string" +}, "id": { "description": "Immutable. The user-specified ID for the agent. This ID becomes the final component of the agent resource name. If not provided, Vertex AI will generate a value for this ID. The ID can be up to 63 characters and must match the regular expression `[a-z]([a-z0-9-]{0,61}[a-z0-9])?`.", "type": "string" @@ -57246,6 +57285,10 @@ false "description": "Optional. User-provided display name of the AgentAnomalyDetectionScope.", "type": "string" }, +"encryptionSpec": { +"$ref": "GoogleCloudAiplatformV1beta1EncryptionSpec", +"description": "Optional. Immutable. Specifies the customer-managed encryption key spec for a Scope. If set, this Scope and all sub-resources will be secured by this key. The key is immutable after the Scope is created and must be a multi-region (`us` or `eu`) key in the same region as the Scope." +}, "logBuckets": { "description": "Required. Customer-owned Cloud Logging bucket resource names attached to this scope. Format: `projects/{project}/locations/{location}/buckets/{bucket}`.", "items": { @@ -60137,6 +60180,12 @@ false "description": "Output only. The content of the candidate.", "readOnly": true }, +"continuationToken": { +"description": "Output only. An optional opaque continuation token returned when `finish_reason` is `CONTINUATION`. Clients can pass this token in a subsequent `GenerateContentRequest` to continue generation.", +"format": "byte", +"readOnly": true, +"type": "string" +}, "finishMessage": { "description": "Output only. Describes the reason the model stopped generating tokens in more detail. This field is returned only when `finish_reason` is set.", "readOnly": true, @@ -60161,7 +60210,9 @@ false "IMAGE_RECITATION", "IMAGE_OTHER", "UNEXPECTED_TOOL_CALL", -"NO_IMAGE" +"NO_IMAGE", +"MALFORMED_RESPONSE", +"CONTINUATION" ], "enumDescriptions": [ "The finish reason is unspecified.", @@ -60180,7 +60231,9 @@ false "The generated image may be a recitation from a source.", "The image generation stopped for a reason not otherwise specified.", "The model generated a function call that is semantically invalid. This can happen, for example, if function calling is not enabled or the generated function is not in the function declaration.", -"The model was expected to generate an image, but didn't." +"The model was expected to generate an image, but didn't.", +"Finishes due to malformed response.", +"Token generation was stopped because the response reached the per-request token limit, but generation is not yet complete. The model response can be continued via a subsequent request using the returned `continuation_token`." ], "readOnly": true, "type": "string" @@ -70472,6 +70525,11 @@ false }, "type": "array" }, +"continuationToken": { +"description": "Optional. An opaque continuation token used to resume generation from a previous `GenerateContent` or `StreamGenerateContent` response that stopped with `finish_reason` set to `CONTINUATION`.", +"format": "byte", +"type": "string" +}, "generationConfig": { "$ref": "GoogleCloudAiplatformV1beta1GenerationConfig", "description": "Optional. Generation config." @@ -77169,7 +77227,7 @@ false "type": "string" }, "env": { -"description": "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).", +"description": "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). At most 200 environment variables can be specified. Each variable (`NAME=value`) must be smaller than 128 KiB, and the total size of all variables must not exceed 512 KiB.", "items": { "$ref": "GoogleCloudAiplatformV1beta1EnvVar" }, @@ -80596,6 +80654,10 @@ false "$ref": "GoogleCloudAiplatformV1beta1OnlineEvaluatorCloudObservabilityNumericPredicate", "description": "Filter on the number of underlying LLM calls within a session." }, +"serviceVersion": { +"$ref": "GoogleCloudAiplatformV1beta1OnlineEvaluatorCloudObservabilityStringPredicate", +"description": "Filter on the versions that served a session (`service.version` OTel resource attribute); matches if any of them is listed. At most one is allowed. On Vertex AI Agent Engine, this is the runtime revision id, currently set only for agents created via v1beta1." +}, "toolCallErrors": { "$ref": "GoogleCloudAiplatformV1beta1OnlineEvaluatorCloudObservabilityNumericPredicate", "description": "Filter on the number of tool call errors within a session." @@ -80615,6 +80677,20 @@ false }, "type": "object" }, +"GoogleCloudAiplatformV1beta1OnlineEvaluatorCloudObservabilityStringPredicate": { +"description": "Defines a predicate for filtering based on a string value.", +"id": "GoogleCloudAiplatformV1beta1OnlineEvaluatorCloudObservabilityStringPredicate", +"properties": { +"values": { +"description": "Required. The values to match exactly (case-sensitive). Requires 1 to 20 values, each at most 128 characters long.", +"items": { +"type": "string" +}, +"type": "array" +} +}, +"type": "object" +}, "GoogleCloudAiplatformV1beta1OnlineEvaluatorCloudObservabilityTraceScope": { "description": "If chosen, the online evaluator will evaluate single traces matching specified `filter`.", "id": "GoogleCloudAiplatformV1beta1OnlineEvaluatorCloudObservabilityTraceScope", @@ -80637,6 +80713,10 @@ false "$ref": "GoogleCloudAiplatformV1beta1OnlineEvaluatorCloudObservabilityNumericPredicate", "description": "Filter on the duration of a trace (in seconds)." }, +"serviceVersion": { +"$ref": "GoogleCloudAiplatformV1beta1OnlineEvaluatorCloudObservabilityStringPredicate", +"description": "Filter on the version that served a trace (`service.version` OTel resource attribute). At most one is allowed. On Vertex AI Agent Engine, this is the runtime revision id, currently set only for agents created via v1beta1." +}, "totalTokenUsage": { "$ref": "GoogleCloudAiplatformV1beta1OnlineEvaluatorCloudObservabilityNumericPredicate", "description": "Filter on the total token usage within a trace." @@ -81104,7 +81184,7 @@ false "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`. For media types that are not text, `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.", +"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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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", "properties": { "audioTranscription": { @@ -90715,6 +90795,21 @@ false }, "type": "object" }, +"GoogleCloudAiplatformV1beta1SchemaPromptSpecContentMetadata": { +"description": "Metadata the model returned alongside the content it generated.", +"id": "GoogleCloudAiplatformV1beta1SchemaPromptSpecContentMetadata", +"properties": { +"citationMetadata": { +"$ref": "GoogleCloudAiplatformV1beta1CitationMetadata", +"description": "Optional. Citations that apply to the content." +}, +"groundingMetadata": { +"$ref": "GoogleCloudAiplatformV1beta1GroundingMetadata", +"description": "Optional. Sources used to ground the content." +} +}, +"type": "object" +}, "GoogleCloudAiplatformV1beta1SchemaPromptSpecInteractionData": { "description": "Defines data for an interaction prompt.", "id": "GoogleCloudAiplatformV1beta1SchemaPromptSpecInteractionData", @@ -90835,6 +90930,13 @@ false "$ref": "GoogleCloudAiplatformV1beta1SchemaPromptSpecAppBuilderData", "description": "Data for app builder use case." }, +"contentMetadata": { +"description": "Optional. Metadata the model returned with each of `prompt_message.contents`, such as citations and grounding sources. This maps 1:1 to PromptMessage.contents; an entry is empty when its content has no metadata.", +"items": { +"$ref": "GoogleCloudAiplatformV1beta1SchemaPromptSpecContentMetadata" +}, +"type": "array" +}, "context": { "$ref": "GoogleCloudAiplatformV1beta1Content", "description": "Preamble: The context of the prompt." From 262d8f086bd3e6b2e5fdd5552b64ebb2e3c9702f Mon Sep 17 00:00:00 2001 From: Yoshi Automation Date: Tue, 20 Oct 2026 07:23:59 +0000 Subject: [PATCH 03/34] feat(backupdr): update the api #### backupdr:v1 The following keys were added: - schemas.Backup.properties.netappVolumeBackupProperties (Total Keys: 2) - schemas.BackupPlanAssociation.properties.netappVolumeBackupPlanAssociationProperties (Total Keys: 2) - schemas.DataSourceGcpResource.properties.netappVolumeDatasourceProperties (Total Keys: 2) - schemas.DataSourceGcpResourceInfo.properties.netappVolumeProperties (Total Keys: 2) - schemas.NetAppVolumeBackupPlanAssociationProperties (Total Keys: 5) - schemas.NetAppVolumeBackupProperties (Total Keys: 4) - schemas.NetAppVolumeDataSourceProperties (Total Keys: 7) - schemas.NetAppVolumeDataSourceReferenceProperties (Total Keys: 7) #### backupdr:v1beta The following keys were added: - schemas.Backup.properties.netappVolumeBackupProperties (Total Keys: 2) - schemas.BackupPlanAssociation.properties.netappVolumeBackupPlanAssociationProperties (Total Keys: 2) - schemas.DataSourceGcpResource.properties.netappVolumeDatasourceProperties (Total Keys: 2) - schemas.DataSourceGcpResourceInfo.properties.netappVolumeProperties (Total Keys: 2) - schemas.NetAppVolumeBackupPlanAssociationProperties (Total Keys: 5) - schemas.NetAppVolumeBackupProperties (Total Keys: 4) - schemas.NetAppVolumeDataSourceProperties (Total Keys: 7) - schemas.NetAppVolumeDataSourceReferenceProperties (Total Keys: 7) --- ...ects.locations.backupPlanAssociations.html | 15 ++++ ...ions.backupVaults.dataSources.backups.html | 12 +++ ...ts.locations.backupVaults.dataSources.html | 12 +++ ...ojects.locations.dataSourceReferences.html | 12 +++ ...ects.locations.backupPlanAssociations.html | 15 ++++ ...ions.backupVaults.dataSources.backups.html | 12 +++ ...ts.locations.backupVaults.dataSources.html | 12 +++ ...ojects.locations.dataSourceReferences.html | 12 +++ .../documents/backupdr.v1.json | 83 ++++++++++++++++++- .../documents/backupdr.v1beta.json | 83 ++++++++++++++++++- 10 files changed, 266 insertions(+), 2 deletions(-) diff --git a/docs/dyn/backupdr_v1.projects.locations.backupPlanAssociations.html b/docs/dyn/backupdr_v1.projects.locations.backupPlanAssociations.html index 36d0e69604..e103ab1322 100644 --- a/docs/dyn/backupdr_v1.projects.locations.backupPlanAssociations.html +++ b/docs/dyn/backupdr_v1.projects.locations.backupPlanAssociations.html @@ -135,6 +135,9 @@

Method Details

"instanceCreateTime": "A String", # Output only. The time when the instance was created. }, "name": "A String", # Output only. Identifier. The resource name of BackupPlanAssociation in below format Format : projects/{project}/locations/{location}/backupPlanAssociations/{backupPlanAssociationId} + "netappVolumeBackupPlanAssociationProperties": { # NetAppVolumeBackupPlanAssociationProperties represents NetApp Volume backup plan association properties in BackupPlanAssociation. . # Output only. NetApp volume backup plan association properties. + "sourceResourceCreateTime": "A String", # Output only. The creation timestamp of the source resource. + }, "resource": "A String", # Required. Immutable. Resource name of workload on which the backup plan is applied. The format can either be the resource name (e.g., "projects/my-project/zones/us-central1-a/instances/my-instance") or the full resource URI (e.g., "https://www.googleapis.com/compute/v1/projects/my-project/zones/us-central1-a/instances/my-instance"). "resourceType": "A String", # Required. Immutable. Resource type of workload on which backupplan is applied "rulesConfigInfo": [ # Output only. The config info related to backup rules. @@ -261,6 +264,9 @@

Method Details

"instanceCreateTime": "A String", # Output only. The time when the instance was created. }, "name": "A String", # Output only. Identifier. The resource name of BackupPlanAssociation in below format Format : projects/{project}/locations/{location}/backupPlanAssociations/{backupPlanAssociationId} + "netappVolumeBackupPlanAssociationProperties": { # NetAppVolumeBackupPlanAssociationProperties represents NetApp Volume backup plan association properties in BackupPlanAssociation. . # Output only. NetApp volume backup plan association properties. + "sourceResourceCreateTime": "A String", # Output only. The creation timestamp of the source resource. + }, "resource": "A String", # Required. Immutable. Resource name of workload on which the backup plan is applied. The format can either be the resource name (e.g., "projects/my-project/zones/us-central1-a/instances/my-instance") or the full resource URI (e.g., "https://www.googleapis.com/compute/v1/projects/my-project/zones/us-central1-a/instances/my-instance"). "resourceType": "A String", # Required. Immutable. Resource type of workload on which backupplan is applied "rulesConfigInfo": [ # Output only. The config info related to backup rules. @@ -331,6 +337,9 @@

Method Details

"instanceCreateTime": "A String", # Output only. The time when the instance was created. }, "name": "A String", # Output only. Identifier. The resource name of BackupPlanAssociation in below format Format : projects/{project}/locations/{location}/backupPlanAssociations/{backupPlanAssociationId} + "netappVolumeBackupPlanAssociationProperties": { # NetAppVolumeBackupPlanAssociationProperties represents NetApp Volume backup plan association properties in BackupPlanAssociation. . # Output only. NetApp volume backup plan association properties. + "sourceResourceCreateTime": "A String", # Output only. The creation timestamp of the source resource. + }, "resource": "A String", # Required. Immutable. Resource name of workload on which the backup plan is applied. The format can either be the resource name (e.g., "projects/my-project/zones/us-central1-a/instances/my-instance") or the full resource URI (e.g., "https://www.googleapis.com/compute/v1/projects/my-project/zones/us-central1-a/instances/my-instance"). "resourceType": "A String", # Required. Immutable. Resource type of workload on which backupplan is applied "rulesConfigInfo": [ # Output only. The config info related to backup rules. @@ -389,6 +398,9 @@

Method Details

"instanceCreateTime": "A String", # Output only. The time when the instance was created. }, "name": "A String", # Output only. Identifier. The resource name of BackupPlanAssociation in below format Format : projects/{project}/locations/{location}/backupPlanAssociations/{backupPlanAssociationId} + "netappVolumeBackupPlanAssociationProperties": { # NetAppVolumeBackupPlanAssociationProperties represents NetApp Volume backup plan association properties in BackupPlanAssociation. . # Output only. NetApp volume backup plan association properties. + "sourceResourceCreateTime": "A String", # Output only. The creation timestamp of the source resource. + }, "resource": "A String", # Required. Immutable. Resource name of workload on which the backup plan is applied. The format can either be the resource name (e.g., "projects/my-project/zones/us-central1-a/instances/my-instance") or the full resource URI (e.g., "https://www.googleapis.com/compute/v1/projects/my-project/zones/us-central1-a/instances/my-instance"). "resourceType": "A String", # Required. Immutable. Resource type of workload on which backupplan is applied "rulesConfigInfo": [ # Output only. The config info related to backup rules. @@ -457,6 +469,9 @@

Method Details

"instanceCreateTime": "A String", # Output only. The time when the instance was created. }, "name": "A String", # Output only. Identifier. The resource name of BackupPlanAssociation in below format Format : projects/{project}/locations/{location}/backupPlanAssociations/{backupPlanAssociationId} + "netappVolumeBackupPlanAssociationProperties": { # NetAppVolumeBackupPlanAssociationProperties represents NetApp Volume backup plan association properties in BackupPlanAssociation. . # Output only. NetApp volume backup plan association properties. + "sourceResourceCreateTime": "A String", # Output only. The creation timestamp of the source resource. + }, "resource": "A String", # Required. Immutable. Resource name of workload on which the backup plan is applied. The format can either be the resource name (e.g., "projects/my-project/zones/us-central1-a/instances/my-instance") or the full resource URI (e.g., "https://www.googleapis.com/compute/v1/projects/my-project/zones/us-central1-a/instances/my-instance"). "resourceType": "A String", # Required. Immutable. Resource type of workload on which backupplan is applied "rulesConfigInfo": [ # Output only. The config info related to backup rules. 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 044c397127..82af151340 100644 --- a/docs/dyn/backupdr_v1.projects.locations.backupVaults.dataSources.backups.html +++ b/docs/dyn/backupdr_v1.projects.locations.backupVaults.dataSources.backups.html @@ -413,6 +413,9 @@

Method Details

"a_key": "A String", }, "name": "A String", # Output only. Identifier. Name of the backup to create. It must have the format`"projects//locations//backupVaults//dataSources/{datasource}/backups/{backup}"`. `{backup}` cannot be changed after creation. It must be between 3-63 characters long and must be unique within the datasource. + "netappVolumeBackupProperties": { # NetAppVolumeBackupProperties represents NetApp Volume backup properties in Backup. . # Output only. NetApp Volume specific backup properties. + "sourceResource": "A String", # Output only. The source volume of the Backup. + }, "resourceSizeBytes": "A String", # Output only. source resource size in bytes at the time of the backup. "satisfiesPzi": True or False, # Optional. Output only. Reserved for future use. "satisfiesPzs": True or False, # Optional. Output only. Reserved for future use. @@ -717,6 +720,9 @@

Method Details

"a_key": "A String", }, "name": "A String", # Output only. Identifier. Name of the backup to create. It must have the format`"projects//locations//backupVaults//dataSources/{datasource}/backups/{backup}"`. `{backup}` cannot be changed after creation. It must be between 3-63 characters long and must be unique within the datasource. + "netappVolumeBackupProperties": { # NetAppVolumeBackupProperties represents NetApp Volume backup properties in Backup. . # Output only. NetApp Volume specific backup properties. + "sourceResource": "A String", # Output only. The source volume of the Backup. + }, "resourceSizeBytes": "A String", # Output only. source resource size in bytes at the time of the backup. "satisfiesPzi": True or False, # Optional. Output only. Reserved for future use. "satisfiesPzs": True or False, # Optional. Output only. Reserved for future use. @@ -1010,6 +1016,9 @@

Method Details

"a_key": "A String", }, "name": "A String", # Output only. Identifier. Name of the backup to create. It must have the format`"projects//locations//backupVaults//dataSources/{datasource}/backups/{backup}"`. `{backup}` cannot be changed after creation. It must be between 3-63 characters long and must be unique within the datasource. + "netappVolumeBackupProperties": { # NetAppVolumeBackupProperties represents NetApp Volume backup properties in Backup. . # Output only. NetApp Volume specific backup properties. + "sourceResource": "A String", # Output only. The source volume of the Backup. + }, "resourceSizeBytes": "A String", # Output only. source resource size in bytes at the time of the backup. "satisfiesPzi": True or False, # Optional. Output only. Reserved for future use. "satisfiesPzs": True or False, # Optional. Output only. Reserved for future use. @@ -1307,6 +1316,9 @@

Method Details

"a_key": "A String", }, "name": "A String", # Output only. Identifier. Name of the backup to create. It must have the format`"projects//locations//backupVaults//dataSources/{datasource}/backups/{backup}"`. `{backup}` cannot be changed after creation. It must be between 3-63 characters long and must be unique within the datasource. + "netappVolumeBackupProperties": { # NetAppVolumeBackupProperties represents NetApp Volume backup properties in Backup. . # Output only. NetApp Volume specific backup properties. + "sourceResource": "A String", # Output only. The source volume of the Backup. + }, "resourceSizeBytes": "A String", # Output only. source resource size in bytes at the time of the backup. "satisfiesPzi": True or False, # Optional. Output only. Reserved for future use. "satisfiesPzs": True or False, # Optional. Output only. Reserved for future use. diff --git a/docs/dyn/backupdr_v1.projects.locations.backupVaults.dataSources.html b/docs/dyn/backupdr_v1.projects.locations.backupVaults.dataSources.html index 6cd97d480f..1083811039 100644 --- a/docs/dyn/backupdr_v1.projects.locations.backupVaults.dataSources.html +++ b/docs/dyn/backupdr_v1.projects.locations.backupVaults.dataSources.html @@ -334,6 +334,10 @@

Method Details

}, "gcpResourcename": "A String", # Output only. Full resource pathname URL of the source Google Cloud resource. "location": "A String", # Location of the resource: //"global"/"unspecified". + "netappVolumeDatasourceProperties": { # NetAppVolumeDataSourceProperties represents NetApp Volume properties stored in DataSource. . # Output only. NetAppVolumeDataSourceProperties has a subset of NetApp Volume properties that are useful at the Datasource level. + "sourceResource": "A String", # Output only. The source volume represented by this DataSource. + "sourceResourceCreateTime": "A String", # Output only. The volume creation timestamp. + }, "type": "A String", # The type of the Google Cloud resource. Use the Unified Resource Type, eg. compute.googleapis.com/Instance. }, "etag": "A String", # Server specified ETag for the ManagementServer resource to prevent simultaneous updates from overwiting each other. @@ -479,6 +483,10 @@

Method Details

}, "gcpResourcename": "A String", # Output only. Full resource pathname URL of the source Google Cloud resource. "location": "A String", # Location of the resource: //"global"/"unspecified". + "netappVolumeDatasourceProperties": { # NetAppVolumeDataSourceProperties represents NetApp Volume properties stored in DataSource. . # Output only. NetAppVolumeDataSourceProperties has a subset of NetApp Volume properties that are useful at the Datasource level. + "sourceResource": "A String", # Output only. The source volume represented by this DataSource. + "sourceResourceCreateTime": "A String", # Output only. The volume creation timestamp. + }, "type": "A String", # The type of the Google Cloud resource. Use the Unified Resource Type, eg. compute.googleapis.com/Instance. }, "etag": "A String", # Server specified ETag for the ManagementServer resource to prevent simultaneous updates from overwiting each other. @@ -604,6 +612,10 @@

Method Details

}, "gcpResourcename": "A String", # Output only. Full resource pathname URL of the source Google Cloud resource. "location": "A String", # Location of the resource: //"global"/"unspecified". + "netappVolumeDatasourceProperties": { # NetAppVolumeDataSourceProperties represents NetApp Volume properties stored in DataSource. . # Output only. NetAppVolumeDataSourceProperties has a subset of NetApp Volume properties that are useful at the Datasource level. + "sourceResource": "A String", # Output only. The source volume represented by this DataSource. + "sourceResourceCreateTime": "A String", # Output only. The volume creation timestamp. + }, "type": "A String", # The type of the Google Cloud resource. Use the Unified Resource Type, eg. compute.googleapis.com/Instance. }, "etag": "A String", # Server specified ETag for the ManagementServer resource to prevent simultaneous updates from overwiting each other. diff --git a/docs/dyn/backupdr_v1.projects.locations.dataSourceReferences.html b/docs/dyn/backupdr_v1.projects.locations.dataSourceReferences.html index 091a548ff4..d5d62fa275 100644 --- a/docs/dyn/backupdr_v1.projects.locations.dataSourceReferences.html +++ b/docs/dyn/backupdr_v1.projects.locations.dataSourceReferences.html @@ -144,6 +144,10 @@

Method Details

}, "gcpResourcename": "A String", # Output only. The resource name of the Google Cloud resource. Ex: projects/{project}/zones/{zone}/instances/{instance} "location": "A String", # Output only. The location of the Google Cloud resource. Ex: //"global"/"unspecified" + "netappVolumeProperties": { # NetAppVolumeDataSourceReferenceProperties represents NetApp Volume properties stored in DataSourceReference. . # Output only. The NetApp Volume properties. + "sourceResource": "A String", # Output only. The source volume represented by this DataSourceReference. + "sourceResourceCreateTime": "A String", # Output only. The volume creation timestamp. + }, "type": "A String", # Output only. The type of the Google Cloud resource. Ex: compute.googleapis.com/Instance }, "name": "A String", # Identifier. The resource name of the DataSourceReference. Format: projects/{project}/locations/{location}/dataSourceReferences/{data_source_reference} @@ -207,6 +211,10 @@

Method Details

}, "gcpResourcename": "A String", # Output only. The resource name of the Google Cloud resource. Ex: projects/{project}/zones/{zone}/instances/{instance} "location": "A String", # Output only. The location of the Google Cloud resource. Ex: //"global"/"unspecified" + "netappVolumeProperties": { # NetAppVolumeDataSourceReferenceProperties represents NetApp Volume properties stored in DataSourceReference. . # Output only. The NetApp Volume properties. + "sourceResource": "A String", # Output only. The source volume represented by this DataSourceReference. + "sourceResourceCreateTime": "A String", # Output only. The volume creation timestamp. + }, "type": "A String", # Output only. The type of the Google Cloud resource. Ex: compute.googleapis.com/Instance }, "name": "A String", # Identifier. The resource name of the DataSourceReference. Format: projects/{project}/locations/{location}/dataSourceReferences/{data_source_reference} @@ -259,6 +267,10 @@

Method Details

}, "gcpResourcename": "A String", # Output only. The resource name of the Google Cloud resource. Ex: projects/{project}/zones/{zone}/instances/{instance} "location": "A String", # Output only. The location of the Google Cloud resource. Ex: //"global"/"unspecified" + "netappVolumeProperties": { # NetAppVolumeDataSourceReferenceProperties represents NetApp Volume properties stored in DataSourceReference. . # Output only. The NetApp Volume properties. + "sourceResource": "A String", # Output only. The source volume represented by this DataSourceReference. + "sourceResourceCreateTime": "A String", # Output only. The volume creation timestamp. + }, "type": "A String", # Output only. The type of the Google Cloud resource. Ex: compute.googleapis.com/Instance }, "name": "A String", # Identifier. The resource name of the DataSourceReference. Format: projects/{project}/locations/{location}/dataSourceReferences/{data_source_reference} diff --git a/docs/dyn/backupdr_v1beta.projects.locations.backupPlanAssociations.html b/docs/dyn/backupdr_v1beta.projects.locations.backupPlanAssociations.html index 1b7a915843..81d35e003e 100644 --- a/docs/dyn/backupdr_v1beta.projects.locations.backupPlanAssociations.html +++ b/docs/dyn/backupdr_v1beta.projects.locations.backupPlanAssociations.html @@ -136,6 +136,9 @@

Method Details

"instanceCreateTime": "A String", # Output only. The time when the instance was created. }, "name": "A String", # Output only. Identifier. The resource name of BackupPlanAssociation in below format Format : projects/{project}/locations/{location}/backupPlanAssociations/{backupPlanAssociationId} + "netappVolumeBackupPlanAssociationProperties": { # NetAppVolumeBackupPlanAssociationProperties represents NetApp Volume backup plan association properties in BackupPlanAssociation. . # Output only. NetApp volume backup plan association properties. + "sourceResourceCreateTime": "A String", # Output only. The creation timestamp of the source resource. + }, "resource": "A String", # Required. Immutable. Resource name of workload on which the backup plan is applied. The format can either be the resource name (e.g., "projects/my-project/zones/us-central1-a/instances/my-instance") or the full resource URI (e.g., "https://www.googleapis.com/compute/v1/projects/my-project/zones/us-central1-a/instances/my-instance"). "resourceType": "A String", # Required. Immutable. Resource type of workload on which backupplan is applied "rulesConfigInfo": [ # Output only. The config info related to backup rules. @@ -264,6 +267,9 @@

Method Details

"instanceCreateTime": "A String", # Output only. The time when the instance was created. }, "name": "A String", # Output only. Identifier. The resource name of BackupPlanAssociation in below format Format : projects/{project}/locations/{location}/backupPlanAssociations/{backupPlanAssociationId} + "netappVolumeBackupPlanAssociationProperties": { # NetAppVolumeBackupPlanAssociationProperties represents NetApp Volume backup plan association properties in BackupPlanAssociation. . # Output only. NetApp volume backup plan association properties. + "sourceResourceCreateTime": "A String", # Output only. The creation timestamp of the source resource. + }, "resource": "A String", # Required. Immutable. Resource name of workload on which the backup plan is applied. The format can either be the resource name (e.g., "projects/my-project/zones/us-central1-a/instances/my-instance") or the full resource URI (e.g., "https://www.googleapis.com/compute/v1/projects/my-project/zones/us-central1-a/instances/my-instance"). "resourceType": "A String", # Required. Immutable. Resource type of workload on which backupplan is applied "rulesConfigInfo": [ # Output only. The config info related to backup rules. @@ -335,6 +341,9 @@

Method Details

"instanceCreateTime": "A String", # Output only. The time when the instance was created. }, "name": "A String", # Output only. Identifier. The resource name of BackupPlanAssociation in below format Format : projects/{project}/locations/{location}/backupPlanAssociations/{backupPlanAssociationId} + "netappVolumeBackupPlanAssociationProperties": { # NetAppVolumeBackupPlanAssociationProperties represents NetApp Volume backup plan association properties in BackupPlanAssociation. . # Output only. NetApp volume backup plan association properties. + "sourceResourceCreateTime": "A String", # Output only. The creation timestamp of the source resource. + }, "resource": "A String", # Required. Immutable. Resource name of workload on which the backup plan is applied. The format can either be the resource name (e.g., "projects/my-project/zones/us-central1-a/instances/my-instance") or the full resource URI (e.g., "https://www.googleapis.com/compute/v1/projects/my-project/zones/us-central1-a/instances/my-instance"). "resourceType": "A String", # Required. Immutable. Resource type of workload on which backupplan is applied "rulesConfigInfo": [ # Output only. The config info related to backup rules. @@ -394,6 +403,9 @@

Method Details

"instanceCreateTime": "A String", # Output only. The time when the instance was created. }, "name": "A String", # Output only. Identifier. The resource name of BackupPlanAssociation in below format Format : projects/{project}/locations/{location}/backupPlanAssociations/{backupPlanAssociationId} + "netappVolumeBackupPlanAssociationProperties": { # NetAppVolumeBackupPlanAssociationProperties represents NetApp Volume backup plan association properties in BackupPlanAssociation. . # Output only. NetApp volume backup plan association properties. + "sourceResourceCreateTime": "A String", # Output only. The creation timestamp of the source resource. + }, "resource": "A String", # Required. Immutable. Resource name of workload on which the backup plan is applied. The format can either be the resource name (e.g., "projects/my-project/zones/us-central1-a/instances/my-instance") or the full resource URI (e.g., "https://www.googleapis.com/compute/v1/projects/my-project/zones/us-central1-a/instances/my-instance"). "resourceType": "A String", # Required. Immutable. Resource type of workload on which backupplan is applied "rulesConfigInfo": [ # Output only. The config info related to backup rules. @@ -463,6 +475,9 @@

Method Details

"instanceCreateTime": "A String", # Output only. The time when the instance was created. }, "name": "A String", # Output only. Identifier. The resource name of BackupPlanAssociation in below format Format : projects/{project}/locations/{location}/backupPlanAssociations/{backupPlanAssociationId} + "netappVolumeBackupPlanAssociationProperties": { # NetAppVolumeBackupPlanAssociationProperties represents NetApp Volume backup plan association properties in BackupPlanAssociation. . # Output only. NetApp volume backup plan association properties. + "sourceResourceCreateTime": "A String", # Output only. The creation timestamp of the source resource. + }, "resource": "A String", # Required. Immutable. Resource name of workload on which the backup plan is applied. The format can either be the resource name (e.g., "projects/my-project/zones/us-central1-a/instances/my-instance") or the full resource URI (e.g., "https://www.googleapis.com/compute/v1/projects/my-project/zones/us-central1-a/instances/my-instance"). "resourceType": "A String", # Required. Immutable. Resource type of workload on which backupplan is applied "rulesConfigInfo": [ # Output only. The config info related to backup rules. diff --git a/docs/dyn/backupdr_v1beta.projects.locations.backupVaults.dataSources.backups.html b/docs/dyn/backupdr_v1beta.projects.locations.backupVaults.dataSources.backups.html index 0377314ce6..ef0c569be6 100644 --- a/docs/dyn/backupdr_v1beta.projects.locations.backupVaults.dataSources.backups.html +++ b/docs/dyn/backupdr_v1beta.projects.locations.backupVaults.dataSources.backups.html @@ -407,6 +407,9 @@

Method Details

"a_key": "A String", }, "name": "A String", # Output only. Identifier. Name of the backup to create. It must have the format`"projects//locations//backupVaults//dataSources/{datasource}/backups/{backup}"`. `{backup}` cannot be changed after creation. It must be between 3-63 characters long and must be unique within the datasource. + "netappVolumeBackupProperties": { # NetAppVolumeBackupProperties represents NetApp Volume backup properties in Backup. . # Output only. NetApp Volume specific backup properties. + "sourceResource": "A String", # Output only. The source volume of the Backup. + }, "resourceSizeBytes": "A String", # Output only. source resource size in bytes at the time of the backup. "satisfiesPzi": True or False, # Optional. Output only. Reserved for future use. "satisfiesPzs": True or False, # Optional. Output only. Reserved for future use. @@ -705,6 +708,9 @@

Method Details

"a_key": "A String", }, "name": "A String", # Output only. Identifier. Name of the backup to create. It must have the format`"projects//locations//backupVaults//dataSources/{datasource}/backups/{backup}"`. `{backup}` cannot be changed after creation. It must be between 3-63 characters long and must be unique within the datasource. + "netappVolumeBackupProperties": { # NetAppVolumeBackupProperties represents NetApp Volume backup properties in Backup. . # Output only. NetApp Volume specific backup properties. + "sourceResource": "A String", # Output only. The source volume of the Backup. + }, "resourceSizeBytes": "A String", # Output only. source resource size in bytes at the time of the backup. "satisfiesPzi": True or False, # Optional. Output only. Reserved for future use. "satisfiesPzs": True or False, # Optional. Output only. Reserved for future use. @@ -992,6 +998,9 @@

Method Details

"a_key": "A String", }, "name": "A String", # Output only. Identifier. Name of the backup to create. It must have the format`"projects//locations//backupVaults//dataSources/{datasource}/backups/{backup}"`. `{backup}` cannot be changed after creation. It must be between 3-63 characters long and must be unique within the datasource. + "netappVolumeBackupProperties": { # NetAppVolumeBackupProperties represents NetApp Volume backup properties in Backup. . # Output only. NetApp Volume specific backup properties. + "sourceResource": "A String", # Output only. The source volume of the Backup. + }, "resourceSizeBytes": "A String", # Output only. source resource size in bytes at the time of the backup. "satisfiesPzi": True or False, # Optional. Output only. Reserved for future use. "satisfiesPzs": True or False, # Optional. Output only. Reserved for future use. @@ -1283,6 +1292,9 @@

Method Details

"a_key": "A String", }, "name": "A String", # Output only. Identifier. Name of the backup to create. It must have the format`"projects//locations//backupVaults//dataSources/{datasource}/backups/{backup}"`. `{backup}` cannot be changed after creation. It must be between 3-63 characters long and must be unique within the datasource. + "netappVolumeBackupProperties": { # NetAppVolumeBackupProperties represents NetApp Volume backup properties in Backup. . # Output only. NetApp Volume specific backup properties. + "sourceResource": "A String", # Output only. The source volume of the Backup. + }, "resourceSizeBytes": "A String", # Output only. source resource size in bytes at the time of the backup. "satisfiesPzi": True or False, # Optional. Output only. Reserved for future use. "satisfiesPzs": True or False, # Optional. Output only. Reserved for future use. diff --git a/docs/dyn/backupdr_v1beta.projects.locations.backupVaults.dataSources.html b/docs/dyn/backupdr_v1beta.projects.locations.backupVaults.dataSources.html index 94bbf4ed53..504be687a5 100644 --- a/docs/dyn/backupdr_v1beta.projects.locations.backupVaults.dataSources.html +++ b/docs/dyn/backupdr_v1beta.projects.locations.backupVaults.dataSources.html @@ -335,6 +335,10 @@

Method Details

}, "gcpResourcename": "A String", # Output only. Full resource pathname URL of the source Google Cloud resource. "location": "A String", # Location of the resource: //"global"/"unspecified". + "netappVolumeDatasourceProperties": { # NetAppVolumeDataSourceProperties represents NetApp Volume properties stored in DataSource. . # Output only. NetAppVolumeDataSourceProperties has a subset of NetApp Volume properties that are useful at the Datasource level. + "sourceResource": "A String", # Output only. The source volume represented by this DataSource. + "sourceResourceCreateTime": "A String", # Output only. The volume creation timestamp. + }, "type": "A String", # The type of the Google Cloud resource. Use the Unified Resource Type, eg. compute.googleapis.com/Instance. }, "etag": "A String", # Server specified ETag for the ManagementServer resource to prevent simultaneous updates from overwiting each other. @@ -481,6 +485,10 @@

Method Details

}, "gcpResourcename": "A String", # Output only. Full resource pathname URL of the source Google Cloud resource. "location": "A String", # Location of the resource: //"global"/"unspecified". + "netappVolumeDatasourceProperties": { # NetAppVolumeDataSourceProperties represents NetApp Volume properties stored in DataSource. . # Output only. NetAppVolumeDataSourceProperties has a subset of NetApp Volume properties that are useful at the Datasource level. + "sourceResource": "A String", # Output only. The source volume represented by this DataSource. + "sourceResourceCreateTime": "A String", # Output only. The volume creation timestamp. + }, "type": "A String", # The type of the Google Cloud resource. Use the Unified Resource Type, eg. compute.googleapis.com/Instance. }, "etag": "A String", # Server specified ETag for the ManagementServer resource to prevent simultaneous updates from overwiting each other. @@ -607,6 +615,10 @@

Method Details

}, "gcpResourcename": "A String", # Output only. Full resource pathname URL of the source Google Cloud resource. "location": "A String", # Location of the resource: //"global"/"unspecified". + "netappVolumeDatasourceProperties": { # NetAppVolumeDataSourceProperties represents NetApp Volume properties stored in DataSource. . # Output only. NetAppVolumeDataSourceProperties has a subset of NetApp Volume properties that are useful at the Datasource level. + "sourceResource": "A String", # Output only. The source volume represented by this DataSource. + "sourceResourceCreateTime": "A String", # Output only. The volume creation timestamp. + }, "type": "A String", # The type of the Google Cloud resource. Use the Unified Resource Type, eg. compute.googleapis.com/Instance. }, "etag": "A String", # Server specified ETag for the ManagementServer resource to prevent simultaneous updates from overwiting each other. diff --git a/docs/dyn/backupdr_v1beta.projects.locations.dataSourceReferences.html b/docs/dyn/backupdr_v1beta.projects.locations.dataSourceReferences.html index 38fa559cb3..c14d43b4c6 100644 --- a/docs/dyn/backupdr_v1beta.projects.locations.dataSourceReferences.html +++ b/docs/dyn/backupdr_v1beta.projects.locations.dataSourceReferences.html @@ -144,6 +144,10 @@

Method Details

}, "gcpResourcename": "A String", # Output only. The resource name of the Google Cloud resource. Ex: projects/{project}/zones/{zone}/instances/{instance} "location": "A String", # Output only. The location of the Google Cloud resource. Ex: //"global"/"unspecified" + "netappVolumeProperties": { # NetAppVolumeDataSourceReferenceProperties represents NetApp Volume properties stored in DataSourceReference. . # Output only. The properties of the NetApp volume. + "sourceResource": "A String", # Output only. The source volume represented by this DataSourceReference. + "sourceResourceCreateTime": "A String", # Output only. The volume creation timestamp. + }, "type": "A String", # Output only. The type of the Google Cloud resource. Ex: compute.googleapis.com/Instance }, "name": "A String", # Identifier. The resource name of the DataSourceReference. Format: projects/{project}/locations/{location}/dataSourceReferences/{data_source_reference} @@ -207,6 +211,10 @@

Method Details

}, "gcpResourcename": "A String", # Output only. The resource name of the Google Cloud resource. Ex: projects/{project}/zones/{zone}/instances/{instance} "location": "A String", # Output only. The location of the Google Cloud resource. Ex: //"global"/"unspecified" + "netappVolumeProperties": { # NetAppVolumeDataSourceReferenceProperties represents NetApp Volume properties stored in DataSourceReference. . # Output only. The properties of the NetApp volume. + "sourceResource": "A String", # Output only. The source volume represented by this DataSourceReference. + "sourceResourceCreateTime": "A String", # Output only. The volume creation timestamp. + }, "type": "A String", # Output only. The type of the Google Cloud resource. Ex: compute.googleapis.com/Instance }, "name": "A String", # Identifier. The resource name of the DataSourceReference. Format: projects/{project}/locations/{location}/dataSourceReferences/{data_source_reference} @@ -259,6 +267,10 @@

Method Details

}, "gcpResourcename": "A String", # Output only. The resource name of the Google Cloud resource. Ex: projects/{project}/zones/{zone}/instances/{instance} "location": "A String", # Output only. The location of the Google Cloud resource. Ex: //"global"/"unspecified" + "netappVolumeProperties": { # NetAppVolumeDataSourceReferenceProperties represents NetApp Volume properties stored in DataSourceReference. . # Output only. The properties of the NetApp volume. + "sourceResource": "A String", # Output only. The source volume represented by this DataSourceReference. + "sourceResourceCreateTime": "A String", # Output only. The volume creation timestamp. + }, "type": "A String", # Output only. The type of the Google Cloud resource. Ex: compute.googleapis.com/Instance }, "name": "A String", # Identifier. The resource name of the DataSourceReference. Format: projects/{project}/locations/{location}/dataSourceReferences/{data_source_reference} diff --git a/googleapiclient/discovery_cache/documents/backupdr.v1.json b/googleapiclient/discovery_cache/documents/backupdr.v1.json index b6b5ef866f..94c639bb03 100644 --- a/googleapiclient/discovery_cache/documents/backupdr.v1.json +++ b/googleapiclient/discovery_cache/documents/backupdr.v1.json @@ -2725,7 +2725,7 @@ } } }, -"revision": "20261002", +"revision": "20261006", "rootUrl": "https://backupdr.googleapis.com/", "schemas": { "AbandonBackupRequest": { @@ -3312,6 +3312,11 @@ "readOnly": true, "type": "string" }, +"netappVolumeBackupProperties": { +"$ref": "NetAppVolumeBackupProperties", +"description": "Output only. NetApp Volume specific backup properties.", +"readOnly": true +}, "resourceSizeBytes": { "description": "Output only. source resource size in bytes at the time of the backup.", "format": "int64", @@ -3882,6 +3887,11 @@ "readOnly": true, "type": "string" }, +"netappVolumeBackupPlanAssociationProperties": { +"$ref": "NetAppVolumeBackupPlanAssociationProperties", +"description": "Output only. NetApp volume backup plan association properties.", +"readOnly": true +}, "resource": { "description": "Required. Immutable. Resource name of workload on which the backup plan is applied. The format can either be the resource name (e.g., \"projects/my-project/zones/us-central1-a/instances/my-instance\") or the full resource URI (e.g., \"https://www.googleapis.com/compute/v1/projects/my-project/zones/us-central1-a/instances/my-instance\").", "type": "string" @@ -4869,6 +4879,11 @@ "description": "Location of the resource: //\"global\"/\"unspecified\".", "type": "string" }, +"netappVolumeDatasourceProperties": { +"$ref": "NetAppVolumeDataSourceProperties", +"description": "Output only. NetAppVolumeDataSourceProperties has a subset of NetApp Volume properties that are useful at the Datasource level.", +"readOnly": true +}, "type": { "description": "The type of the Google Cloud resource. Use the Unified Resource Type, eg. compute.googleapis.com/Instance.", "type": "string" @@ -4905,6 +4920,11 @@ "readOnly": true, "type": "string" }, +"netappVolumeProperties": { +"$ref": "NetAppVolumeDataSourceReferenceProperties", +"description": "Output only. The NetApp Volume properties.", +"readOnly": true +}, "type": { "description": "Output only. The type of the Google Cloud resource. Ex: compute.googleapis.com/Instance", "readOnly": true, @@ -6384,6 +6404,67 @@ }, "type": "object" }, +"NetAppVolumeBackupPlanAssociationProperties": { +"description": "NetAppVolumeBackupPlanAssociationProperties represents NetApp Volume backup plan association properties in BackupPlanAssociation. .", +"id": "NetAppVolumeBackupPlanAssociationProperties", +"properties": { +"sourceResourceCreateTime": { +"description": "Output only. The creation timestamp of the source resource.", +"format": "google-datetime", +"readOnly": true, +"type": "string" +} +}, +"type": "object" +}, +"NetAppVolumeBackupProperties": { +"description": "NetAppVolumeBackupProperties represents NetApp Volume backup properties in Backup. .", +"id": "NetAppVolumeBackupProperties", +"properties": { +"sourceResource": { +"description": "Output only. The source volume of the Backup.", +"readOnly": true, +"type": "string" +} +}, +"type": "object" +}, +"NetAppVolumeDataSourceProperties": { +"description": "NetAppVolumeDataSourceProperties represents NetApp Volume properties stored in DataSource. .", +"id": "NetAppVolumeDataSourceProperties", +"properties": { +"sourceResource": { +"description": "Output only. The source volume represented by this DataSource.", +"readOnly": true, +"type": "string" +}, +"sourceResourceCreateTime": { +"description": "Output only. The volume creation timestamp.", +"format": "google-datetime", +"readOnly": true, +"type": "string" +} +}, +"type": "object" +}, +"NetAppVolumeDataSourceReferenceProperties": { +"description": "NetAppVolumeDataSourceReferenceProperties represents NetApp Volume properties stored in DataSourceReference. .", +"id": "NetAppVolumeDataSourceReferenceProperties", +"properties": { +"sourceResource": { +"description": "Output only. The source volume represented by this DataSourceReference.", +"readOnly": true, +"type": "string" +}, +"sourceResourceCreateTime": { +"description": "Output only. The volume creation timestamp.", +"format": "google-datetime", +"readOnly": true, +"type": "string" +} +}, +"type": "object" +}, "NetworkConfig": { "description": "Network configuration for ManagementServer instance.", "id": "NetworkConfig", diff --git a/googleapiclient/discovery_cache/documents/backupdr.v1beta.json b/googleapiclient/discovery_cache/documents/backupdr.v1beta.json index 24fca2d3b6..b57b67eda1 100644 --- a/googleapiclient/discovery_cache/documents/backupdr.v1beta.json +++ b/googleapiclient/discovery_cache/documents/backupdr.v1beta.json @@ -3179,7 +3179,7 @@ } } }, -"revision": "20261002", +"revision": "20261006", "rootUrl": "https://backupdr.googleapis.com/", "schemas": { "AbandonBackupRequest": { @@ -3998,6 +3998,11 @@ "readOnly": true, "type": "string" }, +"netappVolumeBackupProperties": { +"$ref": "NetAppVolumeBackupProperties", +"description": "Output only. NetApp Volume specific backup properties.", +"readOnly": true +}, "resourceSizeBytes": { "description": "Output only. source resource size in bytes at the time of the backup.", "format": "int64", @@ -4573,6 +4578,11 @@ "readOnly": true, "type": "string" }, +"netappVolumeBackupPlanAssociationProperties": { +"$ref": "NetAppVolumeBackupPlanAssociationProperties", +"description": "Output only. NetApp volume backup plan association properties.", +"readOnly": true +}, "resource": { "description": "Required. Immutable. Resource name of workload on which the backup plan is applied. The format can either be the resource name (e.g., \"projects/my-project/zones/us-central1-a/instances/my-instance\") or the full resource URI (e.g., \"https://www.googleapis.com/compute/v1/projects/my-project/zones/us-central1-a/instances/my-instance\").", "type": "string" @@ -5631,6 +5641,11 @@ "description": "Location of the resource: //\"global\"/\"unspecified\".", "type": "string" }, +"netappVolumeDatasourceProperties": { +"$ref": "NetAppVolumeDataSourceProperties", +"description": "Output only. NetAppVolumeDataSourceProperties has a subset of NetApp Volume properties that are useful at the Datasource level.", +"readOnly": true +}, "type": { "description": "The type of the Google Cloud resource. Use the Unified Resource Type, eg. compute.googleapis.com/Instance.", "type": "string" @@ -5667,6 +5682,11 @@ "readOnly": true, "type": "string" }, +"netappVolumeProperties": { +"$ref": "NetAppVolumeDataSourceReferenceProperties", +"description": "Output only. The properties of the NetApp volume.", +"readOnly": true +}, "type": { "description": "Output only. The type of the Google Cloud resource. Ex: compute.googleapis.com/Instance", "readOnly": true, @@ -7231,6 +7251,67 @@ }, "type": "object" }, +"NetAppVolumeBackupPlanAssociationProperties": { +"description": "NetAppVolumeBackupPlanAssociationProperties represents NetApp Volume backup plan association properties in BackupPlanAssociation. .", +"id": "NetAppVolumeBackupPlanAssociationProperties", +"properties": { +"sourceResourceCreateTime": { +"description": "Output only. The creation timestamp of the source resource.", +"format": "google-datetime", +"readOnly": true, +"type": "string" +} +}, +"type": "object" +}, +"NetAppVolumeBackupProperties": { +"description": "NetAppVolumeBackupProperties represents NetApp Volume backup properties in Backup. .", +"id": "NetAppVolumeBackupProperties", +"properties": { +"sourceResource": { +"description": "Output only. The source volume of the Backup.", +"readOnly": true, +"type": "string" +} +}, +"type": "object" +}, +"NetAppVolumeDataSourceProperties": { +"description": "NetAppVolumeDataSourceProperties represents NetApp Volume properties stored in DataSource. .", +"id": "NetAppVolumeDataSourceProperties", +"properties": { +"sourceResource": { +"description": "Output only. The source volume represented by this DataSource.", +"readOnly": true, +"type": "string" +}, +"sourceResourceCreateTime": { +"description": "Output only. The volume creation timestamp.", +"format": "google-datetime", +"readOnly": true, +"type": "string" +} +}, +"type": "object" +}, +"NetAppVolumeDataSourceReferenceProperties": { +"description": "NetAppVolumeDataSourceReferenceProperties represents NetApp Volume properties stored in DataSourceReference. .", +"id": "NetAppVolumeDataSourceReferenceProperties", +"properties": { +"sourceResource": { +"description": "Output only. The source volume represented by this DataSourceReference.", +"readOnly": true, +"type": "string" +}, +"sourceResourceCreateTime": { +"description": "Output only. The volume creation timestamp.", +"format": "google-datetime", +"readOnly": true, +"type": "string" +} +}, +"type": "object" +}, "NetworkConfig": { "description": "Network configuration for ManagementServer instance.", "id": "NetworkConfig", From 174f185c8a8edbb031541ceebfee65ca00416a6e Mon Sep 17 00:00:00 2001 From: Yoshi Automation Date: Tue, 20 Oct 2026 07:23:59 +0000 Subject: [PATCH 04/34] feat(beyondcorp): update the api #### beyondcorp:v1 The following keys were added: - resources.projects.resources.locations.resources.appConnections.methods.create.deprecated (Total Keys: 1) - resources.projects.resources.locations.resources.appConnections.methods.delete.deprecated (Total Keys: 1) - resources.projects.resources.locations.resources.appConnections.methods.get.deprecated (Total Keys: 1) - resources.projects.resources.locations.resources.appConnections.methods.list.deprecated (Total Keys: 1) - resources.projects.resources.locations.resources.appConnections.methods.patch.deprecated (Total Keys: 1) - resources.projects.resources.locations.resources.appConnections.methods.resolve.deprecated (Total Keys: 1) - resources.projects.resources.locations.resources.appConnectors.methods.create.deprecated (Total Keys: 1) - resources.projects.resources.locations.resources.appConnectors.methods.delete.deprecated (Total Keys: 1) - resources.projects.resources.locations.resources.appConnectors.methods.get.deprecated (Total Keys: 1) - resources.projects.resources.locations.resources.appConnectors.methods.list.deprecated (Total Keys: 1) - resources.projects.resources.locations.resources.appConnectors.methods.patch.deprecated (Total Keys: 1) - resources.projects.resources.locations.resources.appConnectors.methods.reportStatus.deprecated (Total Keys: 1) - resources.projects.resources.locations.resources.appConnectors.methods.resolveInstanceConfig.deprecated (Total Keys: 1) - resources.projects.resources.locations.resources.appGateways.methods.create.deprecated (Total Keys: 1) - resources.projects.resources.locations.resources.appGateways.methods.delete.deprecated (Total Keys: 1) - resources.projects.resources.locations.resources.appGateways.methods.get.deprecated (Total Keys: 1) - resources.projects.resources.locations.resources.appGateways.methods.list.deprecated (Total Keys: 1) #### beyondcorp:v1alpha The following keys were added: - resources.projects.resources.locations.resources.appConnections.methods.create.deprecated (Total Keys: 1) - resources.projects.resources.locations.resources.appConnections.methods.delete.deprecated (Total Keys: 1) - resources.projects.resources.locations.resources.appConnections.methods.get.deprecated (Total Keys: 1) - resources.projects.resources.locations.resources.appConnections.methods.list.deprecated (Total Keys: 1) - resources.projects.resources.locations.resources.appConnections.methods.patch.deprecated (Total Keys: 1) - resources.projects.resources.locations.resources.appConnections.methods.resolve.deprecated (Total Keys: 1) - resources.projects.resources.locations.resources.appConnectors.methods.create.deprecated (Total Keys: 1) - resources.projects.resources.locations.resources.appConnectors.methods.delete.deprecated (Total Keys: 1) - resources.projects.resources.locations.resources.appConnectors.methods.get.deprecated (Total Keys: 1) - resources.projects.resources.locations.resources.appConnectors.methods.list.deprecated (Total Keys: 1) - resources.projects.resources.locations.resources.appConnectors.methods.patch.deprecated (Total Keys: 1) - resources.projects.resources.locations.resources.appConnectors.methods.reportStatus.deprecated (Total Keys: 1) - resources.projects.resources.locations.resources.appConnectors.methods.resolveInstanceConfig.deprecated (Total Keys: 1) - resources.projects.resources.locations.resources.appGateways.methods.create.deprecated (Total Keys: 1) - resources.projects.resources.locations.resources.appGateways.methods.delete.deprecated (Total Keys: 1) - resources.projects.resources.locations.resources.appGateways.methods.get.deprecated (Total Keys: 1) - resources.projects.resources.locations.resources.appGateways.methods.list.deprecated (Total Keys: 1) --- .../documents/beyondcorp.v1.json | 19 ++++++++++++++++++- .../documents/beyondcorp.v1alpha.json | 19 ++++++++++++++++++- 2 files changed, 36 insertions(+), 2 deletions(-) diff --git a/googleapiclient/discovery_cache/documents/beyondcorp.v1.json b/googleapiclient/discovery_cache/documents/beyondcorp.v1.json index 605fab5b75..6575bfffc2 100644 --- a/googleapiclient/discovery_cache/documents/beyondcorp.v1.json +++ b/googleapiclient/discovery_cache/documents/beyondcorp.v1.json @@ -322,6 +322,7 @@ "appConnections": { "methods": { "create": { +"deprecated": true, "description": "Creates a new AppConnection in a given project and location.", "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/appConnections", "httpMethod": "POST", @@ -365,6 +366,7 @@ ] }, "delete": { +"deprecated": true, "description": "Deletes a single AppConnection.", "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/appConnections/{appConnectionsId}", "httpMethod": "DELETE", @@ -400,6 +402,7 @@ ] }, "get": { +"deprecated": true, "description": "Gets details of a single AppConnection.", "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/appConnections/{appConnectionsId}", "httpMethod": "GET", @@ -456,6 +459,7 @@ ] }, "list": { +"deprecated": true, "description": "Lists AppConnections in a given project and location.", "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/appConnections", "httpMethod": "GET", @@ -502,6 +506,7 @@ ] }, "patch": { +"deprecated": true, "description": "Updates the parameters of a single AppConnection.", "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/appConnections/{appConnectionsId}", "httpMethod": "PATCH", @@ -551,6 +556,7 @@ ] }, "resolve": { +"deprecated": true, "description": "Resolves AppConnections details for a given AppConnector. An internal method called by a connector to find AppConnections to connect to.", "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/appConnections:resolve", "httpMethod": "GET", @@ -652,6 +658,7 @@ "appConnectors": { "methods": { "create": { +"deprecated": true, "description": "Creates a new AppConnector in a given project and location.", "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/appConnectors", "httpMethod": "POST", @@ -695,6 +702,7 @@ ] }, "delete": { +"deprecated": true, "description": "Deletes a single AppConnector.", "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/appConnectors/{appConnectorsId}", "httpMethod": "DELETE", @@ -730,6 +738,7 @@ ] }, "get": { +"deprecated": true, "description": "Gets details of a single AppConnector.", "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/appConnectors/{appConnectorsId}", "httpMethod": "GET", @@ -786,6 +795,7 @@ ] }, "list": { +"deprecated": true, "description": "Lists AppConnectors in a given project and location.", "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/appConnectors", "httpMethod": "GET", @@ -832,6 +842,7 @@ ] }, "patch": { +"deprecated": true, "description": "Updates the parameters of a single AppConnector.", "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/appConnectors/{appConnectorsId}", "httpMethod": "PATCH", @@ -876,6 +887,7 @@ ] }, "reportStatus": { +"deprecated": true, "description": "Report status for a given connector.", "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/appConnectors/{appConnectorsId}:reportStatus", "httpMethod": "POST", @@ -904,6 +916,7 @@ ] }, "resolveInstanceConfig": { +"deprecated": true, "description": "Gets instance configuration for a given AppConnector. An internal method called by a AppConnector to get its container config.", "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/appConnectors/{appConnectorsId}:resolveInstanceConfig", "httpMethod": "GET", @@ -989,6 +1002,7 @@ "appGateways": { "methods": { "create": { +"deprecated": true, "description": "Creates a new AppGateway in a given project and location.", "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/appGateways", "httpMethod": "POST", @@ -1032,6 +1046,7 @@ ] }, "delete": { +"deprecated": true, "description": "Deletes a single AppGateway.", "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/appGateways/{appGatewaysId}", "httpMethod": "DELETE", @@ -1067,6 +1082,7 @@ ] }, "get": { +"deprecated": true, "description": "Gets details of a single AppGateway.", "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/appGateways/{appGatewaysId}", "httpMethod": "GET", @@ -1123,6 +1139,7 @@ ] }, "list": { +"deprecated": true, "description": "Lists AppGateways in a given project and location.", "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/appGateways", "httpMethod": "GET", @@ -1909,7 +1926,7 @@ } } }, -"revision": "20260722", +"revision": "20261007", "rootUrl": "https://beyondcorp.googleapis.com/", "schemas": { "AllocatedConnection": { diff --git a/googleapiclient/discovery_cache/documents/beyondcorp.v1alpha.json b/googleapiclient/discovery_cache/documents/beyondcorp.v1alpha.json index 6b26585988..f5a4140b44 100644 --- a/googleapiclient/discovery_cache/documents/beyondcorp.v1alpha.json +++ b/googleapiclient/discovery_cache/documents/beyondcorp.v1alpha.json @@ -724,6 +724,7 @@ "appConnections": { "methods": { "create": { +"deprecated": true, "description": "Creates a new AppConnection in a given project and location.", "flatPath": "v1alpha/projects/{projectsId}/locations/{locationsId}/appConnections", "httpMethod": "POST", @@ -767,6 +768,7 @@ ] }, "delete": { +"deprecated": true, "description": "Deletes a single AppConnection.", "flatPath": "v1alpha/projects/{projectsId}/locations/{locationsId}/appConnections/{appConnectionsId}", "httpMethod": "DELETE", @@ -802,6 +804,7 @@ ] }, "get": { +"deprecated": true, "description": "Gets details of a single AppConnection.", "flatPath": "v1alpha/projects/{projectsId}/locations/{locationsId}/appConnections/{appConnectionsId}", "httpMethod": "GET", @@ -858,6 +861,7 @@ ] }, "list": { +"deprecated": true, "description": "Lists AppConnections in a given project and location.", "flatPath": "v1alpha/projects/{projectsId}/locations/{locationsId}/appConnections", "httpMethod": "GET", @@ -904,6 +908,7 @@ ] }, "patch": { +"deprecated": true, "description": "Updates the parameters of a single AppConnection.", "flatPath": "v1alpha/projects/{projectsId}/locations/{locationsId}/appConnections/{appConnectionsId}", "httpMethod": "PATCH", @@ -953,6 +958,7 @@ ] }, "resolve": { +"deprecated": true, "description": "Resolves AppConnections details for a given AppConnector. An internal method called by a connector to find AppConnections to connect to.", "flatPath": "v1alpha/projects/{projectsId}/locations/{locationsId}/appConnections:resolve", "httpMethod": "GET", @@ -1054,6 +1060,7 @@ "appConnectors": { "methods": { "create": { +"deprecated": true, "description": "Creates a new AppConnector in a given project and location.", "flatPath": "v1alpha/projects/{projectsId}/locations/{locationsId}/appConnectors", "httpMethod": "POST", @@ -1097,6 +1104,7 @@ ] }, "delete": { +"deprecated": true, "description": "Deletes a single AppConnector.", "flatPath": "v1alpha/projects/{projectsId}/locations/{locationsId}/appConnectors/{appConnectorsId}", "httpMethod": "DELETE", @@ -1132,6 +1140,7 @@ ] }, "get": { +"deprecated": true, "description": "Gets details of a single AppConnector.", "flatPath": "v1alpha/projects/{projectsId}/locations/{locationsId}/appConnectors/{appConnectorsId}", "httpMethod": "GET", @@ -1188,6 +1197,7 @@ ] }, "list": { +"deprecated": true, "description": "Lists AppConnectors in a given project and location.", "flatPath": "v1alpha/projects/{projectsId}/locations/{locationsId}/appConnectors", "httpMethod": "GET", @@ -1234,6 +1244,7 @@ ] }, "patch": { +"deprecated": true, "description": "Updates the parameters of a single AppConnector.", "flatPath": "v1alpha/projects/{projectsId}/locations/{locationsId}/appConnectors/{appConnectorsId}", "httpMethod": "PATCH", @@ -1278,6 +1289,7 @@ ] }, "reportStatus": { +"deprecated": true, "description": "Report status for a given connector.", "flatPath": "v1alpha/projects/{projectsId}/locations/{locationsId}/appConnectors/{appConnectorsId}:reportStatus", "httpMethod": "POST", @@ -1306,6 +1318,7 @@ ] }, "resolveInstanceConfig": { +"deprecated": true, "description": "Gets instance configuration for a given AppConnector. An internal method called by a AppConnector to get its container config.", "flatPath": "v1alpha/projects/{projectsId}/locations/{locationsId}/appConnectors/{appConnectorsId}:resolveInstanceConfig", "httpMethod": "GET", @@ -1391,6 +1404,7 @@ "appGateways": { "methods": { "create": { +"deprecated": true, "description": "Creates a new AppGateway in a given project and location.", "flatPath": "v1alpha/projects/{projectsId}/locations/{locationsId}/appGateways", "httpMethod": "POST", @@ -1434,6 +1448,7 @@ ] }, "delete": { +"deprecated": true, "description": "Deletes a single AppGateway.", "flatPath": "v1alpha/projects/{projectsId}/locations/{locationsId}/appGateways/{appGatewaysId}", "httpMethod": "DELETE", @@ -1469,6 +1484,7 @@ ] }, "get": { +"deprecated": true, "description": "Gets details of a single AppGateway.", "flatPath": "v1alpha/projects/{projectsId}/locations/{locationsId}/appGateways/{appGatewaysId}", "httpMethod": "GET", @@ -1525,6 +1541,7 @@ ] }, "list": { +"deprecated": true, "description": "Lists AppGateways in a given project and location.", "flatPath": "v1alpha/projects/{projectsId}/locations/{locationsId}/appGateways", "httpMethod": "GET", @@ -3332,7 +3349,7 @@ } } }, -"revision": "20260722", +"revision": "20261007", "rootUrl": "https://beyondcorp.googleapis.com/", "schemas": { "AllocatedConnection": { From 3408876193be9bc4c7d121982397646d1756b608 Mon Sep 17 00:00:00 2001 From: Yoshi Automation Date: Tue, 20 Oct 2026 07:23:59 +0000 Subject: [PATCH 05/34] feat(bigtableadmin): update the api #### bigtableadmin:v2 The following keys were added: - schemas.AutomatedBackupPolicy.properties.disabled.type (Total Keys: 1) - schemas.AutomatedBackupPolicy.properties.keepHotDuration (Total Keys: 2) - schemas.RestoreTableRequest.properties.table.$ref (Total Keys: 1) - schemas.RestoreTableRequest.properties.updateMask (Total Keys: 2) - schemas.Table.properties.effectiveAutomatedBackupPolicy (Total Keys: 2) --- ...bleadmin_v2.projects.instances.tables.html | 290 ++++++++++++++++++ .../documents/bigtableadmin.v2.json | 25 +- 2 files changed, 314 insertions(+), 1 deletion(-) diff --git a/docs/dyn/bigtableadmin_v2.projects.instances.tables.html b/docs/dyn/bigtableadmin_v2.projects.instances.tables.html index 3b3aac9d6f..fe8e20c198 100644 --- a/docs/dyn/bigtableadmin_v2.projects.instances.tables.html +++ b/docs/dyn/bigtableadmin_v2.projects.instances.tables.html @@ -185,7 +185,9 @@

Method Details

], "table": { # A collection of user data indexed by row, column, and timestamp. Each table is served using the resources of its parent cluster. # Required. The Table to create. "automatedBackupPolicy": { # Defines an automated backup policy for a table # If specified, automated backups are enabled for this table. Otherwise, automated backups are disabled. + "disabled": True or False, # Optional. If `true`, automated backups are explicitly disabled on this table. This allows users to opt out of default enablement. "frequency": "A String", # How frequently automated backups should occur. The only supported value at this time is 24 hours. An undefined frequency is treated as 24 hours. + "keepHotDuration": "A String", # Optional. The amount of time that the automated backups remain hot. If specified, the backups created by this policy are `HOT` backups. If not specified, the backups are `STANDARD` backups. The value must be at least 24 hours and at most 10 days, and can't exceed the policy's `retention_period`. Only SSD instances support `HOT` automated backups. "locations": [ # Optional. A list of Cloud Bigtable zones where automated backups are allowed to be created. If empty, automated backups will be created in all zones of the instance. Locations are in the format `projects/{project}/locations/{zone}`. You can set this field only for tables in Enterprise Plus instances. "A String", ], @@ -354,6 +356,15 @@

Method Details

}, }, "deletionProtection": True or False, # Set to true to make the table protected against data loss. i.e. deleting the following resources through Admin APIs are prohibited: * The table. * The column families in the table. * The instance containing the table. Note one can still delete the data stored in the table through Data APIs. + "effectiveAutomatedBackupPolicy": { # Defines an automated backup policy for a table # Output only. The effective automated backup policy applied to the table. This represents the policy actually in effect, which may be a system-default policy if the user has not explicitly configured one. Views: `SCHEMA_VIEW`, `FULL`. + "disabled": True or False, # Optional. If `true`, automated backups are explicitly disabled on this table. This allows users to opt out of default enablement. + "frequency": "A String", # How frequently automated backups should occur. The only supported value at this time is 24 hours. An undefined frequency is treated as 24 hours. + "keepHotDuration": "A String", # Optional. The amount of time that the automated backups remain hot. If specified, the backups created by this policy are `HOT` backups. If not specified, the backups are `STANDARD` backups. The value must be at least 24 hours and at most 10 days, and can't exceed the policy's `retention_period`. Only SSD instances support `HOT` automated backups. + "locations": [ # Optional. A list of Cloud Bigtable zones where automated backups are allowed to be created. If empty, automated backups will be created in all zones of the instance. Locations are in the format `projects/{project}/locations/{zone}`. You can set this field only for tables in Enterprise Plus instances. + "A String", + ], + "retentionPeriod": "A String", # Required. How long the automated backups should be retained. Values must be at least 3 days and at most 90 days. + }, "granularity": "A String", # Immutable. The granularity at which timestamps are stored in this table. Timestamps not matching the granularity will be rejected. If unspecified at creation time, the value will be set to `MILLIS`. Views: `SCHEMA_VIEW`, `FULL`. "name": "A String", # The unique name of the table. Values are of the form `projects/{project}/instances/{instance}/tables/_a-zA-Z0-9*`. Views: `NAME_ONLY`, `SCHEMA_VIEW`, `REPLICATION_VIEW`, `STATS_VIEW`, `FULL` "restoreInfo": { # Information about a table restore. # Output only. If this table was restored from another data source (e.g. a backup), this field will be populated with information about the restore. @@ -408,7 +419,9 @@

Method Details

{ # A collection of user data indexed by row, column, and timestamp. Each table is served using the resources of its parent cluster. "automatedBackupPolicy": { # Defines an automated backup policy for a table # If specified, automated backups are enabled for this table. Otherwise, automated backups are disabled. + "disabled": True or False, # Optional. If `true`, automated backups are explicitly disabled on this table. This allows users to opt out of default enablement. "frequency": "A String", # How frequently automated backups should occur. The only supported value at this time is 24 hours. An undefined frequency is treated as 24 hours. + "keepHotDuration": "A String", # Optional. The amount of time that the automated backups remain hot. If specified, the backups created by this policy are `HOT` backups. If not specified, the backups are `STANDARD` backups. The value must be at least 24 hours and at most 10 days, and can't exceed the policy's `retention_period`. Only SSD instances support `HOT` automated backups. "locations": [ # Optional. A list of Cloud Bigtable zones where automated backups are allowed to be created. If empty, automated backups will be created in all zones of the instance. Locations are in the format `projects/{project}/locations/{zone}`. You can set this field only for tables in Enterprise Plus instances. "A String", ], @@ -577,6 +590,15 @@

Method Details

}, }, "deletionProtection": True or False, # Set to true to make the table protected against data loss. i.e. deleting the following resources through Admin APIs are prohibited: * The table. * The column families in the table. * The instance containing the table. Note one can still delete the data stored in the table through Data APIs. + "effectiveAutomatedBackupPolicy": { # Defines an automated backup policy for a table # Output only. The effective automated backup policy applied to the table. This represents the policy actually in effect, which may be a system-default policy if the user has not explicitly configured one. Views: `SCHEMA_VIEW`, `FULL`. + "disabled": True or False, # Optional. If `true`, automated backups are explicitly disabled on this table. This allows users to opt out of default enablement. + "frequency": "A String", # How frequently automated backups should occur. The only supported value at this time is 24 hours. An undefined frequency is treated as 24 hours. + "keepHotDuration": "A String", # Optional. The amount of time that the automated backups remain hot. If specified, the backups created by this policy are `HOT` backups. If not specified, the backups are `STANDARD` backups. The value must be at least 24 hours and at most 10 days, and can't exceed the policy's `retention_period`. Only SSD instances support `HOT` automated backups. + "locations": [ # Optional. A list of Cloud Bigtable zones where automated backups are allowed to be created. If empty, automated backups will be created in all zones of the instance. Locations are in the format `projects/{project}/locations/{zone}`. You can set this field only for tables in Enterprise Plus instances. + "A String", + ], + "retentionPeriod": "A String", # Required. How long the automated backups should be retained. Values must be at least 3 days and at most 90 days. + }, "granularity": "A String", # Immutable. The granularity at which timestamps are stored in this table. Timestamps not matching the granularity will be rejected. If unspecified at creation time, the value will be set to `MILLIS`. Views: `SCHEMA_VIEW`, `FULL`. "name": "A String", # The unique name of the table. Values are of the form `projects/{project}/instances/{instance}/tables/_a-zA-Z0-9*`. Views: `NAME_ONLY`, `SCHEMA_VIEW`, `REPLICATION_VIEW`, `STATS_VIEW`, `FULL` "restoreInfo": { # Information about a table restore. # Output only. If this table was restored from another data source (e.g. a backup), this field will be populated with information about the restore. @@ -714,7 +736,9 @@

Method Details

{ # A collection of user data indexed by row, column, and timestamp. Each table is served using the resources of its parent cluster. "automatedBackupPolicy": { # Defines an automated backup policy for a table # If specified, automated backups are enabled for this table. Otherwise, automated backups are disabled. + "disabled": True or False, # Optional. If `true`, automated backups are explicitly disabled on this table. This allows users to opt out of default enablement. "frequency": "A String", # How frequently automated backups should occur. The only supported value at this time is 24 hours. An undefined frequency is treated as 24 hours. + "keepHotDuration": "A String", # Optional. The amount of time that the automated backups remain hot. If specified, the backups created by this policy are `HOT` backups. If not specified, the backups are `STANDARD` backups. The value must be at least 24 hours and at most 10 days, and can't exceed the policy's `retention_period`. Only SSD instances support `HOT` automated backups. "locations": [ # Optional. A list of Cloud Bigtable zones where automated backups are allowed to be created. If empty, automated backups will be created in all zones of the instance. Locations are in the format `projects/{project}/locations/{zone}`. You can set this field only for tables in Enterprise Plus instances. "A String", ], @@ -883,6 +907,15 @@

Method Details

}, }, "deletionProtection": True or False, # Set to true to make the table protected against data loss. i.e. deleting the following resources through Admin APIs are prohibited: * The table. * The column families in the table. * The instance containing the table. Note one can still delete the data stored in the table through Data APIs. + "effectiveAutomatedBackupPolicy": { # Defines an automated backup policy for a table # Output only. The effective automated backup policy applied to the table. This represents the policy actually in effect, which may be a system-default policy if the user has not explicitly configured one. Views: `SCHEMA_VIEW`, `FULL`. + "disabled": True or False, # Optional. If `true`, automated backups are explicitly disabled on this table. This allows users to opt out of default enablement. + "frequency": "A String", # How frequently automated backups should occur. The only supported value at this time is 24 hours. An undefined frequency is treated as 24 hours. + "keepHotDuration": "A String", # Optional. The amount of time that the automated backups remain hot. If specified, the backups created by this policy are `HOT` backups. If not specified, the backups are `STANDARD` backups. The value must be at least 24 hours and at most 10 days, and can't exceed the policy's `retention_period`. Only SSD instances support `HOT` automated backups. + "locations": [ # Optional. A list of Cloud Bigtable zones where automated backups are allowed to be created. If empty, automated backups will be created in all zones of the instance. Locations are in the format `projects/{project}/locations/{zone}`. You can set this field only for tables in Enterprise Plus instances. + "A String", + ], + "retentionPeriod": "A String", # Required. How long the automated backups should be retained. Values must be at least 3 days and at most 90 days. + }, "granularity": "A String", # Immutable. The granularity at which timestamps are stored in this table. Timestamps not matching the granularity will be rejected. If unspecified at creation time, the value will be set to `MILLIS`. Views: `SCHEMA_VIEW`, `FULL`. "name": "A String", # The unique name of the table. Values are of the form `projects/{project}/instances/{instance}/tables/_a-zA-Z0-9*`. Views: `NAME_ONLY`, `SCHEMA_VIEW`, `REPLICATION_VIEW`, `STATS_VIEW`, `FULL` "restoreInfo": { # Information about a table restore. # Output only. If this table was restored from another data source (e.g. a backup), this field will be populated with information about the restore. @@ -1012,7 +1045,9 @@

Method Details

"tables": [ # The tables present in the requested instance. { # A collection of user data indexed by row, column, and timestamp. Each table is served using the resources of its parent cluster. "automatedBackupPolicy": { # Defines an automated backup policy for a table # If specified, automated backups are enabled for this table. Otherwise, automated backups are disabled. + "disabled": True or False, # Optional. If `true`, automated backups are explicitly disabled on this table. This allows users to opt out of default enablement. "frequency": "A String", # How frequently automated backups should occur. The only supported value at this time is 24 hours. An undefined frequency is treated as 24 hours. + "keepHotDuration": "A String", # Optional. The amount of time that the automated backups remain hot. If specified, the backups created by this policy are `HOT` backups. If not specified, the backups are `STANDARD` backups. The value must be at least 24 hours and at most 10 days, and can't exceed the policy's `retention_period`. Only SSD instances support `HOT` automated backups. "locations": [ # Optional. A list of Cloud Bigtable zones where automated backups are allowed to be created. If empty, automated backups will be created in all zones of the instance. Locations are in the format `projects/{project}/locations/{zone}`. You can set this field only for tables in Enterprise Plus instances. "A String", ], @@ -1181,6 +1216,15 @@

Method Details

}, }, "deletionProtection": True or False, # Set to true to make the table protected against data loss. i.e. deleting the following resources through Admin APIs are prohibited: * The table. * The column families in the table. * The instance containing the table. Note one can still delete the data stored in the table through Data APIs. + "effectiveAutomatedBackupPolicy": { # Defines an automated backup policy for a table # Output only. The effective automated backup policy applied to the table. This represents the policy actually in effect, which may be a system-default policy if the user has not explicitly configured one. Views: `SCHEMA_VIEW`, `FULL`. + "disabled": True or False, # Optional. If `true`, automated backups are explicitly disabled on this table. This allows users to opt out of default enablement. + "frequency": "A String", # How frequently automated backups should occur. The only supported value at this time is 24 hours. An undefined frequency is treated as 24 hours. + "keepHotDuration": "A String", # Optional. The amount of time that the automated backups remain hot. If specified, the backups created by this policy are `HOT` backups. If not specified, the backups are `STANDARD` backups. The value must be at least 24 hours and at most 10 days, and can't exceed the policy's `retention_period`. Only SSD instances support `HOT` automated backups. + "locations": [ # Optional. A list of Cloud Bigtable zones where automated backups are allowed to be created. If empty, automated backups will be created in all zones of the instance. Locations are in the format `projects/{project}/locations/{zone}`. You can set this field only for tables in Enterprise Plus instances. + "A String", + ], + "retentionPeriod": "A String", # Required. How long the automated backups should be retained. Values must be at least 3 days and at most 90 days. + }, "granularity": "A String", # Immutable. The granularity at which timestamps are stored in this table. Timestamps not matching the granularity will be rejected. If unspecified at creation time, the value will be set to `MILLIS`. Views: `SCHEMA_VIEW`, `FULL`. "name": "A String", # The unique name of the table. Values are of the form `projects/{project}/instances/{instance}/tables/_a-zA-Z0-9*`. Views: `NAME_ONLY`, `SCHEMA_VIEW`, `REPLICATION_VIEW`, `STATS_VIEW`, `FULL` "restoreInfo": { # Information about a table restore. # Output only. If this table was restored from another data source (e.g. a backup), this field will be populated with information about the restore. @@ -1544,7 +1588,9 @@

Method Details

{ # A collection of user data indexed by row, column, and timestamp. Each table is served using the resources of its parent cluster. "automatedBackupPolicy": { # Defines an automated backup policy for a table # If specified, automated backups are enabled for this table. Otherwise, automated backups are disabled. + "disabled": True or False, # Optional. If `true`, automated backups are explicitly disabled on this table. This allows users to opt out of default enablement. "frequency": "A String", # How frequently automated backups should occur. The only supported value at this time is 24 hours. An undefined frequency is treated as 24 hours. + "keepHotDuration": "A String", # Optional. The amount of time that the automated backups remain hot. If specified, the backups created by this policy are `HOT` backups. If not specified, the backups are `STANDARD` backups. The value must be at least 24 hours and at most 10 days, and can't exceed the policy's `retention_period`. Only SSD instances support `HOT` automated backups. "locations": [ # Optional. A list of Cloud Bigtable zones where automated backups are allowed to be created. If empty, automated backups will be created in all zones of the instance. Locations are in the format `projects/{project}/locations/{zone}`. You can set this field only for tables in Enterprise Plus instances. "A String", ], @@ -1713,6 +1759,15 @@

Method Details

}, }, "deletionProtection": True or False, # Set to true to make the table protected against data loss. i.e. deleting the following resources through Admin APIs are prohibited: * The table. * The column families in the table. * The instance containing the table. Note one can still delete the data stored in the table through Data APIs. + "effectiveAutomatedBackupPolicy": { # Defines an automated backup policy for a table # Output only. The effective automated backup policy applied to the table. This represents the policy actually in effect, which may be a system-default policy if the user has not explicitly configured one. Views: `SCHEMA_VIEW`, `FULL`. + "disabled": True or False, # Optional. If `true`, automated backups are explicitly disabled on this table. This allows users to opt out of default enablement. + "frequency": "A String", # How frequently automated backups should occur. The only supported value at this time is 24 hours. An undefined frequency is treated as 24 hours. + "keepHotDuration": "A String", # Optional. The amount of time that the automated backups remain hot. If specified, the backups created by this policy are `HOT` backups. If not specified, the backups are `STANDARD` backups. The value must be at least 24 hours and at most 10 days, and can't exceed the policy's `retention_period`. Only SSD instances support `HOT` automated backups. + "locations": [ # Optional. A list of Cloud Bigtable zones where automated backups are allowed to be created. If empty, automated backups will be created in all zones of the instance. Locations are in the format `projects/{project}/locations/{zone}`. You can set this field only for tables in Enterprise Plus instances. + "A String", + ], + "retentionPeriod": "A String", # Required. How long the automated backups should be retained. Values must be at least 3 days and at most 90 days. + }, "granularity": "A String", # Immutable. The granularity at which timestamps are stored in this table. Timestamps not matching the granularity will be rejected. If unspecified at creation time, the value will be set to `MILLIS`. Views: `SCHEMA_VIEW`, `FULL`. "name": "A String", # The unique name of the table. Values are of the form `projects/{project}/instances/{instance}/tables/_a-zA-Z0-9*`. Views: `NAME_ONLY`, `SCHEMA_VIEW`, `REPLICATION_VIEW`, `STATS_VIEW`, `FULL` "restoreInfo": { # Information about a table restore. # Output only. If this table was restored from another data source (e.g. a backup), this field will be populated with information about the restore. @@ -1767,7 +1822,9 @@

Method Details

{ # A collection of user data indexed by row, column, and timestamp. Each table is served using the resources of its parent cluster. "automatedBackupPolicy": { # Defines an automated backup policy for a table # If specified, automated backups are enabled for this table. Otherwise, automated backups are disabled. + "disabled": True or False, # Optional. If `true`, automated backups are explicitly disabled on this table. This allows users to opt out of default enablement. "frequency": "A String", # How frequently automated backups should occur. The only supported value at this time is 24 hours. An undefined frequency is treated as 24 hours. + "keepHotDuration": "A String", # Optional. The amount of time that the automated backups remain hot. If specified, the backups created by this policy are `HOT` backups. If not specified, the backups are `STANDARD` backups. The value must be at least 24 hours and at most 10 days, and can't exceed the policy's `retention_period`. Only SSD instances support `HOT` automated backups. "locations": [ # Optional. A list of Cloud Bigtable zones where automated backups are allowed to be created. If empty, automated backups will be created in all zones of the instance. Locations are in the format `projects/{project}/locations/{zone}`. You can set this field only for tables in Enterprise Plus instances. "A String", ], @@ -1936,6 +1993,15 @@

Method Details

}, }, "deletionProtection": True or False, # Set to true to make the table protected against data loss. i.e. deleting the following resources through Admin APIs are prohibited: * The table. * The column families in the table. * The instance containing the table. Note one can still delete the data stored in the table through Data APIs. + "effectiveAutomatedBackupPolicy": { # Defines an automated backup policy for a table # Output only. The effective automated backup policy applied to the table. This represents the policy actually in effect, which may be a system-default policy if the user has not explicitly configured one. Views: `SCHEMA_VIEW`, `FULL`. + "disabled": True or False, # Optional. If `true`, automated backups are explicitly disabled on this table. This allows users to opt out of default enablement. + "frequency": "A String", # How frequently automated backups should occur. The only supported value at this time is 24 hours. An undefined frequency is treated as 24 hours. + "keepHotDuration": "A String", # Optional. The amount of time that the automated backups remain hot. If specified, the backups created by this policy are `HOT` backups. If not specified, the backups are `STANDARD` backups. The value must be at least 24 hours and at most 10 days, and can't exceed the policy's `retention_period`. Only SSD instances support `HOT` automated backups. + "locations": [ # Optional. A list of Cloud Bigtable zones where automated backups are allowed to be created. If empty, automated backups will be created in all zones of the instance. Locations are in the format `projects/{project}/locations/{zone}`. You can set this field only for tables in Enterprise Plus instances. + "A String", + ], + "retentionPeriod": "A String", # Required. How long the automated backups should be retained. Values must be at least 3 days and at most 90 days. + }, "granularity": "A String", # Immutable. The granularity at which timestamps are stored in this table. Timestamps not matching the granularity will be rejected. If unspecified at creation time, the value will be set to `MILLIS`. Views: `SCHEMA_VIEW`, `FULL`. "name": "A String", # The unique name of the table. Values are of the form `projects/{project}/instances/{instance}/tables/_a-zA-Z0-9*`. Views: `NAME_ONLY`, `SCHEMA_VIEW`, `REPLICATION_VIEW`, `STATS_VIEW`, `FULL` "restoreInfo": { # Information about a table restore. # Output only. If this table was restored from another data source (e.g. a backup), this field will be populated with information about the restore. @@ -2020,7 +2086,231 @@

Method Details

{ # The request for RestoreTable. "backup": "A String", # Name of the backup from which to restore. Values are of the form `projects//instances//clusters//backups/`. + "table": { # A collection of user data indexed by row, column, and timestamp. Each table is served using the resources of its parent cluster. # Optional. Properties of the table to be restored. Only the fields specified in update_mask will be used to set the restored table's properties. + "automatedBackupPolicy": { # Defines an automated backup policy for a table # If specified, automated backups are enabled for this table. Otherwise, automated backups are disabled. + "disabled": True or False, # Optional. If `true`, automated backups are explicitly disabled on this table. This allows users to opt out of default enablement. + "frequency": "A String", # How frequently automated backups should occur. The only supported value at this time is 24 hours. An undefined frequency is treated as 24 hours. + "keepHotDuration": "A String", # Optional. The amount of time that the automated backups remain hot. If specified, the backups created by this policy are `HOT` backups. If not specified, the backups are `STANDARD` backups. The value must be at least 24 hours and at most 10 days, and can't exceed the policy's `retention_period`. Only SSD instances support `HOT` automated backups. + "locations": [ # Optional. A list of Cloud Bigtable zones where automated backups are allowed to be created. If empty, automated backups will be created in all zones of the instance. Locations are in the format `projects/{project}/locations/{zone}`. You can set this field only for tables in Enterprise Plus instances. + "A String", + ], + "retentionPeriod": "A String", # Required. How long the automated backups should be retained. Values must be at least 3 days and at most 90 days. + }, + "changeStreamConfig": { # Change stream configuration. # If specified, enable the change stream on this table. Otherwise, the change stream is disabled and the change stream is not retained. + "retentionPeriod": "A String", # How long the change stream should be retained. Change stream data older than the retention period will not be returned when reading the change stream from the table. Values must be at least 1 day and at most 7 days, and will be truncated to microsecond granularity. + }, + "clusterStates": { # Output only. Map from cluster ID to per-cluster table state. If it could not be determined whether or not the table has data in a particular cluster (for example, if its zone is unavailable), then there will be an entry for the cluster with UNKNOWN `replication_status`. Views: `REPLICATION_VIEW`, `ENCRYPTION_VIEW`, `FULL` + "a_key": { # The state of a table's data in a particular cluster. + "encryptionInfo": [ # Output only. The encryption information for the table in this cluster. If the encryption key protecting this resource is customer managed, then its version can be rotated in Cloud Key Management Service (Cloud KMS). The primary version of the key and its status will be reflected here when changes propagate from Cloud KMS. + { # Encryption information for a given resource. If this resource is protected with customer managed encryption, the in-use Cloud Key Management Service (Cloud KMS) key version is specified along with its status. + "encryptionStatus": { # The `Status` type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by [gRPC](https://github.com/grpc). Each `Status` message contains three pieces of data: error code, error message, and error details. You can find out more about this error model and how to work with it in the [API Design Guide](https://cloud.google.com/apis/design/errors). # Output only. The status of encrypt/decrypt calls on underlying data for this resource. Regardless of status, the existing data is always encrypted at rest. + "code": 42, # The status code, which should be an enum value of google.rpc.Code. + "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. + }, + "encryptionType": "A String", # Output only. The type of encryption used to protect this resource. + "kmsKeyVersion": "A String", # Output only. The version of the Cloud KMS key specified in the parent cluster that is in use for the data underlying this table. + }, + ], + "replicationState": "A String", # Output only. The state of replication for the table in this cluster. + }, + }, + "columnFamilies": { # The column families configured for this table, mapped by column family ID. Views: `SCHEMA_VIEW`, `STATS_VIEW`, `FULL` + "a_key": { # A set of columns within a table which share a common configuration. + "gcRule": { # Rule for determining which cells to delete during garbage collection. # Garbage collection rule specified as a protobuf. Must serialize to at most 500 bytes. NOTE: Garbage collection executes opportunistically in the background, and so it's possible for reads to return a cell even if it matches the active GC expression for its family. + "intersection": { # A GcRule which deletes cells matching all of the given rules. # Delete cells that would be deleted by every nested rule. + "rules": [ # Only delete cells which would be deleted by every element of `rules`. + # Object with schema name: GcRule + ], + }, + "maxAge": "A String", # Delete cells in a column older than the given age. Values must be at least one millisecond, and will be truncated to microsecond granularity. + "maxNumVersions": 42, # Delete all cells in a column except the most recent N. + "union": { # A GcRule which deletes cells matching any of the given rules. # Delete cells that would be deleted by any nested rule. + "rules": [ # Delete cells which would be deleted by any element of `rules`. + # Object with schema name: GcRule + ], + }, + }, + "stats": { # Approximate statistics related to a single column family within a table. This information may change rapidly, interpreting these values at a point in time may already preset out-of-date information. Everything below is approximate, unless otherwise specified. # Output only. Only available with STATS_VIEW, this includes summary statistics about column family contents. For statistics over an entire table, see TableStats above. + "averageCellsPerColumn": 3.14, # How many cells are present per column qualifier in this column family, averaged over all rows containing any column in the column family. e.g. For column family "family" in a table with 3 rows: * A row with 3 cells in "family:col" and 1 cell in "other:col" (3 cells / 1 column in "family") * A row with 1 cell in "family:col", 7 cells in "family:other_col", and 7 cells in "other:data" (8 cells / 2 columns in "family") * A row with 3 cells in "other:col" (0 columns in "family", "family" not present) would report (3 + 8 + 0)/(1 + 2 + 0) = 3.66 in this field. + "averageColumnsPerRow": 3.14, # How many column qualifiers are present in this column family, averaged over all rows in the table. e.g. For column family "family" in a table with 3 rows: * A row with cells in "family:col" and "other:col" (1 column in "family") * A row with cells in "family:col", "family:other_col", and "other:data" (2 columns in "family") * A row with cells in "other:col" (0 columns in "family", "family" not present) would report (1 + 2 + 0)/3 = 1.5 in this field. + "logicalDataBytes": "A String", # How much space the data in the column family occupies. This is roughly how many bytes would be needed to read the contents of the entire column family (e.g. by streaming all contents out). + "logicalDataHddBytes": "A String", # Output only. The logical data bytes of the column family stored on HDD. + "logicalDataSsdBytes": "A String", # Output only. The logical data bytes of the column family stored on SSD. + }, + "valueType": { # `Type` represents the type of data that is written to, read from, or stored in Bigtable. It is heavily based on the GoogleSQL standard to help maintain familiarity and consistency across products and features. For compatibility with Bigtable's existing untyped APIs, each `Type` includes an `Encoding` which describes how to convert to or from the underlying data. Each encoding can operate in one of two modes: - Sorted: In this mode, Bigtable guarantees that `Encode(X) <= Encode(Y)` if and only if `X <= Y`. This is useful anywhere sort order is important, for example when encoding keys. - Distinct: In this mode, Bigtable guarantees that if `X != Y` then `Encode(X) != Encode(Y)`. However, the converse is not guaranteed. For example, both `{'foo': '1', 'bar': '2'}` and `{'bar': '2', 'foo': '1'}` are valid encodings of the same JSON value. The API clearly documents which mode is used wherever an encoding can be configured. Each encoding also documents which values are supported in which modes. For example, when encoding INT64 as a numeric STRING, negative numbers cannot be encoded in sorted mode. This is because `INT64(1) > INT64(-1)`, but `STRING("-00001") > STRING("00001")`. # The type of data stored in each of this family's cell values, including its full encoding. If omitted, the family only serves raw untyped bytes. For now, only the `Aggregate` type is supported. `Aggregate` can only be set at family creation and is immutable afterwards. This field is mutually exclusive with `sql_type`. If `value_type` is `Aggregate`, written data must be compatible with: * `value_type.input_type` for `AddInput` mutations + "aggregateType": { # A value that combines incremental updates into a summarized value. Data is never directly written or read using type `Aggregate`. Writes provide either the `input_type` or `state_type`, and reads always return the `state_type` . # Aggregate + "hllppUniqueCount": { # Computes an approximate unique count over the input values. When using raw data as input, be careful to use a consistent encoding. Otherwise the same value encoded differently could count more than once, or two distinct values could count as identical. Input: Any, or omit for Raw State: TBD Special state conversions: `Int64` (the unique count estimate) # HyperLogLogPlusPlusUniqueCount aggregator. + }, + "inputType": # Object with schema name: Type # Type of the inputs that are accumulated by this `Aggregate`. Use `AddInput` mutations to accumulate new inputs. + "max": { # Computes the max of the input values. Allowed input: `Int64` State: same as input # Max aggregator. + }, + "min": { # Computes the min of the input values. Allowed input: `Int64` State: same as input # Min aggregator. + }, + "stateType": # Object with schema name: Type # Output only. Type that holds the internal accumulator state for the `Aggregate`. This is a function of the `input_type` and `aggregator` chosen. + "sum": { # Computes the sum of the input values. Allowed input: `Int64` State: same as input # Sum aggregator. + }, + }, + "arrayType": { # An ordered list of elements of a given type. Values of type `Array` are stored in `Value.array_value`. # Array + "elementType": # Object with schema name: Type # The type of the elements in the array. This must not be `Array`. + }, + "boolType": { # bool Values of type `Bool` are stored in `Value.bool_value`. # Bool + "encoding": { # Defines rules used to convert to or from lower level types. # Specifies the encoding to use when converting to or from lower level types. + }, + }, + "bytesType": { # Bytes Values of type `Bytes` are stored in `Value.bytes_value`. # Bytes + "encoding": { # Rules used to convert to or from lower level types. # The encoding to use when converting to or from lower level types. + "raw": { # Leaves the value as-is. Sorted mode: all values are supported. Distinct mode: all values are supported. # Use `Raw` encoding. + "escapeNulls": True or False, # If set, allows NULL values to be encoded as the empty string "". The actual empty string, or any value which only contains the null byte `0x00`, has one more null byte appended. + }, + }, + }, + "dateType": { # Date Values of type `Date` are stored in `Value.date_value`. # Date + }, + "enumType": { # A protobuf enum type. Values of type `Enum` are stored in `Value.int_value`. # Enum + "enumName": "A String", # The fully qualified name of the protobuf enum message, including package. In the format of "foo.bar.EnumMessage". + "schemaBundleId": "A String", # The ID of the schema bundle that this enum is defined in. + }, + "float32Type": { # Float32 Values of type `Float32` are stored in `Value.float_value`. # Float32 + }, + "float64Type": { # Float64 Values of type `Float64` are stored in `Value.float_value`. # Float64 + }, + "geographyType": { # A geography type, representing a point or region on Earth. The value is stored in `Value.bytes_value` as Well-Known Binary (WKB) bytes. # Geography + }, + "int32Type": { # Int32 Values of type `Int32` are stored in `Value.int_value`. # Int32 + "encoding": { # Rules used to convert to or from lower level types. # The encoding to use when converting to or from lower level types. + "bigEndianBytes": { # Encodes the value as a 4-byte big-endian two's complement value. Sorted mode: non-negative values are supported. Distinct mode: all values are supported. Compatible with: - BigQuery `BINARY` encoding - HBase `Bytes.toBytes` - Java `ByteBuffer.putInt()` with `ByteOrder.BIG_ENDIAN` # Use `BigEndianBytes` encoding. + }, + "orderedCodeBytes": { # Encodes the value in a variable length binary format of up to 5 bytes. Values that are closer to zero use fewer bytes. Sorted mode: all values are supported. Distinct mode: all values are supported. # Use `OrderedCodeBytes` encoding. + }, + }, + }, + "int64Type": { # Int64 Values of type `Int64` are stored in `Value.int_value`. # Int64 + "encoding": { # Rules used to convert to or from lower level types. # The encoding to use when converting to or from lower level types. + "bigEndianBytes": { # Encodes the value as an 8-byte big-endian two's complement value. Sorted mode: non-negative values are supported. Distinct mode: all values are supported. Compatible with: - BigQuery `BINARY` encoding - HBase `Bytes.toBytes` - Java `ByteBuffer.putLong()` with `ByteOrder.BIG_ENDIAN` # Use `BigEndianBytes` encoding. + "bytesType": { # Bytes Values of type `Bytes` are stored in `Value.bytes_value`. # Deprecated: ignored if set. + "encoding": { # Rules used to convert to or from lower level types. # The encoding to use when converting to or from lower level types. + "raw": { # Leaves the value as-is. Sorted mode: all values are supported. Distinct mode: all values are supported. # Use `Raw` encoding. + "escapeNulls": True or False, # If set, allows NULL values to be encoded as the empty string "". The actual empty string, or any value which only contains the null byte `0x00`, has one more null byte appended. + }, + }, + }, + }, + "orderedCodeBytes": { # Encodes the value in a variable length binary format of up to 10 bytes. Values that are closer to zero use fewer bytes. Sorted mode: all values are supported. Distinct mode: all values are supported. # Use `OrderedCodeBytes` encoding. + }, + }, + }, + "mapType": { # A mapping of keys to values of a given type. Values of type `Map` are stored in a `Value.array_value` where each entry is another `Value.array_value` with two elements (the key and the value, in that order). Normally encoded Map values won't have repeated keys, however, clients are expected to handle the case in which they do. If the same key appears multiple times, the _last_ value takes precedence. # Map + "keyType": # Object with schema name: Type # The type of a map key. Only `Bytes`, `String`, and `Int64` are allowed as key types. + "valueType": # Object with schema name: Type # The type of the values in a map. + }, + "protoType": { # A protobuf message type. Values of type `Proto` are stored in `Value.bytes_value`. # Proto + "messageName": "A String", # The fully qualified name of the protobuf message, including package. In the format of "foo.bar.Message". + "schemaBundleId": "A String", # The ID of the schema bundle that this proto is defined in. + }, + "stringType": { # String Values of type `String` are stored in `Value.string_value`. # String + "encoding": { # Rules used to convert to or from lower level types. # The encoding to use when converting to or from lower level types. + "utf8Bytes": { # UTF-8 encoding. Sorted mode: - All values are supported. - Code point order is preserved. Distinct mode: all values are supported. Compatible with: - BigQuery `TEXT` encoding - HBase `Bytes.toBytes` - Java `String#getBytes(StandardCharsets.UTF_8)` # Use `Utf8Bytes` encoding. + "nullEscapeChar": "A String", # Single-character escape sequence used to support NULL values. If set, allows NULL values to be encoded as the empty string "". The actual empty string, or any value where every character equals `null_escape_char`, has one more `null_escape_char` appended. If `null_escape_char` is set and does not equal the ASCII null character `0x00`, then the encoding will not support sorted mode. . + }, + "utf8Raw": { # Deprecated: prefer the equivalent `Utf8Bytes`. # Deprecated: if set, converts to an empty `utf8_bytes`. + }, + }, + }, + "structType": { # A structured data value, consisting of fields which map to dynamically typed values. Values of type `Struct` are stored in `Value.array_value` where entries are in the same order and number as `field_types`. # Struct + "encoding": { # Rules used to convert to or from lower level types. # The encoding to use when converting to or from lower level types. + "delimitedBytes": { # Fields are encoded independently and concatenated with a configurable `delimiter` in between. A struct with no fields defined is encoded as a single `delimiter`. Sorted mode: - Fields are encoded in sorted mode. - Encoded field values must not contain any bytes <= `delimiter[0]` - Element-wise order is preserved: `A < B` if `A[0] < B[0]`, or if `A[0] == B[0] && A[1] < B[1]`, etc. Strict prefixes sort first. - This encoding does not support `DESC` field ordering. Distinct mode: - Fields are encoded in distinct mode. - Encoded field values must not contain `delimiter[0]`. # Use `DelimitedBytes` encoding. + "delimiter": "A String", # Byte sequence used to delimit concatenated fields. The delimiter must contain at least 1 character and at most 50 characters. + }, + "orderedCodeBytes": { # Fields are encoded independently, then escaped and delimited by appling the following rules in order: - While the last remaining field is `ASC` or `UNSPECIFIED`, and encodes to the empty string "", remove it. - In each remaining field, replace all null bytes `0x00` with the fixed byte pair `{0x00, 0xFF}`. - If any remaining field encodes to the empty string "", replace it with the fixed byte pair `{0x00, 0x00}`. - Append the fixed byte pair `{0x00, 0x01}` to each remaining field, except for the last remaining field if it is `ASC`. - Bitwise negate all `DESC` fields. - Concatenate the results, or emit the fixed byte pair `{0x00, 0x00}` if there are no remaining fields to concatenate. Examples: ``` - STRUCT() -> "\00\00" - STRUCT("") -> "\00\00" - STRUCT("", "") -> "\00\00" - STRUCT("", "B") -> "\00\00" + "\00\01" + "B" - STRUCT("A", "") -> "A" - STRUCT("", "B", "") -> "\00\00" + "\00\01" + "B" - STRUCT("A", "", "C") -> "A" + "\00\01" + "\00\00" + "\00\01" + "C" ``` Examples for struct with `DESC` fields: ``` - STRUCT("" DESC) -> "\xFF\xFF" + "\xFF\xFE" - STRUCT("" DESC, "") -> "\xFF\xFF" + "\xFF\xFE" - STRUCT("" DESC, "", "") -> "\xFF\xFF" + "\xFF\xFE" - STRUCT("" DESC, "A") -> "\xFF\xFF" + "\xFF\xFE" + "A" - STRUCT("A", "" DESC, "") -> "A" + "\00\01" + "\xFF\xFF" + "\xFF\xFE" - STRUCT("", "A" DESC) -> "\x00\x00" + "\x00\x01" + "\xBE" + "\xFF\xFE" ``` Since null bytes are always escaped, this encoding can cause size blowup for encodings like `Int64.BigEndianBytes` that are likely to produce many such bytes. Sorted mode: - Fields are encoded in sorted mode. - All values supported by the field encodings are allowed. - Fields with unset or `UNSPECIFIED` order are treated as `ASC`. - Element-wise order is preserved: `A < B` if `A[0] < B[0]`, or if `A[0] == B[0] && A[1] < B[1]`, etc. Strict prefixes sort first. Distinct mode: - Fields are encoded in distinct mode. - All values supported by the field encodings are allowed. # User `OrderedCodeBytes` encoding. + }, + "singleton": { # Uses the encoding of `fields[0].type` as-is. Only valid if `fields.size == 1`. This encoding does not support `DESC` field ordering. # Use `Singleton` encoding. + }, + }, + "fields": [ # The names and types of the fields in this struct. + { # A struct field and its type. + "fieldName": "A String", # The field name (optional). Fields without a `field_name` are considered anonymous and cannot be referenced by name. + "type": # Object with schema name: Type # The type of values in this field. + }, + ], + }, + "timestampType": { # Timestamp Values of type `Timestamp` are stored in `Value.timestamp_value`. # Timestamp + "encoding": { # Rules used to convert to or from lower level types. # The encoding to use when converting to or from lower level types. + "unixMicrosInt64": { # Rules used to convert to or from lower level types. # Encodes the number of microseconds since the Unix epoch using the given `Int64` encoding. Values must be microsecond-aligned. Compatible with: - Java `Instant.truncatedTo()` with `ChronoUnit.MICROS` + "bigEndianBytes": { # Encodes the value as an 8-byte big-endian two's complement value. Sorted mode: non-negative values are supported. Distinct mode: all values are supported. Compatible with: - BigQuery `BINARY` encoding - HBase `Bytes.toBytes` - Java `ByteBuffer.putLong()` with `ByteOrder.BIG_ENDIAN` # Use `BigEndianBytes` encoding. + "bytesType": { # Bytes Values of type `Bytes` are stored in `Value.bytes_value`. # Deprecated: ignored if set. + "encoding": { # Rules used to convert to or from lower level types. # The encoding to use when converting to or from lower level types. + "raw": { # Leaves the value as-is. Sorted mode: all values are supported. Distinct mode: all values are supported. # Use `Raw` encoding. + "escapeNulls": True or False, # If set, allows NULL values to be encoded as the empty string "". The actual empty string, or any value which only contains the null byte `0x00`, has one more null byte appended. + }, + }, + }, + }, + "orderedCodeBytes": { # Encodes the value in a variable length binary format of up to 10 bytes. Values that are closer to zero use fewer bytes. Sorted mode: all values are supported. Distinct mode: all values are supported. # Use `OrderedCodeBytes` encoding. + }, + }, + }, + }, + }, + }, + }, + "deletionProtection": True or False, # Set to true to make the table protected against data loss. i.e. deleting the following resources through Admin APIs are prohibited: * The table. * The column families in the table. * The instance containing the table. Note one can still delete the data stored in the table through Data APIs. + "effectiveAutomatedBackupPolicy": { # Defines an automated backup policy for a table # Output only. The effective automated backup policy applied to the table. This represents the policy actually in effect, which may be a system-default policy if the user has not explicitly configured one. Views: `SCHEMA_VIEW`, `FULL`. + "disabled": True or False, # Optional. If `true`, automated backups are explicitly disabled on this table. This allows users to opt out of default enablement. + "frequency": "A String", # How frequently automated backups should occur. The only supported value at this time is 24 hours. An undefined frequency is treated as 24 hours. + "keepHotDuration": "A String", # Optional. The amount of time that the automated backups remain hot. If specified, the backups created by this policy are `HOT` backups. If not specified, the backups are `STANDARD` backups. The value must be at least 24 hours and at most 10 days, and can't exceed the policy's `retention_period`. Only SSD instances support `HOT` automated backups. + "locations": [ # Optional. A list of Cloud Bigtable zones where automated backups are allowed to be created. If empty, automated backups will be created in all zones of the instance. Locations are in the format `projects/{project}/locations/{zone}`. You can set this field only for tables in Enterprise Plus instances. + "A String", + ], + "retentionPeriod": "A String", # Required. How long the automated backups should be retained. Values must be at least 3 days and at most 90 days. + }, + "granularity": "A String", # Immutable. The granularity at which timestamps are stored in this table. Timestamps not matching the granularity will be rejected. If unspecified at creation time, the value will be set to `MILLIS`. Views: `SCHEMA_VIEW`, `FULL`. + "name": "A String", # The unique name of the table. Values are of the form `projects/{project}/instances/{instance}/tables/_a-zA-Z0-9*`. Views: `NAME_ONLY`, `SCHEMA_VIEW`, `REPLICATION_VIEW`, `STATS_VIEW`, `FULL` + "restoreInfo": { # Information about a table restore. # Output only. If this table was restored from another data source (e.g. a backup), this field will be populated with information about the restore. + "backupInfo": { # Information about a backup. # Information about the backup used to restore the table. The backup may no longer exist. + "backup": "A String", # Output only. Name of the backup. + "endTime": "A String", # Output only. This time that the backup was finished. Row data in the backup will be no newer than this timestamp. + "sourceBackup": "A String", # Output only. Name of the backup from which this backup was copied. If a backup is not created by copying a backup, this field will be empty. Values are of the form: projects//instances//clusters//backups/ + "sourceTable": "A String", # Output only. Name of the table the backup was created from. + "startTime": "A String", # Output only. The time that the backup was started. Row data in the backup will be no older than this timestamp. + }, + "sourceType": "A String", # The type of the restore source. + }, + "rowKeySchema": { # A structured data value, consisting of fields which map to dynamically typed values. Values of type `Struct` are stored in `Value.array_value` where entries are in the same order and number as `field_types`. # The row key schema for this table. The schema is used to decode the raw row key bytes into a structured format. The order of field declarations in this schema is important, as it reflects how the raw row key bytes are structured. Currently, this only affects how the key is read via a GoogleSQL query from the ExecuteQuery API. For a SQL query, the _key column is still read as raw bytes. But queries can reference the key fields by name, which will be decoded from _key using provided type and encoding. Queries that reference key fields will fail if they encounter an invalid row key. For example, if _key = "some_id#2024-04-30#\x00\x13\x00\xf3" with the following schema: { fields { field_name: "id" type { string { encoding: utf8_bytes {} } } } fields { field_name: "date" type { string { encoding: utf8_bytes {} } } } fields { field_name: "product_code" type { int64 { encoding: big_endian_bytes {} } } } encoding { delimited_bytes { delimiter: "#" } } } The decoded key parts would be: id = "some_id", date = "2024-04-30", product_code = 1245427 The query "SELECT _key, product_code FROM table" will return two columns: /------------------------------------------------------\ | _key | product_code | | --------------------------------------|--------------| | "some_id#2024-04-30#\x00\x13\x00\xf3" | 1245427 | \------------------------------------------------------/ The schema has the following invariants: (1) The decoded field values are order-preserved. For read, the field values will be decoded in sorted mode from the raw bytes. (2) Every field in the schema must specify a non-empty name. (3) Every field must specify a type with an associated encoding. The type is limited to scalar types only: Array, Map, Aggregate, and Struct are not allowed. (4) The field names must not collide with existing column family names and reserved keywords "_key" and "_timestamp". The following update operations are allowed for row_key_schema: - Update from an empty schema to a new schema. - Remove the existing schema. This operation requires setting the `ignore_warnings` flag to `true`, since it might be a backward incompatible change. Without the flag, the update request will fail with an INVALID_ARGUMENT error. Any other row key schema update operation (e.g. update existing schema columns names or types) is currently unsupported. + "encoding": { # Rules used to convert to or from lower level types. # The encoding to use when converting to or from lower level types. + "delimitedBytes": { # Fields are encoded independently and concatenated with a configurable `delimiter` in between. A struct with no fields defined is encoded as a single `delimiter`. Sorted mode: - Fields are encoded in sorted mode. - Encoded field values must not contain any bytes <= `delimiter[0]` - Element-wise order is preserved: `A < B` if `A[0] < B[0]`, or if `A[0] == B[0] && A[1] < B[1]`, etc. Strict prefixes sort first. - This encoding does not support `DESC` field ordering. Distinct mode: - Fields are encoded in distinct mode. - Encoded field values must not contain `delimiter[0]`. # Use `DelimitedBytes` encoding. + "delimiter": "A String", # Byte sequence used to delimit concatenated fields. The delimiter must contain at least 1 character and at most 50 characters. + }, + "orderedCodeBytes": { # Fields are encoded independently, then escaped and delimited by appling the following rules in order: - While the last remaining field is `ASC` or `UNSPECIFIED`, and encodes to the empty string "", remove it. - In each remaining field, replace all null bytes `0x00` with the fixed byte pair `{0x00, 0xFF}`. - If any remaining field encodes to the empty string "", replace it with the fixed byte pair `{0x00, 0x00}`. - Append the fixed byte pair `{0x00, 0x01}` to each remaining field, except for the last remaining field if it is `ASC`. - Bitwise negate all `DESC` fields. - Concatenate the results, or emit the fixed byte pair `{0x00, 0x00}` if there are no remaining fields to concatenate. Examples: ``` - STRUCT() -> "\00\00" - STRUCT("") -> "\00\00" - STRUCT("", "") -> "\00\00" - STRUCT("", "B") -> "\00\00" + "\00\01" + "B" - STRUCT("A", "") -> "A" - STRUCT("", "B", "") -> "\00\00" + "\00\01" + "B" - STRUCT("A", "", "C") -> "A" + "\00\01" + "\00\00" + "\00\01" + "C" ``` Examples for struct with `DESC` fields: ``` - STRUCT("" DESC) -> "\xFF\xFF" + "\xFF\xFE" - STRUCT("" DESC, "") -> "\xFF\xFF" + "\xFF\xFE" - STRUCT("" DESC, "", "") -> "\xFF\xFF" + "\xFF\xFE" - STRUCT("" DESC, "A") -> "\xFF\xFF" + "\xFF\xFE" + "A" - STRUCT("A", "" DESC, "") -> "A" + "\00\01" + "\xFF\xFF" + "\xFF\xFE" - STRUCT("", "A" DESC) -> "\x00\x00" + "\x00\x01" + "\xBE" + "\xFF\xFE" ``` Since null bytes are always escaped, this encoding can cause size blowup for encodings like `Int64.BigEndianBytes` that are likely to produce many such bytes. Sorted mode: - Fields are encoded in sorted mode. - All values supported by the field encodings are allowed. - Fields with unset or `UNSPECIFIED` order are treated as `ASC`. - Element-wise order is preserved: `A < B` if `A[0] < B[0]`, or if `A[0] == B[0] && A[1] < B[1]`, etc. Strict prefixes sort first. Distinct mode: - Fields are encoded in distinct mode. - All values supported by the field encodings are allowed. # User `OrderedCodeBytes` encoding. + }, + "singleton": { # Uses the encoding of `fields[0].type` as-is. Only valid if `fields.size == 1`. This encoding does not support `DESC` field ordering. # Use `Singleton` encoding. + }, + }, + "fields": [ # The names and types of the fields in this struct. + { # A struct field and its type. + "fieldName": "A String", # The field name (optional). Fields without a `field_name` are considered anonymous and cannot be referenced by name. + "type": # Object with schema name: Type # The type of values in this field. + }, + ], + }, + "stats": { # Approximate statistics related to a table. These statistics are calculated infrequently, while simultaneously, data in the table can change rapidly. Thus the values reported here (e.g. row count) are very likely out-of date, even the instant they are received in this API. Thus, only treat these values as approximate. IMPORTANT: Everything below is approximate, unless otherwise specified. # Output only. Only available with STATS_VIEW, this includes summary statistics about the entire table contents. For statistics about a specific column family, see ColumnFamilyStats in the mapped ColumnFamily collection above. + "averageCellsPerColumn": 3.14, # How many cells are present per column (column family, column qualifier) combinations, averaged over all columns in all rows in the table. e.g. A table with 2 rows: * A row with 3 cells in "family:col" and 1 cell in "other:col" (4 cells / 2 columns) * A row with 1 cell in "family:col", 7 cells in "family:other_col", and 7 cells in "other:data" (15 cells / 3 columns) would report (4 + 15)/(2 + 3) = 3.8 in this field. + "averageColumnsPerRow": 3.14, # How many (column family, column qualifier) combinations are present per row in the table, averaged over all rows in the table. e.g. A table with 2 rows: * A row with cells in "family:col" and "other:col" (2 distinct columns) * A row with cells in "family:col", "family:other_col", and "other:data" (3 distinct columns) would report (2 + 3)/2 = 2.5 in this field. + "logicalDataBytes": "A String", # This is roughly how many bytes would be needed to read the entire table (e.g. by streaming all contents out). + "rowCount": "A String", # How many rows are in the table. + }, + "tieredStorageConfig": { # Config for tiered storage. A valid config must have a valid TieredStorageRule. Otherwise the whole TieredStorageConfig must be unset. By default all data is stored in the SSD tier (only SSD instances can configure tiered storage). # Rules to specify what data is stored in each storage tier. Different tiers store data differently, providing different trade-offs between cost and performance. Different parts of a table can be stored separately on different tiers. If a config is specified, tiered storage is enabled for this table. Otherwise, tiered storage is disabled. Only SSD instances can configure tiered storage. + "infrequentAccess": { # Rule to specify what data is stored in a storage tier. # Rule to specify what data is stored in the infrequent access(IA) tier. The IA tier allows storing more data per node with reduced performance. + "includeIfOlderThan": "A String", # Include cells older than the given age. For the infrequent access tier, this value must be at least 30 days. + }, + }, + }, "tableId": "A String", # Required. The id of the table to create and restore to. This table must not already exist. The `table_id` appended to `parent` forms the full table name of the form `projects//instances//tables/`. + "updateMask": "A String", # Optional. The list of fields to set on the new table. A mask specifying which fields (e.g. `deletion_protection`) in the `table` field should be set. This mask is relative to the `table` field, not to the request message. The wildcard (*) path is currently not supported. Currently RestoreTable only supports the following fields for modification: * `deletion_protection`: Defaults to `false` if not set. * `automated_backup_policy`: Defaults to no automated backup policy if not set. Output-only fields in the mask will be ignored. If any other field not listed above is included in `update_mask`, it will result in an INVALID_ARGUMENT error. } x__xgafv: string, V1 error format. diff --git a/googleapiclient/discovery_cache/documents/bigtableadmin.v2.json b/googleapiclient/discovery_cache/documents/bigtableadmin.v2.json index 871321825a..d6272574ab 100644 --- a/googleapiclient/discovery_cache/documents/bigtableadmin.v2.json +++ b/googleapiclient/discovery_cache/documents/bigtableadmin.v2.json @@ -3238,7 +3238,7 @@ } } }, -"revision": "20260913", +"revision": "20261007", "rootUrl": "https://bigtableadmin.googleapis.com/", "schemas": { "AppProfile": { @@ -3368,11 +3368,20 @@ "description": "Defines an automated backup policy for a table", "id": "AutomatedBackupPolicy", "properties": { +"disabled": { +"description": "Optional. If `true`, automated backups are explicitly disabled on this table. This allows users to opt out of default enablement.", +"type": "boolean" +}, "frequency": { "description": "How frequently automated backups should occur. The only supported value at this time is 24 hours. An undefined frequency is treated as 24 hours.", "format": "google-duration", "type": "string" }, +"keepHotDuration": { +"description": "Optional. The amount of time that the automated backups remain hot. If specified, the backups created by this policy are `HOT` backups. If not specified, the backups are `STANDARD` backups. The value must be at least 24 hours and at most 10 days, and can't exceed the policy's `retention_period`. Only SSD instances support `HOT` automated backups.", +"format": "google-duration", +"type": "string" +}, "locations": { "description": "Optional. A list of Cloud Bigtable zones where automated backups are allowed to be created. If empty, automated backups will be created in all zones of the instance. Locations are in the format `projects/{project}/locations/{zone}`. You can set this field only for tables in Enterprise Plus instances.", "items": { @@ -5685,9 +5694,18 @@ "description": "Name of the backup from which to restore. Values are of the form `projects//instances//clusters//backups/`.", "type": "string" }, +"table": { +"$ref": "Table", +"description": "Optional. Properties of the table to be restored. Only the fields specified in update_mask will be used to set the restored table's properties." +}, "tableId": { "description": "Required. The id of the table to create and restore to. This table must not already exist. The `table_id` appended to `parent` forms the full table name of the form `projects//instances//tables/`.", "type": "string" +}, +"updateMask": { +"description": "Optional. The list of fields to set on the new table. A mask specifying which fields (e.g. `deletion_protection`) in the `table` field should be set. This mask is relative to the `table` field, not to the request message. The wildcard (*) path is currently not supported. Currently RestoreTable only supports the following fields for modification: * `deletion_protection`: Defaults to `false` if not set. * `automated_backup_policy`: Defaults to no automated backup policy if not set. Output-only fields in the mask will be ignored. If any other field not listed above is included in `update_mask`, it will result in an INVALID_ARGUMENT error.", +"format": "google-fieldmask", +"type": "string" } }, "type": "object" @@ -5855,6 +5873,11 @@ "description": "Set to true to make the table protected against data loss. i.e. deleting the following resources through Admin APIs are prohibited: * The table. * The column families in the table. * The instance containing the table. Note one can still delete the data stored in the table through Data APIs.", "type": "boolean" }, +"effectiveAutomatedBackupPolicy": { +"$ref": "AutomatedBackupPolicy", +"description": "Output only. The effective automated backup policy applied to the table. This represents the policy actually in effect, which may be a system-default policy if the user has not explicitly configured one. Views: `SCHEMA_VIEW`, `FULL`.", +"readOnly": true +}, "granularity": { "description": "Immutable. The granularity at which timestamps are stored in this table. Timestamps not matching the granularity will be rejected. If unspecified at creation time, the value will be set to `MILLIS`. Views: `SCHEMA_VIEW`, `FULL`.", "enum": [ From 081595b44c8cd1e7d66210d2cf64659d72b7e4e9 Mon Sep 17 00:00:00 2001 From: Yoshi Automation Date: Tue, 20 Oct 2026 07:23:59 +0000 Subject: [PATCH 06/34] feat(cloudbuild): update the api #### cloudbuild:v1 The following keys were added: - schemas.BuildResourceUsage (Total Keys: 17) - schemas.Results.properties.resourceUsage (Total Keys: 2) --- docs/dyn/cloudbuild_v1.projects.builds.html | 36 +++++++++++-- ...oudbuild_v1.projects.locations.builds.html | 36 +++++++++++-- ...dbuild_v1.projects.locations.triggers.html | 54 ++++++++++++++++--- docs/dyn/cloudbuild_v1.projects.triggers.html | 54 ++++++++++++++++--- .../documents/cloudbuild.v1.json | 52 ++++++++++++++++-- 5 files changed, 208 insertions(+), 24 deletions(-) diff --git a/docs/dyn/cloudbuild_v1.projects.builds.html b/docs/dyn/cloudbuild_v1.projects.builds.html index 1653677d52..c26f491669 100644 --- a/docs/dyn/cloudbuild_v1.projects.builds.html +++ b/docs/dyn/cloudbuild_v1.projects.builds.html @@ -271,7 +271,7 @@

Method Details

{ # A dependency that the Cloud Build worker will fetch before executing user steps. "empty": True or False, # If set to true disable all dependency fetching (ignoring the default source as well). "genericArtifact": { # Represents a generic artifact as a build dependency. # Represents a generic artifact as a build dependency. - "destPath": "A String", # Required. Where the artifact files should be placed on the worker. + "destPath": "A String", # Optional. Where the artifact files should be placed on the worker. Required when specified in `Build.dependencies`. "resource": "A String", # Required. The location to download the artifact files from. Ex: projects/p1/locations/us/repositories/r1/packages/p1/versions/v1 }, "gitSource": { # Represents a git repository as a build dependency. # Represents a git repository as a build dependency. @@ -474,6 +474,13 @@

Method Details

"uri": "A String", # URI of the uploaded artifact. }, ], + "resourceUsage": { # Aggregated/summary metrics over the entire build lifecycle. # Output only. Aggregated metrics for the build. + "averageCpuUtilization": 3.14, # Output only. The average CPU utilization ratio across all vCPUs over the duration of the build, expressed as a fraction in the range [0.0, 1.0]. + "averageMemoryUtilization": 3.14, # Output only. The average memory utilization ratio over the duration of the build, expressed as a fraction in the range [0.0, 1.0]. + "peakCpuUtilization": 3.14, # Output only. The highest CPU utilization ratio across all vCPUs observed over the duration of the build, expressed as a fraction in the range [0.0, 1.0]. + "peakMemoryUtilization": 3.14, # Output only. The highest memory utilization ratio observed over the duration of the build, expressed as a fraction in the range [0.0, 1.0]. + "totalCpuDuration": "A String", # Output only. Total CPU execution time consumed across all cores during build execution. + }, }, "secrets": [ # Secrets to decrypt using Cloud Key Management Service. Note: Secret Manager is the recommended technique for managing sensitive data with Cloud Build. Use `available_secrets` to configure builds to access secrets from Secret Manager. For instructions, see: https://cloud.google.com/cloud-build/docs/securing-builds/use-secrets { # Pairs a set of secret environment variables containing encrypted values with the Cloud KMS key to use to decrypt the value. Note: Use `kmsKeyName` with `available_secrets` instead of using `kmsKeyName` with `secret`. For instructions see: https://cloud.google.com/cloud-build/docs/securing-builds/use-encrypted-credentials. @@ -758,7 +765,7 @@

Method Details

{ # A dependency that the Cloud Build worker will fetch before executing user steps. "empty": True or False, # If set to true disable all dependency fetching (ignoring the default source as well). "genericArtifact": { # Represents a generic artifact as a build dependency. # Represents a generic artifact as a build dependency. - "destPath": "A String", # Required. Where the artifact files should be placed on the worker. + "destPath": "A String", # Optional. Where the artifact files should be placed on the worker. Required when specified in `Build.dependencies`. "resource": "A String", # Required. The location to download the artifact files from. Ex: projects/p1/locations/us/repositories/r1/packages/p1/versions/v1 }, "gitSource": { # Represents a git repository as a build dependency. # Represents a git repository as a build dependency. @@ -961,6 +968,13 @@

Method Details

"uri": "A String", # URI of the uploaded artifact. }, ], + "resourceUsage": { # Aggregated/summary metrics over the entire build lifecycle. # Output only. Aggregated metrics for the build. + "averageCpuUtilization": 3.14, # Output only. The average CPU utilization ratio across all vCPUs over the duration of the build, expressed as a fraction in the range [0.0, 1.0]. + "averageMemoryUtilization": 3.14, # Output only. The average memory utilization ratio over the duration of the build, expressed as a fraction in the range [0.0, 1.0]. + "peakCpuUtilization": 3.14, # Output only. The highest CPU utilization ratio across all vCPUs observed over the duration of the build, expressed as a fraction in the range [0.0, 1.0]. + "peakMemoryUtilization": 3.14, # Output only. The highest memory utilization ratio observed over the duration of the build, expressed as a fraction in the range [0.0, 1.0]. + "totalCpuDuration": "A String", # Output only. Total CPU execution time consumed across all cores during build execution. + }, }, "secrets": [ # Secrets to decrypt using Cloud Key Management Service. Note: Secret Manager is the recommended technique for managing sensitive data with Cloud Build. Use `available_secrets` to configure builds to access secrets from Secret Manager. For instructions, see: https://cloud.google.com/cloud-build/docs/securing-builds/use-secrets { # Pairs a set of secret environment variables containing encrypted values with the Cloud KMS key to use to decrypt the value. Note: Use `kmsKeyName` with `available_secrets` instead of using `kmsKeyName` with `secret`. For instructions see: https://cloud.google.com/cloud-build/docs/securing-builds/use-encrypted-credentials. @@ -1276,7 +1290,7 @@

Method Details

{ # A dependency that the Cloud Build worker will fetch before executing user steps. "empty": True or False, # If set to true disable all dependency fetching (ignoring the default source as well). "genericArtifact": { # Represents a generic artifact as a build dependency. # Represents a generic artifact as a build dependency. - "destPath": "A String", # Required. Where the artifact files should be placed on the worker. + "destPath": "A String", # Optional. Where the artifact files should be placed on the worker. Required when specified in `Build.dependencies`. "resource": "A String", # Required. The location to download the artifact files from. Ex: projects/p1/locations/us/repositories/r1/packages/p1/versions/v1 }, "gitSource": { # Represents a git repository as a build dependency. # Represents a git repository as a build dependency. @@ -1479,6 +1493,13 @@

Method Details

"uri": "A String", # URI of the uploaded artifact. }, ], + "resourceUsage": { # Aggregated/summary metrics over the entire build lifecycle. # Output only. Aggregated metrics for the build. + "averageCpuUtilization": 3.14, # Output only. The average CPU utilization ratio across all vCPUs over the duration of the build, expressed as a fraction in the range [0.0, 1.0]. + "averageMemoryUtilization": 3.14, # Output only. The average memory utilization ratio over the duration of the build, expressed as a fraction in the range [0.0, 1.0]. + "peakCpuUtilization": 3.14, # Output only. The highest CPU utilization ratio across all vCPUs observed over the duration of the build, expressed as a fraction in the range [0.0, 1.0]. + "peakMemoryUtilization": 3.14, # Output only. The highest memory utilization ratio observed over the duration of the build, expressed as a fraction in the range [0.0, 1.0]. + "totalCpuDuration": "A String", # Output only. Total CPU execution time consumed across all cores during build execution. + }, }, "secrets": [ # Secrets to decrypt using Cloud Key Management Service. Note: Secret Manager is the recommended technique for managing sensitive data with Cloud Build. Use `available_secrets` to configure builds to access secrets from Secret Manager. For instructions, see: https://cloud.google.com/cloud-build/docs/securing-builds/use-secrets { # Pairs a set of secret environment variables containing encrypted values with the Cloud KMS key to use to decrypt the value. Note: Use `kmsKeyName` with `available_secrets` instead of using `kmsKeyName` with `secret`. For instructions see: https://cloud.google.com/cloud-build/docs/securing-builds/use-encrypted-credentials. @@ -1769,7 +1790,7 @@

Method Details

{ # A dependency that the Cloud Build worker will fetch before executing user steps. "empty": True or False, # If set to true disable all dependency fetching (ignoring the default source as well). "genericArtifact": { # Represents a generic artifact as a build dependency. # Represents a generic artifact as a build dependency. - "destPath": "A String", # Required. Where the artifact files should be placed on the worker. + "destPath": "A String", # Optional. Where the artifact files should be placed on the worker. Required when specified in `Build.dependencies`. "resource": "A String", # Required. The location to download the artifact files from. Ex: projects/p1/locations/us/repositories/r1/packages/p1/versions/v1 }, "gitSource": { # Represents a git repository as a build dependency. # Represents a git repository as a build dependency. @@ -1972,6 +1993,13 @@

Method Details

"uri": "A String", # URI of the uploaded artifact. }, ], + "resourceUsage": { # Aggregated/summary metrics over the entire build lifecycle. # Output only. Aggregated metrics for the build. + "averageCpuUtilization": 3.14, # Output only. The average CPU utilization ratio across all vCPUs over the duration of the build, expressed as a fraction in the range [0.0, 1.0]. + "averageMemoryUtilization": 3.14, # Output only. The average memory utilization ratio over the duration of the build, expressed as a fraction in the range [0.0, 1.0]. + "peakCpuUtilization": 3.14, # Output only. The highest CPU utilization ratio across all vCPUs observed over the duration of the build, expressed as a fraction in the range [0.0, 1.0]. + "peakMemoryUtilization": 3.14, # Output only. The highest memory utilization ratio observed over the duration of the build, expressed as a fraction in the range [0.0, 1.0]. + "totalCpuDuration": "A String", # Output only. Total CPU execution time consumed across all cores during build execution. + }, }, "secrets": [ # Secrets to decrypt using Cloud Key Management Service. Note: Secret Manager is the recommended technique for managing sensitive data with Cloud Build. Use `available_secrets` to configure builds to access secrets from Secret Manager. For instructions, see: https://cloud.google.com/cloud-build/docs/securing-builds/use-secrets { # Pairs a set of secret environment variables containing encrypted values with the Cloud KMS key to use to decrypt the value. Note: Use `kmsKeyName` with `available_secrets` instead of using `kmsKeyName` with `secret`. For instructions see: https://cloud.google.com/cloud-build/docs/securing-builds/use-encrypted-credentials. diff --git a/docs/dyn/cloudbuild_v1.projects.locations.builds.html b/docs/dyn/cloudbuild_v1.projects.locations.builds.html index cc583c76e4..e44df78b8b 100644 --- a/docs/dyn/cloudbuild_v1.projects.locations.builds.html +++ b/docs/dyn/cloudbuild_v1.projects.locations.builds.html @@ -270,7 +270,7 @@

Method Details

{ # A dependency that the Cloud Build worker will fetch before executing user steps. "empty": True or False, # If set to true disable all dependency fetching (ignoring the default source as well). "genericArtifact": { # Represents a generic artifact as a build dependency. # Represents a generic artifact as a build dependency. - "destPath": "A String", # Required. Where the artifact files should be placed on the worker. + "destPath": "A String", # Optional. Where the artifact files should be placed on the worker. Required when specified in `Build.dependencies`. "resource": "A String", # Required. The location to download the artifact files from. Ex: projects/p1/locations/us/repositories/r1/packages/p1/versions/v1 }, "gitSource": { # Represents a git repository as a build dependency. # Represents a git repository as a build dependency. @@ -473,6 +473,13 @@

Method Details

"uri": "A String", # URI of the uploaded artifact. }, ], + "resourceUsage": { # Aggregated/summary metrics over the entire build lifecycle. # Output only. Aggregated metrics for the build. + "averageCpuUtilization": 3.14, # Output only. The average CPU utilization ratio across all vCPUs over the duration of the build, expressed as a fraction in the range [0.0, 1.0]. + "averageMemoryUtilization": 3.14, # Output only. The average memory utilization ratio over the duration of the build, expressed as a fraction in the range [0.0, 1.0]. + "peakCpuUtilization": 3.14, # Output only. The highest CPU utilization ratio across all vCPUs observed over the duration of the build, expressed as a fraction in the range [0.0, 1.0]. + "peakMemoryUtilization": 3.14, # Output only. The highest memory utilization ratio observed over the duration of the build, expressed as a fraction in the range [0.0, 1.0]. + "totalCpuDuration": "A String", # Output only. Total CPU execution time consumed across all cores during build execution. + }, }, "secrets": [ # Secrets to decrypt using Cloud Key Management Service. Note: Secret Manager is the recommended technique for managing sensitive data with Cloud Build. Use `available_secrets` to configure builds to access secrets from Secret Manager. For instructions, see: https://cloud.google.com/cloud-build/docs/securing-builds/use-secrets { # Pairs a set of secret environment variables containing encrypted values with the Cloud KMS key to use to decrypt the value. Note: Use `kmsKeyName` with `available_secrets` instead of using `kmsKeyName` with `secret`. For instructions see: https://cloud.google.com/cloud-build/docs/securing-builds/use-encrypted-credentials. @@ -757,7 +764,7 @@

Method Details

{ # A dependency that the Cloud Build worker will fetch before executing user steps. "empty": True or False, # If set to true disable all dependency fetching (ignoring the default source as well). "genericArtifact": { # Represents a generic artifact as a build dependency. # Represents a generic artifact as a build dependency. - "destPath": "A String", # Required. Where the artifact files should be placed on the worker. + "destPath": "A String", # Optional. Where the artifact files should be placed on the worker. Required when specified in `Build.dependencies`. "resource": "A String", # Required. The location to download the artifact files from. Ex: projects/p1/locations/us/repositories/r1/packages/p1/versions/v1 }, "gitSource": { # Represents a git repository as a build dependency. # Represents a git repository as a build dependency. @@ -960,6 +967,13 @@

Method Details

"uri": "A String", # URI of the uploaded artifact. }, ], + "resourceUsage": { # Aggregated/summary metrics over the entire build lifecycle. # Output only. Aggregated metrics for the build. + "averageCpuUtilization": 3.14, # Output only. The average CPU utilization ratio across all vCPUs over the duration of the build, expressed as a fraction in the range [0.0, 1.0]. + "averageMemoryUtilization": 3.14, # Output only. The average memory utilization ratio over the duration of the build, expressed as a fraction in the range [0.0, 1.0]. + "peakCpuUtilization": 3.14, # Output only. The highest CPU utilization ratio across all vCPUs observed over the duration of the build, expressed as a fraction in the range [0.0, 1.0]. + "peakMemoryUtilization": 3.14, # Output only. The highest memory utilization ratio observed over the duration of the build, expressed as a fraction in the range [0.0, 1.0]. + "totalCpuDuration": "A String", # Output only. Total CPU execution time consumed across all cores during build execution. + }, }, "secrets": [ # Secrets to decrypt using Cloud Key Management Service. Note: Secret Manager is the recommended technique for managing sensitive data with Cloud Build. Use `available_secrets` to configure builds to access secrets from Secret Manager. For instructions, see: https://cloud.google.com/cloud-build/docs/securing-builds/use-secrets { # Pairs a set of secret environment variables containing encrypted values with the Cloud KMS key to use to decrypt the value. Note: Use `kmsKeyName` with `available_secrets` instead of using `kmsKeyName` with `secret`. For instructions see: https://cloud.google.com/cloud-build/docs/securing-builds/use-encrypted-credentials. @@ -1275,7 +1289,7 @@

Method Details

{ # A dependency that the Cloud Build worker will fetch before executing user steps. "empty": True or False, # If set to true disable all dependency fetching (ignoring the default source as well). "genericArtifact": { # Represents a generic artifact as a build dependency. # Represents a generic artifact as a build dependency. - "destPath": "A String", # Required. Where the artifact files should be placed on the worker. + "destPath": "A String", # Optional. Where the artifact files should be placed on the worker. Required when specified in `Build.dependencies`. "resource": "A String", # Required. The location to download the artifact files from. Ex: projects/p1/locations/us/repositories/r1/packages/p1/versions/v1 }, "gitSource": { # Represents a git repository as a build dependency. # Represents a git repository as a build dependency. @@ -1478,6 +1492,13 @@

Method Details

"uri": "A String", # URI of the uploaded artifact. }, ], + "resourceUsage": { # Aggregated/summary metrics over the entire build lifecycle. # Output only. Aggregated metrics for the build. + "averageCpuUtilization": 3.14, # Output only. The average CPU utilization ratio across all vCPUs over the duration of the build, expressed as a fraction in the range [0.0, 1.0]. + "averageMemoryUtilization": 3.14, # Output only. The average memory utilization ratio over the duration of the build, expressed as a fraction in the range [0.0, 1.0]. + "peakCpuUtilization": 3.14, # Output only. The highest CPU utilization ratio across all vCPUs observed over the duration of the build, expressed as a fraction in the range [0.0, 1.0]. + "peakMemoryUtilization": 3.14, # Output only. The highest memory utilization ratio observed over the duration of the build, expressed as a fraction in the range [0.0, 1.0]. + "totalCpuDuration": "A String", # Output only. Total CPU execution time consumed across all cores during build execution. + }, }, "secrets": [ # Secrets to decrypt using Cloud Key Management Service. Note: Secret Manager is the recommended technique for managing sensitive data with Cloud Build. Use `available_secrets` to configure builds to access secrets from Secret Manager. For instructions, see: https://cloud.google.com/cloud-build/docs/securing-builds/use-secrets { # Pairs a set of secret environment variables containing encrypted values with the Cloud KMS key to use to decrypt the value. Note: Use `kmsKeyName` with `available_secrets` instead of using `kmsKeyName` with `secret`. For instructions see: https://cloud.google.com/cloud-build/docs/securing-builds/use-encrypted-credentials. @@ -1768,7 +1789,7 @@

Method Details

{ # A dependency that the Cloud Build worker will fetch before executing user steps. "empty": True or False, # If set to true disable all dependency fetching (ignoring the default source as well). "genericArtifact": { # Represents a generic artifact as a build dependency. # Represents a generic artifact as a build dependency. - "destPath": "A String", # Required. Where the artifact files should be placed on the worker. + "destPath": "A String", # Optional. Where the artifact files should be placed on the worker. Required when specified in `Build.dependencies`. "resource": "A String", # Required. The location to download the artifact files from. Ex: projects/p1/locations/us/repositories/r1/packages/p1/versions/v1 }, "gitSource": { # Represents a git repository as a build dependency. # Represents a git repository as a build dependency. @@ -1971,6 +1992,13 @@

Method Details

"uri": "A String", # URI of the uploaded artifact. }, ], + "resourceUsage": { # Aggregated/summary metrics over the entire build lifecycle. # Output only. Aggregated metrics for the build. + "averageCpuUtilization": 3.14, # Output only. The average CPU utilization ratio across all vCPUs over the duration of the build, expressed as a fraction in the range [0.0, 1.0]. + "averageMemoryUtilization": 3.14, # Output only. The average memory utilization ratio over the duration of the build, expressed as a fraction in the range [0.0, 1.0]. + "peakCpuUtilization": 3.14, # Output only. The highest CPU utilization ratio across all vCPUs observed over the duration of the build, expressed as a fraction in the range [0.0, 1.0]. + "peakMemoryUtilization": 3.14, # Output only. The highest memory utilization ratio observed over the duration of the build, expressed as a fraction in the range [0.0, 1.0]. + "totalCpuDuration": "A String", # Output only. Total CPU execution time consumed across all cores during build execution. + }, }, "secrets": [ # Secrets to decrypt using Cloud Key Management Service. Note: Secret Manager is the recommended technique for managing sensitive data with Cloud Build. Use `available_secrets` to configure builds to access secrets from Secret Manager. For instructions, see: https://cloud.google.com/cloud-build/docs/securing-builds/use-secrets { # Pairs a set of secret environment variables containing encrypted values with the Cloud KMS key to use to decrypt the value. Note: Use `kmsKeyName` with `available_secrets` instead of using `kmsKeyName` with `secret`. For instructions see: https://cloud.google.com/cloud-build/docs/securing-builds/use-encrypted-credentials. diff --git a/docs/dyn/cloudbuild_v1.projects.locations.triggers.html b/docs/dyn/cloudbuild_v1.projects.locations.triggers.html index cf887e34d1..304c9102f9 100644 --- a/docs/dyn/cloudbuild_v1.projects.locations.triggers.html +++ b/docs/dyn/cloudbuild_v1.projects.locations.triggers.html @@ -259,7 +259,7 @@

Method Details

{ # A dependency that the Cloud Build worker will fetch before executing user steps. "empty": True or False, # If set to true disable all dependency fetching (ignoring the default source as well). "genericArtifact": { # Represents a generic artifact as a build dependency. # Represents a generic artifact as a build dependency. - "destPath": "A String", # Required. Where the artifact files should be placed on the worker. + "destPath": "A String", # Optional. Where the artifact files should be placed on the worker. Required when specified in `Build.dependencies`. "resource": "A String", # Required. The location to download the artifact files from. Ex: projects/p1/locations/us/repositories/r1/packages/p1/versions/v1 }, "gitSource": { # Represents a git repository as a build dependency. # Represents a git repository as a build dependency. @@ -462,6 +462,13 @@

Method Details

"uri": "A String", # URI of the uploaded artifact. }, ], + "resourceUsage": { # Aggregated/summary metrics over the entire build lifecycle. # Output only. Aggregated metrics for the build. + "averageCpuUtilization": 3.14, # Output only. The average CPU utilization ratio across all vCPUs over the duration of the build, expressed as a fraction in the range [0.0, 1.0]. + "averageMemoryUtilization": 3.14, # Output only. The average memory utilization ratio over the duration of the build, expressed as a fraction in the range [0.0, 1.0]. + "peakCpuUtilization": 3.14, # Output only. The highest CPU utilization ratio across all vCPUs observed over the duration of the build, expressed as a fraction in the range [0.0, 1.0]. + "peakMemoryUtilization": 3.14, # Output only. The highest memory utilization ratio observed over the duration of the build, expressed as a fraction in the range [0.0, 1.0]. + "totalCpuDuration": "A String", # Output only. Total CPU execution time consumed across all cores during build execution. + }, }, "secrets": [ # Secrets to decrypt using Cloud Key Management Service. Note: Secret Manager is the recommended technique for managing sensitive data with Cloud Build. Use `available_secrets` to configure builds to access secrets from Secret Manager. For instructions, see: https://cloud.google.com/cloud-build/docs/securing-builds/use-secrets { # Pairs a set of secret environment variables containing encrypted values with the Cloud KMS key to use to decrypt the value. Note: Use `kmsKeyName` with `available_secrets` instead of using `kmsKeyName` with `secret`. For instructions see: https://cloud.google.com/cloud-build/docs/securing-builds/use-encrypted-credentials. @@ -890,7 +897,7 @@

Method Details

{ # A dependency that the Cloud Build worker will fetch before executing user steps. "empty": True or False, # If set to true disable all dependency fetching (ignoring the default source as well). "genericArtifact": { # Represents a generic artifact as a build dependency. # Represents a generic artifact as a build dependency. - "destPath": "A String", # Required. Where the artifact files should be placed on the worker. + "destPath": "A String", # Optional. Where the artifact files should be placed on the worker. Required when specified in `Build.dependencies`. "resource": "A String", # Required. The location to download the artifact files from. Ex: projects/p1/locations/us/repositories/r1/packages/p1/versions/v1 }, "gitSource": { # Represents a git repository as a build dependency. # Represents a git repository as a build dependency. @@ -1093,6 +1100,13 @@

Method Details

"uri": "A String", # URI of the uploaded artifact. }, ], + "resourceUsage": { # Aggregated/summary metrics over the entire build lifecycle. # Output only. Aggregated metrics for the build. + "averageCpuUtilization": 3.14, # Output only. The average CPU utilization ratio across all vCPUs over the duration of the build, expressed as a fraction in the range [0.0, 1.0]. + "averageMemoryUtilization": 3.14, # Output only. The average memory utilization ratio over the duration of the build, expressed as a fraction in the range [0.0, 1.0]. + "peakCpuUtilization": 3.14, # Output only. The highest CPU utilization ratio across all vCPUs observed over the duration of the build, expressed as a fraction in the range [0.0, 1.0]. + "peakMemoryUtilization": 3.14, # Output only. The highest memory utilization ratio observed over the duration of the build, expressed as a fraction in the range [0.0, 1.0]. + "totalCpuDuration": "A String", # Output only. Total CPU execution time consumed across all cores during build execution. + }, }, "secrets": [ # Secrets to decrypt using Cloud Key Management Service. Note: Secret Manager is the recommended technique for managing sensitive data with Cloud Build. Use `available_secrets` to configure builds to access secrets from Secret Manager. For instructions, see: https://cloud.google.com/cloud-build/docs/securing-builds/use-secrets { # Pairs a set of secret environment variables containing encrypted values with the Cloud KMS key to use to decrypt the value. Note: Use `kmsKeyName` with `available_secrets` instead of using `kmsKeyName` with `secret`. For instructions see: https://cloud.google.com/cloud-build/docs/securing-builds/use-encrypted-credentials. @@ -1549,7 +1563,7 @@

Method Details

{ # A dependency that the Cloud Build worker will fetch before executing user steps. "empty": True or False, # If set to true disable all dependency fetching (ignoring the default source as well). "genericArtifact": { # Represents a generic artifact as a build dependency. # Represents a generic artifact as a build dependency. - "destPath": "A String", # Required. Where the artifact files should be placed on the worker. + "destPath": "A String", # Optional. Where the artifact files should be placed on the worker. Required when specified in `Build.dependencies`. "resource": "A String", # Required. The location to download the artifact files from. Ex: projects/p1/locations/us/repositories/r1/packages/p1/versions/v1 }, "gitSource": { # Represents a git repository as a build dependency. # Represents a git repository as a build dependency. @@ -1752,6 +1766,13 @@

Method Details

"uri": "A String", # URI of the uploaded artifact. }, ], + "resourceUsage": { # Aggregated/summary metrics over the entire build lifecycle. # Output only. Aggregated metrics for the build. + "averageCpuUtilization": 3.14, # Output only. The average CPU utilization ratio across all vCPUs over the duration of the build, expressed as a fraction in the range [0.0, 1.0]. + "averageMemoryUtilization": 3.14, # Output only. The average memory utilization ratio over the duration of the build, expressed as a fraction in the range [0.0, 1.0]. + "peakCpuUtilization": 3.14, # Output only. The highest CPU utilization ratio across all vCPUs observed over the duration of the build, expressed as a fraction in the range [0.0, 1.0]. + "peakMemoryUtilization": 3.14, # Output only. The highest memory utilization ratio observed over the duration of the build, expressed as a fraction in the range [0.0, 1.0]. + "totalCpuDuration": "A String", # Output only. Total CPU execution time consumed across all cores during build execution. + }, }, "secrets": [ # Secrets to decrypt using Cloud Key Management Service. Note: Secret Manager is the recommended technique for managing sensitive data with Cloud Build. Use `available_secrets` to configure builds to access secrets from Secret Manager. For instructions, see: https://cloud.google.com/cloud-build/docs/securing-builds/use-secrets { # Pairs a set of secret environment variables containing encrypted values with the Cloud KMS key to use to decrypt the value. Note: Use `kmsKeyName` with `available_secrets` instead of using `kmsKeyName` with `secret`. For instructions see: https://cloud.google.com/cloud-build/docs/securing-builds/use-encrypted-credentials. @@ -2192,7 +2213,7 @@

Method Details

{ # A dependency that the Cloud Build worker will fetch before executing user steps. "empty": True or False, # If set to true disable all dependency fetching (ignoring the default source as well). "genericArtifact": { # Represents a generic artifact as a build dependency. # Represents a generic artifact as a build dependency. - "destPath": "A String", # Required. Where the artifact files should be placed on the worker. + "destPath": "A String", # Optional. Where the artifact files should be placed on the worker. Required when specified in `Build.dependencies`. "resource": "A String", # Required. The location to download the artifact files from. Ex: projects/p1/locations/us/repositories/r1/packages/p1/versions/v1 }, "gitSource": { # Represents a git repository as a build dependency. # Represents a git repository as a build dependency. @@ -2395,6 +2416,13 @@

Method Details

"uri": "A String", # URI of the uploaded artifact. }, ], + "resourceUsage": { # Aggregated/summary metrics over the entire build lifecycle. # Output only. Aggregated metrics for the build. + "averageCpuUtilization": 3.14, # Output only. The average CPU utilization ratio across all vCPUs over the duration of the build, expressed as a fraction in the range [0.0, 1.0]. + "averageMemoryUtilization": 3.14, # Output only. The average memory utilization ratio over the duration of the build, expressed as a fraction in the range [0.0, 1.0]. + "peakCpuUtilization": 3.14, # Output only. The highest CPU utilization ratio across all vCPUs observed over the duration of the build, expressed as a fraction in the range [0.0, 1.0]. + "peakMemoryUtilization": 3.14, # Output only. The highest memory utilization ratio observed over the duration of the build, expressed as a fraction in the range [0.0, 1.0]. + "totalCpuDuration": "A String", # Output only. Total CPU execution time consumed across all cores during build execution. + }, }, "secrets": [ # Secrets to decrypt using Cloud Key Management Service. Note: Secret Manager is the recommended technique for managing sensitive data with Cloud Build. Use `available_secrets` to configure builds to access secrets from Secret Manager. For instructions, see: https://cloud.google.com/cloud-build/docs/securing-builds/use-secrets { # Pairs a set of secret environment variables containing encrypted values with the Cloud KMS key to use to decrypt the value. Note: Use `kmsKeyName` with `available_secrets` instead of using `kmsKeyName` with `secret`. For instructions see: https://cloud.google.com/cloud-build/docs/securing-builds/use-encrypted-credentials. @@ -2840,7 +2868,7 @@

Method Details

{ # A dependency that the Cloud Build worker will fetch before executing user steps. "empty": True or False, # If set to true disable all dependency fetching (ignoring the default source as well). "genericArtifact": { # Represents a generic artifact as a build dependency. # Represents a generic artifact as a build dependency. - "destPath": "A String", # Required. Where the artifact files should be placed on the worker. + "destPath": "A String", # Optional. Where the artifact files should be placed on the worker. Required when specified in `Build.dependencies`. "resource": "A String", # Required. The location to download the artifact files from. Ex: projects/p1/locations/us/repositories/r1/packages/p1/versions/v1 }, "gitSource": { # Represents a git repository as a build dependency. # Represents a git repository as a build dependency. @@ -3043,6 +3071,13 @@

Method Details

"uri": "A String", # URI of the uploaded artifact. }, ], + "resourceUsage": { # Aggregated/summary metrics over the entire build lifecycle. # Output only. Aggregated metrics for the build. + "averageCpuUtilization": 3.14, # Output only. The average CPU utilization ratio across all vCPUs over the duration of the build, expressed as a fraction in the range [0.0, 1.0]. + "averageMemoryUtilization": 3.14, # Output only. The average memory utilization ratio over the duration of the build, expressed as a fraction in the range [0.0, 1.0]. + "peakCpuUtilization": 3.14, # Output only. The highest CPU utilization ratio across all vCPUs observed over the duration of the build, expressed as a fraction in the range [0.0, 1.0]. + "peakMemoryUtilization": 3.14, # Output only. The highest memory utilization ratio observed over the duration of the build, expressed as a fraction in the range [0.0, 1.0]. + "totalCpuDuration": "A String", # Output only. Total CPU execution time consumed across all cores during build execution. + }, }, "secrets": [ # Secrets to decrypt using Cloud Key Management Service. Note: Secret Manager is the recommended technique for managing sensitive data with Cloud Build. Use `available_secrets` to configure builds to access secrets from Secret Manager. For instructions, see: https://cloud.google.com/cloud-build/docs/securing-builds/use-secrets { # Pairs a set of secret environment variables containing encrypted values with the Cloud KMS key to use to decrypt the value. Note: Use `kmsKeyName` with `available_secrets` instead of using `kmsKeyName` with `secret`. For instructions see: https://cloud.google.com/cloud-build/docs/securing-builds/use-encrypted-credentials. @@ -3473,7 +3508,7 @@

Method Details

{ # A dependency that the Cloud Build worker will fetch before executing user steps. "empty": True or False, # If set to true disable all dependency fetching (ignoring the default source as well). "genericArtifact": { # Represents a generic artifact as a build dependency. # Represents a generic artifact as a build dependency. - "destPath": "A String", # Required. Where the artifact files should be placed on the worker. + "destPath": "A String", # Optional. Where the artifact files should be placed on the worker. Required when specified in `Build.dependencies`. "resource": "A String", # Required. The location to download the artifact files from. Ex: projects/p1/locations/us/repositories/r1/packages/p1/versions/v1 }, "gitSource": { # Represents a git repository as a build dependency. # Represents a git repository as a build dependency. @@ -3676,6 +3711,13 @@

Method Details

"uri": "A String", # URI of the uploaded artifact. }, ], + "resourceUsage": { # Aggregated/summary metrics over the entire build lifecycle. # Output only. Aggregated metrics for the build. + "averageCpuUtilization": 3.14, # Output only. The average CPU utilization ratio across all vCPUs over the duration of the build, expressed as a fraction in the range [0.0, 1.0]. + "averageMemoryUtilization": 3.14, # Output only. The average memory utilization ratio over the duration of the build, expressed as a fraction in the range [0.0, 1.0]. + "peakCpuUtilization": 3.14, # Output only. The highest CPU utilization ratio across all vCPUs observed over the duration of the build, expressed as a fraction in the range [0.0, 1.0]. + "peakMemoryUtilization": 3.14, # Output only. The highest memory utilization ratio observed over the duration of the build, expressed as a fraction in the range [0.0, 1.0]. + "totalCpuDuration": "A String", # Output only. Total CPU execution time consumed across all cores during build execution. + }, }, "secrets": [ # Secrets to decrypt using Cloud Key Management Service. Note: Secret Manager is the recommended technique for managing sensitive data with Cloud Build. Use `available_secrets` to configure builds to access secrets from Secret Manager. For instructions, see: https://cloud.google.com/cloud-build/docs/securing-builds/use-secrets { # Pairs a set of secret environment variables containing encrypted values with the Cloud KMS key to use to decrypt the value. Note: Use `kmsKeyName` with `available_secrets` instead of using `kmsKeyName` with `secret`. For instructions see: https://cloud.google.com/cloud-build/docs/securing-builds/use-encrypted-credentials. diff --git a/docs/dyn/cloudbuild_v1.projects.triggers.html b/docs/dyn/cloudbuild_v1.projects.triggers.html index 9bbd59ab64..e4d3d25ee1 100644 --- a/docs/dyn/cloudbuild_v1.projects.triggers.html +++ b/docs/dyn/cloudbuild_v1.projects.triggers.html @@ -259,7 +259,7 @@

Method Details

{ # A dependency that the Cloud Build worker will fetch before executing user steps. "empty": True or False, # If set to true disable all dependency fetching (ignoring the default source as well). "genericArtifact": { # Represents a generic artifact as a build dependency. # Represents a generic artifact as a build dependency. - "destPath": "A String", # Required. Where the artifact files should be placed on the worker. + "destPath": "A String", # Optional. Where the artifact files should be placed on the worker. Required when specified in `Build.dependencies`. "resource": "A String", # Required. The location to download the artifact files from. Ex: projects/p1/locations/us/repositories/r1/packages/p1/versions/v1 }, "gitSource": { # Represents a git repository as a build dependency. # Represents a git repository as a build dependency. @@ -462,6 +462,13 @@

Method Details

"uri": "A String", # URI of the uploaded artifact. }, ], + "resourceUsage": { # Aggregated/summary metrics over the entire build lifecycle. # Output only. Aggregated metrics for the build. + "averageCpuUtilization": 3.14, # Output only. The average CPU utilization ratio across all vCPUs over the duration of the build, expressed as a fraction in the range [0.0, 1.0]. + "averageMemoryUtilization": 3.14, # Output only. The average memory utilization ratio over the duration of the build, expressed as a fraction in the range [0.0, 1.0]. + "peakCpuUtilization": 3.14, # Output only. The highest CPU utilization ratio across all vCPUs observed over the duration of the build, expressed as a fraction in the range [0.0, 1.0]. + "peakMemoryUtilization": 3.14, # Output only. The highest memory utilization ratio observed over the duration of the build, expressed as a fraction in the range [0.0, 1.0]. + "totalCpuDuration": "A String", # Output only. Total CPU execution time consumed across all cores during build execution. + }, }, "secrets": [ # Secrets to decrypt using Cloud Key Management Service. Note: Secret Manager is the recommended technique for managing sensitive data with Cloud Build. Use `available_secrets` to configure builds to access secrets from Secret Manager. For instructions, see: https://cloud.google.com/cloud-build/docs/securing-builds/use-secrets { # Pairs a set of secret environment variables containing encrypted values with the Cloud KMS key to use to decrypt the value. Note: Use `kmsKeyName` with `available_secrets` instead of using `kmsKeyName` with `secret`. For instructions see: https://cloud.google.com/cloud-build/docs/securing-builds/use-encrypted-credentials. @@ -890,7 +897,7 @@

Method Details

{ # A dependency that the Cloud Build worker will fetch before executing user steps. "empty": True or False, # If set to true disable all dependency fetching (ignoring the default source as well). "genericArtifact": { # Represents a generic artifact as a build dependency. # Represents a generic artifact as a build dependency. - "destPath": "A String", # Required. Where the artifact files should be placed on the worker. + "destPath": "A String", # Optional. Where the artifact files should be placed on the worker. Required when specified in `Build.dependencies`. "resource": "A String", # Required. The location to download the artifact files from. Ex: projects/p1/locations/us/repositories/r1/packages/p1/versions/v1 }, "gitSource": { # Represents a git repository as a build dependency. # Represents a git repository as a build dependency. @@ -1093,6 +1100,13 @@

Method Details

"uri": "A String", # URI of the uploaded artifact. }, ], + "resourceUsage": { # Aggregated/summary metrics over the entire build lifecycle. # Output only. Aggregated metrics for the build. + "averageCpuUtilization": 3.14, # Output only. The average CPU utilization ratio across all vCPUs over the duration of the build, expressed as a fraction in the range [0.0, 1.0]. + "averageMemoryUtilization": 3.14, # Output only. The average memory utilization ratio over the duration of the build, expressed as a fraction in the range [0.0, 1.0]. + "peakCpuUtilization": 3.14, # Output only. The highest CPU utilization ratio across all vCPUs observed over the duration of the build, expressed as a fraction in the range [0.0, 1.0]. + "peakMemoryUtilization": 3.14, # Output only. The highest memory utilization ratio observed over the duration of the build, expressed as a fraction in the range [0.0, 1.0]. + "totalCpuDuration": "A String", # Output only. Total CPU execution time consumed across all cores during build execution. + }, }, "secrets": [ # Secrets to decrypt using Cloud Key Management Service. Note: Secret Manager is the recommended technique for managing sensitive data with Cloud Build. Use `available_secrets` to configure builds to access secrets from Secret Manager. For instructions, see: https://cloud.google.com/cloud-build/docs/securing-builds/use-secrets { # Pairs a set of secret environment variables containing encrypted values with the Cloud KMS key to use to decrypt the value. Note: Use `kmsKeyName` with `available_secrets` instead of using `kmsKeyName` with `secret`. For instructions see: https://cloud.google.com/cloud-build/docs/securing-builds/use-encrypted-credentials. @@ -1549,7 +1563,7 @@

Method Details

{ # A dependency that the Cloud Build worker will fetch before executing user steps. "empty": True or False, # If set to true disable all dependency fetching (ignoring the default source as well). "genericArtifact": { # Represents a generic artifact as a build dependency. # Represents a generic artifact as a build dependency. - "destPath": "A String", # Required. Where the artifact files should be placed on the worker. + "destPath": "A String", # Optional. Where the artifact files should be placed on the worker. Required when specified in `Build.dependencies`. "resource": "A String", # Required. The location to download the artifact files from. Ex: projects/p1/locations/us/repositories/r1/packages/p1/versions/v1 }, "gitSource": { # Represents a git repository as a build dependency. # Represents a git repository as a build dependency. @@ -1752,6 +1766,13 @@

Method Details

"uri": "A String", # URI of the uploaded artifact. }, ], + "resourceUsage": { # Aggregated/summary metrics over the entire build lifecycle. # Output only. Aggregated metrics for the build. + "averageCpuUtilization": 3.14, # Output only. The average CPU utilization ratio across all vCPUs over the duration of the build, expressed as a fraction in the range [0.0, 1.0]. + "averageMemoryUtilization": 3.14, # Output only. The average memory utilization ratio over the duration of the build, expressed as a fraction in the range [0.0, 1.0]. + "peakCpuUtilization": 3.14, # Output only. The highest CPU utilization ratio across all vCPUs observed over the duration of the build, expressed as a fraction in the range [0.0, 1.0]. + "peakMemoryUtilization": 3.14, # Output only. The highest memory utilization ratio observed over the duration of the build, expressed as a fraction in the range [0.0, 1.0]. + "totalCpuDuration": "A String", # Output only. Total CPU execution time consumed across all cores during build execution. + }, }, "secrets": [ # Secrets to decrypt using Cloud Key Management Service. Note: Secret Manager is the recommended technique for managing sensitive data with Cloud Build. Use `available_secrets` to configure builds to access secrets from Secret Manager. For instructions, see: https://cloud.google.com/cloud-build/docs/securing-builds/use-secrets { # Pairs a set of secret environment variables containing encrypted values with the Cloud KMS key to use to decrypt the value. Note: Use `kmsKeyName` with `available_secrets` instead of using `kmsKeyName` with `secret`. For instructions see: https://cloud.google.com/cloud-build/docs/securing-builds/use-encrypted-credentials. @@ -2192,7 +2213,7 @@

Method Details

{ # A dependency that the Cloud Build worker will fetch before executing user steps. "empty": True or False, # If set to true disable all dependency fetching (ignoring the default source as well). "genericArtifact": { # Represents a generic artifact as a build dependency. # Represents a generic artifact as a build dependency. - "destPath": "A String", # Required. Where the artifact files should be placed on the worker. + "destPath": "A String", # Optional. Where the artifact files should be placed on the worker. Required when specified in `Build.dependencies`. "resource": "A String", # Required. The location to download the artifact files from. Ex: projects/p1/locations/us/repositories/r1/packages/p1/versions/v1 }, "gitSource": { # Represents a git repository as a build dependency. # Represents a git repository as a build dependency. @@ -2395,6 +2416,13 @@

Method Details

"uri": "A String", # URI of the uploaded artifact. }, ], + "resourceUsage": { # Aggregated/summary metrics over the entire build lifecycle. # Output only. Aggregated metrics for the build. + "averageCpuUtilization": 3.14, # Output only. The average CPU utilization ratio across all vCPUs over the duration of the build, expressed as a fraction in the range [0.0, 1.0]. + "averageMemoryUtilization": 3.14, # Output only. The average memory utilization ratio over the duration of the build, expressed as a fraction in the range [0.0, 1.0]. + "peakCpuUtilization": 3.14, # Output only. The highest CPU utilization ratio across all vCPUs observed over the duration of the build, expressed as a fraction in the range [0.0, 1.0]. + "peakMemoryUtilization": 3.14, # Output only. The highest memory utilization ratio observed over the duration of the build, expressed as a fraction in the range [0.0, 1.0]. + "totalCpuDuration": "A String", # Output only. Total CPU execution time consumed across all cores during build execution. + }, }, "secrets": [ # Secrets to decrypt using Cloud Key Management Service. Note: Secret Manager is the recommended technique for managing sensitive data with Cloud Build. Use `available_secrets` to configure builds to access secrets from Secret Manager. For instructions, see: https://cloud.google.com/cloud-build/docs/securing-builds/use-secrets { # Pairs a set of secret environment variables containing encrypted values with the Cloud KMS key to use to decrypt the value. Note: Use `kmsKeyName` with `available_secrets` instead of using `kmsKeyName` with `secret`. For instructions see: https://cloud.google.com/cloud-build/docs/securing-builds/use-encrypted-credentials. @@ -2841,7 +2869,7 @@

Method Details

{ # A dependency that the Cloud Build worker will fetch before executing user steps. "empty": True or False, # If set to true disable all dependency fetching (ignoring the default source as well). "genericArtifact": { # Represents a generic artifact as a build dependency. # Represents a generic artifact as a build dependency. - "destPath": "A String", # Required. Where the artifact files should be placed on the worker. + "destPath": "A String", # Optional. Where the artifact files should be placed on the worker. Required when specified in `Build.dependencies`. "resource": "A String", # Required. The location to download the artifact files from. Ex: projects/p1/locations/us/repositories/r1/packages/p1/versions/v1 }, "gitSource": { # Represents a git repository as a build dependency. # Represents a git repository as a build dependency. @@ -3044,6 +3072,13 @@

Method Details

"uri": "A String", # URI of the uploaded artifact. }, ], + "resourceUsage": { # Aggregated/summary metrics over the entire build lifecycle. # Output only. Aggregated metrics for the build. + "averageCpuUtilization": 3.14, # Output only. The average CPU utilization ratio across all vCPUs over the duration of the build, expressed as a fraction in the range [0.0, 1.0]. + "averageMemoryUtilization": 3.14, # Output only. The average memory utilization ratio over the duration of the build, expressed as a fraction in the range [0.0, 1.0]. + "peakCpuUtilization": 3.14, # Output only. The highest CPU utilization ratio across all vCPUs observed over the duration of the build, expressed as a fraction in the range [0.0, 1.0]. + "peakMemoryUtilization": 3.14, # Output only. The highest memory utilization ratio observed over the duration of the build, expressed as a fraction in the range [0.0, 1.0]. + "totalCpuDuration": "A String", # Output only. Total CPU execution time consumed across all cores during build execution. + }, }, "secrets": [ # Secrets to decrypt using Cloud Key Management Service. Note: Secret Manager is the recommended technique for managing sensitive data with Cloud Build. Use `available_secrets` to configure builds to access secrets from Secret Manager. For instructions, see: https://cloud.google.com/cloud-build/docs/securing-builds/use-secrets { # Pairs a set of secret environment variables containing encrypted values with the Cloud KMS key to use to decrypt the value. Note: Use `kmsKeyName` with `available_secrets` instead of using `kmsKeyName` with `secret`. For instructions see: https://cloud.google.com/cloud-build/docs/securing-builds/use-encrypted-credentials. @@ -3472,7 +3507,7 @@

Method Details

{ # A dependency that the Cloud Build worker will fetch before executing user steps. "empty": True or False, # If set to true disable all dependency fetching (ignoring the default source as well). "genericArtifact": { # Represents a generic artifact as a build dependency. # Represents a generic artifact as a build dependency. - "destPath": "A String", # Required. Where the artifact files should be placed on the worker. + "destPath": "A String", # Optional. Where the artifact files should be placed on the worker. Required when specified in `Build.dependencies`. "resource": "A String", # Required. The location to download the artifact files from. Ex: projects/p1/locations/us/repositories/r1/packages/p1/versions/v1 }, "gitSource": { # Represents a git repository as a build dependency. # Represents a git repository as a build dependency. @@ -3675,6 +3710,13 @@

Method Details

"uri": "A String", # URI of the uploaded artifact. }, ], + "resourceUsage": { # Aggregated/summary metrics over the entire build lifecycle. # Output only. Aggregated metrics for the build. + "averageCpuUtilization": 3.14, # Output only. The average CPU utilization ratio across all vCPUs over the duration of the build, expressed as a fraction in the range [0.0, 1.0]. + "averageMemoryUtilization": 3.14, # Output only. The average memory utilization ratio over the duration of the build, expressed as a fraction in the range [0.0, 1.0]. + "peakCpuUtilization": 3.14, # Output only. The highest CPU utilization ratio across all vCPUs observed over the duration of the build, expressed as a fraction in the range [0.0, 1.0]. + "peakMemoryUtilization": 3.14, # Output only. The highest memory utilization ratio observed over the duration of the build, expressed as a fraction in the range [0.0, 1.0]. + "totalCpuDuration": "A String", # Output only. Total CPU execution time consumed across all cores during build execution. + }, }, "secrets": [ # Secrets to decrypt using Cloud Key Management Service. Note: Secret Manager is the recommended technique for managing sensitive data with Cloud Build. Use `available_secrets` to configure builds to access secrets from Secret Manager. For instructions, see: https://cloud.google.com/cloud-build/docs/securing-builds/use-secrets { # Pairs a set of secret environment variables containing encrypted values with the Cloud KMS key to use to decrypt the value. Note: Use `kmsKeyName` with `available_secrets` instead of using `kmsKeyName` with `secret`. For instructions see: https://cloud.google.com/cloud-build/docs/securing-builds/use-encrypted-credentials. diff --git a/googleapiclient/discovery_cache/documents/cloudbuild.v1.json b/googleapiclient/discovery_cache/documents/cloudbuild.v1.json index 51896bf0a7..5ee4f2ae4f 100644 --- a/googleapiclient/discovery_cache/documents/cloudbuild.v1.json +++ b/googleapiclient/discovery_cache/documents/cloudbuild.v1.json @@ -2324,7 +2324,7 @@ } } }, -"revision": "20260918", +"revision": "20261010", "rootUrl": "https://cloudbuild.googleapis.com/", "schemas": { "ApprovalConfig": { @@ -3089,11 +3089,13 @@ false "description": "Requested verifiability options.", "enum": [ "NOT_VERIFIED", -"VERIFIED" +"VERIFIED", +"BEST_EFFORT" ], "enumDescriptions": [ "Not a verifiable build (the default).", -"Build must be verified." +"Build must be verified.", +"Build verification is best effort. If provenance generation fails, the build will still succeed." ], "type": "string" }, @@ -3163,6 +3165,43 @@ false }, "type": "object" }, +"BuildResourceUsage": { +"description": "Aggregated/summary metrics over the entire build lifecycle.", +"id": "BuildResourceUsage", +"properties": { +"averageCpuUtilization": { +"description": "Output only. The average CPU utilization ratio across all vCPUs over the duration of the build, expressed as a fraction in the range [0.0, 1.0].", +"format": "float", +"readOnly": true, +"type": "number" +}, +"averageMemoryUtilization": { +"description": "Output only. The average memory utilization ratio over the duration of the build, expressed as a fraction in the range [0.0, 1.0].", +"format": "float", +"readOnly": true, +"type": "number" +}, +"peakCpuUtilization": { +"description": "Output only. The highest CPU utilization ratio across all vCPUs observed over the duration of the build, expressed as a fraction in the range [0.0, 1.0].", +"format": "float", +"readOnly": true, +"type": "number" +}, +"peakMemoryUtilization": { +"description": "Output only. The highest memory utilization ratio observed over the duration of the build, expressed as a fraction in the range [0.0, 1.0].", +"format": "float", +"readOnly": true, +"type": "number" +}, +"totalCpuDuration": { +"description": "Output only. Total CPU execution time consumed across all cores during build execution.", +"format": "google-duration", +"readOnly": true, +"type": "string" +} +}, +"type": "object" +}, "BuildStep": { "description": "A step in the build pipeline.", "id": "BuildStep", @@ -3858,7 +3897,7 @@ false "id": "GenericArtifactDependency", "properties": { "destPath": { -"description": "Required. Where the artifact files should be placed on the worker.", +"description": "Optional. Where the artifact files should be placed on the worker. Required when specified in `Build.dependencies`.", "type": "string" }, "resource": { @@ -4929,6 +4968,11 @@ false "$ref": "UploadedPythonPackage" }, "type": "array" +}, +"resourceUsage": { +"$ref": "BuildResourceUsage", +"description": "Output only. Aggregated metrics for the build.", +"readOnly": true } }, "type": "object" From bad3968455d598149bfae00038ed6616b4adc0f6 Mon Sep 17 00:00:00 2001 From: Yoshi Automation Date: Tue, 20 Oct 2026 07:23:59 +0000 Subject: [PATCH 07/34] feat(cloudresourcemanager): update the api #### cloudresourcemanager:v1 The following keys were added: - schemas.CreateSemanticTagBindingMetadata (Total Keys: 2) - schemas.CreateSemanticTagValueMetadata (Total Keys: 2) - schemas.DeleteSemanticTagBindingMetadata (Total Keys: 2) - schemas.DeleteSemanticTagValueMetadata (Total Keys: 2) #### cloudresourcemanager:v1beta1 The following keys were added: - schemas.CreateSemanticTagBindingMetadata (Total Keys: 2) - schemas.CreateSemanticTagValueMetadata (Total Keys: 2) - schemas.DeleteSemanticTagBindingMetadata (Total Keys: 2) - schemas.DeleteSemanticTagValueMetadata (Total Keys: 2) #### cloudresourcemanager:v2 The following keys were added: - schemas.CreateSemanticTagBindingMetadata (Total Keys: 2) - schemas.CreateSemanticTagValueMetadata (Total Keys: 2) - schemas.DeleteSemanticTagBindingMetadata (Total Keys: 2) - schemas.DeleteSemanticTagValueMetadata (Total Keys: 2) #### cloudresourcemanager:v2beta1 The following keys were added: - schemas.CreateSemanticTagBindingMetadata (Total Keys: 2) - schemas.CreateSemanticTagValueMetadata (Total Keys: 2) - schemas.DeleteSemanticTagBindingMetadata (Total Keys: 2) - schemas.DeleteSemanticTagValueMetadata (Total Keys: 2) #### cloudresourcemanager:v3 The following keys were added: - schemas.CreateSemanticTagBindingMetadata (Total Keys: 2) - schemas.CreateSemanticTagValueMetadata (Total Keys: 2) - schemas.DeleteSemanticTagBindingMetadata (Total Keys: 2) - schemas.DeleteSemanticTagValueMetadata (Total Keys: 2) --- .../documents/cloudresourcemanager.v1.json | 26 ++++++++++++++++++- .../cloudresourcemanager.v1beta1.json | 26 ++++++++++++++++++- .../documents/cloudresourcemanager.v2.json | 26 ++++++++++++++++++- .../cloudresourcemanager.v2beta1.json | 26 ++++++++++++++++++- .../documents/cloudresourcemanager.v3.json | 26 ++++++++++++++++++- 5 files changed, 125 insertions(+), 5 deletions(-) diff --git a/googleapiclient/discovery_cache/documents/cloudresourcemanager.v1.json b/googleapiclient/discovery_cache/documents/cloudresourcemanager.v1.json index 1984972b35..ae24ef45bc 100644 --- a/googleapiclient/discovery_cache/documents/cloudresourcemanager.v1.json +++ b/googleapiclient/discovery_cache/documents/cloudresourcemanager.v1.json @@ -1171,7 +1171,7 @@ } } }, -"revision": "20260820", +"revision": "20261011", "rootUrl": "https://cloudresourcemanager.googleapis.com/", "schemas": { "Ancestor": { @@ -1447,6 +1447,18 @@ }, "type": "object" }, +"CreateSemanticTagBindingMetadata": { +"description": "Metadata for the `CreateSemanticTagBinding` long-running operation.", +"id": "CreateSemanticTagBindingMetadata", +"properties": {}, +"type": "object" +}, +"CreateSemanticTagValueMetadata": { +"description": "Runtime operation information for creating a `SemanticTagValue`.", +"id": "CreateSemanticTagValueMetadata", +"properties": {}, +"type": "object" +}, "CreateTagBindingMetadata": { "description": "Runtime operation information for creating a TagValue.", "id": "CreateTagBindingMetadata", @@ -1495,6 +1507,18 @@ "properties": {}, "type": "object" }, +"DeleteSemanticTagBindingMetadata": { +"description": "Metadata for the `DeleteSemanticTagBinding` long-running operation.", +"id": "DeleteSemanticTagBindingMetadata", +"properties": {}, +"type": "object" +}, +"DeleteSemanticTagValueMetadata": { +"description": "Runtime operation information for deleting a `SemanticTagValue`.", +"id": "DeleteSemanticTagValueMetadata", +"properties": {}, +"type": "object" +}, "DeleteTagBindingMetadata": { "description": "Runtime operation information for deleting a TagBinding.", "id": "DeleteTagBindingMetadata", diff --git a/googleapiclient/discovery_cache/documents/cloudresourcemanager.v1beta1.json b/googleapiclient/discovery_cache/documents/cloudresourcemanager.v1beta1.json index 2687fda209..3c5214eb50 100644 --- a/googleapiclient/discovery_cache/documents/cloudresourcemanager.v1beta1.json +++ b/googleapiclient/discovery_cache/documents/cloudresourcemanager.v1beta1.json @@ -568,7 +568,7 @@ } } }, -"revision": "20260820", +"revision": "20261011", "rootUrl": "https://cloudresourcemanager.googleapis.com/", "schemas": { "Ancestor": { @@ -765,6 +765,18 @@ }, "type": "object" }, +"CreateSemanticTagBindingMetadata": { +"description": "Metadata for the `CreateSemanticTagBinding` long-running operation.", +"id": "CreateSemanticTagBindingMetadata", +"properties": {}, +"type": "object" +}, +"CreateSemanticTagValueMetadata": { +"description": "Runtime operation information for creating a `SemanticTagValue`.", +"id": "CreateSemanticTagValueMetadata", +"properties": {}, +"type": "object" +}, "CreateTagBindingMetadata": { "description": "Runtime operation information for creating a TagValue.", "id": "CreateTagBindingMetadata", @@ -813,6 +825,18 @@ "properties": {}, "type": "object" }, +"DeleteSemanticTagBindingMetadata": { +"description": "Metadata for the `DeleteSemanticTagBinding` long-running operation.", +"id": "DeleteSemanticTagBindingMetadata", +"properties": {}, +"type": "object" +}, +"DeleteSemanticTagValueMetadata": { +"description": "Runtime operation information for deleting a `SemanticTagValue`.", +"id": "DeleteSemanticTagValueMetadata", +"properties": {}, +"type": "object" +}, "DeleteTagBindingMetadata": { "description": "Runtime operation information for deleting a TagBinding.", "id": "DeleteTagBindingMetadata", diff --git a/googleapiclient/discovery_cache/documents/cloudresourcemanager.v2.json b/googleapiclient/discovery_cache/documents/cloudresourcemanager.v2.json index 036e0df5c4..687aebafa4 100644 --- a/googleapiclient/discovery_cache/documents/cloudresourcemanager.v2.json +++ b/googleapiclient/discovery_cache/documents/cloudresourcemanager.v2.json @@ -450,7 +450,7 @@ } } }, -"revision": "20260820", +"revision": "20261011", "rootUrl": "https://cloudresourcemanager.googleapis.com/", "schemas": { "AuditConfig": { @@ -636,6 +636,18 @@ }, "type": "object" }, +"CreateSemanticTagBindingMetadata": { +"description": "Metadata for the `CreateSemanticTagBinding` long-running operation.", +"id": "CreateSemanticTagBindingMetadata", +"properties": {}, +"type": "object" +}, +"CreateSemanticTagValueMetadata": { +"description": "Runtime operation information for creating a `SemanticTagValue`.", +"id": "CreateSemanticTagValueMetadata", +"properties": {}, +"type": "object" +}, "CreateTagBindingMetadata": { "description": "Runtime operation information for creating a TagValue.", "id": "CreateTagBindingMetadata", @@ -684,6 +696,18 @@ "properties": {}, "type": "object" }, +"DeleteSemanticTagBindingMetadata": { +"description": "Metadata for the `DeleteSemanticTagBinding` long-running operation.", +"id": "DeleteSemanticTagBindingMetadata", +"properties": {}, +"type": "object" +}, +"DeleteSemanticTagValueMetadata": { +"description": "Runtime operation information for deleting a `SemanticTagValue`.", +"id": "DeleteSemanticTagValueMetadata", +"properties": {}, +"type": "object" +}, "DeleteTagBindingMetadata": { "description": "Runtime operation information for deleting a TagBinding.", "id": "DeleteTagBindingMetadata", diff --git a/googleapiclient/discovery_cache/documents/cloudresourcemanager.v2beta1.json b/googleapiclient/discovery_cache/documents/cloudresourcemanager.v2beta1.json index 7046f4f05f..7353bb9bd2 100644 --- a/googleapiclient/discovery_cache/documents/cloudresourcemanager.v2beta1.json +++ b/googleapiclient/discovery_cache/documents/cloudresourcemanager.v2beta1.json @@ -450,7 +450,7 @@ } } }, -"revision": "20260820", +"revision": "20261011", "rootUrl": "https://cloudresourcemanager.googleapis.com/", "schemas": { "AuditConfig": { @@ -636,6 +636,18 @@ }, "type": "object" }, +"CreateSemanticTagBindingMetadata": { +"description": "Metadata for the `CreateSemanticTagBinding` long-running operation.", +"id": "CreateSemanticTagBindingMetadata", +"properties": {}, +"type": "object" +}, +"CreateSemanticTagValueMetadata": { +"description": "Runtime operation information for creating a `SemanticTagValue`.", +"id": "CreateSemanticTagValueMetadata", +"properties": {}, +"type": "object" +}, "CreateTagBindingMetadata": { "description": "Runtime operation information for creating a TagValue.", "id": "CreateTagBindingMetadata", @@ -684,6 +696,18 @@ "properties": {}, "type": "object" }, +"DeleteSemanticTagBindingMetadata": { +"description": "Metadata for the `DeleteSemanticTagBinding` long-running operation.", +"id": "DeleteSemanticTagBindingMetadata", +"properties": {}, +"type": "object" +}, +"DeleteSemanticTagValueMetadata": { +"description": "Runtime operation information for deleting a `SemanticTagValue`.", +"id": "DeleteSemanticTagValueMetadata", +"properties": {}, +"type": "object" +}, "DeleteTagBindingMetadata": { "description": "Runtime operation information for deleting a TagBinding.", "id": "DeleteTagBindingMetadata", diff --git a/googleapiclient/discovery_cache/documents/cloudresourcemanager.v3.json b/googleapiclient/discovery_cache/documents/cloudresourcemanager.v3.json index 4abc02bbeb..81f5581c98 100644 --- a/googleapiclient/discovery_cache/documents/cloudresourcemanager.v3.json +++ b/googleapiclient/discovery_cache/documents/cloudresourcemanager.v3.json @@ -2475,7 +2475,7 @@ } } }, -"revision": "20260917", +"revision": "20261011", "rootUrl": "https://cloudresourcemanager.googleapis.com/", "schemas": { "AuditConfig": { @@ -2748,6 +2748,18 @@ }, "type": "object" }, +"CreateSemanticTagBindingMetadata": { +"description": "Metadata for the `CreateSemanticTagBinding` long-running operation.", +"id": "CreateSemanticTagBindingMetadata", +"properties": {}, +"type": "object" +}, +"CreateSemanticTagValueMetadata": { +"description": "Runtime operation information for creating a `SemanticTagValue`.", +"id": "CreateSemanticTagValueMetadata", +"properties": {}, +"type": "object" +}, "CreateTagBindingMetadata": { "description": "Runtime operation information for creating a TagValue.", "id": "CreateTagBindingMetadata", @@ -2796,6 +2808,18 @@ "properties": {}, "type": "object" }, +"DeleteSemanticTagBindingMetadata": { +"description": "Metadata for the `DeleteSemanticTagBinding` long-running operation.", +"id": "DeleteSemanticTagBindingMetadata", +"properties": {}, +"type": "object" +}, +"DeleteSemanticTagValueMetadata": { +"description": "Runtime operation information for deleting a `SemanticTagValue`.", +"id": "DeleteSemanticTagValueMetadata", +"properties": {}, +"type": "object" +}, "DeleteTagBindingMetadata": { "description": "Runtime operation information for deleting a TagBinding.", "id": "DeleteTagBindingMetadata", From 367e21071f9644121f666cc01a1337b222ae985b Mon Sep 17 00:00:00 2001 From: Yoshi Automation Date: Tue, 20 Oct 2026 07:24:00 +0000 Subject: [PATCH 08/34] feat(composer): update the api #### composer:v1 The following keys were added: - schemas.ImageVersionRollbackTarget (Total Keys: 7) - schemas.SoftwareConfig.properties.imageVersionRollbackTargets (Total Keys: 3) The following keys were changed: - endpoints (Total Keys: 1) #### composer:v1beta1 The following keys were added: - schemas.ImageVersionRollbackTarget (Total Keys: 7) - schemas.SoftwareConfig.properties.imageVersionRollbackTargets (Total Keys: 3) The following keys were changed: - endpoints (Total Keys: 1) --- ...er_v1.projects.locations.environments.html | 24 ++ ...beta1.projects.locations.environments.html | 24 ++ .../documents/composer.v1.json | 253 +++++++++++++++++- .../documents/composer.v1beta1.json | 253 +++++++++++++++++- 4 files changed, 552 insertions(+), 2 deletions(-) diff --git a/docs/dyn/composer_v1.projects.locations.environments.html b/docs/dyn/composer_v1.projects.locations.environments.html index f5ed56fa5a..426cbb85ba 100644 --- a/docs/dyn/composer_v1.projects.locations.environments.html +++ b/docs/dyn/composer_v1.projects.locations.environments.html @@ -297,6 +297,12 @@

Method Details

"a_key": "A String", }, "imageVersion": "A String", # Optional. The version of the software running in the environment. This encapsulates both the version of Cloud Composer functionality and the version of Apache Airflow. It must match the regular expression `composer-([0-9]+(\.[0-9]+\.[0-9]+(-preview\.[0-9]+)?)?|latest)-airflow-([0-9]+(\.[0-9]+(\.[0-9]+)?)?)`. When used as input, the server also checks if the provided version is supported and denies the request for an unsupported version. The Cloud Composer portion of the image version is a full [semantic version](https://semver.org), or an alias in the form of major version number or `latest`. When an alias is provided, the server replaces it with the current Cloud Composer version that satisfies the alias. The Apache Airflow portion of the image version is a full semantic version that points to one of the supported Apache Airflow versions, or an alias in the form of only major or major.minor versions specified. When an alias is provided, the server replaces it with the latest Apache Airflow version that satisfies the alias and is supported in the given Cloud Composer version. In all cases, the resolved image version is stored in the same field. See also [version list](/composer/docs/concepts/versioning/composer-versions) and [versioning overview](/composer/docs/concepts/versioning/composer-versioning-overview). + "imageVersionRollbackTargets": [ # Output only. The list of image versions the environment can be rolled back to, sorted by last_active_time in descending order (most recent first). This field is supported for Cloud Composer environments in versions composer-3-airflow-*.*.*-build.* and newer. + { # The image version an environment can be rolled back to. + "imageVersion": "A String", # Output only. The image version the environment can be rolled back to. + "lastActiveTime": "A String", # Output only. The last time when the environment was running this image version. + }, + ], "pypiPackages": { # Optional. Custom Python Package Index (PyPI) packages to be installed in the environment. Keys refer to the lowercase package name such as "numpy" and values are the lowercase extras and version specifier such as "==1.12.0", "[devel,gcp_api]", or "[devel]>=1.8.2, <1.9.2". To specify a package without pinning it to a version specifier, use the empty string as the value. "a_key": "A String", }, @@ -639,6 +645,12 @@

Method Details

"a_key": "A String", }, "imageVersion": "A String", # Optional. The version of the software running in the environment. This encapsulates both the version of Cloud Composer functionality and the version of Apache Airflow. It must match the regular expression `composer-([0-9]+(\.[0-9]+\.[0-9]+(-preview\.[0-9]+)?)?|latest)-airflow-([0-9]+(\.[0-9]+(\.[0-9]+)?)?)`. When used as input, the server also checks if the provided version is supported and denies the request for an unsupported version. The Cloud Composer portion of the image version is a full [semantic version](https://semver.org), or an alias in the form of major version number or `latest`. When an alias is provided, the server replaces it with the current Cloud Composer version that satisfies the alias. The Apache Airflow portion of the image version is a full semantic version that points to one of the supported Apache Airflow versions, or an alias in the form of only major or major.minor versions specified. When an alias is provided, the server replaces it with the latest Apache Airflow version that satisfies the alias and is supported in the given Cloud Composer version. In all cases, the resolved image version is stored in the same field. See also [version list](/composer/docs/concepts/versioning/composer-versions) and [versioning overview](/composer/docs/concepts/versioning/composer-versioning-overview). + "imageVersionRollbackTargets": [ # Output only. The list of image versions the environment can be rolled back to, sorted by last_active_time in descending order (most recent first). This field is supported for Cloud Composer environments in versions composer-3-airflow-*.*.*-build.* and newer. + { # The image version an environment can be rolled back to. + "imageVersion": "A String", # Output only. The image version the environment can be rolled back to. + "lastActiveTime": "A String", # Output only. The last time when the environment was running this image version. + }, + ], "pypiPackages": { # Optional. Custom Python Package Index (PyPI) packages to be installed in the environment. Keys refer to the lowercase package name such as "numpy" and values are the lowercase extras and version specifier such as "==1.12.0", "[devel,gcp_api]", or "[devel]>=1.8.2, <1.9.2". To specify a package without pinning it to a version specifier, use the empty string as the value. "a_key": "A String", }, @@ -827,6 +839,12 @@

Method Details

"a_key": "A String", }, "imageVersion": "A String", # Optional. The version of the software running in the environment. This encapsulates both the version of Cloud Composer functionality and the version of Apache Airflow. It must match the regular expression `composer-([0-9]+(\.[0-9]+\.[0-9]+(-preview\.[0-9]+)?)?|latest)-airflow-([0-9]+(\.[0-9]+(\.[0-9]+)?)?)`. When used as input, the server also checks if the provided version is supported and denies the request for an unsupported version. The Cloud Composer portion of the image version is a full [semantic version](https://semver.org), or an alias in the form of major version number or `latest`. When an alias is provided, the server replaces it with the current Cloud Composer version that satisfies the alias. The Apache Airflow portion of the image version is a full semantic version that points to one of the supported Apache Airflow versions, or an alias in the form of only major or major.minor versions specified. When an alias is provided, the server replaces it with the latest Apache Airflow version that satisfies the alias and is supported in the given Cloud Composer version. In all cases, the resolved image version is stored in the same field. See also [version list](/composer/docs/concepts/versioning/composer-versions) and [versioning overview](/composer/docs/concepts/versioning/composer-versioning-overview). + "imageVersionRollbackTargets": [ # Output only. The list of image versions the environment can be rolled back to, sorted by last_active_time in descending order (most recent first). This field is supported for Cloud Composer environments in versions composer-3-airflow-*.*.*-build.* and newer. + { # The image version an environment can be rolled back to. + "imageVersion": "A String", # Output only. The image version the environment can be rolled back to. + "lastActiveTime": "A String", # Output only. The last time when the environment was running this image version. + }, + ], "pypiPackages": { # Optional. Custom Python Package Index (PyPI) packages to be installed in the environment. Keys refer to the lowercase package name such as "numpy" and values are the lowercase extras and version specifier such as "==1.12.0", "[devel,gcp_api]", or "[devel]>=1.8.2, <1.9.2". To specify a package without pinning it to a version specifier, use the empty string as the value. "a_key": "A String", }, @@ -1069,6 +1087,12 @@

Method Details

"a_key": "A String", }, "imageVersion": "A String", # Optional. The version of the software running in the environment. This encapsulates both the version of Cloud Composer functionality and the version of Apache Airflow. It must match the regular expression `composer-([0-9]+(\.[0-9]+\.[0-9]+(-preview\.[0-9]+)?)?|latest)-airflow-([0-9]+(\.[0-9]+(\.[0-9]+)?)?)`. When used as input, the server also checks if the provided version is supported and denies the request for an unsupported version. The Cloud Composer portion of the image version is a full [semantic version](https://semver.org), or an alias in the form of major version number or `latest`. When an alias is provided, the server replaces it with the current Cloud Composer version that satisfies the alias. The Apache Airflow portion of the image version is a full semantic version that points to one of the supported Apache Airflow versions, or an alias in the form of only major or major.minor versions specified. When an alias is provided, the server replaces it with the latest Apache Airflow version that satisfies the alias and is supported in the given Cloud Composer version. In all cases, the resolved image version is stored in the same field. See also [version list](/composer/docs/concepts/versioning/composer-versions) and [versioning overview](/composer/docs/concepts/versioning/composer-versioning-overview). + "imageVersionRollbackTargets": [ # Output only. The list of image versions the environment can be rolled back to, sorted by last_active_time in descending order (most recent first). This field is supported for Cloud Composer environments in versions composer-3-airflow-*.*.*-build.* and newer. + { # The image version an environment can be rolled back to. + "imageVersion": "A String", # Output only. The image version the environment can be rolled back to. + "lastActiveTime": "A String", # Output only. The last time when the environment was running this image version. + }, + ], "pypiPackages": { # Optional. Custom Python Package Index (PyPI) packages to be installed in the environment. Keys refer to the lowercase package name such as "numpy" and values are the lowercase extras and version specifier such as "==1.12.0", "[devel,gcp_api]", or "[devel]>=1.8.2, <1.9.2". To specify a package without pinning it to a version specifier, use the empty string as the value. "a_key": "A String", }, diff --git a/docs/dyn/composer_v1beta1.projects.locations.environments.html b/docs/dyn/composer_v1beta1.projects.locations.environments.html index dd9896e2a4..e2a79851a7 100644 --- a/docs/dyn/composer_v1beta1.projects.locations.environments.html +++ b/docs/dyn/composer_v1beta1.projects.locations.environments.html @@ -308,6 +308,12 @@

Method Details

"a_key": "A String", }, "imageVersion": "A String", # Optional. The version of the software running in the environment. This encapsulates both the version of Cloud Composer functionality and the version of Apache Airflow. It must match the regular expression `composer-([0-9]+(\.[0-9]+\.[0-9]+(-preview\.[0-9]+)?)?|latest)-airflow-([0-9]+(\.[0-9]+(\.[0-9]+)?)?)`. When used as input, the server also checks if the provided version is supported and denies the request for an unsupported version. The Cloud Composer portion of the image version is a full [semantic version](https://semver.org), or an alias in the form of major version number or `latest`. When an alias is provided, the server replaces it with the current Cloud Composer version that satisfies the alias. The Apache Airflow portion of the image version is a full semantic version that points to one of the supported Apache Airflow versions, or an alias in the form of only major or major.minor versions specified. When an alias is provided, the server replaces it with the latest Apache Airflow version that satisfies the alias and is supported in the given Cloud Composer version. In all cases, the resolved image version is stored in the same field. See also [version list](/composer/docs/concepts/versioning/composer-versions) and [versioning overview](/composer/docs/concepts/versioning/composer-versioning-overview). + "imageVersionRollbackTargets": [ # Output only. The list of image versions the environment can be rolled back to, sorted by last_active_time in descending order (most recent first). This field is supported for Cloud Composer environments in versions composer-3-airflow-*.*.*-build.* and newer. + { # The image version an environment can be rolled back to. + "imageVersion": "A String", # Output only. The image version the environment can be rolled back to. + "lastActiveTime": "A String", # Output only. The last time when the environment was running this image version. + }, + ], "pypiPackages": { # Optional. Custom Python Package Index (PyPI) packages to be installed in the environment. Keys refer to the lowercase package name such as "numpy" and values are the lowercase extras and version specifier such as "==1.12.0", "[devel,gcp_api]", or "[devel]>=1.8.2, <1.9.2". To specify a package without pinning it to a version specifier, use the empty string as the value. "a_key": "A String", }, @@ -655,6 +661,12 @@

Method Details

"a_key": "A String", }, "imageVersion": "A String", # Optional. The version of the software running in the environment. This encapsulates both the version of Cloud Composer functionality and the version of Apache Airflow. It must match the regular expression `composer-([0-9]+(\.[0-9]+\.[0-9]+(-preview\.[0-9]+)?)?|latest)-airflow-([0-9]+(\.[0-9]+(\.[0-9]+)?)?)`. When used as input, the server also checks if the provided version is supported and denies the request for an unsupported version. The Cloud Composer portion of the image version is a full [semantic version](https://semver.org), or an alias in the form of major version number or `latest`. When an alias is provided, the server replaces it with the current Cloud Composer version that satisfies the alias. The Apache Airflow portion of the image version is a full semantic version that points to one of the supported Apache Airflow versions, or an alias in the form of only major or major.minor versions specified. When an alias is provided, the server replaces it with the latest Apache Airflow version that satisfies the alias and is supported in the given Cloud Composer version. In all cases, the resolved image version is stored in the same field. See also [version list](/composer/docs/concepts/versioning/composer-versions) and [versioning overview](/composer/docs/concepts/versioning/composer-versioning-overview). + "imageVersionRollbackTargets": [ # Output only. The list of image versions the environment can be rolled back to, sorted by last_active_time in descending order (most recent first). This field is supported for Cloud Composer environments in versions composer-3-airflow-*.*.*-build.* and newer. + { # The image version an environment can be rolled back to. + "imageVersion": "A String", # Output only. The image version the environment can be rolled back to. + "lastActiveTime": "A String", # Output only. The last time when the environment was running this image version. + }, + ], "pypiPackages": { # Optional. Custom Python Package Index (PyPI) packages to be installed in the environment. Keys refer to the lowercase package name such as "numpy" and values are the lowercase extras and version specifier such as "==1.12.0", "[devel,gcp_api]", or "[devel]>=1.8.2, <1.9.2". To specify a package without pinning it to a version specifier, use the empty string as the value. "a_key": "A String", }, @@ -889,6 +901,12 @@

Method Details

"a_key": "A String", }, "imageVersion": "A String", # Optional. The version of the software running in the environment. This encapsulates both the version of Cloud Composer functionality and the version of Apache Airflow. It must match the regular expression `composer-([0-9]+(\.[0-9]+\.[0-9]+(-preview\.[0-9]+)?)?|latest)-airflow-([0-9]+(\.[0-9]+(\.[0-9]+)?)?)`. When used as input, the server also checks if the provided version is supported and denies the request for an unsupported version. The Cloud Composer portion of the image version is a full [semantic version](https://semver.org), or an alias in the form of major version number or `latest`. When an alias is provided, the server replaces it with the current Cloud Composer version that satisfies the alias. The Apache Airflow portion of the image version is a full semantic version that points to one of the supported Apache Airflow versions, or an alias in the form of only major or major.minor versions specified. When an alias is provided, the server replaces it with the latest Apache Airflow version that satisfies the alias and is supported in the given Cloud Composer version. In all cases, the resolved image version is stored in the same field. See also [version list](/composer/docs/concepts/versioning/composer-versions) and [versioning overview](/composer/docs/concepts/versioning/composer-versioning-overview). + "imageVersionRollbackTargets": [ # Output only. The list of image versions the environment can be rolled back to, sorted by last_active_time in descending order (most recent first). This field is supported for Cloud Composer environments in versions composer-3-airflow-*.*.*-build.* and newer. + { # The image version an environment can be rolled back to. + "imageVersion": "A String", # Output only. The image version the environment can be rolled back to. + "lastActiveTime": "A String", # Output only. The last time when the environment was running this image version. + }, + ], "pypiPackages": { # Optional. Custom Python Package Index (PyPI) packages to be installed in the environment. Keys refer to the lowercase package name such as "numpy" and values are the lowercase extras and version specifier such as "==1.12.0", "[devel,gcp_api]", or "[devel]>=1.8.2, <1.9.2". To specify a package without pinning it to a version specifier, use the empty string as the value. "a_key": "A String", }, @@ -1136,6 +1154,12 @@

Method Details

"a_key": "A String", }, "imageVersion": "A String", # Optional. The version of the software running in the environment. This encapsulates both the version of Cloud Composer functionality and the version of Apache Airflow. It must match the regular expression `composer-([0-9]+(\.[0-9]+\.[0-9]+(-preview\.[0-9]+)?)?|latest)-airflow-([0-9]+(\.[0-9]+(\.[0-9]+)?)?)`. When used as input, the server also checks if the provided version is supported and denies the request for an unsupported version. The Cloud Composer portion of the image version is a full [semantic version](https://semver.org), or an alias in the form of major version number or `latest`. When an alias is provided, the server replaces it with the current Cloud Composer version that satisfies the alias. The Apache Airflow portion of the image version is a full semantic version that points to one of the supported Apache Airflow versions, or an alias in the form of only major or major.minor versions specified. When an alias is provided, the server replaces it with the latest Apache Airflow version that satisfies the alias and is supported in the given Cloud Composer version. In all cases, the resolved image version is stored in the same field. See also [version list](/composer/docs/concepts/versioning/composer-versions) and [versioning overview](/composer/docs/concepts/versioning/composer-versioning-overview). + "imageVersionRollbackTargets": [ # Output only. The list of image versions the environment can be rolled back to, sorted by last_active_time in descending order (most recent first). This field is supported for Cloud Composer environments in versions composer-3-airflow-*.*.*-build.* and newer. + { # The image version an environment can be rolled back to. + "imageVersion": "A String", # Output only. The image version the environment can be rolled back to. + "lastActiveTime": "A String", # Output only. The last time when the environment was running this image version. + }, + ], "pypiPackages": { # Optional. Custom Python Package Index (PyPI) packages to be installed in the environment. Keys refer to the lowercase package name such as "numpy" and values are the lowercase extras and version specifier such as "==1.12.0", "[devel,gcp_api]", or "[devel]>=1.8.2, <1.9.2". To specify a package without pinning it to a version specifier, use the empty string as the value. "a_key": "A String", }, diff --git a/googleapiclient/discovery_cache/documents/composer.v1.json b/googleapiclient/discovery_cache/documents/composer.v1.json index 063698bcb1..69ee1f9ccb 100644 --- a/googleapiclient/discovery_cache/documents/composer.v1.json +++ b/googleapiclient/discovery_cache/documents/composer.v1.json @@ -251,6 +251,231 @@ "description": "Regional Endpoint", "endpointUrl": "https://composer.us-west8.rep.googleapis.com/", "location": "us-west8" +}, +{ +"description": "Locational Endpoint", +"endpointUrl": "https://africa-south1-composer.googleapis.com/", +"location": "africa-south1" +}, +{ +"description": "Locational Endpoint", +"endpointUrl": "https://asia-east1-composer.googleapis.com/", +"location": "asia-east1" +}, +{ +"description": "Locational Endpoint", +"endpointUrl": "https://asia-east2-composer.googleapis.com/", +"location": "asia-east2" +}, +{ +"description": "Locational Endpoint", +"endpointUrl": "https://asia-northeast1-composer.googleapis.com/", +"location": "asia-northeast1" +}, +{ +"description": "Locational Endpoint", +"endpointUrl": "https://asia-northeast2-composer.googleapis.com/", +"location": "asia-northeast2" +}, +{ +"description": "Locational Endpoint", +"endpointUrl": "https://asia-northeast3-composer.googleapis.com/", +"location": "asia-northeast3" +}, +{ +"description": "Locational Endpoint", +"endpointUrl": "https://asia-south1-composer.googleapis.com/", +"location": "asia-south1" +}, +{ +"description": "Locational Endpoint", +"endpointUrl": "https://asia-south2-composer.googleapis.com/", +"location": "asia-south2" +}, +{ +"description": "Locational Endpoint", +"endpointUrl": "https://asia-southeast1-composer.googleapis.com/", +"location": "asia-southeast1" +}, +{ +"description": "Locational Endpoint", +"endpointUrl": "https://asia-southeast2-composer.googleapis.com/", +"location": "asia-southeast2" +}, +{ +"description": "Locational Endpoint", +"endpointUrl": "https://asia-southeast3-composer.googleapis.com/", +"location": "asia-southeast3" +}, +{ +"description": "Locational Endpoint", +"endpointUrl": "https://australia-southeast1-composer.googleapis.com/", +"location": "australia-southeast1" +}, +{ +"description": "Locational Endpoint", +"endpointUrl": "https://australia-southeast2-composer.googleapis.com/", +"location": "australia-southeast2" +}, +{ +"description": "Locational Endpoint", +"endpointUrl": "https://europe-central2-composer.googleapis.com/", +"location": "europe-central2" +}, +{ +"description": "Locational Endpoint", +"endpointUrl": "https://europe-north1-composer.googleapis.com/", +"location": "europe-north1" +}, +{ +"description": "Locational Endpoint", +"endpointUrl": "https://europe-north2-composer.googleapis.com/", +"location": "europe-north2" +}, +{ +"description": "Locational Endpoint", +"endpointUrl": "https://europe-southwest1-composer.googleapis.com/", +"location": "europe-southwest1" +}, +{ +"description": "Locational Endpoint", +"endpointUrl": "https://europe-west1-composer.googleapis.com/", +"location": "europe-west1" +}, +{ +"description": "Locational Endpoint", +"endpointUrl": "https://europe-west10-composer.googleapis.com/", +"location": "europe-west10" +}, +{ +"description": "Locational Endpoint", +"endpointUrl": "https://europe-west12-composer.googleapis.com/", +"location": "europe-west12" +}, +{ +"description": "Locational Endpoint", +"endpointUrl": "https://europe-west15-composer.googleapis.com/", +"location": "europe-west15" +}, +{ +"description": "Locational Endpoint", +"endpointUrl": "https://europe-west2-composer.googleapis.com/", +"location": "europe-west2" +}, +{ +"description": "Locational Endpoint", +"endpointUrl": "https://europe-west3-composer.googleapis.com/", +"location": "europe-west3" +}, +{ +"description": "Locational Endpoint", +"endpointUrl": "https://europe-west4-composer.googleapis.com/", +"location": "europe-west4" +}, +{ +"description": "Locational Endpoint", +"endpointUrl": "https://europe-west6-composer.googleapis.com/", +"location": "europe-west6" +}, +{ +"description": "Locational Endpoint", +"endpointUrl": "https://europe-west8-composer.googleapis.com/", +"location": "europe-west8" +}, +{ +"description": "Locational Endpoint", +"endpointUrl": "https://europe-west9-composer.googleapis.com/", +"location": "europe-west9" +}, +{ +"description": "Locational Endpoint", +"endpointUrl": "https://me-central1-composer.googleapis.com/", +"location": "me-central1" +}, +{ +"description": "Locational Endpoint", +"endpointUrl": "https://me-central2-composer.googleapis.com/", +"location": "me-central2" +}, +{ +"description": "Locational Endpoint", +"endpointUrl": "https://me-west1-composer.googleapis.com/", +"location": "me-west1" +}, +{ +"description": "Locational Endpoint", +"endpointUrl": "https://northamerica-northeast1-composer.googleapis.com/", +"location": "northamerica-northeast1" +}, +{ +"description": "Locational Endpoint", +"endpointUrl": "https://northamerica-northeast2-composer.googleapis.com/", +"location": "northamerica-northeast2" +}, +{ +"description": "Locational Endpoint", +"endpointUrl": "https://northamerica-south1-composer.googleapis.com/", +"location": "northamerica-south1" +}, +{ +"description": "Locational Endpoint", +"endpointUrl": "https://southamerica-east1-composer.googleapis.com/", +"location": "southamerica-east1" +}, +{ +"description": "Locational Endpoint", +"endpointUrl": "https://southamerica-west1-composer.googleapis.com/", +"location": "southamerica-west1" +}, +{ +"description": "Locational Endpoint", +"endpointUrl": "https://us-central1-composer.googleapis.com/", +"location": "us-central1" +}, +{ +"description": "Locational Endpoint", +"endpointUrl": "https://us-east1-composer.googleapis.com/", +"location": "us-east1" +}, +{ +"description": "Locational Endpoint", +"endpointUrl": "https://us-east4-composer.googleapis.com/", +"location": "us-east4" +}, +{ +"description": "Locational Endpoint", +"endpointUrl": "https://us-east5-composer.googleapis.com/", +"location": "us-east5" +}, +{ +"description": "Locational Endpoint", +"endpointUrl": "https://us-east7-composer.googleapis.com/", +"location": "us-east7" +}, +{ +"description": "Locational Endpoint", +"endpointUrl": "https://us-south1-composer.googleapis.com/", +"location": "us-south1" +}, +{ +"description": "Locational Endpoint", +"endpointUrl": "https://us-west1-composer.googleapis.com/", +"location": "us-west1" +}, +{ +"description": "Locational Endpoint", +"endpointUrl": "https://us-west2-composer.googleapis.com/", +"location": "us-west2" +}, +{ +"description": "Locational Endpoint", +"endpointUrl": "https://us-west3-composer.googleapis.com/", +"location": "us-west3" +}, +{ +"description": "Locational Endpoint", +"endpointUrl": "https://us-west4-composer.googleapis.com/", +"location": "us-west4" } ], "fullyEncodeReservedExpansion": true, @@ -1278,7 +1503,7 @@ } } }, -"revision": "20260825", +"revision": "20261011", "rootUrl": "https://composer.googleapis.com/", "schemas": { "AirflowMetadataRetentionPolicyConfig": { @@ -1957,6 +2182,24 @@ }, "type": "object" }, +"ImageVersionRollbackTarget": { +"description": "The image version an environment can be rolled back to.", +"id": "ImageVersionRollbackTarget", +"properties": { +"imageVersion": { +"description": "Output only. The image version the environment can be rolled back to.", +"readOnly": true, +"type": "string" +}, +"lastActiveTime": { +"description": "Output only. The last time when the environment was running this image version.", +"format": "google-datetime", +"readOnly": true, +"type": "string" +} +}, +"type": "object" +}, "Line": { "description": "Contains information about a single line from logs.", "id": "Line", @@ -2615,6 +2858,14 @@ "description": "Optional. The version of the software running in the environment. This encapsulates both the version of Cloud Composer functionality and the version of Apache Airflow. It must match the regular expression `composer-([0-9]+(\\.[0-9]+\\.[0-9]+(-preview\\.[0-9]+)?)?|latest)-airflow-([0-9]+(\\.[0-9]+(\\.[0-9]+)?)?)`. When used as input, the server also checks if the provided version is supported and denies the request for an unsupported version. The Cloud Composer portion of the image version is a full [semantic version](https://semver.org), or an alias in the form of major version number or `latest`. When an alias is provided, the server replaces it with the current Cloud Composer version that satisfies the alias. The Apache Airflow portion of the image version is a full semantic version that points to one of the supported Apache Airflow versions, or an alias in the form of only major or major.minor versions specified. When an alias is provided, the server replaces it with the latest Apache Airflow version that satisfies the alias and is supported in the given Cloud Composer version. In all cases, the resolved image version is stored in the same field. See also [version list](/composer/docs/concepts/versioning/composer-versions) and [versioning overview](/composer/docs/concepts/versioning/composer-versioning-overview).", "type": "string" }, +"imageVersionRollbackTargets": { +"description": "Output only. The list of image versions the environment can be rolled back to, sorted by last_active_time in descending order (most recent first). This field is supported for Cloud Composer environments in versions composer-3-airflow-*.*.*-build.* and newer.", +"items": { +"$ref": "ImageVersionRollbackTarget" +}, +"readOnly": true, +"type": "array" +}, "pypiPackages": { "additionalProperties": { "type": "string" diff --git a/googleapiclient/discovery_cache/documents/composer.v1beta1.json b/googleapiclient/discovery_cache/documents/composer.v1beta1.json index 7ef8894b21..950be5fa5d 100644 --- a/googleapiclient/discovery_cache/documents/composer.v1beta1.json +++ b/googleapiclient/discovery_cache/documents/composer.v1beta1.json @@ -251,6 +251,231 @@ "description": "Regional Endpoint", "endpointUrl": "https://composer.us-west8.rep.googleapis.com/", "location": "us-west8" +}, +{ +"description": "Locational Endpoint", +"endpointUrl": "https://africa-south1-composer.googleapis.com/", +"location": "africa-south1" +}, +{ +"description": "Locational Endpoint", +"endpointUrl": "https://asia-east1-composer.googleapis.com/", +"location": "asia-east1" +}, +{ +"description": "Locational Endpoint", +"endpointUrl": "https://asia-east2-composer.googleapis.com/", +"location": "asia-east2" +}, +{ +"description": "Locational Endpoint", +"endpointUrl": "https://asia-northeast1-composer.googleapis.com/", +"location": "asia-northeast1" +}, +{ +"description": "Locational Endpoint", +"endpointUrl": "https://asia-northeast2-composer.googleapis.com/", +"location": "asia-northeast2" +}, +{ +"description": "Locational Endpoint", +"endpointUrl": "https://asia-northeast3-composer.googleapis.com/", +"location": "asia-northeast3" +}, +{ +"description": "Locational Endpoint", +"endpointUrl": "https://asia-south1-composer.googleapis.com/", +"location": "asia-south1" +}, +{ +"description": "Locational Endpoint", +"endpointUrl": "https://asia-south2-composer.googleapis.com/", +"location": "asia-south2" +}, +{ +"description": "Locational Endpoint", +"endpointUrl": "https://asia-southeast1-composer.googleapis.com/", +"location": "asia-southeast1" +}, +{ +"description": "Locational Endpoint", +"endpointUrl": "https://asia-southeast2-composer.googleapis.com/", +"location": "asia-southeast2" +}, +{ +"description": "Locational Endpoint", +"endpointUrl": "https://asia-southeast3-composer.googleapis.com/", +"location": "asia-southeast3" +}, +{ +"description": "Locational Endpoint", +"endpointUrl": "https://australia-southeast1-composer.googleapis.com/", +"location": "australia-southeast1" +}, +{ +"description": "Locational Endpoint", +"endpointUrl": "https://australia-southeast2-composer.googleapis.com/", +"location": "australia-southeast2" +}, +{ +"description": "Locational Endpoint", +"endpointUrl": "https://europe-central2-composer.googleapis.com/", +"location": "europe-central2" +}, +{ +"description": "Locational Endpoint", +"endpointUrl": "https://europe-north1-composer.googleapis.com/", +"location": "europe-north1" +}, +{ +"description": "Locational Endpoint", +"endpointUrl": "https://europe-north2-composer.googleapis.com/", +"location": "europe-north2" +}, +{ +"description": "Locational Endpoint", +"endpointUrl": "https://europe-southwest1-composer.googleapis.com/", +"location": "europe-southwest1" +}, +{ +"description": "Locational Endpoint", +"endpointUrl": "https://europe-west1-composer.googleapis.com/", +"location": "europe-west1" +}, +{ +"description": "Locational Endpoint", +"endpointUrl": "https://europe-west10-composer.googleapis.com/", +"location": "europe-west10" +}, +{ +"description": "Locational Endpoint", +"endpointUrl": "https://europe-west12-composer.googleapis.com/", +"location": "europe-west12" +}, +{ +"description": "Locational Endpoint", +"endpointUrl": "https://europe-west15-composer.googleapis.com/", +"location": "europe-west15" +}, +{ +"description": "Locational Endpoint", +"endpointUrl": "https://europe-west2-composer.googleapis.com/", +"location": "europe-west2" +}, +{ +"description": "Locational Endpoint", +"endpointUrl": "https://europe-west3-composer.googleapis.com/", +"location": "europe-west3" +}, +{ +"description": "Locational Endpoint", +"endpointUrl": "https://europe-west4-composer.googleapis.com/", +"location": "europe-west4" +}, +{ +"description": "Locational Endpoint", +"endpointUrl": "https://europe-west6-composer.googleapis.com/", +"location": "europe-west6" +}, +{ +"description": "Locational Endpoint", +"endpointUrl": "https://europe-west8-composer.googleapis.com/", +"location": "europe-west8" +}, +{ +"description": "Locational Endpoint", +"endpointUrl": "https://europe-west9-composer.googleapis.com/", +"location": "europe-west9" +}, +{ +"description": "Locational Endpoint", +"endpointUrl": "https://me-central1-composer.googleapis.com/", +"location": "me-central1" +}, +{ +"description": "Locational Endpoint", +"endpointUrl": "https://me-central2-composer.googleapis.com/", +"location": "me-central2" +}, +{ +"description": "Locational Endpoint", +"endpointUrl": "https://me-west1-composer.googleapis.com/", +"location": "me-west1" +}, +{ +"description": "Locational Endpoint", +"endpointUrl": "https://northamerica-northeast1-composer.googleapis.com/", +"location": "northamerica-northeast1" +}, +{ +"description": "Locational Endpoint", +"endpointUrl": "https://northamerica-northeast2-composer.googleapis.com/", +"location": "northamerica-northeast2" +}, +{ +"description": "Locational Endpoint", +"endpointUrl": "https://northamerica-south1-composer.googleapis.com/", +"location": "northamerica-south1" +}, +{ +"description": "Locational Endpoint", +"endpointUrl": "https://southamerica-east1-composer.googleapis.com/", +"location": "southamerica-east1" +}, +{ +"description": "Locational Endpoint", +"endpointUrl": "https://southamerica-west1-composer.googleapis.com/", +"location": "southamerica-west1" +}, +{ +"description": "Locational Endpoint", +"endpointUrl": "https://us-central1-composer.googleapis.com/", +"location": "us-central1" +}, +{ +"description": "Locational Endpoint", +"endpointUrl": "https://us-east1-composer.googleapis.com/", +"location": "us-east1" +}, +{ +"description": "Locational Endpoint", +"endpointUrl": "https://us-east4-composer.googleapis.com/", +"location": "us-east4" +}, +{ +"description": "Locational Endpoint", +"endpointUrl": "https://us-east5-composer.googleapis.com/", +"location": "us-east5" +}, +{ +"description": "Locational Endpoint", +"endpointUrl": "https://us-east7-composer.googleapis.com/", +"location": "us-east7" +}, +{ +"description": "Locational Endpoint", +"endpointUrl": "https://us-south1-composer.googleapis.com/", +"location": "us-south1" +}, +{ +"description": "Locational Endpoint", +"endpointUrl": "https://us-west1-composer.googleapis.com/", +"location": "us-west1" +}, +{ +"description": "Locational Endpoint", +"endpointUrl": "https://us-west2-composer.googleapis.com/", +"location": "us-west2" +}, +{ +"description": "Locational Endpoint", +"endpointUrl": "https://us-west3-composer.googleapis.com/", +"location": "us-west3" +}, +{ +"description": "Locational Endpoint", +"endpointUrl": "https://us-west4-composer.googleapis.com/", +"location": "us-west4" } ], "fullyEncodeReservedExpansion": true, @@ -1336,7 +1561,7 @@ } } }, -"revision": "20260825", +"revision": "20261011", "rootUrl": "https://composer.googleapis.com/", "schemas": { "AirflowMetadataRetentionPolicyConfig": { @@ -2033,6 +2258,24 @@ }, "type": "object" }, +"ImageVersionRollbackTarget": { +"description": "The image version an environment can be rolled back to.", +"id": "ImageVersionRollbackTarget", +"properties": { +"imageVersion": { +"description": "Output only. The image version the environment can be rolled back to.", +"readOnly": true, +"type": "string" +}, +"lastActiveTime": { +"description": "Output only. The last time when the environment was running this image version.", +"format": "google-datetime", +"readOnly": true, +"type": "string" +} +}, +"type": "object" +}, "Line": { "description": "Contains information about a single line from logs.", "id": "Line", @@ -2704,6 +2947,14 @@ "description": "Optional. The version of the software running in the environment. This encapsulates both the version of Cloud Composer functionality and the version of Apache Airflow. It must match the regular expression `composer-([0-9]+(\\.[0-9]+\\.[0-9]+(-preview\\.[0-9]+)?)?|latest)-airflow-([0-9]+(\\.[0-9]+(\\.[0-9]+)?)?)`. When used as input, the server also checks if the provided version is supported and denies the request for an unsupported version. The Cloud Composer portion of the image version is a full [semantic version](https://semver.org), or an alias in the form of major version number or `latest`. When an alias is provided, the server replaces it with the current Cloud Composer version that satisfies the alias. The Apache Airflow portion of the image version is a full semantic version that points to one of the supported Apache Airflow versions, or an alias in the form of only major or major.minor versions specified. When an alias is provided, the server replaces it with the latest Apache Airflow version that satisfies the alias and is supported in the given Cloud Composer version. In all cases, the resolved image version is stored in the same field. See also [version list](/composer/docs/concepts/versioning/composer-versions) and [versioning overview](/composer/docs/concepts/versioning/composer-versioning-overview).", "type": "string" }, +"imageVersionRollbackTargets": { +"description": "Output only. The list of image versions the environment can be rolled back to, sorted by last_active_time in descending order (most recent first). This field is supported for Cloud Composer environments in versions composer-3-airflow-*.*.*-build.* and newer.", +"items": { +"$ref": "ImageVersionRollbackTarget" +}, +"readOnly": true, +"type": "array" +}, "pypiPackages": { "additionalProperties": { "type": "string" From 507f35390943735d2b3157801b35a1adb244d6fa Mon Sep 17 00:00:00 2001 From: Yoshi Automation Date: Tue, 20 Oct 2026 07:24:00 +0000 Subject: [PATCH 09/34] feat(contactcenterinsights): update the api #### contactcenterinsights:v1 The following keys were deleted: - resources.projects.resources.locations.resources.assistantSessions.methods.create (Total Keys: 14) - resources.projects.resources.locations.resources.assistantSessions.methods.get (Total Keys: 11) - resources.projects.resources.locations.resources.assistantSessions.methods.list (Total Keys: 18) - resources.projects.resources.locations.resources.assistantSessions.methods.streamChat (Total Keys: 12) - schemas.GoogleCloudContactcenterinsightsV1AssistantChunk (Total Keys: 3) - schemas.GoogleCloudContactcenterinsightsV1AssistantMessage (Total Keys: 7) - schemas.GoogleCloudContactcenterinsightsV1AssistantSession (Total Keys: 16) - schemas.GoogleCloudContactcenterinsightsV1ListAssistantSessionsResponse (Total Keys: 5) - schemas.GoogleCloudContactcenterinsightsV1StreamChatRequest (Total Keys: 3) - schemas.GoogleCloudContactcenterinsightsV1StreamChatResponse (Total Keys: 7) The following keys were added: - schemas.GoogleCloudContactcenterinsightsV1GenerativeInsightsRequest.properties.timeZone.type (Total Keys: 1) - schemas.GoogleCloudContactcenterinsightsV1GenerativeInsightsResponse.properties.timeZone.type (Total Keys: 1) - schemas.GoogleCloudContactcenterinsightsV1alpha1GenerativeInsightsResponse.properties.timeZone.type (Total Keys: 1) - schemas.GoogleCloudContactcenterinsightsV1mainGenerativeInsightsResponse.properties.timeZone.type (Total Keys: 1) --- ...ns.authorizedViewSets.authorizedViews.html | 1 + ...tcenterinsights_v1.projects.locations.html | 6 +- .../documents/contactcenterinsights.v1.json | 300 +----------------- 3 files changed, 19 insertions(+), 288 deletions(-) diff --git a/docs/dyn/contactcenterinsights_v1.projects.locations.authorizedViewSets.authorizedViews.html b/docs/dyn/contactcenterinsights_v1.projects.locations.authorizedViewSets.authorizedViews.html index 33b3c1ff01..a57d9d0748 100644 --- a/docs/dyn/contactcenterinsights_v1.projects.locations.authorizedViewSets.authorizedViews.html +++ b/docs/dyn/contactcenterinsights_v1.projects.locations.authorizedViewSets.authorizedViews.html @@ -210,6 +210,7 @@

Method Details

"sessionId": "A String", # Optional. The session id of the conversation. If the session id is not specified, backend will generate a random session id. If the session id is specified, will associate user-provided user_query with the provided session id. "sqlComparisonKey": "A String", # Optional. For charts with comparison, this key will determine the metric that will be compared between the current and another dataset. "sqlQuery": "A String", # Optional. The SQL query specified by the user. This query must be in BigQuery SQL dialect. The `filter` field will also be ignored, as it is assumed that any filtering is already included in the SQL query. + "timeZone": "A String", # Optional. The time zone name from the [IANA Time Zone Database](https://www.iana.org/time-zones) (for example, `"America/Los_Angeles"`) used to group daily time-series results. If empty, or if the name is well-formed but not known to the server, `UTC` is used. Malformed values are rejected with `INVALID_ARGUMENT`. "userProvidedChartSpec": { # Optional. The user provided chart spec for the chart. This will be used to override the visual spec generated by the LLM. "a_key": "", # Properties of the object. }, diff --git a/docs/dyn/contactcenterinsights_v1.projects.locations.html b/docs/dyn/contactcenterinsights_v1.projects.locations.html index a5170fdd89..e91357275e 100644 --- a/docs/dyn/contactcenterinsights_v1.projects.locations.html +++ b/docs/dyn/contactcenterinsights_v1.projects.locations.html @@ -84,11 +84,6 @@

Instance Methods

Returns the assessmentRules Resource.

-

- assistantSessions() -

-

Returns the assistantSessions Resource.

-

authorizedViewSets()

@@ -375,6 +370,7 @@

Method Details

"sessionId": "A String", # Optional. The session id of the conversation. If the session id is not specified, backend will generate a random session id. If the session id is specified, will associate user-provided user_query with the provided session id. "sqlComparisonKey": "A String", # Optional. For charts with comparison, this key will determine the metric that will be compared between the current and another dataset. "sqlQuery": "A String", # Optional. The SQL query specified by the user. This query must be in BigQuery SQL dialect. The `filter` field will also be ignored, as it is assumed that any filtering is already included in the SQL query. + "timeZone": "A String", # Optional. The time zone name from the [IANA Time Zone Database](https://www.iana.org/time-zones) (for example, `"America/Los_Angeles"`) used to group daily time-series results. If empty, or if the name is well-formed but not known to the server, `UTC` is used. Malformed values are rejected with `INVALID_ARGUMENT`. "userProvidedChartSpec": { # Optional. The user provided chart spec for the chart. This will be used to override the visual spec generated by the LLM. "a_key": "", # Properties of the object. }, diff --git a/googleapiclient/discovery_cache/documents/contactcenterinsights.v1.json b/googleapiclient/discovery_cache/documents/contactcenterinsights.v1.json index 2f69ed7364..44e27675cc 100644 --- a/googleapiclient/discovery_cache/documents/contactcenterinsights.v1.json +++ b/googleapiclient/discovery_cache/documents/contactcenterinsights.v1.json @@ -800,137 +800,6 @@ } } }, -"assistantSessions": { -"methods": { -"create": { -"description": "Creates an assistant session.", -"flatPath": "v1/projects/{projectsId}/locations/{locationsId}/assistantSessions", -"httpMethod": "POST", -"id": "contactcenterinsights.projects.locations.assistantSessions.create", -"parameterOrder": [ -"parent" -], -"parameters": { -"assistantSessionId": { -"description": "Optional. The ID to use for the assistant session, which will become the final component of the assistant session's resource name. If not provided, a random UUID will be generated by the server. This value should be 4-64 characters and must match the regular expression `^[a-z0-9-]{4,64}$`.", -"location": "query", -"type": "string" -}, -"parent": { -"description": "Required. The parent resource where this assistant session will be created. Format: projects/{project}/locations/{location}", -"location": "path", -"pattern": "^projects/[^/]+/locations/[^/]+$", -"required": true, -"type": "string" -} -}, -"path": "v1/{+parent}/assistantSessions", -"request": { -"$ref": "GoogleCloudContactcenterinsightsV1AssistantSession" -}, -"response": { -"$ref": "GoogleCloudContactcenterinsightsV1AssistantSession" -}, -"scopes": [ -"https://www.googleapis.com/auth/cloud-platform" -] -}, -"get": { -"description": "Gets an assistant session.", -"flatPath": "v1/projects/{projectsId}/locations/{locationsId}/assistantSessions/{assistantSessionsId}", -"httpMethod": "GET", -"id": "contactcenterinsights.projects.locations.assistantSessions.get", -"parameterOrder": [ -"name" -], -"parameters": { -"name": { -"description": "Required. The name of the assistant session to retrieve. Format: `projects/{project}/locations/{location}/assistantSessions/{assistant_session}`", -"location": "path", -"pattern": "^projects/[^/]+/locations/[^/]+/assistantSessions/[^/]+$", -"required": true, -"type": "string" -} -}, -"path": "v1/{+name}", -"response": { -"$ref": "GoogleCloudContactcenterinsightsV1AssistantSession" -}, -"scopes": [ -"https://www.googleapis.com/auth/cloud-platform" -] -}, -"list": { -"description": "Lists assistant sessions.", -"flatPath": "v1/projects/{projectsId}/locations/{locationsId}/assistantSessions", -"httpMethod": "GET", -"id": "contactcenterinsights.projects.locations.assistantSessions.list", -"parameterOrder": [ -"parent" -], -"parameters": { -"filter": { -"description": "Optional. A filter to reduce results to a specific subset.", -"location": "query", -"type": "string" -}, -"pageSize": { -"description": "Optional. The maximum number of assistant sessions to return in a single response. If unspecified, at most 100 assistant sessions 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 `ListAssistantSessions` call. Provide this to retrieve the subsequent page.", -"location": "query", -"type": "string" -}, -"parent": { -"description": "Required. The parent resource, which owns this collection of assistant sessions. Format: `projects/{project}/locations/{location}`", -"location": "path", -"pattern": "^projects/[^/]+/locations/[^/]+$", -"required": true, -"type": "string" -} -}, -"path": "v1/{+parent}/assistantSessions", -"response": { -"$ref": "GoogleCloudContactcenterinsightsV1ListAssistantSessionsResponse" -}, -"scopes": [ -"https://www.googleapis.com/auth/cloud-platform" -] -}, -"streamChat": { -"description": "Streams chat messages from the assistant.", -"flatPath": "v1/projects/{projectsId}/locations/{locationsId}/assistantSessions/{assistantSessionsId}:streamChat", -"httpMethod": "POST", -"id": "contactcenterinsights.projects.locations.assistantSessions.streamChat", -"parameterOrder": [ -"name" -], -"parameters": { -"name": { -"description": "Required. The name of the assistant session to stream chat. Format: `projects/{project}/locations/{location}/assistantSessions/{assistant_session}`", -"location": "path", -"pattern": "^projects/[^/]+/locations/[^/]+/assistantSessions/[^/]+$", -"required": true, -"type": "string" -} -}, -"path": "v1/{+name}:streamChat", -"request": { -"$ref": "GoogleCloudContactcenterinsightsV1StreamChatRequest" -}, -"response": { -"$ref": "GoogleCloudContactcenterinsightsV1StreamChatResponse" -}, -"scopes": [ -"https://www.googleapis.com/auth/cloud-platform" -] -} -} -}, "authorizedViewSets": { "methods": { "create": { @@ -6248,7 +6117,7 @@ } } }, -"revision": "20260930", +"revision": "20261015", "rootUrl": "https://contactcenterinsights.googleapis.com/", "schemas": { "GoogleCloudCesV1mainAgentTransfer": { @@ -7027,104 +6896,6 @@ true }, "type": "object" }, -"GoogleCloudContactcenterinsightsV1AssistantChunk": { -"description": "A chunk of data in an assistant message.", -"id": "GoogleCloudContactcenterinsightsV1AssistantChunk", -"properties": { -"text": { -"description": "Optional. Text data.", -"type": "string" -} -}, -"type": "object" -}, -"GoogleCloudContactcenterinsightsV1AssistantMessage": { -"description": "A message in an assistant session.", -"id": "GoogleCloudContactcenterinsightsV1AssistantMessage", -"properties": { -"chunks": { -"description": "Required. Content of the message.", -"items": { -"$ref": "GoogleCloudContactcenterinsightsV1AssistantChunk" -}, -"type": "array" -}, -"eventTime": { -"description": "Required. Timestamp when the message was sent or received.", -"format": "google-datetime", -"type": "string" -}, -"role": { -"description": "Required. Role within the conversation.", -"enum": [ -"ROLE_UNSPECIFIED", -"USER", -"MODEL" -], -"enumDescriptions": [ -"Default value for unspecified.", -"The user role.", -"The model role." -], -"type": "string" -} -}, -"type": "object" -}, -"GoogleCloudContactcenterinsightsV1AssistantSession": { -"description": "Represents a conversation session with the Assistant Agent.", -"id": "GoogleCloudContactcenterinsightsV1AssistantSession", -"properties": { -"createTime": { -"description": "Output only. The time the session was created.", -"format": "google-datetime", -"readOnly": true, -"type": "string" -}, -"displayName": { -"description": "Optional. The display name of the session.", -"type": "string" -}, -"messages": { -"description": "Optional. History of messages in the session.", -"items": { -"$ref": "GoogleCloudContactcenterinsightsV1AssistantMessage" -}, -"type": "array" -}, -"name": { -"description": "Identifier. Resource name of the session. Format: projects/{project}/locations/{location}/assistantSessions/{assistant_session}", -"type": "string" -}, -"requester": { -"description": "Output only. The user who initiated the session.", -"readOnly": true, -"type": "string" -}, -"state": { -"description": "Output only. The status of the session.", -"enum": [ -"STATE_UNSPECIFIED", -"PROCESSING", -"IDLE" -], -"enumDescriptions": [ -"Unspecified state.", -"Agent is working.", -"Waiting for user input." -], -"readOnly": true, -"type": "string" -}, -"updateTime": { -"description": "Output only. The time the session was last updated.", -"format": "google-datetime", -"readOnly": true, -"type": "string" -} -}, -"type": "object" -}, "GoogleCloudContactcenterinsightsV1AuthorizedView": { "description": "An AuthorizedView represents a view of accessible Insights resources (for example, Conversation and Scorecard). Who have read access to the AuthorizedView resource will have access to these Insight resources as well.", "id": "GoogleCloudContactcenterinsightsV1AuthorizedView", @@ -10652,6 +10423,10 @@ true "description": "Optional. The SQL query specified by the user. This query must be in BigQuery SQL dialect. The `filter` field will also be ignored, as it is assumed that any filtering is already included in the SQL query.", "type": "string" }, +"timeZone": { +"description": "Optional. The time zone name from the [IANA Time Zone Database](https://www.iana.org/time-zones) (for example, `\"America/Los_Angeles\"`) used to group daily time-series results. If empty, or if the name is well-formed but not known to the server, `UTC` is used. Malformed values are rejected with `INVALID_ARGUMENT`.", +"type": "string" +}, "userProvidedChartSpec": { "additionalProperties": { "description": "Properties of the object.", @@ -10674,6 +10449,10 @@ true }, "type": "array" }, +"timeZone": { +"description": "The time zone name from the [IANA Time Zone Database](https://www.iana.org/time-zones) that the query actually used to group results. Equals the requested `time_zone` when the chart SQL supports time zones, otherwise `\"UTC\"`.", +"type": "string" +}, "transcript": { "$ref": "GoogleCloudContactcenterinsightsV1GenerativeInsightConversationTranscript", "description": "The transcript of the generative insights conversation." @@ -11426,24 +11205,6 @@ true }, "type": "object" }, -"GoogleCloudContactcenterinsightsV1ListAssistantSessionsResponse": { -"description": "Response to list assistant sessions.", -"id": "GoogleCloudContactcenterinsightsV1ListAssistantSessionsResponse", -"properties": { -"assistantSessions": { -"description": "The assistant sessions.", -"items": { -"$ref": "GoogleCloudContactcenterinsightsV1AssistantSession" -}, -"type": "array" -}, -"nextPageToken": { -"description": "A token, which can be sent as `page_token` to retrieve the next page.", -"type": "string" -} -}, -"type": "object" -}, "GoogleCloudContactcenterinsightsV1ListAuthorizedViewSetsResponse": { "description": "The response from a ListAuthorizedViewSet request.", "id": "GoogleCloudContactcenterinsightsV1ListAuthorizedViewSetsResponse", @@ -13706,41 +13467,6 @@ true }, "type": "object" }, -"GoogleCloudContactcenterinsightsV1StreamChatRequest": { -"description": "Request to stream chat.", -"id": "GoogleCloudContactcenterinsightsV1StreamChatRequest", -"properties": { -"message": { -"description": "Required. The message to send to the assistant.", -"type": "string" -} -}, -"type": "object" -}, -"GoogleCloudContactcenterinsightsV1StreamChatResponse": { -"description": "Response from streaming chat.", -"id": "GoogleCloudContactcenterinsightsV1StreamChatResponse", -"properties": { -"chunk": { -"$ref": "GoogleCloudContactcenterinsightsV1AssistantChunk", -"description": "A chunk of the assistant response message." -}, -"eventId": { -"description": "The unique ID of the event.", -"type": "string" -}, -"eventTime": { -"description": "The time when the event occurred.", -"format": "google-datetime", -"type": "string" -}, -"statusMessage": { -"description": "A status message.", -"type": "string" -} -}, -"type": "object" -}, "GoogleCloudContactcenterinsightsV1TestAutoLabelingRuleRequest": { "description": "The request message for testing auto labeling rules.", "id": "GoogleCloudContactcenterinsightsV1TestAutoLabelingRuleRequest", @@ -16915,6 +16641,10 @@ true }, "type": "array" }, +"timeZone": { +"description": "The time zone name from the [IANA Time Zone Database](https://www.iana.org/time-zones) that the query actually used to group results. Equals the requested `time_zone` when the chart SQL supports time zones, otherwise `\"UTC\"`.", +"type": "string" +}, "transcript": { "$ref": "GoogleCloudContactcenterinsightsV1alpha1GenerativeInsightConversationTranscript", "description": "The transcript of the generative insights conversation." @@ -21888,6 +21618,10 @@ true }, "type": "array" }, +"timeZone": { +"description": "The time zone name from the [IANA Time Zone Database](https://www.iana.org/time-zones) that the query actually used to group results. Equals the requested `time_zone` when the chart SQL supports time zones, otherwise `\"UTC\"`.", +"type": "string" +}, "transcript": { "$ref": "GoogleCloudContactcenterinsightsV1mainGenerativeInsightConversationTranscript", "description": "The transcript of the generative insights conversation." From 83438bdb52e68d7864cdc36140125116596acfc5 Mon Sep 17 00:00:00 2001 From: Yoshi Automation Date: Tue, 20 Oct 2026 07:24:00 +0000 Subject: [PATCH 10/34] feat(dataform): update the api #### dataform:v1beta1 The following keys were added: - resources.projects.resources.locations.resources.repositories.resources.workspaces.methods.fetchHistory (Total Keys: 16) - schemas.FetchWorkspaceHistoryResponse (Total Keys: 6) - schemas.GitRemoteSettings.properties.accountConnector.type (Total Keys: 1) --- ...ocations.repositories.workflowConfigs.html | 12 ++-- ...ions.repositories.workflowInvocations.html | 8 +-- ...rm_v1beta1.projects.locations.folders.html | 1 + .../dataform_v1beta1.projects.locations.html | 1 + ...beta1.projects.locations.repositories.html | 6 ++ ...ocations.repositories.workflowConfigs.html | 12 ++-- ...ions.repositories.workflowInvocations.html | 8 +-- ...cts.locations.repositories.workspaces.html | 53 +++++++++++++++ ...1beta1.projects.locations.teamFolders.html | 1 + .../documents/dataform.v1.json | 4 +- .../documents/dataform.v1beta1.json | 67 ++++++++++++++++++- 11 files changed, 149 insertions(+), 24 deletions(-) diff --git a/docs/dyn/dataform_v1.projects.locations.repositories.workflowConfigs.html b/docs/dyn/dataform_v1.projects.locations.repositories.workflowConfigs.html index 62043c93e3..5593de2da8 100644 --- a/docs/dyn/dataform_v1.projects.locations.repositories.workflowConfigs.html +++ b/docs/dyn/dataform_v1.projects.locations.repositories.workflowConfigs.html @@ -116,7 +116,7 @@

Method Details

"disabled": True or False, # Optional. Disables automatic creation of workflow invocations. "internalMetadata": "A String", # Output only. All the metadata information that is used internally to serve the resource. For example: timestamps, flags, status fields, etc. The format of this field is a JSON string. "invocationConfig": { # Includes various configuration options for a workflow invocation. If both `included_targets` and `included_tags` are unset, all actions will be included. # Optional. If left unset, a default InvocationConfig will be used. - "endUserAuthConfig": { # Includes configuration options for end user authentication. # Optional. Configuration for end user authentication. Note that this should not be set when `service_account` is used. + "endUserAuthConfig": { # Includes configuration options for end user authentication. # Optional. Configuration for end user authentication. Do not set if `service_account` is used. "oauthConfig": { # OAuth configuration for end user authentication. # Optional. OAuth configuration for end user authentication. "additionalOauthScopes": [ # Optional. Additional OAuth scopes to use for BigQuery executions. Scopes always in use: `https://www.googleapis.com/auth/bigquery` "A String", @@ -177,7 +177,7 @@

Method Details

"disabled": True or False, # Optional. Disables automatic creation of workflow invocations. "internalMetadata": "A String", # Output only. All the metadata information that is used internally to serve the resource. For example: timestamps, flags, status fields, etc. The format of this field is a JSON string. "invocationConfig": { # Includes various configuration options for a workflow invocation. If both `included_targets` and `included_tags` are unset, all actions will be included. # Optional. If left unset, a default InvocationConfig will be used. - "endUserAuthConfig": { # Includes configuration options for end user authentication. # Optional. Configuration for end user authentication. Note that this should not be set when `service_account` is used. + "endUserAuthConfig": { # Includes configuration options for end user authentication. # Optional. Configuration for end user authentication. Do not set if `service_account` is used. "oauthConfig": { # OAuth configuration for end user authentication. # Optional. OAuth configuration for end user authentication. "additionalOauthScopes": [ # Optional. Additional OAuth scopes to use for BigQuery executions. Scopes always in use: `https://www.googleapis.com/auth/bigquery` "A String", @@ -262,7 +262,7 @@

Method Details

"disabled": True or False, # Optional. Disables automatic creation of workflow invocations. "internalMetadata": "A String", # Output only. All the metadata information that is used internally to serve the resource. For example: timestamps, flags, status fields, etc. The format of this field is a JSON string. "invocationConfig": { # Includes various configuration options for a workflow invocation. If both `included_targets` and `included_tags` are unset, all actions will be included. # Optional. If left unset, a default InvocationConfig will be used. - "endUserAuthConfig": { # Includes configuration options for end user authentication. # Optional. Configuration for end user authentication. Note that this should not be set when `service_account` is used. + "endUserAuthConfig": { # Includes configuration options for end user authentication. # Optional. Configuration for end user authentication. Do not set if `service_account` is used. "oauthConfig": { # OAuth configuration for end user authentication. # Optional. OAuth configuration for end user authentication. "additionalOauthScopes": [ # Optional. Additional OAuth scopes to use for BigQuery executions. Scopes always in use: `https://www.googleapis.com/auth/bigquery` "A String", @@ -337,7 +337,7 @@

Method Details

"disabled": True or False, # Optional. Disables automatic creation of workflow invocations. "internalMetadata": "A String", # Output only. All the metadata information that is used internally to serve the resource. For example: timestamps, flags, status fields, etc. The format of this field is a JSON string. "invocationConfig": { # Includes various configuration options for a workflow invocation. If both `included_targets` and `included_tags` are unset, all actions will be included. # Optional. If left unset, a default InvocationConfig will be used. - "endUserAuthConfig": { # Includes configuration options for end user authentication. # Optional. Configuration for end user authentication. Note that this should not be set when `service_account` is used. + "endUserAuthConfig": { # Includes configuration options for end user authentication. # Optional. Configuration for end user authentication. Do not set if `service_account` is used. "oauthConfig": { # OAuth configuration for end user authentication. # Optional. OAuth configuration for end user authentication. "additionalOauthScopes": [ # Optional. Additional OAuth scopes to use for BigQuery executions. Scopes always in use: `https://www.googleapis.com/auth/bigquery` "A String", @@ -415,7 +415,7 @@

Method Details

"disabled": True or False, # Optional. Disables automatic creation of workflow invocations. "internalMetadata": "A String", # Output only. All the metadata information that is used internally to serve the resource. For example: timestamps, flags, status fields, etc. The format of this field is a JSON string. "invocationConfig": { # Includes various configuration options for a workflow invocation. If both `included_targets` and `included_tags` are unset, all actions will be included. # Optional. If left unset, a default InvocationConfig will be used. - "endUserAuthConfig": { # Includes configuration options for end user authentication. # Optional. Configuration for end user authentication. Note that this should not be set when `service_account` is used. + "endUserAuthConfig": { # Includes configuration options for end user authentication. # Optional. Configuration for end user authentication. Do not set if `service_account` is used. "oauthConfig": { # OAuth configuration for end user authentication. # Optional. OAuth configuration for end user authentication. "additionalOauthScopes": [ # Optional. Additional OAuth scopes to use for BigQuery executions. Scopes always in use: `https://www.googleapis.com/auth/bigquery` "A String", @@ -476,7 +476,7 @@

Method Details

"disabled": True or False, # Optional. Disables automatic creation of workflow invocations. "internalMetadata": "A String", # Output only. All the metadata information that is used internally to serve the resource. For example: timestamps, flags, status fields, etc. The format of this field is a JSON string. "invocationConfig": { # Includes various configuration options for a workflow invocation. If both `included_targets` and `included_tags` are unset, all actions will be included. # Optional. If left unset, a default InvocationConfig will be used. - "endUserAuthConfig": { # Includes configuration options for end user authentication. # Optional. Configuration for end user authentication. Note that this should not be set when `service_account` is used. + "endUserAuthConfig": { # Includes configuration options for end user authentication. # Optional. Configuration for end user authentication. Do not set if `service_account` is used. "oauthConfig": { # OAuth configuration for end user authentication. # Optional. OAuth configuration for end user authentication. "additionalOauthScopes": [ # Optional. Additional OAuth scopes to use for BigQuery executions. Scopes always in use: `https://www.googleapis.com/auth/bigquery` "A String", diff --git a/docs/dyn/dataform_v1.projects.locations.repositories.workflowInvocations.html b/docs/dyn/dataform_v1.projects.locations.repositories.workflowInvocations.html index 4aefc791d7..8b2c950c81 100644 --- a/docs/dyn/dataform_v1.projects.locations.repositories.workflowInvocations.html +++ b/docs/dyn/dataform_v1.projects.locations.repositories.workflowInvocations.html @@ -147,7 +147,7 @@

Method Details

}, "internalMetadata": "A String", # Output only. All the metadata information that is used internally to serve the resource. For example: timestamps, flags, status fields, etc. The format of this field is a JSON string. "invocationConfig": { # Includes various configuration options for a workflow invocation. If both `included_targets` and `included_tags` are unset, all actions will be included. # Immutable. If left unset, a default InvocationConfig will be used. - "endUserAuthConfig": { # Includes configuration options for end user authentication. # Optional. Configuration for end user authentication. Note that this should not be set when `service_account` is used. + "endUserAuthConfig": { # Includes configuration options for end user authentication. # Optional. Configuration for end user authentication. Do not set if `service_account` is used. "oauthConfig": { # OAuth configuration for end user authentication. # Optional. OAuth configuration for end user authentication. "additionalOauthScopes": [ # Optional. Additional OAuth scopes to use for BigQuery executions. Scopes always in use: `https://www.googleapis.com/auth/bigquery` "A String", @@ -204,7 +204,7 @@

Method Details

}, "internalMetadata": "A String", # Output only. All the metadata information that is used internally to serve the resource. For example: timestamps, flags, status fields, etc. The format of this field is a JSON string. "invocationConfig": { # Includes various configuration options for a workflow invocation. If both `included_targets` and `included_tags` are unset, all actions will be included. # Immutable. If left unset, a default InvocationConfig will be used. - "endUserAuthConfig": { # Includes configuration options for end user authentication. # Optional. Configuration for end user authentication. Note that this should not be set when `service_account` is used. + "endUserAuthConfig": { # Includes configuration options for end user authentication. # Optional. Configuration for end user authentication. Do not set if `service_account` is used. "oauthConfig": { # OAuth configuration for end user authentication. # Optional. OAuth configuration for end user authentication. "additionalOauthScopes": [ # Optional. Additional OAuth scopes to use for BigQuery executions. Scopes always in use: `https://www.googleapis.com/auth/bigquery` "A String", @@ -286,7 +286,7 @@

Method Details

}, "internalMetadata": "A String", # Output only. All the metadata information that is used internally to serve the resource. For example: timestamps, flags, status fields, etc. The format of this field is a JSON string. "invocationConfig": { # Includes various configuration options for a workflow invocation. If both `included_targets` and `included_tags` are unset, all actions will be included. # Immutable. If left unset, a default InvocationConfig will be used. - "endUserAuthConfig": { # Includes configuration options for end user authentication. # Optional. Configuration for end user authentication. Note that this should not be set when `service_account` is used. + "endUserAuthConfig": { # Includes configuration options for end user authentication. # Optional. Configuration for end user authentication. Do not set if `service_account` is used. "oauthConfig": { # OAuth configuration for end user authentication. # Optional. OAuth configuration for end user authentication. "additionalOauthScopes": [ # Optional. Additional OAuth scopes to use for BigQuery executions. Scopes always in use: `https://www.googleapis.com/auth/bigquery` "A String", @@ -360,7 +360,7 @@

Method Details

}, "internalMetadata": "A String", # Output only. All the metadata information that is used internally to serve the resource. For example: timestamps, flags, status fields, etc. The format of this field is a JSON string. "invocationConfig": { # Includes various configuration options for a workflow invocation. If both `included_targets` and `included_tags` are unset, all actions will be included. # Immutable. If left unset, a default InvocationConfig will be used. - "endUserAuthConfig": { # Includes configuration options for end user authentication. # Optional. Configuration for end user authentication. Note that this should not be set when `service_account` is used. + "endUserAuthConfig": { # Includes configuration options for end user authentication. # Optional. Configuration for end user authentication. Do not set if `service_account` is used. "oauthConfig": { # OAuth configuration for end user authentication. # Optional. OAuth configuration for end user authentication. "additionalOauthScopes": [ # Optional. Additional OAuth scopes to use for BigQuery executions. Scopes always in use: `https://www.googleapis.com/auth/bigquery` "A String", diff --git a/docs/dyn/dataform_v1beta1.projects.locations.folders.html b/docs/dyn/dataform_v1beta1.projects.locations.folders.html index 70d17391ff..90bd87b276 100644 --- a/docs/dyn/dataform_v1beta1.projects.locations.folders.html +++ b/docs/dyn/dataform_v1beta1.projects.locations.folders.html @@ -407,6 +407,7 @@

Method Details

}, }, "gitRemoteSettings": { # Controls Git remote configuration for a repository. # Optional. If set, configures this repository to be linked to a Git remote. + "accountConnector": "A String", # Optional. Resource name for the Account Connector used for personal authentication. Must be in the format `projects/*/locations/*/accountConnectors/*` "authenticationTokenSecretVersion": "A String", # Optional. The name of the Secret Manager secret version to use as an authentication token for Git operations. Must be in the format `projects/*/secrets/*/versions/*`. "defaultBranch": "A String", # Optional. The Git remote's default branch name. If not set, `main` will be used. "effectiveDefaultBranch": "A String", # Output only. The Git remote's effective default branch name. This is the default branch name of the Git remote if it is set, otherwise it is `main`. diff --git a/docs/dyn/dataform_v1beta1.projects.locations.html b/docs/dyn/dataform_v1beta1.projects.locations.html index d8be3748df..f713ef151c 100644 --- a/docs/dyn/dataform_v1beta1.projects.locations.html +++ b/docs/dyn/dataform_v1beta1.projects.locations.html @@ -268,6 +268,7 @@

Method Details

}, }, "gitRemoteSettings": { # Controls Git remote configuration for a repository. # Optional. If set, configures this repository to be linked to a Git remote. + "accountConnector": "A String", # Optional. Resource name for the Account Connector used for personal authentication. Must be in the format `projects/*/locations/*/accountConnectors/*` "authenticationTokenSecretVersion": "A String", # Optional. The name of the Secret Manager secret version to use as an authentication token for Git operations. Must be in the format `projects/*/secrets/*/versions/*`. "defaultBranch": "A String", # Optional. The Git remote's default branch name. If not set, `main` will be used. "effectiveDefaultBranch": "A String", # Output only. The Git remote's effective default branch name. This is the default branch name of the Git remote if it is set, otherwise it is `main`. diff --git a/docs/dyn/dataform_v1beta1.projects.locations.repositories.html b/docs/dyn/dataform_v1beta1.projects.locations.repositories.html index b72e8d44bb..2324d23b16 100644 --- a/docs/dyn/dataform_v1beta1.projects.locations.repositories.html +++ b/docs/dyn/dataform_v1beta1.projects.locations.repositories.html @@ -250,6 +250,7 @@

Method Details

}, }, "gitRemoteSettings": { # Controls Git remote configuration for a repository. # Optional. If set, configures this repository to be linked to a Git remote. + "accountConnector": "A String", # Optional. Resource name for the Account Connector used for personal authentication. Must be in the format `projects/*/locations/*/accountConnectors/*` "authenticationTokenSecretVersion": "A String", # Optional. The name of the Secret Manager secret version to use as an authentication token for Git operations. Must be in the format `projects/*/secrets/*/versions/*`. "defaultBranch": "A String", # Optional. The Git remote's default branch name. If not set, `main` will be used. "effectiveDefaultBranch": "A String", # Output only. The Git remote's effective default branch name. This is the default branch name of the Git remote if it is set, otherwise it is `main`. @@ -302,6 +303,7 @@

Method Details

}, }, "gitRemoteSettings": { # Controls Git remote configuration for a repository. # Optional. If set, configures this repository to be linked to a Git remote. + "accountConnector": "A String", # Optional. Resource name for the Account Connector used for personal authentication. Must be in the format `projects/*/locations/*/accountConnectors/*` "authenticationTokenSecretVersion": "A String", # Optional. The name of the Secret Manager secret version to use as an authentication token for Git operations. Must be in the format `projects/*/secrets/*/versions/*`. "defaultBranch": "A String", # Optional. The Git remote's default branch name. If not set, `main` will be used. "effectiveDefaultBranch": "A String", # Output only. The Git remote's effective default branch name. This is the default branch name of the Git remote if it is set, otherwise it is `main`. @@ -488,6 +490,7 @@

Method Details

}, }, "gitRemoteSettings": { # Controls Git remote configuration for a repository. # Optional. If set, configures this repository to be linked to a Git remote. + "accountConnector": "A String", # Optional. Resource name for the Account Connector used for personal authentication. Must be in the format `projects/*/locations/*/accountConnectors/*` "authenticationTokenSecretVersion": "A String", # Optional. The name of the Secret Manager secret version to use as an authentication token for Git operations. Must be in the format `projects/*/secrets/*/versions/*`. "defaultBranch": "A String", # Optional. The Git remote's default branch name. If not set, `main` will be used. "effectiveDefaultBranch": "A String", # Output only. The Git remote's effective default branch name. This is the default branch name of the Git remote if it is set, otherwise it is `main`. @@ -588,6 +591,7 @@

Method Details

}, }, "gitRemoteSettings": { # Controls Git remote configuration for a repository. # Optional. If set, configures this repository to be linked to a Git remote. + "accountConnector": "A String", # Optional. Resource name for the Account Connector used for personal authentication. Must be in the format `projects/*/locations/*/accountConnectors/*` "authenticationTokenSecretVersion": "A String", # Optional. The name of the Secret Manager secret version to use as an authentication token for Git operations. Must be in the format `projects/*/secrets/*/versions/*`. "defaultBranch": "A String", # Optional. The Git remote's default branch name. If not set, `main` will be used. "effectiveDefaultBranch": "A String", # Output only. The Git remote's effective default branch name. This is the default branch name of the Git remote if it is set, otherwise it is `main`. @@ -702,6 +706,7 @@

Method Details

}, }, "gitRemoteSettings": { # Controls Git remote configuration for a repository. # Optional. If set, configures this repository to be linked to a Git remote. + "accountConnector": "A String", # Optional. Resource name for the Account Connector used for personal authentication. Must be in the format `projects/*/locations/*/accountConnectors/*` "authenticationTokenSecretVersion": "A String", # Optional. The name of the Secret Manager secret version to use as an authentication token for Git operations. Must be in the format `projects/*/secrets/*/versions/*`. "defaultBranch": "A String", # Optional. The Git remote's default branch name. If not set, `main` will be used. "effectiveDefaultBranch": "A String", # Output only. The Git remote's effective default branch name. This is the default branch name of the Git remote if it is set, otherwise it is `main`. @@ -754,6 +759,7 @@

Method Details

}, }, "gitRemoteSettings": { # Controls Git remote configuration for a repository. # Optional. If set, configures this repository to be linked to a Git remote. + "accountConnector": "A String", # Optional. Resource name for the Account Connector used for personal authentication. Must be in the format `projects/*/locations/*/accountConnectors/*` "authenticationTokenSecretVersion": "A String", # Optional. The name of the Secret Manager secret version to use as an authentication token for Git operations. Must be in the format `projects/*/secrets/*/versions/*`. "defaultBranch": "A String", # Optional. The Git remote's default branch name. If not set, `main` will be used. "effectiveDefaultBranch": "A String", # Output only. The Git remote's effective default branch name. This is the default branch name of the Git remote if it is set, otherwise it is `main`. diff --git a/docs/dyn/dataform_v1beta1.projects.locations.repositories.workflowConfigs.html b/docs/dyn/dataform_v1beta1.projects.locations.repositories.workflowConfigs.html index 45b53c06e2..0f8c878d31 100644 --- a/docs/dyn/dataform_v1beta1.projects.locations.repositories.workflowConfigs.html +++ b/docs/dyn/dataform_v1beta1.projects.locations.repositories.workflowConfigs.html @@ -116,7 +116,7 @@

Method Details

"disabled": True or False, # Optional. Disables automatic creation of workflow invocations. "internalMetadata": "A String", # Output only. All the metadata information that is used internally to serve the resource. For example: timestamps, flags, status fields, etc. The format of this field is a JSON string. "invocationConfig": { # Includes various configuration options for a workflow invocation. If both `included_targets` and `included_tags` are unset, all actions will be included. # Optional. If left unset, a default InvocationConfig will be used. - "endUserAuthConfig": { # Includes configuration options for end user authentication. # Optional. Configuration for end user authentication. Note that this should not be set when `service_account` is used. + "endUserAuthConfig": { # Includes configuration options for end user authentication. # Optional. Configuration for end user authentication. Do not set if `service_account` is used. "oauthConfig": { # OAuth configuration for end user authentication. # Optional. OAuth configuration for end user authentication. "additionalOauthScopes": [ # Optional. Additional OAuth scopes to use for BigQuery executions. Scopes always in use: `https://www.googleapis.com/auth/bigquery` "A String", @@ -209,7 +209,7 @@

Method Details

"disabled": True or False, # Optional. Disables automatic creation of workflow invocations. "internalMetadata": "A String", # Output only. All the metadata information that is used internally to serve the resource. For example: timestamps, flags, status fields, etc. The format of this field is a JSON string. "invocationConfig": { # Includes various configuration options for a workflow invocation. If both `included_targets` and `included_tags` are unset, all actions will be included. # Optional. If left unset, a default InvocationConfig will be used. - "endUserAuthConfig": { # Includes configuration options for end user authentication. # Optional. Configuration for end user authentication. Note that this should not be set when `service_account` is used. + "endUserAuthConfig": { # Includes configuration options for end user authentication. # Optional. Configuration for end user authentication. Do not set if `service_account` is used. "oauthConfig": { # OAuth configuration for end user authentication. # Optional. OAuth configuration for end user authentication. "additionalOauthScopes": [ # Optional. Additional OAuth scopes to use for BigQuery executions. Scopes always in use: `https://www.googleapis.com/auth/bigquery` "A String", @@ -326,7 +326,7 @@

Method Details

"disabled": True or False, # Optional. Disables automatic creation of workflow invocations. "internalMetadata": "A String", # Output only. All the metadata information that is used internally to serve the resource. For example: timestamps, flags, status fields, etc. The format of this field is a JSON string. "invocationConfig": { # Includes various configuration options for a workflow invocation. If both `included_targets` and `included_tags` are unset, all actions will be included. # Optional. If left unset, a default InvocationConfig will be used. - "endUserAuthConfig": { # Includes configuration options for end user authentication. # Optional. Configuration for end user authentication. Note that this should not be set when `service_account` is used. + "endUserAuthConfig": { # Includes configuration options for end user authentication. # Optional. Configuration for end user authentication. Do not set if `service_account` is used. "oauthConfig": { # OAuth configuration for end user authentication. # Optional. OAuth configuration for end user authentication. "additionalOauthScopes": [ # Optional. Additional OAuth scopes to use for BigQuery executions. Scopes always in use: `https://www.googleapis.com/auth/bigquery` "A String", @@ -433,7 +433,7 @@

Method Details

"disabled": True or False, # Optional. Disables automatic creation of workflow invocations. "internalMetadata": "A String", # Output only. All the metadata information that is used internally to serve the resource. For example: timestamps, flags, status fields, etc. The format of this field is a JSON string. "invocationConfig": { # Includes various configuration options for a workflow invocation. If both `included_targets` and `included_tags` are unset, all actions will be included. # Optional. If left unset, a default InvocationConfig will be used. - "endUserAuthConfig": { # Includes configuration options for end user authentication. # Optional. Configuration for end user authentication. Note that this should not be set when `service_account` is used. + "endUserAuthConfig": { # Includes configuration options for end user authentication. # Optional. Configuration for end user authentication. Do not set if `service_account` is used. "oauthConfig": { # OAuth configuration for end user authentication. # Optional. OAuth configuration for end user authentication. "additionalOauthScopes": [ # Optional. Additional OAuth scopes to use for BigQuery executions. Scopes always in use: `https://www.googleapis.com/auth/bigquery` "A String", @@ -543,7 +543,7 @@

Method Details

"disabled": True or False, # Optional. Disables automatic creation of workflow invocations. "internalMetadata": "A String", # Output only. All the metadata information that is used internally to serve the resource. For example: timestamps, flags, status fields, etc. The format of this field is a JSON string. "invocationConfig": { # Includes various configuration options for a workflow invocation. If both `included_targets` and `included_tags` are unset, all actions will be included. # Optional. If left unset, a default InvocationConfig will be used. - "endUserAuthConfig": { # Includes configuration options for end user authentication. # Optional. Configuration for end user authentication. Note that this should not be set when `service_account` is used. + "endUserAuthConfig": { # Includes configuration options for end user authentication. # Optional. Configuration for end user authentication. Do not set if `service_account` is used. "oauthConfig": { # OAuth configuration for end user authentication. # Optional. OAuth configuration for end user authentication. "additionalOauthScopes": [ # Optional. Additional OAuth scopes to use for BigQuery executions. Scopes always in use: `https://www.googleapis.com/auth/bigquery` "A String", @@ -636,7 +636,7 @@

Method Details

"disabled": True or False, # Optional. Disables automatic creation of workflow invocations. "internalMetadata": "A String", # Output only. All the metadata information that is used internally to serve the resource. For example: timestamps, flags, status fields, etc. The format of this field is a JSON string. "invocationConfig": { # Includes various configuration options for a workflow invocation. If both `included_targets` and `included_tags` are unset, all actions will be included. # Optional. If left unset, a default InvocationConfig will be used. - "endUserAuthConfig": { # Includes configuration options for end user authentication. # Optional. Configuration for end user authentication. Note that this should not be set when `service_account` is used. + "endUserAuthConfig": { # Includes configuration options for end user authentication. # Optional. Configuration for end user authentication. Do not set if `service_account` is used. "oauthConfig": { # OAuth configuration for end user authentication. # Optional. OAuth configuration for end user authentication. "additionalOauthScopes": [ # Optional. Additional OAuth scopes to use for BigQuery executions. Scopes always in use: `https://www.googleapis.com/auth/bigquery` "A String", diff --git a/docs/dyn/dataform_v1beta1.projects.locations.repositories.workflowInvocations.html b/docs/dyn/dataform_v1beta1.projects.locations.repositories.workflowInvocations.html index e16cbd96b3..dc24b307a7 100644 --- a/docs/dyn/dataform_v1beta1.projects.locations.repositories.workflowInvocations.html +++ b/docs/dyn/dataform_v1beta1.projects.locations.repositories.workflowInvocations.html @@ -147,7 +147,7 @@

Method Details

}, "internalMetadata": "A String", # Output only. All the metadata information that is used internally to serve the resource. For example: timestamps, flags, status fields, etc. The format of this field is a JSON string. "invocationConfig": { # Includes various configuration options for a workflow invocation. If both `included_targets` and `included_tags` are unset, all actions will be included. # Immutable. If left unset, a default InvocationConfig will be used. - "endUserAuthConfig": { # Includes configuration options for end user authentication. # Optional. Configuration for end user authentication. Note that this should not be set when `service_account` is used. + "endUserAuthConfig": { # Includes configuration options for end user authentication. # Optional. Configuration for end user authentication. Do not set if `service_account` is used. "oauthConfig": { # OAuth configuration for end user authentication. # Optional. OAuth configuration for end user authentication. "additionalOauthScopes": [ # Optional. Additional OAuth scopes to use for BigQuery executions. Scopes always in use: `https://www.googleapis.com/auth/bigquery` "A String", @@ -204,7 +204,7 @@

Method Details

}, "internalMetadata": "A String", # Output only. All the metadata information that is used internally to serve the resource. For example: timestamps, flags, status fields, etc. The format of this field is a JSON string. "invocationConfig": { # Includes various configuration options for a workflow invocation. If both `included_targets` and `included_tags` are unset, all actions will be included. # Immutable. If left unset, a default InvocationConfig will be used. - "endUserAuthConfig": { # Includes configuration options for end user authentication. # Optional. Configuration for end user authentication. Note that this should not be set when `service_account` is used. + "endUserAuthConfig": { # Includes configuration options for end user authentication. # Optional. Configuration for end user authentication. Do not set if `service_account` is used. "oauthConfig": { # OAuth configuration for end user authentication. # Optional. OAuth configuration for end user authentication. "additionalOauthScopes": [ # Optional. Additional OAuth scopes to use for BigQuery executions. Scopes always in use: `https://www.googleapis.com/auth/bigquery` "A String", @@ -286,7 +286,7 @@

Method Details

}, "internalMetadata": "A String", # Output only. All the metadata information that is used internally to serve the resource. For example: timestamps, flags, status fields, etc. The format of this field is a JSON string. "invocationConfig": { # Includes various configuration options for a workflow invocation. If both `included_targets` and `included_tags` are unset, all actions will be included. # Immutable. If left unset, a default InvocationConfig will be used. - "endUserAuthConfig": { # Includes configuration options for end user authentication. # Optional. Configuration for end user authentication. Note that this should not be set when `service_account` is used. + "endUserAuthConfig": { # Includes configuration options for end user authentication. # Optional. Configuration for end user authentication. Do not set if `service_account` is used. "oauthConfig": { # OAuth configuration for end user authentication. # Optional. OAuth configuration for end user authentication. "additionalOauthScopes": [ # Optional. Additional OAuth scopes to use for BigQuery executions. Scopes always in use: `https://www.googleapis.com/auth/bigquery` "A String", @@ -360,7 +360,7 @@

Method Details

}, "internalMetadata": "A String", # Output only. All the metadata information that is used internally to serve the resource. For example: timestamps, flags, status fields, etc. The format of this field is a JSON string. "invocationConfig": { # Includes various configuration options for a workflow invocation. If both `included_targets` and `included_tags` are unset, all actions will be included. # Immutable. If left unset, a default InvocationConfig will be used. - "endUserAuthConfig": { # Includes configuration options for end user authentication. # Optional. Configuration for end user authentication. Note that this should not be set when `service_account` is used. + "endUserAuthConfig": { # Includes configuration options for end user authentication. # Optional. Configuration for end user authentication. Do not set if `service_account` is used. "oauthConfig": { # OAuth configuration for end user authentication. # Optional. OAuth configuration for end user authentication. "additionalOauthScopes": [ # Optional. Additional OAuth scopes to use for BigQuery executions. Scopes always in use: `https://www.googleapis.com/auth/bigquery` "A String", diff --git a/docs/dyn/dataform_v1beta1.projects.locations.repositories.workspaces.html b/docs/dyn/dataform_v1beta1.projects.locations.repositories.workspaces.html index 59ada1f2bf..eb7ba2663c 100644 --- a/docs/dyn/dataform_v1beta1.projects.locations.repositories.workspaces.html +++ b/docs/dyn/dataform_v1beta1.projects.locations.repositories.workspaces.html @@ -110,6 +110,12 @@

Instance Methods

fetchGitAheadBehind(name, remoteBranch=None, x__xgafv=None)

Fetches Git ahead/behind against a remote branch.

+

+ fetchHistory(name, pageSize=None, pageToken=None, x__xgafv=None)

+

Fetches a Workspace's history of commits.

+

+ fetchHistory_next(previous_request, previous_response)

+

Retrieves the next page of results.

get(name, x__xgafv=None)

Fetches a single Workspace.

@@ -477,6 +483,53 @@

Method Details

} +
+ fetchHistory(name, pageSize=None, pageToken=None, x__xgafv=None) + 
Fetches a Workspace's history of commits.
+
+Args:
+  name: string, Required. The workspace's name. (required)
+  pageSize: integer, Optional. Maximum number of commits to return. The server may return fewer items than requested. If unspecified, the server will pick an appropriate default.
+  pageToken: string, Optional. Page token received from a previous `FetchWorkspaceHistory` call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to `FetchWorkspaceHistory`, with the exception of `page_size`, 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:
+
+    { # `FetchWorkspaceHistory` response message.
+  "commits": [ # A list of commit logs, ordered by 'git log' default order.
+    { # Represents a single commit log.
+      "author": { # Represents the author of a Git commit. # The commit author for this commit log entry.
+        "emailAddress": "A String", # Required. The commit author's email address.
+        "name": "A String", # Required. The commit author's name.
+      },
+      "commitMessage": "A String", # The commit message for this commit log entry.
+      "commitSha": "A String", # The commit SHA for this commit log entry.
+      "commitTime": "A String", # Commit timestamp.
+    },
+  ],
+  "nextPageToken": "A String", # Optional. A token, which can be sent as `page_token` to retrieve the next page. If this field is omitted, there are no subsequent pages.
+  "reachesShallowBoundary": True or False, # Whether this response reaches the shallow boundary of the repository.
+}
+
+ +
+ fetchHistory_next(previous_request, previous_response) + 
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.
+
+
+
get(name, x__xgafv=None) 
Fetches a single Workspace.
diff --git a/docs/dyn/dataform_v1beta1.projects.locations.teamFolders.html b/docs/dyn/dataform_v1beta1.projects.locations.teamFolders.html
index 8ff82df609..ebe5f1481e 100644
--- a/docs/dyn/dataform_v1beta1.projects.locations.teamFolders.html
+++ b/docs/dyn/dataform_v1beta1.projects.locations.teamFolders.html
@@ -358,6 +358,7 @@ 
Method Details

           },
         },
         "gitRemoteSettings": { # Controls Git remote configuration for a repository. # Optional. If set, configures this repository to be linked to a Git remote.
+          "accountConnector": "A String", # Optional. Resource name for the Account Connector used for personal authentication. Must be in the format `projects/*/locations/*/accountConnectors/*`
           "authenticationTokenSecretVersion": "A String", # Optional. The name of the Secret Manager secret version to use as an authentication token for Git operations. Must be in the format `projects/*/secrets/*/versions/*`.
           "defaultBranch": "A String", # Optional. The Git remote's default branch name. If not set, `main` will be used.
           "effectiveDefaultBranch": "A String", # Output only. The Git remote's effective default branch name. This is the default branch name of the Git remote if it is set, otherwise it is `main`.
diff --git a/googleapiclient/discovery_cache/documents/dataform.v1.json b/googleapiclient/discovery_cache/documents/dataform.v1.json
index 9765fa5e6a..819131cd68 100644
--- a/googleapiclient/discovery_cache/documents/dataform.v1.json
+++ b/googleapiclient/discovery_cache/documents/dataform.v1.json
@@ -3220,7 +3220,7 @@
 }
 }
 },
-"revision": "20260920",
+"revision": "20261011",
 "rootUrl": "https://dataform.googleapis.com/",
 "schemas": {
 "ActionErrorTable": {
@@ -4439,7 +4439,7 @@
 "properties": {
 "endUserAuthConfig": {
 "$ref": "EndUserAuthenticationConfig",
-"description": "Optional. Configuration for end user authentication. Note that this should not be set when `service_account` is used."
+"description": "Optional. Configuration for end user authentication. Do not set if `service_account` is used."
 },
 "executionMode": {
 "description": "Optional. Specifies the execution mode for the workflow invocation.",
diff --git a/googleapiclient/discovery_cache/documents/dataform.v1beta1.json b/googleapiclient/discovery_cache/documents/dataform.v1beta1.json
index f8051ae51c..de7798dd87 100644
--- a/googleapiclient/discovery_cache/documents/dataform.v1beta1.json
+++ b/googleapiclient/discovery_cache/documents/dataform.v1beta1.json
@@ -2463,6 +2463,43 @@
 "https://www.googleapis.com/auth/cloud-platform"
 ]
 },
+"fetchHistory": {
+"description": "Fetches a Workspace's history of commits.",
+"flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/repositories/{repositoriesId}/workspaces/{workspacesId}:fetchHistory",
+"httpMethod": "GET",
+"id": "dataform.projects.locations.repositories.workspaces.fetchHistory",
+"parameterOrder": [
+"name"
+],
+"parameters": {
+"name": {
+"description": "Required. The workspace's name.",
+"location": "path",
+"pattern": "^projects/[^/]+/locations/[^/]+/repositories/[^/]+/workspaces/[^/]+$",
+"required": true,
+"type": "string"
+},
+"pageSize": {
+"description": "Optional. Maximum number of commits to return. The server may return fewer items than requested. If unspecified, the server will pick an appropriate default.",
+"format": "int32",
+"location": "query",
+"type": "integer"
+},
+"pageToken": {
+"description": "Optional. Page token received from a previous `FetchWorkspaceHistory` call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to `FetchWorkspaceHistory`, with the exception of `page_size`, must match the call that provided the page token.",
+"location": "query",
+"type": "string"
+}
+},
+"path": "v1beta1/{+name}:fetchHistory",
+"response": {
+"$ref": "FetchWorkspaceHistoryResponse"
+},
+"scopes": [
+"https://www.googleapis.com/auth/bigquery",
+"https://www.googleapis.com/auth/cloud-platform"
+]
+},
 "get": {
 "description": "Fetches a single Workspace.",
 "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/repositories/{repositoriesId}/workspaces/{workspacesId}",
@@ -3428,7 +3465,7 @@
 }
 }
 },
-"revision": "20260920",
+"revision": "20261011",
 "rootUrl": "https://dataform.googleapis.com/",
 "schemas": {
 "ActionErrorTable": {
@@ -4446,6 +4483,28 @@
 },
 "type": "object"
 },
+"FetchWorkspaceHistoryResponse": {
+"description": "`FetchWorkspaceHistory` response message.",
+"id": "FetchWorkspaceHistoryResponse",
+"properties": {
+"commits": {
+"description": "A list of commit logs, ordered by 'git log' default order.",
+"items": {
+"$ref": "CommitLogEntry"
+},
+"type": "array"
+},
+"nextPageToken": {
+"description": "Optional. A token, which can be sent as `page_token` to retrieve the next page. If this field is omitted, there are no subsequent pages.",
+"type": "string"
+},
+"reachesShallowBoundary": {
+"description": "Whether this response reaches the shallow boundary of the repository.",
+"type": "boolean"
+}
+},
+"type": "object"
+},
 "FileOperation": {
 "description": "Represents a single file operation to the repository.",
 "id": "FileOperation",
@@ -4590,6 +4649,10 @@
 "description": "Controls Git remote configuration for a repository.",
 "id": "GitRemoteSettings",
 "properties": {
+"accountConnector": {
+"description": "Optional. Resource name for the Account Connector used for personal authentication. Must be in the format `projects/*/locations/*/accountConnectors/*`",
+"type": "string"
+},
 "authenticationTokenSecretVersion": {
 "description": "Optional. The name of the Secret Manager secret version to use as an authentication token for Git operations. Must be in the format `projects/*/secrets/*/versions/*`.",
 "type": "string"
@@ -4742,7 +4805,7 @@
 "properties": {
 "endUserAuthConfig": {
 "$ref": "EndUserAuthenticationConfig",
-"description": "Optional. Configuration for end user authentication. Note that this should not be set when `service_account` is used."
+"description": "Optional. Configuration for end user authentication. Do not set if `service_account` is used."
 },
 "executionMode": {
 "description": "Optional. Specifies the execution mode for the workflow invocation.",

From ba05d7c86874d121aa17fdcb5f46e49a5ec714bd Mon Sep 17 00:00:00 2001
From: Yoshi Automation 
Date: Tue, 20 Oct 2026 07:24:00 +0000
Subject: [PATCH 11/34] feat(datalineage): update the api

#### datalineage:v1

The following keys were added:
- schemas.GoogleCloudDatacatalogLineageV1SearchLineageStreamingRequestSearchFilters.properties.projects (Total Keys: 2)
---
 docs/dyn/datalineage_v1.projects.locations.html          | 3 +++
 .../discovery_cache/documents/datalineage.v1.json        | 9 ++++++++-
 2 files changed, 11 insertions(+), 1 deletion(-)

diff --git a/docs/dyn/datalineage_v1.projects.locations.html b/docs/dyn/datalineage_v1.projects.locations.html
index 0043f77676..fddfe9b17d 100644
--- a/docs/dyn/datalineage_v1.projects.locations.html
+++ b/docs/dyn/datalineage_v1.projects.locations.html
@@ -213,6 +213,9 @@ 
Method Details

       "A String",
     ],
     "entitySet": "A String", # Optional. Entity set restriction. If unspecified, the method returns all entities.
+    "projects": [ # Optional. Projects to restrict lineage links to. Callers can provide project IDs (for example, `projects/my-project`) or project numbers (for example, `projects/123456789`). If unspecified, lineage is returned from all projects.
+      "A String",
+    ],
     "timeRange": { # 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. Time interval to search for lineage. If unspecified, all lineage is returned. Currently, at most one of `start_time` and `end_time` can be set.
       "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.
diff --git a/googleapiclient/discovery_cache/documents/datalineage.v1.json b/googleapiclient/discovery_cache/documents/datalineage.v1.json
index 3553fcc83f..61b16d6102 100644
--- a/googleapiclient/discovery_cache/documents/datalineage.v1.json
+++ b/googleapiclient/discovery_cache/documents/datalineage.v1.json
@@ -1279,7 +1279,7 @@
 }
 }
 },
-"revision": "20260912",
+"revision": "20261009",
 "rootUrl": "https://datalineage.googleapis.com/",
 "schemas": {
 "GoogleCloudDatacatalogLineageConfigmanagementV1Config": {
@@ -2012,6 +2012,13 @@
 ],
 "type": "string"
 },
+"projects": {
+"description": "Optional. Projects to restrict lineage links to. Callers can provide project IDs (for example, `projects/my-project`) or project numbers (for example, `projects/123456789`). If unspecified, lineage is returned from all projects.",
+"items": {
+"type": "string"
+},
+"type": "array"
+},
 "timeRange": {
 "$ref": "GoogleTypeInterval",
 "description": "Optional. Time interval to search for lineage. If unspecified, all lineage is returned. Currently, at most one of `start_time` and `end_time` can be set."

From a8b09a5865b3d8c1f6e403da5276556413c8cd04 Mon Sep 17 00:00:00 2001
From: Yoshi Automation 
Date: Tue, 20 Oct 2026 07:24:00 +0000
Subject: [PATCH 12/34] feat(dataplex): update the api

#### dataplex:v1

The following keys were added:
- resources.projects.resources.locations.resources.entryGroups.methods.batchChangeMetadata (Total Keys: 12)
- resources.projects.resources.locations.resources.entryGroups.methods.requestBatchMetadataChange (Total Keys: 12)
- schemas.GoogleCloudDataplexV1BatchChangeMetadataRequest (Total Keys: 13)
- schemas.GoogleCloudDataplexV1BatchChangeMetadataResponse (Total Keys: 4)
- schemas.GoogleCloudDataplexV1ChangeRequest.properties.batchChangeMetadataRequest.$ref (Total Keys: 1)
- schemas.GoogleCloudDataplexV1ChangeRequest.properties.batchChangeMetadataResponse (Total Keys: 2)
- schemas.GoogleCloudDataplexV1EntryGroup.properties.changeRequestConfig.$ref (Total Keys: 1)
- schemas.GoogleCloudDataplexV1EntryGroupChangeRequestConfig (Total Keys: 4)
- schemas.GoogleCloudDataplexV1RequestBatchMetadataChangeRequest (Total Keys: 6)
- schemas.GoogleCloudDataplexV1RequestBatchMetadataChangeResponse (Total Keys: 3)
- schemas.GoogleCloudDataplexV1UpdateEntryLinkRequest (Total Keys: 6)
---
 ...lex_v1.projects.locations.aspectTypes.html |    8 +-
 ..._v1.projects.locations.changeRequests.html | 1194 +++++++++++++++++
 ...ex_v1.projects.locations.dataProducts.html |  199 +++
 ...lex_v1.projects.locations.entryGroups.html |  466 +++++++
 .../documents/dataplex.v1.json                |  256 +++-
 5 files changed, 2113 insertions(+), 10 deletions(-)

diff --git a/docs/dyn/dataplex_v1.projects.locations.aspectTypes.html b/docs/dyn/dataplex_v1.projects.locations.aspectTypes.html
index 4b8853b825..cbad55a96e 100644
--- a/docs/dyn/dataplex_v1.projects.locations.aspectTypes.html
+++ b/docs/dyn/dataplex_v1.projects.locations.aspectTypes.html
@@ -137,7 +137,7 @@ 
Method Details

       "description": "A String", # Optional. Description for a field.
       "displayName": "A String", # Optional. Display name for a field.
       "displayOrder": 42, # Optional. Display order for a field. You can use this to reorder where a field is rendered.
-      "stringType": "A String", # Optional. You can use String Type annotations to specify special meaning to string fields. The following values are supported: richText: The field must be interpreted as a rich text field. url: A fully qualified URL link. resource: A service qualified resource reference.
+      "stringType": "A String", # Optional. You can use String Type annotations to specify special meaning to string fields. The following values are supported: richText: The field must be interpreted as a rich text field. markdown: The field must be interpreted as a markdown field. url: A fully qualified URL link. resource: A service qualified resource reference.
       "stringValues": [ # Optional. Suggested hints for string fields. You can use them to suggest values to users through console.
         "A String",
       ],
@@ -268,7 +268,7 @@ 
Method Details

       "description": "A String", # Optional. Description for a field.
       "displayName": "A String", # Optional. Display name for a field.
       "displayOrder": 42, # Optional. Display order for a field. You can use this to reorder where a field is rendered.
-      "stringType": "A String", # Optional. You can use String Type annotations to specify special meaning to string fields. The following values are supported: richText: The field must be interpreted as a rich text field. url: A fully qualified URL link. resource: A service qualified resource reference.
+      "stringType": "A String", # Optional. You can use String Type annotations to specify special meaning to string fields. The following values are supported: richText: The field must be interpreted as a rich text field. markdown: The field must be interpreted as a markdown field. url: A fully qualified URL link. resource: A service qualified resource reference.
       "stringValues": [ # Optional. Suggested hints for string fields. You can use them to suggest values to users through console.
         "A String",
       ],
@@ -387,7 +387,7 @@ 
Method Details

           "description": "A String", # Optional. Description for a field.
           "displayName": "A String", # Optional. Display name for a field.
           "displayOrder": 42, # Optional. Display order for a field. You can use this to reorder where a field is rendered.
-          "stringType": "A String", # Optional. You can use String Type annotations to specify special meaning to string fields. The following values are supported: richText: The field must be interpreted as a rich text field. url: A fully qualified URL link. resource: A service qualified resource reference.
+          "stringType": "A String", # Optional. You can use String Type annotations to specify special meaning to string fields. The following values are supported: richText: The field must be interpreted as a rich text field. markdown: The field must be interpreted as a markdown field. url: A fully qualified URL link. resource: A service qualified resource reference.
           "stringValues": [ # Optional. Suggested hints for string fields. You can use them to suggest values to users through console.
             "A String",
           ],
@@ -467,7 +467,7 @@ 
Method Details

       "description": "A String", # Optional. Description for a field.
       "displayName": "A String", # Optional. Display name for a field.
       "displayOrder": 42, # Optional. Display order for a field. You can use this to reorder where a field is rendered.
-      "stringType": "A String", # Optional. You can use String Type annotations to specify special meaning to string fields. The following values are supported: richText: The field must be interpreted as a rich text field. url: A fully qualified URL link. resource: A service qualified resource reference.
+      "stringType": "A String", # Optional. You can use String Type annotations to specify special meaning to string fields. The following values are supported: richText: The field must be interpreted as a rich text field. markdown: The field must be interpreted as a markdown field. url: A fully qualified URL link. resource: A service qualified resource reference.
       "stringValues": [ # Optional. Suggested hints for string fields. You can use them to suggest values to users through console.
         "A String",
       ],
diff --git a/docs/dyn/dataplex_v1.projects.locations.changeRequests.html b/docs/dyn/dataplex_v1.projects.locations.changeRequests.html
index ccaf7da4ba..82b5991963 100644
--- a/docs/dyn/dataplex_v1.projects.locations.changeRequests.html
+++ b/docs/dyn/dataplex_v1.projects.locations.changeRequests.html
@@ -133,6 +133,205 @@ 
Method Details

     { # Represents a proposed change to a metadata resource.
   "approver": "A String", # Output only. The email address of the user who approved/rejected the ChangeRequest.
   "author": "A String", # Output only. The email address of the user who created the ChangeRequest.
+  "batchChangeMetadataRequest": { # Request message for batch changing metadata. Requires permission to perform the underlying change, depending on the type and content of the change. Per operation, required permissions are: - for CreateEntry: dataplex.entries.create - for UpdateEntry: dataplex.entries.update - for DeleteEntry: dataplex.entries.delete - for CreateEntryLink: dataplex.entryLinks.create - for UpdateEntryLink: dataplex.entryLinks.update - for DeleteEntryLink: dataplex.entryLinks.deleteAnd per used type permissions are: - for EntryType: dataplex.entryTypes.use or dataplex.entryGroups.useEntry for reusable built-in types, - for AspectType: dataplex.aspectTypes.use or dataplex.entryGroups.useAspect for reusable built-in types and - for EntryLinkType: dataplex.entryLinkTypes.use or dataplex.entryGroups.useEntryLink for reusable built-in types. # Payload for executing a batch of catalog changes.
+    "changes": [ # Required. The list of changes to apply. Only a single change per resource is supported. Maximum number of changes supported is 250.
+      { # Detailed description of an individual change.
+        "createEntryLinkRequest": { # Request message for CreateEntryLink. # Payload for creating an EntryLink.
+          "entryLink": { # EntryLink represents a link between two Entries. # Required. Entry Link resource.
+            "aspects": { # Optional. The aspects that are attached to the entry link. The format of the aspect key has to be the following: {project_id_or_number}.{location_id}.{aspect_type_id} Currently, only a single aspect of a Dataplex-owned Aspect Type is allowed.
+              "a_key": { # Represents a single piece of metadata describing an entry or entry link.
+                "aspectSource": { # Information related to the source system of the aspect. # Optional. Information related to the source system of the aspect.
+                  "createTime": "A String", # The time the aspect was created in the source system.
+                  "dataVersion": "A String", # The version of the data format used to produce this data. This field is used to indicated when the underlying data format changes (e.g., schema modifications, changes to the source URL format definition, etc).
+                  "updateTime": "A String", # The time the aspect was last updated in the source system.
+                },
+                "aspectType": "A String", # Output only. The resource name of the type used to create this Aspect.
+                "createTime": "A String", # Output only. The time when the Aspect was created.
+                "data": { # Required. The content of the aspect, according to its aspect type schema. The maximum size of the field is 120KB (encoded as UTF-8).
+                  "a_key": "", # Properties of the object.
+                },
+                "path": "A String", # Output only. The path in the entry under which the aspect is attached.
+                "updateTime": "A String", # Output only. The time when the Aspect was last updated.
+              },
+            },
+            "createTime": "A String", # Output only. The time when the Entry Link was created.
+            "entryLinkType": "A String", # Required. Immutable. Relative resource name of the Entry Link Type used to create this Entry Link. For example: Entry link between synonym terms in a glossary: projects/dataplex-types/locations/global/entryLinkTypes/synonym Entry link between related terms in a glossary: projects/dataplex-types/locations/global/entryLinkTypes/related Entry link between glossary terms and data assets: projects/dataplex-types/locations/global/entryLinkTypes/definition
+            "entryReferences": [ # Required. Immutable. Specifies the Entries referenced in the Entry Link. There should be exactly two entry references.
+              { # Reference to the Entry that is linked through the Entry Link.
+                "name": "A String", # Required. Immutable. The relative resource name of the referenced Entry, of the form: projects/{project_id_or_number}/locations/{location_id}/entryGroups/{entry_group_id}/entries/{entry_id}
+                "path": "A String", # Immutable. The path in the Entry that is referenced in the Entry Link. Empty path denotes that the Entry itself is referenced in the Entry Link.
+                "type": "A String", # Required. Immutable. The reference type of the Entry.
+              },
+            ],
+            "name": "A String", # Output only. Immutable. Identifier. The relative resource name of the Entry Link, of the form: projects/{project_id_or_number}/locations/{location_id}/entryGroups/{entry_group_id}/entryLinks/{entry_link_id}
+            "updateTime": "A String", # Output only. The time when the Entry Link was last updated.
+          },
+          "entryLinkId": "A String", # Required. Entry Link identifier * Must contain only lowercase letters, numbers and hyphens. * Must start with a letter. * Must be between 1-63 characters. * Must end with a number or a letter. * Must be unique within the EntryGroup.
+          "parent": "A String", # Required. The resource name of the parent Entry Group: projects/{project_id_or_number}/locations/{location_id}/entryGroups/{entry_group_id}.
+        },
+        "createEntryRequest": { # Create Entry request. # Payload for creating an Entry.
+          "entry": { # An entry is a representation of a data resource that can be described by various metadata. # Required. Entry resource.
+            "aspects": { # Optional. The aspects that are attached to the entry. Depending on how the aspect is attached to the entry, the format of the aspect key can be one of the following: If the aspect is attached directly to the entry: {project_id_or_number}.{location_id}.{aspect_type_id} If the aspect is attached to an entry's path: {project_id_or_number}.{location_id}.{aspect_type_id}@{path}
+              "a_key": { # Represents a single piece of metadata describing an entry or entry link.
+                "aspectSource": { # Information related to the source system of the aspect. # Optional. Information related to the source system of the aspect.
+                  "createTime": "A String", # The time the aspect was created in the source system.
+                  "dataVersion": "A String", # The version of the data format used to produce this data. This field is used to indicated when the underlying data format changes (e.g., schema modifications, changes to the source URL format definition, etc).
+                  "updateTime": "A String", # The time the aspect was last updated in the source system.
+                },
+                "aspectType": "A String", # Output only. The resource name of the type used to create this Aspect.
+                "createTime": "A String", # Output only. The time when the Aspect was created.
+                "data": { # Required. The content of the aspect, according to its aspect type schema. The maximum size of the field is 120KB (encoded as UTF-8).
+                  "a_key": "", # Properties of the object.
+                },
+                "path": "A String", # Output only. The path in the entry under which the aspect is attached.
+                "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 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.
+                  "name": "A String", # Optional. The name of the ancestor resource.
+                  "type": "A String", # Optional. The type of the ancestor resource.
+                },
+              ],
+              "createTime": "A String", # The time when the resource was created in the source system.
+              "description": "A String", # A description of the data resource. Maximum length is 2,000 characters.
+              "displayName": "A String", # A user-friendly display name. Maximum length is 500 characters.
+              "labels": { # User-defined labels. The maximum size of keys and values is 128 characters each.
+                "a_key": "A String",
+              },
+              "location": "A String", # Output only. Location of the resource in the source system. You can search the entry by this location. By default, this should match the location of the entry group containing this entry. A different value allows capturing the source location for data external to Google Cloud.
+              "platform": "A String", # The platform containing the source system. Maximum length is 64 characters.
+              "resource": "A String", # The name of the resource in the source system. Maximum length is 4,000 characters.
+              "system": "A String", # The name of the source system. Maximum length is 64 characters.
+              "updateTime": "A String", # The time when the resource was last updated in the source system. If the entry exists in the system and its EntrySource has update_time populated, further updates to the EntrySource of the entry must provide incremental updates to its update_time.
+            },
+            "entryType": "A String", # Required. Immutable. The relative resource name of the entry type that was used to create this entry, in the format projects/{project_id_or_number}/locations/{location_id}/entryTypes/{entry_type_id}.
+            "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 Universal Catalog.
+          },
+          "entryId": "A 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.
+          "parent": "A String", # Required. The resource name of the parent Entry Group: projects/{project}/locations/{location}/entryGroups/{entry_group}.
+        },
+        "deleteEntryLinkRequest": { # Request message for DeleteEntryLink. # Payload for deleting an EntryLink.
+          "name": "A String", # Required. The resource name of the Entry Link: projects/{project_id_or_number}/locations/{location_id}/entryGroups/{entry_group_id}/entryLinks/{entry_link_id}.
+        },
+        "deleteEntryRequest": { # Delete Entry request. # Payload for deleting an Entry.
+          "name": "A String", # Required. The resource name of the Entry: projects/{project}/locations/{location}/entryGroups/{entry_group}/entries/{entry}.
+        },
+        "updateEntryLinkRequest": { # Request message for UpdateEntryLink method. # Payload for updating an EntryLink.
+          "allowMissing": True or False, # Optional. If set to true and the entry link doesn't exist, the service will create it.
+          "aspectKeys": [ # Optional. The map keys of the Aspects which the service should modify. It should be the aspect type reference in the format {project_id_or_number}.{location_id}.{aspect_type_id}.If this field is left empty, the service treats it as specifying exactly those Aspects present in the request.
+            "A String",
+          ],
+          "entryLink": { # EntryLink represents a link between two Entries. # Required. Entry Link resource.
+            "aspects": { # Optional. The aspects that are attached to the entry link. The format of the aspect key has to be the following: {project_id_or_number}.{location_id}.{aspect_type_id} Currently, only a single aspect of a Dataplex-owned Aspect Type is allowed.
+              "a_key": { # Represents a single piece of metadata describing an entry or entry link.
+                "aspectSource": { # Information related to the source system of the aspect. # Optional. Information related to the source system of the aspect.
+                  "createTime": "A String", # The time the aspect was created in the source system.
+                  "dataVersion": "A String", # The version of the data format used to produce this data. This field is used to indicated when the underlying data format changes (e.g., schema modifications, changes to the source URL format definition, etc).
+                  "updateTime": "A String", # The time the aspect was last updated in the source system.
+                },
+                "aspectType": "A String", # Output only. The resource name of the type used to create this Aspect.
+                "createTime": "A String", # Output only. The time when the Aspect was created.
+                "data": { # Required. The content of the aspect, according to its aspect type schema. The maximum size of the field is 120KB (encoded as UTF-8).
+                  "a_key": "", # Properties of the object.
+                },
+                "path": "A String", # Output only. The path in the entry under which the aspect is attached.
+                "updateTime": "A String", # Output only. The time when the Aspect was last updated.
+              },
+            },
+            "createTime": "A String", # Output only. The time when the Entry Link was created.
+            "entryLinkType": "A String", # Required. Immutable. Relative resource name of the Entry Link Type used to create this Entry Link. For example: Entry link between synonym terms in a glossary: projects/dataplex-types/locations/global/entryLinkTypes/synonym Entry link between related terms in a glossary: projects/dataplex-types/locations/global/entryLinkTypes/related Entry link between glossary terms and data assets: projects/dataplex-types/locations/global/entryLinkTypes/definition
+            "entryReferences": [ # Required. Immutable. Specifies the Entries referenced in the Entry Link. There should be exactly two entry references.
+              { # Reference to the Entry that is linked through the Entry Link.
+                "name": "A String", # Required. Immutable. The relative resource name of the referenced Entry, of the form: projects/{project_id_or_number}/locations/{location_id}/entryGroups/{entry_group_id}/entries/{entry_id}
+                "path": "A String", # Immutable. The path in the Entry that is referenced in the Entry Link. Empty path denotes that the Entry itself is referenced in the Entry Link.
+                "type": "A String", # Required. Immutable. The reference type of the Entry.
+              },
+            ],
+            "name": "A String", # Output only. Immutable. Identifier. The relative resource name of the Entry Link, of the form: projects/{project_id_or_number}/locations/{location_id}/entryGroups/{entry_group_id}/entryLinks/{entry_link_id}
+            "updateTime": "A String", # Output only. The time when the Entry Link was last updated.
+          },
+        },
+        "updateEntryRequest": { # Update Entry request. # Payload for updating an Entry.
+          "allowMissing": True or False, # Optional. If set to true and the entry doesn't exist, the service will create it.
+          "aspectKeys": [ # Optional. The map keys of the Aspects which the service should modify. It supports the following syntaxes: - matches an aspect of the given type and empty path. @path - matches an aspect of the given type and specified path. For example, to attach an aspect to a field that is specified by the schema aspect, the path should have the format Schema.. @* - matches aspects of the given type for all paths. *@path - matches aspects of all types on the given path.The service will not remove existing aspects matching the syntax unless delete_missing_aspects is set to true.If this field is left empty, the service treats it as specifying exactly those Aspects present in the request.
+            "A String",
+          ],
+          "deleteMissingAspects": True or False, # Optional. If set to true and the aspect_keys specify aspect ranges, the service deletes any existing aspects from that range that weren't provided in the request.
+          "entry": { # An entry is a representation of a data resource that can be described by various metadata. # Required. Entry resource.
+            "aspects": { # Optional. The aspects that are attached to the entry. Depending on how the aspect is attached to the entry, the format of the aspect key can be one of the following: If the aspect is attached directly to the entry: {project_id_or_number}.{location_id}.{aspect_type_id} If the aspect is attached to an entry's path: {project_id_or_number}.{location_id}.{aspect_type_id}@{path}
+              "a_key": { # Represents a single piece of metadata describing an entry or entry link.
+                "aspectSource": { # Information related to the source system of the aspect. # Optional. Information related to the source system of the aspect.
+                  "createTime": "A String", # The time the aspect was created in the source system.
+                  "dataVersion": "A String", # The version of the data format used to produce this data. This field is used to indicated when the underlying data format changes (e.g., schema modifications, changes to the source URL format definition, etc).
+                  "updateTime": "A String", # The time the aspect was last updated in the source system.
+                },
+                "aspectType": "A String", # Output only. The resource name of the type used to create this Aspect.
+                "createTime": "A String", # Output only. The time when the Aspect was created.
+                "data": { # Required. The content of the aspect, according to its aspect type schema. The maximum size of the field is 120KB (encoded as UTF-8).
+                  "a_key": "", # Properties of the object.
+                },
+                "path": "A String", # Output only. The path in the entry under which the aspect is attached.
+                "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 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.
+                  "name": "A String", # Optional. The name of the ancestor resource.
+                  "type": "A String", # Optional. The type of the ancestor resource.
+                },
+              ],
+              "createTime": "A String", # The time when the resource was created in the source system.
+              "description": "A String", # A description of the data resource. Maximum length is 2,000 characters.
+              "displayName": "A String", # A user-friendly display name. Maximum length is 500 characters.
+              "labels": { # User-defined labels. The maximum size of keys and values is 128 characters each.
+                "a_key": "A String",
+              },
+              "location": "A String", # Output only. Location of the resource in the source system. You can search the entry by this location. By default, this should match the location of the entry group containing this entry. A different value allows capturing the source location for data external to Google Cloud.
+              "platform": "A String", # The platform containing the source system. Maximum length is 64 characters.
+              "resource": "A String", # The name of the resource in the source system. Maximum length is 4,000 characters.
+              "system": "A String", # The name of the source system. Maximum length is 64 characters.
+              "updateTime": "A String", # The time when the resource was last updated in the source system. If the entry exists in the system and its EntrySource has update_time populated, further updates to the EntrySource of the entry must provide incremental updates to its update_time.
+            },
+            "entryType": "A String", # Required. Immutable. The relative resource name of the entry type that was used to create this entry, in the format projects/{project_id_or_number}/locations/{location_id}/entryTypes/{entry_type_id}.
+            "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 Universal Catalog.
+          },
+          "updateMask": "A String", # Optional. Mask of fields to update. To update Aspects, the update_mask must contain the value "aspects".If the update_mask is empty, the service will update all modifiable fields present in the request.
+        },
+      },
+    ],
+    "description": { # Description of the batch change. # Optional. Text description of the batch change.
+      "content": "A String", # Optional. The text description content.
+      "job": { # Description of the job that created the batch change. # Optional. The job that created the batch change.
+        "name": "A String", # Optional. The name of the job that created the batch change. For example: projects/{project_number}/locations/{location_id}/enrichmentTasks/{enrichment_task_id}/runs/{enrichment_run_id}
+        "runTime": "A String", # Optional. The start time of the job run that created the batch change.
+      },
+    },
+    "name": "A String", # Required. The resource name of the EntryGroup on which the batch change applies. Format: projects/{project_number_or_id}/locations/{location_id}/entryGroups/{entry_group_id}
+  },
+  "batchChangeMetadataResponse": { # Response message for BatchChangeMetadata. # Output only. Result of applying a batch change metadata request.
+    "failedRequests": { # A map of failed requests for a batch change, where the key is the 0-based index of the failed request in the batch and the value is the error status. If all operations succeeded, this map is empty.
+      "a_key": { # The Status type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by gRPC (https://github.com/grpc). Each Status message contains three pieces of data: error code, error message, and error details.You can find out more about this error model and how to work with it in the API Design Guide (https://cloud.google.com/apis/design/errors).
+        "code": 42, # The status code, which should be an enum value of google.rpc.Code.
+        "details": [ # A list of messages that carry the error details. There is a common set of message types for APIs to use.
+          {
+            "a_key": "", # Properties of the object. Contains field @type with type URL.
+          },
+        ],
+        "message": "A String", # A developer-facing error message, which should be in English. Any user-facing error message should be localized and sent in the google.rpc.Status.details field, or localized by the client.
+      },
+    },
+  },
   "changeType": "A String", # Output only. The type of change represented by the change_payload. This field is derived from the populated field in the change_payload oneof.
   "createEntry": { # Create Entry request. # Payload for creating an Entry.
     "entry": { # An entry is a representation of a data resource that can be described by various metadata. # Required. Entry resource.
@@ -443,6 +642,205 @@ 
Method Details

     { # Represents a proposed change to a metadata resource.
   "approver": "A String", # Output only. The email address of the user who approved/rejected the ChangeRequest.
   "author": "A String", # Output only. The email address of the user who created the ChangeRequest.
+  "batchChangeMetadataRequest": { # Request message for batch changing metadata. Requires permission to perform the underlying change, depending on the type and content of the change. Per operation, required permissions are: - for CreateEntry: dataplex.entries.create - for UpdateEntry: dataplex.entries.update - for DeleteEntry: dataplex.entries.delete - for CreateEntryLink: dataplex.entryLinks.create - for UpdateEntryLink: dataplex.entryLinks.update - for DeleteEntryLink: dataplex.entryLinks.deleteAnd per used type permissions are: - for EntryType: dataplex.entryTypes.use or dataplex.entryGroups.useEntry for reusable built-in types, - for AspectType: dataplex.aspectTypes.use or dataplex.entryGroups.useAspect for reusable built-in types and - for EntryLinkType: dataplex.entryLinkTypes.use or dataplex.entryGroups.useEntryLink for reusable built-in types. # Payload for executing a batch of catalog changes.
+    "changes": [ # Required. The list of changes to apply. Only a single change per resource is supported. Maximum number of changes supported is 250.
+      { # Detailed description of an individual change.
+        "createEntryLinkRequest": { # Request message for CreateEntryLink. # Payload for creating an EntryLink.
+          "entryLink": { # EntryLink represents a link between two Entries. # Required. Entry Link resource.
+            "aspects": { # Optional. The aspects that are attached to the entry link. The format of the aspect key has to be the following: {project_id_or_number}.{location_id}.{aspect_type_id} Currently, only a single aspect of a Dataplex-owned Aspect Type is allowed.
+              "a_key": { # Represents a single piece of metadata describing an entry or entry link.
+                "aspectSource": { # Information related to the source system of the aspect. # Optional. Information related to the source system of the aspect.
+                  "createTime": "A String", # The time the aspect was created in the source system.
+                  "dataVersion": "A String", # The version of the data format used to produce this data. This field is used to indicated when the underlying data format changes (e.g., schema modifications, changes to the source URL format definition, etc).
+                  "updateTime": "A String", # The time the aspect was last updated in the source system.
+                },
+                "aspectType": "A String", # Output only. The resource name of the type used to create this Aspect.
+                "createTime": "A String", # Output only. The time when the Aspect was created.
+                "data": { # Required. The content of the aspect, according to its aspect type schema. The maximum size of the field is 120KB (encoded as UTF-8).
+                  "a_key": "", # Properties of the object.
+                },
+                "path": "A String", # Output only. The path in the entry under which the aspect is attached.
+                "updateTime": "A String", # Output only. The time when the Aspect was last updated.
+              },
+            },
+            "createTime": "A String", # Output only. The time when the Entry Link was created.
+            "entryLinkType": "A String", # Required. Immutable. Relative resource name of the Entry Link Type used to create this Entry Link. For example: Entry link between synonym terms in a glossary: projects/dataplex-types/locations/global/entryLinkTypes/synonym Entry link between related terms in a glossary: projects/dataplex-types/locations/global/entryLinkTypes/related Entry link between glossary terms and data assets: projects/dataplex-types/locations/global/entryLinkTypes/definition
+            "entryReferences": [ # Required. Immutable. Specifies the Entries referenced in the Entry Link. There should be exactly two entry references.
+              { # Reference to the Entry that is linked through the Entry Link.
+                "name": "A String", # Required. Immutable. The relative resource name of the referenced Entry, of the form: projects/{project_id_or_number}/locations/{location_id}/entryGroups/{entry_group_id}/entries/{entry_id}
+                "path": "A String", # Immutable. The path in the Entry that is referenced in the Entry Link. Empty path denotes that the Entry itself is referenced in the Entry Link.
+                "type": "A String", # Required. Immutable. The reference type of the Entry.
+              },
+            ],
+            "name": "A String", # Output only. Immutable. Identifier. The relative resource name of the Entry Link, of the form: projects/{project_id_or_number}/locations/{location_id}/entryGroups/{entry_group_id}/entryLinks/{entry_link_id}
+            "updateTime": "A String", # Output only. The time when the Entry Link was last updated.
+          },
+          "entryLinkId": "A String", # Required. Entry Link identifier * Must contain only lowercase letters, numbers and hyphens. * Must start with a letter. * Must be between 1-63 characters. * Must end with a number or a letter. * Must be unique within the EntryGroup.
+          "parent": "A String", # Required. The resource name of the parent Entry Group: projects/{project_id_or_number}/locations/{location_id}/entryGroups/{entry_group_id}.
+        },
+        "createEntryRequest": { # Create Entry request. # Payload for creating an Entry.
+          "entry": { # An entry is a representation of a data resource that can be described by various metadata. # Required. Entry resource.
+            "aspects": { # Optional. The aspects that are attached to the entry. Depending on how the aspect is attached to the entry, the format of the aspect key can be one of the following: If the aspect is attached directly to the entry: {project_id_or_number}.{location_id}.{aspect_type_id} If the aspect is attached to an entry's path: {project_id_or_number}.{location_id}.{aspect_type_id}@{path}
+              "a_key": { # Represents a single piece of metadata describing an entry or entry link.
+                "aspectSource": { # Information related to the source system of the aspect. # Optional. Information related to the source system of the aspect.
+                  "createTime": "A String", # The time the aspect was created in the source system.
+                  "dataVersion": "A String", # The version of the data format used to produce this data. This field is used to indicated when the underlying data format changes (e.g., schema modifications, changes to the source URL format definition, etc).
+                  "updateTime": "A String", # The time the aspect was last updated in the source system.
+                },
+                "aspectType": "A String", # Output only. The resource name of the type used to create this Aspect.
+                "createTime": "A String", # Output only. The time when the Aspect was created.
+                "data": { # Required. The content of the aspect, according to its aspect type schema. The maximum size of the field is 120KB (encoded as UTF-8).
+                  "a_key": "", # Properties of the object.
+                },
+                "path": "A String", # Output only. The path in the entry under which the aspect is attached.
+                "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 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.
+                  "name": "A String", # Optional. The name of the ancestor resource.
+                  "type": "A String", # Optional. The type of the ancestor resource.
+                },
+              ],
+              "createTime": "A String", # The time when the resource was created in the source system.
+              "description": "A String", # A description of the data resource. Maximum length is 2,000 characters.
+              "displayName": "A String", # A user-friendly display name. Maximum length is 500 characters.
+              "labels": { # User-defined labels. The maximum size of keys and values is 128 characters each.
+                "a_key": "A String",
+              },
+              "location": "A String", # Output only. Location of the resource in the source system. You can search the entry by this location. By default, this should match the location of the entry group containing this entry. A different value allows capturing the source location for data external to Google Cloud.
+              "platform": "A String", # The platform containing the source system. Maximum length is 64 characters.
+              "resource": "A String", # The name of the resource in the source system. Maximum length is 4,000 characters.
+              "system": "A String", # The name of the source system. Maximum length is 64 characters.
+              "updateTime": "A String", # The time when the resource was last updated in the source system. If the entry exists in the system and its EntrySource has update_time populated, further updates to the EntrySource of the entry must provide incremental updates to its update_time.
+            },
+            "entryType": "A String", # Required. Immutable. The relative resource name of the entry type that was used to create this entry, in the format projects/{project_id_or_number}/locations/{location_id}/entryTypes/{entry_type_id}.
+            "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 Universal Catalog.
+          },
+          "entryId": "A 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.
+          "parent": "A String", # Required. The resource name of the parent Entry Group: projects/{project}/locations/{location}/entryGroups/{entry_group}.
+        },
+        "deleteEntryLinkRequest": { # Request message for DeleteEntryLink. # Payload for deleting an EntryLink.
+          "name": "A String", # Required. The resource name of the Entry Link: projects/{project_id_or_number}/locations/{location_id}/entryGroups/{entry_group_id}/entryLinks/{entry_link_id}.
+        },
+        "deleteEntryRequest": { # Delete Entry request. # Payload for deleting an Entry.
+          "name": "A String", # Required. The resource name of the Entry: projects/{project}/locations/{location}/entryGroups/{entry_group}/entries/{entry}.
+        },
+        "updateEntryLinkRequest": { # Request message for UpdateEntryLink method. # Payload for updating an EntryLink.
+          "allowMissing": True or False, # Optional. If set to true and the entry link doesn't exist, the service will create it.
+          "aspectKeys": [ # Optional. The map keys of the Aspects which the service should modify. It should be the aspect type reference in the format {project_id_or_number}.{location_id}.{aspect_type_id}.If this field is left empty, the service treats it as specifying exactly those Aspects present in the request.
+            "A String",
+          ],
+          "entryLink": { # EntryLink represents a link between two Entries. # Required. Entry Link resource.
+            "aspects": { # Optional. The aspects that are attached to the entry link. The format of the aspect key has to be the following: {project_id_or_number}.{location_id}.{aspect_type_id} Currently, only a single aspect of a Dataplex-owned Aspect Type is allowed.
+              "a_key": { # Represents a single piece of metadata describing an entry or entry link.
+                "aspectSource": { # Information related to the source system of the aspect. # Optional. Information related to the source system of the aspect.
+                  "createTime": "A String", # The time the aspect was created in the source system.
+                  "dataVersion": "A String", # The version of the data format used to produce this data. This field is used to indicated when the underlying data format changes (e.g., schema modifications, changes to the source URL format definition, etc).
+                  "updateTime": "A String", # The time the aspect was last updated in the source system.
+                },
+                "aspectType": "A String", # Output only. The resource name of the type used to create this Aspect.
+                "createTime": "A String", # Output only. The time when the Aspect was created.
+                "data": { # Required. The content of the aspect, according to its aspect type schema. The maximum size of the field is 120KB (encoded as UTF-8).
+                  "a_key": "", # Properties of the object.
+                },
+                "path": "A String", # Output only. The path in the entry under which the aspect is attached.
+                "updateTime": "A String", # Output only. The time when the Aspect was last updated.
+              },
+            },
+            "createTime": "A String", # Output only. The time when the Entry Link was created.
+            "entryLinkType": "A String", # Required. Immutable. Relative resource name of the Entry Link Type used to create this Entry Link. For example: Entry link between synonym terms in a glossary: projects/dataplex-types/locations/global/entryLinkTypes/synonym Entry link between related terms in a glossary: projects/dataplex-types/locations/global/entryLinkTypes/related Entry link between glossary terms and data assets: projects/dataplex-types/locations/global/entryLinkTypes/definition
+            "entryReferences": [ # Required. Immutable. Specifies the Entries referenced in the Entry Link. There should be exactly two entry references.
+              { # Reference to the Entry that is linked through the Entry Link.
+                "name": "A String", # Required. Immutable. The relative resource name of the referenced Entry, of the form: projects/{project_id_or_number}/locations/{location_id}/entryGroups/{entry_group_id}/entries/{entry_id}
+                "path": "A String", # Immutable. The path in the Entry that is referenced in the Entry Link. Empty path denotes that the Entry itself is referenced in the Entry Link.
+                "type": "A String", # Required. Immutable. The reference type of the Entry.
+              },
+            ],
+            "name": "A String", # Output only. Immutable. Identifier. The relative resource name of the Entry Link, of the form: projects/{project_id_or_number}/locations/{location_id}/entryGroups/{entry_group_id}/entryLinks/{entry_link_id}
+            "updateTime": "A String", # Output only. The time when the Entry Link was last updated.
+          },
+        },
+        "updateEntryRequest": { # Update Entry request. # Payload for updating an Entry.
+          "allowMissing": True or False, # Optional. If set to true and the entry doesn't exist, the service will create it.
+          "aspectKeys": [ # Optional. The map keys of the Aspects which the service should modify. It supports the following syntaxes: - matches an aspect of the given type and empty path. @path - matches an aspect of the given type and specified path. For example, to attach an aspect to a field that is specified by the schema aspect, the path should have the format Schema.. @* - matches aspects of the given type for all paths. *@path - matches aspects of all types on the given path.The service will not remove existing aspects matching the syntax unless delete_missing_aspects is set to true.If this field is left empty, the service treats it as specifying exactly those Aspects present in the request.
+            "A String",
+          ],
+          "deleteMissingAspects": True or False, # Optional. If set to true and the aspect_keys specify aspect ranges, the service deletes any existing aspects from that range that weren't provided in the request.
+          "entry": { # An entry is a representation of a data resource that can be described by various metadata. # Required. Entry resource.
+            "aspects": { # Optional. The aspects that are attached to the entry. Depending on how the aspect is attached to the entry, the format of the aspect key can be one of the following: If the aspect is attached directly to the entry: {project_id_or_number}.{location_id}.{aspect_type_id} If the aspect is attached to an entry's path: {project_id_or_number}.{location_id}.{aspect_type_id}@{path}
+              "a_key": { # Represents a single piece of metadata describing an entry or entry link.
+                "aspectSource": { # Information related to the source system of the aspect. # Optional. Information related to the source system of the aspect.
+                  "createTime": "A String", # The time the aspect was created in the source system.
+                  "dataVersion": "A String", # The version of the data format used to produce this data. This field is used to indicated when the underlying data format changes (e.g., schema modifications, changes to the source URL format definition, etc).
+                  "updateTime": "A String", # The time the aspect was last updated in the source system.
+                },
+                "aspectType": "A String", # Output only. The resource name of the type used to create this Aspect.
+                "createTime": "A String", # Output only. The time when the Aspect was created.
+                "data": { # Required. The content of the aspect, according to its aspect type schema. The maximum size of the field is 120KB (encoded as UTF-8).
+                  "a_key": "", # Properties of the object.
+                },
+                "path": "A String", # Output only. The path in the entry under which the aspect is attached.
+                "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 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.
+                  "name": "A String", # Optional. The name of the ancestor resource.
+                  "type": "A String", # Optional. The type of the ancestor resource.
+                },
+              ],
+              "createTime": "A String", # The time when the resource was created in the source system.
+              "description": "A String", # A description of the data resource. Maximum length is 2,000 characters.
+              "displayName": "A String", # A user-friendly display name. Maximum length is 500 characters.
+              "labels": { # User-defined labels. The maximum size of keys and values is 128 characters each.
+                "a_key": "A String",
+              },
+              "location": "A String", # Output only. Location of the resource in the source system. You can search the entry by this location. By default, this should match the location of the entry group containing this entry. A different value allows capturing the source location for data external to Google Cloud.
+              "platform": "A String", # The platform containing the source system. Maximum length is 64 characters.
+              "resource": "A String", # The name of the resource in the source system. Maximum length is 4,000 characters.
+              "system": "A String", # The name of the source system. Maximum length is 64 characters.
+              "updateTime": "A String", # The time when the resource was last updated in the source system. If the entry exists in the system and its EntrySource has update_time populated, further updates to the EntrySource of the entry must provide incremental updates to its update_time.
+            },
+            "entryType": "A String", # Required. Immutable. The relative resource name of the entry type that was used to create this entry, in the format projects/{project_id_or_number}/locations/{location_id}/entryTypes/{entry_type_id}.
+            "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 Universal Catalog.
+          },
+          "updateMask": "A String", # Optional. Mask of fields to update. To update Aspects, the update_mask must contain the value "aspects".If the update_mask is empty, the service will update all modifiable fields present in the request.
+        },
+      },
+    ],
+    "description": { # Description of the batch change. # Optional. Text description of the batch change.
+      "content": "A String", # Optional. The text description content.
+      "job": { # Description of the job that created the batch change. # Optional. The job that created the batch change.
+        "name": "A String", # Optional. The name of the job that created the batch change. For example: projects/{project_number}/locations/{location_id}/enrichmentTasks/{enrichment_task_id}/runs/{enrichment_run_id}
+        "runTime": "A String", # Optional. The start time of the job run that created the batch change.
+      },
+    },
+    "name": "A String", # Required. The resource name of the EntryGroup on which the batch change applies. Format: projects/{project_number_or_id}/locations/{location_id}/entryGroups/{entry_group_id}
+  },
+  "batchChangeMetadataResponse": { # Response message for BatchChangeMetadata. # Output only. Result of applying a batch change metadata request.
+    "failedRequests": { # A map of failed requests for a batch change, where the key is the 0-based index of the failed request in the batch and the value is the error status. If all operations succeeded, this map is empty.
+      "a_key": { # The Status type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by gRPC (https://github.com/grpc). Each Status message contains three pieces of data: error code, error message, and error details.You can find out more about this error model and how to work with it in the API Design Guide (https://cloud.google.com/apis/design/errors).
+        "code": 42, # The status code, which should be an enum value of google.rpc.Code.
+        "details": [ # A list of messages that carry the error details. There is a common set of message types for APIs to use.
+          {
+            "a_key": "", # Properties of the object. Contains field @type with type URL.
+          },
+        ],
+        "message": "A String", # A developer-facing error message, which should be in English. Any user-facing error message should be localized and sent in the google.rpc.Status.details field, or localized by the client.
+      },
+    },
+  },
   "changeType": "A String", # Output only. The type of change represented by the change_payload. This field is derived from the populated field in the change_payload oneof.
   "createEntry": { # Create Entry request. # Payload for creating an Entry.
     "entry": { # An entry is a representation of a data resource that can be described by various metadata. # Required. Entry resource.
@@ -783,6 +1181,205 @@ 
Method Details

     { # Represents a proposed change to a metadata resource.
       "approver": "A String", # Output only. The email address of the user who approved/rejected the ChangeRequest.
       "author": "A String", # Output only. The email address of the user who created the ChangeRequest.
+      "batchChangeMetadataRequest": { # Request message for batch changing metadata. Requires permission to perform the underlying change, depending on the type and content of the change. Per operation, required permissions are: - for CreateEntry: dataplex.entries.create - for UpdateEntry: dataplex.entries.update - for DeleteEntry: dataplex.entries.delete - for CreateEntryLink: dataplex.entryLinks.create - for UpdateEntryLink: dataplex.entryLinks.update - for DeleteEntryLink: dataplex.entryLinks.deleteAnd per used type permissions are: - for EntryType: dataplex.entryTypes.use or dataplex.entryGroups.useEntry for reusable built-in types, - for AspectType: dataplex.aspectTypes.use or dataplex.entryGroups.useAspect for reusable built-in types and - for EntryLinkType: dataplex.entryLinkTypes.use or dataplex.entryGroups.useEntryLink for reusable built-in types. # Payload for executing a batch of catalog changes.
+        "changes": [ # Required. The list of changes to apply. Only a single change per resource is supported. Maximum number of changes supported is 250.
+          { # Detailed description of an individual change.
+            "createEntryLinkRequest": { # Request message for CreateEntryLink. # Payload for creating an EntryLink.
+              "entryLink": { # EntryLink represents a link between two Entries. # Required. Entry Link resource.
+                "aspects": { # Optional. The aspects that are attached to the entry link. The format of the aspect key has to be the following: {project_id_or_number}.{location_id}.{aspect_type_id} Currently, only a single aspect of a Dataplex-owned Aspect Type is allowed.
+                  "a_key": { # Represents a single piece of metadata describing an entry or entry link.
+                    "aspectSource": { # Information related to the source system of the aspect. # Optional. Information related to the source system of the aspect.
+                      "createTime": "A String", # The time the aspect was created in the source system.
+                      "dataVersion": "A String", # The version of the data format used to produce this data. This field is used to indicated when the underlying data format changes (e.g., schema modifications, changes to the source URL format definition, etc).
+                      "updateTime": "A String", # The time the aspect was last updated in the source system.
+                    },
+                    "aspectType": "A String", # Output only. The resource name of the type used to create this Aspect.
+                    "createTime": "A String", # Output only. The time when the Aspect was created.
+                    "data": { # Required. The content of the aspect, according to its aspect type schema. The maximum size of the field is 120KB (encoded as UTF-8).
+                      "a_key": "", # Properties of the object.
+                    },
+                    "path": "A String", # Output only. The path in the entry under which the aspect is attached.
+                    "updateTime": "A String", # Output only. The time when the Aspect was last updated.
+                  },
+                },
+                "createTime": "A String", # Output only. The time when the Entry Link was created.
+                "entryLinkType": "A String", # Required. Immutable. Relative resource name of the Entry Link Type used to create this Entry Link. For example: Entry link between synonym terms in a glossary: projects/dataplex-types/locations/global/entryLinkTypes/synonym Entry link between related terms in a glossary: projects/dataplex-types/locations/global/entryLinkTypes/related Entry link between glossary terms and data assets: projects/dataplex-types/locations/global/entryLinkTypes/definition
+                "entryReferences": [ # Required. Immutable. Specifies the Entries referenced in the Entry Link. There should be exactly two entry references.
+                  { # Reference to the Entry that is linked through the Entry Link.
+                    "name": "A String", # Required. Immutable. The relative resource name of the referenced Entry, of the form: projects/{project_id_or_number}/locations/{location_id}/entryGroups/{entry_group_id}/entries/{entry_id}
+                    "path": "A String", # Immutable. The path in the Entry that is referenced in the Entry Link. Empty path denotes that the Entry itself is referenced in the Entry Link.
+                    "type": "A String", # Required. Immutable. The reference type of the Entry.
+                  },
+                ],
+                "name": "A String", # Output only. Immutable. Identifier. The relative resource name of the Entry Link, of the form: projects/{project_id_or_number}/locations/{location_id}/entryGroups/{entry_group_id}/entryLinks/{entry_link_id}
+                "updateTime": "A String", # Output only. The time when the Entry Link was last updated.
+              },
+              "entryLinkId": "A String", # Required. Entry Link identifier * Must contain only lowercase letters, numbers and hyphens. * Must start with a letter. * Must be between 1-63 characters. * Must end with a number or a letter. * Must be unique within the EntryGroup.
+              "parent": "A String", # Required. The resource name of the parent Entry Group: projects/{project_id_or_number}/locations/{location_id}/entryGroups/{entry_group_id}.
+            },
+            "createEntryRequest": { # Create Entry request. # Payload for creating an Entry.
+              "entry": { # An entry is a representation of a data resource that can be described by various metadata. # Required. Entry resource.
+                "aspects": { # Optional. The aspects that are attached to the entry. Depending on how the aspect is attached to the entry, the format of the aspect key can be one of the following: If the aspect is attached directly to the entry: {project_id_or_number}.{location_id}.{aspect_type_id} If the aspect is attached to an entry's path: {project_id_or_number}.{location_id}.{aspect_type_id}@{path}
+                  "a_key": { # Represents a single piece of metadata describing an entry or entry link.
+                    "aspectSource": { # Information related to the source system of the aspect. # Optional. Information related to the source system of the aspect.
+                      "createTime": "A String", # The time the aspect was created in the source system.
+                      "dataVersion": "A String", # The version of the data format used to produce this data. This field is used to indicated when the underlying data format changes (e.g., schema modifications, changes to the source URL format definition, etc).
+                      "updateTime": "A String", # The time the aspect was last updated in the source system.
+                    },
+                    "aspectType": "A String", # Output only. The resource name of the type used to create this Aspect.
+                    "createTime": "A String", # Output only. The time when the Aspect was created.
+                    "data": { # Required. The content of the aspect, according to its aspect type schema. The maximum size of the field is 120KB (encoded as UTF-8).
+                      "a_key": "", # Properties of the object.
+                    },
+                    "path": "A String", # Output only. The path in the entry under which the aspect is attached.
+                    "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 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.
+                      "name": "A String", # Optional. The name of the ancestor resource.
+                      "type": "A String", # Optional. The type of the ancestor resource.
+                    },
+                  ],
+                  "createTime": "A String", # The time when the resource was created in the source system.
+                  "description": "A String", # A description of the data resource. Maximum length is 2,000 characters.
+                  "displayName": "A String", # A user-friendly display name. Maximum length is 500 characters.
+                  "labels": { # User-defined labels. The maximum size of keys and values is 128 characters each.
+                    "a_key": "A String",
+                  },
+                  "location": "A String", # Output only. Location of the resource in the source system. You can search the entry by this location. By default, this should match the location of the entry group containing this entry. A different value allows capturing the source location for data external to Google Cloud.
+                  "platform": "A String", # The platform containing the source system. Maximum length is 64 characters.
+                  "resource": "A String", # The name of the resource in the source system. Maximum length is 4,000 characters.
+                  "system": "A String", # The name of the source system. Maximum length is 64 characters.
+                  "updateTime": "A String", # The time when the resource was last updated in the source system. If the entry exists in the system and its EntrySource has update_time populated, further updates to the EntrySource of the entry must provide incremental updates to its update_time.
+                },
+                "entryType": "A String", # Required. Immutable. The relative resource name of the entry type that was used to create this entry, in the format projects/{project_id_or_number}/locations/{location_id}/entryTypes/{entry_type_id}.
+                "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 Universal Catalog.
+              },
+              "entryId": "A 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.
+              "parent": "A String", # Required. The resource name of the parent Entry Group: projects/{project}/locations/{location}/entryGroups/{entry_group}.
+            },
+            "deleteEntryLinkRequest": { # Request message for DeleteEntryLink. # Payload for deleting an EntryLink.
+              "name": "A String", # Required. The resource name of the Entry Link: projects/{project_id_or_number}/locations/{location_id}/entryGroups/{entry_group_id}/entryLinks/{entry_link_id}.
+            },
+            "deleteEntryRequest": { # Delete Entry request. # Payload for deleting an Entry.
+              "name": "A String", # Required. The resource name of the Entry: projects/{project}/locations/{location}/entryGroups/{entry_group}/entries/{entry}.
+            },
+            "updateEntryLinkRequest": { # Request message for UpdateEntryLink method. # Payload for updating an EntryLink.
+              "allowMissing": True or False, # Optional. If set to true and the entry link doesn't exist, the service will create it.
+              "aspectKeys": [ # Optional. The map keys of the Aspects which the service should modify. It should be the aspect type reference in the format {project_id_or_number}.{location_id}.{aspect_type_id}.If this field is left empty, the service treats it as specifying exactly those Aspects present in the request.
+                "A String",
+              ],
+              "entryLink": { # EntryLink represents a link between two Entries. # Required. Entry Link resource.
+                "aspects": { # Optional. The aspects that are attached to the entry link. The format of the aspect key has to be the following: {project_id_or_number}.{location_id}.{aspect_type_id} Currently, only a single aspect of a Dataplex-owned Aspect Type is allowed.
+                  "a_key": { # Represents a single piece of metadata describing an entry or entry link.
+                    "aspectSource": { # Information related to the source system of the aspect. # Optional. Information related to the source system of the aspect.
+                      "createTime": "A String", # The time the aspect was created in the source system.
+                      "dataVersion": "A String", # The version of the data format used to produce this data. This field is used to indicated when the underlying data format changes (e.g., schema modifications, changes to the source URL format definition, etc).
+                      "updateTime": "A String", # The time the aspect was last updated in the source system.
+                    },
+                    "aspectType": "A String", # Output only. The resource name of the type used to create this Aspect.
+                    "createTime": "A String", # Output only. The time when the Aspect was created.
+                    "data": { # Required. The content of the aspect, according to its aspect type schema. The maximum size of the field is 120KB (encoded as UTF-8).
+                      "a_key": "", # Properties of the object.
+                    },
+                    "path": "A String", # Output only. The path in the entry under which the aspect is attached.
+                    "updateTime": "A String", # Output only. The time when the Aspect was last updated.
+                  },
+                },
+                "createTime": "A String", # Output only. The time when the Entry Link was created.
+                "entryLinkType": "A String", # Required. Immutable. Relative resource name of the Entry Link Type used to create this Entry Link. For example: Entry link between synonym terms in a glossary: projects/dataplex-types/locations/global/entryLinkTypes/synonym Entry link between related terms in a glossary: projects/dataplex-types/locations/global/entryLinkTypes/related Entry link between glossary terms and data assets: projects/dataplex-types/locations/global/entryLinkTypes/definition
+                "entryReferences": [ # Required. Immutable. Specifies the Entries referenced in the Entry Link. There should be exactly two entry references.
+                  { # Reference to the Entry that is linked through the Entry Link.
+                    "name": "A String", # Required. Immutable. The relative resource name of the referenced Entry, of the form: projects/{project_id_or_number}/locations/{location_id}/entryGroups/{entry_group_id}/entries/{entry_id}
+                    "path": "A String", # Immutable. The path in the Entry that is referenced in the Entry Link. Empty path denotes that the Entry itself is referenced in the Entry Link.
+                    "type": "A String", # Required. Immutable. The reference type of the Entry.
+                  },
+                ],
+                "name": "A String", # Output only. Immutable. Identifier. The relative resource name of the Entry Link, of the form: projects/{project_id_or_number}/locations/{location_id}/entryGroups/{entry_group_id}/entryLinks/{entry_link_id}
+                "updateTime": "A String", # Output only. The time when the Entry Link was last updated.
+              },
+            },
+            "updateEntryRequest": { # Update Entry request. # Payload for updating an Entry.
+              "allowMissing": True or False, # Optional. If set to true and the entry doesn't exist, the service will create it.
+              "aspectKeys": [ # Optional. The map keys of the Aspects which the service should modify. It supports the following syntaxes: - matches an aspect of the given type and empty path. @path - matches an aspect of the given type and specified path. For example, to attach an aspect to a field that is specified by the schema aspect, the path should have the format Schema.. @* - matches aspects of the given type for all paths. *@path - matches aspects of all types on the given path.The service will not remove existing aspects matching the syntax unless delete_missing_aspects is set to true.If this field is left empty, the service treats it as specifying exactly those Aspects present in the request.
+                "A String",
+              ],
+              "deleteMissingAspects": True or False, # Optional. If set to true and the aspect_keys specify aspect ranges, the service deletes any existing aspects from that range that weren't provided in the request.
+              "entry": { # An entry is a representation of a data resource that can be described by various metadata. # Required. Entry resource.
+                "aspects": { # Optional. The aspects that are attached to the entry. Depending on how the aspect is attached to the entry, the format of the aspect key can be one of the following: If the aspect is attached directly to the entry: {project_id_or_number}.{location_id}.{aspect_type_id} If the aspect is attached to an entry's path: {project_id_or_number}.{location_id}.{aspect_type_id}@{path}
+                  "a_key": { # Represents a single piece of metadata describing an entry or entry link.
+                    "aspectSource": { # Information related to the source system of the aspect. # Optional. Information related to the source system of the aspect.
+                      "createTime": "A String", # The time the aspect was created in the source system.
+                      "dataVersion": "A String", # The version of the data format used to produce this data. This field is used to indicated when the underlying data format changes (e.g., schema modifications, changes to the source URL format definition, etc).
+                      "updateTime": "A String", # The time the aspect was last updated in the source system.
+                    },
+                    "aspectType": "A String", # Output only. The resource name of the type used to create this Aspect.
+                    "createTime": "A String", # Output only. The time when the Aspect was created.
+                    "data": { # Required. The content of the aspect, according to its aspect type schema. The maximum size of the field is 120KB (encoded as UTF-8).
+                      "a_key": "", # Properties of the object.
+                    },
+                    "path": "A String", # Output only. The path in the entry under which the aspect is attached.
+                    "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 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.
+                      "name": "A String", # Optional. The name of the ancestor resource.
+                      "type": "A String", # Optional. The type of the ancestor resource.
+                    },
+                  ],
+                  "createTime": "A String", # The time when the resource was created in the source system.
+                  "description": "A String", # A description of the data resource. Maximum length is 2,000 characters.
+                  "displayName": "A String", # A user-friendly display name. Maximum length is 500 characters.
+                  "labels": { # User-defined labels. The maximum size of keys and values is 128 characters each.
+                    "a_key": "A String",
+                  },
+                  "location": "A String", # Output only. Location of the resource in the source system. You can search the entry by this location. By default, this should match the location of the entry group containing this entry. A different value allows capturing the source location for data external to Google Cloud.
+                  "platform": "A String", # The platform containing the source system. Maximum length is 64 characters.
+                  "resource": "A String", # The name of the resource in the source system. Maximum length is 4,000 characters.
+                  "system": "A String", # The name of the source system. Maximum length is 64 characters.
+                  "updateTime": "A String", # The time when the resource was last updated in the source system. If the entry exists in the system and its EntrySource has update_time populated, further updates to the EntrySource of the entry must provide incremental updates to its update_time.
+                },
+                "entryType": "A String", # Required. Immutable. The relative resource name of the entry type that was used to create this entry, in the format projects/{project_id_or_number}/locations/{location_id}/entryTypes/{entry_type_id}.
+                "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 Universal Catalog.
+              },
+              "updateMask": "A String", # Optional. Mask of fields to update. To update Aspects, the update_mask must contain the value "aspects".If the update_mask is empty, the service will update all modifiable fields present in the request.
+            },
+          },
+        ],
+        "description": { # Description of the batch change. # Optional. Text description of the batch change.
+          "content": "A String", # Optional. The text description content.
+          "job": { # Description of the job that created the batch change. # Optional. The job that created the batch change.
+            "name": "A String", # Optional. The name of the job that created the batch change. For example: projects/{project_number}/locations/{location_id}/enrichmentTasks/{enrichment_task_id}/runs/{enrichment_run_id}
+            "runTime": "A String", # Optional. The start time of the job run that created the batch change.
+          },
+        },
+        "name": "A String", # Required. The resource name of the EntryGroup on which the batch change applies. Format: projects/{project_number_or_id}/locations/{location_id}/entryGroups/{entry_group_id}
+      },
+      "batchChangeMetadataResponse": { # Response message for BatchChangeMetadata. # Output only. Result of applying a batch change metadata request.
+        "failedRequests": { # A map of failed requests for a batch change, where the key is the 0-based index of the failed request in the batch and the value is the error status. If all operations succeeded, this map is empty.
+          "a_key": { # The Status type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by gRPC (https://github.com/grpc). Each Status message contains three pieces of data: error code, error message, and error details.You can find out more about this error model and how to work with it in the API Design Guide (https://cloud.google.com/apis/design/errors).
+            "code": 42, # The status code, which should be an enum value of google.rpc.Code.
+            "details": [ # A list of messages that carry the error details. There is a common set of message types for APIs to use.
+              {
+                "a_key": "", # Properties of the object. Contains field @type with type URL.
+              },
+            ],
+            "message": "A String", # A developer-facing error message, which should be in English. Any user-facing error message should be localized and sent in the google.rpc.Status.details field, or localized by the client.
+          },
+        },
+      },
       "changeType": "A String", # Output only. The type of change represented by the change_payload. This field is derived from the populated field in the change_payload oneof.
       "createEntry": { # Create Entry request. # Payload for creating an Entry.
         "entry": { # An entry is a representation of a data resource that can be described by various metadata. # Required. Entry resource.
@@ -1084,6 +1681,205 @@ 
Method Details

 { # Represents a proposed change to a metadata resource.
   "approver": "A String", # Output only. The email address of the user who approved/rejected the ChangeRequest.
   "author": "A String", # Output only. The email address of the user who created the ChangeRequest.
+  "batchChangeMetadataRequest": { # Request message for batch changing metadata. Requires permission to perform the underlying change, depending on the type and content of the change. Per operation, required permissions are: - for CreateEntry: dataplex.entries.create - for UpdateEntry: dataplex.entries.update - for DeleteEntry: dataplex.entries.delete - for CreateEntryLink: dataplex.entryLinks.create - for UpdateEntryLink: dataplex.entryLinks.update - for DeleteEntryLink: dataplex.entryLinks.deleteAnd per used type permissions are: - for EntryType: dataplex.entryTypes.use or dataplex.entryGroups.useEntry for reusable built-in types, - for AspectType: dataplex.aspectTypes.use or dataplex.entryGroups.useAspect for reusable built-in types and - for EntryLinkType: dataplex.entryLinkTypes.use or dataplex.entryGroups.useEntryLink for reusable built-in types. # Payload for executing a batch of catalog changes.
+    "changes": [ # Required. The list of changes to apply. Only a single change per resource is supported. Maximum number of changes supported is 250.
+      { # Detailed description of an individual change.
+        "createEntryLinkRequest": { # Request message for CreateEntryLink. # Payload for creating an EntryLink.
+          "entryLink": { # EntryLink represents a link between two Entries. # Required. Entry Link resource.
+            "aspects": { # Optional. The aspects that are attached to the entry link. The format of the aspect key has to be the following: {project_id_or_number}.{location_id}.{aspect_type_id} Currently, only a single aspect of a Dataplex-owned Aspect Type is allowed.
+              "a_key": { # Represents a single piece of metadata describing an entry or entry link.
+                "aspectSource": { # Information related to the source system of the aspect. # Optional. Information related to the source system of the aspect.
+                  "createTime": "A String", # The time the aspect was created in the source system.
+                  "dataVersion": "A String", # The version of the data format used to produce this data. This field is used to indicated when the underlying data format changes (e.g., schema modifications, changes to the source URL format definition, etc).
+                  "updateTime": "A String", # The time the aspect was last updated in the source system.
+                },
+                "aspectType": "A String", # Output only. The resource name of the type used to create this Aspect.
+                "createTime": "A String", # Output only. The time when the Aspect was created.
+                "data": { # Required. The content of the aspect, according to its aspect type schema. The maximum size of the field is 120KB (encoded as UTF-8).
+                  "a_key": "", # Properties of the object.
+                },
+                "path": "A String", # Output only. The path in the entry under which the aspect is attached.
+                "updateTime": "A String", # Output only. The time when the Aspect was last updated.
+              },
+            },
+            "createTime": "A String", # Output only. The time when the Entry Link was created.
+            "entryLinkType": "A String", # Required. Immutable. Relative resource name of the Entry Link Type used to create this Entry Link. For example: Entry link between synonym terms in a glossary: projects/dataplex-types/locations/global/entryLinkTypes/synonym Entry link between related terms in a glossary: projects/dataplex-types/locations/global/entryLinkTypes/related Entry link between glossary terms and data assets: projects/dataplex-types/locations/global/entryLinkTypes/definition
+            "entryReferences": [ # Required. Immutable. Specifies the Entries referenced in the Entry Link. There should be exactly two entry references.
+              { # Reference to the Entry that is linked through the Entry Link.
+                "name": "A String", # Required. Immutable. The relative resource name of the referenced Entry, of the form: projects/{project_id_or_number}/locations/{location_id}/entryGroups/{entry_group_id}/entries/{entry_id}
+                "path": "A String", # Immutable. The path in the Entry that is referenced in the Entry Link. Empty path denotes that the Entry itself is referenced in the Entry Link.
+                "type": "A String", # Required. Immutable. The reference type of the Entry.
+              },
+            ],
+            "name": "A String", # Output only. Immutable. Identifier. The relative resource name of the Entry Link, of the form: projects/{project_id_or_number}/locations/{location_id}/entryGroups/{entry_group_id}/entryLinks/{entry_link_id}
+            "updateTime": "A String", # Output only. The time when the Entry Link was last updated.
+          },
+          "entryLinkId": "A String", # Required. Entry Link identifier * Must contain only lowercase letters, numbers and hyphens. * Must start with a letter. * Must be between 1-63 characters. * Must end with a number or a letter. * Must be unique within the EntryGroup.
+          "parent": "A String", # Required. The resource name of the parent Entry Group: projects/{project_id_or_number}/locations/{location_id}/entryGroups/{entry_group_id}.
+        },
+        "createEntryRequest": { # Create Entry request. # Payload for creating an Entry.
+          "entry": { # An entry is a representation of a data resource that can be described by various metadata. # Required. Entry resource.
+            "aspects": { # Optional. The aspects that are attached to the entry. Depending on how the aspect is attached to the entry, the format of the aspect key can be one of the following: If the aspect is attached directly to the entry: {project_id_or_number}.{location_id}.{aspect_type_id} If the aspect is attached to an entry's path: {project_id_or_number}.{location_id}.{aspect_type_id}@{path}
+              "a_key": { # Represents a single piece of metadata describing an entry or entry link.
+                "aspectSource": { # Information related to the source system of the aspect. # Optional. Information related to the source system of the aspect.
+                  "createTime": "A String", # The time the aspect was created in the source system.
+                  "dataVersion": "A String", # The version of the data format used to produce this data. This field is used to indicated when the underlying data format changes (e.g., schema modifications, changes to the source URL format definition, etc).
+                  "updateTime": "A String", # The time the aspect was last updated in the source system.
+                },
+                "aspectType": "A String", # Output only. The resource name of the type used to create this Aspect.
+                "createTime": "A String", # Output only. The time when the Aspect was created.
+                "data": { # Required. The content of the aspect, according to its aspect type schema. The maximum size of the field is 120KB (encoded as UTF-8).
+                  "a_key": "", # Properties of the object.
+                },
+                "path": "A String", # Output only. The path in the entry under which the aspect is attached.
+                "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 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.
+                  "name": "A String", # Optional. The name of the ancestor resource.
+                  "type": "A String", # Optional. The type of the ancestor resource.
+                },
+              ],
+              "createTime": "A String", # The time when the resource was created in the source system.
+              "description": "A String", # A description of the data resource. Maximum length is 2,000 characters.
+              "displayName": "A String", # A user-friendly display name. Maximum length is 500 characters.
+              "labels": { # User-defined labels. The maximum size of keys and values is 128 characters each.
+                "a_key": "A String",
+              },
+              "location": "A String", # Output only. Location of the resource in the source system. You can search the entry by this location. By default, this should match the location of the entry group containing this entry. A different value allows capturing the source location for data external to Google Cloud.
+              "platform": "A String", # The platform containing the source system. Maximum length is 64 characters.
+              "resource": "A String", # The name of the resource in the source system. Maximum length is 4,000 characters.
+              "system": "A String", # The name of the source system. Maximum length is 64 characters.
+              "updateTime": "A String", # The time when the resource was last updated in the source system. If the entry exists in the system and its EntrySource has update_time populated, further updates to the EntrySource of the entry must provide incremental updates to its update_time.
+            },
+            "entryType": "A String", # Required. Immutable. The relative resource name of the entry type that was used to create this entry, in the format projects/{project_id_or_number}/locations/{location_id}/entryTypes/{entry_type_id}.
+            "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 Universal Catalog.
+          },
+          "entryId": "A 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.
+          "parent": "A String", # Required. The resource name of the parent Entry Group: projects/{project}/locations/{location}/entryGroups/{entry_group}.
+        },
+        "deleteEntryLinkRequest": { # Request message for DeleteEntryLink. # Payload for deleting an EntryLink.
+          "name": "A String", # Required. The resource name of the Entry Link: projects/{project_id_or_number}/locations/{location_id}/entryGroups/{entry_group_id}/entryLinks/{entry_link_id}.
+        },
+        "deleteEntryRequest": { # Delete Entry request. # Payload for deleting an Entry.
+          "name": "A String", # Required. The resource name of the Entry: projects/{project}/locations/{location}/entryGroups/{entry_group}/entries/{entry}.
+        },
+        "updateEntryLinkRequest": { # Request message for UpdateEntryLink method. # Payload for updating an EntryLink.
+          "allowMissing": True or False, # Optional. If set to true and the entry link doesn't exist, the service will create it.
+          "aspectKeys": [ # Optional. The map keys of the Aspects which the service should modify. It should be the aspect type reference in the format {project_id_or_number}.{location_id}.{aspect_type_id}.If this field is left empty, the service treats it as specifying exactly those Aspects present in the request.
+            "A String",
+          ],
+          "entryLink": { # EntryLink represents a link between two Entries. # Required. Entry Link resource.
+            "aspects": { # Optional. The aspects that are attached to the entry link. The format of the aspect key has to be the following: {project_id_or_number}.{location_id}.{aspect_type_id} Currently, only a single aspect of a Dataplex-owned Aspect Type is allowed.
+              "a_key": { # Represents a single piece of metadata describing an entry or entry link.
+                "aspectSource": { # Information related to the source system of the aspect. # Optional. Information related to the source system of the aspect.
+                  "createTime": "A String", # The time the aspect was created in the source system.
+                  "dataVersion": "A String", # The version of the data format used to produce this data. This field is used to indicated when the underlying data format changes (e.g., schema modifications, changes to the source URL format definition, etc).
+                  "updateTime": "A String", # The time the aspect was last updated in the source system.
+                },
+                "aspectType": "A String", # Output only. The resource name of the type used to create this Aspect.
+                "createTime": "A String", # Output only. The time when the Aspect was created.
+                "data": { # Required. The content of the aspect, according to its aspect type schema. The maximum size of the field is 120KB (encoded as UTF-8).
+                  "a_key": "", # Properties of the object.
+                },
+                "path": "A String", # Output only. The path in the entry under which the aspect is attached.
+                "updateTime": "A String", # Output only. The time when the Aspect was last updated.
+              },
+            },
+            "createTime": "A String", # Output only. The time when the Entry Link was created.
+            "entryLinkType": "A String", # Required. Immutable. Relative resource name of the Entry Link Type used to create this Entry Link. For example: Entry link between synonym terms in a glossary: projects/dataplex-types/locations/global/entryLinkTypes/synonym Entry link between related terms in a glossary: projects/dataplex-types/locations/global/entryLinkTypes/related Entry link between glossary terms and data assets: projects/dataplex-types/locations/global/entryLinkTypes/definition
+            "entryReferences": [ # Required. Immutable. Specifies the Entries referenced in the Entry Link. There should be exactly two entry references.
+              { # Reference to the Entry that is linked through the Entry Link.
+                "name": "A String", # Required. Immutable. The relative resource name of the referenced Entry, of the form: projects/{project_id_or_number}/locations/{location_id}/entryGroups/{entry_group_id}/entries/{entry_id}
+                "path": "A String", # Immutable. The path in the Entry that is referenced in the Entry Link. Empty path denotes that the Entry itself is referenced in the Entry Link.
+                "type": "A String", # Required. Immutable. The reference type of the Entry.
+              },
+            ],
+            "name": "A String", # Output only. Immutable. Identifier. The relative resource name of the Entry Link, of the form: projects/{project_id_or_number}/locations/{location_id}/entryGroups/{entry_group_id}/entryLinks/{entry_link_id}
+            "updateTime": "A String", # Output only. The time when the Entry Link was last updated.
+          },
+        },
+        "updateEntryRequest": { # Update Entry request. # Payload for updating an Entry.
+          "allowMissing": True or False, # Optional. If set to true and the entry doesn't exist, the service will create it.
+          "aspectKeys": [ # Optional. The map keys of the Aspects which the service should modify. It supports the following syntaxes: - matches an aspect of the given type and empty path. @path - matches an aspect of the given type and specified path. For example, to attach an aspect to a field that is specified by the schema aspect, the path should have the format Schema.. @* - matches aspects of the given type for all paths. *@path - matches aspects of all types on the given path.The service will not remove existing aspects matching the syntax unless delete_missing_aspects is set to true.If this field is left empty, the service treats it as specifying exactly those Aspects present in the request.
+            "A String",
+          ],
+          "deleteMissingAspects": True or False, # Optional. If set to true and the aspect_keys specify aspect ranges, the service deletes any existing aspects from that range that weren't provided in the request.
+          "entry": { # An entry is a representation of a data resource that can be described by various metadata. # Required. Entry resource.
+            "aspects": { # Optional. The aspects that are attached to the entry. Depending on how the aspect is attached to the entry, the format of the aspect key can be one of the following: If the aspect is attached directly to the entry: {project_id_or_number}.{location_id}.{aspect_type_id} If the aspect is attached to an entry's path: {project_id_or_number}.{location_id}.{aspect_type_id}@{path}
+              "a_key": { # Represents a single piece of metadata describing an entry or entry link.
+                "aspectSource": { # Information related to the source system of the aspect. # Optional. Information related to the source system of the aspect.
+                  "createTime": "A String", # The time the aspect was created in the source system.
+                  "dataVersion": "A String", # The version of the data format used to produce this data. This field is used to indicated when the underlying data format changes (e.g., schema modifications, changes to the source URL format definition, etc).
+                  "updateTime": "A String", # The time the aspect was last updated in the source system.
+                },
+                "aspectType": "A String", # Output only. The resource name of the type used to create this Aspect.
+                "createTime": "A String", # Output only. The time when the Aspect was created.
+                "data": { # Required. The content of the aspect, according to its aspect type schema. The maximum size of the field is 120KB (encoded as UTF-8).
+                  "a_key": "", # Properties of the object.
+                },
+                "path": "A String", # Output only. The path in the entry under which the aspect is attached.
+                "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 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.
+                  "name": "A String", # Optional. The name of the ancestor resource.
+                  "type": "A String", # Optional. The type of the ancestor resource.
+                },
+              ],
+              "createTime": "A String", # The time when the resource was created in the source system.
+              "description": "A String", # A description of the data resource. Maximum length is 2,000 characters.
+              "displayName": "A String", # A user-friendly display name. Maximum length is 500 characters.
+              "labels": { # User-defined labels. The maximum size of keys and values is 128 characters each.
+                "a_key": "A String",
+              },
+              "location": "A String", # Output only. Location of the resource in the source system. You can search the entry by this location. By default, this should match the location of the entry group containing this entry. A different value allows capturing the source location for data external to Google Cloud.
+              "platform": "A String", # The platform containing the source system. Maximum length is 64 characters.
+              "resource": "A String", # The name of the resource in the source system. Maximum length is 4,000 characters.
+              "system": "A String", # The name of the source system. Maximum length is 64 characters.
+              "updateTime": "A String", # The time when the resource was last updated in the source system. If the entry exists in the system and its EntrySource has update_time populated, further updates to the EntrySource of the entry must provide incremental updates to its update_time.
+            },
+            "entryType": "A String", # Required. Immutable. The relative resource name of the entry type that was used to create this entry, in the format projects/{project_id_or_number}/locations/{location_id}/entryTypes/{entry_type_id}.
+            "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 Universal Catalog.
+          },
+          "updateMask": "A String", # Optional. Mask of fields to update. To update Aspects, the update_mask must contain the value "aspects".If the update_mask is empty, the service will update all modifiable fields present in the request.
+        },
+      },
+    ],
+    "description": { # Description of the batch change. # Optional. Text description of the batch change.
+      "content": "A String", # Optional. The text description content.
+      "job": { # Description of the job that created the batch change. # Optional. The job that created the batch change.
+        "name": "A String", # Optional. The name of the job that created the batch change. For example: projects/{project_number}/locations/{location_id}/enrichmentTasks/{enrichment_task_id}/runs/{enrichment_run_id}
+        "runTime": "A String", # Optional. The start time of the job run that created the batch change.
+      },
+    },
+    "name": "A String", # Required. The resource name of the EntryGroup on which the batch change applies. Format: projects/{project_number_or_id}/locations/{location_id}/entryGroups/{entry_group_id}
+  },
+  "batchChangeMetadataResponse": { # Response message for BatchChangeMetadata. # Output only. Result of applying a batch change metadata request.
+    "failedRequests": { # A map of failed requests for a batch change, where the key is the 0-based index of the failed request in the batch and the value is the error status. If all operations succeeded, this map is empty.
+      "a_key": { # The Status type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by gRPC (https://github.com/grpc). Each Status message contains three pieces of data: error code, error message, and error details.You can find out more about this error model and how to work with it in the API Design Guide (https://cloud.google.com/apis/design/errors).
+        "code": 42, # The status code, which should be an enum value of google.rpc.Code.
+        "details": [ # A list of messages that carry the error details. There is a common set of message types for APIs to use.
+          {
+            "a_key": "", # Properties of the object. Contains field @type with type URL.
+          },
+        ],
+        "message": "A String", # A developer-facing error message, which should be in English. Any user-facing error message should be localized and sent in the google.rpc.Status.details field, or localized by the client.
+      },
+    },
+  },
   "changeType": "A String", # Output only. The type of change represented by the change_payload. This field is derived from the populated field in the change_payload oneof.
   "createEntry": { # Create Entry request. # Payload for creating an Entry.
     "entry": { # An entry is a representation of a data resource that can be described by various metadata. # Required. Entry resource.
@@ -1364,6 +2160,205 @@ 
Method Details

     { # Represents a proposed change to a metadata resource.
   "approver": "A String", # Output only. The email address of the user who approved/rejected the ChangeRequest.
   "author": "A String", # Output only. The email address of the user who created the ChangeRequest.
+  "batchChangeMetadataRequest": { # Request message for batch changing metadata. Requires permission to perform the underlying change, depending on the type and content of the change. Per operation, required permissions are: - for CreateEntry: dataplex.entries.create - for UpdateEntry: dataplex.entries.update - for DeleteEntry: dataplex.entries.delete - for CreateEntryLink: dataplex.entryLinks.create - for UpdateEntryLink: dataplex.entryLinks.update - for DeleteEntryLink: dataplex.entryLinks.deleteAnd per used type permissions are: - for EntryType: dataplex.entryTypes.use or dataplex.entryGroups.useEntry for reusable built-in types, - for AspectType: dataplex.aspectTypes.use or dataplex.entryGroups.useAspect for reusable built-in types and - for EntryLinkType: dataplex.entryLinkTypes.use or dataplex.entryGroups.useEntryLink for reusable built-in types. # Payload for executing a batch of catalog changes.
+    "changes": [ # Required. The list of changes to apply. Only a single change per resource is supported. Maximum number of changes supported is 250.
+      { # Detailed description of an individual change.
+        "createEntryLinkRequest": { # Request message for CreateEntryLink. # Payload for creating an EntryLink.
+          "entryLink": { # EntryLink represents a link between two Entries. # Required. Entry Link resource.
+            "aspects": { # Optional. The aspects that are attached to the entry link. The format of the aspect key has to be the following: {project_id_or_number}.{location_id}.{aspect_type_id} Currently, only a single aspect of a Dataplex-owned Aspect Type is allowed.
+              "a_key": { # Represents a single piece of metadata describing an entry or entry link.
+                "aspectSource": { # Information related to the source system of the aspect. # Optional. Information related to the source system of the aspect.
+                  "createTime": "A String", # The time the aspect was created in the source system.
+                  "dataVersion": "A String", # The version of the data format used to produce this data. This field is used to indicated when the underlying data format changes (e.g., schema modifications, changes to the source URL format definition, etc).
+                  "updateTime": "A String", # The time the aspect was last updated in the source system.
+                },
+                "aspectType": "A String", # Output only. The resource name of the type used to create this Aspect.
+                "createTime": "A String", # Output only. The time when the Aspect was created.
+                "data": { # Required. The content of the aspect, according to its aspect type schema. The maximum size of the field is 120KB (encoded as UTF-8).
+                  "a_key": "", # Properties of the object.
+                },
+                "path": "A String", # Output only. The path in the entry under which the aspect is attached.
+                "updateTime": "A String", # Output only. The time when the Aspect was last updated.
+              },
+            },
+            "createTime": "A String", # Output only. The time when the Entry Link was created.
+            "entryLinkType": "A String", # Required. Immutable. Relative resource name of the Entry Link Type used to create this Entry Link. For example: Entry link between synonym terms in a glossary: projects/dataplex-types/locations/global/entryLinkTypes/synonym Entry link between related terms in a glossary: projects/dataplex-types/locations/global/entryLinkTypes/related Entry link between glossary terms and data assets: projects/dataplex-types/locations/global/entryLinkTypes/definition
+            "entryReferences": [ # Required. Immutable. Specifies the Entries referenced in the Entry Link. There should be exactly two entry references.
+              { # Reference to the Entry that is linked through the Entry Link.
+                "name": "A String", # Required. Immutable. The relative resource name of the referenced Entry, of the form: projects/{project_id_or_number}/locations/{location_id}/entryGroups/{entry_group_id}/entries/{entry_id}
+                "path": "A String", # Immutable. The path in the Entry that is referenced in the Entry Link. Empty path denotes that the Entry itself is referenced in the Entry Link.
+                "type": "A String", # Required. Immutable. The reference type of the Entry.
+              },
+            ],
+            "name": "A String", # Output only. Immutable. Identifier. The relative resource name of the Entry Link, of the form: projects/{project_id_or_number}/locations/{location_id}/entryGroups/{entry_group_id}/entryLinks/{entry_link_id}
+            "updateTime": "A String", # Output only. The time when the Entry Link was last updated.
+          },
+          "entryLinkId": "A String", # Required. Entry Link identifier * Must contain only lowercase letters, numbers and hyphens. * Must start with a letter. * Must be between 1-63 characters. * Must end with a number or a letter. * Must be unique within the EntryGroup.
+          "parent": "A String", # Required. The resource name of the parent Entry Group: projects/{project_id_or_number}/locations/{location_id}/entryGroups/{entry_group_id}.
+        },
+        "createEntryRequest": { # Create Entry request. # Payload for creating an Entry.
+          "entry": { # An entry is a representation of a data resource that can be described by various metadata. # Required. Entry resource.
+            "aspects": { # Optional. The aspects that are attached to the entry. Depending on how the aspect is attached to the entry, the format of the aspect key can be one of the following: If the aspect is attached directly to the entry: {project_id_or_number}.{location_id}.{aspect_type_id} If the aspect is attached to an entry's path: {project_id_or_number}.{location_id}.{aspect_type_id}@{path}
+              "a_key": { # Represents a single piece of metadata describing an entry or entry link.
+                "aspectSource": { # Information related to the source system of the aspect. # Optional. Information related to the source system of the aspect.
+                  "createTime": "A String", # The time the aspect was created in the source system.
+                  "dataVersion": "A String", # The version of the data format used to produce this data. This field is used to indicated when the underlying data format changes (e.g., schema modifications, changes to the source URL format definition, etc).
+                  "updateTime": "A String", # The time the aspect was last updated in the source system.
+                },
+                "aspectType": "A String", # Output only. The resource name of the type used to create this Aspect.
+                "createTime": "A String", # Output only. The time when the Aspect was created.
+                "data": { # Required. The content of the aspect, according to its aspect type schema. The maximum size of the field is 120KB (encoded as UTF-8).
+                  "a_key": "", # Properties of the object.
+                },
+                "path": "A String", # Output only. The path in the entry under which the aspect is attached.
+                "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 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.
+                  "name": "A String", # Optional. The name of the ancestor resource.
+                  "type": "A String", # Optional. The type of the ancestor resource.
+                },
+              ],
+              "createTime": "A String", # The time when the resource was created in the source system.
+              "description": "A String", # A description of the data resource. Maximum length is 2,000 characters.
+              "displayName": "A String", # A user-friendly display name. Maximum length is 500 characters.
+              "labels": { # User-defined labels. The maximum size of keys and values is 128 characters each.
+                "a_key": "A String",
+              },
+              "location": "A String", # Output only. Location of the resource in the source system. You can search the entry by this location. By default, this should match the location of the entry group containing this entry. A different value allows capturing the source location for data external to Google Cloud.
+              "platform": "A String", # The platform containing the source system. Maximum length is 64 characters.
+              "resource": "A String", # The name of the resource in the source system. Maximum length is 4,000 characters.
+              "system": "A String", # The name of the source system. Maximum length is 64 characters.
+              "updateTime": "A String", # The time when the resource was last updated in the source system. If the entry exists in the system and its EntrySource has update_time populated, further updates to the EntrySource of the entry must provide incremental updates to its update_time.
+            },
+            "entryType": "A String", # Required. Immutable. The relative resource name of the entry type that was used to create this entry, in the format projects/{project_id_or_number}/locations/{location_id}/entryTypes/{entry_type_id}.
+            "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 Universal Catalog.
+          },
+          "entryId": "A 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.
+          "parent": "A String", # Required. The resource name of the parent Entry Group: projects/{project}/locations/{location}/entryGroups/{entry_group}.
+        },
+        "deleteEntryLinkRequest": { # Request message for DeleteEntryLink. # Payload for deleting an EntryLink.
+          "name": "A String", # Required. The resource name of the Entry Link: projects/{project_id_or_number}/locations/{location_id}/entryGroups/{entry_group_id}/entryLinks/{entry_link_id}.
+        },
+        "deleteEntryRequest": { # Delete Entry request. # Payload for deleting an Entry.
+          "name": "A String", # Required. The resource name of the Entry: projects/{project}/locations/{location}/entryGroups/{entry_group}/entries/{entry}.
+        },
+        "updateEntryLinkRequest": { # Request message for UpdateEntryLink method. # Payload for updating an EntryLink.
+          "allowMissing": True or False, # Optional. If set to true and the entry link doesn't exist, the service will create it.
+          "aspectKeys": [ # Optional. The map keys of the Aspects which the service should modify. It should be the aspect type reference in the format {project_id_or_number}.{location_id}.{aspect_type_id}.If this field is left empty, the service treats it as specifying exactly those Aspects present in the request.
+            "A String",
+          ],
+          "entryLink": { # EntryLink represents a link between two Entries. # Required. Entry Link resource.
+            "aspects": { # Optional. The aspects that are attached to the entry link. The format of the aspect key has to be the following: {project_id_or_number}.{location_id}.{aspect_type_id} Currently, only a single aspect of a Dataplex-owned Aspect Type is allowed.
+              "a_key": { # Represents a single piece of metadata describing an entry or entry link.
+                "aspectSource": { # Information related to the source system of the aspect. # Optional. Information related to the source system of the aspect.
+                  "createTime": "A String", # The time the aspect was created in the source system.
+                  "dataVersion": "A String", # The version of the data format used to produce this data. This field is used to indicated when the underlying data format changes (e.g., schema modifications, changes to the source URL format definition, etc).
+                  "updateTime": "A String", # The time the aspect was last updated in the source system.
+                },
+                "aspectType": "A String", # Output only. The resource name of the type used to create this Aspect.
+                "createTime": "A String", # Output only. The time when the Aspect was created.
+                "data": { # Required. The content of the aspect, according to its aspect type schema. The maximum size of the field is 120KB (encoded as UTF-8).
+                  "a_key": "", # Properties of the object.
+                },
+                "path": "A String", # Output only. The path in the entry under which the aspect is attached.
+                "updateTime": "A String", # Output only. The time when the Aspect was last updated.
+              },
+            },
+            "createTime": "A String", # Output only. The time when the Entry Link was created.
+            "entryLinkType": "A String", # Required. Immutable. Relative resource name of the Entry Link Type used to create this Entry Link. For example: Entry link between synonym terms in a glossary: projects/dataplex-types/locations/global/entryLinkTypes/synonym Entry link between related terms in a glossary: projects/dataplex-types/locations/global/entryLinkTypes/related Entry link between glossary terms and data assets: projects/dataplex-types/locations/global/entryLinkTypes/definition
+            "entryReferences": [ # Required. Immutable. Specifies the Entries referenced in the Entry Link. There should be exactly two entry references.
+              { # Reference to the Entry that is linked through the Entry Link.
+                "name": "A String", # Required. Immutable. The relative resource name of the referenced Entry, of the form: projects/{project_id_or_number}/locations/{location_id}/entryGroups/{entry_group_id}/entries/{entry_id}
+                "path": "A String", # Immutable. The path in the Entry that is referenced in the Entry Link. Empty path denotes that the Entry itself is referenced in the Entry Link.
+                "type": "A String", # Required. Immutable. The reference type of the Entry.
+              },
+            ],
+            "name": "A String", # Output only. Immutable. Identifier. The relative resource name of the Entry Link, of the form: projects/{project_id_or_number}/locations/{location_id}/entryGroups/{entry_group_id}/entryLinks/{entry_link_id}
+            "updateTime": "A String", # Output only. The time when the Entry Link was last updated.
+          },
+        },
+        "updateEntryRequest": { # Update Entry request. # Payload for updating an Entry.
+          "allowMissing": True or False, # Optional. If set to true and the entry doesn't exist, the service will create it.
+          "aspectKeys": [ # Optional. The map keys of the Aspects which the service should modify. It supports the following syntaxes: - matches an aspect of the given type and empty path. @path - matches an aspect of the given type and specified path. For example, to attach an aspect to a field that is specified by the schema aspect, the path should have the format Schema.. @* - matches aspects of the given type for all paths. *@path - matches aspects of all types on the given path.The service will not remove existing aspects matching the syntax unless delete_missing_aspects is set to true.If this field is left empty, the service treats it as specifying exactly those Aspects present in the request.
+            "A String",
+          ],
+          "deleteMissingAspects": True or False, # Optional. If set to true and the aspect_keys specify aspect ranges, the service deletes any existing aspects from that range that weren't provided in the request.
+          "entry": { # An entry is a representation of a data resource that can be described by various metadata. # Required. Entry resource.
+            "aspects": { # Optional. The aspects that are attached to the entry. Depending on how the aspect is attached to the entry, the format of the aspect key can be one of the following: If the aspect is attached directly to the entry: {project_id_or_number}.{location_id}.{aspect_type_id} If the aspect is attached to an entry's path: {project_id_or_number}.{location_id}.{aspect_type_id}@{path}
+              "a_key": { # Represents a single piece of metadata describing an entry or entry link.
+                "aspectSource": { # Information related to the source system of the aspect. # Optional. Information related to the source system of the aspect.
+                  "createTime": "A String", # The time the aspect was created in the source system.
+                  "dataVersion": "A String", # The version of the data format used to produce this data. This field is used to indicated when the underlying data format changes (e.g., schema modifications, changes to the source URL format definition, etc).
+                  "updateTime": "A String", # The time the aspect was last updated in the source system.
+                },
+                "aspectType": "A String", # Output only. The resource name of the type used to create this Aspect.
+                "createTime": "A String", # Output only. The time when the Aspect was created.
+                "data": { # Required. The content of the aspect, according to its aspect type schema. The maximum size of the field is 120KB (encoded as UTF-8).
+                  "a_key": "", # Properties of the object.
+                },
+                "path": "A String", # Output only. The path in the entry under which the aspect is attached.
+                "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 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.
+                  "name": "A String", # Optional. The name of the ancestor resource.
+                  "type": "A String", # Optional. The type of the ancestor resource.
+                },
+              ],
+              "createTime": "A String", # The time when the resource was created in the source system.
+              "description": "A String", # A description of the data resource. Maximum length is 2,000 characters.
+              "displayName": "A String", # A user-friendly display name. Maximum length is 500 characters.
+              "labels": { # User-defined labels. The maximum size of keys and values is 128 characters each.
+                "a_key": "A String",
+              },
+              "location": "A String", # Output only. Location of the resource in the source system. You can search the entry by this location. By default, this should match the location of the entry group containing this entry. A different value allows capturing the source location for data external to Google Cloud.
+              "platform": "A String", # The platform containing the source system. Maximum length is 64 characters.
+              "resource": "A String", # The name of the resource in the source system. Maximum length is 4,000 characters.
+              "system": "A String", # The name of the source system. Maximum length is 64 characters.
+              "updateTime": "A String", # The time when the resource was last updated in the source system. If the entry exists in the system and its EntrySource has update_time populated, further updates to the EntrySource of the entry must provide incremental updates to its update_time.
+            },
+            "entryType": "A String", # Required. Immutable. The relative resource name of the entry type that was used to create this entry, in the format projects/{project_id_or_number}/locations/{location_id}/entryTypes/{entry_type_id}.
+            "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 Universal Catalog.
+          },
+          "updateMask": "A String", # Optional. Mask of fields to update. To update Aspects, the update_mask must contain the value "aspects".If the update_mask is empty, the service will update all modifiable fields present in the request.
+        },
+      },
+    ],
+    "description": { # Description of the batch change. # Optional. Text description of the batch change.
+      "content": "A String", # Optional. The text description content.
+      "job": { # Description of the job that created the batch change. # Optional. The job that created the batch change.
+        "name": "A String", # Optional. The name of the job that created the batch change. For example: projects/{project_number}/locations/{location_id}/enrichmentTasks/{enrichment_task_id}/runs/{enrichment_run_id}
+        "runTime": "A String", # Optional. The start time of the job run that created the batch change.
+      },
+    },
+    "name": "A String", # Required. The resource name of the EntryGroup on which the batch change applies. Format: projects/{project_number_or_id}/locations/{location_id}/entryGroups/{entry_group_id}
+  },
+  "batchChangeMetadataResponse": { # Response message for BatchChangeMetadata. # Output only. Result of applying a batch change metadata request.
+    "failedRequests": { # A map of failed requests for a batch change, where the key is the 0-based index of the failed request in the batch and the value is the error status. If all operations succeeded, this map is empty.
+      "a_key": { # The Status type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by gRPC (https://github.com/grpc). Each Status message contains three pieces of data: error code, error message, and error details.You can find out more about this error model and how to work with it in the API Design Guide (https://cloud.google.com/apis/design/errors).
+        "code": 42, # The status code, which should be an enum value of google.rpc.Code.
+        "details": [ # A list of messages that carry the error details. There is a common set of message types for APIs to use.
+          {
+            "a_key": "", # Properties of the object. Contains field @type with type URL.
+          },
+        ],
+        "message": "A String", # A developer-facing error message, which should be in English. Any user-facing error message should be localized and sent in the google.rpc.Status.details field, or localized by the client.
+      },
+    },
+  },
   "changeType": "A String", # Output only. The type of change represented by the change_payload. This field is derived from the populated field in the change_payload oneof.
   "createEntry": { # Create Entry request. # Payload for creating an Entry.
     "entry": { # An entry is a representation of a data resource that can be described by various metadata. # Required. Entry resource.
@@ -1658,6 +2653,205 @@ 
Method Details

     { # Represents a proposed change to a metadata resource.
   "approver": "A String", # Output only. The email address of the user who approved/rejected the ChangeRequest.
   "author": "A String", # Output only. The email address of the user who created the ChangeRequest.
+  "batchChangeMetadataRequest": { # Request message for batch changing metadata. Requires permission to perform the underlying change, depending on the type and content of the change. Per operation, required permissions are: - for CreateEntry: dataplex.entries.create - for UpdateEntry: dataplex.entries.update - for DeleteEntry: dataplex.entries.delete - for CreateEntryLink: dataplex.entryLinks.create - for UpdateEntryLink: dataplex.entryLinks.update - for DeleteEntryLink: dataplex.entryLinks.deleteAnd per used type permissions are: - for EntryType: dataplex.entryTypes.use or dataplex.entryGroups.useEntry for reusable built-in types, - for AspectType: dataplex.aspectTypes.use or dataplex.entryGroups.useAspect for reusable built-in types and - for EntryLinkType: dataplex.entryLinkTypes.use or dataplex.entryGroups.useEntryLink for reusable built-in types. # Payload for executing a batch of catalog changes.
+    "changes": [ # Required. The list of changes to apply. Only a single change per resource is supported. Maximum number of changes supported is 250.
+      { # Detailed description of an individual change.
+        "createEntryLinkRequest": { # Request message for CreateEntryLink. # Payload for creating an EntryLink.
+          "entryLink": { # EntryLink represents a link between two Entries. # Required. Entry Link resource.
+            "aspects": { # Optional. The aspects that are attached to the entry link. The format of the aspect key has to be the following: {project_id_or_number}.{location_id}.{aspect_type_id} Currently, only a single aspect of a Dataplex-owned Aspect Type is allowed.
+              "a_key": { # Represents a single piece of metadata describing an entry or entry link.
+                "aspectSource": { # Information related to the source system of the aspect. # Optional. Information related to the source system of the aspect.
+                  "createTime": "A String", # The time the aspect was created in the source system.
+                  "dataVersion": "A String", # The version of the data format used to produce this data. This field is used to indicated when the underlying data format changes (e.g., schema modifications, changes to the source URL format definition, etc).
+                  "updateTime": "A String", # The time the aspect was last updated in the source system.
+                },
+                "aspectType": "A String", # Output only. The resource name of the type used to create this Aspect.
+                "createTime": "A String", # Output only. The time when the Aspect was created.
+                "data": { # Required. The content of the aspect, according to its aspect type schema. The maximum size of the field is 120KB (encoded as UTF-8).
+                  "a_key": "", # Properties of the object.
+                },
+                "path": "A String", # Output only. The path in the entry under which the aspect is attached.
+                "updateTime": "A String", # Output only. The time when the Aspect was last updated.
+              },
+            },
+            "createTime": "A String", # Output only. The time when the Entry Link was created.
+            "entryLinkType": "A String", # Required. Immutable. Relative resource name of the Entry Link Type used to create this Entry Link. For example: Entry link between synonym terms in a glossary: projects/dataplex-types/locations/global/entryLinkTypes/synonym Entry link between related terms in a glossary: projects/dataplex-types/locations/global/entryLinkTypes/related Entry link between glossary terms and data assets: projects/dataplex-types/locations/global/entryLinkTypes/definition
+            "entryReferences": [ # Required. Immutable. Specifies the Entries referenced in the Entry Link. There should be exactly two entry references.
+              { # Reference to the Entry that is linked through the Entry Link.
+                "name": "A String", # Required. Immutable. The relative resource name of the referenced Entry, of the form: projects/{project_id_or_number}/locations/{location_id}/entryGroups/{entry_group_id}/entries/{entry_id}
+                "path": "A String", # Immutable. The path in the Entry that is referenced in the Entry Link. Empty path denotes that the Entry itself is referenced in the Entry Link.
+                "type": "A String", # Required. Immutable. The reference type of the Entry.
+              },
+            ],
+            "name": "A String", # Output only. Immutable. Identifier. The relative resource name of the Entry Link, of the form: projects/{project_id_or_number}/locations/{location_id}/entryGroups/{entry_group_id}/entryLinks/{entry_link_id}
+            "updateTime": "A String", # Output only. The time when the Entry Link was last updated.
+          },
+          "entryLinkId": "A String", # Required. Entry Link identifier * Must contain only lowercase letters, numbers and hyphens. * Must start with a letter. * Must be between 1-63 characters. * Must end with a number or a letter. * Must be unique within the EntryGroup.
+          "parent": "A String", # Required. The resource name of the parent Entry Group: projects/{project_id_or_number}/locations/{location_id}/entryGroups/{entry_group_id}.
+        },
+        "createEntryRequest": { # Create Entry request. # Payload for creating an Entry.
+          "entry": { # An entry is a representation of a data resource that can be described by various metadata. # Required. Entry resource.
+            "aspects": { # Optional. The aspects that are attached to the entry. Depending on how the aspect is attached to the entry, the format of the aspect key can be one of the following: If the aspect is attached directly to the entry: {project_id_or_number}.{location_id}.{aspect_type_id} If the aspect is attached to an entry's path: {project_id_or_number}.{location_id}.{aspect_type_id}@{path}
+              "a_key": { # Represents a single piece of metadata describing an entry or entry link.
+                "aspectSource": { # Information related to the source system of the aspect. # Optional. Information related to the source system of the aspect.
+                  "createTime": "A String", # The time the aspect was created in the source system.
+                  "dataVersion": "A String", # The version of the data format used to produce this data. This field is used to indicated when the underlying data format changes (e.g., schema modifications, changes to the source URL format definition, etc).
+                  "updateTime": "A String", # The time the aspect was last updated in the source system.
+                },
+                "aspectType": "A String", # Output only. The resource name of the type used to create this Aspect.
+                "createTime": "A String", # Output only. The time when the Aspect was created.
+                "data": { # Required. The content of the aspect, according to its aspect type schema. The maximum size of the field is 120KB (encoded as UTF-8).
+                  "a_key": "", # Properties of the object.
+                },
+                "path": "A String", # Output only. The path in the entry under which the aspect is attached.
+                "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 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.
+                  "name": "A String", # Optional. The name of the ancestor resource.
+                  "type": "A String", # Optional. The type of the ancestor resource.
+                },
+              ],
+              "createTime": "A String", # The time when the resource was created in the source system.
+              "description": "A String", # A description of the data resource. Maximum length is 2,000 characters.
+              "displayName": "A String", # A user-friendly display name. Maximum length is 500 characters.
+              "labels": { # User-defined labels. The maximum size of keys and values is 128 characters each.
+                "a_key": "A String",
+              },
+              "location": "A String", # Output only. Location of the resource in the source system. You can search the entry by this location. By default, this should match the location of the entry group containing this entry. A different value allows capturing the source location for data external to Google Cloud.
+              "platform": "A String", # The platform containing the source system. Maximum length is 64 characters.
+              "resource": "A String", # The name of the resource in the source system. Maximum length is 4,000 characters.
+              "system": "A String", # The name of the source system. Maximum length is 64 characters.
+              "updateTime": "A String", # The time when the resource was last updated in the source system. If the entry exists in the system and its EntrySource has update_time populated, further updates to the EntrySource of the entry must provide incremental updates to its update_time.
+            },
+            "entryType": "A String", # Required. Immutable. The relative resource name of the entry type that was used to create this entry, in the format projects/{project_id_or_number}/locations/{location_id}/entryTypes/{entry_type_id}.
+            "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 Universal Catalog.
+          },
+          "entryId": "A 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.
+          "parent": "A String", # Required. The resource name of the parent Entry Group: projects/{project}/locations/{location}/entryGroups/{entry_group}.
+        },
+        "deleteEntryLinkRequest": { # Request message for DeleteEntryLink. # Payload for deleting an EntryLink.
+          "name": "A String", # Required. The resource name of the Entry Link: projects/{project_id_or_number}/locations/{location_id}/entryGroups/{entry_group_id}/entryLinks/{entry_link_id}.
+        },
+        "deleteEntryRequest": { # Delete Entry request. # Payload for deleting an Entry.
+          "name": "A String", # Required. The resource name of the Entry: projects/{project}/locations/{location}/entryGroups/{entry_group}/entries/{entry}.
+        },
+        "updateEntryLinkRequest": { # Request message for UpdateEntryLink method. # Payload for updating an EntryLink.
+          "allowMissing": True or False, # Optional. If set to true and the entry link doesn't exist, the service will create it.
+          "aspectKeys": [ # Optional. The map keys of the Aspects which the service should modify. It should be the aspect type reference in the format {project_id_or_number}.{location_id}.{aspect_type_id}.If this field is left empty, the service treats it as specifying exactly those Aspects present in the request.
+            "A String",
+          ],
+          "entryLink": { # EntryLink represents a link between two Entries. # Required. Entry Link resource.
+            "aspects": { # Optional. The aspects that are attached to the entry link. The format of the aspect key has to be the following: {project_id_or_number}.{location_id}.{aspect_type_id} Currently, only a single aspect of a Dataplex-owned Aspect Type is allowed.
+              "a_key": { # Represents a single piece of metadata describing an entry or entry link.
+                "aspectSource": { # Information related to the source system of the aspect. # Optional. Information related to the source system of the aspect.
+                  "createTime": "A String", # The time the aspect was created in the source system.
+                  "dataVersion": "A String", # The version of the data format used to produce this data. This field is used to indicated when the underlying data format changes (e.g., schema modifications, changes to the source URL format definition, etc).
+                  "updateTime": "A String", # The time the aspect was last updated in the source system.
+                },
+                "aspectType": "A String", # Output only. The resource name of the type used to create this Aspect.
+                "createTime": "A String", # Output only. The time when the Aspect was created.
+                "data": { # Required. The content of the aspect, according to its aspect type schema. The maximum size of the field is 120KB (encoded as UTF-8).
+                  "a_key": "", # Properties of the object.
+                },
+                "path": "A String", # Output only. The path in the entry under which the aspect is attached.
+                "updateTime": "A String", # Output only. The time when the Aspect was last updated.
+              },
+            },
+            "createTime": "A String", # Output only. The time when the Entry Link was created.
+            "entryLinkType": "A String", # Required. Immutable. Relative resource name of the Entry Link Type used to create this Entry Link. For example: Entry link between synonym terms in a glossary: projects/dataplex-types/locations/global/entryLinkTypes/synonym Entry link between related terms in a glossary: projects/dataplex-types/locations/global/entryLinkTypes/related Entry link between glossary terms and data assets: projects/dataplex-types/locations/global/entryLinkTypes/definition
+            "entryReferences": [ # Required. Immutable. Specifies the Entries referenced in the Entry Link. There should be exactly two entry references.
+              { # Reference to the Entry that is linked through the Entry Link.
+                "name": "A String", # Required. Immutable. The relative resource name of the referenced Entry, of the form: projects/{project_id_or_number}/locations/{location_id}/entryGroups/{entry_group_id}/entries/{entry_id}
+                "path": "A String", # Immutable. The path in the Entry that is referenced in the Entry Link. Empty path denotes that the Entry itself is referenced in the Entry Link.
+                "type": "A String", # Required. Immutable. The reference type of the Entry.
+              },
+            ],
+            "name": "A String", # Output only. Immutable. Identifier. The relative resource name of the Entry Link, of the form: projects/{project_id_or_number}/locations/{location_id}/entryGroups/{entry_group_id}/entryLinks/{entry_link_id}
+            "updateTime": "A String", # Output only. The time when the Entry Link was last updated.
+          },
+        },
+        "updateEntryRequest": { # Update Entry request. # Payload for updating an Entry.
+          "allowMissing": True or False, # Optional. If set to true and the entry doesn't exist, the service will create it.
+          "aspectKeys": [ # Optional. The map keys of the Aspects which the service should modify. It supports the following syntaxes: - matches an aspect of the given type and empty path. @path - matches an aspect of the given type and specified path. For example, to attach an aspect to a field that is specified by the schema aspect, the path should have the format Schema.. @* - matches aspects of the given type for all paths. *@path - matches aspects of all types on the given path.The service will not remove existing aspects matching the syntax unless delete_missing_aspects is set to true.If this field is left empty, the service treats it as specifying exactly those Aspects present in the request.
+            "A String",
+          ],
+          "deleteMissingAspects": True or False, # Optional. If set to true and the aspect_keys specify aspect ranges, the service deletes any existing aspects from that range that weren't provided in the request.
+          "entry": { # An entry is a representation of a data resource that can be described by various metadata. # Required. Entry resource.
+            "aspects": { # Optional. The aspects that are attached to the entry. Depending on how the aspect is attached to the entry, the format of the aspect key can be one of the following: If the aspect is attached directly to the entry: {project_id_or_number}.{location_id}.{aspect_type_id} If the aspect is attached to an entry's path: {project_id_or_number}.{location_id}.{aspect_type_id}@{path}
+              "a_key": { # Represents a single piece of metadata describing an entry or entry link.
+                "aspectSource": { # Information related to the source system of the aspect. # Optional. Information related to the source system of the aspect.
+                  "createTime": "A String", # The time the aspect was created in the source system.
+                  "dataVersion": "A String", # The version of the data format used to produce this data. This field is used to indicated when the underlying data format changes (e.g., schema modifications, changes to the source URL format definition, etc).
+                  "updateTime": "A String", # The time the aspect was last updated in the source system.
+                },
+                "aspectType": "A String", # Output only. The resource name of the type used to create this Aspect.
+                "createTime": "A String", # Output only. The time when the Aspect was created.
+                "data": { # Required. The content of the aspect, according to its aspect type schema. The maximum size of the field is 120KB (encoded as UTF-8).
+                  "a_key": "", # Properties of the object.
+                },
+                "path": "A String", # Output only. The path in the entry under which the aspect is attached.
+                "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 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.
+                  "name": "A String", # Optional. The name of the ancestor resource.
+                  "type": "A String", # Optional. The type of the ancestor resource.
+                },
+              ],
+              "createTime": "A String", # The time when the resource was created in the source system.
+              "description": "A String", # A description of the data resource. Maximum length is 2,000 characters.
+              "displayName": "A String", # A user-friendly display name. Maximum length is 500 characters.
+              "labels": { # User-defined labels. The maximum size of keys and values is 128 characters each.
+                "a_key": "A String",
+              },
+              "location": "A String", # Output only. Location of the resource in the source system. You can search the entry by this location. By default, this should match the location of the entry group containing this entry. A different value allows capturing the source location for data external to Google Cloud.
+              "platform": "A String", # The platform containing the source system. Maximum length is 64 characters.
+              "resource": "A String", # The name of the resource in the source system. Maximum length is 4,000 characters.
+              "system": "A String", # The name of the source system. Maximum length is 64 characters.
+              "updateTime": "A String", # The time when the resource was last updated in the source system. If the entry exists in the system and its EntrySource has update_time populated, further updates to the EntrySource of the entry must provide incremental updates to its update_time.
+            },
+            "entryType": "A String", # Required. Immutable. The relative resource name of the entry type that was used to create this entry, in the format projects/{project_id_or_number}/locations/{location_id}/entryTypes/{entry_type_id}.
+            "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 Universal Catalog.
+          },
+          "updateMask": "A String", # Optional. Mask of fields to update. To update Aspects, the update_mask must contain the value "aspects".If the update_mask is empty, the service will update all modifiable fields present in the request.
+        },
+      },
+    ],
+    "description": { # Description of the batch change. # Optional. Text description of the batch change.
+      "content": "A String", # Optional. The text description content.
+      "job": { # Description of the job that created the batch change. # Optional. The job that created the batch change.
+        "name": "A String", # Optional. The name of the job that created the batch change. For example: projects/{project_number}/locations/{location_id}/enrichmentTasks/{enrichment_task_id}/runs/{enrichment_run_id}
+        "runTime": "A String", # Optional. The start time of the job run that created the batch change.
+      },
+    },
+    "name": "A String", # Required. The resource name of the EntryGroup on which the batch change applies. Format: projects/{project_number_or_id}/locations/{location_id}/entryGroups/{entry_group_id}
+  },
+  "batchChangeMetadataResponse": { # Response message for BatchChangeMetadata. # Output only. Result of applying a batch change metadata request.
+    "failedRequests": { # A map of failed requests for a batch change, where the key is the 0-based index of the failed request in the batch and the value is the error status. If all operations succeeded, this map is empty.
+      "a_key": { # The Status type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by gRPC (https://github.com/grpc). Each Status message contains three pieces of data: error code, error message, and error details.You can find out more about this error model and how to work with it in the API Design Guide (https://cloud.google.com/apis/design/errors).
+        "code": 42, # The status code, which should be an enum value of google.rpc.Code.
+        "details": [ # A list of messages that carry the error details. There is a common set of message types for APIs to use.
+          {
+            "a_key": "", # Properties of the object. Contains field @type with type URL.
+          },
+        ],
+        "message": "A String", # A developer-facing error message, which should be in English. Any user-facing error message should be localized and sent in the google.rpc.Status.details field, or localized by the client.
+      },
+    },
+  },
   "changeType": "A String", # Output only. The type of change represented by the change_payload. This field is derived from the populated field in the change_payload oneof.
   "createEntry": { # Create Entry request. # Payload for creating an Entry.
     "entry": { # An entry is a representation of a data resource that can be described by various metadata. # Required. Entry resource.
diff --git a/docs/dyn/dataplex_v1.projects.locations.dataProducts.html b/docs/dyn/dataplex_v1.projects.locations.dataProducts.html
index 5a16eaa08c..f8bbe09ea1 100644
--- a/docs/dyn/dataplex_v1.projects.locations.dataProducts.html
+++ b/docs/dyn/dataplex_v1.projects.locations.dataProducts.html
@@ -500,6 +500,205 @@ 
Method Details

   "changeRequest": { # Represents a proposed change to a metadata resource. # Required. The change request for the data product access request.
     "approver": "A String", # Output only. The email address of the user who approved/rejected the ChangeRequest.
     "author": "A String", # Output only. The email address of the user who created the ChangeRequest.
+    "batchChangeMetadataRequest": { # Request message for batch changing metadata. Requires permission to perform the underlying change, depending on the type and content of the change. Per operation, required permissions are: - for CreateEntry: dataplex.entries.create - for UpdateEntry: dataplex.entries.update - for DeleteEntry: dataplex.entries.delete - for CreateEntryLink: dataplex.entryLinks.create - for UpdateEntryLink: dataplex.entryLinks.update - for DeleteEntryLink: dataplex.entryLinks.deleteAnd per used type permissions are: - for EntryType: dataplex.entryTypes.use or dataplex.entryGroups.useEntry for reusable built-in types, - for AspectType: dataplex.aspectTypes.use or dataplex.entryGroups.useAspect for reusable built-in types and - for EntryLinkType: dataplex.entryLinkTypes.use or dataplex.entryGroups.useEntryLink for reusable built-in types. # Payload for executing a batch of catalog changes.
+      "changes": [ # Required. The list of changes to apply. Only a single change per resource is supported. Maximum number of changes supported is 250.
+        { # Detailed description of an individual change.
+          "createEntryLinkRequest": { # Request message for CreateEntryLink. # Payload for creating an EntryLink.
+            "entryLink": { # EntryLink represents a link between two Entries. # Required. Entry Link resource.
+              "aspects": { # Optional. The aspects that are attached to the entry link. The format of the aspect key has to be the following: {project_id_or_number}.{location_id}.{aspect_type_id} Currently, only a single aspect of a Dataplex-owned Aspect Type is allowed.
+                "a_key": { # Represents a single piece of metadata describing an entry or entry link.
+                  "aspectSource": { # Information related to the source system of the aspect. # Optional. Information related to the source system of the aspect.
+                    "createTime": "A String", # The time the aspect was created in the source system.
+                    "dataVersion": "A String", # The version of the data format used to produce this data. This field is used to indicated when the underlying data format changes (e.g., schema modifications, changes to the source URL format definition, etc).
+                    "updateTime": "A String", # The time the aspect was last updated in the source system.
+                  },
+                  "aspectType": "A String", # Output only. The resource name of the type used to create this Aspect.
+                  "createTime": "A String", # Output only. The time when the Aspect was created.
+                  "data": { # Required. The content of the aspect, according to its aspect type schema. The maximum size of the field is 120KB (encoded as UTF-8).
+                    "a_key": "", # Properties of the object.
+                  },
+                  "path": "A String", # Output only. The path in the entry under which the aspect is attached.
+                  "updateTime": "A String", # Output only. The time when the Aspect was last updated.
+                },
+              },
+              "createTime": "A String", # Output only. The time when the Entry Link was created.
+              "entryLinkType": "A String", # Required. Immutable. Relative resource name of the Entry Link Type used to create this Entry Link. For example: Entry link between synonym terms in a glossary: projects/dataplex-types/locations/global/entryLinkTypes/synonym Entry link between related terms in a glossary: projects/dataplex-types/locations/global/entryLinkTypes/related Entry link between glossary terms and data assets: projects/dataplex-types/locations/global/entryLinkTypes/definition
+              "entryReferences": [ # Required. Immutable. Specifies the Entries referenced in the Entry Link. There should be exactly two entry references.
+                { # Reference to the Entry that is linked through the Entry Link.
+                  "name": "A String", # Required. Immutable. The relative resource name of the referenced Entry, of the form: projects/{project_id_or_number}/locations/{location_id}/entryGroups/{entry_group_id}/entries/{entry_id}
+                  "path": "A String", # Immutable. The path in the Entry that is referenced in the Entry Link. Empty path denotes that the Entry itself is referenced in the Entry Link.
+                  "type": "A String", # Required. Immutable. The reference type of the Entry.
+                },
+              ],
+              "name": "A String", # Output only. Immutable. Identifier. The relative resource name of the Entry Link, of the form: projects/{project_id_or_number}/locations/{location_id}/entryGroups/{entry_group_id}/entryLinks/{entry_link_id}
+              "updateTime": "A String", # Output only. The time when the Entry Link was last updated.
+            },
+            "entryLinkId": "A String", # Required. Entry Link identifier * Must contain only lowercase letters, numbers and hyphens. * Must start with a letter. * Must be between 1-63 characters. * Must end with a number or a letter. * Must be unique within the EntryGroup.
+            "parent": "A String", # Required. The resource name of the parent Entry Group: projects/{project_id_or_number}/locations/{location_id}/entryGroups/{entry_group_id}.
+          },
+          "createEntryRequest": { # Create Entry request. # Payload for creating an Entry.
+            "entry": { # An entry is a representation of a data resource that can be described by various metadata. # Required. Entry resource.
+              "aspects": { # Optional. The aspects that are attached to the entry. Depending on how the aspect is attached to the entry, the format of the aspect key can be one of the following: If the aspect is attached directly to the entry: {project_id_or_number}.{location_id}.{aspect_type_id} If the aspect is attached to an entry's path: {project_id_or_number}.{location_id}.{aspect_type_id}@{path}
+                "a_key": { # Represents a single piece of metadata describing an entry or entry link.
+                  "aspectSource": { # Information related to the source system of the aspect. # Optional. Information related to the source system of the aspect.
+                    "createTime": "A String", # The time the aspect was created in the source system.
+                    "dataVersion": "A String", # The version of the data format used to produce this data. This field is used to indicated when the underlying data format changes (e.g., schema modifications, changes to the source URL format definition, etc).
+                    "updateTime": "A String", # The time the aspect was last updated in the source system.
+                  },
+                  "aspectType": "A String", # Output only. The resource name of the type used to create this Aspect.
+                  "createTime": "A String", # Output only. The time when the Aspect was created.
+                  "data": { # Required. The content of the aspect, according to its aspect type schema. The maximum size of the field is 120KB (encoded as UTF-8).
+                    "a_key": "", # Properties of the object.
+                  },
+                  "path": "A String", # Output only. The path in the entry under which the aspect is attached.
+                  "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 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.
+                    "name": "A String", # Optional. The name of the ancestor resource.
+                    "type": "A String", # Optional. The type of the ancestor resource.
+                  },
+                ],
+                "createTime": "A String", # The time when the resource was created in the source system.
+                "description": "A String", # A description of the data resource. Maximum length is 2,000 characters.
+                "displayName": "A String", # A user-friendly display name. Maximum length is 500 characters.
+                "labels": { # User-defined labels. The maximum size of keys and values is 128 characters each.
+                  "a_key": "A String",
+                },
+                "location": "A String", # Output only. Location of the resource in the source system. You can search the entry by this location. By default, this should match the location of the entry group containing this entry. A different value allows capturing the source location for data external to Google Cloud.
+                "platform": "A String", # The platform containing the source system. Maximum length is 64 characters.
+                "resource": "A String", # The name of the resource in the source system. Maximum length is 4,000 characters.
+                "system": "A String", # The name of the source system. Maximum length is 64 characters.
+                "updateTime": "A String", # The time when the resource was last updated in the source system. If the entry exists in the system and its EntrySource has update_time populated, further updates to the EntrySource of the entry must provide incremental updates to its update_time.
+              },
+              "entryType": "A String", # Required. Immutable. The relative resource name of the entry type that was used to create this entry, in the format projects/{project_id_or_number}/locations/{location_id}/entryTypes/{entry_type_id}.
+              "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 Universal Catalog.
+            },
+            "entryId": "A 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.
+            "parent": "A String", # Required. The resource name of the parent Entry Group: projects/{project}/locations/{location}/entryGroups/{entry_group}.
+          },
+          "deleteEntryLinkRequest": { # Request message for DeleteEntryLink. # Payload for deleting an EntryLink.
+            "name": "A String", # Required. The resource name of the Entry Link: projects/{project_id_or_number}/locations/{location_id}/entryGroups/{entry_group_id}/entryLinks/{entry_link_id}.
+          },
+          "deleteEntryRequest": { # Delete Entry request. # Payload for deleting an Entry.
+            "name": "A String", # Required. The resource name of the Entry: projects/{project}/locations/{location}/entryGroups/{entry_group}/entries/{entry}.
+          },
+          "updateEntryLinkRequest": { # Request message for UpdateEntryLink method. # Payload for updating an EntryLink.
+            "allowMissing": True or False, # Optional. If set to true and the entry link doesn't exist, the service will create it.
+            "aspectKeys": [ # Optional. The map keys of the Aspects which the service should modify. It should be the aspect type reference in the format {project_id_or_number}.{location_id}.{aspect_type_id}.If this field is left empty, the service treats it as specifying exactly those Aspects present in the request.
+              "A String",
+            ],
+            "entryLink": { # EntryLink represents a link between two Entries. # Required. Entry Link resource.
+              "aspects": { # Optional. The aspects that are attached to the entry link. The format of the aspect key has to be the following: {project_id_or_number}.{location_id}.{aspect_type_id} Currently, only a single aspect of a Dataplex-owned Aspect Type is allowed.
+                "a_key": { # Represents a single piece of metadata describing an entry or entry link.
+                  "aspectSource": { # Information related to the source system of the aspect. # Optional. Information related to the source system of the aspect.
+                    "createTime": "A String", # The time the aspect was created in the source system.
+                    "dataVersion": "A String", # The version of the data format used to produce this data. This field is used to indicated when the underlying data format changes (e.g., schema modifications, changes to the source URL format definition, etc).
+                    "updateTime": "A String", # The time the aspect was last updated in the source system.
+                  },
+                  "aspectType": "A String", # Output only. The resource name of the type used to create this Aspect.
+                  "createTime": "A String", # Output only. The time when the Aspect was created.
+                  "data": { # Required. The content of the aspect, according to its aspect type schema. The maximum size of the field is 120KB (encoded as UTF-8).
+                    "a_key": "", # Properties of the object.
+                  },
+                  "path": "A String", # Output only. The path in the entry under which the aspect is attached.
+                  "updateTime": "A String", # Output only. The time when the Aspect was last updated.
+                },
+              },
+              "createTime": "A String", # Output only. The time when the Entry Link was created.
+              "entryLinkType": "A String", # Required. Immutable. Relative resource name of the Entry Link Type used to create this Entry Link. For example: Entry link between synonym terms in a glossary: projects/dataplex-types/locations/global/entryLinkTypes/synonym Entry link between related terms in a glossary: projects/dataplex-types/locations/global/entryLinkTypes/related Entry link between glossary terms and data assets: projects/dataplex-types/locations/global/entryLinkTypes/definition
+              "entryReferences": [ # Required. Immutable. Specifies the Entries referenced in the Entry Link. There should be exactly two entry references.
+                { # Reference to the Entry that is linked through the Entry Link.
+                  "name": "A String", # Required. Immutable. The relative resource name of the referenced Entry, of the form: projects/{project_id_or_number}/locations/{location_id}/entryGroups/{entry_group_id}/entries/{entry_id}
+                  "path": "A String", # Immutable. The path in the Entry that is referenced in the Entry Link. Empty path denotes that the Entry itself is referenced in the Entry Link.
+                  "type": "A String", # Required. Immutable. The reference type of the Entry.
+                },
+              ],
+              "name": "A String", # Output only. Immutable. Identifier. The relative resource name of the Entry Link, of the form: projects/{project_id_or_number}/locations/{location_id}/entryGroups/{entry_group_id}/entryLinks/{entry_link_id}
+              "updateTime": "A String", # Output only. The time when the Entry Link was last updated.
+            },
+          },
+          "updateEntryRequest": { # Update Entry request. # Payload for updating an Entry.
+            "allowMissing": True or False, # Optional. If set to true and the entry doesn't exist, the service will create it.
+            "aspectKeys": [ # Optional. The map keys of the Aspects which the service should modify. It supports the following syntaxes: - matches an aspect of the given type and empty path. @path - matches an aspect of the given type and specified path. For example, to attach an aspect to a field that is specified by the schema aspect, the path should have the format Schema.. @* - matches aspects of the given type for all paths. *@path - matches aspects of all types on the given path.The service will not remove existing aspects matching the syntax unless delete_missing_aspects is set to true.If this field is left empty, the service treats it as specifying exactly those Aspects present in the request.
+              "A String",
+            ],
+            "deleteMissingAspects": True or False, # Optional. If set to true and the aspect_keys specify aspect ranges, the service deletes any existing aspects from that range that weren't provided in the request.
+            "entry": { # An entry is a representation of a data resource that can be described by various metadata. # Required. Entry resource.
+              "aspects": { # Optional. The aspects that are attached to the entry. Depending on how the aspect is attached to the entry, the format of the aspect key can be one of the following: If the aspect is attached directly to the entry: {project_id_or_number}.{location_id}.{aspect_type_id} If the aspect is attached to an entry's path: {project_id_or_number}.{location_id}.{aspect_type_id}@{path}
+                "a_key": { # Represents a single piece of metadata describing an entry or entry link.
+                  "aspectSource": { # Information related to the source system of the aspect. # Optional. Information related to the source system of the aspect.
+                    "createTime": "A String", # The time the aspect was created in the source system.
+                    "dataVersion": "A String", # The version of the data format used to produce this data. This field is used to indicated when the underlying data format changes (e.g., schema modifications, changes to the source URL format definition, etc).
+                    "updateTime": "A String", # The time the aspect was last updated in the source system.
+                  },
+                  "aspectType": "A String", # Output only. The resource name of the type used to create this Aspect.
+                  "createTime": "A String", # Output only. The time when the Aspect was created.
+                  "data": { # Required. The content of the aspect, according to its aspect type schema. The maximum size of the field is 120KB (encoded as UTF-8).
+                    "a_key": "", # Properties of the object.
+                  },
+                  "path": "A String", # Output only. The path in the entry under which the aspect is attached.
+                  "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 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.
+                    "name": "A String", # Optional. The name of the ancestor resource.
+                    "type": "A String", # Optional. The type of the ancestor resource.
+                  },
+                ],
+                "createTime": "A String", # The time when the resource was created in the source system.
+                "description": "A String", # A description of the data resource. Maximum length is 2,000 characters.
+                "displayName": "A String", # A user-friendly display name. Maximum length is 500 characters.
+                "labels": { # User-defined labels. The maximum size of keys and values is 128 characters each.
+                  "a_key": "A String",
+                },
+                "location": "A String", # Output only. Location of the resource in the source system. You can search the entry by this location. By default, this should match the location of the entry group containing this entry. A different value allows capturing the source location for data external to Google Cloud.
+                "platform": "A String", # The platform containing the source system. Maximum length is 64 characters.
+                "resource": "A String", # The name of the resource in the source system. Maximum length is 4,000 characters.
+                "system": "A String", # The name of the source system. Maximum length is 64 characters.
+                "updateTime": "A String", # The time when the resource was last updated in the source system. If the entry exists in the system and its EntrySource has update_time populated, further updates to the EntrySource of the entry must provide incremental updates to its update_time.
+              },
+              "entryType": "A String", # Required. Immutable. The relative resource name of the entry type that was used to create this entry, in the format projects/{project_id_or_number}/locations/{location_id}/entryTypes/{entry_type_id}.
+              "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 Universal Catalog.
+            },
+            "updateMask": "A String", # Optional. Mask of fields to update. To update Aspects, the update_mask must contain the value "aspects".If the update_mask is empty, the service will update all modifiable fields present in the request.
+          },
+        },
+      ],
+      "description": { # Description of the batch change. # Optional. Text description of the batch change.
+        "content": "A String", # Optional. The text description content.
+        "job": { # Description of the job that created the batch change. # Optional. The job that created the batch change.
+          "name": "A String", # Optional. The name of the job that created the batch change. For example: projects/{project_number}/locations/{location_id}/enrichmentTasks/{enrichment_task_id}/runs/{enrichment_run_id}
+          "runTime": "A String", # Optional. The start time of the job run that created the batch change.
+        },
+      },
+      "name": "A String", # Required. The resource name of the EntryGroup on which the batch change applies. Format: projects/{project_number_or_id}/locations/{location_id}/entryGroups/{entry_group_id}
+    },
+    "batchChangeMetadataResponse": { # Response message for BatchChangeMetadata. # Output only. Result of applying a batch change metadata request.
+      "failedRequests": { # A map of failed requests for a batch change, where the key is the 0-based index of the failed request in the batch and the value is the error status. If all operations succeeded, this map is empty.
+        "a_key": { # The Status type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by gRPC (https://github.com/grpc). Each Status message contains three pieces of data: error code, error message, and error details.You can find out more about this error model and how to work with it in the API Design Guide (https://cloud.google.com/apis/design/errors).
+          "code": 42, # The status code, which should be an enum value of google.rpc.Code.
+          "details": [ # A list of messages that carry the error details. There is a common set of message types for APIs to use.
+            {
+              "a_key": "", # Properties of the object. Contains field @type with type URL.
+            },
+          ],
+          "message": "A String", # A developer-facing error message, which should be in English. Any user-facing error message should be localized and sent in the google.rpc.Status.details field, or localized by the client.
+        },
+      },
+    },
     "changeType": "A String", # Output only. The type of change represented by the change_payload. This field is derived from the populated field in the change_payload oneof.
     "createEntry": { # Create Entry request. # Payload for creating an Entry.
       "entry": { # An entry is a representation of a data resource that can be described by various metadata. # Required. Entry resource.
diff --git a/docs/dyn/dataplex_v1.projects.locations.entryGroups.html b/docs/dyn/dataplex_v1.projects.locations.entryGroups.html
index ab17317755..4dbadeaa2a 100644
--- a/docs/dyn/dataplex_v1.projects.locations.entryGroups.html
+++ b/docs/dyn/dataplex_v1.projects.locations.entryGroups.html
@@ -84,6 +84,9 @@ 
Instance Methods

 

 
Returns the entryLinks Resource.

 
+

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

+
Batch changes metadata within an EntryGroup.

 

   close()

 
Close httplib2 connections.

@@ -108,6 +111,9 @@ 
Instance Methods

 

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

 
Updates an EntryGroup.

+

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

+
Submits a catalog change request for multiple resources within an EntryGroup. This method creates a ChangeRequest resource that must be reviewed and approved before the proposed changes are applied.

 

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

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

@@ -115,6 +121,231 @@ 
Instance Methods

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

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

 
Method Details

+

+    batchChangeMetadata(name, body=None, x__xgafv=None)
+  
Batch changes metadata within an EntryGroup.
+
+Args:
+  name: string, Required. The resource name of the EntryGroup on which the batch change applies. Format: projects/{project_number_or_id}/locations/{location_id}/entryGroups/{entry_group_id} (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # Request message for batch changing metadata. Requires permission to perform the underlying change, depending on the type and content of the change. Per operation, required permissions are: - for CreateEntry: dataplex.entries.create - for UpdateEntry: dataplex.entries.update - for DeleteEntry: dataplex.entries.delete - for CreateEntryLink: dataplex.entryLinks.create - for UpdateEntryLink: dataplex.entryLinks.update - for DeleteEntryLink: dataplex.entryLinks.deleteAnd per used type permissions are: - for EntryType: dataplex.entryTypes.use or dataplex.entryGroups.useEntry for reusable built-in types, - for AspectType: dataplex.aspectTypes.use or dataplex.entryGroups.useAspect for reusable built-in types and - for EntryLinkType: dataplex.entryLinkTypes.use or dataplex.entryGroups.useEntryLink for reusable built-in types.
+  "changes": [ # Required. The list of changes to apply. Only a single change per resource is supported. Maximum number of changes supported is 250.
+    { # Detailed description of an individual change.
+      "createEntryLinkRequest": { # Request message for CreateEntryLink. # Payload for creating an EntryLink.
+        "entryLink": { # EntryLink represents a link between two Entries. # Required. Entry Link resource.
+          "aspects": { # Optional. The aspects that are attached to the entry link. The format of the aspect key has to be the following: {project_id_or_number}.{location_id}.{aspect_type_id} Currently, only a single aspect of a Dataplex-owned Aspect Type is allowed.
+            "a_key": { # Represents a single piece of metadata describing an entry or entry link.
+              "aspectSource": { # Information related to the source system of the aspect. # Optional. Information related to the source system of the aspect.
+                "createTime": "A String", # The time the aspect was created in the source system.
+                "dataVersion": "A String", # The version of the data format used to produce this data. This field is used to indicated when the underlying data format changes (e.g., schema modifications, changes to the source URL format definition, etc).
+                "updateTime": "A String", # The time the aspect was last updated in the source system.
+              },
+              "aspectType": "A String", # Output only. The resource name of the type used to create this Aspect.
+              "createTime": "A String", # Output only. The time when the Aspect was created.
+              "data": { # Required. The content of the aspect, according to its aspect type schema. The maximum size of the field is 120KB (encoded as UTF-8).
+                "a_key": "", # Properties of the object.
+              },
+              "path": "A String", # Output only. The path in the entry under which the aspect is attached.
+              "updateTime": "A String", # Output only. The time when the Aspect was last updated.
+            },
+          },
+          "createTime": "A String", # Output only. The time when the Entry Link was created.
+          "entryLinkType": "A String", # Required. Immutable. Relative resource name of the Entry Link Type used to create this Entry Link. For example: Entry link between synonym terms in a glossary: projects/dataplex-types/locations/global/entryLinkTypes/synonym Entry link between related terms in a glossary: projects/dataplex-types/locations/global/entryLinkTypes/related Entry link between glossary terms and data assets: projects/dataplex-types/locations/global/entryLinkTypes/definition
+          "entryReferences": [ # Required. Immutable. Specifies the Entries referenced in the Entry Link. There should be exactly two entry references.
+            { # Reference to the Entry that is linked through the Entry Link.
+              "name": "A String", # Required. Immutable. The relative resource name of the referenced Entry, of the form: projects/{project_id_or_number}/locations/{location_id}/entryGroups/{entry_group_id}/entries/{entry_id}
+              "path": "A String", # Immutable. The path in the Entry that is referenced in the Entry Link. Empty path denotes that the Entry itself is referenced in the Entry Link.
+              "type": "A String", # Required. Immutable. The reference type of the Entry.
+            },
+          ],
+          "name": "A String", # Output only. Immutable. Identifier. The relative resource name of the Entry Link, of the form: projects/{project_id_or_number}/locations/{location_id}/entryGroups/{entry_group_id}/entryLinks/{entry_link_id}
+          "updateTime": "A String", # Output only. The time when the Entry Link was last updated.
+        },
+        "entryLinkId": "A String", # Required. Entry Link identifier * Must contain only lowercase letters, numbers and hyphens. * Must start with a letter. * Must be between 1-63 characters. * Must end with a number or a letter. * Must be unique within the EntryGroup.
+        "parent": "A String", # Required. The resource name of the parent Entry Group: projects/{project_id_or_number}/locations/{location_id}/entryGroups/{entry_group_id}.
+      },
+      "createEntryRequest": { # Create Entry request. # Payload for creating an Entry.
+        "entry": { # An entry is a representation of a data resource that can be described by various metadata. # Required. Entry resource.
+          "aspects": { # Optional. The aspects that are attached to the entry. Depending on how the aspect is attached to the entry, the format of the aspect key can be one of the following: If the aspect is attached directly to the entry: {project_id_or_number}.{location_id}.{aspect_type_id} If the aspect is attached to an entry's path: {project_id_or_number}.{location_id}.{aspect_type_id}@{path}
+            "a_key": { # Represents a single piece of metadata describing an entry or entry link.
+              "aspectSource": { # Information related to the source system of the aspect. # Optional. Information related to the source system of the aspect.
+                "createTime": "A String", # The time the aspect was created in the source system.
+                "dataVersion": "A String", # The version of the data format used to produce this data. This field is used to indicated when the underlying data format changes (e.g., schema modifications, changes to the source URL format definition, etc).
+                "updateTime": "A String", # The time the aspect was last updated in the source system.
+              },
+              "aspectType": "A String", # Output only. The resource name of the type used to create this Aspect.
+              "createTime": "A String", # Output only. The time when the Aspect was created.
+              "data": { # Required. The content of the aspect, according to its aspect type schema. The maximum size of the field is 120KB (encoded as UTF-8).
+                "a_key": "", # Properties of the object.
+              },
+              "path": "A String", # Output only. The path in the entry under which the aspect is attached.
+              "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 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.
+                "name": "A String", # Optional. The name of the ancestor resource.
+                "type": "A String", # Optional. The type of the ancestor resource.
+              },
+            ],
+            "createTime": "A String", # The time when the resource was created in the source system.
+            "description": "A String", # A description of the data resource. Maximum length is 2,000 characters.
+            "displayName": "A String", # A user-friendly display name. Maximum length is 500 characters.
+            "labels": { # User-defined labels. The maximum size of keys and values is 128 characters each.
+              "a_key": "A String",
+            },
+            "location": "A String", # Output only. Location of the resource in the source system. You can search the entry by this location. By default, this should match the location of the entry group containing this entry. A different value allows capturing the source location for data external to Google Cloud.
+            "platform": "A String", # The platform containing the source system. Maximum length is 64 characters.
+            "resource": "A String", # The name of the resource in the source system. Maximum length is 4,000 characters.
+            "system": "A String", # The name of the source system. Maximum length is 64 characters.
+            "updateTime": "A String", # The time when the resource was last updated in the source system. If the entry exists in the system and its EntrySource has update_time populated, further updates to the EntrySource of the entry must provide incremental updates to its update_time.
+          },
+          "entryType": "A String", # Required. Immutable. The relative resource name of the entry type that was used to create this entry, in the format projects/{project_id_or_number}/locations/{location_id}/entryTypes/{entry_type_id}.
+          "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 Universal Catalog.
+        },
+        "entryId": "A 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.
+        "parent": "A String", # Required. The resource name of the parent Entry Group: projects/{project}/locations/{location}/entryGroups/{entry_group}.
+      },
+      "deleteEntryLinkRequest": { # Request message for DeleteEntryLink. # Payload for deleting an EntryLink.
+        "name": "A String", # Required. The resource name of the Entry Link: projects/{project_id_or_number}/locations/{location_id}/entryGroups/{entry_group_id}/entryLinks/{entry_link_id}.
+      },
+      "deleteEntryRequest": { # Delete Entry request. # Payload for deleting an Entry.
+        "name": "A String", # Required. The resource name of the Entry: projects/{project}/locations/{location}/entryGroups/{entry_group}/entries/{entry}.
+      },
+      "updateEntryLinkRequest": { # Request message for UpdateEntryLink method. # Payload for updating an EntryLink.
+        "allowMissing": True or False, # Optional. If set to true and the entry link doesn't exist, the service will create it.
+        "aspectKeys": [ # Optional. The map keys of the Aspects which the service should modify. It should be the aspect type reference in the format {project_id_or_number}.{location_id}.{aspect_type_id}.If this field is left empty, the service treats it as specifying exactly those Aspects present in the request.
+          "A String",
+        ],
+        "entryLink": { # EntryLink represents a link between two Entries. # Required. Entry Link resource.
+          "aspects": { # Optional. The aspects that are attached to the entry link. The format of the aspect key has to be the following: {project_id_or_number}.{location_id}.{aspect_type_id} Currently, only a single aspect of a Dataplex-owned Aspect Type is allowed.
+            "a_key": { # Represents a single piece of metadata describing an entry or entry link.
+              "aspectSource": { # Information related to the source system of the aspect. # Optional. Information related to the source system of the aspect.
+                "createTime": "A String", # The time the aspect was created in the source system.
+                "dataVersion": "A String", # The version of the data format used to produce this data. This field is used to indicated when the underlying data format changes (e.g., schema modifications, changes to the source URL format definition, etc).
+                "updateTime": "A String", # The time the aspect was last updated in the source system.
+              },
+              "aspectType": "A String", # Output only. The resource name of the type used to create this Aspect.
+              "createTime": "A String", # Output only. The time when the Aspect was created.
+              "data": { # Required. The content of the aspect, according to its aspect type schema. The maximum size of the field is 120KB (encoded as UTF-8).
+                "a_key": "", # Properties of the object.
+              },
+              "path": "A String", # Output only. The path in the entry under which the aspect is attached.
+              "updateTime": "A String", # Output only. The time when the Aspect was last updated.
+            },
+          },
+          "createTime": "A String", # Output only. The time when the Entry Link was created.
+          "entryLinkType": "A String", # Required. Immutable. Relative resource name of the Entry Link Type used to create this Entry Link. For example: Entry link between synonym terms in a glossary: projects/dataplex-types/locations/global/entryLinkTypes/synonym Entry link between related terms in a glossary: projects/dataplex-types/locations/global/entryLinkTypes/related Entry link between glossary terms and data assets: projects/dataplex-types/locations/global/entryLinkTypes/definition
+          "entryReferences": [ # Required. Immutable. Specifies the Entries referenced in the Entry Link. There should be exactly two entry references.
+            { # Reference to the Entry that is linked through the Entry Link.
+              "name": "A String", # Required. Immutable. The relative resource name of the referenced Entry, of the form: projects/{project_id_or_number}/locations/{location_id}/entryGroups/{entry_group_id}/entries/{entry_id}
+              "path": "A String", # Immutable. The path in the Entry that is referenced in the Entry Link. Empty path denotes that the Entry itself is referenced in the Entry Link.
+              "type": "A String", # Required. Immutable. The reference type of the Entry.
+            },
+          ],
+          "name": "A String", # Output only. Immutable. Identifier. The relative resource name of the Entry Link, of the form: projects/{project_id_or_number}/locations/{location_id}/entryGroups/{entry_group_id}/entryLinks/{entry_link_id}
+          "updateTime": "A String", # Output only. The time when the Entry Link was last updated.
+        },
+      },
+      "updateEntryRequest": { # Update Entry request. # Payload for updating an Entry.
+        "allowMissing": True or False, # Optional. If set to true and the entry doesn't exist, the service will create it.
+        "aspectKeys": [ # Optional. The map keys of the Aspects which the service should modify. It supports the following syntaxes: - matches an aspect of the given type and empty path. @path - matches an aspect of the given type and specified path. For example, to attach an aspect to a field that is specified by the schema aspect, the path should have the format Schema.. @* - matches aspects of the given type for all paths. *@path - matches aspects of all types on the given path.The service will not remove existing aspects matching the syntax unless delete_missing_aspects is set to true.If this field is left empty, the service treats it as specifying exactly those Aspects present in the request.
+          "A String",
+        ],
+        "deleteMissingAspects": True or False, # Optional. If set to true and the aspect_keys specify aspect ranges, the service deletes any existing aspects from that range that weren't provided in the request.
+        "entry": { # An entry is a representation of a data resource that can be described by various metadata. # Required. Entry resource.
+          "aspects": { # Optional. The aspects that are attached to the entry. Depending on how the aspect is attached to the entry, the format of the aspect key can be one of the following: If the aspect is attached directly to the entry: {project_id_or_number}.{location_id}.{aspect_type_id} If the aspect is attached to an entry's path: {project_id_or_number}.{location_id}.{aspect_type_id}@{path}
+            "a_key": { # Represents a single piece of metadata describing an entry or entry link.
+              "aspectSource": { # Information related to the source system of the aspect. # Optional. Information related to the source system of the aspect.
+                "createTime": "A String", # The time the aspect was created in the source system.
+                "dataVersion": "A String", # The version of the data format used to produce this data. This field is used to indicated when the underlying data format changes (e.g., schema modifications, changes to the source URL format definition, etc).
+                "updateTime": "A String", # The time the aspect was last updated in the source system.
+              },
+              "aspectType": "A String", # Output only. The resource name of the type used to create this Aspect.
+              "createTime": "A String", # Output only. The time when the Aspect was created.
+              "data": { # Required. The content of the aspect, according to its aspect type schema. The maximum size of the field is 120KB (encoded as UTF-8).
+                "a_key": "", # Properties of the object.
+              },
+              "path": "A String", # Output only. The path in the entry under which the aspect is attached.
+              "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 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.
+                "name": "A String", # Optional. The name of the ancestor resource.
+                "type": "A String", # Optional. The type of the ancestor resource.
+              },
+            ],
+            "createTime": "A String", # The time when the resource was created in the source system.
+            "description": "A String", # A description of the data resource. Maximum length is 2,000 characters.
+            "displayName": "A String", # A user-friendly display name. Maximum length is 500 characters.
+            "labels": { # User-defined labels. The maximum size of keys and values is 128 characters each.
+              "a_key": "A String",
+            },
+            "location": "A String", # Output only. Location of the resource in the source system. You can search the entry by this location. By default, this should match the location of the entry group containing this entry. A different value allows capturing the source location for data external to Google Cloud.
+            "platform": "A String", # The platform containing the source system. Maximum length is 64 characters.
+            "resource": "A String", # The name of the resource in the source system. Maximum length is 4,000 characters.
+            "system": "A String", # The name of the source system. Maximum length is 64 characters.
+            "updateTime": "A String", # The time when the resource was last updated in the source system. If the entry exists in the system and its EntrySource has update_time populated, further updates to the EntrySource of the entry must provide incremental updates to its update_time.
+          },
+          "entryType": "A String", # Required. Immutable. The relative resource name of the entry type that was used to create this entry, in the format projects/{project_id_or_number}/locations/{location_id}/entryTypes/{entry_type_id}.
+          "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 Universal Catalog.
+        },
+        "updateMask": "A String", # Optional. Mask of fields to update. To update Aspects, the update_mask must contain the value "aspects".If the update_mask is empty, the service will update all modifiable fields present in the request.
+      },
+    },
+  ],
+  "description": { # Description of the batch change. # Optional. Text description of the batch change.
+    "content": "A String", # Optional. The text description content.
+    "job": { # Description of the job that created the batch change. # Optional. The job that created the batch change.
+      "name": "A String", # Optional. The name of the job that created the batch change. For example: projects/{project_number}/locations/{location_id}/enrichmentTasks/{enrichment_task_id}/runs/{enrichment_run_id}
+      "runTime": "A String", # Optional. The start time of the job run that created the batch change.
+    },
+  },
+  "name": "A String", # Required. The resource name of the EntryGroup on which the batch change applies. Format: projects/{project_number_or_id}/locations/{location_id}/entryGroups/{entry_group_id}
+}
+
+  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.
+  },
+}

+

+
 

     close()
   
Close httplib2 connections.

@@ -130,6 +361,11 @@ 
Method Details

     The object takes the form of:
 
 { # An Entry Group represents a logical grouping of one or more Entries.
+  "changeRequestConfig": { # Specifies the configuration for requesting changes in the metadata belonging to the Entry Group. # Optional. Specifies the configuration for requesting changes in the metadata belonging to the Entry Group.
+    "approverEmails": [ # Optional. Specifies the email addresses of users who are potential approvers and are notified when a change request is created for the metadata belonging to the Entry Group. The maximum number of emails allowed is 10.
+      "A String",
+    ],
+  },
   "createTime": "A String", # Output only. The time when the EntryGroup was created.
   "description": "A String", # Optional. Description of the EntryGroup.
   "displayName": "A String", # Optional. User friendly display name.
@@ -225,6 +461,11 @@ 
Method Details

   An object of the form:
 
     { # An Entry Group represents a logical grouping of one or more Entries.
+  "changeRequestConfig": { # Specifies the configuration for requesting changes in the metadata belonging to the Entry Group. # Optional. Specifies the configuration for requesting changes in the metadata belonging to the Entry Group.
+    "approverEmails": [ # Optional. Specifies the email addresses of users who are potential approvers and are notified when a change request is created for the metadata belonging to the Entry Group. The maximum number of emails allowed is 10.
+      "A String",
+    ],
+  },
   "createTime": "A String", # Output only. The time when the EntryGroup was created.
   "description": "A String", # Optional. Description of the EntryGroup.
   "displayName": "A String", # Optional. User friendly display name.
@@ -308,6 +549,11 @@ 
Method Details

     { # List entry groups response.
   "entryGroups": [ # Entry groups under the given parent location.
     { # An Entry Group represents a logical grouping of one or more Entries.
+      "changeRequestConfig": { # Specifies the configuration for requesting changes in the metadata belonging to the Entry Group. # Optional. Specifies the configuration for requesting changes in the metadata belonging to the Entry Group.
+        "approverEmails": [ # Optional. Specifies the email addresses of users who are potential approvers and are notified when a change request is created for the metadata belonging to the Entry Group. The maximum number of emails allowed is 10.
+          "A String",
+        ],
+      },
       "createTime": "A String", # Output only. The time when the EntryGroup was created.
       "description": "A String", # Optional. Description of the EntryGroup.
       "displayName": "A String", # Optional. User friendly display name.
@@ -352,6 +598,11 @@ 
Method Details

     The object takes the form of:
 
 { # An Entry Group represents a logical grouping of one or more Entries.
+  "changeRequestConfig": { # Specifies the configuration for requesting changes in the metadata belonging to the Entry Group. # Optional. Specifies the configuration for requesting changes in the metadata belonging to the Entry Group.
+    "approverEmails": [ # Optional. Specifies the email addresses of users who are potential approvers and are notified when a change request is created for the metadata belonging to the Entry Group. The maximum number of emails allowed is 10.
+      "A String",
+    ],
+  },
   "createTime": "A String", # Output only. The time when the EntryGroup was created.
   "description": "A String", # Optional. Description of the EntryGroup.
   "displayName": "A String", # Optional. User friendly display name.
@@ -396,6 +647,221 @@ 
Method Details

 }
+
+ requestBatchMetadataChange(name, body=None, x__xgafv=None) + 
Submits a catalog change request for multiple resources within an EntryGroup. This method creates a ChangeRequest resource that must be reviewed and approved before the proposed changes are applied.
+
+Args:
+  name: string, Required. The resource name of the Entry Group on which the change applies. Format: projects/{project}/locations/{location}/entryGroups/{entry_group} (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # Request message for submitting a set of catalog changes proposals.
+  "changePayload": { # Request message for batch changing metadata. Requires permission to perform the underlying change, depending on the type and content of the change. Per operation, required permissions are: - for CreateEntry: dataplex.entries.create - for UpdateEntry: dataplex.entries.update - for DeleteEntry: dataplex.entries.delete - for CreateEntryLink: dataplex.entryLinks.create - for UpdateEntryLink: dataplex.entryLinks.update - for DeleteEntryLink: dataplex.entryLinks.deleteAnd per used type permissions are: - for EntryType: dataplex.entryTypes.use or dataplex.entryGroups.useEntry for reusable built-in types, - for AspectType: dataplex.aspectTypes.use or dataplex.entryGroups.useAspect for reusable built-in types and - for EntryLinkType: dataplex.entryLinkTypes.use or dataplex.entryGroups.useEntryLink for reusable built-in types. # Required. The detailed specification of the proposed changes. This payload is intended to be embedded as the change_payload in the resulting ChangeRequest.
+    "changes": [ # Required. The list of changes to apply. Only a single change per resource is supported. Maximum number of changes supported is 250.
+      { # Detailed description of an individual change.
+        "createEntryLinkRequest": { # Request message for CreateEntryLink. # Payload for creating an EntryLink.
+          "entryLink": { # EntryLink represents a link between two Entries. # Required. Entry Link resource.
+            "aspects": { # Optional. The aspects that are attached to the entry link. The format of the aspect key has to be the following: {project_id_or_number}.{location_id}.{aspect_type_id} Currently, only a single aspect of a Dataplex-owned Aspect Type is allowed.
+              "a_key": { # Represents a single piece of metadata describing an entry or entry link.
+                "aspectSource": { # Information related to the source system of the aspect. # Optional. Information related to the source system of the aspect.
+                  "createTime": "A String", # The time the aspect was created in the source system.
+                  "dataVersion": "A String", # The version of the data format used to produce this data. This field is used to indicated when the underlying data format changes (e.g., schema modifications, changes to the source URL format definition, etc).
+                  "updateTime": "A String", # The time the aspect was last updated in the source system.
+                },
+                "aspectType": "A String", # Output only. The resource name of the type used to create this Aspect.
+                "createTime": "A String", # Output only. The time when the Aspect was created.
+                "data": { # Required. The content of the aspect, according to its aspect type schema. The maximum size of the field is 120KB (encoded as UTF-8).
+                  "a_key": "", # Properties of the object.
+                },
+                "path": "A String", # Output only. The path in the entry under which the aspect is attached.
+                "updateTime": "A String", # Output only. The time when the Aspect was last updated.
+              },
+            },
+            "createTime": "A String", # Output only. The time when the Entry Link was created.
+            "entryLinkType": "A String", # Required. Immutable. Relative resource name of the Entry Link Type used to create this Entry Link. For example: Entry link between synonym terms in a glossary: projects/dataplex-types/locations/global/entryLinkTypes/synonym Entry link between related terms in a glossary: projects/dataplex-types/locations/global/entryLinkTypes/related Entry link between glossary terms and data assets: projects/dataplex-types/locations/global/entryLinkTypes/definition
+            "entryReferences": [ # Required. Immutable. Specifies the Entries referenced in the Entry Link. There should be exactly two entry references.
+              { # Reference to the Entry that is linked through the Entry Link.
+                "name": "A String", # Required. Immutable. The relative resource name of the referenced Entry, of the form: projects/{project_id_or_number}/locations/{location_id}/entryGroups/{entry_group_id}/entries/{entry_id}
+                "path": "A String", # Immutable. The path in the Entry that is referenced in the Entry Link. Empty path denotes that the Entry itself is referenced in the Entry Link.
+                "type": "A String", # Required. Immutable. The reference type of the Entry.
+              },
+            ],
+            "name": "A String", # Output only. Immutable. Identifier. The relative resource name of the Entry Link, of the form: projects/{project_id_or_number}/locations/{location_id}/entryGroups/{entry_group_id}/entryLinks/{entry_link_id}
+            "updateTime": "A String", # Output only. The time when the Entry Link was last updated.
+          },
+          "entryLinkId": "A String", # Required. Entry Link identifier * Must contain only lowercase letters, numbers and hyphens. * Must start with a letter. * Must be between 1-63 characters. * Must end with a number or a letter. * Must be unique within the EntryGroup.
+          "parent": "A String", # Required. The resource name of the parent Entry Group: projects/{project_id_or_number}/locations/{location_id}/entryGroups/{entry_group_id}.
+        },
+        "createEntryRequest": { # Create Entry request. # Payload for creating an Entry.
+          "entry": { # An entry is a representation of a data resource that can be described by various metadata. # Required. Entry resource.
+            "aspects": { # Optional. The aspects that are attached to the entry. Depending on how the aspect is attached to the entry, the format of the aspect key can be one of the following: If the aspect is attached directly to the entry: {project_id_or_number}.{location_id}.{aspect_type_id} If the aspect is attached to an entry's path: {project_id_or_number}.{location_id}.{aspect_type_id}@{path}
+              "a_key": { # Represents a single piece of metadata describing an entry or entry link.
+                "aspectSource": { # Information related to the source system of the aspect. # Optional. Information related to the source system of the aspect.
+                  "createTime": "A String", # The time the aspect was created in the source system.
+                  "dataVersion": "A String", # The version of the data format used to produce this data. This field is used to indicated when the underlying data format changes (e.g., schema modifications, changes to the source URL format definition, etc).
+                  "updateTime": "A String", # The time the aspect was last updated in the source system.
+                },
+                "aspectType": "A String", # Output only. The resource name of the type used to create this Aspect.
+                "createTime": "A String", # Output only. The time when the Aspect was created.
+                "data": { # Required. The content of the aspect, according to its aspect type schema. The maximum size of the field is 120KB (encoded as UTF-8).
+                  "a_key": "", # Properties of the object.
+                },
+                "path": "A String", # Output only. The path in the entry under which the aspect is attached.
+                "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 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.
+                  "name": "A String", # Optional. The name of the ancestor resource.
+                  "type": "A String", # Optional. The type of the ancestor resource.
+                },
+              ],
+              "createTime": "A String", # The time when the resource was created in the source system.
+              "description": "A String", # A description of the data resource. Maximum length is 2,000 characters.
+              "displayName": "A String", # A user-friendly display name. Maximum length is 500 characters.
+              "labels": { # User-defined labels. The maximum size of keys and values is 128 characters each.
+                "a_key": "A String",
+              },
+              "location": "A String", # Output only. Location of the resource in the source system. You can search the entry by this location. By default, this should match the location of the entry group containing this entry. A different value allows capturing the source location for data external to Google Cloud.
+              "platform": "A String", # The platform containing the source system. Maximum length is 64 characters.
+              "resource": "A String", # The name of the resource in the source system. Maximum length is 4,000 characters.
+              "system": "A String", # The name of the source system. Maximum length is 64 characters.
+              "updateTime": "A String", # The time when the resource was last updated in the source system. If the entry exists in the system and its EntrySource has update_time populated, further updates to the EntrySource of the entry must provide incremental updates to its update_time.
+            },
+            "entryType": "A String", # Required. Immutable. The relative resource name of the entry type that was used to create this entry, in the format projects/{project_id_or_number}/locations/{location_id}/entryTypes/{entry_type_id}.
+            "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 Universal Catalog.
+          },
+          "entryId": "A 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.
+          "parent": "A String", # Required. The resource name of the parent Entry Group: projects/{project}/locations/{location}/entryGroups/{entry_group}.
+        },
+        "deleteEntryLinkRequest": { # Request message for DeleteEntryLink. # Payload for deleting an EntryLink.
+          "name": "A String", # Required. The resource name of the Entry Link: projects/{project_id_or_number}/locations/{location_id}/entryGroups/{entry_group_id}/entryLinks/{entry_link_id}.
+        },
+        "deleteEntryRequest": { # Delete Entry request. # Payload for deleting an Entry.
+          "name": "A String", # Required. The resource name of the Entry: projects/{project}/locations/{location}/entryGroups/{entry_group}/entries/{entry}.
+        },
+        "updateEntryLinkRequest": { # Request message for UpdateEntryLink method. # Payload for updating an EntryLink.
+          "allowMissing": True or False, # Optional. If set to true and the entry link doesn't exist, the service will create it.
+          "aspectKeys": [ # Optional. The map keys of the Aspects which the service should modify. It should be the aspect type reference in the format {project_id_or_number}.{location_id}.{aspect_type_id}.If this field is left empty, the service treats it as specifying exactly those Aspects present in the request.
+            "A String",
+          ],
+          "entryLink": { # EntryLink represents a link between two Entries. # Required. Entry Link resource.
+            "aspects": { # Optional. The aspects that are attached to the entry link. The format of the aspect key has to be the following: {project_id_or_number}.{location_id}.{aspect_type_id} Currently, only a single aspect of a Dataplex-owned Aspect Type is allowed.
+              "a_key": { # Represents a single piece of metadata describing an entry or entry link.
+                "aspectSource": { # Information related to the source system of the aspect. # Optional. Information related to the source system of the aspect.
+                  "createTime": "A String", # The time the aspect was created in the source system.
+                  "dataVersion": "A String", # The version of the data format used to produce this data. This field is used to indicated when the underlying data format changes (e.g., schema modifications, changes to the source URL format definition, etc).
+                  "updateTime": "A String", # The time the aspect was last updated in the source system.
+                },
+                "aspectType": "A String", # Output only. The resource name of the type used to create this Aspect.
+                "createTime": "A String", # Output only. The time when the Aspect was created.
+                "data": { # Required. The content of the aspect, according to its aspect type schema. The maximum size of the field is 120KB (encoded as UTF-8).
+                  "a_key": "", # Properties of the object.
+                },
+                "path": "A String", # Output only. The path in the entry under which the aspect is attached.
+                "updateTime": "A String", # Output only. The time when the Aspect was last updated.
+              },
+            },
+            "createTime": "A String", # Output only. The time when the Entry Link was created.
+            "entryLinkType": "A String", # Required. Immutable. Relative resource name of the Entry Link Type used to create this Entry Link. For example: Entry link between synonym terms in a glossary: projects/dataplex-types/locations/global/entryLinkTypes/synonym Entry link between related terms in a glossary: projects/dataplex-types/locations/global/entryLinkTypes/related Entry link between glossary terms and data assets: projects/dataplex-types/locations/global/entryLinkTypes/definition
+            "entryReferences": [ # Required. Immutable. Specifies the Entries referenced in the Entry Link. There should be exactly two entry references.
+              { # Reference to the Entry that is linked through the Entry Link.
+                "name": "A String", # Required. Immutable. The relative resource name of the referenced Entry, of the form: projects/{project_id_or_number}/locations/{location_id}/entryGroups/{entry_group_id}/entries/{entry_id}
+                "path": "A String", # Immutable. The path in the Entry that is referenced in the Entry Link. Empty path denotes that the Entry itself is referenced in the Entry Link.
+                "type": "A String", # Required. Immutable. The reference type of the Entry.
+              },
+            ],
+            "name": "A String", # Output only. Immutable. Identifier. The relative resource name of the Entry Link, of the form: projects/{project_id_or_number}/locations/{location_id}/entryGroups/{entry_group_id}/entryLinks/{entry_link_id}
+            "updateTime": "A String", # Output only. The time when the Entry Link was last updated.
+          },
+        },
+        "updateEntryRequest": { # Update Entry request. # Payload for updating an Entry.
+          "allowMissing": True or False, # Optional. If set to true and the entry doesn't exist, the service will create it.
+          "aspectKeys": [ # Optional. The map keys of the Aspects which the service should modify. It supports the following syntaxes: - matches an aspect of the given type and empty path. @path - matches an aspect of the given type and specified path. For example, to attach an aspect to a field that is specified by the schema aspect, the path should have the format Schema.. @* - matches aspects of the given type for all paths. *@path - matches aspects of all types on the given path.The service will not remove existing aspects matching the syntax unless delete_missing_aspects is set to true.If this field is left empty, the service treats it as specifying exactly those Aspects present in the request.
+            "A String",
+          ],
+          "deleteMissingAspects": True or False, # Optional. If set to true and the aspect_keys specify aspect ranges, the service deletes any existing aspects from that range that weren't provided in the request.
+          "entry": { # An entry is a representation of a data resource that can be described by various metadata. # Required. Entry resource.
+            "aspects": { # Optional. The aspects that are attached to the entry. Depending on how the aspect is attached to the entry, the format of the aspect key can be one of the following: If the aspect is attached directly to the entry: {project_id_or_number}.{location_id}.{aspect_type_id} If the aspect is attached to an entry's path: {project_id_or_number}.{location_id}.{aspect_type_id}@{path}
+              "a_key": { # Represents a single piece of metadata describing an entry or entry link.
+                "aspectSource": { # Information related to the source system of the aspect. # Optional. Information related to the source system of the aspect.
+                  "createTime": "A String", # The time the aspect was created in the source system.
+                  "dataVersion": "A String", # The version of the data format used to produce this data. This field is used to indicated when the underlying data format changes (e.g., schema modifications, changes to the source URL format definition, etc).
+                  "updateTime": "A String", # The time the aspect was last updated in the source system.
+                },
+                "aspectType": "A String", # Output only. The resource name of the type used to create this Aspect.
+                "createTime": "A String", # Output only. The time when the Aspect was created.
+                "data": { # Required. The content of the aspect, according to its aspect type schema. The maximum size of the field is 120KB (encoded as UTF-8).
+                  "a_key": "", # Properties of the object.
+                },
+                "path": "A String", # Output only. The path in the entry under which the aspect is attached.
+                "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 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.
+                  "name": "A String", # Optional. The name of the ancestor resource.
+                  "type": "A String", # Optional. The type of the ancestor resource.
+                },
+              ],
+              "createTime": "A String", # The time when the resource was created in the source system.
+              "description": "A String", # A description of the data resource. Maximum length is 2,000 characters.
+              "displayName": "A String", # A user-friendly display name. Maximum length is 500 characters.
+              "labels": { # User-defined labels. The maximum size of keys and values is 128 characters each.
+                "a_key": "A String",
+              },
+              "location": "A String", # Output only. Location of the resource in the source system. You can search the entry by this location. By default, this should match the location of the entry group containing this entry. A different value allows capturing the source location for data external to Google Cloud.
+              "platform": "A String", # The platform containing the source system. Maximum length is 64 characters.
+              "resource": "A String", # The name of the resource in the source system. Maximum length is 4,000 characters.
+              "system": "A String", # The name of the source system. Maximum length is 64 characters.
+              "updateTime": "A String", # The time when the resource was last updated in the source system. If the entry exists in the system and its EntrySource has update_time populated, further updates to the EntrySource of the entry must provide incremental updates to its update_time.
+            },
+            "entryType": "A String", # Required. Immutable. The relative resource name of the entry type that was used to create this entry, in the format projects/{project_id_or_number}/locations/{location_id}/entryTypes/{entry_type_id}.
+            "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 Universal Catalog.
+          },
+          "updateMask": "A String", # Optional. Mask of fields to update. To update Aspects, the update_mask must contain the value "aspects".If the update_mask is empty, the service will update all modifiable fields present in the request.
+        },
+      },
+    ],
+    "description": { # Description of the batch change. # Optional. Text description of the batch change.
+      "content": "A String", # Optional. The text description content.
+      "job": { # Description of the job that created the batch change. # Optional. The job that created the batch change.
+        "name": "A String", # Optional. The name of the job that created the batch change. For example: projects/{project_number}/locations/{location_id}/enrichmentTasks/{enrichment_task_id}/runs/{enrichment_run_id}
+        "runTime": "A String", # Optional. The start time of the job run that created the batch change.
+      },
+    },
+    "name": "A String", # Required. The resource name of the EntryGroup on which the batch change applies. Format: projects/{project_number_or_id}/locations/{location_id}/entryGroups/{entry_group_id}
+  },
+  "justification": "A String", # Optional. Justification for the metadata change request.
+  "labels": { # Optional. User-defined labels for the metadata change request.
+    "a_key": "A String",
+  },
+}
+
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # Response message containing the reference to the created change request.
+  "changeRequest": "A String", # The resource name of the created ChangeRequest. Format: projects/{project}/locations/{location}/changeRequests/{change_request}
+}
+
+
setIamPolicy(resource, body=None, x__xgafv=None) 
Sets the access control policy on the specified resource. Replaces any existing policy.Can return NOT_FOUND, INVALID_ARGUMENT, and PERMISSION_DENIED errors.
diff --git a/googleapiclient/discovery_cache/documents/dataplex.v1.json b/googleapiclient/discovery_cache/documents/dataplex.v1.json
index 189a33b8c2..a03407f4ca 100644
--- a/googleapiclient/discovery_cache/documents/dataplex.v1.json
+++ b/googleapiclient/discovery_cache/documents/dataplex.v1.json
@@ -3486,6 +3486,35 @@
 },
 "entryGroups": {
 "methods": {
+"batchChangeMetadata": {
+"description": "Batch changes metadata within an EntryGroup.",
+"flatPath": "v1/projects/{projectsId}/locations/{locationsId}/entryGroups/{entryGroupsId}:batchChangeMetadata",
+"httpMethod": "POST",
+"id": "dataplex.projects.locations.entryGroups.batchChangeMetadata",
+"parameterOrder": [
+"name"
+],
+"parameters": {
+"name": {
+"description": "Required. The resource name of the EntryGroup on which the batch change applies. Format: projects/{project_number_or_id}/locations/{location_id}/entryGroups/{entry_group_id}",
+"location": "path",
+"pattern": "^projects/[^/]+/locations/[^/]+/entryGroups/[^/]+$",
+"required": true,
+"type": "string"
+}
+},
+"path": "v1/{+name}:batchChangeMetadata",
+"request": {
+"$ref": "GoogleCloudDataplexV1BatchChangeMetadataRequest"
+},
+"response": {
+"$ref": "GoogleLongrunningOperation"
+},
+"scopes": [
+"https://www.googleapis.com/auth/cloud-platform",
+"https://www.googleapis.com/auth/dataplex.read-write"
+]
+},
 "create": {
 "description": "Creates an EntryGroup.",
 "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/entryGroups",
@@ -3705,6 +3734,35 @@
 "https://www.googleapis.com/auth/dataplex.read-write"
 ]
 },
+"requestBatchMetadataChange": {
+"description": "Submits a catalog change request for multiple resources within an EntryGroup. This method creates a ChangeRequest resource that must be reviewed and approved before the proposed changes are applied.",
+"flatPath": "v1/projects/{projectsId}/locations/{locationsId}/entryGroups/{entryGroupsId}:requestBatchMetadataChange",
+"httpMethod": "POST",
+"id": "dataplex.projects.locations.entryGroups.requestBatchMetadataChange",
+"parameterOrder": [
+"name"
+],
+"parameters": {
+"name": {
+"description": "Required. The resource name of the Entry Group on which the change applies. Format: projects/{project}/locations/{location}/entryGroups/{entry_group}",
+"location": "path",
+"pattern": "^projects/[^/]+/locations/[^/]+/entryGroups/[^/]+$",
+"required": true,
+"type": "string"
+}
+},
+"path": "v1/{+name}:requestBatchMetadataChange",
+"request": {
+"$ref": "GoogleCloudDataplexV1RequestBatchMetadataChangeRequest"
+},
+"response": {
+"$ref": "GoogleCloudDataplexV1RequestBatchMetadataChangeResponse"
+},
+"scopes": [
+"https://www.googleapis.com/auth/cloud-platform",
+"https://www.googleapis.com/auth/dataplex.read-write"
+]
+},
 "setIamPolicy": {
 "description": "Sets the access control policy on the specified resource. Replaces any existing policy.Can return NOT_FOUND, INVALID_ARGUMENT, and PERMISSION_DENIED errors.",
 "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/entryGroups/{entryGroupsId}:setIamPolicy",
@@ -7576,7 +7634,7 @@
 }
 }
 },
-"revision": "20261005",
+"revision": "20261012",
 "rootUrl": "https://dataplex.googleapis.com/",
 "schemas": {
 "Empty": {
@@ -8045,7 +8103,7 @@
 "type": "integer"
 },
 "stringType": {
-"description": "Optional. You can use String Type annotations to specify special meaning to string fields. The following values are supported: richText: The field must be interpreted as a rich text field. url: A fully qualified URL link. resource: A service qualified resource reference.",
+"description": "Optional. You can use String Type annotations to specify special meaning to string fields. The following values are supported: richText: The field must be interpreted as a rich text field. markdown: The field must be interpreted as a markdown field. url: A fully qualified URL link. resource: A service qualified resource reference.",
 "type": "string"
 },
 "stringValues": {
@@ -8454,6 +8512,104 @@
 },
 "type": "object"
 },
+"GoogleCloudDataplexV1BatchChangeMetadataRequest": {
+"description": "Request message for batch changing metadata. Requires permission to perform the underlying change, depending on the type and content of the change. Per operation, required permissions are: - for CreateEntry: dataplex.entries.create - for UpdateEntry: dataplex.entries.update - for DeleteEntry: dataplex.entries.delete - for CreateEntryLink: dataplex.entryLinks.create - for UpdateEntryLink: dataplex.entryLinks.update - for DeleteEntryLink: dataplex.entryLinks.deleteAnd per used type permissions are: - for EntryType: dataplex.entryTypes.use or dataplex.entryGroups.useEntry for reusable built-in types, - for AspectType: dataplex.aspectTypes.use or dataplex.entryGroups.useAspect for reusable built-in types and - for EntryLinkType: dataplex.entryLinkTypes.use or dataplex.entryGroups.useEntryLink for reusable built-in types.",
+"id": "GoogleCloudDataplexV1BatchChangeMetadataRequest",
+"properties": {
+"changes": {
+"description": "Required. The list of changes to apply. Only a single change per resource is supported. Maximum number of changes supported is 250.",
+"items": {
+"$ref": "GoogleCloudDataplexV1BatchChangeMetadataRequestChange"
+},
+"type": "array"
+},
+"description": {
+"$ref": "GoogleCloudDataplexV1BatchChangeMetadataRequestDescription",
+"description": "Optional. Text description of the batch change."
+},
+"name": {
+"description": "Required. The resource name of the EntryGroup on which the batch change applies. Format: projects/{project_number_or_id}/locations/{location_id}/entryGroups/{entry_group_id}",
+"type": "string"
+}
+},
+"type": "object"
+},
+"GoogleCloudDataplexV1BatchChangeMetadataRequestChange": {
+"description": "Detailed description of an individual change.",
+"id": "GoogleCloudDataplexV1BatchChangeMetadataRequestChange",
+"properties": {
+"createEntryLinkRequest": {
+"$ref": "GoogleCloudDataplexV1CreateEntryLinkRequest",
+"description": "Payload for creating an EntryLink."
+},
+"createEntryRequest": {
+"$ref": "GoogleCloudDataplexV1CreateEntryRequest",
+"description": "Payload for creating an Entry."
+},
+"deleteEntryLinkRequest": {
+"$ref": "GoogleCloudDataplexV1DeleteEntryLinkRequest",
+"description": "Payload for deleting an EntryLink."
+},
+"deleteEntryRequest": {
+"$ref": "GoogleCloudDataplexV1DeleteEntryRequest",
+"description": "Payload for deleting an Entry."
+},
+"updateEntryLinkRequest": {
+"$ref": "GoogleCloudDataplexV1UpdateEntryLinkRequest",
+"description": "Payload for updating an EntryLink."
+},
+"updateEntryRequest": {
+"$ref": "GoogleCloudDataplexV1UpdateEntryRequest",
+"description": "Payload for updating an Entry."
+}
+},
+"type": "object"
+},
+"GoogleCloudDataplexV1BatchChangeMetadataRequestDescription": {
+"description": "Description of the batch change.",
+"id": "GoogleCloudDataplexV1BatchChangeMetadataRequestDescription",
+"properties": {
+"content": {
+"description": "Optional. The text description content.",
+"type": "string"
+},
+"job": {
+"$ref": "GoogleCloudDataplexV1BatchChangeMetadataRequestDescriptionJob",
+"description": "Optional. The job that created the batch change."
+}
+},
+"type": "object"
+},
+"GoogleCloudDataplexV1BatchChangeMetadataRequestDescriptionJob": {
+"description": "Description of the job that created the batch change.",
+"id": "GoogleCloudDataplexV1BatchChangeMetadataRequestDescriptionJob",
+"properties": {
+"name": {
+"description": "Optional. The name of the job that created the batch change. For example: projects/{project_number}/locations/{location_id}/enrichmentTasks/{enrichment_task_id}/runs/{enrichment_run_id}",
+"type": "string"
+},
+"runTime": {
+"description": "Optional. The start time of the job run that created the batch change.",
+"format": "google-datetime",
+"type": "string"
+}
+},
+"type": "object"
+},
+"GoogleCloudDataplexV1BatchChangeMetadataResponse": {
+"description": "Response message for BatchChangeMetadata.",
+"id": "GoogleCloudDataplexV1BatchChangeMetadataResponse",
+"properties": {
+"failedRequests": {
+"additionalProperties": {
+"$ref": "GoogleRpcStatus"
+},
+"description": "A map of failed requests for a batch change, where the key is the 0-based index of the failed request in the batch and the value is the error status. If all operations succeeded, this map is empty.",
+"type": "object"
+}
+},
+"type": "object"
+},
 "GoogleCloudDataplexV1BusinessGlossaryEvent": {
 "description": "Payload associated with Business Glossary related log events.",
 "id": "GoogleCloudDataplexV1BusinessGlossaryEvent",
@@ -8535,6 +8691,15 @@
 "readOnly": true,
 "type": "string"
 },
+"batchChangeMetadataRequest": {
+"$ref": "GoogleCloudDataplexV1BatchChangeMetadataRequest",
+"description": "Payload for executing a batch of catalog changes."
+},
+"batchChangeMetadataResponse": {
+"$ref": "GoogleCloudDataplexV1BatchChangeMetadataResponse",
+"description": "Output only. Result of applying a batch change metadata request.",
+"readOnly": true
+},
 "changeType": {
 "description": "Output only. The type of change represented by the change_payload. This field is derived from the populated field in the change_payload oneof.",
 "enum": [
@@ -8553,7 +8718,8 @@
 "CREATE_GLOSSARY_TERM",
 "UPDATE_GLOSSARY_TERM",
 "DELETE_GLOSSARY_TERM",
-"REQUEST_DATA_PRODUCT_ACCESS"
+"REQUEST_DATA_PRODUCT_ACCESS",
+"BATCH_CHANGE_METADATA"
 ],
 "enumDescriptions": [
 "State unspecified.",
@@ -8571,7 +8737,8 @@
 "Request to create a GlossaryTerm.",
 "Request to update a GlossaryTerm.",
 "Request to delete a GlossaryTerm.",
-"Request to request Data Product access."
+"Request to request Data Product access.",
+"Request to execute a batch of catalog changes."
 ],
 "readOnly": true,
 "type": "string"
@@ -8668,7 +8835,9 @@
 "APPROVED",
 "REJECTED",
 "EXPIRED",
-"REVOKED"
+"REVOKED",
+"APPLYING",
+"FAILED"
 ],
 "enumDescriptions": [
 "State unspecified.",
@@ -8676,7 +8845,9 @@
 "The change has been approved.",
 "The change has been rejected.",
 "The change request has expired.",
-"The approved change has been revoked."
+"The approved change has been revoked.",
+"The change request has been approved and changes are currently being applied.",
+"The change request execution failed."
 ],
 "readOnly": true,
 "type": "string"
@@ -12164,6 +12335,10 @@
 "description": "An Entry Group represents a logical grouping of one or more Entries.",
 "id": "GoogleCloudDataplexV1EntryGroup",
 "properties": {
+"changeRequestConfig": {
+"$ref": "GoogleCloudDataplexV1EntryGroupChangeRequestConfig",
+"description": "Optional. Specifies the configuration for requesting changes in the metadata belonging to the Entry Group."
+},
 "createTime": {
 "description": "Output only. The time when the EntryGroup was created.",
 "format": "google-datetime",
@@ -12223,6 +12398,20 @@
 },
 "type": "object"
 },
+"GoogleCloudDataplexV1EntryGroupChangeRequestConfig": {
+"description": "Specifies the configuration for requesting changes in the metadata belonging to the Entry Group.",
+"id": "GoogleCloudDataplexV1EntryGroupChangeRequestConfig",
+"properties": {
+"approverEmails": {
+"description": "Optional. Specifies the email addresses of users who are potential approvers and are notified when a change request is created for the metadata belonging to the Entry Group. The maximum number of emails allowed is 10.",
+"items": {
+"type": "string"
+},
+"type": "array"
+}
+},
+"type": "object"
+},
 "GoogleCloudDataplexV1EntryLink": {
 "description": "EntryLink represents a link between two Entries.",
 "id": "GoogleCloudDataplexV1EntryLink",
@@ -14373,6 +14562,39 @@
 },
 "type": "object"
 },
+"GoogleCloudDataplexV1RequestBatchMetadataChangeRequest": {
+"description": "Request message for submitting a set of catalog changes proposals.",
+"id": "GoogleCloudDataplexV1RequestBatchMetadataChangeRequest",
+"properties": {
+"changePayload": {
+"$ref": "GoogleCloudDataplexV1BatchChangeMetadataRequest",
+"description": "Required. The detailed specification of the proposed changes. This payload is intended to be embedded as the change_payload in the resulting ChangeRequest."
+},
+"justification": {
+"description": "Optional. Justification for the metadata change request.",
+"type": "string"
+},
+"labels": {
+"additionalProperties": {
+"type": "string"
+},
+"description": "Optional. User-defined labels for the metadata change request.",
+"type": "object"
+}
+},
+"type": "object"
+},
+"GoogleCloudDataplexV1RequestBatchMetadataChangeResponse": {
+"description": "Response message containing the reference to the created change request.",
+"id": "GoogleCloudDataplexV1RequestBatchMetadataChangeResponse",
+"properties": {
+"changeRequest": {
+"description": "The resource name of the created ChangeRequest. Format: projects/{project}/locations/{location}/changeRequests/{change_request}",
+"type": "string"
+}
+},
+"type": "object"
+},
 "GoogleCloudDataplexV1RequestDataProductAccessRequest": {
 "description": "Message for requesting access to a Data Product.",
 "id": "GoogleCloudDataplexV1RequestDataProductAccessRequest",
@@ -15329,6 +15551,28 @@
 },
 "type": "object"
 },
+"GoogleCloudDataplexV1UpdateEntryLinkRequest": {
+"description": "Request message for UpdateEntryLink method.",
+"id": "GoogleCloudDataplexV1UpdateEntryLinkRequest",
+"properties": {
+"allowMissing": {
+"description": "Optional. If set to true and the entry link doesn't exist, the service will create it.",
+"type": "boolean"
+},
+"aspectKeys": {
+"description": "Optional. The map keys of the Aspects which the service should modify. It should be the aspect type reference in the format {project_id_or_number}.{location_id}.{aspect_type_id}.If this field is left empty, the service treats it as specifying exactly those Aspects present in the request.",
+"items": {
+"type": "string"
+},
+"type": "array"
+},
+"entryLink": {
+"$ref": "GoogleCloudDataplexV1EntryLink",
+"description": "Required. Entry Link resource."
+}
+},
+"type": "object"
+},
 "GoogleCloudDataplexV1UpdateEntryRequest": {
 "description": "Update Entry request.",
 "id": "GoogleCloudDataplexV1UpdateEntryRequest",

From 001573874d3a0756cb6e67665d71c191256c8cc3 Mon Sep 17 00:00:00 2001
From: Yoshi Automation 
Date: Tue, 20 Oct 2026 07:24:00 +0000
Subject: [PATCH 13/34] feat(dataproc): update the api

#### dataproc:v1

The following keys were added:
- schemas.ClusterConfig.properties.masterFlexibleConfig.$ref (Total Keys: 1)
- schemas.ClusterConfig.properties.secondaryWorkerFlexibleConfig.$ref (Total Keys: 1)
- schemas.ClusterConfig.properties.workerFlexibleConfig.$ref (Total Keys: 1)
- schemas.FlexibleInstanceGroupConfig (Total Keys: 9)
- schemas.SessionTemplate.properties.displayName.type (Total Keys: 1)
---
 ...1.projects.locations.sessionTemplates.html |   6 +
 ....projects.locations.workflowTemplates.html | 126 ++++++++++++++++++
 ...dataproc_v1.projects.regions.clusters.html |  72 ++++++++++
 ...v1.projects.regions.workflowTemplates.html | 126 ++++++++++++++++++
 .../documents/dataproc.v1.json                |  54 +++++++-
 5 files changed, 383 insertions(+), 1 deletion(-)

diff --git a/docs/dyn/dataproc_v1.projects.locations.sessionTemplates.html b/docs/dyn/dataproc_v1.projects.locations.sessionTemplates.html
index 782ee258bc..79619f32a3 100644
--- a/docs/dyn/dataproc_v1.projects.locations.sessionTemplates.html
+++ b/docs/dyn/dataproc_v1.projects.locations.sessionTemplates.html
@@ -114,6 +114,7 @@ 
Method Details

   "createTime": "A String", # Output only. The time when the template was created.
   "creator": "A String", # Output only. The email address of the user who created the template.
   "description": "A String", # Optional. Brief description of the template.
+  "displayName": "A String", # Optional. User-friendly display name for the session template. Can be up to 63 characters.
   "environmentConfig": { # Environment configuration for a workload. # Optional. Environment configuration for session execution.
     "executionConfig": { # Execution configuration for a workload. # Optional. Execution configuration for a workload.
       "authenticationConfig": { # Authentication configuration for a workload is used to set the default identity for the workload execution. The config specifies the type of identity (service account or user) that will be used by workloads to access resources on the project(s). # Optional. Authentication configuration used to set the default identity for the workload execution. The config specifies the type of identity (service account or user) that will be used by workloads to access resources on the project(s).
@@ -184,6 +185,7 @@ 
Method Details

   "createTime": "A String", # Output only. The time when the template was created.
   "creator": "A String", # Output only. The email address of the user who created the template.
   "description": "A String", # Optional. Brief description of the template.
+  "displayName": "A String", # Optional. User-friendly display name for the session template. Can be up to 63 characters.
   "environmentConfig": { # Environment configuration for a workload. # Optional. Environment configuration for session execution.
     "executionConfig": { # Execution configuration for a workload. # Optional. Execution configuration for a workload.
       "authenticationConfig": { # Authentication configuration for a workload is used to set the default identity for the workload execution. The config specifies the type of identity (service account or user) that will be used by workloads to access resources on the project(s). # Optional. Authentication configuration used to set the default identity for the workload execution. The config specifies the type of identity (service account or user) that will be used by workloads to access resources on the project(s).
@@ -279,6 +281,7 @@ 
Method Details

   "createTime": "A String", # Output only. The time when the template was created.
   "creator": "A String", # Output only. The email address of the user who created the template.
   "description": "A String", # Optional. Brief description of the template.
+  "displayName": "A String", # Optional. User-friendly display name for the session template. Can be up to 63 characters.
   "environmentConfig": { # Environment configuration for a workload. # Optional. Environment configuration for session execution.
     "executionConfig": { # Execution configuration for a workload. # Optional. Execution configuration for a workload.
       "authenticationConfig": { # Authentication configuration for a workload is used to set the default identity for the workload execution. The config specifies the type of identity (service account or user) that will be used by workloads to access resources on the project(s). # Optional. Authentication configuration used to set the default identity for the workload execution. The config specifies the type of identity (service account or user) that will be used by workloads to access resources on the project(s).
@@ -362,6 +365,7 @@ 
Method Details

       "createTime": "A String", # Output only. The time when the template was created.
       "creator": "A String", # Output only. The email address of the user who created the template.
       "description": "A String", # Optional. Brief description of the template.
+      "displayName": "A String", # Optional. User-friendly display name for the session template. Can be up to 63 characters.
       "environmentConfig": { # Environment configuration for a workload. # Optional. Environment configuration for session execution.
         "executionConfig": { # Execution configuration for a workload. # Optional. Execution configuration for a workload.
           "authenticationConfig": { # Authentication configuration for a workload is used to set the default identity for the workload execution. The config specifies the type of identity (service account or user) that will be used by workloads to access resources on the project(s). # Optional. Authentication configuration used to set the default identity for the workload execution. The config specifies the type of identity (service account or user) that will be used by workloads to access resources on the project(s).
@@ -450,6 +454,7 @@ 
Method Details

   "createTime": "A String", # Output only. The time when the template was created.
   "creator": "A String", # Output only. The email address of the user who created the template.
   "description": "A String", # Optional. Brief description of the template.
+  "displayName": "A String", # Optional. User-friendly display name for the session template. Can be up to 63 characters.
   "environmentConfig": { # Environment configuration for a workload. # Optional. Environment configuration for session execution.
     "executionConfig": { # Execution configuration for a workload. # Optional. Execution configuration for a workload.
       "authenticationConfig": { # Authentication configuration for a workload is used to set the default identity for the workload execution. The config specifies the type of identity (service account or user) that will be used by workloads to access resources on the project(s). # Optional. Authentication configuration used to set the default identity for the workload execution. The config specifies the type of identity (service account or user) that will be used by workloads to access resources on the project(s).
@@ -520,6 +525,7 @@ 
Method Details

   "createTime": "A String", # Output only. The time when the template was created.
   "creator": "A String", # Output only. The email address of the user who created the template.
   "description": "A String", # Optional. Brief description of the template.
+  "displayName": "A String", # Optional. User-friendly display name for the session template. Can be up to 63 characters.
   "environmentConfig": { # Environment configuration for a workload. # Optional. Environment configuration for session execution.
     "executionConfig": { # Execution configuration for a workload. # Optional. Execution configuration for a workload.
       "authenticationConfig": { # Authentication configuration for a workload is used to set the default identity for the workload execution. The config specifies the type of identity (service account or user) that will be used by workloads to access resources on the project(s). # Optional. Authentication configuration used to set the default identity for the workload execution. The config specifies the type of identity (service account or user) that will be used by workloads to access resources on the project(s).
diff --git a/docs/dyn/dataproc_v1.projects.locations.workflowTemplates.html b/docs/dyn/dataproc_v1.projects.locations.workflowTemplates.html
index fcf0fe3347..4405681cca 100644
--- a/docs/dyn/dataproc_v1.projects.locations.workflowTemplates.html
+++ b/docs/dyn/dataproc_v1.projects.locations.workflowTemplates.html
@@ -724,6 +724,12 @@ 
Method Details

             "requiredRegistrationFraction": 3.14, # Optional. The config setting to enable cluster creation/ updation to be successful only after required_registration_fraction of instances are up and running. This configuration is applicable to only secondary workers for now. The cluster will fail if required_registration_fraction of instances are not available. This will include instance creation, agent registration, and service registration (if enabled).
           },
         },
+        "masterFlexibleConfig": { # The configuration for High Obtainability (HO) flexible instance groups. Flexible instance group configs serve as the single source of truth for desired state. # Optional. The High Obtainability (HO) config settings for the cluster's master instances.In High Obtainability (HO) mode, flexible configs are the single source of truth for desired cluster configuration across node groups: * For single-node clusters: master_flexible_config must be specified, and no worker configs should be set. * For multi-node (standard) clusters: both master_flexible_config and worker_flexible_config must be specified. Mixing standard and flexible configs across node groups is not allowed.Only one of master_config or master_flexible_config can be set.
+          "bootDiskSizeGb": 42, # Optional. The boot disk size in GB. This is a create-time specification and is not currently mutable via update masks.
+          "coreCount": 42, # Optional. The number of vCPUs per instance. Must be a power of 2 (2, 4, 8, 16, 32). This is a create-time specification and is not currently mutable via update masks.
+          "hardwareClass": "A String", # Optional. The hardware class of the instances. This is a create-time specification and is not currently mutable via update masks.
+          "numInstances": 42, # Optional. The number of VM instances requested.For master instances, this must be 1. For worker and secondary worker instances, this represents the desired capacity of the group and is mutable via cluster update operations and autoscaling.
+        },
         "metastoreConfig": { # Specifies a Metastore configuration. # Optional. Metastore configuration.
           "dataprocMetastoreService": "A String", # Required. Resource name of an existing Metastore service.Example: projects/[project_id]/locations/[dataproc_region]/services/[service-name]
         },
@@ -818,6 +824,12 @@ 
Method Details

             "requiredRegistrationFraction": 3.14, # Optional. The config setting to enable cluster creation/ updation to be successful only after required_registration_fraction of instances are up and running. This configuration is applicable to only secondary workers for now. The cluster will fail if required_registration_fraction of instances are not available. This will include instance creation, agent registration, and service registration (if enabled).
           },
         },
+        "secondaryWorkerFlexibleConfig": { # The configuration for High Obtainability (HO) flexible instance groups. Flexible instance group configs serve as the single source of truth for desired state. # Optional. The High Obtainability (HO) config settings for a cluster's secondary worker instances.In High Obtainability (HO) mode, flexible configs are the single source of truth for desired cluster configuration. num_instances represents the desired capacity of the secondary worker group and is mutable via cluster updates and autoscaling.Only one of secondary_worker_config or secondary_worker_flexible_config can be set.In High Obtainability (HO) mode, secondary workers are optional. If secondary workers are used in an HO cluster, they must be configured using secondary_worker_flexible_config (not secondary_worker_config).
+          "bootDiskSizeGb": 42, # Optional. The boot disk size in GB. This is a create-time specification and is not currently mutable via update masks.
+          "coreCount": 42, # Optional. The number of vCPUs per instance. Must be a power of 2 (2, 4, 8, 16, 32). This is a create-time specification and is not currently mutable via update masks.
+          "hardwareClass": "A String", # Optional. The hardware class of the instances. This is a create-time specification and is not currently mutable via update masks.
+          "numInstances": 42, # Optional. The number of VM instances requested.For master instances, this must be 1. For worker and secondary worker instances, this represents the desired capacity of the group and is mutable via cluster update operations and autoscaling.
+        },
         "securityConfig": { # Security related configuration, including encryption, Kerberos, etc. # Optional. Security settings for the cluster.
           "identityConfig": { # Identity related configuration, including service account based secure multi-tenancy user mappings. # Optional. Identity related configuration, including service account based secure multi-tenancy user mappings.
             "enableSsh": True or False, # Optional. Whether to enable SSH access for the cluster. The default is true for image versions prior to 3.1 and false for image versions 3.1 and later. The default behavior can be changed when creating clusters using image versions 2.3.30 and later.
@@ -944,6 +956,12 @@ 
Method Details

             "requiredRegistrationFraction": 3.14, # Optional. The config setting to enable cluster creation/ updation to be successful only after required_registration_fraction of instances are up and running. This configuration is applicable to only secondary workers for now. The cluster will fail if required_registration_fraction of instances are not available. This will include instance creation, agent registration, and service registration (if enabled).
           },
         },
+        "workerFlexibleConfig": { # The configuration for High Obtainability (HO) flexible instance groups. Flexible instance group configs serve as the single source of truth for desired state. # Optional. The High Obtainability (HO) config settings for the cluster's worker instances.In High Obtainability (HO) mode, flexible configs are the single source of truth for desired cluster configuration. num_instances represents the desired capacity of the worker group and is mutable via cluster updates and autoscaling.Only one of worker_config or worker_flexible_config can be set.In High Obtainability (HO) mode, for multi-node (standard) clusters, both master_flexible_config and worker_flexible_config must be specified. Mixing standard and flexible configs across node groups is not allowed. Single-node clusters do not specify worker configs.
+          "bootDiskSizeGb": 42, # Optional. The boot disk size in GB. This is a create-time specification and is not currently mutable via update masks.
+          "coreCount": 42, # Optional. The number of vCPUs per instance. Must be a power of 2 (2, 4, 8, 16, 32). This is a create-time specification and is not currently mutable via update masks.
+          "hardwareClass": "A String", # Optional. The hardware class of the instances. This is a create-time specification and is not currently mutable via update masks.
+          "numInstances": 42, # Optional. The number of VM instances requested.For master instances, this must be 1. For worker and secondary worker instances, this represents the desired capacity of the group and is mutable via cluster update operations and autoscaling.
+        },
       },
       "labels": { # Optional. The labels to associate with this cluster.Label keys must be between 1 and 63 characters long, and must conform to the following PCRE regular expression: \p{Ll}\p{Lo}{0,62}Label values must be between 1 and 63 characters long, and must conform to the following PCRE regular expression: \p{Ll}\p{Lo}\p{N}_-{0,63}No more than 32 labels can be associated with a given cluster.
         "a_key": "A String",
@@ -1561,6 +1579,12 @@ 
Method Details

             "requiredRegistrationFraction": 3.14, # Optional. The config setting to enable cluster creation/ updation to be successful only after required_registration_fraction of instances are up and running. This configuration is applicable to only secondary workers for now. The cluster will fail if required_registration_fraction of instances are not available. This will include instance creation, agent registration, and service registration (if enabled).
           },
         },
+        "masterFlexibleConfig": { # The configuration for High Obtainability (HO) flexible instance groups. Flexible instance group configs serve as the single source of truth for desired state. # Optional. The High Obtainability (HO) config settings for the cluster's master instances.In High Obtainability (HO) mode, flexible configs are the single source of truth for desired cluster configuration across node groups: * For single-node clusters: master_flexible_config must be specified, and no worker configs should be set. * For multi-node (standard) clusters: both master_flexible_config and worker_flexible_config must be specified. Mixing standard and flexible configs across node groups is not allowed.Only one of master_config or master_flexible_config can be set.
+          "bootDiskSizeGb": 42, # Optional. The boot disk size in GB. This is a create-time specification and is not currently mutable via update masks.
+          "coreCount": 42, # Optional. The number of vCPUs per instance. Must be a power of 2 (2, 4, 8, 16, 32). This is a create-time specification and is not currently mutable via update masks.
+          "hardwareClass": "A String", # Optional. The hardware class of the instances. This is a create-time specification and is not currently mutable via update masks.
+          "numInstances": 42, # Optional. The number of VM instances requested.For master instances, this must be 1. For worker and secondary worker instances, this represents the desired capacity of the group and is mutable via cluster update operations and autoscaling.
+        },
         "metastoreConfig": { # Specifies a Metastore configuration. # Optional. Metastore configuration.
           "dataprocMetastoreService": "A String", # Required. Resource name of an existing Metastore service.Example: projects/[project_id]/locations/[dataproc_region]/services/[service-name]
         },
@@ -1655,6 +1679,12 @@ 
Method Details

             "requiredRegistrationFraction": 3.14, # Optional. The config setting to enable cluster creation/ updation to be successful only after required_registration_fraction of instances are up and running. This configuration is applicable to only secondary workers for now. The cluster will fail if required_registration_fraction of instances are not available. This will include instance creation, agent registration, and service registration (if enabled).
           },
         },
+        "secondaryWorkerFlexibleConfig": { # The configuration for High Obtainability (HO) flexible instance groups. Flexible instance group configs serve as the single source of truth for desired state. # Optional. The High Obtainability (HO) config settings for a cluster's secondary worker instances.In High Obtainability (HO) mode, flexible configs are the single source of truth for desired cluster configuration. num_instances represents the desired capacity of the secondary worker group and is mutable via cluster updates and autoscaling.Only one of secondary_worker_config or secondary_worker_flexible_config can be set.In High Obtainability (HO) mode, secondary workers are optional. If secondary workers are used in an HO cluster, they must be configured using secondary_worker_flexible_config (not secondary_worker_config).
+          "bootDiskSizeGb": 42, # Optional. The boot disk size in GB. This is a create-time specification and is not currently mutable via update masks.
+          "coreCount": 42, # Optional. The number of vCPUs per instance. Must be a power of 2 (2, 4, 8, 16, 32). This is a create-time specification and is not currently mutable via update masks.
+          "hardwareClass": "A String", # Optional. The hardware class of the instances. This is a create-time specification and is not currently mutable via update masks.
+          "numInstances": 42, # Optional. The number of VM instances requested.For master instances, this must be 1. For worker and secondary worker instances, this represents the desired capacity of the group and is mutable via cluster update operations and autoscaling.
+        },
         "securityConfig": { # Security related configuration, including encryption, Kerberos, etc. # Optional. Security settings for the cluster.
           "identityConfig": { # Identity related configuration, including service account based secure multi-tenancy user mappings. # Optional. Identity related configuration, including service account based secure multi-tenancy user mappings.
             "enableSsh": True or False, # Optional. Whether to enable SSH access for the cluster. The default is true for image versions prior to 3.1 and false for image versions 3.1 and later. The default behavior can be changed when creating clusters using image versions 2.3.30 and later.
@@ -1781,6 +1811,12 @@ 
Method Details

             "requiredRegistrationFraction": 3.14, # Optional. The config setting to enable cluster creation/ updation to be successful only after required_registration_fraction of instances are up and running. This configuration is applicable to only secondary workers for now. The cluster will fail if required_registration_fraction of instances are not available. This will include instance creation, agent registration, and service registration (if enabled).
           },
         },
+        "workerFlexibleConfig": { # The configuration for High Obtainability (HO) flexible instance groups. Flexible instance group configs serve as the single source of truth for desired state. # Optional. The High Obtainability (HO) config settings for the cluster's worker instances.In High Obtainability (HO) mode, flexible configs are the single source of truth for desired cluster configuration. num_instances represents the desired capacity of the worker group and is mutable via cluster updates and autoscaling.Only one of worker_config or worker_flexible_config can be set.In High Obtainability (HO) mode, for multi-node (standard) clusters, both master_flexible_config and worker_flexible_config must be specified. Mixing standard and flexible configs across node groups is not allowed. Single-node clusters do not specify worker configs.
+          "bootDiskSizeGb": 42, # Optional. The boot disk size in GB. This is a create-time specification and is not currently mutable via update masks.
+          "coreCount": 42, # Optional. The number of vCPUs per instance. Must be a power of 2 (2, 4, 8, 16, 32). This is a create-time specification and is not currently mutable via update masks.
+          "hardwareClass": "A String", # Optional. The hardware class of the instances. This is a create-time specification and is not currently mutable via update masks.
+          "numInstances": 42, # Optional. The number of VM instances requested.For master instances, this must be 1. For worker and secondary worker instances, this represents the desired capacity of the group and is mutable via cluster update operations and autoscaling.
+        },
       },
       "labels": { # Optional. The labels to associate with this cluster.Label keys must be between 1 and 63 characters long, and must conform to the following PCRE regular expression: \p{Ll}\p{Lo}{0,62}Label values must be between 1 and 63 characters long, and must conform to the following PCRE regular expression: \p{Ll}\p{Lo}\p{N}_-{0,63}No more than 32 labels can be associated with a given cluster.
         "a_key": "A String",
@@ -2425,6 +2461,12 @@ 
Method Details

             "requiredRegistrationFraction": 3.14, # Optional. The config setting to enable cluster creation/ updation to be successful only after required_registration_fraction of instances are up and running. This configuration is applicable to only secondary workers for now. The cluster will fail if required_registration_fraction of instances are not available. This will include instance creation, agent registration, and service registration (if enabled).
           },
         },
+        "masterFlexibleConfig": { # The configuration for High Obtainability (HO) flexible instance groups. Flexible instance group configs serve as the single source of truth for desired state. # Optional. The High Obtainability (HO) config settings for the cluster's master instances.In High Obtainability (HO) mode, flexible configs are the single source of truth for desired cluster configuration across node groups: * For single-node clusters: master_flexible_config must be specified, and no worker configs should be set. * For multi-node (standard) clusters: both master_flexible_config and worker_flexible_config must be specified. Mixing standard and flexible configs across node groups is not allowed.Only one of master_config or master_flexible_config can be set.
+          "bootDiskSizeGb": 42, # Optional. The boot disk size in GB. This is a create-time specification and is not currently mutable via update masks.
+          "coreCount": 42, # Optional. The number of vCPUs per instance. Must be a power of 2 (2, 4, 8, 16, 32). This is a create-time specification and is not currently mutable via update masks.
+          "hardwareClass": "A String", # Optional. The hardware class of the instances. This is a create-time specification and is not currently mutable via update masks.
+          "numInstances": 42, # Optional. The number of VM instances requested.For master instances, this must be 1. For worker and secondary worker instances, this represents the desired capacity of the group and is mutable via cluster update operations and autoscaling.
+        },
         "metastoreConfig": { # Specifies a Metastore configuration. # Optional. Metastore configuration.
           "dataprocMetastoreService": "A String", # Required. Resource name of an existing Metastore service.Example: projects/[project_id]/locations/[dataproc_region]/services/[service-name]
         },
@@ -2519,6 +2561,12 @@ 
Method Details

             "requiredRegistrationFraction": 3.14, # Optional. The config setting to enable cluster creation/ updation to be successful only after required_registration_fraction of instances are up and running. This configuration is applicable to only secondary workers for now. The cluster will fail if required_registration_fraction of instances are not available. This will include instance creation, agent registration, and service registration (if enabled).
           },
         },
+        "secondaryWorkerFlexibleConfig": { # The configuration for High Obtainability (HO) flexible instance groups. Flexible instance group configs serve as the single source of truth for desired state. # Optional. The High Obtainability (HO) config settings for a cluster's secondary worker instances.In High Obtainability (HO) mode, flexible configs are the single source of truth for desired cluster configuration. num_instances represents the desired capacity of the secondary worker group and is mutable via cluster updates and autoscaling.Only one of secondary_worker_config or secondary_worker_flexible_config can be set.In High Obtainability (HO) mode, secondary workers are optional. If secondary workers are used in an HO cluster, they must be configured using secondary_worker_flexible_config (not secondary_worker_config).
+          "bootDiskSizeGb": 42, # Optional. The boot disk size in GB. This is a create-time specification and is not currently mutable via update masks.
+          "coreCount": 42, # Optional. The number of vCPUs per instance. Must be a power of 2 (2, 4, 8, 16, 32). This is a create-time specification and is not currently mutable via update masks.
+          "hardwareClass": "A String", # Optional. The hardware class of the instances. This is a create-time specification and is not currently mutable via update masks.
+          "numInstances": 42, # Optional. The number of VM instances requested.For master instances, this must be 1. For worker and secondary worker instances, this represents the desired capacity of the group and is mutable via cluster update operations and autoscaling.
+        },
         "securityConfig": { # Security related configuration, including encryption, Kerberos, etc. # Optional. Security settings for the cluster.
           "identityConfig": { # Identity related configuration, including service account based secure multi-tenancy user mappings. # Optional. Identity related configuration, including service account based secure multi-tenancy user mappings.
             "enableSsh": True or False, # Optional. Whether to enable SSH access for the cluster. The default is true for image versions prior to 3.1 and false for image versions 3.1 and later. The default behavior can be changed when creating clusters using image versions 2.3.30 and later.
@@ -2645,6 +2693,12 @@ 
Method Details

             "requiredRegistrationFraction": 3.14, # Optional. The config setting to enable cluster creation/ updation to be successful only after required_registration_fraction of instances are up and running. This configuration is applicable to only secondary workers for now. The cluster will fail if required_registration_fraction of instances are not available. This will include instance creation, agent registration, and service registration (if enabled).
           },
         },
+        "workerFlexibleConfig": { # The configuration for High Obtainability (HO) flexible instance groups. Flexible instance group configs serve as the single source of truth for desired state. # Optional. The High Obtainability (HO) config settings for the cluster's worker instances.In High Obtainability (HO) mode, flexible configs are the single source of truth for desired cluster configuration. num_instances represents the desired capacity of the worker group and is mutable via cluster updates and autoscaling.Only one of worker_config or worker_flexible_config can be set.In High Obtainability (HO) mode, for multi-node (standard) clusters, both master_flexible_config and worker_flexible_config must be specified. Mixing standard and flexible configs across node groups is not allowed. Single-node clusters do not specify worker configs.
+          "bootDiskSizeGb": 42, # Optional. The boot disk size in GB. This is a create-time specification and is not currently mutable via update masks.
+          "coreCount": 42, # Optional. The number of vCPUs per instance. Must be a power of 2 (2, 4, 8, 16, 32). This is a create-time specification and is not currently mutable via update masks.
+          "hardwareClass": "A String", # Optional. The hardware class of the instances. This is a create-time specification and is not currently mutable via update masks.
+          "numInstances": 42, # Optional. The number of VM instances requested.For master instances, this must be 1. For worker and secondary worker instances, this represents the desired capacity of the group and is mutable via cluster update operations and autoscaling.
+        },
       },
       "labels": { # Optional. The labels to associate with this cluster.Label keys must be between 1 and 63 characters long, and must conform to the following PCRE regular expression: \p{Ll}\p{Lo}{0,62}Label values must be between 1 and 63 characters long, and must conform to the following PCRE regular expression: \p{Ll}\p{Lo}\p{N}_-{0,63}No more than 32 labels can be associated with a given cluster.
         "a_key": "A String",
@@ -3353,6 +3407,12 @@ 
Method Details

             "requiredRegistrationFraction": 3.14, # Optional. The config setting to enable cluster creation/ updation to be successful only after required_registration_fraction of instances are up and running. This configuration is applicable to only secondary workers for now. The cluster will fail if required_registration_fraction of instances are not available. This will include instance creation, agent registration, and service registration (if enabled).
           },
         },
+        "masterFlexibleConfig": { # The configuration for High Obtainability (HO) flexible instance groups. Flexible instance group configs serve as the single source of truth for desired state. # Optional. The High Obtainability (HO) config settings for the cluster's master instances.In High Obtainability (HO) mode, flexible configs are the single source of truth for desired cluster configuration across node groups: * For single-node clusters: master_flexible_config must be specified, and no worker configs should be set. * For multi-node (standard) clusters: both master_flexible_config and worker_flexible_config must be specified. Mixing standard and flexible configs across node groups is not allowed.Only one of master_config or master_flexible_config can be set.
+          "bootDiskSizeGb": 42, # Optional. The boot disk size in GB. This is a create-time specification and is not currently mutable via update masks.
+          "coreCount": 42, # Optional. The number of vCPUs per instance. Must be a power of 2 (2, 4, 8, 16, 32). This is a create-time specification and is not currently mutable via update masks.
+          "hardwareClass": "A String", # Optional. The hardware class of the instances. This is a create-time specification and is not currently mutable via update masks.
+          "numInstances": 42, # Optional. The number of VM instances requested.For master instances, this must be 1. For worker and secondary worker instances, this represents the desired capacity of the group and is mutable via cluster update operations and autoscaling.
+        },
         "metastoreConfig": { # Specifies a Metastore configuration. # Optional. Metastore configuration.
           "dataprocMetastoreService": "A String", # Required. Resource name of an existing Metastore service.Example: projects/[project_id]/locations/[dataproc_region]/services/[service-name]
         },
@@ -3447,6 +3507,12 @@ 
Method Details

             "requiredRegistrationFraction": 3.14, # Optional. The config setting to enable cluster creation/ updation to be successful only after required_registration_fraction of instances are up and running. This configuration is applicable to only secondary workers for now. The cluster will fail if required_registration_fraction of instances are not available. This will include instance creation, agent registration, and service registration (if enabled).
           },
         },
+        "secondaryWorkerFlexibleConfig": { # The configuration for High Obtainability (HO) flexible instance groups. Flexible instance group configs serve as the single source of truth for desired state. # Optional. The High Obtainability (HO) config settings for a cluster's secondary worker instances.In High Obtainability (HO) mode, flexible configs are the single source of truth for desired cluster configuration. num_instances represents the desired capacity of the secondary worker group and is mutable via cluster updates and autoscaling.Only one of secondary_worker_config or secondary_worker_flexible_config can be set.In High Obtainability (HO) mode, secondary workers are optional. If secondary workers are used in an HO cluster, they must be configured using secondary_worker_flexible_config (not secondary_worker_config).
+          "bootDiskSizeGb": 42, # Optional. The boot disk size in GB. This is a create-time specification and is not currently mutable via update masks.
+          "coreCount": 42, # Optional. The number of vCPUs per instance. Must be a power of 2 (2, 4, 8, 16, 32). This is a create-time specification and is not currently mutable via update masks.
+          "hardwareClass": "A String", # Optional. The hardware class of the instances. This is a create-time specification and is not currently mutable via update masks.
+          "numInstances": 42, # Optional. The number of VM instances requested.For master instances, this must be 1. For worker and secondary worker instances, this represents the desired capacity of the group and is mutable via cluster update operations and autoscaling.
+        },
         "securityConfig": { # Security related configuration, including encryption, Kerberos, etc. # Optional. Security settings for the cluster.
           "identityConfig": { # Identity related configuration, including service account based secure multi-tenancy user mappings. # Optional. Identity related configuration, including service account based secure multi-tenancy user mappings.
             "enableSsh": True or False, # Optional. Whether to enable SSH access for the cluster. The default is true for image versions prior to 3.1 and false for image versions 3.1 and later. The default behavior can be changed when creating clusters using image versions 2.3.30 and later.
@@ -3573,6 +3639,12 @@ 
Method Details

             "requiredRegistrationFraction": 3.14, # Optional. The config setting to enable cluster creation/ updation to be successful only after required_registration_fraction of instances are up and running. This configuration is applicable to only secondary workers for now. The cluster will fail if required_registration_fraction of instances are not available. This will include instance creation, agent registration, and service registration (if enabled).
           },
         },
+        "workerFlexibleConfig": { # The configuration for High Obtainability (HO) flexible instance groups. Flexible instance group configs serve as the single source of truth for desired state. # Optional. The High Obtainability (HO) config settings for the cluster's worker instances.In High Obtainability (HO) mode, flexible configs are the single source of truth for desired cluster configuration. num_instances represents the desired capacity of the worker group and is mutable via cluster updates and autoscaling.Only one of worker_config or worker_flexible_config can be set.In High Obtainability (HO) mode, for multi-node (standard) clusters, both master_flexible_config and worker_flexible_config must be specified. Mixing standard and flexible configs across node groups is not allowed. Single-node clusters do not specify worker configs.
+          "bootDiskSizeGb": 42, # Optional. The boot disk size in GB. This is a create-time specification and is not currently mutable via update masks.
+          "coreCount": 42, # Optional. The number of vCPUs per instance. Must be a power of 2 (2, 4, 8, 16, 32). This is a create-time specification and is not currently mutable via update masks.
+          "hardwareClass": "A String", # Optional. The hardware class of the instances. This is a create-time specification and is not currently mutable via update masks.
+          "numInstances": 42, # Optional. The number of VM instances requested.For master instances, this must be 1. For worker and secondary worker instances, this represents the desired capacity of the group and is mutable via cluster update operations and autoscaling.
+        },
       },
       "labels": { # Optional. The labels to associate with this cluster.Label keys must be between 1 and 63 characters long, and must conform to the following PCRE regular expression: \p{Ll}\p{Lo}{0,62}Label values must be between 1 and 63 characters long, and must conform to the following PCRE regular expression: \p{Ll}\p{Lo}\p{N}_-{0,63}No more than 32 labels can be associated with a given cluster.
         "a_key": "A String",
@@ -4231,6 +4303,12 @@ 
Method Details

                 "requiredRegistrationFraction": 3.14, # Optional. The config setting to enable cluster creation/ updation to be successful only after required_registration_fraction of instances are up and running. This configuration is applicable to only secondary workers for now. The cluster will fail if required_registration_fraction of instances are not available. This will include instance creation, agent registration, and service registration (if enabled).
               },
             },
+            "masterFlexibleConfig": { # The configuration for High Obtainability (HO) flexible instance groups. Flexible instance group configs serve as the single source of truth for desired state. # Optional. The High Obtainability (HO) config settings for the cluster's master instances.In High Obtainability (HO) mode, flexible configs are the single source of truth for desired cluster configuration across node groups: * For single-node clusters: master_flexible_config must be specified, and no worker configs should be set. * For multi-node (standard) clusters: both master_flexible_config and worker_flexible_config must be specified. Mixing standard and flexible configs across node groups is not allowed.Only one of master_config or master_flexible_config can be set.
+              "bootDiskSizeGb": 42, # Optional. The boot disk size in GB. This is a create-time specification and is not currently mutable via update masks.
+              "coreCount": 42, # Optional. The number of vCPUs per instance. Must be a power of 2 (2, 4, 8, 16, 32). This is a create-time specification and is not currently mutable via update masks.
+              "hardwareClass": "A String", # Optional. The hardware class of the instances. This is a create-time specification and is not currently mutable via update masks.
+              "numInstances": 42, # Optional. The number of VM instances requested.For master instances, this must be 1. For worker and secondary worker instances, this represents the desired capacity of the group and is mutable via cluster update operations and autoscaling.
+            },
             "metastoreConfig": { # Specifies a Metastore configuration. # Optional. Metastore configuration.
               "dataprocMetastoreService": "A String", # Required. Resource name of an existing Metastore service.Example: projects/[project_id]/locations/[dataproc_region]/services/[service-name]
             },
@@ -4325,6 +4403,12 @@ 
Method Details

                 "requiredRegistrationFraction": 3.14, # Optional. The config setting to enable cluster creation/ updation to be successful only after required_registration_fraction of instances are up and running. This configuration is applicable to only secondary workers for now. The cluster will fail if required_registration_fraction of instances are not available. This will include instance creation, agent registration, and service registration (if enabled).
               },
             },
+            "secondaryWorkerFlexibleConfig": { # The configuration for High Obtainability (HO) flexible instance groups. Flexible instance group configs serve as the single source of truth for desired state. # Optional. The High Obtainability (HO) config settings for a cluster's secondary worker instances.In High Obtainability (HO) mode, flexible configs are the single source of truth for desired cluster configuration. num_instances represents the desired capacity of the secondary worker group and is mutable via cluster updates and autoscaling.Only one of secondary_worker_config or secondary_worker_flexible_config can be set.In High Obtainability (HO) mode, secondary workers are optional. If secondary workers are used in an HO cluster, they must be configured using secondary_worker_flexible_config (not secondary_worker_config).
+              "bootDiskSizeGb": 42, # Optional. The boot disk size in GB. This is a create-time specification and is not currently mutable via update masks.
+              "coreCount": 42, # Optional. The number of vCPUs per instance. Must be a power of 2 (2, 4, 8, 16, 32). This is a create-time specification and is not currently mutable via update masks.
+              "hardwareClass": "A String", # Optional. The hardware class of the instances. This is a create-time specification and is not currently mutable via update masks.
+              "numInstances": 42, # Optional. The number of VM instances requested.For master instances, this must be 1. For worker and secondary worker instances, this represents the desired capacity of the group and is mutable via cluster update operations and autoscaling.
+            },
             "securityConfig": { # Security related configuration, including encryption, Kerberos, etc. # Optional. Security settings for the cluster.
               "identityConfig": { # Identity related configuration, including service account based secure multi-tenancy user mappings. # Optional. Identity related configuration, including service account based secure multi-tenancy user mappings.
                 "enableSsh": True or False, # Optional. Whether to enable SSH access for the cluster. The default is true for image versions prior to 3.1 and false for image versions 3.1 and later. The default behavior can be changed when creating clusters using image versions 2.3.30 and later.
@@ -4451,6 +4535,12 @@ 
Method Details

                 "requiredRegistrationFraction": 3.14, # Optional. The config setting to enable cluster creation/ updation to be successful only after required_registration_fraction of instances are up and running. This configuration is applicable to only secondary workers for now. The cluster will fail if required_registration_fraction of instances are not available. This will include instance creation, agent registration, and service registration (if enabled).
               },
             },
+            "workerFlexibleConfig": { # The configuration for High Obtainability (HO) flexible instance groups. Flexible instance group configs serve as the single source of truth for desired state. # Optional. The High Obtainability (HO) config settings for the cluster's worker instances.In High Obtainability (HO) mode, flexible configs are the single source of truth for desired cluster configuration. num_instances represents the desired capacity of the worker group and is mutable via cluster updates and autoscaling.Only one of worker_config or worker_flexible_config can be set.In High Obtainability (HO) mode, for multi-node (standard) clusters, both master_flexible_config and worker_flexible_config must be specified. Mixing standard and flexible configs across node groups is not allowed. Single-node clusters do not specify worker configs.
+              "bootDiskSizeGb": 42, # Optional. The boot disk size in GB. This is a create-time specification and is not currently mutable via update masks.
+              "coreCount": 42, # Optional. The number of vCPUs per instance. Must be a power of 2 (2, 4, 8, 16, 32). This is a create-time specification and is not currently mutable via update masks.
+              "hardwareClass": "A String", # Optional. The hardware class of the instances. This is a create-time specification and is not currently mutable via update masks.
+              "numInstances": 42, # Optional. The number of VM instances requested.For master instances, this must be 1. For worker and secondary worker instances, this represents the desired capacity of the group and is mutable via cluster update operations and autoscaling.
+            },
           },
           "labels": { # Optional. The labels to associate with this cluster.Label keys must be between 1 and 63 characters long, and must conform to the following PCRE regular expression: \p{Ll}\p{Lo}{0,62}Label values must be between 1 and 63 characters long, and must conform to the following PCRE regular expression: \p{Ll}\p{Lo}\p{N}_-{0,63}No more than 32 labels can be associated with a given cluster.
             "a_key": "A String",
@@ -5177,6 +5267,12 @@ 
Method Details

             "requiredRegistrationFraction": 3.14, # Optional. The config setting to enable cluster creation/ updation to be successful only after required_registration_fraction of instances are up and running. This configuration is applicable to only secondary workers for now. The cluster will fail if required_registration_fraction of instances are not available. This will include instance creation, agent registration, and service registration (if enabled).
           },
         },
+        "masterFlexibleConfig": { # The configuration for High Obtainability (HO) flexible instance groups. Flexible instance group configs serve as the single source of truth for desired state. # Optional. The High Obtainability (HO) config settings for the cluster's master instances.In High Obtainability (HO) mode, flexible configs are the single source of truth for desired cluster configuration across node groups: * For single-node clusters: master_flexible_config must be specified, and no worker configs should be set. * For multi-node (standard) clusters: both master_flexible_config and worker_flexible_config must be specified. Mixing standard and flexible configs across node groups is not allowed.Only one of master_config or master_flexible_config can be set.
+          "bootDiskSizeGb": 42, # Optional. The boot disk size in GB. This is a create-time specification and is not currently mutable via update masks.
+          "coreCount": 42, # Optional. The number of vCPUs per instance. Must be a power of 2 (2, 4, 8, 16, 32). This is a create-time specification and is not currently mutable via update masks.
+          "hardwareClass": "A String", # Optional. The hardware class of the instances. This is a create-time specification and is not currently mutable via update masks.
+          "numInstances": 42, # Optional. The number of VM instances requested.For master instances, this must be 1. For worker and secondary worker instances, this represents the desired capacity of the group and is mutable via cluster update operations and autoscaling.
+        },
         "metastoreConfig": { # Specifies a Metastore configuration. # Optional. Metastore configuration.
           "dataprocMetastoreService": "A String", # Required. Resource name of an existing Metastore service.Example: projects/[project_id]/locations/[dataproc_region]/services/[service-name]
         },
@@ -5271,6 +5367,12 @@ 
Method Details

             "requiredRegistrationFraction": 3.14, # Optional. The config setting to enable cluster creation/ updation to be successful only after required_registration_fraction of instances are up and running. This configuration is applicable to only secondary workers for now. The cluster will fail if required_registration_fraction of instances are not available. This will include instance creation, agent registration, and service registration (if enabled).
           },
         },
+        "secondaryWorkerFlexibleConfig": { # The configuration for High Obtainability (HO) flexible instance groups. Flexible instance group configs serve as the single source of truth for desired state. # Optional. The High Obtainability (HO) config settings for a cluster's secondary worker instances.In High Obtainability (HO) mode, flexible configs are the single source of truth for desired cluster configuration. num_instances represents the desired capacity of the secondary worker group and is mutable via cluster updates and autoscaling.Only one of secondary_worker_config or secondary_worker_flexible_config can be set.In High Obtainability (HO) mode, secondary workers are optional. If secondary workers are used in an HO cluster, they must be configured using secondary_worker_flexible_config (not secondary_worker_config).
+          "bootDiskSizeGb": 42, # Optional. The boot disk size in GB. This is a create-time specification and is not currently mutable via update masks.
+          "coreCount": 42, # Optional. The number of vCPUs per instance. Must be a power of 2 (2, 4, 8, 16, 32). This is a create-time specification and is not currently mutable via update masks.
+          "hardwareClass": "A String", # Optional. The hardware class of the instances. This is a create-time specification and is not currently mutable via update masks.
+          "numInstances": 42, # Optional. The number of VM instances requested.For master instances, this must be 1. For worker and secondary worker instances, this represents the desired capacity of the group and is mutable via cluster update operations and autoscaling.
+        },
         "securityConfig": { # Security related configuration, including encryption, Kerberos, etc. # Optional. Security settings for the cluster.
           "identityConfig": { # Identity related configuration, including service account based secure multi-tenancy user mappings. # Optional. Identity related configuration, including service account based secure multi-tenancy user mappings.
             "enableSsh": True or False, # Optional. Whether to enable SSH access for the cluster. The default is true for image versions prior to 3.1 and false for image versions 3.1 and later. The default behavior can be changed when creating clusters using image versions 2.3.30 and later.
@@ -5397,6 +5499,12 @@ 
Method Details

             "requiredRegistrationFraction": 3.14, # Optional. The config setting to enable cluster creation/ updation to be successful only after required_registration_fraction of instances are up and running. This configuration is applicable to only secondary workers for now. The cluster will fail if required_registration_fraction of instances are not available. This will include instance creation, agent registration, and service registration (if enabled).
           },
         },
+        "workerFlexibleConfig": { # The configuration for High Obtainability (HO) flexible instance groups. Flexible instance group configs serve as the single source of truth for desired state. # Optional. The High Obtainability (HO) config settings for the cluster's worker instances.In High Obtainability (HO) mode, flexible configs are the single source of truth for desired cluster configuration. num_instances represents the desired capacity of the worker group and is mutable via cluster updates and autoscaling.Only one of worker_config or worker_flexible_config can be set.In High Obtainability (HO) mode, for multi-node (standard) clusters, both master_flexible_config and worker_flexible_config must be specified. Mixing standard and flexible configs across node groups is not allowed. Single-node clusters do not specify worker configs.
+          "bootDiskSizeGb": 42, # Optional. The boot disk size in GB. This is a create-time specification and is not currently mutable via update masks.
+          "coreCount": 42, # Optional. The number of vCPUs per instance. Must be a power of 2 (2, 4, 8, 16, 32). This is a create-time specification and is not currently mutable via update masks.
+          "hardwareClass": "A String", # Optional. The hardware class of the instances. This is a create-time specification and is not currently mutable via update masks.
+          "numInstances": 42, # Optional. The number of VM instances requested.For master instances, this must be 1. For worker and secondary worker instances, this represents the desired capacity of the group and is mutable via cluster update operations and autoscaling.
+        },
       },
       "labels": { # Optional. The labels to associate with this cluster.Label keys must be between 1 and 63 characters long, and must conform to the following PCRE regular expression: \p{Ll}\p{Lo}{0,62}Label values must be between 1 and 63 characters long, and must conform to the following PCRE regular expression: \p{Ll}\p{Lo}\p{N}_-{0,63}No more than 32 labels can be associated with a given cluster.
         "a_key": "A String",
@@ -6014,6 +6122,12 @@ 
Method Details

             "requiredRegistrationFraction": 3.14, # Optional. The config setting to enable cluster creation/ updation to be successful only after required_registration_fraction of instances are up and running. This configuration is applicable to only secondary workers for now. The cluster will fail if required_registration_fraction of instances are not available. This will include instance creation, agent registration, and service registration (if enabled).
           },
         },
+        "masterFlexibleConfig": { # The configuration for High Obtainability (HO) flexible instance groups. Flexible instance group configs serve as the single source of truth for desired state. # Optional. The High Obtainability (HO) config settings for the cluster's master instances.In High Obtainability (HO) mode, flexible configs are the single source of truth for desired cluster configuration across node groups: * For single-node clusters: master_flexible_config must be specified, and no worker configs should be set. * For multi-node (standard) clusters: both master_flexible_config and worker_flexible_config must be specified. Mixing standard and flexible configs across node groups is not allowed.Only one of master_config or master_flexible_config can be set.
+          "bootDiskSizeGb": 42, # Optional. The boot disk size in GB. This is a create-time specification and is not currently mutable via update masks.
+          "coreCount": 42, # Optional. The number of vCPUs per instance. Must be a power of 2 (2, 4, 8, 16, 32). This is a create-time specification and is not currently mutable via update masks.
+          "hardwareClass": "A String", # Optional. The hardware class of the instances. This is a create-time specification and is not currently mutable via update masks.
+          "numInstances": 42, # Optional. The number of VM instances requested.For master instances, this must be 1. For worker and secondary worker instances, this represents the desired capacity of the group and is mutable via cluster update operations and autoscaling.
+        },
         "metastoreConfig": { # Specifies a Metastore configuration. # Optional. Metastore configuration.
           "dataprocMetastoreService": "A String", # Required. Resource name of an existing Metastore service.Example: projects/[project_id]/locations/[dataproc_region]/services/[service-name]
         },
@@ -6108,6 +6222,12 @@ 
Method Details

             "requiredRegistrationFraction": 3.14, # Optional. The config setting to enable cluster creation/ updation to be successful only after required_registration_fraction of instances are up and running. This configuration is applicable to only secondary workers for now. The cluster will fail if required_registration_fraction of instances are not available. This will include instance creation, agent registration, and service registration (if enabled).
           },
         },
+        "secondaryWorkerFlexibleConfig": { # The configuration for High Obtainability (HO) flexible instance groups. Flexible instance group configs serve as the single source of truth for desired state. # Optional. The High Obtainability (HO) config settings for a cluster's secondary worker instances.In High Obtainability (HO) mode, flexible configs are the single source of truth for desired cluster configuration. num_instances represents the desired capacity of the secondary worker group and is mutable via cluster updates and autoscaling.Only one of secondary_worker_config or secondary_worker_flexible_config can be set.In High Obtainability (HO) mode, secondary workers are optional. If secondary workers are used in an HO cluster, they must be configured using secondary_worker_flexible_config (not secondary_worker_config).
+          "bootDiskSizeGb": 42, # Optional. The boot disk size in GB. This is a create-time specification and is not currently mutable via update masks.
+          "coreCount": 42, # Optional. The number of vCPUs per instance. Must be a power of 2 (2, 4, 8, 16, 32). This is a create-time specification and is not currently mutable via update masks.
+          "hardwareClass": "A String", # Optional. The hardware class of the instances. This is a create-time specification and is not currently mutable via update masks.
+          "numInstances": 42, # Optional. The number of VM instances requested.For master instances, this must be 1. For worker and secondary worker instances, this represents the desired capacity of the group and is mutable via cluster update operations and autoscaling.
+        },
         "securityConfig": { # Security related configuration, including encryption, Kerberos, etc. # Optional. Security settings for the cluster.
           "identityConfig": { # Identity related configuration, including service account based secure multi-tenancy user mappings. # Optional. Identity related configuration, including service account based secure multi-tenancy user mappings.
             "enableSsh": True or False, # Optional. Whether to enable SSH access for the cluster. The default is true for image versions prior to 3.1 and false for image versions 3.1 and later. The default behavior can be changed when creating clusters using image versions 2.3.30 and later.
@@ -6234,6 +6354,12 @@ 
Method Details

             "requiredRegistrationFraction": 3.14, # Optional. The config setting to enable cluster creation/ updation to be successful only after required_registration_fraction of instances are up and running. This configuration is applicable to only secondary workers for now. The cluster will fail if required_registration_fraction of instances are not available. This will include instance creation, agent registration, and service registration (if enabled).
           },
         },
+        "workerFlexibleConfig": { # The configuration for High Obtainability (HO) flexible instance groups. Flexible instance group configs serve as the single source of truth for desired state. # Optional. The High Obtainability (HO) config settings for the cluster's worker instances.In High Obtainability (HO) mode, flexible configs are the single source of truth for desired cluster configuration. num_instances represents the desired capacity of the worker group and is mutable via cluster updates and autoscaling.Only one of worker_config or worker_flexible_config can be set.In High Obtainability (HO) mode, for multi-node (standard) clusters, both master_flexible_config and worker_flexible_config must be specified. Mixing standard and flexible configs across node groups is not allowed. Single-node clusters do not specify worker configs.
+          "bootDiskSizeGb": 42, # Optional. The boot disk size in GB. This is a create-time specification and is not currently mutable via update masks.
+          "coreCount": 42, # Optional. The number of vCPUs per instance. Must be a power of 2 (2, 4, 8, 16, 32). This is a create-time specification and is not currently mutable via update masks.
+          "hardwareClass": "A String", # Optional. The hardware class of the instances. This is a create-time specification and is not currently mutable via update masks.
+          "numInstances": 42, # Optional. The number of VM instances requested.For master instances, this must be 1. For worker and secondary worker instances, this represents the desired capacity of the group and is mutable via cluster update operations and autoscaling.
+        },
       },
       "labels": { # Optional. The labels to associate with this cluster.Label keys must be between 1 and 63 characters long, and must conform to the following PCRE regular expression: \p{Ll}\p{Lo}{0,62}Label values must be between 1 and 63 characters long, and must conform to the following PCRE regular expression: \p{Ll}\p{Lo}\p{N}_-{0,63}No more than 32 labels can be associated with a given cluster.
         "a_key": "A String",
diff --git a/docs/dyn/dataproc_v1.projects.regions.clusters.html b/docs/dyn/dataproc_v1.projects.regions.clusters.html
index 6b7e32cee3..87df5c1e5e 100644
--- a/docs/dyn/dataproc_v1.projects.regions.clusters.html
+++ b/docs/dyn/dataproc_v1.projects.regions.clusters.html
@@ -468,6 +468,12 @@ 
Method Details

         "requiredRegistrationFraction": 3.14, # Optional. The config setting to enable cluster creation/ updation to be successful only after required_registration_fraction of instances are up and running. This configuration is applicable to only secondary workers for now. The cluster will fail if required_registration_fraction of instances are not available. This will include instance creation, agent registration, and service registration (if enabled).
       },
     },
+    "masterFlexibleConfig": { # The configuration for High Obtainability (HO) flexible instance groups. Flexible instance group configs serve as the single source of truth for desired state. # Optional. The High Obtainability (HO) config settings for the cluster's master instances.In High Obtainability (HO) mode, flexible configs are the single source of truth for desired cluster configuration across node groups: * For single-node clusters: master_flexible_config must be specified, and no worker configs should be set. * For multi-node (standard) clusters: both master_flexible_config and worker_flexible_config must be specified. Mixing standard and flexible configs across node groups is not allowed.Only one of master_config or master_flexible_config can be set.
+      "bootDiskSizeGb": 42, # Optional. The boot disk size in GB. This is a create-time specification and is not currently mutable via update masks.
+      "coreCount": 42, # Optional. The number of vCPUs per instance. Must be a power of 2 (2, 4, 8, 16, 32). This is a create-time specification and is not currently mutable via update masks.
+      "hardwareClass": "A String", # Optional. The hardware class of the instances. This is a create-time specification and is not currently mutable via update masks.
+      "numInstances": 42, # Optional. The number of VM instances requested.For master instances, this must be 1. For worker and secondary worker instances, this represents the desired capacity of the group and is mutable via cluster update operations and autoscaling.
+    },
     "metastoreConfig": { # Specifies a Metastore configuration. # Optional. Metastore configuration.
       "dataprocMetastoreService": "A String", # Required. Resource name of an existing Metastore service.Example: projects/[project_id]/locations/[dataproc_region]/services/[service-name]
     },
@@ -562,6 +568,12 @@ 
Method Details

         "requiredRegistrationFraction": 3.14, # Optional. The config setting to enable cluster creation/ updation to be successful only after required_registration_fraction of instances are up and running. This configuration is applicable to only secondary workers for now. The cluster will fail if required_registration_fraction of instances are not available. This will include instance creation, agent registration, and service registration (if enabled).
       },
     },
+    "secondaryWorkerFlexibleConfig": { # The configuration for High Obtainability (HO) flexible instance groups. Flexible instance group configs serve as the single source of truth for desired state. # Optional. The High Obtainability (HO) config settings for a cluster's secondary worker instances.In High Obtainability (HO) mode, flexible configs are the single source of truth for desired cluster configuration. num_instances represents the desired capacity of the secondary worker group and is mutable via cluster updates and autoscaling.Only one of secondary_worker_config or secondary_worker_flexible_config can be set.In High Obtainability (HO) mode, secondary workers are optional. If secondary workers are used in an HO cluster, they must be configured using secondary_worker_flexible_config (not secondary_worker_config).
+      "bootDiskSizeGb": 42, # Optional. The boot disk size in GB. This is a create-time specification and is not currently mutable via update masks.
+      "coreCount": 42, # Optional. The number of vCPUs per instance. Must be a power of 2 (2, 4, 8, 16, 32). This is a create-time specification and is not currently mutable via update masks.
+      "hardwareClass": "A String", # Optional. The hardware class of the instances. This is a create-time specification and is not currently mutable via update masks.
+      "numInstances": 42, # Optional. The number of VM instances requested.For master instances, this must be 1. For worker and secondary worker instances, this represents the desired capacity of the group and is mutable via cluster update operations and autoscaling.
+    },
     "securityConfig": { # Security related configuration, including encryption, Kerberos, etc. # Optional. Security settings for the cluster.
       "identityConfig": { # Identity related configuration, including service account based secure multi-tenancy user mappings. # Optional. Identity related configuration, including service account based secure multi-tenancy user mappings.
         "enableSsh": True or False, # Optional. Whether to enable SSH access for the cluster. The default is true for image versions prior to 3.1 and false for image versions 3.1 and later. The default behavior can be changed when creating clusters using image versions 2.3.30 and later.
@@ -688,6 +700,12 @@ 
Method Details

         "requiredRegistrationFraction": 3.14, # Optional. The config setting to enable cluster creation/ updation to be successful only after required_registration_fraction of instances are up and running. This configuration is applicable to only secondary workers for now. The cluster will fail if required_registration_fraction of instances are not available. This will include instance creation, agent registration, and service registration (if enabled).
       },
     },
+    "workerFlexibleConfig": { # The configuration for High Obtainability (HO) flexible instance groups. Flexible instance group configs serve as the single source of truth for desired state. # Optional. The High Obtainability (HO) config settings for the cluster's worker instances.In High Obtainability (HO) mode, flexible configs are the single source of truth for desired cluster configuration. num_instances represents the desired capacity of the worker group and is mutable via cluster updates and autoscaling.Only one of worker_config or worker_flexible_config can be set.In High Obtainability (HO) mode, for multi-node (standard) clusters, both master_flexible_config and worker_flexible_config must be specified. Mixing standard and flexible configs across node groups is not allowed. Single-node clusters do not specify worker configs.
+      "bootDiskSizeGb": 42, # Optional. The boot disk size in GB. This is a create-time specification and is not currently mutable via update masks.
+      "coreCount": 42, # Optional. The number of vCPUs per instance. Must be a power of 2 (2, 4, 8, 16, 32). This is a create-time specification and is not currently mutable via update masks.
+      "hardwareClass": "A String", # Optional. The hardware class of the instances. This is a create-time specification and is not currently mutable via update masks.
+      "numInstances": 42, # Optional. The number of VM instances requested.For master instances, this must be 1. For worker and secondary worker instances, this represents the desired capacity of the group and is mutable via cluster update operations and autoscaling.
+    },
   },
   "labels": { # Optional. The labels to associate with this cluster. Label keys must contain 1 to 63 characters, and must conform to RFC 1035 (https://www.ietf.org/rfc/rfc1035.txt). Label values may be empty, but, if present, must contain 1 to 63 characters, and must conform to RFC 1035 (https://www.ietf.org/rfc/rfc1035.txt). No more than 32 labels can be associated with a cluster.
     "a_key": "A String",
@@ -1255,6 +1273,12 @@ 
Method Details

         "requiredRegistrationFraction": 3.14, # Optional. The config setting to enable cluster creation/ updation to be successful only after required_registration_fraction of instances are up and running. This configuration is applicable to only secondary workers for now. The cluster will fail if required_registration_fraction of instances are not available. This will include instance creation, agent registration, and service registration (if enabled).
       },
     },
+    "masterFlexibleConfig": { # The configuration for High Obtainability (HO) flexible instance groups. Flexible instance group configs serve as the single source of truth for desired state. # Optional. The High Obtainability (HO) config settings for the cluster's master instances.In High Obtainability (HO) mode, flexible configs are the single source of truth for desired cluster configuration across node groups: * For single-node clusters: master_flexible_config must be specified, and no worker configs should be set. * For multi-node (standard) clusters: both master_flexible_config and worker_flexible_config must be specified. Mixing standard and flexible configs across node groups is not allowed.Only one of master_config or master_flexible_config can be set.
+      "bootDiskSizeGb": 42, # Optional. The boot disk size in GB. This is a create-time specification and is not currently mutable via update masks.
+      "coreCount": 42, # Optional. The number of vCPUs per instance. Must be a power of 2 (2, 4, 8, 16, 32). This is a create-time specification and is not currently mutable via update masks.
+      "hardwareClass": "A String", # Optional. The hardware class of the instances. This is a create-time specification and is not currently mutable via update masks.
+      "numInstances": 42, # Optional. The number of VM instances requested.For master instances, this must be 1. For worker and secondary worker instances, this represents the desired capacity of the group and is mutable via cluster update operations and autoscaling.
+    },
     "metastoreConfig": { # Specifies a Metastore configuration. # Optional. Metastore configuration.
       "dataprocMetastoreService": "A String", # Required. Resource name of an existing Metastore service.Example: projects/[project_id]/locations/[dataproc_region]/services/[service-name]
     },
@@ -1349,6 +1373,12 @@ 
Method Details

         "requiredRegistrationFraction": 3.14, # Optional. The config setting to enable cluster creation/ updation to be successful only after required_registration_fraction of instances are up and running. This configuration is applicable to only secondary workers for now. The cluster will fail if required_registration_fraction of instances are not available. This will include instance creation, agent registration, and service registration (if enabled).
       },
     },
+    "secondaryWorkerFlexibleConfig": { # The configuration for High Obtainability (HO) flexible instance groups. Flexible instance group configs serve as the single source of truth for desired state. # Optional. The High Obtainability (HO) config settings for a cluster's secondary worker instances.In High Obtainability (HO) mode, flexible configs are the single source of truth for desired cluster configuration. num_instances represents the desired capacity of the secondary worker group and is mutable via cluster updates and autoscaling.Only one of secondary_worker_config or secondary_worker_flexible_config can be set.In High Obtainability (HO) mode, secondary workers are optional. If secondary workers are used in an HO cluster, they must be configured using secondary_worker_flexible_config (not secondary_worker_config).
+      "bootDiskSizeGb": 42, # Optional. The boot disk size in GB. This is a create-time specification and is not currently mutable via update masks.
+      "coreCount": 42, # Optional. The number of vCPUs per instance. Must be a power of 2 (2, 4, 8, 16, 32). This is a create-time specification and is not currently mutable via update masks.
+      "hardwareClass": "A String", # Optional. The hardware class of the instances. This is a create-time specification and is not currently mutable via update masks.
+      "numInstances": 42, # Optional. The number of VM instances requested.For master instances, this must be 1. For worker and secondary worker instances, this represents the desired capacity of the group and is mutable via cluster update operations and autoscaling.
+    },
     "securityConfig": { # Security related configuration, including encryption, Kerberos, etc. # Optional. Security settings for the cluster.
       "identityConfig": { # Identity related configuration, including service account based secure multi-tenancy user mappings. # Optional. Identity related configuration, including service account based secure multi-tenancy user mappings.
         "enableSsh": True or False, # Optional. Whether to enable SSH access for the cluster. The default is true for image versions prior to 3.1 and false for image versions 3.1 and later. The default behavior can be changed when creating clusters using image versions 2.3.30 and later.
@@ -1475,6 +1505,12 @@ 
Method Details

         "requiredRegistrationFraction": 3.14, # Optional. The config setting to enable cluster creation/ updation to be successful only after required_registration_fraction of instances are up and running. This configuration is applicable to only secondary workers for now. The cluster will fail if required_registration_fraction of instances are not available. This will include instance creation, agent registration, and service registration (if enabled).
       },
     },
+    "workerFlexibleConfig": { # The configuration for High Obtainability (HO) flexible instance groups. Flexible instance group configs serve as the single source of truth for desired state. # Optional. The High Obtainability (HO) config settings for the cluster's worker instances.In High Obtainability (HO) mode, flexible configs are the single source of truth for desired cluster configuration. num_instances represents the desired capacity of the worker group and is mutable via cluster updates and autoscaling.Only one of worker_config or worker_flexible_config can be set.In High Obtainability (HO) mode, for multi-node (standard) clusters, both master_flexible_config and worker_flexible_config must be specified. Mixing standard and flexible configs across node groups is not allowed. Single-node clusters do not specify worker configs.
+      "bootDiskSizeGb": 42, # Optional. The boot disk size in GB. This is a create-time specification and is not currently mutable via update masks.
+      "coreCount": 42, # Optional. The number of vCPUs per instance. Must be a power of 2 (2, 4, 8, 16, 32). This is a create-time specification and is not currently mutable via update masks.
+      "hardwareClass": "A String", # Optional. The hardware class of the instances. This is a create-time specification and is not currently mutable via update masks.
+      "numInstances": 42, # Optional. The number of VM instances requested.For master instances, this must be 1. For worker and secondary worker instances, this represents the desired capacity of the group and is mutable via cluster update operations and autoscaling.
+    },
   },
   "labels": { # Optional. The labels to associate with this cluster. Label keys must contain 1 to 63 characters, and must conform to RFC 1035 (https://www.ietf.org/rfc/rfc1035.txt). Label values may be empty, but, if present, must contain 1 to 63 characters, and must conform to RFC 1035 (https://www.ietf.org/rfc/rfc1035.txt). No more than 32 labels can be associated with a cluster.
     "a_key": "A String",
@@ -2003,6 +2039,12 @@ 
Method Details

             "requiredRegistrationFraction": 3.14, # Optional. The config setting to enable cluster creation/ updation to be successful only after required_registration_fraction of instances are up and running. This configuration is applicable to only secondary workers for now. The cluster will fail if required_registration_fraction of instances are not available. This will include instance creation, agent registration, and service registration (if enabled).
           },
         },
+        "masterFlexibleConfig": { # The configuration for High Obtainability (HO) flexible instance groups. Flexible instance group configs serve as the single source of truth for desired state. # Optional. The High Obtainability (HO) config settings for the cluster's master instances.In High Obtainability (HO) mode, flexible configs are the single source of truth for desired cluster configuration across node groups: * For single-node clusters: master_flexible_config must be specified, and no worker configs should be set. * For multi-node (standard) clusters: both master_flexible_config and worker_flexible_config must be specified. Mixing standard and flexible configs across node groups is not allowed.Only one of master_config or master_flexible_config can be set.
+          "bootDiskSizeGb": 42, # Optional. The boot disk size in GB. This is a create-time specification and is not currently mutable via update masks.
+          "coreCount": 42, # Optional. The number of vCPUs per instance. Must be a power of 2 (2, 4, 8, 16, 32). This is a create-time specification and is not currently mutable via update masks.
+          "hardwareClass": "A String", # Optional. The hardware class of the instances. This is a create-time specification and is not currently mutable via update masks.
+          "numInstances": 42, # Optional. The number of VM instances requested.For master instances, this must be 1. For worker and secondary worker instances, this represents the desired capacity of the group and is mutable via cluster update operations and autoscaling.
+        },
         "metastoreConfig": { # Specifies a Metastore configuration. # Optional. Metastore configuration.
           "dataprocMetastoreService": "A String", # Required. Resource name of an existing Metastore service.Example: projects/[project_id]/locations/[dataproc_region]/services/[service-name]
         },
@@ -2097,6 +2139,12 @@ 
Method Details

             "requiredRegistrationFraction": 3.14, # Optional. The config setting to enable cluster creation/ updation to be successful only after required_registration_fraction of instances are up and running. This configuration is applicable to only secondary workers for now. The cluster will fail if required_registration_fraction of instances are not available. This will include instance creation, agent registration, and service registration (if enabled).
           },
         },
+        "secondaryWorkerFlexibleConfig": { # The configuration for High Obtainability (HO) flexible instance groups. Flexible instance group configs serve as the single source of truth for desired state. # Optional. The High Obtainability (HO) config settings for a cluster's secondary worker instances.In High Obtainability (HO) mode, flexible configs are the single source of truth for desired cluster configuration. num_instances represents the desired capacity of the secondary worker group and is mutable via cluster updates and autoscaling.Only one of secondary_worker_config or secondary_worker_flexible_config can be set.In High Obtainability (HO) mode, secondary workers are optional. If secondary workers are used in an HO cluster, they must be configured using secondary_worker_flexible_config (not secondary_worker_config).
+          "bootDiskSizeGb": 42, # Optional. The boot disk size in GB. This is a create-time specification and is not currently mutable via update masks.
+          "coreCount": 42, # Optional. The number of vCPUs per instance. Must be a power of 2 (2, 4, 8, 16, 32). This is a create-time specification and is not currently mutable via update masks.
+          "hardwareClass": "A String", # Optional. The hardware class of the instances. This is a create-time specification and is not currently mutable via update masks.
+          "numInstances": 42, # Optional. The number of VM instances requested.For master instances, this must be 1. For worker and secondary worker instances, this represents the desired capacity of the group and is mutable via cluster update operations and autoscaling.
+        },
         "securityConfig": { # Security related configuration, including encryption, Kerberos, etc. # Optional. Security settings for the cluster.
           "identityConfig": { # Identity related configuration, including service account based secure multi-tenancy user mappings. # Optional. Identity related configuration, including service account based secure multi-tenancy user mappings.
             "enableSsh": True or False, # Optional. Whether to enable SSH access for the cluster. The default is true for image versions prior to 3.1 and false for image versions 3.1 and later. The default behavior can be changed when creating clusters using image versions 2.3.30 and later.
@@ -2223,6 +2271,12 @@ 
Method Details

             "requiredRegistrationFraction": 3.14, # Optional. The config setting to enable cluster creation/ updation to be successful only after required_registration_fraction of instances are up and running. This configuration is applicable to only secondary workers for now. The cluster will fail if required_registration_fraction of instances are not available. This will include instance creation, agent registration, and service registration (if enabled).
           },
         },
+        "workerFlexibleConfig": { # The configuration for High Obtainability (HO) flexible instance groups. Flexible instance group configs serve as the single source of truth for desired state. # Optional. The High Obtainability (HO) config settings for the cluster's worker instances.In High Obtainability (HO) mode, flexible configs are the single source of truth for desired cluster configuration. num_instances represents the desired capacity of the worker group and is mutable via cluster updates and autoscaling.Only one of worker_config or worker_flexible_config can be set.In High Obtainability (HO) mode, for multi-node (standard) clusters, both master_flexible_config and worker_flexible_config must be specified. Mixing standard and flexible configs across node groups is not allowed. Single-node clusters do not specify worker configs.
+          "bootDiskSizeGb": 42, # Optional. The boot disk size in GB. This is a create-time specification and is not currently mutable via update masks.
+          "coreCount": 42, # Optional. The number of vCPUs per instance. Must be a power of 2 (2, 4, 8, 16, 32). This is a create-time specification and is not currently mutable via update masks.
+          "hardwareClass": "A String", # Optional. The hardware class of the instances. This is a create-time specification and is not currently mutable via update masks.
+          "numInstances": 42, # Optional. The number of VM instances requested.For master instances, this must be 1. For worker and secondary worker instances, this represents the desired capacity of the group and is mutable via cluster update operations and autoscaling.
+        },
       },
       "labels": { # Optional. The labels to associate with this cluster. Label keys must contain 1 to 63 characters, and must conform to RFC 1035 (https://www.ietf.org/rfc/rfc1035.txt). Label values may be empty, but, if present, must contain 1 to 63 characters, and must conform to RFC 1035 (https://www.ietf.org/rfc/rfc1035.txt). No more than 32 labels can be associated with a cluster.
         "a_key": "A String",
@@ -2671,6 +2725,12 @@ 
Method Details

         "requiredRegistrationFraction": 3.14, # Optional. The config setting to enable cluster creation/ updation to be successful only after required_registration_fraction of instances are up and running. This configuration is applicable to only secondary workers for now. The cluster will fail if required_registration_fraction of instances are not available. This will include instance creation, agent registration, and service registration (if enabled).
       },
     },
+    "masterFlexibleConfig": { # The configuration for High Obtainability (HO) flexible instance groups. Flexible instance group configs serve as the single source of truth for desired state. # Optional. The High Obtainability (HO) config settings for the cluster's master instances.In High Obtainability (HO) mode, flexible configs are the single source of truth for desired cluster configuration across node groups: * For single-node clusters: master_flexible_config must be specified, and no worker configs should be set. * For multi-node (standard) clusters: both master_flexible_config and worker_flexible_config must be specified. Mixing standard and flexible configs across node groups is not allowed.Only one of master_config or master_flexible_config can be set.
+      "bootDiskSizeGb": 42, # Optional. The boot disk size in GB. This is a create-time specification and is not currently mutable via update masks.
+      "coreCount": 42, # Optional. The number of vCPUs per instance. Must be a power of 2 (2, 4, 8, 16, 32). This is a create-time specification and is not currently mutable via update masks.
+      "hardwareClass": "A String", # Optional. The hardware class of the instances. This is a create-time specification and is not currently mutable via update masks.
+      "numInstances": 42, # Optional. The number of VM instances requested.For master instances, this must be 1. For worker and secondary worker instances, this represents the desired capacity of the group and is mutable via cluster update operations and autoscaling.
+    },
     "metastoreConfig": { # Specifies a Metastore configuration. # Optional. Metastore configuration.
       "dataprocMetastoreService": "A String", # Required. Resource name of an existing Metastore service.Example: projects/[project_id]/locations/[dataproc_region]/services/[service-name]
     },
@@ -2765,6 +2825,12 @@ 
Method Details

         "requiredRegistrationFraction": 3.14, # Optional. The config setting to enable cluster creation/ updation to be successful only after required_registration_fraction of instances are up and running. This configuration is applicable to only secondary workers for now. The cluster will fail if required_registration_fraction of instances are not available. This will include instance creation, agent registration, and service registration (if enabled).
       },
     },
+    "secondaryWorkerFlexibleConfig": { # The configuration for High Obtainability (HO) flexible instance groups. Flexible instance group configs serve as the single source of truth for desired state. # Optional. The High Obtainability (HO) config settings for a cluster's secondary worker instances.In High Obtainability (HO) mode, flexible configs are the single source of truth for desired cluster configuration. num_instances represents the desired capacity of the secondary worker group and is mutable via cluster updates and autoscaling.Only one of secondary_worker_config or secondary_worker_flexible_config can be set.In High Obtainability (HO) mode, secondary workers are optional. If secondary workers are used in an HO cluster, they must be configured using secondary_worker_flexible_config (not secondary_worker_config).
+      "bootDiskSizeGb": 42, # Optional. The boot disk size in GB. This is a create-time specification and is not currently mutable via update masks.
+      "coreCount": 42, # Optional. The number of vCPUs per instance. Must be a power of 2 (2, 4, 8, 16, 32). This is a create-time specification and is not currently mutable via update masks.
+      "hardwareClass": "A String", # Optional. The hardware class of the instances. This is a create-time specification and is not currently mutable via update masks.
+      "numInstances": 42, # Optional. The number of VM instances requested.For master instances, this must be 1. For worker and secondary worker instances, this represents the desired capacity of the group and is mutable via cluster update operations and autoscaling.
+    },
     "securityConfig": { # Security related configuration, including encryption, Kerberos, etc. # Optional. Security settings for the cluster.
       "identityConfig": { # Identity related configuration, including service account based secure multi-tenancy user mappings. # Optional. Identity related configuration, including service account based secure multi-tenancy user mappings.
         "enableSsh": True or False, # Optional. Whether to enable SSH access for the cluster. The default is true for image versions prior to 3.1 and false for image versions 3.1 and later. The default behavior can be changed when creating clusters using image versions 2.3.30 and later.
@@ -2891,6 +2957,12 @@ 
Method Details

         "requiredRegistrationFraction": 3.14, # Optional. The config setting to enable cluster creation/ updation to be successful only after required_registration_fraction of instances are up and running. This configuration is applicable to only secondary workers for now. The cluster will fail if required_registration_fraction of instances are not available. This will include instance creation, agent registration, and service registration (if enabled).
       },
     },
+    "workerFlexibleConfig": { # The configuration for High Obtainability (HO) flexible instance groups. Flexible instance group configs serve as the single source of truth for desired state. # Optional. The High Obtainability (HO) config settings for the cluster's worker instances.In High Obtainability (HO) mode, flexible configs are the single source of truth for desired cluster configuration. num_instances represents the desired capacity of the worker group and is mutable via cluster updates and autoscaling.Only one of worker_config or worker_flexible_config can be set.In High Obtainability (HO) mode, for multi-node (standard) clusters, both master_flexible_config and worker_flexible_config must be specified. Mixing standard and flexible configs across node groups is not allowed. Single-node clusters do not specify worker configs.
+      "bootDiskSizeGb": 42, # Optional. The boot disk size in GB. This is a create-time specification and is not currently mutable via update masks.
+      "coreCount": 42, # Optional. The number of vCPUs per instance. Must be a power of 2 (2, 4, 8, 16, 32). This is a create-time specification and is not currently mutable via update masks.
+      "hardwareClass": "A String", # Optional. The hardware class of the instances. This is a create-time specification and is not currently mutable via update masks.
+      "numInstances": 42, # Optional. The number of VM instances requested.For master instances, this must be 1. For worker and secondary worker instances, this represents the desired capacity of the group and is mutable via cluster update operations and autoscaling.
+    },
   },
   "labels": { # Optional. The labels to associate with this cluster. Label keys must contain 1 to 63 characters, and must conform to RFC 1035 (https://www.ietf.org/rfc/rfc1035.txt). Label values may be empty, but, if present, must contain 1 to 63 characters, and must conform to RFC 1035 (https://www.ietf.org/rfc/rfc1035.txt). No more than 32 labels can be associated with a cluster.
     "a_key": "A String",
diff --git a/docs/dyn/dataproc_v1.projects.regions.workflowTemplates.html b/docs/dyn/dataproc_v1.projects.regions.workflowTemplates.html
index f5e2a2d21c..2cfe1cac09 100644
--- a/docs/dyn/dataproc_v1.projects.regions.workflowTemplates.html
+++ b/docs/dyn/dataproc_v1.projects.regions.workflowTemplates.html
@@ -724,6 +724,12 @@ 
Method Details

             "requiredRegistrationFraction": 3.14, # Optional. The config setting to enable cluster creation/ updation to be successful only after required_registration_fraction of instances are up and running. This configuration is applicable to only secondary workers for now. The cluster will fail if required_registration_fraction of instances are not available. This will include instance creation, agent registration, and service registration (if enabled).
           },
         },
+        "masterFlexibleConfig": { # The configuration for High Obtainability (HO) flexible instance groups. Flexible instance group configs serve as the single source of truth for desired state. # Optional. The High Obtainability (HO) config settings for the cluster's master instances.In High Obtainability (HO) mode, flexible configs are the single source of truth for desired cluster configuration across node groups: * For single-node clusters: master_flexible_config must be specified, and no worker configs should be set. * For multi-node (standard) clusters: both master_flexible_config and worker_flexible_config must be specified. Mixing standard and flexible configs across node groups is not allowed.Only one of master_config or master_flexible_config can be set.
+          "bootDiskSizeGb": 42, # Optional. The boot disk size in GB. This is a create-time specification and is not currently mutable via update masks.
+          "coreCount": 42, # Optional. The number of vCPUs per instance. Must be a power of 2 (2, 4, 8, 16, 32). This is a create-time specification and is not currently mutable via update masks.
+          "hardwareClass": "A String", # Optional. The hardware class of the instances. This is a create-time specification and is not currently mutable via update masks.
+          "numInstances": 42, # Optional. The number of VM instances requested.For master instances, this must be 1. For worker and secondary worker instances, this represents the desired capacity of the group and is mutable via cluster update operations and autoscaling.
+        },
         "metastoreConfig": { # Specifies a Metastore configuration. # Optional. Metastore configuration.
           "dataprocMetastoreService": "A String", # Required. Resource name of an existing Metastore service.Example: projects/[project_id]/locations/[dataproc_region]/services/[service-name]
         },
@@ -818,6 +824,12 @@ 
Method Details

             "requiredRegistrationFraction": 3.14, # Optional. The config setting to enable cluster creation/ updation to be successful only after required_registration_fraction of instances are up and running. This configuration is applicable to only secondary workers for now. The cluster will fail if required_registration_fraction of instances are not available. This will include instance creation, agent registration, and service registration (if enabled).
           },
         },
+        "secondaryWorkerFlexibleConfig": { # The configuration for High Obtainability (HO) flexible instance groups. Flexible instance group configs serve as the single source of truth for desired state. # Optional. The High Obtainability (HO) config settings for a cluster's secondary worker instances.In High Obtainability (HO) mode, flexible configs are the single source of truth for desired cluster configuration. num_instances represents the desired capacity of the secondary worker group and is mutable via cluster updates and autoscaling.Only one of secondary_worker_config or secondary_worker_flexible_config can be set.In High Obtainability (HO) mode, secondary workers are optional. If secondary workers are used in an HO cluster, they must be configured using secondary_worker_flexible_config (not secondary_worker_config).
+          "bootDiskSizeGb": 42, # Optional. The boot disk size in GB. This is a create-time specification and is not currently mutable via update masks.
+          "coreCount": 42, # Optional. The number of vCPUs per instance. Must be a power of 2 (2, 4, 8, 16, 32). This is a create-time specification and is not currently mutable via update masks.
+          "hardwareClass": "A String", # Optional. The hardware class of the instances. This is a create-time specification and is not currently mutable via update masks.
+          "numInstances": 42, # Optional. The number of VM instances requested.For master instances, this must be 1. For worker and secondary worker instances, this represents the desired capacity of the group and is mutable via cluster update operations and autoscaling.
+        },
         "securityConfig": { # Security related configuration, including encryption, Kerberos, etc. # Optional. Security settings for the cluster.
           "identityConfig": { # Identity related configuration, including service account based secure multi-tenancy user mappings. # Optional. Identity related configuration, including service account based secure multi-tenancy user mappings.
             "enableSsh": True or False, # Optional. Whether to enable SSH access for the cluster. The default is true for image versions prior to 3.1 and false for image versions 3.1 and later. The default behavior can be changed when creating clusters using image versions 2.3.30 and later.
@@ -944,6 +956,12 @@ 
Method Details

             "requiredRegistrationFraction": 3.14, # Optional. The config setting to enable cluster creation/ updation to be successful only after required_registration_fraction of instances are up and running. This configuration is applicable to only secondary workers for now. The cluster will fail if required_registration_fraction of instances are not available. This will include instance creation, agent registration, and service registration (if enabled).
           },
         },
+        "workerFlexibleConfig": { # The configuration for High Obtainability (HO) flexible instance groups. Flexible instance group configs serve as the single source of truth for desired state. # Optional. The High Obtainability (HO) config settings for the cluster's worker instances.In High Obtainability (HO) mode, flexible configs are the single source of truth for desired cluster configuration. num_instances represents the desired capacity of the worker group and is mutable via cluster updates and autoscaling.Only one of worker_config or worker_flexible_config can be set.In High Obtainability (HO) mode, for multi-node (standard) clusters, both master_flexible_config and worker_flexible_config must be specified. Mixing standard and flexible configs across node groups is not allowed. Single-node clusters do not specify worker configs.
+          "bootDiskSizeGb": 42, # Optional. The boot disk size in GB. This is a create-time specification and is not currently mutable via update masks.
+          "coreCount": 42, # Optional. The number of vCPUs per instance. Must be a power of 2 (2, 4, 8, 16, 32). This is a create-time specification and is not currently mutable via update masks.
+          "hardwareClass": "A String", # Optional. The hardware class of the instances. This is a create-time specification and is not currently mutable via update masks.
+          "numInstances": 42, # Optional. The number of VM instances requested.For master instances, this must be 1. For worker and secondary worker instances, this represents the desired capacity of the group and is mutable via cluster update operations and autoscaling.
+        },
       },
       "labels": { # Optional. The labels to associate with this cluster.Label keys must be between 1 and 63 characters long, and must conform to the following PCRE regular expression: \p{Ll}\p{Lo}{0,62}Label values must be between 1 and 63 characters long, and must conform to the following PCRE regular expression: \p{Ll}\p{Lo}\p{N}_-{0,63}No more than 32 labels can be associated with a given cluster.
         "a_key": "A String",
@@ -1561,6 +1579,12 @@ 
Method Details

             "requiredRegistrationFraction": 3.14, # Optional. The config setting to enable cluster creation/ updation to be successful only after required_registration_fraction of instances are up and running. This configuration is applicable to only secondary workers for now. The cluster will fail if required_registration_fraction of instances are not available. This will include instance creation, agent registration, and service registration (if enabled).
           },
         },
+        "masterFlexibleConfig": { # The configuration for High Obtainability (HO) flexible instance groups. Flexible instance group configs serve as the single source of truth for desired state. # Optional. The High Obtainability (HO) config settings for the cluster's master instances.In High Obtainability (HO) mode, flexible configs are the single source of truth for desired cluster configuration across node groups: * For single-node clusters: master_flexible_config must be specified, and no worker configs should be set. * For multi-node (standard) clusters: both master_flexible_config and worker_flexible_config must be specified. Mixing standard and flexible configs across node groups is not allowed.Only one of master_config or master_flexible_config can be set.
+          "bootDiskSizeGb": 42, # Optional. The boot disk size in GB. This is a create-time specification and is not currently mutable via update masks.
+          "coreCount": 42, # Optional. The number of vCPUs per instance. Must be a power of 2 (2, 4, 8, 16, 32). This is a create-time specification and is not currently mutable via update masks.
+          "hardwareClass": "A String", # Optional. The hardware class of the instances. This is a create-time specification and is not currently mutable via update masks.
+          "numInstances": 42, # Optional. The number of VM instances requested.For master instances, this must be 1. For worker and secondary worker instances, this represents the desired capacity of the group and is mutable via cluster update operations and autoscaling.
+        },
         "metastoreConfig": { # Specifies a Metastore configuration. # Optional. Metastore configuration.
           "dataprocMetastoreService": "A String", # Required. Resource name of an existing Metastore service.Example: projects/[project_id]/locations/[dataproc_region]/services/[service-name]
         },
@@ -1655,6 +1679,12 @@ 
Method Details

             "requiredRegistrationFraction": 3.14, # Optional. The config setting to enable cluster creation/ updation to be successful only after required_registration_fraction of instances are up and running. This configuration is applicable to only secondary workers for now. The cluster will fail if required_registration_fraction of instances are not available. This will include instance creation, agent registration, and service registration (if enabled).
           },
         },
+        "secondaryWorkerFlexibleConfig": { # The configuration for High Obtainability (HO) flexible instance groups. Flexible instance group configs serve as the single source of truth for desired state. # Optional. The High Obtainability (HO) config settings for a cluster's secondary worker instances.In High Obtainability (HO) mode, flexible configs are the single source of truth for desired cluster configuration. num_instances represents the desired capacity of the secondary worker group and is mutable via cluster updates and autoscaling.Only one of secondary_worker_config or secondary_worker_flexible_config can be set.In High Obtainability (HO) mode, secondary workers are optional. If secondary workers are used in an HO cluster, they must be configured using secondary_worker_flexible_config (not secondary_worker_config).
+          "bootDiskSizeGb": 42, # Optional. The boot disk size in GB. This is a create-time specification and is not currently mutable via update masks.
+          "coreCount": 42, # Optional. The number of vCPUs per instance. Must be a power of 2 (2, 4, 8, 16, 32). This is a create-time specification and is not currently mutable via update masks.
+          "hardwareClass": "A String", # Optional. The hardware class of the instances. This is a create-time specification and is not currently mutable via update masks.
+          "numInstances": 42, # Optional. The number of VM instances requested.For master instances, this must be 1. For worker and secondary worker instances, this represents the desired capacity of the group and is mutable via cluster update operations and autoscaling.
+        },
         "securityConfig": { # Security related configuration, including encryption, Kerberos, etc. # Optional. Security settings for the cluster.
           "identityConfig": { # Identity related configuration, including service account based secure multi-tenancy user mappings. # Optional. Identity related configuration, including service account based secure multi-tenancy user mappings.
             "enableSsh": True or False, # Optional. Whether to enable SSH access for the cluster. The default is true for image versions prior to 3.1 and false for image versions 3.1 and later. The default behavior can be changed when creating clusters using image versions 2.3.30 and later.
@@ -1781,6 +1811,12 @@ 
Method Details

             "requiredRegistrationFraction": 3.14, # Optional. The config setting to enable cluster creation/ updation to be successful only after required_registration_fraction of instances are up and running. This configuration is applicable to only secondary workers for now. The cluster will fail if required_registration_fraction of instances are not available. This will include instance creation, agent registration, and service registration (if enabled).
           },
         },
+        "workerFlexibleConfig": { # The configuration for High Obtainability (HO) flexible instance groups. Flexible instance group configs serve as the single source of truth for desired state. # Optional. The High Obtainability (HO) config settings for the cluster's worker instances.In High Obtainability (HO) mode, flexible configs are the single source of truth for desired cluster configuration. num_instances represents the desired capacity of the worker group and is mutable via cluster updates and autoscaling.Only one of worker_config or worker_flexible_config can be set.In High Obtainability (HO) mode, for multi-node (standard) clusters, both master_flexible_config and worker_flexible_config must be specified. Mixing standard and flexible configs across node groups is not allowed. Single-node clusters do not specify worker configs.
+          "bootDiskSizeGb": 42, # Optional. The boot disk size in GB. This is a create-time specification and is not currently mutable via update masks.
+          "coreCount": 42, # Optional. The number of vCPUs per instance. Must be a power of 2 (2, 4, 8, 16, 32). This is a create-time specification and is not currently mutable via update masks.
+          "hardwareClass": "A String", # Optional. The hardware class of the instances. This is a create-time specification and is not currently mutable via update masks.
+          "numInstances": 42, # Optional. The number of VM instances requested.For master instances, this must be 1. For worker and secondary worker instances, this represents the desired capacity of the group and is mutable via cluster update operations and autoscaling.
+        },
       },
       "labels": { # Optional. The labels to associate with this cluster.Label keys must be between 1 and 63 characters long, and must conform to the following PCRE regular expression: \p{Ll}\p{Lo}{0,62}Label values must be between 1 and 63 characters long, and must conform to the following PCRE regular expression: \p{Ll}\p{Lo}\p{N}_-{0,63}No more than 32 labels can be associated with a given cluster.
         "a_key": "A String",
@@ -2425,6 +2461,12 @@ 
Method Details

             "requiredRegistrationFraction": 3.14, # Optional. The config setting to enable cluster creation/ updation to be successful only after required_registration_fraction of instances are up and running. This configuration is applicable to only secondary workers for now. The cluster will fail if required_registration_fraction of instances are not available. This will include instance creation, agent registration, and service registration (if enabled).
           },
         },
+        "masterFlexibleConfig": { # The configuration for High Obtainability (HO) flexible instance groups. Flexible instance group configs serve as the single source of truth for desired state. # Optional. The High Obtainability (HO) config settings for the cluster's master instances.In High Obtainability (HO) mode, flexible configs are the single source of truth for desired cluster configuration across node groups: * For single-node clusters: master_flexible_config must be specified, and no worker configs should be set. * For multi-node (standard) clusters: both master_flexible_config and worker_flexible_config must be specified. Mixing standard and flexible configs across node groups is not allowed.Only one of master_config or master_flexible_config can be set.
+          "bootDiskSizeGb": 42, # Optional. The boot disk size in GB. This is a create-time specification and is not currently mutable via update masks.
+          "coreCount": 42, # Optional. The number of vCPUs per instance. Must be a power of 2 (2, 4, 8, 16, 32). This is a create-time specification and is not currently mutable via update masks.
+          "hardwareClass": "A String", # Optional. The hardware class of the instances. This is a create-time specification and is not currently mutable via update masks.
+          "numInstances": 42, # Optional. The number of VM instances requested.For master instances, this must be 1. For worker and secondary worker instances, this represents the desired capacity of the group and is mutable via cluster update operations and autoscaling.
+        },
         "metastoreConfig": { # Specifies a Metastore configuration. # Optional. Metastore configuration.
           "dataprocMetastoreService": "A String", # Required. Resource name of an existing Metastore service.Example: projects/[project_id]/locations/[dataproc_region]/services/[service-name]
         },
@@ -2519,6 +2561,12 @@ 
Method Details

             "requiredRegistrationFraction": 3.14, # Optional. The config setting to enable cluster creation/ updation to be successful only after required_registration_fraction of instances are up and running. This configuration is applicable to only secondary workers for now. The cluster will fail if required_registration_fraction of instances are not available. This will include instance creation, agent registration, and service registration (if enabled).
           },
         },
+        "secondaryWorkerFlexibleConfig": { # The configuration for High Obtainability (HO) flexible instance groups. Flexible instance group configs serve as the single source of truth for desired state. # Optional. The High Obtainability (HO) config settings for a cluster's secondary worker instances.In High Obtainability (HO) mode, flexible configs are the single source of truth for desired cluster configuration. num_instances represents the desired capacity of the secondary worker group and is mutable via cluster updates and autoscaling.Only one of secondary_worker_config or secondary_worker_flexible_config can be set.In High Obtainability (HO) mode, secondary workers are optional. If secondary workers are used in an HO cluster, they must be configured using secondary_worker_flexible_config (not secondary_worker_config).
+          "bootDiskSizeGb": 42, # Optional. The boot disk size in GB. This is a create-time specification and is not currently mutable via update masks.
+          "coreCount": 42, # Optional. The number of vCPUs per instance. Must be a power of 2 (2, 4, 8, 16, 32). This is a create-time specification and is not currently mutable via update masks.
+          "hardwareClass": "A String", # Optional. The hardware class of the instances. This is a create-time specification and is not currently mutable via update masks.
+          "numInstances": 42, # Optional. The number of VM instances requested.For master instances, this must be 1. For worker and secondary worker instances, this represents the desired capacity of the group and is mutable via cluster update operations and autoscaling.
+        },
         "securityConfig": { # Security related configuration, including encryption, Kerberos, etc. # Optional. Security settings for the cluster.
           "identityConfig": { # Identity related configuration, including service account based secure multi-tenancy user mappings. # Optional. Identity related configuration, including service account based secure multi-tenancy user mappings.
             "enableSsh": True or False, # Optional. Whether to enable SSH access for the cluster. The default is true for image versions prior to 3.1 and false for image versions 3.1 and later. The default behavior can be changed when creating clusters using image versions 2.3.30 and later.
@@ -2645,6 +2693,12 @@ 
Method Details

             "requiredRegistrationFraction": 3.14, # Optional. The config setting to enable cluster creation/ updation to be successful only after required_registration_fraction of instances are up and running. This configuration is applicable to only secondary workers for now. The cluster will fail if required_registration_fraction of instances are not available. This will include instance creation, agent registration, and service registration (if enabled).
           },
         },
+        "workerFlexibleConfig": { # The configuration for High Obtainability (HO) flexible instance groups. Flexible instance group configs serve as the single source of truth for desired state. # Optional. The High Obtainability (HO) config settings for the cluster's worker instances.In High Obtainability (HO) mode, flexible configs are the single source of truth for desired cluster configuration. num_instances represents the desired capacity of the worker group and is mutable via cluster updates and autoscaling.Only one of worker_config or worker_flexible_config can be set.In High Obtainability (HO) mode, for multi-node (standard) clusters, both master_flexible_config and worker_flexible_config must be specified. Mixing standard and flexible configs across node groups is not allowed. Single-node clusters do not specify worker configs.
+          "bootDiskSizeGb": 42, # Optional. The boot disk size in GB. This is a create-time specification and is not currently mutable via update masks.
+          "coreCount": 42, # Optional. The number of vCPUs per instance. Must be a power of 2 (2, 4, 8, 16, 32). This is a create-time specification and is not currently mutable via update masks.
+          "hardwareClass": "A String", # Optional. The hardware class of the instances. This is a create-time specification and is not currently mutable via update masks.
+          "numInstances": 42, # Optional. The number of VM instances requested.For master instances, this must be 1. For worker and secondary worker instances, this represents the desired capacity of the group and is mutable via cluster update operations and autoscaling.
+        },
       },
       "labels": { # Optional. The labels to associate with this cluster.Label keys must be between 1 and 63 characters long, and must conform to the following PCRE regular expression: \p{Ll}\p{Lo}{0,62}Label values must be between 1 and 63 characters long, and must conform to the following PCRE regular expression: \p{Ll}\p{Lo}\p{N}_-{0,63}No more than 32 labels can be associated with a given cluster.
         "a_key": "A String",
@@ -3353,6 +3407,12 @@ 
Method Details

             "requiredRegistrationFraction": 3.14, # Optional. The config setting to enable cluster creation/ updation to be successful only after required_registration_fraction of instances are up and running. This configuration is applicable to only secondary workers for now. The cluster will fail if required_registration_fraction of instances are not available. This will include instance creation, agent registration, and service registration (if enabled).
           },
         },
+        "masterFlexibleConfig": { # The configuration for High Obtainability (HO) flexible instance groups. Flexible instance group configs serve as the single source of truth for desired state. # Optional. The High Obtainability (HO) config settings for the cluster's master instances.In High Obtainability (HO) mode, flexible configs are the single source of truth for desired cluster configuration across node groups: * For single-node clusters: master_flexible_config must be specified, and no worker configs should be set. * For multi-node (standard) clusters: both master_flexible_config and worker_flexible_config must be specified. Mixing standard and flexible configs across node groups is not allowed.Only one of master_config or master_flexible_config can be set.
+          "bootDiskSizeGb": 42, # Optional. The boot disk size in GB. This is a create-time specification and is not currently mutable via update masks.
+          "coreCount": 42, # Optional. The number of vCPUs per instance. Must be a power of 2 (2, 4, 8, 16, 32). This is a create-time specification and is not currently mutable via update masks.
+          "hardwareClass": "A String", # Optional. The hardware class of the instances. This is a create-time specification and is not currently mutable via update masks.
+          "numInstances": 42, # Optional. The number of VM instances requested.For master instances, this must be 1. For worker and secondary worker instances, this represents the desired capacity of the group and is mutable via cluster update operations and autoscaling.
+        },
         "metastoreConfig": { # Specifies a Metastore configuration. # Optional. Metastore configuration.
           "dataprocMetastoreService": "A String", # Required. Resource name of an existing Metastore service.Example: projects/[project_id]/locations/[dataproc_region]/services/[service-name]
         },
@@ -3447,6 +3507,12 @@ 
Method Details

             "requiredRegistrationFraction": 3.14, # Optional. The config setting to enable cluster creation/ updation to be successful only after required_registration_fraction of instances are up and running. This configuration is applicable to only secondary workers for now. The cluster will fail if required_registration_fraction of instances are not available. This will include instance creation, agent registration, and service registration (if enabled).
           },
         },
+        "secondaryWorkerFlexibleConfig": { # The configuration for High Obtainability (HO) flexible instance groups. Flexible instance group configs serve as the single source of truth for desired state. # Optional. The High Obtainability (HO) config settings for a cluster's secondary worker instances.In High Obtainability (HO) mode, flexible configs are the single source of truth for desired cluster configuration. num_instances represents the desired capacity of the secondary worker group and is mutable via cluster updates and autoscaling.Only one of secondary_worker_config or secondary_worker_flexible_config can be set.In High Obtainability (HO) mode, secondary workers are optional. If secondary workers are used in an HO cluster, they must be configured using secondary_worker_flexible_config (not secondary_worker_config).
+          "bootDiskSizeGb": 42, # Optional. The boot disk size in GB. This is a create-time specification and is not currently mutable via update masks.
+          "coreCount": 42, # Optional. The number of vCPUs per instance. Must be a power of 2 (2, 4, 8, 16, 32). This is a create-time specification and is not currently mutable via update masks.
+          "hardwareClass": "A String", # Optional. The hardware class of the instances. This is a create-time specification and is not currently mutable via update masks.
+          "numInstances": 42, # Optional. The number of VM instances requested.For master instances, this must be 1. For worker and secondary worker instances, this represents the desired capacity of the group and is mutable via cluster update operations and autoscaling.
+        },
         "securityConfig": { # Security related configuration, including encryption, Kerberos, etc. # Optional. Security settings for the cluster.
           "identityConfig": { # Identity related configuration, including service account based secure multi-tenancy user mappings. # Optional. Identity related configuration, including service account based secure multi-tenancy user mappings.
             "enableSsh": True or False, # Optional. Whether to enable SSH access for the cluster. The default is true for image versions prior to 3.1 and false for image versions 3.1 and later. The default behavior can be changed when creating clusters using image versions 2.3.30 and later.
@@ -3573,6 +3639,12 @@ 
Method Details

             "requiredRegistrationFraction": 3.14, # Optional. The config setting to enable cluster creation/ updation to be successful only after required_registration_fraction of instances are up and running. This configuration is applicable to only secondary workers for now. The cluster will fail if required_registration_fraction of instances are not available. This will include instance creation, agent registration, and service registration (if enabled).
           },
         },
+        "workerFlexibleConfig": { # The configuration for High Obtainability (HO) flexible instance groups. Flexible instance group configs serve as the single source of truth for desired state. # Optional. The High Obtainability (HO) config settings for the cluster's worker instances.In High Obtainability (HO) mode, flexible configs are the single source of truth for desired cluster configuration. num_instances represents the desired capacity of the worker group and is mutable via cluster updates and autoscaling.Only one of worker_config or worker_flexible_config can be set.In High Obtainability (HO) mode, for multi-node (standard) clusters, both master_flexible_config and worker_flexible_config must be specified. Mixing standard and flexible configs across node groups is not allowed. Single-node clusters do not specify worker configs.
+          "bootDiskSizeGb": 42, # Optional. The boot disk size in GB. This is a create-time specification and is not currently mutable via update masks.
+          "coreCount": 42, # Optional. The number of vCPUs per instance. Must be a power of 2 (2, 4, 8, 16, 32). This is a create-time specification and is not currently mutable via update masks.
+          "hardwareClass": "A String", # Optional. The hardware class of the instances. This is a create-time specification and is not currently mutable via update masks.
+          "numInstances": 42, # Optional. The number of VM instances requested.For master instances, this must be 1. For worker and secondary worker instances, this represents the desired capacity of the group and is mutable via cluster update operations and autoscaling.
+        },
       },
       "labels": { # Optional. The labels to associate with this cluster.Label keys must be between 1 and 63 characters long, and must conform to the following PCRE regular expression: \p{Ll}\p{Lo}{0,62}Label values must be between 1 and 63 characters long, and must conform to the following PCRE regular expression: \p{Ll}\p{Lo}\p{N}_-{0,63}No more than 32 labels can be associated with a given cluster.
         "a_key": "A String",
@@ -4231,6 +4303,12 @@ 
Method Details

                 "requiredRegistrationFraction": 3.14, # Optional. The config setting to enable cluster creation/ updation to be successful only after required_registration_fraction of instances are up and running. This configuration is applicable to only secondary workers for now. The cluster will fail if required_registration_fraction of instances are not available. This will include instance creation, agent registration, and service registration (if enabled).
               },
             },
+            "masterFlexibleConfig": { # The configuration for High Obtainability (HO) flexible instance groups. Flexible instance group configs serve as the single source of truth for desired state. # Optional. The High Obtainability (HO) config settings for the cluster's master instances.In High Obtainability (HO) mode, flexible configs are the single source of truth for desired cluster configuration across node groups: * For single-node clusters: master_flexible_config must be specified, and no worker configs should be set. * For multi-node (standard) clusters: both master_flexible_config and worker_flexible_config must be specified. Mixing standard and flexible configs across node groups is not allowed.Only one of master_config or master_flexible_config can be set.
+              "bootDiskSizeGb": 42, # Optional. The boot disk size in GB. This is a create-time specification and is not currently mutable via update masks.
+              "coreCount": 42, # Optional. The number of vCPUs per instance. Must be a power of 2 (2, 4, 8, 16, 32). This is a create-time specification and is not currently mutable via update masks.
+              "hardwareClass": "A String", # Optional. The hardware class of the instances. This is a create-time specification and is not currently mutable via update masks.
+              "numInstances": 42, # Optional. The number of VM instances requested.For master instances, this must be 1. For worker and secondary worker instances, this represents the desired capacity of the group and is mutable via cluster update operations and autoscaling.
+            },
             "metastoreConfig": { # Specifies a Metastore configuration. # Optional. Metastore configuration.
               "dataprocMetastoreService": "A String", # Required. Resource name of an existing Metastore service.Example: projects/[project_id]/locations/[dataproc_region]/services/[service-name]
             },
@@ -4325,6 +4403,12 @@ 
Method Details

                 "requiredRegistrationFraction": 3.14, # Optional. The config setting to enable cluster creation/ updation to be successful only after required_registration_fraction of instances are up and running. This configuration is applicable to only secondary workers for now. The cluster will fail if required_registration_fraction of instances are not available. This will include instance creation, agent registration, and service registration (if enabled).
               },
             },
+            "secondaryWorkerFlexibleConfig": { # The configuration for High Obtainability (HO) flexible instance groups. Flexible instance group configs serve as the single source of truth for desired state. # Optional. The High Obtainability (HO) config settings for a cluster's secondary worker instances.In High Obtainability (HO) mode, flexible configs are the single source of truth for desired cluster configuration. num_instances represents the desired capacity of the secondary worker group and is mutable via cluster updates and autoscaling.Only one of secondary_worker_config or secondary_worker_flexible_config can be set.In High Obtainability (HO) mode, secondary workers are optional. If secondary workers are used in an HO cluster, they must be configured using secondary_worker_flexible_config (not secondary_worker_config).
+              "bootDiskSizeGb": 42, # Optional. The boot disk size in GB. This is a create-time specification and is not currently mutable via update masks.
+              "coreCount": 42, # Optional. The number of vCPUs per instance. Must be a power of 2 (2, 4, 8, 16, 32). This is a create-time specification and is not currently mutable via update masks.
+              "hardwareClass": "A String", # Optional. The hardware class of the instances. This is a create-time specification and is not currently mutable via update masks.
+              "numInstances": 42, # Optional. The number of VM instances requested.For master instances, this must be 1. For worker and secondary worker instances, this represents the desired capacity of the group and is mutable via cluster update operations and autoscaling.
+            },
             "securityConfig": { # Security related configuration, including encryption, Kerberos, etc. # Optional. Security settings for the cluster.
               "identityConfig": { # Identity related configuration, including service account based secure multi-tenancy user mappings. # Optional. Identity related configuration, including service account based secure multi-tenancy user mappings.
                 "enableSsh": True or False, # Optional. Whether to enable SSH access for the cluster. The default is true for image versions prior to 3.1 and false for image versions 3.1 and later. The default behavior can be changed when creating clusters using image versions 2.3.30 and later.
@@ -4451,6 +4535,12 @@ 
Method Details

                 "requiredRegistrationFraction": 3.14, # Optional. The config setting to enable cluster creation/ updation to be successful only after required_registration_fraction of instances are up and running. This configuration is applicable to only secondary workers for now. The cluster will fail if required_registration_fraction of instances are not available. This will include instance creation, agent registration, and service registration (if enabled).
               },
             },
+            "workerFlexibleConfig": { # The configuration for High Obtainability (HO) flexible instance groups. Flexible instance group configs serve as the single source of truth for desired state. # Optional. The High Obtainability (HO) config settings for the cluster's worker instances.In High Obtainability (HO) mode, flexible configs are the single source of truth for desired cluster configuration. num_instances represents the desired capacity of the worker group and is mutable via cluster updates and autoscaling.Only one of worker_config or worker_flexible_config can be set.In High Obtainability (HO) mode, for multi-node (standard) clusters, both master_flexible_config and worker_flexible_config must be specified. Mixing standard and flexible configs across node groups is not allowed. Single-node clusters do not specify worker configs.
+              "bootDiskSizeGb": 42, # Optional. The boot disk size in GB. This is a create-time specification and is not currently mutable via update masks.
+              "coreCount": 42, # Optional. The number of vCPUs per instance. Must be a power of 2 (2, 4, 8, 16, 32). This is a create-time specification and is not currently mutable via update masks.
+              "hardwareClass": "A String", # Optional. The hardware class of the instances. This is a create-time specification and is not currently mutable via update masks.
+              "numInstances": 42, # Optional. The number of VM instances requested.For master instances, this must be 1. For worker and secondary worker instances, this represents the desired capacity of the group and is mutable via cluster update operations and autoscaling.
+            },
           },
           "labels": { # Optional. The labels to associate with this cluster.Label keys must be between 1 and 63 characters long, and must conform to the following PCRE regular expression: \p{Ll}\p{Lo}{0,62}Label values must be between 1 and 63 characters long, and must conform to the following PCRE regular expression: \p{Ll}\p{Lo}\p{N}_-{0,63}No more than 32 labels can be associated with a given cluster.
             "a_key": "A String",
@@ -5177,6 +5267,12 @@ 
Method Details

             "requiredRegistrationFraction": 3.14, # Optional. The config setting to enable cluster creation/ updation to be successful only after required_registration_fraction of instances are up and running. This configuration is applicable to only secondary workers for now. The cluster will fail if required_registration_fraction of instances are not available. This will include instance creation, agent registration, and service registration (if enabled).
           },
         },
+        "masterFlexibleConfig": { # The configuration for High Obtainability (HO) flexible instance groups. Flexible instance group configs serve as the single source of truth for desired state. # Optional. The High Obtainability (HO) config settings for the cluster's master instances.In High Obtainability (HO) mode, flexible configs are the single source of truth for desired cluster configuration across node groups: * For single-node clusters: master_flexible_config must be specified, and no worker configs should be set. * For multi-node (standard) clusters: both master_flexible_config and worker_flexible_config must be specified. Mixing standard and flexible configs across node groups is not allowed.Only one of master_config or master_flexible_config can be set.
+          "bootDiskSizeGb": 42, # Optional. The boot disk size in GB. This is a create-time specification and is not currently mutable via update masks.
+          "coreCount": 42, # Optional. The number of vCPUs per instance. Must be a power of 2 (2, 4, 8, 16, 32). This is a create-time specification and is not currently mutable via update masks.
+          "hardwareClass": "A String", # Optional. The hardware class of the instances. This is a create-time specification and is not currently mutable via update masks.
+          "numInstances": 42, # Optional. The number of VM instances requested.For master instances, this must be 1. For worker and secondary worker instances, this represents the desired capacity of the group and is mutable via cluster update operations and autoscaling.
+        },
         "metastoreConfig": { # Specifies a Metastore configuration. # Optional. Metastore configuration.
           "dataprocMetastoreService": "A String", # Required. Resource name of an existing Metastore service.Example: projects/[project_id]/locations/[dataproc_region]/services/[service-name]
         },
@@ -5271,6 +5367,12 @@ 
Method Details

             "requiredRegistrationFraction": 3.14, # Optional. The config setting to enable cluster creation/ updation to be successful only after required_registration_fraction of instances are up and running. This configuration is applicable to only secondary workers for now. The cluster will fail if required_registration_fraction of instances are not available. This will include instance creation, agent registration, and service registration (if enabled).
           },
         },
+        "secondaryWorkerFlexibleConfig": { # The configuration for High Obtainability (HO) flexible instance groups. Flexible instance group configs serve as the single source of truth for desired state. # Optional. The High Obtainability (HO) config settings for a cluster's secondary worker instances.In High Obtainability (HO) mode, flexible configs are the single source of truth for desired cluster configuration. num_instances represents the desired capacity of the secondary worker group and is mutable via cluster updates and autoscaling.Only one of secondary_worker_config or secondary_worker_flexible_config can be set.In High Obtainability (HO) mode, secondary workers are optional. If secondary workers are used in an HO cluster, they must be configured using secondary_worker_flexible_config (not secondary_worker_config).
+          "bootDiskSizeGb": 42, # Optional. The boot disk size in GB. This is a create-time specification and is not currently mutable via update masks.
+          "coreCount": 42, # Optional. The number of vCPUs per instance. Must be a power of 2 (2, 4, 8, 16, 32). This is a create-time specification and is not currently mutable via update masks.
+          "hardwareClass": "A String", # Optional. The hardware class of the instances. This is a create-time specification and is not currently mutable via update masks.
+          "numInstances": 42, # Optional. The number of VM instances requested.For master instances, this must be 1. For worker and secondary worker instances, this represents the desired capacity of the group and is mutable via cluster update operations and autoscaling.
+        },
         "securityConfig": { # Security related configuration, including encryption, Kerberos, etc. # Optional. Security settings for the cluster.
           "identityConfig": { # Identity related configuration, including service account based secure multi-tenancy user mappings. # Optional. Identity related configuration, including service account based secure multi-tenancy user mappings.
             "enableSsh": True or False, # Optional. Whether to enable SSH access for the cluster. The default is true for image versions prior to 3.1 and false for image versions 3.1 and later. The default behavior can be changed when creating clusters using image versions 2.3.30 and later.
@@ -5397,6 +5499,12 @@ 
Method Details

             "requiredRegistrationFraction": 3.14, # Optional. The config setting to enable cluster creation/ updation to be successful only after required_registration_fraction of instances are up and running. This configuration is applicable to only secondary workers for now. The cluster will fail if required_registration_fraction of instances are not available. This will include instance creation, agent registration, and service registration (if enabled).
           },
         },
+        "workerFlexibleConfig": { # The configuration for High Obtainability (HO) flexible instance groups. Flexible instance group configs serve as the single source of truth for desired state. # Optional. The High Obtainability (HO) config settings for the cluster's worker instances.In High Obtainability (HO) mode, flexible configs are the single source of truth for desired cluster configuration. num_instances represents the desired capacity of the worker group and is mutable via cluster updates and autoscaling.Only one of worker_config or worker_flexible_config can be set.In High Obtainability (HO) mode, for multi-node (standard) clusters, both master_flexible_config and worker_flexible_config must be specified. Mixing standard and flexible configs across node groups is not allowed. Single-node clusters do not specify worker configs.
+          "bootDiskSizeGb": 42, # Optional. The boot disk size in GB. This is a create-time specification and is not currently mutable via update masks.
+          "coreCount": 42, # Optional. The number of vCPUs per instance. Must be a power of 2 (2, 4, 8, 16, 32). This is a create-time specification and is not currently mutable via update masks.
+          "hardwareClass": "A String", # Optional. The hardware class of the instances. This is a create-time specification and is not currently mutable via update masks.
+          "numInstances": 42, # Optional. The number of VM instances requested.For master instances, this must be 1. For worker and secondary worker instances, this represents the desired capacity of the group and is mutable via cluster update operations and autoscaling.
+        },
       },
       "labels": { # Optional. The labels to associate with this cluster.Label keys must be between 1 and 63 characters long, and must conform to the following PCRE regular expression: \p{Ll}\p{Lo}{0,62}Label values must be between 1 and 63 characters long, and must conform to the following PCRE regular expression: \p{Ll}\p{Lo}\p{N}_-{0,63}No more than 32 labels can be associated with a given cluster.
         "a_key": "A String",
@@ -6014,6 +6122,12 @@ 
Method Details

             "requiredRegistrationFraction": 3.14, # Optional. The config setting to enable cluster creation/ updation to be successful only after required_registration_fraction of instances are up and running. This configuration is applicable to only secondary workers for now. The cluster will fail if required_registration_fraction of instances are not available. This will include instance creation, agent registration, and service registration (if enabled).
           },
         },
+        "masterFlexibleConfig": { # The configuration for High Obtainability (HO) flexible instance groups. Flexible instance group configs serve as the single source of truth for desired state. # Optional. The High Obtainability (HO) config settings for the cluster's master instances.In High Obtainability (HO) mode, flexible configs are the single source of truth for desired cluster configuration across node groups: * For single-node clusters: master_flexible_config must be specified, and no worker configs should be set. * For multi-node (standard) clusters: both master_flexible_config and worker_flexible_config must be specified. Mixing standard and flexible configs across node groups is not allowed.Only one of master_config or master_flexible_config can be set.
+          "bootDiskSizeGb": 42, # Optional. The boot disk size in GB. This is a create-time specification and is not currently mutable via update masks.
+          "coreCount": 42, # Optional. The number of vCPUs per instance. Must be a power of 2 (2, 4, 8, 16, 32). This is a create-time specification and is not currently mutable via update masks.
+          "hardwareClass": "A String", # Optional. The hardware class of the instances. This is a create-time specification and is not currently mutable via update masks.
+          "numInstances": 42, # Optional. The number of VM instances requested.For master instances, this must be 1. For worker and secondary worker instances, this represents the desired capacity of the group and is mutable via cluster update operations and autoscaling.
+        },
         "metastoreConfig": { # Specifies a Metastore configuration. # Optional. Metastore configuration.
           "dataprocMetastoreService": "A String", # Required. Resource name of an existing Metastore service.Example: projects/[project_id]/locations/[dataproc_region]/services/[service-name]
         },
@@ -6108,6 +6222,12 @@ 
Method Details

             "requiredRegistrationFraction": 3.14, # Optional. The config setting to enable cluster creation/ updation to be successful only after required_registration_fraction of instances are up and running. This configuration is applicable to only secondary workers for now. The cluster will fail if required_registration_fraction of instances are not available. This will include instance creation, agent registration, and service registration (if enabled).
           },
         },
+        "secondaryWorkerFlexibleConfig": { # The configuration for High Obtainability (HO) flexible instance groups. Flexible instance group configs serve as the single source of truth for desired state. # Optional. The High Obtainability (HO) config settings for a cluster's secondary worker instances.In High Obtainability (HO) mode, flexible configs are the single source of truth for desired cluster configuration. num_instances represents the desired capacity of the secondary worker group and is mutable via cluster updates and autoscaling.Only one of secondary_worker_config or secondary_worker_flexible_config can be set.In High Obtainability (HO) mode, secondary workers are optional. If secondary workers are used in an HO cluster, they must be configured using secondary_worker_flexible_config (not secondary_worker_config).
+          "bootDiskSizeGb": 42, # Optional. The boot disk size in GB. This is a create-time specification and is not currently mutable via update masks.
+          "coreCount": 42, # Optional. The number of vCPUs per instance. Must be a power of 2 (2, 4, 8, 16, 32). This is a create-time specification and is not currently mutable via update masks.
+          "hardwareClass": "A String", # Optional. The hardware class of the instances. This is a create-time specification and is not currently mutable via update masks.
+          "numInstances": 42, # Optional. The number of VM instances requested.For master instances, this must be 1. For worker and secondary worker instances, this represents the desired capacity of the group and is mutable via cluster update operations and autoscaling.
+        },
         "securityConfig": { # Security related configuration, including encryption, Kerberos, etc. # Optional. Security settings for the cluster.
           "identityConfig": { # Identity related configuration, including service account based secure multi-tenancy user mappings. # Optional. Identity related configuration, including service account based secure multi-tenancy user mappings.
             "enableSsh": True or False, # Optional. Whether to enable SSH access for the cluster. The default is true for image versions prior to 3.1 and false for image versions 3.1 and later. The default behavior can be changed when creating clusters using image versions 2.3.30 and later.
@@ -6234,6 +6354,12 @@ 
Method Details

             "requiredRegistrationFraction": 3.14, # Optional. The config setting to enable cluster creation/ updation to be successful only after required_registration_fraction of instances are up and running. This configuration is applicable to only secondary workers for now. The cluster will fail if required_registration_fraction of instances are not available. This will include instance creation, agent registration, and service registration (if enabled).
           },
         },
+        "workerFlexibleConfig": { # The configuration for High Obtainability (HO) flexible instance groups. Flexible instance group configs serve as the single source of truth for desired state. # Optional. The High Obtainability (HO) config settings for the cluster's worker instances.In High Obtainability (HO) mode, flexible configs are the single source of truth for desired cluster configuration. num_instances represents the desired capacity of the worker group and is mutable via cluster updates and autoscaling.Only one of worker_config or worker_flexible_config can be set.In High Obtainability (HO) mode, for multi-node (standard) clusters, both master_flexible_config and worker_flexible_config must be specified. Mixing standard and flexible configs across node groups is not allowed. Single-node clusters do not specify worker configs.
+          "bootDiskSizeGb": 42, # Optional. The boot disk size in GB. This is a create-time specification and is not currently mutable via update masks.
+          "coreCount": 42, # Optional. The number of vCPUs per instance. Must be a power of 2 (2, 4, 8, 16, 32). This is a create-time specification and is not currently mutable via update masks.
+          "hardwareClass": "A String", # Optional. The hardware class of the instances. This is a create-time specification and is not currently mutable via update masks.
+          "numInstances": 42, # Optional. The number of VM instances requested.For master instances, this must be 1. For worker and secondary worker instances, this represents the desired capacity of the group and is mutable via cluster update operations and autoscaling.
+        },
       },
       "labels": { # Optional. The labels to associate with this cluster.Label keys must be between 1 and 63 characters long, and must conform to the following PCRE regular expression: \p{Ll}\p{Lo}{0,62}Label values must be between 1 and 63 characters long, and must conform to the following PCRE regular expression: \p{Ll}\p{Lo}\p{N}_-{0,63}No more than 32 labels can be associated with a given cluster.
         "a_key": "A String",
diff --git a/googleapiclient/discovery_cache/documents/dataproc.v1.json b/googleapiclient/discovery_cache/documents/dataproc.v1.json
index 309a0542d3..a8d71ae230 100644
--- a/googleapiclient/discovery_cache/documents/dataproc.v1.json
+++ b/googleapiclient/discovery_cache/documents/dataproc.v1.json
@@ -5503,7 +5503,7 @@
 }
 }
 },
-"revision": "20260926",
+"revision": "20261008",
 "rootUrl": "https://dataproc.googleapis.com/",
 "schemas": {
 "AcceleratorConfig": {
@@ -6656,6 +6656,10 @@
 "$ref": "InstanceGroupConfig",
 "description": "Optional. The Compute Engine config settings for the cluster's master instance."
 },
+"masterFlexibleConfig": {
+"$ref": "FlexibleInstanceGroupConfig",
+"description": "Optional. The High Obtainability (HO) config settings for the cluster's master instances.In High Obtainability (HO) mode, flexible configs are the single source of truth for desired cluster configuration across node groups: * For single-node clusters: master_flexible_config must be specified, and no worker configs should be set. * For multi-node (standard) clusters: both master_flexible_config and worker_flexible_config must be specified. Mixing standard and flexible configs across node groups is not allowed.Only one of master_config or master_flexible_config can be set."
+},
 "metastoreConfig": {
 "$ref": "MetastoreConfig",
 "description": "Optional. Metastore configuration."
@@ -6664,6 +6668,10 @@
 "$ref": "InstanceGroupConfig",
 "description": "Optional. The Compute Engine config settings for a cluster's secondary worker instances"
 },
+"secondaryWorkerFlexibleConfig": {
+"$ref": "FlexibleInstanceGroupConfig",
+"description": "Optional. The High Obtainability (HO) config settings for a cluster's secondary worker instances.In High Obtainability (HO) mode, flexible configs are the single source of truth for desired cluster configuration. num_instances represents the desired capacity of the secondary worker group and is mutable via cluster updates and autoscaling.Only one of secondary_worker_config or secondary_worker_flexible_config can be set.In High Obtainability (HO) mode, secondary workers are optional. If secondary workers are used in an HO cluster, they must be configured using secondary_worker_flexible_config (not secondary_worker_config)."
+},
 "securityConfig": {
 "$ref": "SecurityConfig",
 "description": "Optional. Security settings for the cluster."
@@ -6679,6 +6687,10 @@
 "workerConfig": {
 "$ref": "InstanceGroupConfig",
 "description": "Optional. The Compute Engine config settings for the cluster's worker instances."
+},
+"workerFlexibleConfig": {
+"$ref": "FlexibleInstanceGroupConfig",
+"description": "Optional. The High Obtainability (HO) config settings for the cluster's worker instances.In High Obtainability (HO) mode, flexible configs are the single source of truth for desired cluster configuration. num_instances represents the desired capacity of the worker group and is mutable via cluster updates and autoscaling.Only one of worker_config or worker_flexible_config can be set.In High Obtainability (HO) mode, for multi-node (standard) clusters, both master_flexible_config and worker_flexible_config must be specified. Mixing standard and flexible configs across node groups is not allowed. Single-node clusters do not specify worker configs."
 }
 },
 "type": "object"
@@ -7734,6 +7746,42 @@
 },
 "type": "object"
 },
+"FlexibleInstanceGroupConfig": {
+"description": "The configuration for High Obtainability (HO) flexible instance groups. Flexible instance group configs serve as the single source of truth for desired state.",
+"id": "FlexibleInstanceGroupConfig",
+"properties": {
+"bootDiskSizeGb": {
+"description": "Optional. The boot disk size in GB. This is a create-time specification and is not currently mutable via update masks.",
+"format": "int32",
+"type": "integer"
+},
+"coreCount": {
+"description": "Optional. The number of vCPUs per instance. Must be a power of 2 (2, 4, 8, 16, 32). This is a create-time specification and is not currently mutable via update masks.",
+"format": "int32",
+"type": "integer"
+},
+"hardwareClass": {
+"description": "Optional. The hardware class of the instances. This is a create-time specification and is not currently mutable via update masks.",
+"enum": [
+"HARDWARE_CLASS_UNSPECIFIED",
+"STANDARD",
+"PERFORMANCE"
+],
+"enumDescriptions": [
+"Unspecified hardware class.",
+"Standard hardware class. Provides a balanced compute configuration with approximately 4GB of memory per vCPU and standard disk storage tiers.Candidate machine types include n4-standard, n4d-standard, n2-standard, and n2d-standard (Rank 0), and c4-standard and c4d-standard (Rank 1) (for requested core counts 2, 4, 8, 16, 32).Warning: The specific machine families and types selected for this hardware class are subject to change. Users should not take a dependency on the underlying machine type selection.",
+"Performance hardware class. Provides a high-performance configuration with approximately 8GB of memory per vCPU (e.g. high-memory machine types) and higher-tier disk configurations (e.g. higher IOPS and throughput).Candidate machine types include n4-highmem, n4d-highmem, n2-highmem, and n2d-highmem (Rank 0), and c4-highmem and c4d-highmem (Rank 1) (for requested core counts 2, 4, 8, 16, 32). n4, n4d, c4, and c4d use Hyperdisk Balanced with provisioned storage, whereas n2 and n2d use SSD persistent disks.Warning: The specific machine families and types selected for this hardware class are subject to change. Users should not take a dependency on the underlying machine type selection."
+],
+"type": "string"
+},
+"numInstances": {
+"description": "Optional. The number of VM instances requested.For master instances, this must be 1. For worker and secondary worker instances, this represents the desired capacity of the group and is mutable via cluster update operations and autoscaling.",
+"format": "int32",
+"type": "integer"
+}
+},
+"type": "object"
+},
 "FlinkJob": {
 "description": "A Dataproc job for running Apache Flink applications on YARN.",
 "id": "FlinkJob",
@@ -11282,6 +11330,10 @@
 "description": "Optional. Brief description of the template.",
 "type": "string"
 },
+"displayName": {
+"description": "Optional. User-friendly display name for the session template. Can be up to 63 characters.",
+"type": "string"
+},
 "environmentConfig": {
 "$ref": "EnvironmentConfig",
 "description": "Optional. Environment configuration for session execution."

From a87049916c48b27e61d1efee518fff42de13f4e4 Mon Sep 17 00:00:00 2001
From: Yoshi Automation 
Date: Tue, 20 Oct 2026 07:24:00 +0000
Subject: [PATCH 14/34] feat(devicerun): update the api

#### devicerun:v1alpha

The following keys were added:
- schemas.IssueSummary.properties.metadata (Total Keys: 3)
- schemas.Session.properties.createTime (Total Keys: 3)
---
 ...n_v1alpha.projects.locations.sessions.html | 120 ++++++++++++++----
 .../documents/devicerun.v1alpha.json          |  44 ++++---
 2 files changed, 121 insertions(+), 43 deletions(-)

diff --git a/docs/dyn/devicerun_v1alpha.projects.locations.sessions.html b/docs/dyn/devicerun_v1alpha.projects.locations.sessions.html
index d014b44249..826e0f17cd 100644
--- a/docs/dyn/devicerun_v1alpha.projects.locations.sessions.html
+++ b/docs/dyn/devicerun_v1alpha.projects.locations.sessions.html
@@ -117,6 +117,7 @@ 
Method Details

     { # Response including the requested sessions.
   "sessions": [ # The requested sessions, in the same order as the `names` in the request.
     { # A session resource in the AutomationSession API. At a high level, `Session` describes the configuration of one or multiple jobs, the state transitions it goes through, and the results.
+      "createTime": "A String", # Output only. The time when the session was created.
       "name": "A String", # Identifier. The resource name of the session. Format: `projects/{project}/locations/{location}/sessions/{session}`.
       "sessionConfig": { # SessionConfig is used to create a session. # Required. Configuration used to create the session.
         "displayName": "A String", # Optional. User-settable, human-readable name for the session. Maximum size is 63 bytes when encoded as UTF-8. If set, must match regex: `^A-Za-z0-9*$`.
@@ -191,10 +192,10 @@ 
Method Details

                   "actions": [ # Optional. The actions to be performed on the device. Actions will be executed in the order they are specified in the list. Each action type can at most have 1 instance in the list.
                     { # The action to be performed on a device.
                       "androidBugreport": { # Captures a bugreport from the device. The output will be written to a file named `bugreport.zip` in the execution output directory. # Captures a bugreport from the device unless the test result is pass.
-                        "collectOnPass": True or False, # Optional. Whether to deliver the bugreport when the test passes. If false, the bugreport is skipped on pass to save time (default behavior). If true, the bugreport is always delivered.
+                        "collectOnPass": True or False, # Optional. Whether to deliver the bugreport when the test passes. If `false`, the bugreport is skipped on pass to save time (default behavior). If `true`, the bugreport is always delivered.
                       },
                       "androidDumpsys": { # Captures dumpsys output from the device. The output will be written to a file named `dumpsys.log` in the execution output directory. # Captures a dumpsys from the device.
-                        "collectOnPass": True or False, # Optional. Whether to deliver the dumpsys when the test passes. If false, the dumpsys is skipped on pass to save time (default behavior). If true, the dumpsys is always delivered.
+                        "collectOnPass": True or False, # Optional. Whether to deliver the dumpsys when the test passes. If `false`, the dumpsys is skipped on pass to save time (default behavior). If `true`, the dumpsys is always delivered.
                       },
                       "androidInstallPackages": { # Installs Android packages on the device. At least one installable is specified when using this device action. Limits: - A maximum of 20 installables in total are allowed. - A maximum of 100 files are allowed in total across all installables. # Installs Android packages on the device.
                         "installables": [ # Optional. Deprecated: use `pre_target_app_installables`, `target_app` and `post_target_app_installables` instead. The Android packages to install on the device. The installation will be performed in the order specified, before the installables of all other fields.
@@ -269,7 +270,7 @@ 
Method Details

                         ],
                       },
                       "androidRecordVideo": { # Records a video of the device screen during the run. The video will be written to a file named `video.mp4` in the execution output directory. # Records a video of the device screen during the run.
-                        "discardOnPass": True or False, # Optional. Whether to discard and not upload the recording when the test passes. Default is false.
+                        "discardOnPass": True or False, # Optional. Whether to discard and not upload the recording when the test passes. Default is `false`.
                       },
                       "androidSwitchLocale": { # Switches the locale (language and region) of the device. # Switches the locale (language and region) of the device.
                         "localeCode": "A String", # Required. The locale (language and region) to switch the device to. The format is `language-region`, e.g. "en-US", "zh-CN", etc. The typical language value is a two or three-letter language code as defined in ISO639. The typical region value is a two-letter ISO 3166 code or a three-digit UN M.49 area code.
@@ -306,8 +307,8 @@ 
Method Details

                           },
                         ],
                       },
-                      "iosRecordVideo": { # Records a video of the iOS device screen during the run. The video will be written to a file named `video.mp4` in the execution output directory. # Records a video of the iOS device screen during the run.
-                        "discardOnPass": True or False, # Optional. Whether to discard the video if the test passes. If not specified, the default is false (always keep the video).
+                      "iosRecordVideo": { # Records videos of the iOS device screen, one per UI test case. Each video covers only the execution of its test case, and will be written to `testcases/{test_class}/{test_method}/video.mp4` in the execution output directory. No video is recorded for unit tests, or on devices running a version earlier than iOS 17. # Records videos of the iOS device screen, one per UI test case.
+                        "discardOnPass": True or False, # Optional. Whether to discard the video of a test case when it passes. If not specified, the default is `false` (videos of all test cases are kept).
                       },
                       "iosSwitchLocale": { # Switches the locale (language and region) of the iOS application. # Switches the locale (language and region) of the iOS application.
                         "localeCode": "A String", # Required. The locale (language and region) to switch the app to. The format is `language-region` or `language`, e.g. "en-US", "zh-CN", "ja", etc.
@@ -370,6 +371,9 @@ 
Method Details

                   "cause": { # Describes the cause of the non-passed result occurred during the execution. # Output only. Detailed result cause diagnostics. Set if type is not PASSED.
                     "summary": { # Describes the summary of an issue (error or warning) with structured details. # Output only. Structured cause detail.
                       "message": "A String", # Output only. Human-readable explanation of the issue in English.
+                      "metadata": { # Output only. Additional metadata about the issue.
+                        "a_key": "A String",
+                      },
                       "reason": "A String", # Output only. The reason of the issue. This is a constant value that identifies the proximate cause of the issue. This should be at most 63 characters and match a regular expression of `A-Z*[A-Z0-9]`, which represents UPPER_SNAKE_CASE.
                       "type": "A String", # Output only. The issue classification based on responsibility.
                     },
@@ -387,6 +391,9 @@ 
Method Details

                   { # Non-fatal operational anomaly, lint observation, or execution insight.
                     "summary": { # Describes the summary of an issue (error or warning) with structured details. # Output only. Detailed warning summary.
                       "message": "A String", # Output only. Human-readable explanation of the issue in English.
+                      "metadata": { # Output only. Additional metadata about the issue.
+                        "a_key": "A String",
+                      },
                       "reason": "A String", # Output only. The reason of the issue. This is a constant value that identifies the proximate cause of the issue. This should be at most 63 characters and match a regular expression of `A-Z*[A-Z0-9]`, which represents UPPER_SNAKE_CASE.
                       "type": "A String", # Output only. The issue classification based on responsibility.
                     },
@@ -409,6 +416,9 @@ 
Method Details

               "cause": { # Describes the cause of the non-passed result occurred during the execution. # Output only. Detailed result cause diagnostics. Set if type is not PASSED.
                 "summary": { # Describes the summary of an issue (error or warning) with structured details. # Output only. Structured cause detail.
                   "message": "A String", # Output only. Human-readable explanation of the issue in English.
+                  "metadata": { # Output only. Additional metadata about the issue.
+                    "a_key": "A String",
+                  },
                   "reason": "A String", # Output only. The reason of the issue. This is a constant value that identifies the proximate cause of the issue. This should be at most 63 characters and match a regular expression of `A-Z*[A-Z0-9]`, which represents UPPER_SNAKE_CASE.
                   "type": "A String", # Output only. The issue classification based on responsibility.
                 },
@@ -426,6 +436,9 @@ 
Method Details

               { # Non-fatal operational anomaly, lint observation, or execution insight.
                 "summary": { # Describes the summary of an issue (error or warning) with structured details. # Output only. Detailed warning summary.
                   "message": "A String", # Output only. Human-readable explanation of the issue in English.
+                  "metadata": { # Output only. Additional metadata about the issue.
+                    "a_key": "A String",
+                  },
                   "reason": "A String", # Output only. The reason of the issue. This is a constant value that identifies the proximate cause of the issue. This should be at most 63 characters and match a regular expression of `A-Z*[A-Z0-9]`, which represents UPPER_SNAKE_CASE.
                   "type": "A String", # Output only. The issue classification based on responsibility.
                 },
@@ -437,6 +450,9 @@ 
Method Details

           "cause": { # Describes the cause of the non-passed result occurred during the execution. # Output only. Detailed result cause diagnostics. Set if type is not PASSED.
             "summary": { # Describes the summary of an issue (error or warning) with structured details. # Output only. Structured cause detail.
               "message": "A String", # Output only. Human-readable explanation of the issue in English.
+              "metadata": { # Output only. Additional metadata about the issue.
+                "a_key": "A String",
+              },
               "reason": "A String", # Output only. The reason of the issue. This is a constant value that identifies the proximate cause of the issue. This should be at most 63 characters and match a regular expression of `A-Z*[A-Z0-9]`, which represents UPPER_SNAKE_CASE.
               "type": "A String", # Output only. The issue classification based on responsibility.
             },
@@ -496,6 +512,7 @@ 
Method Details

     The object takes the form of:
 
 { # A session resource in the AutomationSession API. At a high level, `Session` describes the configuration of one or multiple jobs, the state transitions it goes through, and the results.
+  "createTime": "A String", # Output only. The time when the session was created.
   "name": "A String", # Identifier. The resource name of the session. Format: `projects/{project}/locations/{location}/sessions/{session}`.
   "sessionConfig": { # SessionConfig is used to create a session. # Required. Configuration used to create the session.
     "displayName": "A String", # Optional. User-settable, human-readable name for the session. Maximum size is 63 bytes when encoded as UTF-8. If set, must match regex: `^A-Za-z0-9*$`.
@@ -570,10 +587,10 @@ 
Method Details

               "actions": [ # Optional. The actions to be performed on the device. Actions will be executed in the order they are specified in the list. Each action type can at most have 1 instance in the list.
                 { # The action to be performed on a device.
                   "androidBugreport": { # Captures a bugreport from the device. The output will be written to a file named `bugreport.zip` in the execution output directory. # Captures a bugreport from the device unless the test result is pass.
-                    "collectOnPass": True or False, # Optional. Whether to deliver the bugreport when the test passes. If false, the bugreport is skipped on pass to save time (default behavior). If true, the bugreport is always delivered.
+                    "collectOnPass": True or False, # Optional. Whether to deliver the bugreport when the test passes. If `false`, the bugreport is skipped on pass to save time (default behavior). If `true`, the bugreport is always delivered.
                   },
                   "androidDumpsys": { # Captures dumpsys output from the device. The output will be written to a file named `dumpsys.log` in the execution output directory. # Captures a dumpsys from the device.
-                    "collectOnPass": True or False, # Optional. Whether to deliver the dumpsys when the test passes. If false, the dumpsys is skipped on pass to save time (default behavior). If true, the dumpsys is always delivered.
+                    "collectOnPass": True or False, # Optional. Whether to deliver the dumpsys when the test passes. If `false`, the dumpsys is skipped on pass to save time (default behavior). If `true`, the dumpsys is always delivered.
                   },
                   "androidInstallPackages": { # Installs Android packages on the device. At least one installable is specified when using this device action. Limits: - A maximum of 20 installables in total are allowed. - A maximum of 100 files are allowed in total across all installables. # Installs Android packages on the device.
                     "installables": [ # Optional. Deprecated: use `pre_target_app_installables`, `target_app` and `post_target_app_installables` instead. The Android packages to install on the device. The installation will be performed in the order specified, before the installables of all other fields.
@@ -648,7 +665,7 @@ 
Method Details

                     ],
                   },
                   "androidRecordVideo": { # Records a video of the device screen during the run. The video will be written to a file named `video.mp4` in the execution output directory. # Records a video of the device screen during the run.
-                    "discardOnPass": True or False, # Optional. Whether to discard and not upload the recording when the test passes. Default is false.
+                    "discardOnPass": True or False, # Optional. Whether to discard and not upload the recording when the test passes. Default is `false`.
                   },
                   "androidSwitchLocale": { # Switches the locale (language and region) of the device. # Switches the locale (language and region) of the device.
                     "localeCode": "A String", # Required. The locale (language and region) to switch the device to. The format is `language-region`, e.g. "en-US", "zh-CN", etc. The typical language value is a two or three-letter language code as defined in ISO639. The typical region value is a two-letter ISO 3166 code or a three-digit UN M.49 area code.
@@ -685,8 +702,8 @@ 
Method Details

                       },
                     ],
                   },
-                  "iosRecordVideo": { # Records a video of the iOS device screen during the run. The video will be written to a file named `video.mp4` in the execution output directory. # Records a video of the iOS device screen during the run.
-                    "discardOnPass": True or False, # Optional. Whether to discard the video if the test passes. If not specified, the default is false (always keep the video).
+                  "iosRecordVideo": { # Records videos of the iOS device screen, one per UI test case. Each video covers only the execution of its test case, and will be written to `testcases/{test_class}/{test_method}/video.mp4` in the execution output directory. No video is recorded for unit tests, or on devices running a version earlier than iOS 17. # Records videos of the iOS device screen, one per UI test case.
+                    "discardOnPass": True or False, # Optional. Whether to discard the video of a test case when it passes. If not specified, the default is `false` (videos of all test cases are kept).
                   },
                   "iosSwitchLocale": { # Switches the locale (language and region) of the iOS application. # Switches the locale (language and region) of the iOS application.
                     "localeCode": "A String", # Required. The locale (language and region) to switch the app to. The format is `language-region` or `language`, e.g. "en-US", "zh-CN", "ja", etc.
@@ -749,6 +766,9 @@ 
Method Details

               "cause": { # Describes the cause of the non-passed result occurred during the execution. # Output only. Detailed result cause diagnostics. Set if type is not PASSED.
                 "summary": { # Describes the summary of an issue (error or warning) with structured details. # Output only. Structured cause detail.
                   "message": "A String", # Output only. Human-readable explanation of the issue in English.
+                  "metadata": { # Output only. Additional metadata about the issue.
+                    "a_key": "A String",
+                  },
                   "reason": "A String", # Output only. The reason of the issue. This is a constant value that identifies the proximate cause of the issue. This should be at most 63 characters and match a regular expression of `A-Z*[A-Z0-9]`, which represents UPPER_SNAKE_CASE.
                   "type": "A String", # Output only. The issue classification based on responsibility.
                 },
@@ -766,6 +786,9 @@ 
Method Details

               { # Non-fatal operational anomaly, lint observation, or execution insight.
                 "summary": { # Describes the summary of an issue (error or warning) with structured details. # Output only. Detailed warning summary.
                   "message": "A String", # Output only. Human-readable explanation of the issue in English.
+                  "metadata": { # Output only. Additional metadata about the issue.
+                    "a_key": "A String",
+                  },
                   "reason": "A String", # Output only. The reason of the issue. This is a constant value that identifies the proximate cause of the issue. This should be at most 63 characters and match a regular expression of `A-Z*[A-Z0-9]`, which represents UPPER_SNAKE_CASE.
                   "type": "A String", # Output only. The issue classification based on responsibility.
                 },
@@ -788,6 +811,9 @@ 
Method Details

           "cause": { # Describes the cause of the non-passed result occurred during the execution. # Output only. Detailed result cause diagnostics. Set if type is not PASSED.
             "summary": { # Describes the summary of an issue (error or warning) with structured details. # Output only. Structured cause detail.
               "message": "A String", # Output only. Human-readable explanation of the issue in English.
+              "metadata": { # Output only. Additional metadata about the issue.
+                "a_key": "A String",
+              },
               "reason": "A String", # Output only. The reason of the issue. This is a constant value that identifies the proximate cause of the issue. This should be at most 63 characters and match a regular expression of `A-Z*[A-Z0-9]`, which represents UPPER_SNAKE_CASE.
               "type": "A String", # Output only. The issue classification based on responsibility.
             },
@@ -805,6 +831,9 @@ 
Method Details

           { # Non-fatal operational anomaly, lint observation, or execution insight.
             "summary": { # Describes the summary of an issue (error or warning) with structured details. # Output only. Detailed warning summary.
               "message": "A String", # Output only. Human-readable explanation of the issue in English.
+              "metadata": { # Output only. Additional metadata about the issue.
+                "a_key": "A String",
+              },
               "reason": "A String", # Output only. The reason of the issue. This is a constant value that identifies the proximate cause of the issue. This should be at most 63 characters and match a regular expression of `A-Z*[A-Z0-9]`, which represents UPPER_SNAKE_CASE.
               "type": "A String", # Output only. The issue classification based on responsibility.
             },
@@ -816,6 +845,9 @@ 
Method Details

       "cause": { # Describes the cause of the non-passed result occurred during the execution. # Output only. Detailed result cause diagnostics. Set if type is not PASSED.
         "summary": { # Describes the summary of an issue (error or warning) with structured details. # Output only. Structured cause detail.
           "message": "A String", # Output only. Human-readable explanation of the issue in English.
+          "metadata": { # Output only. Additional metadata about the issue.
+            "a_key": "A String",
+          },
           "reason": "A String", # Output only. The reason of the issue. This is a constant value that identifies the proximate cause of the issue. This should be at most 63 characters and match a regular expression of `A-Z*[A-Z0-9]`, which represents UPPER_SNAKE_CASE.
           "type": "A String", # Output only. The issue classification based on responsibility.
         },
@@ -905,11 +937,11 @@ 
Method Details

 
 Args:
   name: string, Required. The name of the session. Format: `projects/{project}/locations/{location}/sessions/{session}`. (required)
-  view: string, Optional. The view of the session to return. If not set, the default BASIC view will be returned.
+  view: string, Optional. The view of the session to return. If not set, the `FULL` view will be returned.
     Allowed values
-      SESSION_VIEW_UNSPECIFIED - The default / unset value. The API will default to the BASIC view.
-      SESSION_VIEW_BASIC - Include basic view of the session but not the full contents. Only the uid/display_name/status/result of the session and its jobs/executions will be included. This is the default value (for GetSession).
-      SESSION_VIEW_FULL - Include everything.
+      SESSION_VIEW_UNSPECIFIED - The default / unset value. The API will default to the FULL view.
+      SESSION_VIEW_BASIC - Include basic view of the session but not the full contents. Only the uid/display_name/status/result of the session and its jobs/executions will be included.
+      SESSION_VIEW_FULL - Include everything. This is the default value.
   x__xgafv: string, V1 error format.
     Allowed values
       1 - v1 error format
@@ -919,6 +951,7 @@ 
Method Details

   An object of the form:
 
     { # A session resource in the AutomationSession API. At a high level, `Session` describes the configuration of one or multiple jobs, the state transitions it goes through, and the results.
+  "createTime": "A String", # Output only. The time when the session was created.
   "name": "A String", # Identifier. The resource name of the session. Format: `projects/{project}/locations/{location}/sessions/{session}`.
   "sessionConfig": { # SessionConfig is used to create a session. # Required. Configuration used to create the session.
     "displayName": "A String", # Optional. User-settable, human-readable name for the session. Maximum size is 63 bytes when encoded as UTF-8. If set, must match regex: `^A-Za-z0-9*$`.
@@ -993,10 +1026,10 @@ 
Method Details

               "actions": [ # Optional. The actions to be performed on the device. Actions will be executed in the order they are specified in the list. Each action type can at most have 1 instance in the list.
                 { # The action to be performed on a device.
                   "androidBugreport": { # Captures a bugreport from the device. The output will be written to a file named `bugreport.zip` in the execution output directory. # Captures a bugreport from the device unless the test result is pass.
-                    "collectOnPass": True or False, # Optional. Whether to deliver the bugreport when the test passes. If false, the bugreport is skipped on pass to save time (default behavior). If true, the bugreport is always delivered.
+                    "collectOnPass": True or False, # Optional. Whether to deliver the bugreport when the test passes. If `false`, the bugreport is skipped on pass to save time (default behavior). If `true`, the bugreport is always delivered.
                   },
                   "androidDumpsys": { # Captures dumpsys output from the device. The output will be written to a file named `dumpsys.log` in the execution output directory. # Captures a dumpsys from the device.
-                    "collectOnPass": True or False, # Optional. Whether to deliver the dumpsys when the test passes. If false, the dumpsys is skipped on pass to save time (default behavior). If true, the dumpsys is always delivered.
+                    "collectOnPass": True or False, # Optional. Whether to deliver the dumpsys when the test passes. If `false`, the dumpsys is skipped on pass to save time (default behavior). If `true`, the dumpsys is always delivered.
                   },
                   "androidInstallPackages": { # Installs Android packages on the device. At least one installable is specified when using this device action. Limits: - A maximum of 20 installables in total are allowed. - A maximum of 100 files are allowed in total across all installables. # Installs Android packages on the device.
                     "installables": [ # Optional. Deprecated: use `pre_target_app_installables`, `target_app` and `post_target_app_installables` instead. The Android packages to install on the device. The installation will be performed in the order specified, before the installables of all other fields.
@@ -1071,7 +1104,7 @@ 
Method Details

                     ],
                   },
                   "androidRecordVideo": { # Records a video of the device screen during the run. The video will be written to a file named `video.mp4` in the execution output directory. # Records a video of the device screen during the run.
-                    "discardOnPass": True or False, # Optional. Whether to discard and not upload the recording when the test passes. Default is false.
+                    "discardOnPass": True or False, # Optional. Whether to discard and not upload the recording when the test passes. Default is `false`.
                   },
                   "androidSwitchLocale": { # Switches the locale (language and region) of the device. # Switches the locale (language and region) of the device.
                     "localeCode": "A String", # Required. The locale (language and region) to switch the device to. The format is `language-region`, e.g. "en-US", "zh-CN", etc. The typical language value is a two or three-letter language code as defined in ISO639. The typical region value is a two-letter ISO 3166 code or a three-digit UN M.49 area code.
@@ -1108,8 +1141,8 @@ 
Method Details

                       },
                     ],
                   },
-                  "iosRecordVideo": { # Records a video of the iOS device screen during the run. The video will be written to a file named `video.mp4` in the execution output directory. # Records a video of the iOS device screen during the run.
-                    "discardOnPass": True or False, # Optional. Whether to discard the video if the test passes. If not specified, the default is false (always keep the video).
+                  "iosRecordVideo": { # Records videos of the iOS device screen, one per UI test case. Each video covers only the execution of its test case, and will be written to `testcases/{test_class}/{test_method}/video.mp4` in the execution output directory. No video is recorded for unit tests, or on devices running a version earlier than iOS 17. # Records videos of the iOS device screen, one per UI test case.
+                    "discardOnPass": True or False, # Optional. Whether to discard the video of a test case when it passes. If not specified, the default is `false` (videos of all test cases are kept).
                   },
                   "iosSwitchLocale": { # Switches the locale (language and region) of the iOS application. # Switches the locale (language and region) of the iOS application.
                     "localeCode": "A String", # Required. The locale (language and region) to switch the app to. The format is `language-region` or `language`, e.g. "en-US", "zh-CN", "ja", etc.
@@ -1172,6 +1205,9 @@ 
Method Details

               "cause": { # Describes the cause of the non-passed result occurred during the execution. # Output only. Detailed result cause diagnostics. Set if type is not PASSED.
                 "summary": { # Describes the summary of an issue (error or warning) with structured details. # Output only. Structured cause detail.
                   "message": "A String", # Output only. Human-readable explanation of the issue in English.
+                  "metadata": { # Output only. Additional metadata about the issue.
+                    "a_key": "A String",
+                  },
                   "reason": "A String", # Output only. The reason of the issue. This is a constant value that identifies the proximate cause of the issue. This should be at most 63 characters and match a regular expression of `A-Z*[A-Z0-9]`, which represents UPPER_SNAKE_CASE.
                   "type": "A String", # Output only. The issue classification based on responsibility.
                 },
@@ -1189,6 +1225,9 @@ 
Method Details

               { # Non-fatal operational anomaly, lint observation, or execution insight.
                 "summary": { # Describes the summary of an issue (error or warning) with structured details. # Output only. Detailed warning summary.
                   "message": "A String", # Output only. Human-readable explanation of the issue in English.
+                  "metadata": { # Output only. Additional metadata about the issue.
+                    "a_key": "A String",
+                  },
                   "reason": "A String", # Output only. The reason of the issue. This is a constant value that identifies the proximate cause of the issue. This should be at most 63 characters and match a regular expression of `A-Z*[A-Z0-9]`, which represents UPPER_SNAKE_CASE.
                   "type": "A String", # Output only. The issue classification based on responsibility.
                 },
@@ -1211,6 +1250,9 @@ 
Method Details

           "cause": { # Describes the cause of the non-passed result occurred during the execution. # Output only. Detailed result cause diagnostics. Set if type is not PASSED.
             "summary": { # Describes the summary of an issue (error or warning) with structured details. # Output only. Structured cause detail.
               "message": "A String", # Output only. Human-readable explanation of the issue in English.
+              "metadata": { # Output only. Additional metadata about the issue.
+                "a_key": "A String",
+              },
               "reason": "A String", # Output only. The reason of the issue. This is a constant value that identifies the proximate cause of the issue. This should be at most 63 characters and match a regular expression of `A-Z*[A-Z0-9]`, which represents UPPER_SNAKE_CASE.
               "type": "A String", # Output only. The issue classification based on responsibility.
             },
@@ -1228,6 +1270,9 @@ 
Method Details

           { # Non-fatal operational anomaly, lint observation, or execution insight.
             "summary": { # Describes the summary of an issue (error or warning) with structured details. # Output only. Detailed warning summary.
               "message": "A String", # Output only. Human-readable explanation of the issue in English.
+              "metadata": { # Output only. Additional metadata about the issue.
+                "a_key": "A String",
+              },
               "reason": "A String", # Output only. The reason of the issue. This is a constant value that identifies the proximate cause of the issue. This should be at most 63 characters and match a regular expression of `A-Z*[A-Z0-9]`, which represents UPPER_SNAKE_CASE.
               "type": "A String", # Output only. The issue classification based on responsibility.
             },
@@ -1239,6 +1284,9 @@ 
Method Details

       "cause": { # Describes the cause of the non-passed result occurred during the execution. # Output only. Detailed result cause diagnostics. Set if type is not PASSED.
         "summary": { # Describes the summary of an issue (error or warning) with structured details. # Output only. Structured cause detail.
           "message": "A String", # Output only. Human-readable explanation of the issue in English.
+          "metadata": { # Output only. Additional metadata about the issue.
+            "a_key": "A String",
+          },
           "reason": "A String", # Output only. The reason of the issue. This is a constant value that identifies the proximate cause of the issue. This should be at most 63 characters and match a regular expression of `A-Z*[A-Z0-9]`, which represents UPPER_SNAKE_CASE.
           "type": "A String", # Output only. The issue classification based on responsibility.
         },
@@ -1266,11 +1314,11 @@ 
Method Details

   orderBy: string, Optional. The order to sort results by. Supported values: `name`, `name desc`, `create_time`, `create_time desc`. Values must use the snake_case field name; `createTime` is not accepted. Ordering by `create_time` is not supported when listing across all locations (`locations/-`). If unspecified, results are returned in an unspecified order.
   pageSize: integer, Optional. The maximum number of sessions to return. The server may return fewer items than this value. If unspecified, at most 500 sessions will be returned. The maximum value is 1000, values above will be coerced to 1000.
   pageToken: string, Optional. A page token, received from a previous `ListSessions` call. Provide this to receive the subsequent page. When paginating, all other parameters provided to `ListSessions` must match the call that provided the page token.
-  view: string, Optional. The view of the sessions to return. If not set, the `BASIC` view will be returned.
+  view: string, Optional. The view of the sessions to return. If not set, the `FULL` view will be returned.
     Allowed values
-      SESSION_VIEW_UNSPECIFIED - The default / unset value. The API will default to the BASIC view.
-      SESSION_VIEW_BASIC - Include basic view of the session but not the full contents. Only the uid/display_name/status/result of the session and its jobs/executions will be included. This is the default value (for GetSession).
-      SESSION_VIEW_FULL - Include everything.
+      SESSION_VIEW_UNSPECIFIED - The default / unset value. The API will default to the FULL view.
+      SESSION_VIEW_BASIC - Include basic view of the session but not the full contents. Only the uid/display_name/status/result of the session and its jobs/executions will be included.
+      SESSION_VIEW_FULL - Include everything. This is the default value.
   x__xgafv: string, V1 error format.
     Allowed values
       1 - v1 error format
@@ -1283,6 +1331,7 @@ 
Method Details

   "nextPageToken": "A String", # Token to receive the next page of sessions. This will be absent if the end of the response list has been reached.
   "sessions": [ # The list of sessions.
     { # A session resource in the AutomationSession API. At a high level, `Session` describes the configuration of one or multiple jobs, the state transitions it goes through, and the results.
+      "createTime": "A String", # Output only. The time when the session was created.
       "name": "A String", # Identifier. The resource name of the session. Format: `projects/{project}/locations/{location}/sessions/{session}`.
       "sessionConfig": { # SessionConfig is used to create a session. # Required. Configuration used to create the session.
         "displayName": "A String", # Optional. User-settable, human-readable name for the session. Maximum size is 63 bytes when encoded as UTF-8. If set, must match regex: `^A-Za-z0-9*$`.
@@ -1357,10 +1406,10 @@ 
Method Details

                   "actions": [ # Optional. The actions to be performed on the device. Actions will be executed in the order they are specified in the list. Each action type can at most have 1 instance in the list.
                     { # The action to be performed on a device.
                       "androidBugreport": { # Captures a bugreport from the device. The output will be written to a file named `bugreport.zip` in the execution output directory. # Captures a bugreport from the device unless the test result is pass.
-                        "collectOnPass": True or False, # Optional. Whether to deliver the bugreport when the test passes. If false, the bugreport is skipped on pass to save time (default behavior). If true, the bugreport is always delivered.
+                        "collectOnPass": True or False, # Optional. Whether to deliver the bugreport when the test passes. If `false`, the bugreport is skipped on pass to save time (default behavior). If `true`, the bugreport is always delivered.
                       },
                       "androidDumpsys": { # Captures dumpsys output from the device. The output will be written to a file named `dumpsys.log` in the execution output directory. # Captures a dumpsys from the device.
-                        "collectOnPass": True or False, # Optional. Whether to deliver the dumpsys when the test passes. If false, the dumpsys is skipped on pass to save time (default behavior). If true, the dumpsys is always delivered.
+                        "collectOnPass": True or False, # Optional. Whether to deliver the dumpsys when the test passes. If `false`, the dumpsys is skipped on pass to save time (default behavior). If `true`, the dumpsys is always delivered.
                       },
                       "androidInstallPackages": { # Installs Android packages on the device. At least one installable is specified when using this device action. Limits: - A maximum of 20 installables in total are allowed. - A maximum of 100 files are allowed in total across all installables. # Installs Android packages on the device.
                         "installables": [ # Optional. Deprecated: use `pre_target_app_installables`, `target_app` and `post_target_app_installables` instead. The Android packages to install on the device. The installation will be performed in the order specified, before the installables of all other fields.
@@ -1435,7 +1484,7 @@ 
Method Details

                         ],
                       },
                       "androidRecordVideo": { # Records a video of the device screen during the run. The video will be written to a file named `video.mp4` in the execution output directory. # Records a video of the device screen during the run.
-                        "discardOnPass": True or False, # Optional. Whether to discard and not upload the recording when the test passes. Default is false.
+                        "discardOnPass": True or False, # Optional. Whether to discard and not upload the recording when the test passes. Default is `false`.
                       },
                       "androidSwitchLocale": { # Switches the locale (language and region) of the device. # Switches the locale (language and region) of the device.
                         "localeCode": "A String", # Required. The locale (language and region) to switch the device to. The format is `language-region`, e.g. "en-US", "zh-CN", etc. The typical language value is a two or three-letter language code as defined in ISO639. The typical region value is a two-letter ISO 3166 code or a three-digit UN M.49 area code.
@@ -1472,8 +1521,8 @@ 
Method Details

                           },
                         ],
                       },
-                      "iosRecordVideo": { # Records a video of the iOS device screen during the run. The video will be written to a file named `video.mp4` in the execution output directory. # Records a video of the iOS device screen during the run.
-                        "discardOnPass": True or False, # Optional. Whether to discard the video if the test passes. If not specified, the default is false (always keep the video).
+                      "iosRecordVideo": { # Records videos of the iOS device screen, one per UI test case. Each video covers only the execution of its test case, and will be written to `testcases/{test_class}/{test_method}/video.mp4` in the execution output directory. No video is recorded for unit tests, or on devices running a version earlier than iOS 17. # Records videos of the iOS device screen, one per UI test case.
+                        "discardOnPass": True or False, # Optional. Whether to discard the video of a test case when it passes. If not specified, the default is `false` (videos of all test cases are kept).
                       },
                       "iosSwitchLocale": { # Switches the locale (language and region) of the iOS application. # Switches the locale (language and region) of the iOS application.
                         "localeCode": "A String", # Required. The locale (language and region) to switch the app to. The format is `language-region` or `language`, e.g. "en-US", "zh-CN", "ja", etc.
@@ -1536,6 +1585,9 @@ 
Method Details

                   "cause": { # Describes the cause of the non-passed result occurred during the execution. # Output only. Detailed result cause diagnostics. Set if type is not PASSED.
                     "summary": { # Describes the summary of an issue (error or warning) with structured details. # Output only. Structured cause detail.
                       "message": "A String", # Output only. Human-readable explanation of the issue in English.
+                      "metadata": { # Output only. Additional metadata about the issue.
+                        "a_key": "A String",
+                      },
                       "reason": "A String", # Output only. The reason of the issue. This is a constant value that identifies the proximate cause of the issue. This should be at most 63 characters and match a regular expression of `A-Z*[A-Z0-9]`, which represents UPPER_SNAKE_CASE.
                       "type": "A String", # Output only. The issue classification based on responsibility.
                     },
@@ -1553,6 +1605,9 @@ 
Method Details

                   { # Non-fatal operational anomaly, lint observation, or execution insight.
                     "summary": { # Describes the summary of an issue (error or warning) with structured details. # Output only. Detailed warning summary.
                       "message": "A String", # Output only. Human-readable explanation of the issue in English.
+                      "metadata": { # Output only. Additional metadata about the issue.
+                        "a_key": "A String",
+                      },
                       "reason": "A String", # Output only. The reason of the issue. This is a constant value that identifies the proximate cause of the issue. This should be at most 63 characters and match a regular expression of `A-Z*[A-Z0-9]`, which represents UPPER_SNAKE_CASE.
                       "type": "A String", # Output only. The issue classification based on responsibility.
                     },
@@ -1575,6 +1630,9 @@ 
Method Details

               "cause": { # Describes the cause of the non-passed result occurred during the execution. # Output only. Detailed result cause diagnostics. Set if type is not PASSED.
                 "summary": { # Describes the summary of an issue (error or warning) with structured details. # Output only. Structured cause detail.
                   "message": "A String", # Output only. Human-readable explanation of the issue in English.
+                  "metadata": { # Output only. Additional metadata about the issue.
+                    "a_key": "A String",
+                  },
                   "reason": "A String", # Output only. The reason of the issue. This is a constant value that identifies the proximate cause of the issue. This should be at most 63 characters and match a regular expression of `A-Z*[A-Z0-9]`, which represents UPPER_SNAKE_CASE.
                   "type": "A String", # Output only. The issue classification based on responsibility.
                 },
@@ -1592,6 +1650,9 @@ 
Method Details

               { # Non-fatal operational anomaly, lint observation, or execution insight.
                 "summary": { # Describes the summary of an issue (error or warning) with structured details. # Output only. Detailed warning summary.
                   "message": "A String", # Output only. Human-readable explanation of the issue in English.
+                  "metadata": { # Output only. Additional metadata about the issue.
+                    "a_key": "A String",
+                  },
                   "reason": "A String", # Output only. The reason of the issue. This is a constant value that identifies the proximate cause of the issue. This should be at most 63 characters and match a regular expression of `A-Z*[A-Z0-9]`, which represents UPPER_SNAKE_CASE.
                   "type": "A String", # Output only. The issue classification based on responsibility.
                 },
@@ -1603,6 +1664,9 @@ 
Method Details

           "cause": { # Describes the cause of the non-passed result occurred during the execution. # Output only. Detailed result cause diagnostics. Set if type is not PASSED.
             "summary": { # Describes the summary of an issue (error or warning) with structured details. # Output only. Structured cause detail.
               "message": "A String", # Output only. Human-readable explanation of the issue in English.
+              "metadata": { # Output only. Additional metadata about the issue.
+                "a_key": "A String",
+              },
               "reason": "A String", # Output only. The reason of the issue. This is a constant value that identifies the proximate cause of the issue. This should be at most 63 characters and match a regular expression of `A-Z*[A-Z0-9]`, which represents UPPER_SNAKE_CASE.
               "type": "A String", # Output only. The issue classification based on responsibility.
             },
diff --git a/googleapiclient/discovery_cache/documents/devicerun.v1alpha.json b/googleapiclient/discovery_cache/documents/devicerun.v1alpha.json
index db04abb2d4..493b2a3d5b 100644
--- a/googleapiclient/discovery_cache/documents/devicerun.v1alpha.json
+++ b/googleapiclient/discovery_cache/documents/devicerun.v1alpha.json
@@ -527,16 +527,16 @@
 "type": "string"
 },
 "view": {
-"description": "Optional. The view of the session to return. If not set, the default BASIC view will be returned.",
+"description": "Optional. The view of the session to return. If not set, the `FULL` view will be returned.",
 "enum": [
 "SESSION_VIEW_UNSPECIFIED",
 "SESSION_VIEW_BASIC",
 "SESSION_VIEW_FULL"
 ],
 "enumDescriptions": [
-"The default / unset value. The API will default to the BASIC view.",
-"Include basic view of the session but not the full contents. Only the uid/display_name/status/result of the session and its jobs/executions will be included. This is the default value (for GetSession).",
-"Include everything."
+"The default / unset value. The API will default to the FULL view.",
+"Include basic view of the session but not the full contents. Only the uid/display_name/status/result of the session and its jobs/executions will be included.",
+"Include everything. This is the default value."
 ],
 "location": "query",
 "type": "string"
@@ -588,16 +588,16 @@
 "type": "string"
 },
 "view": {
-"description": "Optional. The view of the sessions to return. If not set, the `BASIC` view will be returned.",
+"description": "Optional. The view of the sessions to return. If not set, the `FULL` view will be returned.",
 "enum": [
 "SESSION_VIEW_UNSPECIFIED",
 "SESSION_VIEW_BASIC",
 "SESSION_VIEW_FULL"
 ],
 "enumDescriptions": [
-"The default / unset value. The API will default to the BASIC view.",
-"Include basic view of the session but not the full contents. Only the uid/display_name/status/result of the session and its jobs/executions will be included. This is the default value (for GetSession).",
-"Include everything."
+"The default / unset value. The API will default to the FULL view.",
+"Include basic view of the session but not the full contents. Only the uid/display_name/status/result of the session and its jobs/executions will be included.",
+"Include everything. This is the default value."
 ],
 "location": "query",
 "type": "string"
@@ -688,7 +688,7 @@
 }
 }
 },
-"revision": "20261006",
+"revision": "20261013",
 "rootUrl": "https://devicerun.googleapis.com/",
 "schemas": {
 "AllocationConfig": {
@@ -710,7 +710,7 @@
 "id": "AndroidBugreportDeviceAction",
 "properties": {
 "collectOnPass": {
-"description": "Optional. Whether to deliver the bugreport when the test passes. If false, the bugreport is skipped on pass to save time (default behavior). If true, the bugreport is always delivered.",
+"description": "Optional. Whether to deliver the bugreport when the test passes. If `false`, the bugreport is skipped on pass to save time (default behavior). If `true`, the bugreport is always delivered.",
 "type": "boolean"
 }
 },
@@ -721,7 +721,7 @@
 "id": "AndroidDumpsysDeviceAction",
 "properties": {
 "collectOnPass": {
-"description": "Optional. Whether to deliver the dumpsys when the test passes. If false, the dumpsys is skipped on pass to save time (default behavior). If true, the dumpsys is always delivered.",
+"description": "Optional. Whether to deliver the dumpsys when the test passes. If `false`, the dumpsys is skipped on pass to save time (default behavior). If `true`, the dumpsys is always delivered.",
 "type": "boolean"
 }
 },
@@ -963,7 +963,7 @@
 "id": "AndroidRecordVideoDeviceAction",
 "properties": {
 "discardOnPass": {
-"description": "Optional. Whether to discard and not upload the recording when the test passes. Default is false.",
+"description": "Optional. Whether to discard and not upload the recording when the test passes. Default is `false`.",
 "type": "boolean"
 }
 },
@@ -1537,7 +1537,7 @@
 },
 "iosRecordVideo": {
 "$ref": "IosRecordVideoDeviceAction",
-"description": "Records a video of the iOS device screen during the run."
+"description": "Records videos of the iOS device screen, one per UI test case."
 },
 "iosSwitchLocale": {
 "$ref": "IosSwitchLocaleDeviceAction",
@@ -1834,11 +1834,11 @@
 "type": "object"
 },
 "IosRecordVideoDeviceAction": {
-"description": "Records a video of the iOS device screen during the run. The video will be written to a file named `video.mp4` in the execution output directory.",
+"description": "Records videos of the iOS device screen, one per UI test case. Each video covers only the execution of its test case, and will be written to `testcases/{test_class}/{test_method}/video.mp4` in the execution output directory. No video is recorded for unit tests, or on devices running a version earlier than iOS 17.",
 "id": "IosRecordVideoDeviceAction",
 "properties": {
 "discardOnPass": {
-"description": "Optional. Whether to discard the video if the test passes. If not specified, the default is false (always keep the video).",
+"description": "Optional. Whether to discard the video of a test case when it passes. If not specified, the default is `false` (videos of all test cases are kept).",
 "type": "boolean"
 }
 },
@@ -1888,6 +1888,14 @@
 "readOnly": true,
 "type": "string"
 },
+"metadata": {
+"additionalProperties": {
+"type": "string"
+},
+"description": "Output only. Additional metadata about the issue.",
+"readOnly": true,
+"type": "object"
+},
 "reason": {
 "description": "Output only. The reason of the issue. This is a constant value that identifies the proximate cause of the issue. This should be at most 63 characters and match a regular expression of `A-Z*[A-Z0-9]`, which represents UPPER_SNAKE_CASE.",
 "readOnly": true,
@@ -2281,6 +2289,12 @@
 "description": "A session resource in the AutomationSession API. At a high level, `Session` describes the configuration of one or multiple jobs, the state transitions it goes through, and the results.",
 "id": "Session",
 "properties": {
+"createTime": {
+"description": "Output only. The time when the session was created.",
+"format": "google-datetime",
+"readOnly": true,
+"type": "string"
+},
 "name": {
 "description": "Identifier. The resource name of the session. Format: `projects/{project}/locations/{location}/sessions/{session}`.",
 "type": "string"

From 5235405b931954e3c2fddcf5f94b79a3228733eb Mon Sep 17 00:00:00 2001
From: Yoshi Automation 
Date: Tue, 20 Oct 2026 07:24:00 +0000
Subject: [PATCH 15/34] feat(dialogflow): update the api

#### dialogflow:v2

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

The following keys were added:
- schemas.GoogleCloudDialogflowV2InputAudioConfig.properties.disableInterimInputTranscripts.type (Total Keys: 1)
- schemas.GoogleCloudDialogflowV2SpeechToTextConfig.properties.disableInterimInputTranscripts.type (Total Keys: 1)

#### dialogflow:v2beta1

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

The following keys were added:
- schemas.GoogleCloudDialogflowV2beta1InputAudioConfig.properties.disableInterimInputTranscripts.type (Total Keys: 1)
- schemas.GoogleCloudDialogflowV2beta1SpeechToTextConfig.properties.disableInterimInputTranscripts.type (Total Keys: 1)
---
 ...2.projects.agent.environments.users.sessions.html |  2 +-
 docs/dyn/dialogflow_v2.projects.agent.sessions.html  |  2 +-
 .../dialogflow_v2.projects.conversationProfiles.html | 12 ++++++------
 docs/dyn/dialogflow_v2.projects.conversations.html   | 10 +++++-----
 ...gflow_v2.projects.conversations.participants.html |  2 +-
 ....locations.agent.environments.users.sessions.html |  2 +-
 ...logflow_v2.projects.locations.agent.sessions.html |  2 +-
 ...w_v2.projects.locations.conversationProfiles.html | 12 ++++++------
 ...alogflow_v2.projects.locations.conversations.html | 10 +++++-----
 ...rojects.locations.conversations.participants.html |  2 +-
 ...dialogflow_v2.projects.locations.suggestions.html |  2 +-
 docs/dyn/dialogflow_v2.projects.suggestions.html     |  2 +-
 ...1.projects.agent.environments.users.sessions.html |  2 +-
 .../dialogflow_v2beta1.projects.agent.sessions.html  |  2 +-
 ...ogflow_v2beta1.projects.conversationProfiles.html | 12 ++++++------
 .../dialogflow_v2beta1.projects.conversations.html   | 10 +++++-----
 ..._v2beta1.projects.conversations.participants.html |  2 +-
 ....locations.agent.environments.users.sessions.html |  2 +-
 ...ow_v2beta1.projects.locations.agent.sessions.html |  2 +-
 ...eta1.projects.locations.conversationProfiles.html | 12 ++++++------
 ...low_v2beta1.projects.locations.conversations.html | 10 +++++-----
 ...rojects.locations.conversations.participants.html |  2 +-
 ...gflow_v2beta1.projects.locations.suggestions.html |  2 +-
 .../dyn/dialogflow_v2beta1.projects.suggestions.html |  2 +-
 .../discovery_cache/documents/dialogflow.v2.json     | 11 +++++++----
 .../documents/dialogflow.v2beta1.json                | 11 +++++++----
 26 files changed, 74 insertions(+), 68 deletions(-)

diff --git a/docs/dyn/dialogflow_v2.projects.agent.environments.users.sessions.html b/docs/dyn/dialogflow_v2.projects.agent.environments.users.sessions.html
index 06800080c8..893cb25ce1 100644
--- a/docs/dyn/dialogflow_v2.projects.agent.environments.users.sessions.html
+++ b/docs/dyn/dialogflow_v2.projects.agent.environments.users.sessions.html
@@ -155,13 +155,13 @@ 
Method Details

   "queryInput": {
     "audioConfig": {
       "audioEncoding": "A String",
+      "disableInterimInputTranscripts": True or False,
       "disableNoSpeechRecognizedEvent": True or False,
       "enableAutomaticPunctuation": True or False,
       "enableVoiceActivityEvents": True or False,
       "enableWordInfo": True or False,
       "geminiAsrConfig": {
         "endOfSpeechSensitivity": "A String",
-        "modelId": "A String",
         "prefixPaddingMs": 42,
         "silenceDurationMs": 42,
         "startOfSpeechSensitivity": "A String",
diff --git a/docs/dyn/dialogflow_v2.projects.agent.sessions.html b/docs/dyn/dialogflow_v2.projects.agent.sessions.html
index d41ab5b2b7..72e4bdb8e1 100644
--- a/docs/dyn/dialogflow_v2.projects.agent.sessions.html
+++ b/docs/dyn/dialogflow_v2.projects.agent.sessions.html
@@ -155,13 +155,13 @@ 
Method Details

   "queryInput": {
     "audioConfig": {
       "audioEncoding": "A String",
+      "disableInterimInputTranscripts": True or False,
       "disableNoSpeechRecognizedEvent": True or False,
       "enableAutomaticPunctuation": True or False,
       "enableVoiceActivityEvents": True or False,
       "enableWordInfo": True or False,
       "geminiAsrConfig": {
         "endOfSpeechSensitivity": "A String",
-        "modelId": "A String",
         "prefixPaddingMs": 42,
         "silenceDurationMs": 42,
         "startOfSpeechSensitivity": "A String",
diff --git a/docs/dyn/dialogflow_v2.projects.conversationProfiles.html b/docs/dyn/dialogflow_v2.projects.conversationProfiles.html
index fea3ccf2c7..97b77a0198 100644
--- a/docs/dyn/dialogflow_v2.projects.conversationProfiles.html
+++ b/docs/dyn/dialogflow_v2.projects.conversationProfiles.html
@@ -371,10 +371,10 @@ 
Method Details

   },
   "sttConfig": {
     "audioEncoding": "A String",
+    "disableInterimInputTranscripts": True or False,
     "enableWordInfo": True or False,
     "geminiAsrConfig": {
       "endOfSpeechSensitivity": "A String",
-      "modelId": "A String",
       "prefixPaddingMs": 42,
       "silenceDurationMs": 42,
       "startOfSpeechSensitivity": "A String",
@@ -632,10 +632,10 @@ 
Method Details

   },
   "sttConfig": {
     "audioEncoding": "A String",
+    "disableInterimInputTranscripts": True or False,
     "enableWordInfo": True or False,
     "geminiAsrConfig": {
       "endOfSpeechSensitivity": "A String",
-      "modelId": "A String",
       "prefixPaddingMs": 42,
       "silenceDurationMs": 42,
       "startOfSpeechSensitivity": "A String",
@@ -918,10 +918,10 @@ 
Method Details

   },
   "sttConfig": {
     "audioEncoding": "A String",
+    "disableInterimInputTranscripts": True or False,
     "enableWordInfo": True or False,
     "geminiAsrConfig": {
       "endOfSpeechSensitivity": "A String",
-      "modelId": "A String",
       "prefixPaddingMs": 42,
       "silenceDurationMs": 42,
       "startOfSpeechSensitivity": "A String",
@@ -1190,10 +1190,10 @@ 
Method Details

       },
       "sttConfig": {
         "audioEncoding": "A String",
+        "disableInterimInputTranscripts": True or False,
         "enableWordInfo": True or False,
         "geminiAsrConfig": {
           "endOfSpeechSensitivity": "A String",
-          "modelId": "A String",
           "prefixPaddingMs": 42,
           "silenceDurationMs": 42,
           "startOfSpeechSensitivity": "A String",
@@ -1470,10 +1470,10 @@ 
Method Details

   },
   "sttConfig": {
     "audioEncoding": "A String",
+    "disableInterimInputTranscripts": True or False,
     "enableWordInfo": True or False,
     "geminiAsrConfig": {
       "endOfSpeechSensitivity": "A String",
-      "modelId": "A String",
       "prefixPaddingMs": 42,
       "silenceDurationMs": 42,
       "startOfSpeechSensitivity": "A String",
@@ -1732,10 +1732,10 @@ 
Method Details

   },
   "sttConfig": {
     "audioEncoding": "A String",
+    "disableInterimInputTranscripts": True or False,
     "enableWordInfo": True or False,
     "geminiAsrConfig": {
       "endOfSpeechSensitivity": "A String",
-      "modelId": "A String",
       "prefixPaddingMs": 42,
       "silenceDurationMs": 42,
       "startOfSpeechSensitivity": "A String",
diff --git a/docs/dyn/dialogflow_v2.projects.conversations.html b/docs/dyn/dialogflow_v2.projects.conversations.html
index 31426a57b2..3f9dc020c5 100644
--- a/docs/dyn/dialogflow_v2.projects.conversations.html
+++ b/docs/dyn/dialogflow_v2.projects.conversations.html
@@ -364,10 +364,10 @@ 
Method Details

     },
     "sttConfig": {
       "audioEncoding": "A String",
+      "disableInterimInputTranscripts": True or False,
       "enableWordInfo": True or False,
       "geminiAsrConfig": {
         "endOfSpeechSensitivity": "A String",
-        "modelId": "A String",
         "prefixPaddingMs": 42,
         "silenceDurationMs": 42,
         "startOfSpeechSensitivity": "A String",
@@ -675,10 +675,10 @@ 
Method Details

     },
     "sttConfig": {
       "audioEncoding": "A String",
+      "disableInterimInputTranscripts": True or False,
       "enableWordInfo": True or False,
       "geminiAsrConfig": {
         "endOfSpeechSensitivity": "A String",
-        "modelId": "A String",
         "prefixPaddingMs": 42,
         "silenceDurationMs": 42,
         "startOfSpeechSensitivity": "A String",
@@ -985,10 +985,10 @@ 
Method Details

     },
     "sttConfig": {
       "audioEncoding": "A String",
+      "disableInterimInputTranscripts": True or False,
       "enableWordInfo": True or False,
       "geminiAsrConfig": {
         "endOfSpeechSensitivity": "A String",
-        "modelId": "A String",
         "prefixPaddingMs": 42,
         "silenceDurationMs": 42,
         "startOfSpeechSensitivity": "A String",
@@ -1301,10 +1301,10 @@ 
Method Details

     },
     "sttConfig": {
       "audioEncoding": "A String",
+      "disableInterimInputTranscripts": True or False,
       "enableWordInfo": True or False,
       "geminiAsrConfig": {
         "endOfSpeechSensitivity": "A String",
-        "modelId": "A String",
         "prefixPaddingMs": 42,
         "silenceDurationMs": 42,
         "startOfSpeechSensitivity": "A String",
@@ -1622,10 +1622,10 @@ 
Method Details

         },
         "sttConfig": {
           "audioEncoding": "A String",
+          "disableInterimInputTranscripts": True or False,
           "enableWordInfo": True or False,
           "geminiAsrConfig": {
             "endOfSpeechSensitivity": "A String",
-            "modelId": "A String",
             "prefixPaddingMs": 42,
             "silenceDurationMs": 42,
             "startOfSpeechSensitivity": "A String",
diff --git a/docs/dyn/dialogflow_v2.projects.conversations.participants.html b/docs/dyn/dialogflow_v2.projects.conversations.participants.html
index 888968dd2d..d801b26022 100644
--- a/docs/dyn/dialogflow_v2.projects.conversations.participants.html
+++ b/docs/dyn/dialogflow_v2.projects.conversations.participants.html
@@ -120,13 +120,13 @@ 
Method Details

     "audio": "A String",
     "config": {
       "audioEncoding": "A String",
+      "disableInterimInputTranscripts": True or False,
       "disableNoSpeechRecognizedEvent": True or False,
       "enableAutomaticPunctuation": True or False,
       "enableVoiceActivityEvents": True or False,
       "enableWordInfo": True or False,
       "geminiAsrConfig": {
         "endOfSpeechSensitivity": "A String",
-        "modelId": "A String",
         "prefixPaddingMs": 42,
         "silenceDurationMs": 42,
         "startOfSpeechSensitivity": "A String",
diff --git a/docs/dyn/dialogflow_v2.projects.locations.agent.environments.users.sessions.html b/docs/dyn/dialogflow_v2.projects.locations.agent.environments.users.sessions.html
index 76da68d446..adbac5f2a8 100644
--- a/docs/dyn/dialogflow_v2.projects.locations.agent.environments.users.sessions.html
+++ b/docs/dyn/dialogflow_v2.projects.locations.agent.environments.users.sessions.html
@@ -155,13 +155,13 @@ 
Method Details

   "queryInput": {
     "audioConfig": {
       "audioEncoding": "A String",
+      "disableInterimInputTranscripts": True or False,
       "disableNoSpeechRecognizedEvent": True or False,
       "enableAutomaticPunctuation": True or False,
       "enableVoiceActivityEvents": True or False,
       "enableWordInfo": True or False,
       "geminiAsrConfig": {
         "endOfSpeechSensitivity": "A String",
-        "modelId": "A String",
         "prefixPaddingMs": 42,
         "silenceDurationMs": 42,
         "startOfSpeechSensitivity": "A String",
diff --git a/docs/dyn/dialogflow_v2.projects.locations.agent.sessions.html b/docs/dyn/dialogflow_v2.projects.locations.agent.sessions.html
index 91b91ad892..58b8f9d354 100644
--- a/docs/dyn/dialogflow_v2.projects.locations.agent.sessions.html
+++ b/docs/dyn/dialogflow_v2.projects.locations.agent.sessions.html
@@ -155,13 +155,13 @@ 
Method Details

   "queryInput": {
     "audioConfig": {
       "audioEncoding": "A String",
+      "disableInterimInputTranscripts": True or False,
       "disableNoSpeechRecognizedEvent": True or False,
       "enableAutomaticPunctuation": True or False,
       "enableVoiceActivityEvents": True or False,
       "enableWordInfo": True or False,
       "geminiAsrConfig": {
         "endOfSpeechSensitivity": "A String",
-        "modelId": "A String",
         "prefixPaddingMs": 42,
         "silenceDurationMs": 42,
         "startOfSpeechSensitivity": "A String",
diff --git a/docs/dyn/dialogflow_v2.projects.locations.conversationProfiles.html b/docs/dyn/dialogflow_v2.projects.locations.conversationProfiles.html
index aa7a4c3600..224b5ead0c 100644
--- a/docs/dyn/dialogflow_v2.projects.locations.conversationProfiles.html
+++ b/docs/dyn/dialogflow_v2.projects.locations.conversationProfiles.html
@@ -371,10 +371,10 @@ 
Method Details

   },
   "sttConfig": {
     "audioEncoding": "A String",
+    "disableInterimInputTranscripts": True or False,
     "enableWordInfo": True or False,
     "geminiAsrConfig": {
       "endOfSpeechSensitivity": "A String",
-      "modelId": "A String",
       "prefixPaddingMs": 42,
       "silenceDurationMs": 42,
       "startOfSpeechSensitivity": "A String",
@@ -632,10 +632,10 @@ 
Method Details

   },
   "sttConfig": {
     "audioEncoding": "A String",
+    "disableInterimInputTranscripts": True or False,
     "enableWordInfo": True or False,
     "geminiAsrConfig": {
       "endOfSpeechSensitivity": "A String",
-      "modelId": "A String",
       "prefixPaddingMs": 42,
       "silenceDurationMs": 42,
       "startOfSpeechSensitivity": "A String",
@@ -918,10 +918,10 @@ 
Method Details

   },
   "sttConfig": {
     "audioEncoding": "A String",
+    "disableInterimInputTranscripts": True or False,
     "enableWordInfo": True or False,
     "geminiAsrConfig": {
       "endOfSpeechSensitivity": "A String",
-      "modelId": "A String",
       "prefixPaddingMs": 42,
       "silenceDurationMs": 42,
       "startOfSpeechSensitivity": "A String",
@@ -1190,10 +1190,10 @@ 
Method Details

       },
       "sttConfig": {
         "audioEncoding": "A String",
+        "disableInterimInputTranscripts": True or False,
         "enableWordInfo": True or False,
         "geminiAsrConfig": {
           "endOfSpeechSensitivity": "A String",
-          "modelId": "A String",
           "prefixPaddingMs": 42,
           "silenceDurationMs": 42,
           "startOfSpeechSensitivity": "A String",
@@ -1470,10 +1470,10 @@ 
Method Details

   },
   "sttConfig": {
     "audioEncoding": "A String",
+    "disableInterimInputTranscripts": True or False,
     "enableWordInfo": True or False,
     "geminiAsrConfig": {
       "endOfSpeechSensitivity": "A String",
-      "modelId": "A String",
       "prefixPaddingMs": 42,
       "silenceDurationMs": 42,
       "startOfSpeechSensitivity": "A String",
@@ -1732,10 +1732,10 @@ 
Method Details

   },
   "sttConfig": {
     "audioEncoding": "A String",
+    "disableInterimInputTranscripts": True or False,
     "enableWordInfo": True or False,
     "geminiAsrConfig": {
       "endOfSpeechSensitivity": "A String",
-      "modelId": "A String",
       "prefixPaddingMs": 42,
       "silenceDurationMs": 42,
       "startOfSpeechSensitivity": "A String",
diff --git a/docs/dyn/dialogflow_v2.projects.locations.conversations.html b/docs/dyn/dialogflow_v2.projects.locations.conversations.html
index fb35ed4358..36f4d5099b 100644
--- a/docs/dyn/dialogflow_v2.projects.locations.conversations.html
+++ b/docs/dyn/dialogflow_v2.projects.locations.conversations.html
@@ -367,10 +367,10 @@ 
Method Details

     },
     "sttConfig": {
       "audioEncoding": "A String",
+      "disableInterimInputTranscripts": True or False,
       "enableWordInfo": True or False,
       "geminiAsrConfig": {
         "endOfSpeechSensitivity": "A String",
-        "modelId": "A String",
         "prefixPaddingMs": 42,
         "silenceDurationMs": 42,
         "startOfSpeechSensitivity": "A String",
@@ -678,10 +678,10 @@ 
Method Details

     },
     "sttConfig": {
       "audioEncoding": "A String",
+      "disableInterimInputTranscripts": True or False,
       "enableWordInfo": True or False,
       "geminiAsrConfig": {
         "endOfSpeechSensitivity": "A String",
-        "modelId": "A String",
         "prefixPaddingMs": 42,
         "silenceDurationMs": 42,
         "startOfSpeechSensitivity": "A String",
@@ -988,10 +988,10 @@ 
Method Details

     },
     "sttConfig": {
       "audioEncoding": "A String",
+      "disableInterimInputTranscripts": True or False,
       "enableWordInfo": True or False,
       "geminiAsrConfig": {
         "endOfSpeechSensitivity": "A String",
-        "modelId": "A String",
         "prefixPaddingMs": 42,
         "silenceDurationMs": 42,
         "startOfSpeechSensitivity": "A String",
@@ -1304,10 +1304,10 @@ 
Method Details

     },
     "sttConfig": {
       "audioEncoding": "A String",
+      "disableInterimInputTranscripts": True or False,
       "enableWordInfo": True or False,
       "geminiAsrConfig": {
         "endOfSpeechSensitivity": "A String",
-        "modelId": "A String",
         "prefixPaddingMs": 42,
         "silenceDurationMs": 42,
         "startOfSpeechSensitivity": "A String",
@@ -1679,10 +1679,10 @@ 
Method Details

         },
         "sttConfig": {
           "audioEncoding": "A String",
+          "disableInterimInputTranscripts": True or False,
           "enableWordInfo": True or False,
           "geminiAsrConfig": {
             "endOfSpeechSensitivity": "A String",
-            "modelId": "A String",
             "prefixPaddingMs": 42,
             "silenceDurationMs": 42,
             "startOfSpeechSensitivity": "A String",
diff --git a/docs/dyn/dialogflow_v2.projects.locations.conversations.participants.html b/docs/dyn/dialogflow_v2.projects.locations.conversations.participants.html
index e327d2c1de..d539920bf0 100644
--- a/docs/dyn/dialogflow_v2.projects.locations.conversations.participants.html
+++ b/docs/dyn/dialogflow_v2.projects.locations.conversations.participants.html
@@ -120,13 +120,13 @@ 
Method Details

     "audio": "A String",
     "config": {
       "audioEncoding": "A String",
+      "disableInterimInputTranscripts": True or False,
       "disableNoSpeechRecognizedEvent": True or False,
       "enableAutomaticPunctuation": True or False,
       "enableVoiceActivityEvents": True or False,
       "enableWordInfo": True or False,
       "geminiAsrConfig": {
         "endOfSpeechSensitivity": "A String",
-        "modelId": "A String",
         "prefixPaddingMs": 42,
         "silenceDurationMs": 42,
         "startOfSpeechSensitivity": "A String",
diff --git a/docs/dyn/dialogflow_v2.projects.locations.suggestions.html b/docs/dyn/dialogflow_v2.projects.locations.suggestions.html
index 2171f31e4d..ef89c8ef40 100644
--- a/docs/dyn/dialogflow_v2.projects.locations.suggestions.html
+++ b/docs/dyn/dialogflow_v2.projects.locations.suggestions.html
@@ -311,10 +311,10 @@ 
Method Details

     },
     "sttConfig": {
       "audioEncoding": "A String",
+      "disableInterimInputTranscripts": True or False,
       "enableWordInfo": True or False,
       "geminiAsrConfig": {
         "endOfSpeechSensitivity": "A String",
-        "modelId": "A String",
         "prefixPaddingMs": 42,
         "silenceDurationMs": 42,
         "startOfSpeechSensitivity": "A String",
diff --git a/docs/dyn/dialogflow_v2.projects.suggestions.html b/docs/dyn/dialogflow_v2.projects.suggestions.html
index 1737af8b1e..11ddb288ac 100644
--- a/docs/dyn/dialogflow_v2.projects.suggestions.html
+++ b/docs/dyn/dialogflow_v2.projects.suggestions.html
@@ -311,10 +311,10 @@ 
Method Details

     },
     "sttConfig": {
       "audioEncoding": "A String",
+      "disableInterimInputTranscripts": True or False,
       "enableWordInfo": True or False,
       "geminiAsrConfig": {
         "endOfSpeechSensitivity": "A String",
-        "modelId": "A String",
         "prefixPaddingMs": 42,
         "silenceDurationMs": 42,
         "startOfSpeechSensitivity": "A String",
diff --git a/docs/dyn/dialogflow_v2beta1.projects.agent.environments.users.sessions.html b/docs/dyn/dialogflow_v2beta1.projects.agent.environments.users.sessions.html
index fa52cac0bb..25c734c9fd 100644
--- a/docs/dyn/dialogflow_v2beta1.projects.agent.environments.users.sessions.html
+++ b/docs/dyn/dialogflow_v2beta1.projects.agent.environments.users.sessions.html
@@ -160,13 +160,13 @@ 
Method Details

         "totalDuration": "A String",
       },
       "defaultNoSpeechTimeout": "A String",
+      "disableInterimInputTranscripts": True or False,
       "disableNoSpeechRecognizedEvent": True or False,
       "enableAutomaticPunctuation": True or False,
       "enableVoiceActivityEvents": True or False,
       "enableWordInfo": True or False,
       "geminiAsrConfig": {
         "endOfSpeechSensitivity": "A String",
-        "modelId": "A String",
         "prefixPaddingMs": 42,
         "silenceDurationMs": 42,
         "startOfSpeechSensitivity": "A String",
diff --git a/docs/dyn/dialogflow_v2beta1.projects.agent.sessions.html b/docs/dyn/dialogflow_v2beta1.projects.agent.sessions.html
index 5c00932d6a..7d087b20a2 100644
--- a/docs/dyn/dialogflow_v2beta1.projects.agent.sessions.html
+++ b/docs/dyn/dialogflow_v2beta1.projects.agent.sessions.html
@@ -160,13 +160,13 @@ 
Method Details

         "totalDuration": "A String",
       },
       "defaultNoSpeechTimeout": "A String",
+      "disableInterimInputTranscripts": True or False,
       "disableNoSpeechRecognizedEvent": True or False,
       "enableAutomaticPunctuation": True or False,
       "enableVoiceActivityEvents": True or False,
       "enableWordInfo": True or False,
       "geminiAsrConfig": {
         "endOfSpeechSensitivity": "A String",
-        "modelId": "A String",
         "prefixPaddingMs": 42,
         "silenceDurationMs": 42,
         "startOfSpeechSensitivity": "A String",
diff --git a/docs/dyn/dialogflow_v2beta1.projects.conversationProfiles.html b/docs/dyn/dialogflow_v2beta1.projects.conversationProfiles.html
index 5a3a1b76d0..16cd111a48 100644
--- a/docs/dyn/dialogflow_v2beta1.projects.conversationProfiles.html
+++ b/docs/dyn/dialogflow_v2beta1.projects.conversationProfiles.html
@@ -363,10 +363,10 @@ 
Method Details

   },
   "sttConfig": {
     "audioEncoding": "A String",
+    "disableInterimInputTranscripts": True or False,
     "enableWordInfo": True or False,
     "geminiAsrConfig": {
       "endOfSpeechSensitivity": "A String",
-      "modelId": "A String",
       "prefixPaddingMs": 42,
       "silenceDurationMs": 42,
       "startOfSpeechSensitivity": "A String",
@@ -617,10 +617,10 @@ 
Method Details

   },
   "sttConfig": {
     "audioEncoding": "A String",
+    "disableInterimInputTranscripts": True or False,
     "enableWordInfo": True or False,
     "geminiAsrConfig": {
       "endOfSpeechSensitivity": "A String",
-      "modelId": "A String",
       "prefixPaddingMs": 42,
       "silenceDurationMs": 42,
       "startOfSpeechSensitivity": "A String",
@@ -896,10 +896,10 @@ 
Method Details

   },
   "sttConfig": {
     "audioEncoding": "A String",
+    "disableInterimInputTranscripts": True or False,
     "enableWordInfo": True or False,
     "geminiAsrConfig": {
       "endOfSpeechSensitivity": "A String",
-      "modelId": "A String",
       "prefixPaddingMs": 42,
       "silenceDurationMs": 42,
       "startOfSpeechSensitivity": "A String",
@@ -1161,10 +1161,10 @@ 
Method Details

       },
       "sttConfig": {
         "audioEncoding": "A String",
+        "disableInterimInputTranscripts": True or False,
         "enableWordInfo": True or False,
         "geminiAsrConfig": {
           "endOfSpeechSensitivity": "A String",
-          "modelId": "A String",
           "prefixPaddingMs": 42,
           "silenceDurationMs": 42,
           "startOfSpeechSensitivity": "A String",
@@ -1434,10 +1434,10 @@ 
Method Details

   },
   "sttConfig": {
     "audioEncoding": "A String",
+    "disableInterimInputTranscripts": True or False,
     "enableWordInfo": True or False,
     "geminiAsrConfig": {
       "endOfSpeechSensitivity": "A String",
-      "modelId": "A String",
       "prefixPaddingMs": 42,
       "silenceDurationMs": 42,
       "startOfSpeechSensitivity": "A String",
@@ -1689,10 +1689,10 @@ 
Method Details

   },
   "sttConfig": {
     "audioEncoding": "A String",
+    "disableInterimInputTranscripts": True or False,
     "enableWordInfo": True or False,
     "geminiAsrConfig": {
       "endOfSpeechSensitivity": "A String",
-      "modelId": "A String",
       "prefixPaddingMs": 42,
       "silenceDurationMs": 42,
       "startOfSpeechSensitivity": "A String",
diff --git a/docs/dyn/dialogflow_v2beta1.projects.conversations.html b/docs/dyn/dialogflow_v2beta1.projects.conversations.html
index abad93b863..f7fb1f1c7f 100644
--- a/docs/dyn/dialogflow_v2beta1.projects.conversations.html
+++ b/docs/dyn/dialogflow_v2beta1.projects.conversations.html
@@ -356,10 +356,10 @@ 
Method Details

     },
     "sttConfig": {
       "audioEncoding": "A String",
+      "disableInterimInputTranscripts": True or False,
       "enableWordInfo": True or False,
       "geminiAsrConfig": {
         "endOfSpeechSensitivity": "A String",
-        "modelId": "A String",
         "prefixPaddingMs": 42,
         "silenceDurationMs": 42,
         "startOfSpeechSensitivity": "A String",
@@ -660,10 +660,10 @@ 
Method Details

     },
     "sttConfig": {
       "audioEncoding": "A String",
+      "disableInterimInputTranscripts": True or False,
       "enableWordInfo": True or False,
       "geminiAsrConfig": {
         "endOfSpeechSensitivity": "A String",
-        "modelId": "A String",
         "prefixPaddingMs": 42,
         "silenceDurationMs": 42,
         "startOfSpeechSensitivity": "A String",
@@ -963,10 +963,10 @@ 
Method Details

     },
     "sttConfig": {
       "audioEncoding": "A String",
+      "disableInterimInputTranscripts": True or False,
       "enableWordInfo": True or False,
       "geminiAsrConfig": {
         "endOfSpeechSensitivity": "A String",
-        "modelId": "A String",
         "prefixPaddingMs": 42,
         "silenceDurationMs": 42,
         "startOfSpeechSensitivity": "A String",
@@ -1272,10 +1272,10 @@ 
Method Details

     },
     "sttConfig": {
       "audioEncoding": "A String",
+      "disableInterimInputTranscripts": True or False,
       "enableWordInfo": True or False,
       "geminiAsrConfig": {
         "endOfSpeechSensitivity": "A String",
-        "modelId": "A String",
         "prefixPaddingMs": 42,
         "silenceDurationMs": 42,
         "startOfSpeechSensitivity": "A String",
@@ -1586,10 +1586,10 @@ 
Method Details

         },
         "sttConfig": {
           "audioEncoding": "A String",
+          "disableInterimInputTranscripts": True or False,
           "enableWordInfo": True or False,
           "geminiAsrConfig": {
             "endOfSpeechSensitivity": "A String",
-            "modelId": "A String",
             "prefixPaddingMs": 42,
             "silenceDurationMs": 42,
             "startOfSpeechSensitivity": "A String",
diff --git a/docs/dyn/dialogflow_v2beta1.projects.conversations.participants.html b/docs/dyn/dialogflow_v2beta1.projects.conversations.participants.html
index b524e0e111..14e4f299d4 100644
--- a/docs/dyn/dialogflow_v2beta1.projects.conversations.participants.html
+++ b/docs/dyn/dialogflow_v2beta1.projects.conversations.participants.html
@@ -125,13 +125,13 @@ 
Method Details

         "totalDuration": "A String",
       },
       "defaultNoSpeechTimeout": "A String",
+      "disableInterimInputTranscripts": True or False,
       "disableNoSpeechRecognizedEvent": True or False,
       "enableAutomaticPunctuation": True or False,
       "enableVoiceActivityEvents": True or False,
       "enableWordInfo": True or False,
       "geminiAsrConfig": {
         "endOfSpeechSensitivity": "A String",
-        "modelId": "A String",
         "prefixPaddingMs": 42,
         "silenceDurationMs": 42,
         "startOfSpeechSensitivity": "A String",
diff --git a/docs/dyn/dialogflow_v2beta1.projects.locations.agent.environments.users.sessions.html b/docs/dyn/dialogflow_v2beta1.projects.locations.agent.environments.users.sessions.html
index 0d58d7986d..fd5b1d5cf7 100644
--- a/docs/dyn/dialogflow_v2beta1.projects.locations.agent.environments.users.sessions.html
+++ b/docs/dyn/dialogflow_v2beta1.projects.locations.agent.environments.users.sessions.html
@@ -160,13 +160,13 @@ 
Method Details

         "totalDuration": "A String",
       },
       "defaultNoSpeechTimeout": "A String",
+      "disableInterimInputTranscripts": True or False,
       "disableNoSpeechRecognizedEvent": True or False,
       "enableAutomaticPunctuation": True or False,
       "enableVoiceActivityEvents": True or False,
       "enableWordInfo": True or False,
       "geminiAsrConfig": {
         "endOfSpeechSensitivity": "A String",
-        "modelId": "A String",
         "prefixPaddingMs": 42,
         "silenceDurationMs": 42,
         "startOfSpeechSensitivity": "A String",
diff --git a/docs/dyn/dialogflow_v2beta1.projects.locations.agent.sessions.html b/docs/dyn/dialogflow_v2beta1.projects.locations.agent.sessions.html
index 6f79463a61..2538ee6cd8 100644
--- a/docs/dyn/dialogflow_v2beta1.projects.locations.agent.sessions.html
+++ b/docs/dyn/dialogflow_v2beta1.projects.locations.agent.sessions.html
@@ -160,13 +160,13 @@ 
Method Details

         "totalDuration": "A String",
       },
       "defaultNoSpeechTimeout": "A String",
+      "disableInterimInputTranscripts": True or False,
       "disableNoSpeechRecognizedEvent": True or False,
       "enableAutomaticPunctuation": True or False,
       "enableVoiceActivityEvents": True or False,
       "enableWordInfo": True or False,
       "geminiAsrConfig": {
         "endOfSpeechSensitivity": "A String",
-        "modelId": "A String",
         "prefixPaddingMs": 42,
         "silenceDurationMs": 42,
         "startOfSpeechSensitivity": "A String",
diff --git a/docs/dyn/dialogflow_v2beta1.projects.locations.conversationProfiles.html b/docs/dyn/dialogflow_v2beta1.projects.locations.conversationProfiles.html
index e724cc4624..d498c84499 100644
--- a/docs/dyn/dialogflow_v2beta1.projects.locations.conversationProfiles.html
+++ b/docs/dyn/dialogflow_v2beta1.projects.locations.conversationProfiles.html
@@ -363,10 +363,10 @@ 
Method Details

   },
   "sttConfig": {
     "audioEncoding": "A String",
+    "disableInterimInputTranscripts": True or False,
     "enableWordInfo": True or False,
     "geminiAsrConfig": {
       "endOfSpeechSensitivity": "A String",
-      "modelId": "A String",
       "prefixPaddingMs": 42,
       "silenceDurationMs": 42,
       "startOfSpeechSensitivity": "A String",
@@ -617,10 +617,10 @@ 
Method Details

   },
   "sttConfig": {
     "audioEncoding": "A String",
+    "disableInterimInputTranscripts": True or False,
     "enableWordInfo": True or False,
     "geminiAsrConfig": {
       "endOfSpeechSensitivity": "A String",
-      "modelId": "A String",
       "prefixPaddingMs": 42,
       "silenceDurationMs": 42,
       "startOfSpeechSensitivity": "A String",
@@ -896,10 +896,10 @@ 
Method Details

   },
   "sttConfig": {
     "audioEncoding": "A String",
+    "disableInterimInputTranscripts": True or False,
     "enableWordInfo": True or False,
     "geminiAsrConfig": {
       "endOfSpeechSensitivity": "A String",
-      "modelId": "A String",
       "prefixPaddingMs": 42,
       "silenceDurationMs": 42,
       "startOfSpeechSensitivity": "A String",
@@ -1161,10 +1161,10 @@ 
Method Details

       },
       "sttConfig": {
         "audioEncoding": "A String",
+        "disableInterimInputTranscripts": True or False,
         "enableWordInfo": True or False,
         "geminiAsrConfig": {
           "endOfSpeechSensitivity": "A String",
-          "modelId": "A String",
           "prefixPaddingMs": 42,
           "silenceDurationMs": 42,
           "startOfSpeechSensitivity": "A String",
@@ -1434,10 +1434,10 @@ 
Method Details

   },
   "sttConfig": {
     "audioEncoding": "A String",
+    "disableInterimInputTranscripts": True or False,
     "enableWordInfo": True or False,
     "geminiAsrConfig": {
       "endOfSpeechSensitivity": "A String",
-      "modelId": "A String",
       "prefixPaddingMs": 42,
       "silenceDurationMs": 42,
       "startOfSpeechSensitivity": "A String",
@@ -1689,10 +1689,10 @@ 
Method Details

   },
   "sttConfig": {
     "audioEncoding": "A String",
+    "disableInterimInputTranscripts": True or False,
     "enableWordInfo": True or False,
     "geminiAsrConfig": {
       "endOfSpeechSensitivity": "A String",
-      "modelId": "A String",
       "prefixPaddingMs": 42,
       "silenceDurationMs": 42,
       "startOfSpeechSensitivity": "A String",
diff --git a/docs/dyn/dialogflow_v2beta1.projects.locations.conversations.html b/docs/dyn/dialogflow_v2beta1.projects.locations.conversations.html
index c187f81770..16d5fa4106 100644
--- a/docs/dyn/dialogflow_v2beta1.projects.locations.conversations.html
+++ b/docs/dyn/dialogflow_v2beta1.projects.locations.conversations.html
@@ -359,10 +359,10 @@ 
Method Details

     },
     "sttConfig": {
       "audioEncoding": "A String",
+      "disableInterimInputTranscripts": True or False,
       "enableWordInfo": True or False,
       "geminiAsrConfig": {
         "endOfSpeechSensitivity": "A String",
-        "modelId": "A String",
         "prefixPaddingMs": 42,
         "silenceDurationMs": 42,
         "startOfSpeechSensitivity": "A String",
@@ -663,10 +663,10 @@ 
Method Details

     },
     "sttConfig": {
       "audioEncoding": "A String",
+      "disableInterimInputTranscripts": True or False,
       "enableWordInfo": True or False,
       "geminiAsrConfig": {
         "endOfSpeechSensitivity": "A String",
-        "modelId": "A String",
         "prefixPaddingMs": 42,
         "silenceDurationMs": 42,
         "startOfSpeechSensitivity": "A String",
@@ -966,10 +966,10 @@ 
Method Details

     },
     "sttConfig": {
       "audioEncoding": "A String",
+      "disableInterimInputTranscripts": True or False,
       "enableWordInfo": True or False,
       "geminiAsrConfig": {
         "endOfSpeechSensitivity": "A String",
-        "modelId": "A String",
         "prefixPaddingMs": 42,
         "silenceDurationMs": 42,
         "startOfSpeechSensitivity": "A String",
@@ -1275,10 +1275,10 @@ 
Method Details

     },
     "sttConfig": {
       "audioEncoding": "A String",
+      "disableInterimInputTranscripts": True or False,
       "enableWordInfo": True or False,
       "geminiAsrConfig": {
         "endOfSpeechSensitivity": "A String",
-        "modelId": "A String",
         "prefixPaddingMs": 42,
         "silenceDurationMs": 42,
         "startOfSpeechSensitivity": "A String",
@@ -1643,10 +1643,10 @@ 
Method Details

         },
         "sttConfig": {
           "audioEncoding": "A String",
+          "disableInterimInputTranscripts": True or False,
           "enableWordInfo": True or False,
           "geminiAsrConfig": {
             "endOfSpeechSensitivity": "A String",
-            "modelId": "A String",
             "prefixPaddingMs": 42,
             "silenceDurationMs": 42,
             "startOfSpeechSensitivity": "A String",
diff --git a/docs/dyn/dialogflow_v2beta1.projects.locations.conversations.participants.html b/docs/dyn/dialogflow_v2beta1.projects.locations.conversations.participants.html
index 4ae69fc567..e1193a4995 100644
--- a/docs/dyn/dialogflow_v2beta1.projects.locations.conversations.participants.html
+++ b/docs/dyn/dialogflow_v2beta1.projects.locations.conversations.participants.html
@@ -125,13 +125,13 @@ 
Method Details

         "totalDuration": "A String",
       },
       "defaultNoSpeechTimeout": "A String",
+      "disableInterimInputTranscripts": True or False,
       "disableNoSpeechRecognizedEvent": True or False,
       "enableAutomaticPunctuation": True or False,
       "enableVoiceActivityEvents": True or False,
       "enableWordInfo": True or False,
       "geminiAsrConfig": {
         "endOfSpeechSensitivity": "A String",
-        "modelId": "A String",
         "prefixPaddingMs": 42,
         "silenceDurationMs": 42,
         "startOfSpeechSensitivity": "A String",
diff --git a/docs/dyn/dialogflow_v2beta1.projects.locations.suggestions.html b/docs/dyn/dialogflow_v2beta1.projects.locations.suggestions.html
index 393f859a89..91df8467c8 100644
--- a/docs/dyn/dialogflow_v2beta1.projects.locations.suggestions.html
+++ b/docs/dyn/dialogflow_v2beta1.projects.locations.suggestions.html
@@ -303,10 +303,10 @@ 
Method Details

     },
     "sttConfig": {
       "audioEncoding": "A String",
+      "disableInterimInputTranscripts": True or False,
       "enableWordInfo": True or False,
       "geminiAsrConfig": {
         "endOfSpeechSensitivity": "A String",
-        "modelId": "A String",
         "prefixPaddingMs": 42,
         "silenceDurationMs": 42,
         "startOfSpeechSensitivity": "A String",
diff --git a/docs/dyn/dialogflow_v2beta1.projects.suggestions.html b/docs/dyn/dialogflow_v2beta1.projects.suggestions.html
index a8375c1e7d..749af48452 100644
--- a/docs/dyn/dialogflow_v2beta1.projects.suggestions.html
+++ b/docs/dyn/dialogflow_v2beta1.projects.suggestions.html
@@ -303,10 +303,10 @@ 
Method Details

     },
     "sttConfig": {
       "audioEncoding": "A String",
+      "disableInterimInputTranscripts": True or False,
       "enableWordInfo": True or False,
       "geminiAsrConfig": {
         "endOfSpeechSensitivity": "A String",
-        "modelId": "A String",
         "prefixPaddingMs": 42,
         "silenceDurationMs": 42,
         "startOfSpeechSensitivity": "A String",
diff --git a/googleapiclient/discovery_cache/documents/dialogflow.v2.json b/googleapiclient/discovery_cache/documents/dialogflow.v2.json
index 30995a5290..b06a64ee8f 100644
--- a/googleapiclient/discovery_cache/documents/dialogflow.v2.json
+++ b/googleapiclient/discovery_cache/documents/dialogflow.v2.json
@@ -8933,7 +8933,7 @@
 }
 }
 },
-"revision": "20260929",
+"revision": "20261015",
 "rootUrl": "https://dialogflow.googleapis.com/",
 "schemas": {
 "GoogleCloudDialogflowCxV3AdvancedSettings": {
@@ -16716,6 +16716,9 @@ true
 ],
 "type": "string"
 },
+"disableInterimInputTranscripts": {
+"type": "boolean"
+},
 "disableNoSpeechRecognizedEvent": {
 "type": "boolean"
 },
@@ -19584,6 +19587,9 @@ false
 ],
 "type": "string"
 },
+"disableInterimInputTranscripts": {
+"type": "boolean"
+},
 "enableWordInfo": {
 "type": "boolean"
 },
@@ -19646,9 +19652,6 @@ false
 ],
 "type": "string"
 },
-"modelId": {
-"type": "string"
-},
 "prefixPaddingMs": {
 "format": "int32",
 "type": "integer"
diff --git a/googleapiclient/discovery_cache/documents/dialogflow.v2beta1.json b/googleapiclient/discovery_cache/documents/dialogflow.v2beta1.json
index 025223f9f0..6e249a9f10 100644
--- a/googleapiclient/discovery_cache/documents/dialogflow.v2beta1.json
+++ b/googleapiclient/discovery_cache/documents/dialogflow.v2beta1.json
@@ -8584,7 +8584,7 @@
 }
 }
 },
-"revision": "20260929",
+"revision": "20261015",
 "rootUrl": "https://dialogflow.googleapis.com/",
 "schemas": {
 "GoogleCloudDialogflowCxV3AdvancedSettings": {
@@ -19123,6 +19123,9 @@ true
 "format": "google-duration",
 "type": "string"
 },
+"disableInterimInputTranscripts": {
+"type": "boolean"
+},
 "disableNoSpeechRecognizedEvent": {
 "type": "boolean"
 },
@@ -22385,6 +22388,9 @@ false
 ],
 "type": "string"
 },
+"disableInterimInputTranscripts": {
+"type": "boolean"
+},
 "enableWordInfo": {
 "type": "boolean"
 },
@@ -22447,9 +22453,6 @@ false
 ],
 "type": "string"
 },
-"modelId": {
-"type": "string"
-},
 "prefixPaddingMs": {
 "format": "int32",
 "type": "integer"

From f50f5d902327be81cc16772a822d717d3af636a7 Mon Sep 17 00:00:00 2001
From: Yoshi Automation 
Date: Tue, 20 Oct 2026 07:24:01 +0000
Subject: [PATCH 16/34] feat(discoveryengine): update the api

#### discoveryengine:v1

The following keys were added:
- schemas.GoogleCloudDiscoveryengineV1DataStoreFederatedSearchConfigNotebooklmConfig.properties.notebooks (Total Keys: 2)
- schemas.GoogleCloudDiscoveryengineV1FeedbackConversationInfo.properties.stepSeqNum (Total Keys: 2)
- schemas.GoogleCloudDiscoveryengineV1FeedbackConversationInfo.properties.trajectoryId.type (Total Keys: 1)
- schemas.GoogleCloudDiscoveryengineV1alphaDataStoreFederatedSearchConfigNotebooklmConfig.properties.notebooks (Total Keys: 2)
- schemas.GoogleCloudDiscoveryengineV1alphaFieldConfig.properties.partialMatchableOption.type (Total Keys: 1)
- schemas.GoogleCloudDiscoveryengineV1alphaFieldConfig.properties.prefixMatchableOption.type (Total Keys: 1)
- schemas.GoogleCloudDiscoveryengineV1betaDataStoreFederatedSearchConfigNotebooklmConfig.properties.notebooks (Total Keys: 2)

#### discoveryengine:v1alpha

The following keys were deleted:
- resources.projects.resources.locations.resources.collections.resources.engines.resources.assistants.resources.agents.resources.toolCalls.resources.operations.methods.get (Total Keys: 11)
- resources.projects.resources.locations.resources.collections.resources.engines.resources.collaborativeProjects.resources.knowledgeSpaces.resources.operations.methods.get (Total Keys: 11)

The following keys were added:
- resources.projects.resources.locations.resources.knowledgeSpaces.resources.operations.methods.get (Total Keys: 11)
- schemas.GoogleCloudDiscoveryengineV1DataStoreFederatedSearchConfigNotebooklmConfig.properties.notebooks (Total Keys: 2)
- schemas.GoogleCloudDiscoveryengineV1alphaAuthorizationServerSideOAuth2.properties.privateNetworkConfig.$ref (Total Keys: 1)
- schemas.GoogleCloudDiscoveryengineV1alphaAuthorizationServerSideOAuth2PrivateNetworkConfig (Total Keys: 3)
- schemas.GoogleCloudDiscoveryengineV1alphaDataStoreFederatedSearchConfigNotebooklmConfig.properties.notebooks (Total Keys: 2)
- schemas.GoogleCloudDiscoveryengineV1alphaFeedbackConversationInfo.properties.stepSeqNum (Total Keys: 2)
- schemas.GoogleCloudDiscoveryengineV1alphaFeedbackConversationInfo.properties.trajectoryId.type (Total Keys: 1)
- schemas.GoogleCloudDiscoveryengineV1alphaFieldConfig.properties.partialMatchableOption.type (Total Keys: 1)
- schemas.GoogleCloudDiscoveryengineV1alphaFieldConfig.properties.prefixMatchableOption.type (Total Keys: 1)
- schemas.GoogleCloudDiscoveryengineV1betaDataStoreFederatedSearchConfigNotebooklmConfig.properties.notebooks (Total Keys: 2)

#### discoveryengine:v1beta

The following keys were added:
- schemas.GoogleCloudDiscoveryengineV1DataStoreFederatedSearchConfigNotebooklmConfig.properties.notebooks (Total Keys: 2)
- schemas.GoogleCloudDiscoveryengineV1alphaDataStoreFederatedSearchConfigNotebooklmConfig.properties.notebooks (Total Keys: 2)
- schemas.GoogleCloudDiscoveryengineV1alphaFieldConfig.properties.partialMatchableOption.type (Total Keys: 1)
- schemas.GoogleCloudDiscoveryengineV1alphaFieldConfig.properties.prefixMatchableOption.type (Total Keys: 1)
- schemas.GoogleCloudDiscoveryengineV1betaDataStoreFederatedSearchConfigNotebooklmConfig.properties.notebooks (Total Keys: 2)
- schemas.GoogleCloudDiscoveryengineV1betaFeedbackConversationInfo.properties.stepSeqNum (Total Keys: 2)
- schemas.GoogleCloudDiscoveryengineV1betaFeedbackConversationInfo.properties.trajectoryId.type (Total Keys: 1)
---
 ...ects.locations.collections.dataStores.html |  15 ++
 ...collections.dataStores.servingConfigs.html |   8 +-
 ...ons.collections.dataStores.userEvents.html |  12 +-
 ....collections.dataStores.widgetConfigs.html |   6 +-
 ...rojects.locations.collections.engines.html |  10 +-
 ...ns.collections.engines.servingConfigs.html |   8 +-
 ...ons.collections.engines.widgetConfigs.html |   6 +-
 ...gine_v1.projects.locations.dataStores.html |  15 ++
 ...s.locations.dataStores.servingConfigs.html |   8 +-
 ...jects.locations.dataStores.userEvents.html |  12 +-
 ...ts.locations.dataStores.widgetConfigs.html |   6 +-
 ...gine_v1.projects.locations.userEvents.html |  12 +-
 ...pha.projects.locations.authorizations.html |  18 ++
 ...ects.locations.collections.dataStores.html |  25 +++
 ...ations.collections.dataStores.schemas.html |   8 +
 ...collections.dataStores.servingConfigs.html |   8 +-
 ...ons.collections.dataStores.userEvents.html |  12 +-
 ....collections.dataStores.widgetConfigs.html |   6 +-
 ...collections.engines.assistants.agents.html |   5 -
 ...rojects.locations.collections.engines.html |  19 +-
 ...ns.collections.engines.servingConfigs.html |   8 +-
 ...ons.collections.engines.widgetConfigs.html |   6 +-
 ...1alpha.projects.locations.collections.html |  12 +
 ...v1alpha.projects.locations.dataStores.html |  25 +++
 ...projects.locations.dataStores.schemas.html |   8 +
 ...s.locations.dataStores.servingConfigs.html |   8 +-
 ...jects.locations.dataStores.userEvents.html |  12 +-
 ...ts.locations.dataStores.widgetConfigs.html |   6 +-
 ...1alpha.projects.locations.evaluations.html |   6 +-
 ...veryengine_v1alpha.projects.locations.html |   9 +
 ...ha.projects.locations.knowledgeSpaces.html |  91 ++++++++
 ....locations.knowledgeSpaces.operations.html | 124 ++++++++++
 ...v1alpha.projects.locations.userEvents.html |  12 +-
 ...ects.locations.collections.dataStores.html |  15 ++
 ...collections.dataStores.servingConfigs.html |   8 +-
 ...ons.collections.dataStores.userEvents.html |  12 +-
 ...rojects.locations.collections.engines.html |  14 +-
 ...ns.collections.engines.servingConfigs.html |   8 +-
 ..._v1beta.projects.locations.dataStores.html |  15 ++
 ...s.locations.dataStores.servingConfigs.html |   8 +-
 ...jects.locations.dataStores.userEvents.html |  12 +-
 ...v1beta.projects.locations.evaluations.html |   6 +-
 ..._v1beta.projects.locations.userEvents.html |  12 +-
 .../documents/discoveryengine.v1.json         |  88 ++++++--
 .../documents/discoveryengine.v1alpha.json    | 212 ++++++++++--------
 .../documents/discoveryengine.v1beta.json     |  84 ++++++-
 46 files changed, 819 insertions(+), 221 deletions(-)
 create mode 100644 docs/dyn/discoveryengine_v1alpha.projects.locations.knowledgeSpaces.html
 create mode 100644 docs/dyn/discoveryengine_v1alpha.projects.locations.knowledgeSpaces.operations.html

diff --git a/docs/dyn/discoveryengine_v1.projects.locations.collections.dataStores.html b/docs/dyn/discoveryengine_v1.projects.locations.collections.dataStores.html
index 1f4b1dbfa3..26488a8b3e 100644
--- a/docs/dyn/discoveryengine_v1.projects.locations.collections.dataStores.html
+++ b/docs/dyn/discoveryengine_v1.projects.locations.collections.dataStores.html
@@ -355,6 +355,9 @@ 
Method Details

       ],
     },
     "notebooklmConfig": { # Config for connecting to NotebookLM Enterprise. # NotebookLM config. If set, this DataStore is connected to NotebookLM Enterprise.
+      "notebooks": [ # Optional. Restricts this data store to the given notebooks. When empty, the data store covers every notebook the querying user can access, which is the existing behaviour. Each entry is a full notebook resource name, such as `projects/*/locations/*/notebooks/*`. Scoping is enforced on results as well as requested upstream, so a notebook outside this list cannot appear in a search response through this data store even if the backend returns one.
+        "A String",
+      ],
       "searchConfig": "A String", # Required. Search config name. Format: projects/*/locations/global/notebookLmSearchConfigs/*
     },
     "thirdPartyOauthConfig": { # Stores information for third party applicationOAuth. # Third Party OAuth config. If set, this DataStore is connected to a third party application.
@@ -605,6 +608,9 @@ 
Method Details

       ],
     },
     "notebooklmConfig": { # Config for connecting to NotebookLM Enterprise. # NotebookLM config. If set, this DataStore is connected to NotebookLM Enterprise.
+      "notebooks": [ # Optional. Restricts this data store to the given notebooks. When empty, the data store covers every notebook the querying user can access, which is the existing behaviour. Each entry is a full notebook resource name, such as `projects/*/locations/*/notebooks/*`. Scoping is enforced on results as well as requested upstream, so a notebook outside this list cannot appear in a search response through this data store even if the backend returns one.
+        "A String",
+      ],
       "searchConfig": "A String", # Required. Search config name. Format: projects/*/locations/global/notebookLmSearchConfigs/*
     },
     "thirdPartyOauthConfig": { # Stores information for third party applicationOAuth. # Third Party OAuth config. If set, this DataStore is connected to a third party application.
@@ -846,6 +852,9 @@ 
Method Details

           ],
         },
         "notebooklmConfig": { # Config for connecting to NotebookLM Enterprise. # NotebookLM config. If set, this DataStore is connected to NotebookLM Enterprise.
+          "notebooks": [ # Optional. Restricts this data store to the given notebooks. When empty, the data store covers every notebook the querying user can access, which is the existing behaviour. Each entry is a full notebook resource name, such as `projects/*/locations/*/notebooks/*`. Scoping is enforced on results as well as requested upstream, so a notebook outside this list cannot appear in a search response through this data store even if the backend returns one.
+            "A String",
+          ],
           "searchConfig": "A String", # Required. Search config name. Format: projects/*/locations/global/notebookLmSearchConfigs/*
         },
         "thirdPartyOauthConfig": { # Stores information for third party applicationOAuth. # Third Party OAuth config. If set, this DataStore is connected to a third party application.
@@ -1040,6 +1049,9 @@ 
Method Details

       ],
     },
     "notebooklmConfig": { # Config for connecting to NotebookLM Enterprise. # NotebookLM config. If set, this DataStore is connected to NotebookLM Enterprise.
+      "notebooks": [ # Optional. Restricts this data store to the given notebooks. When empty, the data store covers every notebook the querying user can access, which is the existing behaviour. Each entry is a full notebook resource name, such as `projects/*/locations/*/notebooks/*`. Scoping is enforced on results as well as requested upstream, so a notebook outside this list cannot appear in a search response through this data store even if the backend returns one.
+        "A String",
+      ],
       "searchConfig": "A String", # Required. Search config name. Format: projects/*/locations/global/notebookLmSearchConfigs/*
     },
     "thirdPartyOauthConfig": { # Stores information for third party applicationOAuth. # Third Party OAuth config. If set, this DataStore is connected to a third party application.
@@ -1216,6 +1228,9 @@ 
Method Details

       ],
     },
     "notebooklmConfig": { # Config for connecting to NotebookLM Enterprise. # NotebookLM config. If set, this DataStore is connected to NotebookLM Enterprise.
+      "notebooks": [ # Optional. Restricts this data store to the given notebooks. When empty, the data store covers every notebook the querying user can access, which is the existing behaviour. Each entry is a full notebook resource name, such as `projects/*/locations/*/notebooks/*`. Scoping is enforced on results as well as requested upstream, so a notebook outside this list cannot appear in a search response through this data store even if the backend returns one.
+        "A String",
+      ],
       "searchConfig": "A String", # Required. Search config name. Format: projects/*/locations/global/notebookLmSearchConfigs/*
     },
     "thirdPartyOauthConfig": { # Stores information for third party applicationOAuth. # Third Party OAuth config. If set, this DataStore is connected to a third party application.
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 d33db79dc1..52c66ba19d 100644
--- a/docs/dyn/discoveryengine_v1.projects.locations.collections.dataStores.servingConfigs.html
+++ b/docs/dyn/discoveryengine_v1.projects.locations.collections.dataStores.servingConfigs.html
@@ -1454,7 +1454,9 @@ 
Method Details

         },
         "questionIndex": 42, # The index of the user input within the conversation messages.
         "session": "A String", # Name of the newly generated or continued session.
-        "taskName": "A String", # Optional. The full resource name of the Sobi task if the conversation was handled by a long-running agent task. Format: projects/{project}/locations/{location}/tasks/{task_id}
+        "stepSeqNum": "A String", # Optional. The `TaskServerEvent.seq_num` of the step that opened the rated agent task reply.
+        "taskName": "A String", # Optional. The full resource name of the Sobi task if the conversation was handled by a long-running agent task. Format (canonical, or the short alias the Task API also accepts): projects/{project}/locations/{location}/agents/{agent}/tasks/{task} projects/{project}/locations/{location}/tasks/{task}
+        "trajectoryId": "A String", # Optional. The runtime trajectory id of the rated agent task turn, as set on `TaskServerEvent.trajectory_id`. Shared by all steps of the turn.
       },
       "dataTermsAccepted": True or False, # Optional. Whether the customer accepted data use terms.
       "feedbackSource": "A String", # Optional. The UI component the user feedback comes from, which could be GOOGLE_CONSOLE, GOOGLE_WIDGET, GOOGLE_WEBAPP.
@@ -1706,7 +1708,7 @@ 
Method Details

       "A String",
     ],
   },
-  "dataStoreSpecs": [ # Specifications that define the specific DataStores to be searched, along with configurations for those data stores. This is only considered for Engines with multiple data stores. For engines with a single data store, the specs directly under SearchRequest should be used.
+  "dataStoreSpecs": [ # Specifications that define the specific DataStores to be searched, along with configurations for those data stores. This is only considered for Engines with multiple data stores. For engines with a single data store, the specs directly under SearchRequest should be used. On an engine with multiple data stores, this field is optional. If it's empty, all of the engine's data stores are searched (blended search). Unless it specifies exactly one data store, some request fields, such as `order_by` and `query_expansion_spec`, aren't supported and return an `INVALID_ARGUMENT` error.
     { # A struct to define data stores to filter on in a search call and configurations for those data stores. Otherwise, an `INVALID_ARGUMENT` error is returned.
       "boostSpec": { # Boost specification to boost certain documents. # Optional. Boost specification to boost certain documents. For more information on boosting, see [Boosting](https://cloud.google.com/generative-ai-app-builder/docs/boost-search-results)
         "conditionBoostSpecs": [ # Condition boost specifications. If a document matches multiple conditions in the specifications, boost scores from these specifications are all applied and combined in a non-linear way. Maximum number of specifications is 20.
@@ -2206,7 +2208,7 @@ 
Method Details

       "A String",
     ],
   },
-  "dataStoreSpecs": [ # Specifications that define the specific DataStores to be searched, along with configurations for those data stores. This is only considered for Engines with multiple data stores. For engines with a single data store, the specs directly under SearchRequest should be used.
+  "dataStoreSpecs": [ # Specifications that define the specific DataStores to be searched, along with configurations for those data stores. This is only considered for Engines with multiple data stores. For engines with a single data store, the specs directly under SearchRequest should be used. On an engine with multiple data stores, this field is optional. If it's empty, all of the engine's data stores are searched (blended search). Unless it specifies exactly one data store, some request fields, such as `order_by` and `query_expansion_spec`, aren't supported and return an `INVALID_ARGUMENT` error.
     { # A struct to define data stores to filter on in a search call and configurations for those data stores. Otherwise, an `INVALID_ARGUMENT` error is returned.
       "boostSpec": { # Boost specification to boost certain documents. # Optional. Boost specification to boost certain documents. For more information on boosting, see [Boosting](https://cloud.google.com/generative-ai-app-builder/docs/boost-search-results)
         "conditionBoostSpecs": [ # Condition boost specifications. If a document matches multiple conditions in the specifications, boost scores from these specifications are all applied and combined in a non-linear way. Maximum number of specifications is 20.
diff --git a/docs/dyn/discoveryengine_v1.projects.locations.collections.dataStores.userEvents.html b/docs/dyn/discoveryengine_v1.projects.locations.collections.dataStores.userEvents.html
index e25b9cf203..1fcdb79d71 100644
--- a/docs/dyn/discoveryengine_v1.projects.locations.collections.dataStores.userEvents.html
+++ b/docs/dyn/discoveryengine_v1.projects.locations.collections.dataStores.userEvents.html
@@ -204,7 +204,9 @@ 
Method Details

             },
             "questionIndex": 42, # The index of the user input within the conversation messages.
             "session": "A String", # Name of the newly generated or continued session.
-            "taskName": "A String", # Optional. The full resource name of the Sobi task if the conversation was handled by a long-running agent task. Format: projects/{project}/locations/{location}/tasks/{task_id}
+            "stepSeqNum": "A String", # Optional. The `TaskServerEvent.seq_num` of the step that opened the rated agent task reply.
+            "taskName": "A String", # Optional. The full resource name of the Sobi task if the conversation was handled by a long-running agent task. Format (canonical, or the short alias the Task API also accepts): projects/{project}/locations/{location}/agents/{agent}/tasks/{task} projects/{project}/locations/{location}/tasks/{task}
+            "trajectoryId": "A String", # Optional. The runtime trajectory id of the rated agent task turn, as set on `TaskServerEvent.trajectory_id`. Shared by all steps of the turn.
           },
           "dataTermsAccepted": True or False, # Optional. Whether the customer accepted data use terms.
           "feedbackSource": "A String", # Optional. The UI component the user feedback comes from, which could be GOOGLE_CONSOLE, GOOGLE_WIDGET, GOOGLE_WEBAPP.
@@ -432,7 +434,9 @@ 
Method Details

       },
       "questionIndex": 42, # The index of the user input within the conversation messages.
       "session": "A String", # Name of the newly generated or continued session.
-      "taskName": "A String", # Optional. The full resource name of the Sobi task if the conversation was handled by a long-running agent task. Format: projects/{project}/locations/{location}/tasks/{task_id}
+      "stepSeqNum": "A String", # Optional. The `TaskServerEvent.seq_num` of the step that opened the rated agent task reply.
+      "taskName": "A String", # Optional. The full resource name of the Sobi task if the conversation was handled by a long-running agent task. Format (canonical, or the short alias the Task API also accepts): projects/{project}/locations/{location}/agents/{agent}/tasks/{task} projects/{project}/locations/{location}/tasks/{task}
+      "trajectoryId": "A String", # Optional. The runtime trajectory id of the rated agent task turn, as set on `TaskServerEvent.trajectory_id`. Shared by all steps of the turn.
     },
     "dataTermsAccepted": True or False, # Optional. Whether the customer accepted data use terms.
     "feedbackSource": "A String", # Optional. The UI component the user feedback comes from, which could be GOOGLE_CONSOLE, GOOGLE_WIDGET, GOOGLE_WEBAPP.
@@ -585,7 +589,9 @@ 
Method Details

       },
       "questionIndex": 42, # The index of the user input within the conversation messages.
       "session": "A String", # Name of the newly generated or continued session.
-      "taskName": "A String", # Optional. The full resource name of the Sobi task if the conversation was handled by a long-running agent task. Format: projects/{project}/locations/{location}/tasks/{task_id}
+      "stepSeqNum": "A String", # Optional. The `TaskServerEvent.seq_num` of the step that opened the rated agent task reply.
+      "taskName": "A String", # Optional. The full resource name of the Sobi task if the conversation was handled by a long-running agent task. Format (canonical, or the short alias the Task API also accepts): projects/{project}/locations/{location}/agents/{agent}/tasks/{task} projects/{project}/locations/{location}/tasks/{task}
+      "trajectoryId": "A String", # Optional. The runtime trajectory id of the rated agent task turn, as set on `TaskServerEvent.trajectory_id`. Shared by all steps of the turn.
     },
     "dataTermsAccepted": True or False, # Optional. Whether the customer accepted data use terms.
     "feedbackSource": "A String", # Optional. The UI component the user feedback comes from, which could be GOOGLE_CONSOLE, GOOGLE_WIDGET, GOOGLE_WEBAPP.
diff --git a/docs/dyn/discoveryengine_v1.projects.locations.collections.dataStores.widgetConfigs.html b/docs/dyn/discoveryengine_v1.projects.locations.collections.dataStores.widgetConfigs.html
index ad243504c1..9fef14042f 100644
--- a/docs/dyn/discoveryengine_v1.projects.locations.collections.dataStores.widgetConfigs.html
+++ b/docs/dyn/discoveryengine_v1.projects.locations.collections.dataStores.widgetConfigs.html
@@ -336,7 +336,7 @@ 
Method Details

     "enableSafeSearch": True or False, # Whether to enable safe search.
     "enableSearchAsYouType": True or False, # Whether to enable search-as-you-type behavior for the search widget.
     "enableVisualContentSummary": True or False, # If set to true, the widget will enable visual content summary on applicable search requests. Only used by healthcare search.
-    "features": { # Output only. Feature config for the engine to opt in or opt out of features. Supported keys: * `agent-gallery` * `no-code-agent-builder` * `prompt-gallery` * `model-selector` * `notebook-lm` * `people-search` * `people-search-org-chart` * `bi-directional-audio` * `speech-to-text` * `feedback` * `session-sharing` * `personalization-memory` * `personalization-suggested-highlights` * `mobile-app-access` * `disable-agent-sharing` * `disable-image-generation` * `disable-video-generation` * `disable-onedrive-upload` * `disable-talk-to-content` * `disable-google-drive-upload` * `disable-welcome-emails` * `disable-canvas` * `canvas-workspace` * `canvas-app-builder` * `skills` * `skill-sharing` * `skill-sharing-without-admin-approval` * `disable-projects` * `sobi` * `enable-end-user-sharing-with-groups` * `single-agent-orchestration` * `multi-agent-orchestration` * `cross-product-intelligence` * `workflow-agents` * `in-app-notifications`
+    "features": { # Output only. Feature config for the engine to opt in or opt out of features. Supported keys: * `agent-gallery` * `no-code-agent-builder` * `prompt-gallery` * `model-selector` * `notebook-lm` * `people-search` * `people-search-org-chart` * `bi-directional-audio` * `speech-to-text` * `feedback` * `session-sharing` * `personalization-memory` * `personalization-suggested-highlights` * `mobile-app-access` * `disable-agent-sharing` * `disable-image-generation` * `disable-video-generation` * `disable-onedrive-upload` * `disable-talk-to-content` * `disable-google-drive-upload` * `disable-welcome-emails` * `disable-canvas` * `canvas-workspace` * `canvas-app-builder` * `skills` * `skill-sharing` * `skill-sharing-without-admin-approval` * `disable-projects` * `sobi` * `enable-end-user-sharing-with-groups` * `single-agent-orchestration` * `multi-agent-orchestration` * `cross-product-intelligence` * `workflow-agents` * `in-app-notifications` * `code-extraction`
       "a_key": "A String",
     },
     "generativeAnswerConfig": { # Describes configuration for generative answer. # Describes generative answer configuration.
@@ -626,7 +626,7 @@ 
Method Details

     "enableSafeSearch": True or False, # Whether to enable safe search.
     "enableSearchAsYouType": True or False, # Whether to enable search-as-you-type behavior for the search widget.
     "enableVisualContentSummary": True or False, # If set to true, the widget will enable visual content summary on applicable search requests. Only used by healthcare search.
-    "features": { # Output only. Feature config for the engine to opt in or opt out of features. Supported keys: * `agent-gallery` * `no-code-agent-builder` * `prompt-gallery` * `model-selector` * `notebook-lm` * `people-search` * `people-search-org-chart` * `bi-directional-audio` * `speech-to-text` * `feedback` * `session-sharing` * `personalization-memory` * `personalization-suggested-highlights` * `mobile-app-access` * `disable-agent-sharing` * `disable-image-generation` * `disable-video-generation` * `disable-onedrive-upload` * `disable-talk-to-content` * `disable-google-drive-upload` * `disable-welcome-emails` * `disable-canvas` * `canvas-workspace` * `canvas-app-builder` * `skills` * `skill-sharing` * `skill-sharing-without-admin-approval` * `disable-projects` * `sobi` * `enable-end-user-sharing-with-groups` * `single-agent-orchestration` * `multi-agent-orchestration` * `cross-product-intelligence` * `workflow-agents` * `in-app-notifications`
+    "features": { # Output only. Feature config for the engine to opt in or opt out of features. Supported keys: * `agent-gallery` * `no-code-agent-builder` * `prompt-gallery` * `model-selector` * `notebook-lm` * `people-search` * `people-search-org-chart` * `bi-directional-audio` * `speech-to-text` * `feedback` * `session-sharing` * `personalization-memory` * `personalization-suggested-highlights` * `mobile-app-access` * `disable-agent-sharing` * `disable-image-generation` * `disable-video-generation` * `disable-onedrive-upload` * `disable-talk-to-content` * `disable-google-drive-upload` * `disable-welcome-emails` * `disable-canvas` * `canvas-workspace` * `canvas-app-builder` * `skills` * `skill-sharing` * `skill-sharing-without-admin-approval` * `disable-projects` * `sobi` * `enable-end-user-sharing-with-groups` * `single-agent-orchestration` * `multi-agent-orchestration` * `cross-product-intelligence` * `workflow-agents` * `in-app-notifications` * `code-extraction`
       "a_key": "A String",
     },
     "generativeAnswerConfig": { # Describes configuration for generative answer. # Describes generative answer configuration.
@@ -915,7 +915,7 @@ 
Method Details

     "enableSafeSearch": True or False, # Whether to enable safe search.
     "enableSearchAsYouType": True or False, # Whether to enable search-as-you-type behavior for the search widget.
     "enableVisualContentSummary": True or False, # If set to true, the widget will enable visual content summary on applicable search requests. Only used by healthcare search.
-    "features": { # Output only. Feature config for the engine to opt in or opt out of features. Supported keys: * `agent-gallery` * `no-code-agent-builder` * `prompt-gallery` * `model-selector` * `notebook-lm` * `people-search` * `people-search-org-chart` * `bi-directional-audio` * `speech-to-text` * `feedback` * `session-sharing` * `personalization-memory` * `personalization-suggested-highlights` * `mobile-app-access` * `disable-agent-sharing` * `disable-image-generation` * `disable-video-generation` * `disable-onedrive-upload` * `disable-talk-to-content` * `disable-google-drive-upload` * `disable-welcome-emails` * `disable-canvas` * `canvas-workspace` * `canvas-app-builder` * `skills` * `skill-sharing` * `skill-sharing-without-admin-approval` * `disable-projects` * `sobi` * `enable-end-user-sharing-with-groups` * `single-agent-orchestration` * `multi-agent-orchestration` * `cross-product-intelligence` * `workflow-agents` * `in-app-notifications`
+    "features": { # Output only. Feature config for the engine to opt in or opt out of features. Supported keys: * `agent-gallery` * `no-code-agent-builder` * `prompt-gallery` * `model-selector` * `notebook-lm` * `people-search` * `people-search-org-chart` * `bi-directional-audio` * `speech-to-text` * `feedback` * `session-sharing` * `personalization-memory` * `personalization-suggested-highlights` * `mobile-app-access` * `disable-agent-sharing` * `disable-image-generation` * `disable-video-generation` * `disable-onedrive-upload` * `disable-talk-to-content` * `disable-google-drive-upload` * `disable-welcome-emails` * `disable-canvas` * `canvas-workspace` * `canvas-app-builder` * `skills` * `skill-sharing` * `skill-sharing-without-admin-approval` * `disable-projects` * `sobi` * `enable-end-user-sharing-with-groups` * `single-agent-orchestration` * `multi-agent-orchestration` * `cross-product-intelligence` * `workflow-agents` * `in-app-notifications` * `code-extraction`
       "a_key": "A String",
     },
     "generativeAnswerConfig": { # Describes configuration for generative answer. # Describes generative answer configuration.
diff --git a/docs/dyn/discoveryengine_v1.projects.locations.collections.engines.html b/docs/dyn/discoveryengine_v1.projects.locations.collections.engines.html
index 0eeb9254c5..5a76697bf1 100644
--- a/docs/dyn/discoveryengine_v1.projects.locations.collections.engines.html
+++ b/docs/dyn/discoveryengine_v1.projects.locations.collections.engines.html
@@ -204,7 +204,7 @@ 
Method Details

   ],
   "disableAnalytics": True or False, # Optional. Whether to disable analytics for searches performed on this engine.
   "displayName": "A String", # Required. The display name of the engine. Should be human readable. UTF-8 encoded string with limit of 1024 characters.
-  "features": { # Optional. Feature config for the engine to opt in or opt out of features. Supported keys: * `*`: all features, if it's present, all other feature state settings are ignored. * `agent-gallery` * `no-code-agent-builder` * `prompt-gallery` * `model-selector` * `notebook-lm` * `people-search` * `people-search-org-chart` * `bi-directional-audio` * `speech-to-text` * `feedback` * `session-sharing` * `personalization-memory` * `personalization-suggested-highlights` * `mobile-app-access` * `disable-agent-sharing` * `disable-image-generation` * `disable-video-generation` * `disable-onedrive-upload` * `disable-talk-to-content` * `disable-google-drive-upload` * `disable-welcome-emails` * `disable-canvas` * `canvas-workspace` * `canvas-app-builder` * `skills` * `skill-sharing` * `skill-sharing-without-admin-approval` * `disable-projects` * `sobi` * `enable-end-user-sharing-with-groups` * `single-agent-orchestration` * `multi-agent-orchestration` * `cross-product-intelligence` * `workflow-agents` * `in-app-notifications`
+  "features": { # Optional. Feature config for the engine to opt in or opt out of features. Supported keys: * `*`: all features, if it's present, all other feature state settings are ignored. * `agent-gallery` * `no-code-agent-builder` * `prompt-gallery` * `model-selector` * `notebook-lm` * `people-search` * `people-search-org-chart` * `bi-directional-audio` * `speech-to-text` * `feedback` * `session-sharing` * `personalization-memory` * `personalization-suggested-highlights` * `mobile-app-access` * `disable-agent-sharing` * `disable-image-generation` * `disable-video-generation` * `disable-onedrive-upload` * `disable-talk-to-content` * `disable-google-drive-upload` * `disable-welcome-emails` * `disable-canvas` * `canvas-workspace` * `canvas-app-builder` * `skills` * `skill-sharing` * `skill-sharing-without-admin-approval` * `disable-projects` * `sobi` * `enable-end-user-sharing-with-groups` * `single-agent-orchestration` * `multi-agent-orchestration` * `cross-product-intelligence` * `workflow-agents` * `in-app-notifications` * `code-extraction`
     "a_key": "A String",
   },
   "industryVertical": "A String", # Optional. The industry vertical that the engine registers. The restriction of the Engine industry vertical is based on DataStore: Vertical on Engine has to match vertical of the DataStore linked to the engine.
@@ -397,7 +397,7 @@ 
Method Details

   ],
   "disableAnalytics": True or False, # Optional. Whether to disable analytics for searches performed on this engine.
   "displayName": "A String", # Required. The display name of the engine. Should be human readable. UTF-8 encoded string with limit of 1024 characters.
-  "features": { # Optional. Feature config for the engine to opt in or opt out of features. Supported keys: * `*`: all features, if it's present, all other feature state settings are ignored. * `agent-gallery` * `no-code-agent-builder` * `prompt-gallery` * `model-selector` * `notebook-lm` * `people-search` * `people-search-org-chart` * `bi-directional-audio` * `speech-to-text` * `feedback` * `session-sharing` * `personalization-memory` * `personalization-suggested-highlights` * `mobile-app-access` * `disable-agent-sharing` * `disable-image-generation` * `disable-video-generation` * `disable-onedrive-upload` * `disable-talk-to-content` * `disable-google-drive-upload` * `disable-welcome-emails` * `disable-canvas` * `canvas-workspace` * `canvas-app-builder` * `skills` * `skill-sharing` * `skill-sharing-without-admin-approval` * `disable-projects` * `sobi` * `enable-end-user-sharing-with-groups` * `single-agent-orchestration` * `multi-agent-orchestration` * `cross-product-intelligence` * `workflow-agents` * `in-app-notifications`
+  "features": { # Optional. Feature config for the engine to opt in or opt out of features. Supported keys: * `*`: all features, if it's present, all other feature state settings are ignored. * `agent-gallery` * `no-code-agent-builder` * `prompt-gallery` * `model-selector` * `notebook-lm` * `people-search` * `people-search-org-chart` * `bi-directional-audio` * `speech-to-text` * `feedback` * `session-sharing` * `personalization-memory` * `personalization-suggested-highlights` * `mobile-app-access` * `disable-agent-sharing` * `disable-image-generation` * `disable-video-generation` * `disable-onedrive-upload` * `disable-talk-to-content` * `disable-google-drive-upload` * `disable-welcome-emails` * `disable-canvas` * `canvas-workspace` * `canvas-app-builder` * `skills` * `skill-sharing` * `skill-sharing-without-admin-approval` * `disable-projects` * `sobi` * `enable-end-user-sharing-with-groups` * `single-agent-orchestration` * `multi-agent-orchestration` * `cross-product-intelligence` * `workflow-agents` * `in-app-notifications` * `code-extraction`
     "a_key": "A String",
   },
   "industryVertical": "A String", # Optional. The industry vertical that the engine registers. The restriction of the Engine industry vertical is based on DataStore: Vertical on Engine has to match vertical of the DataStore linked to the engine.
@@ -566,7 +566,7 @@ 
Method Details

       ],
       "disableAnalytics": True or False, # Optional. Whether to disable analytics for searches performed on this engine.
       "displayName": "A String", # Required. The display name of the engine. Should be human readable. UTF-8 encoded string with limit of 1024 characters.
-      "features": { # Optional. Feature config for the engine to opt in or opt out of features. Supported keys: * `*`: all features, if it's present, all other feature state settings are ignored. * `agent-gallery` * `no-code-agent-builder` * `prompt-gallery` * `model-selector` * `notebook-lm` * `people-search` * `people-search-org-chart` * `bi-directional-audio` * `speech-to-text` * `feedback` * `session-sharing` * `personalization-memory` * `personalization-suggested-highlights` * `mobile-app-access` * `disable-agent-sharing` * `disable-image-generation` * `disable-video-generation` * `disable-onedrive-upload` * `disable-talk-to-content` * `disable-google-drive-upload` * `disable-welcome-emails` * `disable-canvas` * `canvas-workspace` * `canvas-app-builder` * `skills` * `skill-sharing` * `skill-sharing-without-admin-approval` * `disable-projects` * `sobi` * `enable-end-user-sharing-with-groups` * `single-agent-orchestration` * `multi-agent-orchestration` * `cross-product-intelligence` * `workflow-agents` * `in-app-notifications`
+      "features": { # Optional. Feature config for the engine to opt in or opt out of features. Supported keys: * `*`: all features, if it's present, all other feature state settings are ignored. * `agent-gallery` * `no-code-agent-builder` * `prompt-gallery` * `model-selector` * `notebook-lm` * `people-search` * `people-search-org-chart` * `bi-directional-audio` * `speech-to-text` * `feedback` * `session-sharing` * `personalization-memory` * `personalization-suggested-highlights` * `mobile-app-access` * `disable-agent-sharing` * `disable-image-generation` * `disable-video-generation` * `disable-onedrive-upload` * `disable-talk-to-content` * `disable-google-drive-upload` * `disable-welcome-emails` * `disable-canvas` * `canvas-workspace` * `canvas-app-builder` * `skills` * `skill-sharing` * `skill-sharing-without-admin-approval` * `disable-projects` * `sobi` * `enable-end-user-sharing-with-groups` * `single-agent-orchestration` * `multi-agent-orchestration` * `cross-product-intelligence` * `workflow-agents` * `in-app-notifications` * `code-extraction`
         "a_key": "A String",
       },
       "industryVertical": "A String", # Optional. The industry vertical that the engine registers. The restriction of the Engine industry vertical is based on DataStore: Vertical on Engine has to match vertical of the DataStore linked to the engine.
@@ -707,7 +707,7 @@ 
Method Details

   ],
   "disableAnalytics": True or False, # Optional. Whether to disable analytics for searches performed on this engine.
   "displayName": "A String", # Required. The display name of the engine. Should be human readable. UTF-8 encoded string with limit of 1024 characters.
-  "features": { # Optional. Feature config for the engine to opt in or opt out of features. Supported keys: * `*`: all features, if it's present, all other feature state settings are ignored. * `agent-gallery` * `no-code-agent-builder` * `prompt-gallery` * `model-selector` * `notebook-lm` * `people-search` * `people-search-org-chart` * `bi-directional-audio` * `speech-to-text` * `feedback` * `session-sharing` * `personalization-memory` * `personalization-suggested-highlights` * `mobile-app-access` * `disable-agent-sharing` * `disable-image-generation` * `disable-video-generation` * `disable-onedrive-upload` * `disable-talk-to-content` * `disable-google-drive-upload` * `disable-welcome-emails` * `disable-canvas` * `canvas-workspace` * `canvas-app-builder` * `skills` * `skill-sharing` * `skill-sharing-without-admin-approval` * `disable-projects` * `sobi` * `enable-end-user-sharing-with-groups` * `single-agent-orchestration` * `multi-agent-orchestration` * `cross-product-intelligence` * `workflow-agents` * `in-app-notifications`
+  "features": { # Optional. Feature config for the engine to opt in or opt out of features. Supported keys: * `*`: all features, if it's present, all other feature state settings are ignored. * `agent-gallery` * `no-code-agent-builder` * `prompt-gallery` * `model-selector` * `notebook-lm` * `people-search` * `people-search-org-chart` * `bi-directional-audio` * `speech-to-text` * `feedback` * `session-sharing` * `personalization-memory` * `personalization-suggested-highlights` * `mobile-app-access` * `disable-agent-sharing` * `disable-image-generation` * `disable-video-generation` * `disable-onedrive-upload` * `disable-talk-to-content` * `disable-google-drive-upload` * `disable-welcome-emails` * `disable-canvas` * `canvas-workspace` * `canvas-app-builder` * `skills` * `skill-sharing` * `skill-sharing-without-admin-approval` * `disable-projects` * `sobi` * `enable-end-user-sharing-with-groups` * `single-agent-orchestration` * `multi-agent-orchestration` * `cross-product-intelligence` * `workflow-agents` * `in-app-notifications` * `code-extraction`
     "a_key": "A String",
   },
   "industryVertical": "A String", # Optional. The industry vertical that the engine registers. The restriction of the Engine industry vertical is based on DataStore: Vertical on Engine has to match vertical of the DataStore linked to the engine.
@@ -830,7 +830,7 @@ 
Method Details

   ],
   "disableAnalytics": True or False, # Optional. Whether to disable analytics for searches performed on this engine.
   "displayName": "A String", # Required. The display name of the engine. Should be human readable. UTF-8 encoded string with limit of 1024 characters.
-  "features": { # Optional. Feature config for the engine to opt in or opt out of features. Supported keys: * `*`: all features, if it's present, all other feature state settings are ignored. * `agent-gallery` * `no-code-agent-builder` * `prompt-gallery` * `model-selector` * `notebook-lm` * `people-search` * `people-search-org-chart` * `bi-directional-audio` * `speech-to-text` * `feedback` * `session-sharing` * `personalization-memory` * `personalization-suggested-highlights` * `mobile-app-access` * `disable-agent-sharing` * `disable-image-generation` * `disable-video-generation` * `disable-onedrive-upload` * `disable-talk-to-content` * `disable-google-drive-upload` * `disable-welcome-emails` * `disable-canvas` * `canvas-workspace` * `canvas-app-builder` * `skills` * `skill-sharing` * `skill-sharing-without-admin-approval` * `disable-projects` * `sobi` * `enable-end-user-sharing-with-groups` * `single-agent-orchestration` * `multi-agent-orchestration` * `cross-product-intelligence` * `workflow-agents` * `in-app-notifications`
+  "features": { # Optional. Feature config for the engine to opt in or opt out of features. Supported keys: * `*`: all features, if it's present, all other feature state settings are ignored. * `agent-gallery` * `no-code-agent-builder` * `prompt-gallery` * `model-selector` * `notebook-lm` * `people-search` * `people-search-org-chart` * `bi-directional-audio` * `speech-to-text` * `feedback` * `session-sharing` * `personalization-memory` * `personalization-suggested-highlights` * `mobile-app-access` * `disable-agent-sharing` * `disable-image-generation` * `disable-video-generation` * `disable-onedrive-upload` * `disable-talk-to-content` * `disable-google-drive-upload` * `disable-welcome-emails` * `disable-canvas` * `canvas-workspace` * `canvas-app-builder` * `skills` * `skill-sharing` * `skill-sharing-without-admin-approval` * `disable-projects` * `sobi` * `enable-end-user-sharing-with-groups` * `single-agent-orchestration` * `multi-agent-orchestration` * `cross-product-intelligence` * `workflow-agents` * `in-app-notifications` * `code-extraction`
     "a_key": "A String",
   },
   "industryVertical": "A String", # Optional. The industry vertical that the engine registers. The restriction of the Engine industry vertical is based on DataStore: Vertical on Engine has to match vertical of the DataStore linked to the engine.
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 356ed95ee4..1c207e8363 100644
--- a/docs/dyn/discoveryengine_v1.projects.locations.collections.engines.servingConfigs.html
+++ b/docs/dyn/discoveryengine_v1.projects.locations.collections.engines.servingConfigs.html
@@ -1454,7 +1454,9 @@ 
Method Details

         },
         "questionIndex": 42, # The index of the user input within the conversation messages.
         "session": "A String", # Name of the newly generated or continued session.
-        "taskName": "A String", # Optional. The full resource name of the Sobi task if the conversation was handled by a long-running agent task. Format: projects/{project}/locations/{location}/tasks/{task_id}
+        "stepSeqNum": "A String", # Optional. The `TaskServerEvent.seq_num` of the step that opened the rated agent task reply.
+        "taskName": "A String", # Optional. The full resource name of the Sobi task if the conversation was handled by a long-running agent task. Format (canonical, or the short alias the Task API also accepts): projects/{project}/locations/{location}/agents/{agent}/tasks/{task} projects/{project}/locations/{location}/tasks/{task}
+        "trajectoryId": "A String", # Optional. The runtime trajectory id of the rated agent task turn, as set on `TaskServerEvent.trajectory_id`. Shared by all steps of the turn.
       },
       "dataTermsAccepted": True or False, # Optional. Whether the customer accepted data use terms.
       "feedbackSource": "A String", # Optional. The UI component the user feedback comes from, which could be GOOGLE_CONSOLE, GOOGLE_WIDGET, GOOGLE_WEBAPP.
@@ -1706,7 +1708,7 @@ 
Method Details

       "A String",
     ],
   },
-  "dataStoreSpecs": [ # Specifications that define the specific DataStores to be searched, along with configurations for those data stores. This is only considered for Engines with multiple data stores. For engines with a single data store, the specs directly under SearchRequest should be used.
+  "dataStoreSpecs": [ # Specifications that define the specific DataStores to be searched, along with configurations for those data stores. This is only considered for Engines with multiple data stores. For engines with a single data store, the specs directly under SearchRequest should be used. On an engine with multiple data stores, this field is optional. If it's empty, all of the engine's data stores are searched (blended search). Unless it specifies exactly one data store, some request fields, such as `order_by` and `query_expansion_spec`, aren't supported and return an `INVALID_ARGUMENT` error.
     { # A struct to define data stores to filter on in a search call and configurations for those data stores. Otherwise, an `INVALID_ARGUMENT` error is returned.
       "boostSpec": { # Boost specification to boost certain documents. # Optional. Boost specification to boost certain documents. For more information on boosting, see [Boosting](https://cloud.google.com/generative-ai-app-builder/docs/boost-search-results)
         "conditionBoostSpecs": [ # Condition boost specifications. If a document matches multiple conditions in the specifications, boost scores from these specifications are all applied and combined in a non-linear way. Maximum number of specifications is 20.
@@ -2206,7 +2208,7 @@ 
Method Details

       "A String",
     ],
   },
-  "dataStoreSpecs": [ # Specifications that define the specific DataStores to be searched, along with configurations for those data stores. This is only considered for Engines with multiple data stores. For engines with a single data store, the specs directly under SearchRequest should be used.
+  "dataStoreSpecs": [ # Specifications that define the specific DataStores to be searched, along with configurations for those data stores. This is only considered for Engines with multiple data stores. For engines with a single data store, the specs directly under SearchRequest should be used. On an engine with multiple data stores, this field is optional. If it's empty, all of the engine's data stores are searched (blended search). Unless it specifies exactly one data store, some request fields, such as `order_by` and `query_expansion_spec`, aren't supported and return an `INVALID_ARGUMENT` error.
     { # A struct to define data stores to filter on in a search call and configurations for those data stores. Otherwise, an `INVALID_ARGUMENT` error is returned.
       "boostSpec": { # Boost specification to boost certain documents. # Optional. Boost specification to boost certain documents. For more information on boosting, see [Boosting](https://cloud.google.com/generative-ai-app-builder/docs/boost-search-results)
         "conditionBoostSpecs": [ # Condition boost specifications. If a document matches multiple conditions in the specifications, boost scores from these specifications are all applied and combined in a non-linear way. Maximum number of specifications is 20.
diff --git a/docs/dyn/discoveryengine_v1.projects.locations.collections.engines.widgetConfigs.html b/docs/dyn/discoveryengine_v1.projects.locations.collections.engines.widgetConfigs.html
index 92fd7411dd..7b22b083c6 100644
--- a/docs/dyn/discoveryengine_v1.projects.locations.collections.engines.widgetConfigs.html
+++ b/docs/dyn/discoveryengine_v1.projects.locations.collections.engines.widgetConfigs.html
@@ -336,7 +336,7 @@ 
Method Details

     "enableSafeSearch": True or False, # Whether to enable safe search.
     "enableSearchAsYouType": True or False, # Whether to enable search-as-you-type behavior for the search widget.
     "enableVisualContentSummary": True or False, # If set to true, the widget will enable visual content summary on applicable search requests. Only used by healthcare search.
-    "features": { # Output only. Feature config for the engine to opt in or opt out of features. Supported keys: * `agent-gallery` * `no-code-agent-builder` * `prompt-gallery` * `model-selector` * `notebook-lm` * `people-search` * `people-search-org-chart` * `bi-directional-audio` * `speech-to-text` * `feedback` * `session-sharing` * `personalization-memory` * `personalization-suggested-highlights` * `mobile-app-access` * `disable-agent-sharing` * `disable-image-generation` * `disable-video-generation` * `disable-onedrive-upload` * `disable-talk-to-content` * `disable-google-drive-upload` * `disable-welcome-emails` * `disable-canvas` * `canvas-workspace` * `canvas-app-builder` * `skills` * `skill-sharing` * `skill-sharing-without-admin-approval` * `disable-projects` * `sobi` * `enable-end-user-sharing-with-groups` * `single-agent-orchestration` * `multi-agent-orchestration` * `cross-product-intelligence` * `workflow-agents` * `in-app-notifications`
+    "features": { # Output only. Feature config for the engine to opt in or opt out of features. Supported keys: * `agent-gallery` * `no-code-agent-builder` * `prompt-gallery` * `model-selector` * `notebook-lm` * `people-search` * `people-search-org-chart` * `bi-directional-audio` * `speech-to-text` * `feedback` * `session-sharing` * `personalization-memory` * `personalization-suggested-highlights` * `mobile-app-access` * `disable-agent-sharing` * `disable-image-generation` * `disable-video-generation` * `disable-onedrive-upload` * `disable-talk-to-content` * `disable-google-drive-upload` * `disable-welcome-emails` * `disable-canvas` * `canvas-workspace` * `canvas-app-builder` * `skills` * `skill-sharing` * `skill-sharing-without-admin-approval` * `disable-projects` * `sobi` * `enable-end-user-sharing-with-groups` * `single-agent-orchestration` * `multi-agent-orchestration` * `cross-product-intelligence` * `workflow-agents` * `in-app-notifications` * `code-extraction`
       "a_key": "A String",
     },
     "generativeAnswerConfig": { # Describes configuration for generative answer. # Describes generative answer configuration.
@@ -626,7 +626,7 @@ 
Method Details

     "enableSafeSearch": True or False, # Whether to enable safe search.
     "enableSearchAsYouType": True or False, # Whether to enable search-as-you-type behavior for the search widget.
     "enableVisualContentSummary": True or False, # If set to true, the widget will enable visual content summary on applicable search requests. Only used by healthcare search.
-    "features": { # Output only. Feature config for the engine to opt in or opt out of features. Supported keys: * `agent-gallery` * `no-code-agent-builder` * `prompt-gallery` * `model-selector` * `notebook-lm` * `people-search` * `people-search-org-chart` * `bi-directional-audio` * `speech-to-text` * `feedback` * `session-sharing` * `personalization-memory` * `personalization-suggested-highlights` * `mobile-app-access` * `disable-agent-sharing` * `disable-image-generation` * `disable-video-generation` * `disable-onedrive-upload` * `disable-talk-to-content` * `disable-google-drive-upload` * `disable-welcome-emails` * `disable-canvas` * `canvas-workspace` * `canvas-app-builder` * `skills` * `skill-sharing` * `skill-sharing-without-admin-approval` * `disable-projects` * `sobi` * `enable-end-user-sharing-with-groups` * `single-agent-orchestration` * `multi-agent-orchestration` * `cross-product-intelligence` * `workflow-agents` * `in-app-notifications`
+    "features": { # Output only. Feature config for the engine to opt in or opt out of features. Supported keys: * `agent-gallery` * `no-code-agent-builder` * `prompt-gallery` * `model-selector` * `notebook-lm` * `people-search` * `people-search-org-chart` * `bi-directional-audio` * `speech-to-text` * `feedback` * `session-sharing` * `personalization-memory` * `personalization-suggested-highlights` * `mobile-app-access` * `disable-agent-sharing` * `disable-image-generation` * `disable-video-generation` * `disable-onedrive-upload` * `disable-talk-to-content` * `disable-google-drive-upload` * `disable-welcome-emails` * `disable-canvas` * `canvas-workspace` * `canvas-app-builder` * `skills` * `skill-sharing` * `skill-sharing-without-admin-approval` * `disable-projects` * `sobi` * `enable-end-user-sharing-with-groups` * `single-agent-orchestration` * `multi-agent-orchestration` * `cross-product-intelligence` * `workflow-agents` * `in-app-notifications` * `code-extraction`
       "a_key": "A String",
     },
     "generativeAnswerConfig": { # Describes configuration for generative answer. # Describes generative answer configuration.
@@ -915,7 +915,7 @@ 
Method Details

     "enableSafeSearch": True or False, # Whether to enable safe search.
     "enableSearchAsYouType": True or False, # Whether to enable search-as-you-type behavior for the search widget.
     "enableVisualContentSummary": True or False, # If set to true, the widget will enable visual content summary on applicable search requests. Only used by healthcare search.
-    "features": { # Output only. Feature config for the engine to opt in or opt out of features. Supported keys: * `agent-gallery` * `no-code-agent-builder` * `prompt-gallery` * `model-selector` * `notebook-lm` * `people-search` * `people-search-org-chart` * `bi-directional-audio` * `speech-to-text` * `feedback` * `session-sharing` * `personalization-memory` * `personalization-suggested-highlights` * `mobile-app-access` * `disable-agent-sharing` * `disable-image-generation` * `disable-video-generation` * `disable-onedrive-upload` * `disable-talk-to-content` * `disable-google-drive-upload` * `disable-welcome-emails` * `disable-canvas` * `canvas-workspace` * `canvas-app-builder` * `skills` * `skill-sharing` * `skill-sharing-without-admin-approval` * `disable-projects` * `sobi` * `enable-end-user-sharing-with-groups` * `single-agent-orchestration` * `multi-agent-orchestration` * `cross-product-intelligence` * `workflow-agents` * `in-app-notifications`
+    "features": { # Output only. Feature config for the engine to opt in or opt out of features. Supported keys: * `agent-gallery` * `no-code-agent-builder` * `prompt-gallery` * `model-selector` * `notebook-lm` * `people-search` * `people-search-org-chart` * `bi-directional-audio` * `speech-to-text` * `feedback` * `session-sharing` * `personalization-memory` * `personalization-suggested-highlights` * `mobile-app-access` * `disable-agent-sharing` * `disable-image-generation` * `disable-video-generation` * `disable-onedrive-upload` * `disable-talk-to-content` * `disable-google-drive-upload` * `disable-welcome-emails` * `disable-canvas` * `canvas-workspace` * `canvas-app-builder` * `skills` * `skill-sharing` * `skill-sharing-without-admin-approval` * `disable-projects` * `sobi` * `enable-end-user-sharing-with-groups` * `single-agent-orchestration` * `multi-agent-orchestration` * `cross-product-intelligence` * `workflow-agents` * `in-app-notifications` * `code-extraction`
       "a_key": "A String",
     },
     "generativeAnswerConfig": { # Describes configuration for generative answer. # Describes generative answer configuration.
diff --git a/docs/dyn/discoveryengine_v1.projects.locations.dataStores.html b/docs/dyn/discoveryengine_v1.projects.locations.dataStores.html
index 2eebd1ace1..14277d0ba1 100644
--- a/docs/dyn/discoveryengine_v1.projects.locations.dataStores.html
+++ b/docs/dyn/discoveryengine_v1.projects.locations.dataStores.html
@@ -347,6 +347,9 @@ 
Method Details

       ],
     },
     "notebooklmConfig": { # Config for connecting to NotebookLM Enterprise. # NotebookLM config. If set, this DataStore is connected to NotebookLM Enterprise.
+      "notebooks": [ # Optional. Restricts this data store to the given notebooks. When empty, the data store covers every notebook the querying user can access, which is the existing behaviour. Each entry is a full notebook resource name, such as `projects/*/locations/*/notebooks/*`. Scoping is enforced on results as well as requested upstream, so a notebook outside this list cannot appear in a search response through this data store even if the backend returns one.
+        "A String",
+      ],
       "searchConfig": "A String", # Required. Search config name. Format: projects/*/locations/global/notebookLmSearchConfigs/*
     },
     "thirdPartyOauthConfig": { # Stores information for third party applicationOAuth. # Third Party OAuth config. If set, this DataStore is connected to a third party application.
@@ -597,6 +600,9 @@ 
Method Details

       ],
     },
     "notebooklmConfig": { # Config for connecting to NotebookLM Enterprise. # NotebookLM config. If set, this DataStore is connected to NotebookLM Enterprise.
+      "notebooks": [ # Optional. Restricts this data store to the given notebooks. When empty, the data store covers every notebook the querying user can access, which is the existing behaviour. Each entry is a full notebook resource name, such as `projects/*/locations/*/notebooks/*`. Scoping is enforced on results as well as requested upstream, so a notebook outside this list cannot appear in a search response through this data store even if the backend returns one.
+        "A String",
+      ],
       "searchConfig": "A String", # Required. Search config name. Format: projects/*/locations/global/notebookLmSearchConfigs/*
     },
     "thirdPartyOauthConfig": { # Stores information for third party applicationOAuth. # Third Party OAuth config. If set, this DataStore is connected to a third party application.
@@ -838,6 +844,9 @@ 
Method Details

           ],
         },
         "notebooklmConfig": { # Config for connecting to NotebookLM Enterprise. # NotebookLM config. If set, this DataStore is connected to NotebookLM Enterprise.
+          "notebooks": [ # Optional. Restricts this data store to the given notebooks. When empty, the data store covers every notebook the querying user can access, which is the existing behaviour. Each entry is a full notebook resource name, such as `projects/*/locations/*/notebooks/*`. Scoping is enforced on results as well as requested upstream, so a notebook outside this list cannot appear in a search response through this data store even if the backend returns one.
+            "A String",
+          ],
           "searchConfig": "A String", # Required. Search config name. Format: projects/*/locations/global/notebookLmSearchConfigs/*
         },
         "thirdPartyOauthConfig": { # Stores information for third party applicationOAuth. # Third Party OAuth config. If set, this DataStore is connected to a third party application.
@@ -1032,6 +1041,9 @@ 
Method Details

       ],
     },
     "notebooklmConfig": { # Config for connecting to NotebookLM Enterprise. # NotebookLM config. If set, this DataStore is connected to NotebookLM Enterprise.
+      "notebooks": [ # Optional. Restricts this data store to the given notebooks. When empty, the data store covers every notebook the querying user can access, which is the existing behaviour. Each entry is a full notebook resource name, such as `projects/*/locations/*/notebooks/*`. Scoping is enforced on results as well as requested upstream, so a notebook outside this list cannot appear in a search response through this data store even if the backend returns one.
+        "A String",
+      ],
       "searchConfig": "A String", # Required. Search config name. Format: projects/*/locations/global/notebookLmSearchConfigs/*
     },
     "thirdPartyOauthConfig": { # Stores information for third party applicationOAuth. # Third Party OAuth config. If set, this DataStore is connected to a third party application.
@@ -1208,6 +1220,9 @@ 
Method Details

       ],
     },
     "notebooklmConfig": { # Config for connecting to NotebookLM Enterprise. # NotebookLM config. If set, this DataStore is connected to NotebookLM Enterprise.
+      "notebooks": [ # Optional. Restricts this data store to the given notebooks. When empty, the data store covers every notebook the querying user can access, which is the existing behaviour. Each entry is a full notebook resource name, such as `projects/*/locations/*/notebooks/*`. Scoping is enforced on results as well as requested upstream, so a notebook outside this list cannot appear in a search response through this data store even if the backend returns one.
+        "A String",
+      ],
       "searchConfig": "A String", # Required. Search config name. Format: projects/*/locations/global/notebookLmSearchConfigs/*
     },
     "thirdPartyOauthConfig": { # Stores information for third party applicationOAuth. # Third Party OAuth config. If set, this DataStore is connected to a third party application.
diff --git a/docs/dyn/discoveryengine_v1.projects.locations.dataStores.servingConfigs.html b/docs/dyn/discoveryengine_v1.projects.locations.dataStores.servingConfigs.html
index 1407eb2f6e..3ec5022ae8 100644
--- a/docs/dyn/discoveryengine_v1.projects.locations.dataStores.servingConfigs.html
+++ b/docs/dyn/discoveryengine_v1.projects.locations.dataStores.servingConfigs.html
@@ -1454,7 +1454,9 @@ 
Method Details

         },
         "questionIndex": 42, # The index of the user input within the conversation messages.
         "session": "A String", # Name of the newly generated or continued session.
-        "taskName": "A String", # Optional. The full resource name of the Sobi task if the conversation was handled by a long-running agent task. Format: projects/{project}/locations/{location}/tasks/{task_id}
+        "stepSeqNum": "A String", # Optional. The `TaskServerEvent.seq_num` of the step that opened the rated agent task reply.
+        "taskName": "A String", # Optional. The full resource name of the Sobi task if the conversation was handled by a long-running agent task. Format (canonical, or the short alias the Task API also accepts): projects/{project}/locations/{location}/agents/{agent}/tasks/{task} projects/{project}/locations/{location}/tasks/{task}
+        "trajectoryId": "A String", # Optional. The runtime trajectory id of the rated agent task turn, as set on `TaskServerEvent.trajectory_id`. Shared by all steps of the turn.
       },
       "dataTermsAccepted": True or False, # Optional. Whether the customer accepted data use terms.
       "feedbackSource": "A String", # Optional. The UI component the user feedback comes from, which could be GOOGLE_CONSOLE, GOOGLE_WIDGET, GOOGLE_WEBAPP.
@@ -1706,7 +1708,7 @@ 
Method Details

       "A String",
     ],
   },
-  "dataStoreSpecs": [ # Specifications that define the specific DataStores to be searched, along with configurations for those data stores. This is only considered for Engines with multiple data stores. For engines with a single data store, the specs directly under SearchRequest should be used.
+  "dataStoreSpecs": [ # Specifications that define the specific DataStores to be searched, along with configurations for those data stores. This is only considered for Engines with multiple data stores. For engines with a single data store, the specs directly under SearchRequest should be used. On an engine with multiple data stores, this field is optional. If it's empty, all of the engine's data stores are searched (blended search). Unless it specifies exactly one data store, some request fields, such as `order_by` and `query_expansion_spec`, aren't supported and return an `INVALID_ARGUMENT` error.
     { # A struct to define data stores to filter on in a search call and configurations for those data stores. Otherwise, an `INVALID_ARGUMENT` error is returned.
       "boostSpec": { # Boost specification to boost certain documents. # Optional. Boost specification to boost certain documents. For more information on boosting, see [Boosting](https://cloud.google.com/generative-ai-app-builder/docs/boost-search-results)
         "conditionBoostSpecs": [ # Condition boost specifications. If a document matches multiple conditions in the specifications, boost scores from these specifications are all applied and combined in a non-linear way. Maximum number of specifications is 20.
@@ -2206,7 +2208,7 @@ 
Method Details

       "A String",
     ],
   },
-  "dataStoreSpecs": [ # Specifications that define the specific DataStores to be searched, along with configurations for those data stores. This is only considered for Engines with multiple data stores. For engines with a single data store, the specs directly under SearchRequest should be used.
+  "dataStoreSpecs": [ # Specifications that define the specific DataStores to be searched, along with configurations for those data stores. This is only considered for Engines with multiple data stores. For engines with a single data store, the specs directly under SearchRequest should be used. On an engine with multiple data stores, this field is optional. If it's empty, all of the engine's data stores are searched (blended search). Unless it specifies exactly one data store, some request fields, such as `order_by` and `query_expansion_spec`, aren't supported and return an `INVALID_ARGUMENT` error.
     { # A struct to define data stores to filter on in a search call and configurations for those data stores. Otherwise, an `INVALID_ARGUMENT` error is returned.
       "boostSpec": { # Boost specification to boost certain documents. # Optional. Boost specification to boost certain documents. For more information on boosting, see [Boosting](https://cloud.google.com/generative-ai-app-builder/docs/boost-search-results)
         "conditionBoostSpecs": [ # Condition boost specifications. If a document matches multiple conditions in the specifications, boost scores from these specifications are all applied and combined in a non-linear way. Maximum number of specifications is 20.
diff --git a/docs/dyn/discoveryengine_v1.projects.locations.dataStores.userEvents.html b/docs/dyn/discoveryengine_v1.projects.locations.dataStores.userEvents.html
index 2f2aed06f4..89865e0e81 100644
--- a/docs/dyn/discoveryengine_v1.projects.locations.dataStores.userEvents.html
+++ b/docs/dyn/discoveryengine_v1.projects.locations.dataStores.userEvents.html
@@ -204,7 +204,9 @@ 
Method Details

             },
             "questionIndex": 42, # The index of the user input within the conversation messages.
             "session": "A String", # Name of the newly generated or continued session.
-            "taskName": "A String", # Optional. The full resource name of the Sobi task if the conversation was handled by a long-running agent task. Format: projects/{project}/locations/{location}/tasks/{task_id}
+            "stepSeqNum": "A String", # Optional. The `TaskServerEvent.seq_num` of the step that opened the rated agent task reply.
+            "taskName": "A String", # Optional. The full resource name of the Sobi task if the conversation was handled by a long-running agent task. Format (canonical, or the short alias the Task API also accepts): projects/{project}/locations/{location}/agents/{agent}/tasks/{task} projects/{project}/locations/{location}/tasks/{task}
+            "trajectoryId": "A String", # Optional. The runtime trajectory id of the rated agent task turn, as set on `TaskServerEvent.trajectory_id`. Shared by all steps of the turn.
           },
           "dataTermsAccepted": True or False, # Optional. Whether the customer accepted data use terms.
           "feedbackSource": "A String", # Optional. The UI component the user feedback comes from, which could be GOOGLE_CONSOLE, GOOGLE_WIDGET, GOOGLE_WEBAPP.
@@ -432,7 +434,9 @@ 
Method Details

       },
       "questionIndex": 42, # The index of the user input within the conversation messages.
       "session": "A String", # Name of the newly generated or continued session.
-      "taskName": "A String", # Optional. The full resource name of the Sobi task if the conversation was handled by a long-running agent task. Format: projects/{project}/locations/{location}/tasks/{task_id}
+      "stepSeqNum": "A String", # Optional. The `TaskServerEvent.seq_num` of the step that opened the rated agent task reply.
+      "taskName": "A String", # Optional. The full resource name of the Sobi task if the conversation was handled by a long-running agent task. Format (canonical, or the short alias the Task API also accepts): projects/{project}/locations/{location}/agents/{agent}/tasks/{task} projects/{project}/locations/{location}/tasks/{task}
+      "trajectoryId": "A String", # Optional. The runtime trajectory id of the rated agent task turn, as set on `TaskServerEvent.trajectory_id`. Shared by all steps of the turn.
     },
     "dataTermsAccepted": True or False, # Optional. Whether the customer accepted data use terms.
     "feedbackSource": "A String", # Optional. The UI component the user feedback comes from, which could be GOOGLE_CONSOLE, GOOGLE_WIDGET, GOOGLE_WEBAPP.
@@ -585,7 +589,9 @@ 
Method Details

       },
       "questionIndex": 42, # The index of the user input within the conversation messages.
       "session": "A String", # Name of the newly generated or continued session.
-      "taskName": "A String", # Optional. The full resource name of the Sobi task if the conversation was handled by a long-running agent task. Format: projects/{project}/locations/{location}/tasks/{task_id}
+      "stepSeqNum": "A String", # Optional. The `TaskServerEvent.seq_num` of the step that opened the rated agent task reply.
+      "taskName": "A String", # Optional. The full resource name of the Sobi task if the conversation was handled by a long-running agent task. Format (canonical, or the short alias the Task API also accepts): projects/{project}/locations/{location}/agents/{agent}/tasks/{task} projects/{project}/locations/{location}/tasks/{task}
+      "trajectoryId": "A String", # Optional. The runtime trajectory id of the rated agent task turn, as set on `TaskServerEvent.trajectory_id`. Shared by all steps of the turn.
     },
     "dataTermsAccepted": True or False, # Optional. Whether the customer accepted data use terms.
     "feedbackSource": "A String", # Optional. The UI component the user feedback comes from, which could be GOOGLE_CONSOLE, GOOGLE_WIDGET, GOOGLE_WEBAPP.
diff --git a/docs/dyn/discoveryengine_v1.projects.locations.dataStores.widgetConfigs.html b/docs/dyn/discoveryengine_v1.projects.locations.dataStores.widgetConfigs.html
index 60114178d0..e0546111ab 100644
--- a/docs/dyn/discoveryengine_v1.projects.locations.dataStores.widgetConfigs.html
+++ b/docs/dyn/discoveryengine_v1.projects.locations.dataStores.widgetConfigs.html
@@ -336,7 +336,7 @@ 
Method Details

     "enableSafeSearch": True or False, # Whether to enable safe search.
     "enableSearchAsYouType": True or False, # Whether to enable search-as-you-type behavior for the search widget.
     "enableVisualContentSummary": True or False, # If set to true, the widget will enable visual content summary on applicable search requests. Only used by healthcare search.
-    "features": { # Output only. Feature config for the engine to opt in or opt out of features. Supported keys: * `agent-gallery` * `no-code-agent-builder` * `prompt-gallery` * `model-selector` * `notebook-lm` * `people-search` * `people-search-org-chart` * `bi-directional-audio` * `speech-to-text` * `feedback` * `session-sharing` * `personalization-memory` * `personalization-suggested-highlights` * `mobile-app-access` * `disable-agent-sharing` * `disable-image-generation` * `disable-video-generation` * `disable-onedrive-upload` * `disable-talk-to-content` * `disable-google-drive-upload` * `disable-welcome-emails` * `disable-canvas` * `canvas-workspace` * `canvas-app-builder` * `skills` * `skill-sharing` * `skill-sharing-without-admin-approval` * `disable-projects` * `sobi` * `enable-end-user-sharing-with-groups` * `single-agent-orchestration` * `multi-agent-orchestration` * `cross-product-intelligence` * `workflow-agents` * `in-app-notifications`
+    "features": { # Output only. Feature config for the engine to opt in or opt out of features. Supported keys: * `agent-gallery` * `no-code-agent-builder` * `prompt-gallery` * `model-selector` * `notebook-lm` * `people-search` * `people-search-org-chart` * `bi-directional-audio` * `speech-to-text` * `feedback` * `session-sharing` * `personalization-memory` * `personalization-suggested-highlights` * `mobile-app-access` * `disable-agent-sharing` * `disable-image-generation` * `disable-video-generation` * `disable-onedrive-upload` * `disable-talk-to-content` * `disable-google-drive-upload` * `disable-welcome-emails` * `disable-canvas` * `canvas-workspace` * `canvas-app-builder` * `skills` * `skill-sharing` * `skill-sharing-without-admin-approval` * `disable-projects` * `sobi` * `enable-end-user-sharing-with-groups` * `single-agent-orchestration` * `multi-agent-orchestration` * `cross-product-intelligence` * `workflow-agents` * `in-app-notifications` * `code-extraction`
       "a_key": "A String",
     },
     "generativeAnswerConfig": { # Describes configuration for generative answer. # Describes generative answer configuration.
@@ -626,7 +626,7 @@ 
Method Details

     "enableSafeSearch": True or False, # Whether to enable safe search.
     "enableSearchAsYouType": True or False, # Whether to enable search-as-you-type behavior for the search widget.
     "enableVisualContentSummary": True or False, # If set to true, the widget will enable visual content summary on applicable search requests. Only used by healthcare search.
-    "features": { # Output only. Feature config for the engine to opt in or opt out of features. Supported keys: * `agent-gallery` * `no-code-agent-builder` * `prompt-gallery` * `model-selector` * `notebook-lm` * `people-search` * `people-search-org-chart` * `bi-directional-audio` * `speech-to-text` * `feedback` * `session-sharing` * `personalization-memory` * `personalization-suggested-highlights` * `mobile-app-access` * `disable-agent-sharing` * `disable-image-generation` * `disable-video-generation` * `disable-onedrive-upload` * `disable-talk-to-content` * `disable-google-drive-upload` * `disable-welcome-emails` * `disable-canvas` * `canvas-workspace` * `canvas-app-builder` * `skills` * `skill-sharing` * `skill-sharing-without-admin-approval` * `disable-projects` * `sobi` * `enable-end-user-sharing-with-groups` * `single-agent-orchestration` * `multi-agent-orchestration` * `cross-product-intelligence` * `workflow-agents` * `in-app-notifications`
+    "features": { # Output only. Feature config for the engine to opt in or opt out of features. Supported keys: * `agent-gallery` * `no-code-agent-builder` * `prompt-gallery` * `model-selector` * `notebook-lm` * `people-search` * `people-search-org-chart` * `bi-directional-audio` * `speech-to-text` * `feedback` * `session-sharing` * `personalization-memory` * `personalization-suggested-highlights` * `mobile-app-access` * `disable-agent-sharing` * `disable-image-generation` * `disable-video-generation` * `disable-onedrive-upload` * `disable-talk-to-content` * `disable-google-drive-upload` * `disable-welcome-emails` * `disable-canvas` * `canvas-workspace` * `canvas-app-builder` * `skills` * `skill-sharing` * `skill-sharing-without-admin-approval` * `disable-projects` * `sobi` * `enable-end-user-sharing-with-groups` * `single-agent-orchestration` * `multi-agent-orchestration` * `cross-product-intelligence` * `workflow-agents` * `in-app-notifications` * `code-extraction`
       "a_key": "A String",
     },
     "generativeAnswerConfig": { # Describes configuration for generative answer. # Describes generative answer configuration.
@@ -915,7 +915,7 @@ 
Method Details

     "enableSafeSearch": True or False, # Whether to enable safe search.
     "enableSearchAsYouType": True or False, # Whether to enable search-as-you-type behavior for the search widget.
     "enableVisualContentSummary": True or False, # If set to true, the widget will enable visual content summary on applicable search requests. Only used by healthcare search.
-    "features": { # Output only. Feature config for the engine to opt in or opt out of features. Supported keys: * `agent-gallery` * `no-code-agent-builder` * `prompt-gallery` * `model-selector` * `notebook-lm` * `people-search` * `people-search-org-chart` * `bi-directional-audio` * `speech-to-text` * `feedback` * `session-sharing` * `personalization-memory` * `personalization-suggested-highlights` * `mobile-app-access` * `disable-agent-sharing` * `disable-image-generation` * `disable-video-generation` * `disable-onedrive-upload` * `disable-talk-to-content` * `disable-google-drive-upload` * `disable-welcome-emails` * `disable-canvas` * `canvas-workspace` * `canvas-app-builder` * `skills` * `skill-sharing` * `skill-sharing-without-admin-approval` * `disable-projects` * `sobi` * `enable-end-user-sharing-with-groups` * `single-agent-orchestration` * `multi-agent-orchestration` * `cross-product-intelligence` * `workflow-agents` * `in-app-notifications`
+    "features": { # Output only. Feature config for the engine to opt in or opt out of features. Supported keys: * `agent-gallery` * `no-code-agent-builder` * `prompt-gallery` * `model-selector` * `notebook-lm` * `people-search` * `people-search-org-chart` * `bi-directional-audio` * `speech-to-text` * `feedback` * `session-sharing` * `personalization-memory` * `personalization-suggested-highlights` * `mobile-app-access` * `disable-agent-sharing` * `disable-image-generation` * `disable-video-generation` * `disable-onedrive-upload` * `disable-talk-to-content` * `disable-google-drive-upload` * `disable-welcome-emails` * `disable-canvas` * `canvas-workspace` * `canvas-app-builder` * `skills` * `skill-sharing` * `skill-sharing-without-admin-approval` * `disable-projects` * `sobi` * `enable-end-user-sharing-with-groups` * `single-agent-orchestration` * `multi-agent-orchestration` * `cross-product-intelligence` * `workflow-agents` * `in-app-notifications` * `code-extraction`
       "a_key": "A String",
     },
     "generativeAnswerConfig": { # Describes configuration for generative answer. # Describes generative answer configuration.
diff --git a/docs/dyn/discoveryengine_v1.projects.locations.userEvents.html b/docs/dyn/discoveryengine_v1.projects.locations.userEvents.html
index 39ddb5c1e3..60b916f4a5 100644
--- a/docs/dyn/discoveryengine_v1.projects.locations.userEvents.html
+++ b/docs/dyn/discoveryengine_v1.projects.locations.userEvents.html
@@ -201,7 +201,9 @@ 
Method Details

             },
             "questionIndex": 42, # The index of the user input within the conversation messages.
             "session": "A String", # Name of the newly generated or continued session.
-            "taskName": "A String", # Optional. The full resource name of the Sobi task if the conversation was handled by a long-running agent task. Format: projects/{project}/locations/{location}/tasks/{task_id}
+            "stepSeqNum": "A String", # Optional. The `TaskServerEvent.seq_num` of the step that opened the rated agent task reply.
+            "taskName": "A String", # Optional. The full resource name of the Sobi task if the conversation was handled by a long-running agent task. Format (canonical, or the short alias the Task API also accepts): projects/{project}/locations/{location}/agents/{agent}/tasks/{task} projects/{project}/locations/{location}/tasks/{task}
+            "trajectoryId": "A String", # Optional. The runtime trajectory id of the rated agent task turn, as set on `TaskServerEvent.trajectory_id`. Shared by all steps of the turn.
           },
           "dataTermsAccepted": True or False, # Optional. Whether the customer accepted data use terms.
           "feedbackSource": "A String", # Optional. The UI component the user feedback comes from, which could be GOOGLE_CONSOLE, GOOGLE_WIDGET, GOOGLE_WEBAPP.
@@ -386,7 +388,9 @@ 
Method Details

       },
       "questionIndex": 42, # The index of the user input within the conversation messages.
       "session": "A String", # Name of the newly generated or continued session.
-      "taskName": "A String", # Optional. The full resource name of the Sobi task if the conversation was handled by a long-running agent task. Format: projects/{project}/locations/{location}/tasks/{task_id}
+      "stepSeqNum": "A String", # Optional. The `TaskServerEvent.seq_num` of the step that opened the rated agent task reply.
+      "taskName": "A String", # Optional. The full resource name of the Sobi task if the conversation was handled by a long-running agent task. Format (canonical, or the short alias the Task API also accepts): projects/{project}/locations/{location}/agents/{agent}/tasks/{task} projects/{project}/locations/{location}/tasks/{task}
+      "trajectoryId": "A String", # Optional. The runtime trajectory id of the rated agent task turn, as set on `TaskServerEvent.trajectory_id`. Shared by all steps of the turn.
     },
     "dataTermsAccepted": True or False, # Optional. Whether the customer accepted data use terms.
     "feedbackSource": "A String", # Optional. The UI component the user feedback comes from, which could be GOOGLE_CONSOLE, GOOGLE_WIDGET, GOOGLE_WEBAPP.
@@ -539,7 +543,9 @@ 
Method Details

       },
       "questionIndex": 42, # The index of the user input within the conversation messages.
       "session": "A String", # Name of the newly generated or continued session.
-      "taskName": "A String", # Optional. The full resource name of the Sobi task if the conversation was handled by a long-running agent task. Format: projects/{project}/locations/{location}/tasks/{task_id}
+      "stepSeqNum": "A String", # Optional. The `TaskServerEvent.seq_num` of the step that opened the rated agent task reply.
+      "taskName": "A String", # Optional. The full resource name of the Sobi task if the conversation was handled by a long-running agent task. Format (canonical, or the short alias the Task API also accepts): projects/{project}/locations/{location}/agents/{agent}/tasks/{task} projects/{project}/locations/{location}/tasks/{task}
+      "trajectoryId": "A String", # Optional. The runtime trajectory id of the rated agent task turn, as set on `TaskServerEvent.trajectory_id`. Shared by all steps of the turn.
     },
     "dataTermsAccepted": True or False, # Optional. Whether the customer accepted data use terms.
     "feedbackSource": "A String", # Optional. The UI component the user feedback comes from, which could be GOOGLE_CONSOLE, GOOGLE_WIDGET, GOOGLE_WEBAPP.
diff --git a/docs/dyn/discoveryengine_v1alpha.projects.locations.authorizations.html b/docs/dyn/discoveryengine_v1alpha.projects.locations.authorizations.html
index e94701714b..6cf0063dc7 100644
--- a/docs/dyn/discoveryengine_v1alpha.projects.locations.authorizations.html
+++ b/docs/dyn/discoveryengine_v1alpha.projects.locations.authorizations.html
@@ -119,6 +119,9 @@ 
Method Details

     "clientId": "A String", # Required. The OAuth2 client ID.
     "clientSecret": "A String", # Required. The OAuth2 client secret. Encrypted at rest.
     "pkceVerificationEnabled": True or False, # Optional. Whether to enable PKCE verification. https://datatracker.ietf.org/doc/html/rfc7636#section-3.1/
+    "privateNetworkConfig": { # Identifies the instance hosting an OAuth provider that is reachable only over a private network. # Optional. Set only when the OAuth provider publishes no public endpoint, in which case a token exchange has to be routed over the private network the instance is on instead of over public egress. Leaving it unset keeps the exchange on public egress.
+      "instanceResource": "A String", # Required. Resource name of the instance hosting the OAuth provider. For Looker, the Looker instance, in the form `projects/{project}/locations/{location}/instances/{instance}`.
+    },
     "scopes": [ # Optional. The scopes to request. Example: `https://www.googleapis.com/auth/calendar.events` If omitted, no additional scopes are requested beyond those required by the authorization uri. If set, it will overwrite the scopes in the authorization uri when acquiring user authorization.
       "A String",
     ],
@@ -144,6 +147,9 @@ 
Method Details

     "clientId": "A String", # Required. The OAuth2 client ID.
     "clientSecret": "A String", # Required. The OAuth2 client secret. Encrypted at rest.
     "pkceVerificationEnabled": True or False, # Optional. Whether to enable PKCE verification. https://datatracker.ietf.org/doc/html/rfc7636#section-3.1/
+    "privateNetworkConfig": { # Identifies the instance hosting an OAuth provider that is reachable only over a private network. # Optional. Set only when the OAuth provider publishes no public endpoint, in which case a token exchange has to be routed over the private network the instance is on instead of over public egress. Leaving it unset keeps the exchange on public egress.
+      "instanceResource": "A String", # Required. Resource name of the instance hosting the OAuth provider. For Looker, the Looker instance, in the form `projects/{project}/locations/{location}/instances/{instance}`.
+    },
     "scopes": [ # Optional. The scopes to request. Example: `https://www.googleapis.com/auth/calendar.events` If omitted, no additional scopes are requested beyond those required by the authorization uri. If set, it will overwrite the scopes in the authorization uri when acquiring user authorization.
       "A String",
     ],
@@ -193,6 +199,9 @@ 
Method Details

     "clientId": "A String", # Required. The OAuth2 client ID.
     "clientSecret": "A String", # Required. The OAuth2 client secret. Encrypted at rest.
     "pkceVerificationEnabled": True or False, # Optional. Whether to enable PKCE verification. https://datatracker.ietf.org/doc/html/rfc7636#section-3.1/
+    "privateNetworkConfig": { # Identifies the instance hosting an OAuth provider that is reachable only over a private network. # Optional. Set only when the OAuth provider publishes no public endpoint, in which case a token exchange has to be routed over the private network the instance is on instead of over public egress. Leaving it unset keeps the exchange on public egress.
+      "instanceResource": "A String", # Required. Resource name of the instance hosting the OAuth provider. For Looker, the Looker instance, in the form `projects/{project}/locations/{location}/instances/{instance}`.
+    },
     "scopes": [ # Optional. The scopes to request. Example: `https://www.googleapis.com/auth/calendar.events` If omitted, no additional scopes are requested beyond those required by the authorization uri. If set, it will overwrite the scopes in the authorization uri when acquiring user authorization.
       "A String",
     ],
@@ -228,6 +237,9 @@ 
Method Details

         "clientId": "A String", # Required. The OAuth2 client ID.
         "clientSecret": "A String", # Required. The OAuth2 client secret. Encrypted at rest.
         "pkceVerificationEnabled": True or False, # Optional. Whether to enable PKCE verification. https://datatracker.ietf.org/doc/html/rfc7636#section-3.1/
+        "privateNetworkConfig": { # Identifies the instance hosting an OAuth provider that is reachable only over a private network. # Optional. Set only when the OAuth provider publishes no public endpoint, in which case a token exchange has to be routed over the private network the instance is on instead of over public egress. Leaving it unset keeps the exchange on public egress.
+          "instanceResource": "A String", # Required. Resource name of the instance hosting the OAuth provider. For Looker, the Looker instance, in the form `projects/{project}/locations/{location}/instances/{instance}`.
+        },
         "scopes": [ # Optional. The scopes to request. Example: `https://www.googleapis.com/auth/calendar.events` If omitted, no additional scopes are requested beyond those required by the authorization uri. If set, it will overwrite the scopes in the authorization uri when acquiring user authorization.
           "A String",
         ],
@@ -271,6 +283,9 @@ 
Method Details

     "clientId": "A String", # Required. The OAuth2 client ID.
     "clientSecret": "A String", # Required. The OAuth2 client secret. Encrypted at rest.
     "pkceVerificationEnabled": True or False, # Optional. Whether to enable PKCE verification. https://datatracker.ietf.org/doc/html/rfc7636#section-3.1/
+    "privateNetworkConfig": { # Identifies the instance hosting an OAuth provider that is reachable only over a private network. # Optional. Set only when the OAuth provider publishes no public endpoint, in which case a token exchange has to be routed over the private network the instance is on instead of over public egress. Leaving it unset keeps the exchange on public egress.
+      "instanceResource": "A String", # Required. Resource name of the instance hosting the OAuth provider. For Looker, the Looker instance, in the form `projects/{project}/locations/{location}/instances/{instance}`.
+    },
     "scopes": [ # Optional. The scopes to request. Example: `https://www.googleapis.com/auth/calendar.events` If omitted, no additional scopes are requested beyond those required by the authorization uri. If set, it will overwrite the scopes in the authorization uri when acquiring user authorization.
       "A String",
     ],
@@ -296,6 +311,9 @@ 
Method Details

     "clientId": "A String", # Required. The OAuth2 client ID.
     "clientSecret": "A String", # Required. The OAuth2 client secret. Encrypted at rest.
     "pkceVerificationEnabled": True or False, # Optional. Whether to enable PKCE verification. https://datatracker.ietf.org/doc/html/rfc7636#section-3.1/
+    "privateNetworkConfig": { # Identifies the instance hosting an OAuth provider that is reachable only over a private network. # Optional. Set only when the OAuth provider publishes no public endpoint, in which case a token exchange has to be routed over the private network the instance is on instead of over public egress. Leaving it unset keeps the exchange on public egress.
+      "instanceResource": "A String", # Required. Resource name of the instance hosting the OAuth provider. For Looker, the Looker instance, in the form `projects/{project}/locations/{location}/instances/{instance}`.
+    },
     "scopes": [ # Optional. The scopes to request. Example: `https://www.googleapis.com/auth/calendar.events` If omitted, no additional scopes are requested beyond those required by the authorization uri. If set, it will overwrite the scopes in the authorization uri when acquiring user authorization.
       "A String",
     ],
diff --git a/docs/dyn/discoveryengine_v1alpha.projects.locations.collections.dataStores.html b/docs/dyn/discoveryengine_v1alpha.projects.locations.collections.dataStores.html
index c40072558f..ae49e025a7 100644
--- a/docs/dyn/discoveryengine_v1alpha.projects.locations.collections.dataStores.html
+++ b/docs/dyn/discoveryengine_v1alpha.projects.locations.collections.dataStores.html
@@ -424,6 +424,9 @@ 
Method Details

       ],
     },
     "notebooklmConfig": { # Config for connecting to NotebookLM Enterprise. # NotebookLM config. If set, this DataStore is connected to NotebookLM Enterprise.
+      "notebooks": [ # Optional. Restricts this data store to the given notebooks. When empty, the data store covers every notebook the querying user can access, which is the existing behaviour. Each entry is a full notebook resource name, such as `projects/*/locations/*/notebooks/*`. Scoping is enforced on results as well as requested upstream, so a notebook outside this list cannot appear in a search response through this data store even if the backend returns one.
+        "A String",
+      ],
       "searchConfig": "A String", # Required. Search config name. Format: projects/*/locations/global/notebookLmSearchConfigs/*
     },
     "thirdPartyOauthConfig": { # Stores information for third party applicationOAuth. # Third Party OAuth config. If set, this DataStore is connected to a third party application.
@@ -478,6 +481,8 @@ 
Method Details

         "indexableOption": "A String", # If indexable_option is INDEXABLE_ENABLED, field values are indexed so that it can be filtered or faceted in SearchService.Search. If indexable_option is unset, the server behavior defaults to INDEXABLE_DISABLED for fields that support setting indexable options. For those fields that do not support setting indexable options, such as `object` and `boolean` and key properties, the server will skip indexable_option setting, and setting indexable_option for those fields will throw `INVALID_ARGUMENT` error.
         "keyPropertyType": "A String", # Output only. Type of the key property that this field is mapped to. Empty string if this is not annotated as mapped to a key property. Example types are `title`, `description`. Full list is defined by `keyPropertyMapping` in the schema field annotation. If the schema field has a `KeyPropertyMapping` annotation, `indexable_option` and `searchable_option` of this field cannot be modified.
         "metatagName": "A String", # Optional. The metatag name found in the HTML page. If user defines this field, the value of this metatag name will be used to extract metatag. If the user does not define this field, the FieldConfig.field_path will be used to extract metatag.
+        "partialMatchableOption": "A String", # Optional. If partial_matchable_option is PARTIAL_MATCHABLE_OPTION_ENABLED, field values are partial matchable. If partial_matchable_option is unset, the server behavior defaults to PARTIAL_MATCHABLE_OPTION_DISABLED for fields that support setting partial matchable options. For those fields that do not support setting partial matchable options, the server will skip partial matchable option setting, and setting partial_matchable_option for those fields will throw `INVALID_ARGUMENT` error.
+        "prefixMatchableOption": "A String", # Optional. If prefix_matchable_option is PREFIX_MATCHABLE_OPTION_ENABLED, field values are prefix matchable. If prefix_matchable_option is unset, the server behavior defaults to PREFIX_MATCHABLE_OPTION_DISABLED for fields that support setting prefix matchable options. For those fields that do not support setting prefix matchable options, the server will skip prefix matchable option setting, and setting prefix_matchable_option for those fields will throw `INVALID_ARGUMENT` error.
         "recsFilterableOption": "A String", # If recs_filterable_option is FILTERABLE_ENABLED, field values are filterable by filter expression in RecommendationService.Recommend. If FILTERABLE_ENABLED but the field type is numerical, field values are not filterable by text queries in RecommendationService.Recommend. Only textual fields are supported. If recs_filterable_option is unset, the default setting is FILTERABLE_DISABLED for fields that support setting filterable options. When a field set to [FILTERABLE_DISABLED] is filtered, a warning is generated and an empty result is returned.
         "retrievableOption": "A String", # If retrievable_option is RETRIEVABLE_ENABLED, field values are included in the search results. If retrievable_option is unset, the server behavior defaults to RETRIEVABLE_DISABLED for fields that support setting retrievable options. For those fields that do not support setting retrievable options, such as `object` and `boolean`, the server will skip retrievable option setting, and setting retrievable_option for those fields will throw `INVALID_ARGUMENT` error.
         "schemaOrgPaths": [ # Field paths for indexing custom attribute from schema.org data. More details of schema.org and its defined types can be found at [schema.org](https://schema.org). It is only used on advanced site search schema. Currently only support full path from root. The full path to a field is constructed by concatenating field names, starting from `_root`, with a period `.` as the delimiter. Examples: * Publish date of the root: _root.datePublished * Publish date of the reviews: _root.review.datePublished
@@ -755,6 +760,9 @@ 
Method Details

       ],
     },
     "notebooklmConfig": { # Config for connecting to NotebookLM Enterprise. # NotebookLM config. If set, this DataStore is connected to NotebookLM Enterprise.
+      "notebooks": [ # Optional. Restricts this data store to the given notebooks. When empty, the data store covers every notebook the querying user can access, which is the existing behaviour. Each entry is a full notebook resource name, such as `projects/*/locations/*/notebooks/*`. Scoping is enforced on results as well as requested upstream, so a notebook outside this list cannot appear in a search response through this data store even if the backend returns one.
+        "A String",
+      ],
       "searchConfig": "A String", # Required. Search config name. Format: projects/*/locations/global/notebookLmSearchConfigs/*
     },
     "thirdPartyOauthConfig": { # Stores information for third party applicationOAuth. # Third Party OAuth config. If set, this DataStore is connected to a third party application.
@@ -809,6 +817,8 @@ 
Method Details

         "indexableOption": "A String", # If indexable_option is INDEXABLE_ENABLED, field values are indexed so that it can be filtered or faceted in SearchService.Search. If indexable_option is unset, the server behavior defaults to INDEXABLE_DISABLED for fields that support setting indexable options. For those fields that do not support setting indexable options, such as `object` and `boolean` and key properties, the server will skip indexable_option setting, and setting indexable_option for those fields will throw `INVALID_ARGUMENT` error.
         "keyPropertyType": "A String", # Output only. Type of the key property that this field is mapped to. Empty string if this is not annotated as mapped to a key property. Example types are `title`, `description`. Full list is defined by `keyPropertyMapping` in the schema field annotation. If the schema field has a `KeyPropertyMapping` annotation, `indexable_option` and `searchable_option` of this field cannot be modified.
         "metatagName": "A String", # Optional. The metatag name found in the HTML page. If user defines this field, the value of this metatag name will be used to extract metatag. If the user does not define this field, the FieldConfig.field_path will be used to extract metatag.
+        "partialMatchableOption": "A String", # Optional. If partial_matchable_option is PARTIAL_MATCHABLE_OPTION_ENABLED, field values are partial matchable. If partial_matchable_option is unset, the server behavior defaults to PARTIAL_MATCHABLE_OPTION_DISABLED for fields that support setting partial matchable options. For those fields that do not support setting partial matchable options, the server will skip partial matchable option setting, and setting partial_matchable_option for those fields will throw `INVALID_ARGUMENT` error.
+        "prefixMatchableOption": "A String", # Optional. If prefix_matchable_option is PREFIX_MATCHABLE_OPTION_ENABLED, field values are prefix matchable. If prefix_matchable_option is unset, the server behavior defaults to PREFIX_MATCHABLE_OPTION_DISABLED for fields that support setting prefix matchable options. For those fields that do not support setting prefix matchable options, the server will skip prefix matchable option setting, and setting prefix_matchable_option for those fields will throw `INVALID_ARGUMENT` error.
         "recsFilterableOption": "A String", # If recs_filterable_option is FILTERABLE_ENABLED, field values are filterable by filter expression in RecommendationService.Recommend. If FILTERABLE_ENABLED but the field type is numerical, field values are not filterable by text queries in RecommendationService.Recommend. Only textual fields are supported. If recs_filterable_option is unset, the default setting is FILTERABLE_DISABLED for fields that support setting filterable options. When a field set to [FILTERABLE_DISABLED] is filtered, a warning is generated and an empty result is returned.
         "retrievableOption": "A String", # If retrievable_option is RETRIEVABLE_ENABLED, field values are included in the search results. If retrievable_option is unset, the server behavior defaults to RETRIEVABLE_DISABLED for fields that support setting retrievable options. For those fields that do not support setting retrievable options, such as `object` and `boolean`, the server will skip retrievable option setting, and setting retrievable_option for those fields will throw `INVALID_ARGUMENT` error.
         "schemaOrgPaths": [ # Field paths for indexing custom attribute from schema.org data. More details of schema.org and its defined types can be found at [schema.org](https://schema.org). It is only used on advanced site search schema. Currently only support full path from root. The full path to a field is constructed by concatenating field names, starting from `_root`, with a period `.` as the delimiter. Examples: * Publish date of the root: _root.datePublished * Publish date of the reviews: _root.review.datePublished
@@ -1146,6 +1156,9 @@ 
Method Details

           ],
         },
         "notebooklmConfig": { # Config for connecting to NotebookLM Enterprise. # NotebookLM config. If set, this DataStore is connected to NotebookLM Enterprise.
+          "notebooks": [ # Optional. Restricts this data store to the given notebooks. When empty, the data store covers every notebook the querying user can access, which is the existing behaviour. Each entry is a full notebook resource name, such as `projects/*/locations/*/notebooks/*`. Scoping is enforced on results as well as requested upstream, so a notebook outside this list cannot appear in a search response through this data store even if the backend returns one.
+            "A String",
+          ],
           "searchConfig": "A String", # Required. Search config name. Format: projects/*/locations/global/notebookLmSearchConfigs/*
         },
         "thirdPartyOauthConfig": { # Stores information for third party applicationOAuth. # Third Party OAuth config. If set, this DataStore is connected to a third party application.
@@ -1200,6 +1213,8 @@ 
Method Details

             "indexableOption": "A String", # If indexable_option is INDEXABLE_ENABLED, field values are indexed so that it can be filtered or faceted in SearchService.Search. If indexable_option is unset, the server behavior defaults to INDEXABLE_DISABLED for fields that support setting indexable options. For those fields that do not support setting indexable options, such as `object` and `boolean` and key properties, the server will skip indexable_option setting, and setting indexable_option for those fields will throw `INVALID_ARGUMENT` error.
             "keyPropertyType": "A String", # Output only. Type of the key property that this field is mapped to. Empty string if this is not annotated as mapped to a key property. Example types are `title`, `description`. Full list is defined by `keyPropertyMapping` in the schema field annotation. If the schema field has a `KeyPropertyMapping` annotation, `indexable_option` and `searchable_option` of this field cannot be modified.
             "metatagName": "A String", # Optional. The metatag name found in the HTML page. If user defines this field, the value of this metatag name will be used to extract metatag. If the user does not define this field, the FieldConfig.field_path will be used to extract metatag.
+            "partialMatchableOption": "A String", # Optional. If partial_matchable_option is PARTIAL_MATCHABLE_OPTION_ENABLED, field values are partial matchable. If partial_matchable_option is unset, the server behavior defaults to PARTIAL_MATCHABLE_OPTION_DISABLED for fields that support setting partial matchable options. For those fields that do not support setting partial matchable options, the server will skip partial matchable option setting, and setting partial_matchable_option for those fields will throw `INVALID_ARGUMENT` error.
+            "prefixMatchableOption": "A String", # Optional. If prefix_matchable_option is PREFIX_MATCHABLE_OPTION_ENABLED, field values are prefix matchable. If prefix_matchable_option is unset, the server behavior defaults to PREFIX_MATCHABLE_OPTION_DISABLED for fields that support setting prefix matchable options. For those fields that do not support setting prefix matchable options, the server will skip prefix matchable option setting, and setting prefix_matchable_option for those fields will throw `INVALID_ARGUMENT` error.
             "recsFilterableOption": "A String", # If recs_filterable_option is FILTERABLE_ENABLED, field values are filterable by filter expression in RecommendationService.Recommend. If FILTERABLE_ENABLED but the field type is numerical, field values are not filterable by text queries in RecommendationService.Recommend. Only textual fields are supported. If recs_filterable_option is unset, the default setting is FILTERABLE_DISABLED for fields that support setting filterable options. When a field set to [FILTERABLE_DISABLED] is filtered, a warning is generated and an empty result is returned.
             "retrievableOption": "A String", # If retrievable_option is RETRIEVABLE_ENABLED, field values are included in the search results. If retrievable_option is unset, the server behavior defaults to RETRIEVABLE_DISABLED for fields that support setting retrievable options. For those fields that do not support setting retrievable options, such as `object` and `boolean`, the server will skip retrievable option setting, and setting retrievable_option for those fields will throw `INVALID_ARGUMENT` error.
             "schemaOrgPaths": [ # Field paths for indexing custom attribute from schema.org data. More details of schema.org and its defined types can be found at [schema.org](https://schema.org). It is only used on advanced site search schema. Currently only support full path from root. The full path to a field is constructed by concatenating field names, starting from `_root`, with a period `.` as the delimiter. Examples: * Publish date of the root: _root.datePublished * Publish date of the reviews: _root.review.datePublished
@@ -1374,6 +1389,9 @@ 
Method Details

       ],
     },
     "notebooklmConfig": { # Config for connecting to NotebookLM Enterprise. # NotebookLM config. If set, this DataStore is connected to NotebookLM Enterprise.
+      "notebooks": [ # Optional. Restricts this data store to the given notebooks. When empty, the data store covers every notebook the querying user can access, which is the existing behaviour. Each entry is a full notebook resource name, such as `projects/*/locations/*/notebooks/*`. Scoping is enforced on results as well as requested upstream, so a notebook outside this list cannot appear in a search response through this data store even if the backend returns one.
+        "A String",
+      ],
       "searchConfig": "A String", # Required. Search config name. Format: projects/*/locations/global/notebookLmSearchConfigs/*
     },
     "thirdPartyOauthConfig": { # Stores information for third party applicationOAuth. # Third Party OAuth config. If set, this DataStore is connected to a third party application.
@@ -1428,6 +1446,8 @@ 
Method Details

         "indexableOption": "A String", # If indexable_option is INDEXABLE_ENABLED, field values are indexed so that it can be filtered or faceted in SearchService.Search. If indexable_option is unset, the server behavior defaults to INDEXABLE_DISABLED for fields that support setting indexable options. For those fields that do not support setting indexable options, such as `object` and `boolean` and key properties, the server will skip indexable_option setting, and setting indexable_option for those fields will throw `INVALID_ARGUMENT` error.
         "keyPropertyType": "A String", # Output only. Type of the key property that this field is mapped to. Empty string if this is not annotated as mapped to a key property. Example types are `title`, `description`. Full list is defined by `keyPropertyMapping` in the schema field annotation. If the schema field has a `KeyPropertyMapping` annotation, `indexable_option` and `searchable_option` of this field cannot be modified.
         "metatagName": "A String", # Optional. The metatag name found in the HTML page. If user defines this field, the value of this metatag name will be used to extract metatag. If the user does not define this field, the FieldConfig.field_path will be used to extract metatag.
+        "partialMatchableOption": "A String", # Optional. If partial_matchable_option is PARTIAL_MATCHABLE_OPTION_ENABLED, field values are partial matchable. If partial_matchable_option is unset, the server behavior defaults to PARTIAL_MATCHABLE_OPTION_DISABLED for fields that support setting partial matchable options. For those fields that do not support setting partial matchable options, the server will skip partial matchable option setting, and setting partial_matchable_option for those fields will throw `INVALID_ARGUMENT` error.
+        "prefixMatchableOption": "A String", # Optional. If prefix_matchable_option is PREFIX_MATCHABLE_OPTION_ENABLED, field values are prefix matchable. If prefix_matchable_option is unset, the server behavior defaults to PREFIX_MATCHABLE_OPTION_DISABLED for fields that support setting prefix matchable options. For those fields that do not support setting prefix matchable options, the server will skip prefix matchable option setting, and setting prefix_matchable_option for those fields will throw `INVALID_ARGUMENT` error.
         "recsFilterableOption": "A String", # If recs_filterable_option is FILTERABLE_ENABLED, field values are filterable by filter expression in RecommendationService.Recommend. If FILTERABLE_ENABLED but the field type is numerical, field values are not filterable by text queries in RecommendationService.Recommend. Only textual fields are supported. If recs_filterable_option is unset, the default setting is FILTERABLE_DISABLED for fields that support setting filterable options. When a field set to [FILTERABLE_DISABLED] is filtered, a warning is generated and an empty result is returned.
         "retrievableOption": "A String", # If retrievable_option is RETRIEVABLE_ENABLED, field values are included in the search results. If retrievable_option is unset, the server behavior defaults to RETRIEVABLE_DISABLED for fields that support setting retrievable options. For those fields that do not support setting retrievable options, such as `object` and `boolean`, the server will skip retrievable option setting, and setting retrievable_option for those fields will throw `INVALID_ARGUMENT` error.
         "schemaOrgPaths": [ # Field paths for indexing custom attribute from schema.org data. More details of schema.org and its defined types can be found at [schema.org](https://schema.org). It is only used on advanced site search schema. Currently only support full path from root. The full path to a field is constructed by concatenating field names, starting from `_root`, with a period `.` as the delimiter. Examples: * Publish date of the root: _root.datePublished * Publish date of the reviews: _root.review.datePublished
@@ -1584,6 +1604,9 @@ 
Method Details

       ],
     },
     "notebooklmConfig": { # Config for connecting to NotebookLM Enterprise. # NotebookLM config. If set, this DataStore is connected to NotebookLM Enterprise.
+      "notebooks": [ # Optional. Restricts this data store to the given notebooks. When empty, the data store covers every notebook the querying user can access, which is the existing behaviour. Each entry is a full notebook resource name, such as `projects/*/locations/*/notebooks/*`. Scoping is enforced on results as well as requested upstream, so a notebook outside this list cannot appear in a search response through this data store even if the backend returns one.
+        "A String",
+      ],
       "searchConfig": "A String", # Required. Search config name. Format: projects/*/locations/global/notebookLmSearchConfigs/*
     },
     "thirdPartyOauthConfig": { # Stores information for third party applicationOAuth. # Third Party OAuth config. If set, this DataStore is connected to a third party application.
@@ -1638,6 +1661,8 @@ 
Method Details

         "indexableOption": "A String", # If indexable_option is INDEXABLE_ENABLED, field values are indexed so that it can be filtered or faceted in SearchService.Search. If indexable_option is unset, the server behavior defaults to INDEXABLE_DISABLED for fields that support setting indexable options. For those fields that do not support setting indexable options, such as `object` and `boolean` and key properties, the server will skip indexable_option setting, and setting indexable_option for those fields will throw `INVALID_ARGUMENT` error.
         "keyPropertyType": "A String", # Output only. Type of the key property that this field is mapped to. Empty string if this is not annotated as mapped to a key property. Example types are `title`, `description`. Full list is defined by `keyPropertyMapping` in the schema field annotation. If the schema field has a `KeyPropertyMapping` annotation, `indexable_option` and `searchable_option` of this field cannot be modified.
         "metatagName": "A String", # Optional. The metatag name found in the HTML page. If user defines this field, the value of this metatag name will be used to extract metatag. If the user does not define this field, the FieldConfig.field_path will be used to extract metatag.
+        "partialMatchableOption": "A String", # Optional. If partial_matchable_option is PARTIAL_MATCHABLE_OPTION_ENABLED, field values are partial matchable. If partial_matchable_option is unset, the server behavior defaults to PARTIAL_MATCHABLE_OPTION_DISABLED for fields that support setting partial matchable options. For those fields that do not support setting partial matchable options, the server will skip partial matchable option setting, and setting partial_matchable_option for those fields will throw `INVALID_ARGUMENT` error.
+        "prefixMatchableOption": "A String", # Optional. If prefix_matchable_option is PREFIX_MATCHABLE_OPTION_ENABLED, field values are prefix matchable. If prefix_matchable_option is unset, the server behavior defaults to PREFIX_MATCHABLE_OPTION_DISABLED for fields that support setting prefix matchable options. For those fields that do not support setting prefix matchable options, the server will skip prefix matchable option setting, and setting prefix_matchable_option for those fields will throw `INVALID_ARGUMENT` error.
         "recsFilterableOption": "A String", # If recs_filterable_option is FILTERABLE_ENABLED, field values are filterable by filter expression in RecommendationService.Recommend. If FILTERABLE_ENABLED but the field type is numerical, field values are not filterable by text queries in RecommendationService.Recommend. Only textual fields are supported. If recs_filterable_option is unset, the default setting is FILTERABLE_DISABLED for fields that support setting filterable options. When a field set to [FILTERABLE_DISABLED] is filtered, a warning is generated and an empty result is returned.
         "retrievableOption": "A String", # If retrievable_option is RETRIEVABLE_ENABLED, field values are included in the search results. If retrievable_option is unset, the server behavior defaults to RETRIEVABLE_DISABLED for fields that support setting retrievable options. For those fields that do not support setting retrievable options, such as `object` and `boolean`, the server will skip retrievable option setting, and setting retrievable_option for those fields will throw `INVALID_ARGUMENT` error.
         "schemaOrgPaths": [ # Field paths for indexing custom attribute from schema.org data. More details of schema.org and its defined types can be found at [schema.org](https://schema.org). It is only used on advanced site search schema. Currently only support full path from root. The full path to a field is constructed by concatenating field names, starting from `_root`, with a period `.` as the delimiter. Examples: * Publish date of the root: _root.datePublished * Publish date of the reviews: _root.review.datePublished
diff --git a/docs/dyn/discoveryengine_v1alpha.projects.locations.collections.dataStores.schemas.html b/docs/dyn/discoveryengine_v1alpha.projects.locations.collections.dataStores.schemas.html
index 90043545f4..33e459e199 100644
--- a/docs/dyn/discoveryengine_v1alpha.projects.locations.collections.dataStores.schemas.html
+++ b/docs/dyn/discoveryengine_v1alpha.projects.locations.collections.dataStores.schemas.html
@@ -128,6 +128,8 @@ 
Method Details

       "indexableOption": "A String", # If indexable_option is INDEXABLE_ENABLED, field values are indexed so that it can be filtered or faceted in SearchService.Search. If indexable_option is unset, the server behavior defaults to INDEXABLE_DISABLED for fields that support setting indexable options. For those fields that do not support setting indexable options, such as `object` and `boolean` and key properties, the server will skip indexable_option setting, and setting indexable_option for those fields will throw `INVALID_ARGUMENT` error.
       "keyPropertyType": "A String", # Output only. Type of the key property that this field is mapped to. Empty string if this is not annotated as mapped to a key property. Example types are `title`, `description`. Full list is defined by `keyPropertyMapping` in the schema field annotation. If the schema field has a `KeyPropertyMapping` annotation, `indexable_option` and `searchable_option` of this field cannot be modified.
       "metatagName": "A String", # Optional. The metatag name found in the HTML page. If user defines this field, the value of this metatag name will be used to extract metatag. If the user does not define this field, the FieldConfig.field_path will be used to extract metatag.
+      "partialMatchableOption": "A String", # Optional. If partial_matchable_option is PARTIAL_MATCHABLE_OPTION_ENABLED, field values are partial matchable. If partial_matchable_option is unset, the server behavior defaults to PARTIAL_MATCHABLE_OPTION_DISABLED for fields that support setting partial matchable options. For those fields that do not support setting partial matchable options, the server will skip partial matchable option setting, and setting partial_matchable_option for those fields will throw `INVALID_ARGUMENT` error.
+      "prefixMatchableOption": "A String", # Optional. If prefix_matchable_option is PREFIX_MATCHABLE_OPTION_ENABLED, field values are prefix matchable. If prefix_matchable_option is unset, the server behavior defaults to PREFIX_MATCHABLE_OPTION_DISABLED for fields that support setting prefix matchable options. For those fields that do not support setting prefix matchable options, the server will skip prefix matchable option setting, and setting prefix_matchable_option for those fields will throw `INVALID_ARGUMENT` error.
       "recsFilterableOption": "A String", # If recs_filterable_option is FILTERABLE_ENABLED, field values are filterable by filter expression in RecommendationService.Recommend. If FILTERABLE_ENABLED but the field type is numerical, field values are not filterable by text queries in RecommendationService.Recommend. Only textual fields are supported. If recs_filterable_option is unset, the default setting is FILTERABLE_DISABLED for fields that support setting filterable options. When a field set to [FILTERABLE_DISABLED] is filtered, a warning is generated and an empty result is returned.
       "retrievableOption": "A String", # If retrievable_option is RETRIEVABLE_ENABLED, field values are included in the search results. If retrievable_option is unset, the server behavior defaults to RETRIEVABLE_DISABLED for fields that support setting retrievable options. For those fields that do not support setting retrievable options, such as `object` and `boolean`, the server will skip retrievable option setting, and setting retrievable_option for those fields will throw `INVALID_ARGUMENT` error.
       "schemaOrgPaths": [ # Field paths for indexing custom attribute from schema.org data. More details of schema.org and its defined types can be found at [schema.org](https://schema.org). It is only used on advanced site search schema. Currently only support full path from root. The full path to a field is constructed by concatenating field names, starting from `_root`, with a period `.` as the delimiter. Examples: * Publish date of the root: _root.datePublished * Publish date of the reviews: _root.review.datePublished
@@ -236,6 +238,8 @@ 
Method Details

       "indexableOption": "A String", # If indexable_option is INDEXABLE_ENABLED, field values are indexed so that it can be filtered or faceted in SearchService.Search. If indexable_option is unset, the server behavior defaults to INDEXABLE_DISABLED for fields that support setting indexable options. For those fields that do not support setting indexable options, such as `object` and `boolean` and key properties, the server will skip indexable_option setting, and setting indexable_option for those fields will throw `INVALID_ARGUMENT` error.
       "keyPropertyType": "A String", # Output only. Type of the key property that this field is mapped to. Empty string if this is not annotated as mapped to a key property. Example types are `title`, `description`. Full list is defined by `keyPropertyMapping` in the schema field annotation. If the schema field has a `KeyPropertyMapping` annotation, `indexable_option` and `searchable_option` of this field cannot be modified.
       "metatagName": "A String", # Optional. The metatag name found in the HTML page. If user defines this field, the value of this metatag name will be used to extract metatag. If the user does not define this field, the FieldConfig.field_path will be used to extract metatag.
+      "partialMatchableOption": "A String", # Optional. If partial_matchable_option is PARTIAL_MATCHABLE_OPTION_ENABLED, field values are partial matchable. If partial_matchable_option is unset, the server behavior defaults to PARTIAL_MATCHABLE_OPTION_DISABLED for fields that support setting partial matchable options. For those fields that do not support setting partial matchable options, the server will skip partial matchable option setting, and setting partial_matchable_option for those fields will throw `INVALID_ARGUMENT` error.
+      "prefixMatchableOption": "A String", # Optional. If prefix_matchable_option is PREFIX_MATCHABLE_OPTION_ENABLED, field values are prefix matchable. If prefix_matchable_option is unset, the server behavior defaults to PREFIX_MATCHABLE_OPTION_DISABLED for fields that support setting prefix matchable options. For those fields that do not support setting prefix matchable options, the server will skip prefix matchable option setting, and setting prefix_matchable_option for those fields will throw `INVALID_ARGUMENT` error.
       "recsFilterableOption": "A String", # If recs_filterable_option is FILTERABLE_ENABLED, field values are filterable by filter expression in RecommendationService.Recommend. If FILTERABLE_ENABLED but the field type is numerical, field values are not filterable by text queries in RecommendationService.Recommend. Only textual fields are supported. If recs_filterable_option is unset, the default setting is FILTERABLE_DISABLED for fields that support setting filterable options. When a field set to [FILTERABLE_DISABLED] is filtered, a warning is generated and an empty result is returned.
       "retrievableOption": "A String", # If retrievable_option is RETRIEVABLE_ENABLED, field values are included in the search results. If retrievable_option is unset, the server behavior defaults to RETRIEVABLE_DISABLED for fields that support setting retrievable options. For those fields that do not support setting retrievable options, such as `object` and `boolean`, the server will skip retrievable option setting, and setting retrievable_option for those fields will throw `INVALID_ARGUMENT` error.
       "schemaOrgPaths": [ # Field paths for indexing custom attribute from schema.org data. More details of schema.org and its defined types can be found at [schema.org](https://schema.org). It is only used on advanced site search schema. Currently only support full path from root. The full path to a field is constructed by concatenating field names, starting from `_root`, with a period `.` as the delimiter. Examples: * Publish date of the root: _root.datePublished * Publish date of the reviews: _root.review.datePublished
@@ -285,6 +289,8 @@ 
Method Details

           "indexableOption": "A String", # If indexable_option is INDEXABLE_ENABLED, field values are indexed so that it can be filtered or faceted in SearchService.Search. If indexable_option is unset, the server behavior defaults to INDEXABLE_DISABLED for fields that support setting indexable options. For those fields that do not support setting indexable options, such as `object` and `boolean` and key properties, the server will skip indexable_option setting, and setting indexable_option for those fields will throw `INVALID_ARGUMENT` error.
           "keyPropertyType": "A String", # Output only. Type of the key property that this field is mapped to. Empty string if this is not annotated as mapped to a key property. Example types are `title`, `description`. Full list is defined by `keyPropertyMapping` in the schema field annotation. If the schema field has a `KeyPropertyMapping` annotation, `indexable_option` and `searchable_option` of this field cannot be modified.
           "metatagName": "A String", # Optional. The metatag name found in the HTML page. If user defines this field, the value of this metatag name will be used to extract metatag. If the user does not define this field, the FieldConfig.field_path will be used to extract metatag.
+          "partialMatchableOption": "A String", # Optional. If partial_matchable_option is PARTIAL_MATCHABLE_OPTION_ENABLED, field values are partial matchable. If partial_matchable_option is unset, the server behavior defaults to PARTIAL_MATCHABLE_OPTION_DISABLED for fields that support setting partial matchable options. For those fields that do not support setting partial matchable options, the server will skip partial matchable option setting, and setting partial_matchable_option for those fields will throw `INVALID_ARGUMENT` error.
+          "prefixMatchableOption": "A String", # Optional. If prefix_matchable_option is PREFIX_MATCHABLE_OPTION_ENABLED, field values are prefix matchable. If prefix_matchable_option is unset, the server behavior defaults to PREFIX_MATCHABLE_OPTION_DISABLED for fields that support setting prefix matchable options. For those fields that do not support setting prefix matchable options, the server will skip prefix matchable option setting, and setting prefix_matchable_option for those fields will throw `INVALID_ARGUMENT` error.
           "recsFilterableOption": "A String", # If recs_filterable_option is FILTERABLE_ENABLED, field values are filterable by filter expression in RecommendationService.Recommend. If FILTERABLE_ENABLED but the field type is numerical, field values are not filterable by text queries in RecommendationService.Recommend. Only textual fields are supported. If recs_filterable_option is unset, the default setting is FILTERABLE_DISABLED for fields that support setting filterable options. When a field set to [FILTERABLE_DISABLED] is filtered, a warning is generated and an empty result is returned.
           "retrievableOption": "A String", # If retrievable_option is RETRIEVABLE_ENABLED, field values are included in the search results. If retrievable_option is unset, the server behavior defaults to RETRIEVABLE_DISABLED for fields that support setting retrievable options. For those fields that do not support setting retrievable options, such as `object` and `boolean`, the server will skip retrievable option setting, and setting retrievable_option for those fields will throw `INVALID_ARGUMENT` error.
           "schemaOrgPaths": [ # Field paths for indexing custom attribute from schema.org data. More details of schema.org and its defined types can be found at [schema.org](https://schema.org). It is only used on advanced site search schema. Currently only support full path from root. The full path to a field is constructed by concatenating field names, starting from `_root`, with a period `.` as the delimiter. Examples: * Publish date of the root: _root.datePublished * Publish date of the reviews: _root.review.datePublished
@@ -340,6 +346,8 @@ 
Method Details

       "indexableOption": "A String", # If indexable_option is INDEXABLE_ENABLED, field values are indexed so that it can be filtered or faceted in SearchService.Search. If indexable_option is unset, the server behavior defaults to INDEXABLE_DISABLED for fields that support setting indexable options. For those fields that do not support setting indexable options, such as `object` and `boolean` and key properties, the server will skip indexable_option setting, and setting indexable_option for those fields will throw `INVALID_ARGUMENT` error.
       "keyPropertyType": "A String", # Output only. Type of the key property that this field is mapped to. Empty string if this is not annotated as mapped to a key property. Example types are `title`, `description`. Full list is defined by `keyPropertyMapping` in the schema field annotation. If the schema field has a `KeyPropertyMapping` annotation, `indexable_option` and `searchable_option` of this field cannot be modified.
       "metatagName": "A String", # Optional. The metatag name found in the HTML page. If user defines this field, the value of this metatag name will be used to extract metatag. If the user does not define this field, the FieldConfig.field_path will be used to extract metatag.
+      "partialMatchableOption": "A String", # Optional. If partial_matchable_option is PARTIAL_MATCHABLE_OPTION_ENABLED, field values are partial matchable. If partial_matchable_option is unset, the server behavior defaults to PARTIAL_MATCHABLE_OPTION_DISABLED for fields that support setting partial matchable options. For those fields that do not support setting partial matchable options, the server will skip partial matchable option setting, and setting partial_matchable_option for those fields will throw `INVALID_ARGUMENT` error.
+      "prefixMatchableOption": "A String", # Optional. If prefix_matchable_option is PREFIX_MATCHABLE_OPTION_ENABLED, field values are prefix matchable. If prefix_matchable_option is unset, the server behavior defaults to PREFIX_MATCHABLE_OPTION_DISABLED for fields that support setting prefix matchable options. For those fields that do not support setting prefix matchable options, the server will skip prefix matchable option setting, and setting prefix_matchable_option for those fields will throw `INVALID_ARGUMENT` error.
       "recsFilterableOption": "A String", # If recs_filterable_option is FILTERABLE_ENABLED, field values are filterable by filter expression in RecommendationService.Recommend. If FILTERABLE_ENABLED but the field type is numerical, field values are not filterable by text queries in RecommendationService.Recommend. Only textual fields are supported. If recs_filterable_option is unset, the default setting is FILTERABLE_DISABLED for fields that support setting filterable options. When a field set to [FILTERABLE_DISABLED] is filtered, a warning is generated and an empty result is returned.
       "retrievableOption": "A String", # If retrievable_option is RETRIEVABLE_ENABLED, field values are included in the search results. If retrievable_option is unset, the server behavior defaults to RETRIEVABLE_DISABLED for fields that support setting retrievable options. For those fields that do not support setting retrievable options, such as `object` and `boolean`, the server will skip retrievable option setting, and setting retrievable_option for those fields will throw `INVALID_ARGUMENT` error.
       "schemaOrgPaths": [ # Field paths for indexing custom attribute from schema.org data. More details of schema.org and its defined types can be found at [schema.org](https://schema.org). It is only used on advanced site search schema. Currently only support full path from root. The full path to a field is constructed by concatenating field names, starting from `_root`, with a period `.` as the delimiter. Examples: * Publish date of the root: _root.datePublished * Publish date of the reviews: _root.review.datePublished
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 ec00527f70..3df72b0cf1 100644
--- a/docs/dyn/discoveryengine_v1alpha.projects.locations.collections.dataStores.servingConfigs.html
+++ b/docs/dyn/discoveryengine_v1alpha.projects.locations.collections.dataStores.servingConfigs.html
@@ -1714,7 +1714,9 @@ 
Method Details

         },
         "questionIndex": 42, # The index of the user input within the conversation messages.
         "session": "A String", # Name of the newly generated or continued session.
-        "taskName": "A String", # Optional. The full resource name of the Sobi task if the conversation was handled by a long-running agent task. Format: projects/{project}/locations/{location}/tasks/{task_id}
+        "stepSeqNum": "A String", # Optional. The `TaskServerEvent.seq_num` of the step that opened the rated agent task reply.
+        "taskName": "A String", # Optional. The full resource name of the Sobi task if the conversation was handled by a long-running agent task. Format (canonical, or the short alias the Task API also accepts): projects/{project}/locations/{location}/agents/{agent}/tasks/{task} projects/{project}/locations/{location}/tasks/{task}
+        "trajectoryId": "A String", # Optional. The runtime trajectory id of the rated agent task turn, as set on `TaskServerEvent.trajectory_id`. Shared by all steps of the turn.
       },
       "dataTermsAccepted": True or False, # Optional. Whether the customer accepted data use terms.
       "feedbackSource": "A String", # Optional. The UI component the user feedback comes from, which could be GOOGLE_CONSOLE, GOOGLE_WIDGET, GOOGLE_WEBAPP.
@@ -1972,7 +1974,7 @@ 
Method Details

       "A String",
     ],
   },
-  "dataStoreSpecs": [ # Specifications that define the specific DataStores to be searched, along with configurations for those data stores. This is only considered for Engines with multiple data stores. For engines with a single data store, the specs directly under SearchRequest should be used.
+  "dataStoreSpecs": [ # Specifications that define the specific DataStores to be searched, along with configurations for those data stores. This is only considered for Engines with multiple data stores. For engines with a single data store, the specs directly under SearchRequest should be used. On an engine with multiple data stores, this field is optional. If it's empty, all of the engine's data stores are searched (blended search). Unless it specifies exactly one data store, some request fields, such as `order_by` and `query_expansion_spec`, aren't supported and return an `INVALID_ARGUMENT` error.
     { # A struct to define data stores to filter on in a search call and configurations for those data stores. Otherwise, an `INVALID_ARGUMENT` error is returned.
       "boostSpec": { # Boost specification to boost certain documents. # Optional. Boost specification to boost certain documents. For more information on boosting, see [Boosting](https://cloud.google.com/generative-ai-app-builder/docs/boost-search-results)
         "conditionBoostSpecs": [ # Condition boost specifications. If a document matches multiple conditions in the specifications, boost scores from these specifications are all applied and combined in a non-linear way. Maximum number of specifications is 20.
@@ -2658,7 +2660,7 @@ 
Method Details

       "A String",
     ],
   },
-  "dataStoreSpecs": [ # Specifications that define the specific DataStores to be searched, along with configurations for those data stores. This is only considered for Engines with multiple data stores. For engines with a single data store, the specs directly under SearchRequest should be used.
+  "dataStoreSpecs": [ # Specifications that define the specific DataStores to be searched, along with configurations for those data stores. This is only considered for Engines with multiple data stores. For engines with a single data store, the specs directly under SearchRequest should be used. On an engine with multiple data stores, this field is optional. If it's empty, all of the engine's data stores are searched (blended search). Unless it specifies exactly one data store, some request fields, such as `order_by` and `query_expansion_spec`, aren't supported and return an `INVALID_ARGUMENT` error.
     { # A struct to define data stores to filter on in a search call and configurations for those data stores. Otherwise, an `INVALID_ARGUMENT` error is returned.
       "boostSpec": { # Boost specification to boost certain documents. # Optional. Boost specification to boost certain documents. For more information on boosting, see [Boosting](https://cloud.google.com/generative-ai-app-builder/docs/boost-search-results)
         "conditionBoostSpecs": [ # Condition boost specifications. If a document matches multiple conditions in the specifications, boost scores from these specifications are all applied and combined in a non-linear way. Maximum number of specifications is 20.
diff --git a/docs/dyn/discoveryengine_v1alpha.projects.locations.collections.dataStores.userEvents.html b/docs/dyn/discoveryengine_v1alpha.projects.locations.collections.dataStores.userEvents.html
index 7f4f9b425f..3f8efcd021 100644
--- a/docs/dyn/discoveryengine_v1alpha.projects.locations.collections.dataStores.userEvents.html
+++ b/docs/dyn/discoveryengine_v1alpha.projects.locations.collections.dataStores.userEvents.html
@@ -241,7 +241,9 @@ 
Method Details

             },
             "questionIndex": 42, # The index of the user input within the conversation messages.
             "session": "A String", # Name of the newly generated or continued session.
-            "taskName": "A String", # Optional. The full resource name of the Sobi task if the conversation was handled by a long-running agent task. Format: projects/{project}/locations/{location}/tasks/{task_id}
+            "stepSeqNum": "A String", # Optional. The `TaskServerEvent.seq_num` of the step that opened the rated agent task reply.
+            "taskName": "A String", # Optional. The full resource name of the Sobi task if the conversation was handled by a long-running agent task. Format (canonical, or the short alias the Task API also accepts): projects/{project}/locations/{location}/agents/{agent}/tasks/{task} projects/{project}/locations/{location}/tasks/{task}
+            "trajectoryId": "A String", # Optional. The runtime trajectory id of the rated agent task turn, as set on `TaskServerEvent.trajectory_id`. Shared by all steps of the turn.
           },
           "dataTermsAccepted": True or False, # Optional. Whether the customer accepted data use terms.
           "feedbackSource": "A String", # Optional. The UI component the user feedback comes from, which could be GOOGLE_CONSOLE, GOOGLE_WIDGET, GOOGLE_WEBAPP.
@@ -506,7 +508,9 @@ 
Method Details

       },
       "questionIndex": 42, # The index of the user input within the conversation messages.
       "session": "A String", # Name of the newly generated or continued session.
-      "taskName": "A String", # Optional. The full resource name of the Sobi task if the conversation was handled by a long-running agent task. Format: projects/{project}/locations/{location}/tasks/{task_id}
+      "stepSeqNum": "A String", # Optional. The `TaskServerEvent.seq_num` of the step that opened the rated agent task reply.
+      "taskName": "A String", # Optional. The full resource name of the Sobi task if the conversation was handled by a long-running agent task. Format (canonical, or the short alias the Task API also accepts): projects/{project}/locations/{location}/agents/{agent}/tasks/{task} projects/{project}/locations/{location}/tasks/{task}
+      "trajectoryId": "A String", # Optional. The runtime trajectory id of the rated agent task turn, as set on `TaskServerEvent.trajectory_id`. Shared by all steps of the turn.
     },
     "dataTermsAccepted": True or False, # Optional. Whether the customer accepted data use terms.
     "feedbackSource": "A String", # Optional. The UI component the user feedback comes from, which could be GOOGLE_CONSOLE, GOOGLE_WIDGET, GOOGLE_WEBAPP.
@@ -696,7 +700,9 @@ 
Method Details

       },
       "questionIndex": 42, # The index of the user input within the conversation messages.
       "session": "A String", # Name of the newly generated or continued session.
-      "taskName": "A String", # Optional. The full resource name of the Sobi task if the conversation was handled by a long-running agent task. Format: projects/{project}/locations/{location}/tasks/{task_id}
+      "stepSeqNum": "A String", # Optional. The `TaskServerEvent.seq_num` of the step that opened the rated agent task reply.
+      "taskName": "A String", # Optional. The full resource name of the Sobi task if the conversation was handled by a long-running agent task. Format (canonical, or the short alias the Task API also accepts): projects/{project}/locations/{location}/agents/{agent}/tasks/{task} projects/{project}/locations/{location}/tasks/{task}
+      "trajectoryId": "A String", # Optional. The runtime trajectory id of the rated agent task turn, as set on `TaskServerEvent.trajectory_id`. Shared by all steps of the turn.
     },
     "dataTermsAccepted": True or False, # Optional. Whether the customer accepted data use terms.
     "feedbackSource": "A String", # Optional. The UI component the user feedback comes from, which could be GOOGLE_CONSOLE, GOOGLE_WIDGET, GOOGLE_WEBAPP.
diff --git a/docs/dyn/discoveryengine_v1alpha.projects.locations.collections.dataStores.widgetConfigs.html b/docs/dyn/discoveryengine_v1alpha.projects.locations.collections.dataStores.widgetConfigs.html
index 56a7d504e1..039ed3d52b 100644
--- a/docs/dyn/discoveryengine_v1alpha.projects.locations.collections.dataStores.widgetConfigs.html
+++ b/docs/dyn/discoveryengine_v1alpha.projects.locations.collections.dataStores.widgetConfigs.html
@@ -341,7 +341,7 @@ 
Method Details

     "enableSafeSearch": True or False, # Whether to enable safe search.
     "enableSearchAsYouType": True or False, # Whether to enable search-as-you-type behavior for the search widget.
     "enableVisualContentSummary": True or False, # If set to true, the widget will enable visual content summary on applicable search requests. Only used by healthcare search.
-    "features": { # Output only. Feature config for the engine to opt in or opt out of features. Supported keys: * `agent-gallery` * `no-code-agent-builder` * `prompt-gallery` * `model-selector` * `notebook-lm` * `people-search` * `people-search-org-chart` * `bi-directional-audio` * `speech-to-text` * `feedback` * `session-sharing` * `personalization-memory` * `personalization-suggested-highlights` * `mobile-app-access` * `disable-agent-sharing` * `disable-image-generation` * `disable-video-generation` * `disable-onedrive-upload` * `disable-talk-to-content` * `disable-google-drive-upload` * `disable-welcome-emails` * `disable-canvas` * `canvas-workspace` * `canvas-app-builder` * `skills` * `skill-sharing` * `skill-sharing-without-admin-approval` * `disable-projects` * `sobi` * `enable-end-user-sharing-with-groups` * `single-agent-orchestration` * `multi-agent-orchestration` * `cross-product-intelligence` * `workflow-agents` * `in-app-notifications`
+    "features": { # Output only. Feature config for the engine to opt in or opt out of features. Supported keys: * `agent-gallery` * `no-code-agent-builder` * `prompt-gallery` * `model-selector` * `notebook-lm` * `people-search` * `people-search-org-chart` * `bi-directional-audio` * `speech-to-text` * `feedback` * `session-sharing` * `personalization-memory` * `personalization-suggested-highlights` * `mobile-app-access` * `disable-agent-sharing` * `disable-image-generation` * `disable-video-generation` * `disable-onedrive-upload` * `disable-talk-to-content` * `disable-google-drive-upload` * `disable-welcome-emails` * `disable-canvas` * `canvas-workspace` * `canvas-app-builder` * `skills` * `skill-sharing` * `skill-sharing-without-admin-approval` * `disable-projects` * `sobi` * `enable-end-user-sharing-with-groups` * `single-agent-orchestration` * `multi-agent-orchestration` * `cross-product-intelligence` * `workflow-agents` * `in-app-notifications` * `code-extraction`
       "a_key": "A String",
     },
     "generativeAnswerConfig": { # Describes configuration for generative answer. # Describes generative answer configuration.
@@ -636,7 +636,7 @@ 
Method Details

     "enableSafeSearch": True or False, # Whether to enable safe search.
     "enableSearchAsYouType": True or False, # Whether to enable search-as-you-type behavior for the search widget.
     "enableVisualContentSummary": True or False, # If set to true, the widget will enable visual content summary on applicable search requests. Only used by healthcare search.
-    "features": { # Output only. Feature config for the engine to opt in or opt out of features. Supported keys: * `agent-gallery` * `no-code-agent-builder` * `prompt-gallery` * `model-selector` * `notebook-lm` * `people-search` * `people-search-org-chart` * `bi-directional-audio` * `speech-to-text` * `feedback` * `session-sharing` * `personalization-memory` * `personalization-suggested-highlights` * `mobile-app-access` * `disable-agent-sharing` * `disable-image-generation` * `disable-video-generation` * `disable-onedrive-upload` * `disable-talk-to-content` * `disable-google-drive-upload` * `disable-welcome-emails` * `disable-canvas` * `canvas-workspace` * `canvas-app-builder` * `skills` * `skill-sharing` * `skill-sharing-without-admin-approval` * `disable-projects` * `sobi` * `enable-end-user-sharing-with-groups` * `single-agent-orchestration` * `multi-agent-orchestration` * `cross-product-intelligence` * `workflow-agents` * `in-app-notifications`
+    "features": { # Output only. Feature config for the engine to opt in or opt out of features. Supported keys: * `agent-gallery` * `no-code-agent-builder` * `prompt-gallery` * `model-selector` * `notebook-lm` * `people-search` * `people-search-org-chart` * `bi-directional-audio` * `speech-to-text` * `feedback` * `session-sharing` * `personalization-memory` * `personalization-suggested-highlights` * `mobile-app-access` * `disable-agent-sharing` * `disable-image-generation` * `disable-video-generation` * `disable-onedrive-upload` * `disable-talk-to-content` * `disable-google-drive-upload` * `disable-welcome-emails` * `disable-canvas` * `canvas-workspace` * `canvas-app-builder` * `skills` * `skill-sharing` * `skill-sharing-without-admin-approval` * `disable-projects` * `sobi` * `enable-end-user-sharing-with-groups` * `single-agent-orchestration` * `multi-agent-orchestration` * `cross-product-intelligence` * `workflow-agents` * `in-app-notifications` * `code-extraction`
       "a_key": "A String",
     },
     "generativeAnswerConfig": { # Describes configuration for generative answer. # Describes generative answer configuration.
@@ -930,7 +930,7 @@ 
Method Details

     "enableSafeSearch": True or False, # Whether to enable safe search.
     "enableSearchAsYouType": True or False, # Whether to enable search-as-you-type behavior for the search widget.
     "enableVisualContentSummary": True or False, # If set to true, the widget will enable visual content summary on applicable search requests. Only used by healthcare search.
-    "features": { # Output only. Feature config for the engine to opt in or opt out of features. Supported keys: * `agent-gallery` * `no-code-agent-builder` * `prompt-gallery` * `model-selector` * `notebook-lm` * `people-search` * `people-search-org-chart` * `bi-directional-audio` * `speech-to-text` * `feedback` * `session-sharing` * `personalization-memory` * `personalization-suggested-highlights` * `mobile-app-access` * `disable-agent-sharing` * `disable-image-generation` * `disable-video-generation` * `disable-onedrive-upload` * `disable-talk-to-content` * `disable-google-drive-upload` * `disable-welcome-emails` * `disable-canvas` * `canvas-workspace` * `canvas-app-builder` * `skills` * `skill-sharing` * `skill-sharing-without-admin-approval` * `disable-projects` * `sobi` * `enable-end-user-sharing-with-groups` * `single-agent-orchestration` * `multi-agent-orchestration` * `cross-product-intelligence` * `workflow-agents` * `in-app-notifications`
+    "features": { # Output only. Feature config for the engine to opt in or opt out of features. Supported keys: * `agent-gallery` * `no-code-agent-builder` * `prompt-gallery` * `model-selector` * `notebook-lm` * `people-search` * `people-search-org-chart` * `bi-directional-audio` * `speech-to-text` * `feedback` * `session-sharing` * `personalization-memory` * `personalization-suggested-highlights` * `mobile-app-access` * `disable-agent-sharing` * `disable-image-generation` * `disable-video-generation` * `disable-onedrive-upload` * `disable-talk-to-content` * `disable-google-drive-upload` * `disable-welcome-emails` * `disable-canvas` * `canvas-workspace` * `canvas-app-builder` * `skills` * `skill-sharing` * `skill-sharing-without-admin-approval` * `disable-projects` * `sobi` * `enable-end-user-sharing-with-groups` * `single-agent-orchestration` * `multi-agent-orchestration` * `cross-product-intelligence` * `workflow-agents` * `in-app-notifications` * `code-extraction`
       "a_key": "A String",
     },
     "generativeAnswerConfig": { # Describes configuration for generative answer. # Describes generative answer configuration.
diff --git a/docs/dyn/discoveryengine_v1alpha.projects.locations.collections.engines.assistants.agents.html b/docs/dyn/discoveryengine_v1alpha.projects.locations.collections.engines.assistants.agents.html
index 87e7cfd28b..b7a136cb07 100644
--- a/docs/dyn/discoveryengine_v1alpha.projects.locations.collections.engines.assistants.agents.html
+++ b/docs/dyn/discoveryengine_v1alpha.projects.locations.collections.engines.assistants.agents.html
@@ -84,11 +84,6 @@ 
Instance Methods

 

 
Returns the operations Resource.

 
-

-  toolCalls()
-

-
Returns the toolCalls Resource.

-
 

   close()

 
Close httplib2 connections.

diff --git a/docs/dyn/discoveryengine_v1alpha.projects.locations.collections.engines.html b/docs/dyn/discoveryengine_v1alpha.projects.locations.collections.engines.html
index 021875c790..edba8d626c 100644
--- a/docs/dyn/discoveryengine_v1alpha.projects.locations.collections.engines.html
+++ b/docs/dyn/discoveryengine_v1alpha.projects.locations.collections.engines.html
@@ -84,11 +84,6 @@ 
Instance Methods

 

 
Returns the assistants Resource.

 
-

-  collaborativeProjects()
-

-
Returns the collaborativeProjects Resource.

-
 

   completionConfig()
 

@@ -232,7 +227,7 @@ 
Method Details

   ],
   "disableAnalytics": True or False, # Optional. Whether to disable analytics for searches performed on this engine.
   "displayName": "A String", # Required. The display name of the engine. Should be human readable. UTF-8 encoded string with limit of 1024 characters.
-  "features": { # Optional. Feature config for the engine to opt in or opt out of features. Supported keys: * `*`: all features, if it's present, all other feature state settings are ignored. * `agent-gallery` * `no-code-agent-builder` * `prompt-gallery` * `model-selector` * `notebook-lm` * `people-search` * `people-search-org-chart` * `bi-directional-audio` * `speech-to-text` * `feedback` * `session-sharing` * `personalization-memory` * `personalization-suggested-highlights` * `mobile-app-access` * `disable-agent-sharing` * `disable-image-generation` * `disable-video-generation` * `disable-onedrive-upload` * `disable-talk-to-content` * `disable-google-drive-upload` * `disable-welcome-emails` * `disable-canvas` * `canvas-workspace` * `canvas-app-builder` * `skills` * `skill-sharing` * `skill-sharing-without-admin-approval` * `disable-projects` * `sobi` * `enable-end-user-sharing-with-groups` * `single-agent-orchestration` * `multi-agent-orchestration` * `cross-product-intelligence` * `workflow-agents` * `in-app-notifications`
+  "features": { # Optional. Feature config for the engine to opt in or opt out of features. Supported keys: * `*`: all features, if it's present, all other feature state settings are ignored. * `agent-gallery` * `no-code-agent-builder` * `prompt-gallery` * `model-selector` * `notebook-lm` * `people-search` * `people-search-org-chart` * `bi-directional-audio` * `speech-to-text` * `feedback` * `session-sharing` * `personalization-memory` * `personalization-suggested-highlights` * `mobile-app-access` * `disable-agent-sharing` * `disable-image-generation` * `disable-video-generation` * `disable-onedrive-upload` * `disable-talk-to-content` * `disable-google-drive-upload` * `disable-welcome-emails` * `disable-canvas` * `canvas-workspace` * `canvas-app-builder` * `skills` * `skill-sharing` * `skill-sharing-without-admin-approval` * `disable-projects` * `sobi` * `enable-end-user-sharing-with-groups` * `single-agent-orchestration` * `multi-agent-orchestration` * `cross-product-intelligence` * `workflow-agents` * `in-app-notifications` * `code-extraction`
     "a_key": "A String",
   },
   "industryVertical": "A String", # Optional. The industry vertical that the engine registers. The restriction of the Engine industry vertical is based on DataStore: Vertical on Engine has to match vertical of the DataStore linked to the engine.
@@ -434,7 +429,7 @@ 
Method Details

   ],
   "disableAnalytics": True or False, # Optional. Whether to disable analytics for searches performed on this engine.
   "displayName": "A String", # Required. The display name of the engine. Should be human readable. UTF-8 encoded string with limit of 1024 characters.
-  "features": { # Optional. Feature config for the engine to opt in or opt out of features. Supported keys: * `*`: all features, if it's present, all other feature state settings are ignored. * `agent-gallery` * `no-code-agent-builder` * `prompt-gallery` * `model-selector` * `notebook-lm` * `people-search` * `people-search-org-chart` * `bi-directional-audio` * `speech-to-text` * `feedback` * `session-sharing` * `personalization-memory` * `personalization-suggested-highlights` * `mobile-app-access` * `disable-agent-sharing` * `disable-image-generation` * `disable-video-generation` * `disable-onedrive-upload` * `disable-talk-to-content` * `disable-google-drive-upload` * `disable-welcome-emails` * `disable-canvas` * `canvas-workspace` * `canvas-app-builder` * `skills` * `skill-sharing` * `skill-sharing-without-admin-approval` * `disable-projects` * `sobi` * `enable-end-user-sharing-with-groups` * `single-agent-orchestration` * `multi-agent-orchestration` * `cross-product-intelligence` * `workflow-agents` * `in-app-notifications`
+  "features": { # Optional. Feature config for the engine to opt in or opt out of features. Supported keys: * `*`: all features, if it's present, all other feature state settings are ignored. * `agent-gallery` * `no-code-agent-builder` * `prompt-gallery` * `model-selector` * `notebook-lm` * `people-search` * `people-search-org-chart` * `bi-directional-audio` * `speech-to-text` * `feedback` * `session-sharing` * `personalization-memory` * `personalization-suggested-highlights` * `mobile-app-access` * `disable-agent-sharing` * `disable-image-generation` * `disable-video-generation` * `disable-onedrive-upload` * `disable-talk-to-content` * `disable-google-drive-upload` * `disable-welcome-emails` * `disable-canvas` * `canvas-workspace` * `canvas-app-builder` * `skills` * `skill-sharing` * `skill-sharing-without-admin-approval` * `disable-projects` * `sobi` * `enable-end-user-sharing-with-groups` * `single-agent-orchestration` * `multi-agent-orchestration` * `cross-product-intelligence` * `workflow-agents` * `in-app-notifications` * `code-extraction`
     "a_key": "A String",
   },
   "industryVertical": "A String", # Optional. The industry vertical that the engine registers. The restriction of the Engine industry vertical is based on DataStore: Vertical on Engine has to match vertical of the DataStore linked to the engine.
@@ -660,7 +655,7 @@ 
Method Details

       ],
       "disableAnalytics": True or False, # Optional. Whether to disable analytics for searches performed on this engine.
       "displayName": "A String", # Required. The display name of the engine. Should be human readable. UTF-8 encoded string with limit of 1024 characters.
-      "features": { # Optional. Feature config for the engine to opt in or opt out of features. Supported keys: * `*`: all features, if it's present, all other feature state settings are ignored. * `agent-gallery` * `no-code-agent-builder` * `prompt-gallery` * `model-selector` * `notebook-lm` * `people-search` * `people-search-org-chart` * `bi-directional-audio` * `speech-to-text` * `feedback` * `session-sharing` * `personalization-memory` * `personalization-suggested-highlights` * `mobile-app-access` * `disable-agent-sharing` * `disable-image-generation` * `disable-video-generation` * `disable-onedrive-upload` * `disable-talk-to-content` * `disable-google-drive-upload` * `disable-welcome-emails` * `disable-canvas` * `canvas-workspace` * `canvas-app-builder` * `skills` * `skill-sharing` * `skill-sharing-without-admin-approval` * `disable-projects` * `sobi` * `enable-end-user-sharing-with-groups` * `single-agent-orchestration` * `multi-agent-orchestration` * `cross-product-intelligence` * `workflow-agents` * `in-app-notifications`
+      "features": { # Optional. Feature config for the engine to opt in or opt out of features. Supported keys: * `*`: all features, if it's present, all other feature state settings are ignored. * `agent-gallery` * `no-code-agent-builder` * `prompt-gallery` * `model-selector` * `notebook-lm` * `people-search` * `people-search-org-chart` * `bi-directional-audio` * `speech-to-text` * `feedback` * `session-sharing` * `personalization-memory` * `personalization-suggested-highlights` * `mobile-app-access` * `disable-agent-sharing` * `disable-image-generation` * `disable-video-generation` * `disable-onedrive-upload` * `disable-talk-to-content` * `disable-google-drive-upload` * `disable-welcome-emails` * `disable-canvas` * `canvas-workspace` * `canvas-app-builder` * `skills` * `skill-sharing` * `skill-sharing-without-admin-approval` * `disable-projects` * `sobi` * `enable-end-user-sharing-with-groups` * `single-agent-orchestration` * `multi-agent-orchestration` * `cross-product-intelligence` * `workflow-agents` * `in-app-notifications` * `code-extraction`
         "a_key": "A String",
       },
       "industryVertical": "A String", # Optional. The industry vertical that the engine registers. The restriction of the Engine industry vertical is based on DataStore: Vertical on Engine has to match vertical of the DataStore linked to the engine.
@@ -810,7 +805,7 @@ 
Method Details

   ],
   "disableAnalytics": True or False, # Optional. Whether to disable analytics for searches performed on this engine.
   "displayName": "A String", # Required. The display name of the engine. Should be human readable. UTF-8 encoded string with limit of 1024 characters.
-  "features": { # Optional. Feature config for the engine to opt in or opt out of features. Supported keys: * `*`: all features, if it's present, all other feature state settings are ignored. * `agent-gallery` * `no-code-agent-builder` * `prompt-gallery` * `model-selector` * `notebook-lm` * `people-search` * `people-search-org-chart` * `bi-directional-audio` * `speech-to-text` * `feedback` * `session-sharing` * `personalization-memory` * `personalization-suggested-highlights` * `mobile-app-access` * `disable-agent-sharing` * `disable-image-generation` * `disable-video-generation` * `disable-onedrive-upload` * `disable-talk-to-content` * `disable-google-drive-upload` * `disable-welcome-emails` * `disable-canvas` * `canvas-workspace` * `canvas-app-builder` * `skills` * `skill-sharing` * `skill-sharing-without-admin-approval` * `disable-projects` * `sobi` * `enable-end-user-sharing-with-groups` * `single-agent-orchestration` * `multi-agent-orchestration` * `cross-product-intelligence` * `workflow-agents` * `in-app-notifications`
+  "features": { # Optional. Feature config for the engine to opt in or opt out of features. Supported keys: * `*`: all features, if it's present, all other feature state settings are ignored. * `agent-gallery` * `no-code-agent-builder` * `prompt-gallery` * `model-selector` * `notebook-lm` * `people-search` * `people-search-org-chart` * `bi-directional-audio` * `speech-to-text` * `feedback` * `session-sharing` * `personalization-memory` * `personalization-suggested-highlights` * `mobile-app-access` * `disable-agent-sharing` * `disable-image-generation` * `disable-video-generation` * `disable-onedrive-upload` * `disable-talk-to-content` * `disable-google-drive-upload` * `disable-welcome-emails` * `disable-canvas` * `canvas-workspace` * `canvas-app-builder` * `skills` * `skill-sharing` * `skill-sharing-without-admin-approval` * `disable-projects` * `sobi` * `enable-end-user-sharing-with-groups` * `single-agent-orchestration` * `multi-agent-orchestration` * `cross-product-intelligence` * `workflow-agents` * `in-app-notifications` * `code-extraction`
     "a_key": "A String",
   },
   "industryVertical": "A String", # Optional. The industry vertical that the engine registers. The restriction of the Engine industry vertical is based on DataStore: Vertical on Engine has to match vertical of the DataStore linked to the engine.
@@ -942,7 +937,7 @@ 
Method Details

   ],
   "disableAnalytics": True or False, # Optional. Whether to disable analytics for searches performed on this engine.
   "displayName": "A String", # Required. The display name of the engine. Should be human readable. UTF-8 encoded string with limit of 1024 characters.
-  "features": { # Optional. Feature config for the engine to opt in or opt out of features. Supported keys: * `*`: all features, if it's present, all other feature state settings are ignored. * `agent-gallery` * `no-code-agent-builder` * `prompt-gallery` * `model-selector` * `notebook-lm` * `people-search` * `people-search-org-chart` * `bi-directional-audio` * `speech-to-text` * `feedback` * `session-sharing` * `personalization-memory` * `personalization-suggested-highlights` * `mobile-app-access` * `disable-agent-sharing` * `disable-image-generation` * `disable-video-generation` * `disable-onedrive-upload` * `disable-talk-to-content` * `disable-google-drive-upload` * `disable-welcome-emails` * `disable-canvas` * `canvas-workspace` * `canvas-app-builder` * `skills` * `skill-sharing` * `skill-sharing-without-admin-approval` * `disable-projects` * `sobi` * `enable-end-user-sharing-with-groups` * `single-agent-orchestration` * `multi-agent-orchestration` * `cross-product-intelligence` * `workflow-agents` * `in-app-notifications`
+  "features": { # Optional. Feature config for the engine to opt in or opt out of features. Supported keys: * `*`: all features, if it's present, all other feature state settings are ignored. * `agent-gallery` * `no-code-agent-builder` * `prompt-gallery` * `model-selector` * `notebook-lm` * `people-search` * `people-search-org-chart` * `bi-directional-audio` * `speech-to-text` * `feedback` * `session-sharing` * `personalization-memory` * `personalization-suggested-highlights` * `mobile-app-access` * `disable-agent-sharing` * `disable-image-generation` * `disable-video-generation` * `disable-onedrive-upload` * `disable-talk-to-content` * `disable-google-drive-upload` * `disable-welcome-emails` * `disable-canvas` * `canvas-workspace` * `canvas-app-builder` * `skills` * `skill-sharing` * `skill-sharing-without-admin-approval` * `disable-projects` * `sobi` * `enable-end-user-sharing-with-groups` * `single-agent-orchestration` * `multi-agent-orchestration` * `cross-product-intelligence` * `workflow-agents` * `in-app-notifications` * `code-extraction`
     "a_key": "A String",
   },
   "industryVertical": "A String", # Optional. The industry vertical that the engine registers. The restriction of the Engine industry vertical is based on DataStore: Vertical on Engine has to match vertical of the DataStore linked to the engine.
@@ -1086,7 +1081,7 @@ 
Method Details

   ],
   "disableAnalytics": True or False, # Optional. Whether to disable analytics for searches performed on this engine.
   "displayName": "A String", # Required. The display name of the engine. Should be human readable. UTF-8 encoded string with limit of 1024 characters.
-  "features": { # Optional. Feature config for the engine to opt in or opt out of features. Supported keys: * `*`: all features, if it's present, all other feature state settings are ignored. * `agent-gallery` * `no-code-agent-builder` * `prompt-gallery` * `model-selector` * `notebook-lm` * `people-search` * `people-search-org-chart` * `bi-directional-audio` * `speech-to-text` * `feedback` * `session-sharing` * `personalization-memory` * `personalization-suggested-highlights` * `mobile-app-access` * `disable-agent-sharing` * `disable-image-generation` * `disable-video-generation` * `disable-onedrive-upload` * `disable-talk-to-content` * `disable-google-drive-upload` * `disable-welcome-emails` * `disable-canvas` * `canvas-workspace` * `canvas-app-builder` * `skills` * `skill-sharing` * `skill-sharing-without-admin-approval` * `disable-projects` * `sobi` * `enable-end-user-sharing-with-groups` * `single-agent-orchestration` * `multi-agent-orchestration` * `cross-product-intelligence` * `workflow-agents` * `in-app-notifications`
+  "features": { # Optional. Feature config for the engine to opt in or opt out of features. Supported keys: * `*`: all features, if it's present, all other feature state settings are ignored. * `agent-gallery` * `no-code-agent-builder` * `prompt-gallery` * `model-selector` * `notebook-lm` * `people-search` * `people-search-org-chart` * `bi-directional-audio` * `speech-to-text` * `feedback` * `session-sharing` * `personalization-memory` * `personalization-suggested-highlights` * `mobile-app-access` * `disable-agent-sharing` * `disable-image-generation` * `disable-video-generation` * `disable-onedrive-upload` * `disable-talk-to-content` * `disable-google-drive-upload` * `disable-welcome-emails` * `disable-canvas` * `canvas-workspace` * `canvas-app-builder` * `skills` * `skill-sharing` * `skill-sharing-without-admin-approval` * `disable-projects` * `sobi` * `enable-end-user-sharing-with-groups` * `single-agent-orchestration` * `multi-agent-orchestration` * `cross-product-intelligence` * `workflow-agents` * `in-app-notifications` * `code-extraction`
     "a_key": "A String",
   },
   "industryVertical": "A String", # Optional. The industry vertical that the engine registers. The restriction of the Engine industry vertical is based on DataStore: Vertical on Engine has to match vertical of the DataStore linked to the engine.
@@ -1230,7 +1225,7 @@ 
Method Details

   ],
   "disableAnalytics": True or False, # Optional. Whether to disable analytics for searches performed on this engine.
   "displayName": "A String", # Required. The display name of the engine. Should be human readable. UTF-8 encoded string with limit of 1024 characters.
-  "features": { # Optional. Feature config for the engine to opt in or opt out of features. Supported keys: * `*`: all features, if it's present, all other feature state settings are ignored. * `agent-gallery` * `no-code-agent-builder` * `prompt-gallery` * `model-selector` * `notebook-lm` * `people-search` * `people-search-org-chart` * `bi-directional-audio` * `speech-to-text` * `feedback` * `session-sharing` * `personalization-memory` * `personalization-suggested-highlights` * `mobile-app-access` * `disable-agent-sharing` * `disable-image-generation` * `disable-video-generation` * `disable-onedrive-upload` * `disable-talk-to-content` * `disable-google-drive-upload` * `disable-welcome-emails` * `disable-canvas` * `canvas-workspace` * `canvas-app-builder` * `skills` * `skill-sharing` * `skill-sharing-without-admin-approval` * `disable-projects` * `sobi` * `enable-end-user-sharing-with-groups` * `single-agent-orchestration` * `multi-agent-orchestration` * `cross-product-intelligence` * `workflow-agents` * `in-app-notifications`
+  "features": { # Optional. Feature config for the engine to opt in or opt out of features. Supported keys: * `*`: all features, if it's present, all other feature state settings are ignored. * `agent-gallery` * `no-code-agent-builder` * `prompt-gallery` * `model-selector` * `notebook-lm` * `people-search` * `people-search-org-chart` * `bi-directional-audio` * `speech-to-text` * `feedback` * `session-sharing` * `personalization-memory` * `personalization-suggested-highlights` * `mobile-app-access` * `disable-agent-sharing` * `disable-image-generation` * `disable-video-generation` * `disable-onedrive-upload` * `disable-talk-to-content` * `disable-google-drive-upload` * `disable-welcome-emails` * `disable-canvas` * `canvas-workspace` * `canvas-app-builder` * `skills` * `skill-sharing` * `skill-sharing-without-admin-approval` * `disable-projects` * `sobi` * `enable-end-user-sharing-with-groups` * `single-agent-orchestration` * `multi-agent-orchestration` * `cross-product-intelligence` * `workflow-agents` * `in-app-notifications` * `code-extraction`
     "a_key": "A String",
   },
   "industryVertical": "A String", # Optional. The industry vertical that the engine registers. The restriction of the Engine industry vertical is based on DataStore: Vertical on Engine has to match vertical of the DataStore linked to the engine.
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 2651c81505..8c7cfbc562 100644
--- a/docs/dyn/discoveryengine_v1alpha.projects.locations.collections.engines.servingConfigs.html
+++ b/docs/dyn/discoveryengine_v1alpha.projects.locations.collections.engines.servingConfigs.html
@@ -1714,7 +1714,9 @@ 
Method Details

         },
         "questionIndex": 42, # The index of the user input within the conversation messages.
         "session": "A String", # Name of the newly generated or continued session.
-        "taskName": "A String", # Optional. The full resource name of the Sobi task if the conversation was handled by a long-running agent task. Format: projects/{project}/locations/{location}/tasks/{task_id}
+        "stepSeqNum": "A String", # Optional. The `TaskServerEvent.seq_num` of the step that opened the rated agent task reply.
+        "taskName": "A String", # Optional. The full resource name of the Sobi task if the conversation was handled by a long-running agent task. Format (canonical, or the short alias the Task API also accepts): projects/{project}/locations/{location}/agents/{agent}/tasks/{task} projects/{project}/locations/{location}/tasks/{task}
+        "trajectoryId": "A String", # Optional. The runtime trajectory id of the rated agent task turn, as set on `TaskServerEvent.trajectory_id`. Shared by all steps of the turn.
       },
       "dataTermsAccepted": True or False, # Optional. Whether the customer accepted data use terms.
       "feedbackSource": "A String", # Optional. The UI component the user feedback comes from, which could be GOOGLE_CONSOLE, GOOGLE_WIDGET, GOOGLE_WEBAPP.
@@ -1972,7 +1974,7 @@ 
Method Details

       "A String",
     ],
   },
-  "dataStoreSpecs": [ # Specifications that define the specific DataStores to be searched, along with configurations for those data stores. This is only considered for Engines with multiple data stores. For engines with a single data store, the specs directly under SearchRequest should be used.
+  "dataStoreSpecs": [ # Specifications that define the specific DataStores to be searched, along with configurations for those data stores. This is only considered for Engines with multiple data stores. For engines with a single data store, the specs directly under SearchRequest should be used. On an engine with multiple data stores, this field is optional. If it's empty, all of the engine's data stores are searched (blended search). Unless it specifies exactly one data store, some request fields, such as `order_by` and `query_expansion_spec`, aren't supported and return an `INVALID_ARGUMENT` error.
     { # A struct to define data stores to filter on in a search call and configurations for those data stores. Otherwise, an `INVALID_ARGUMENT` error is returned.
       "boostSpec": { # Boost specification to boost certain documents. # Optional. Boost specification to boost certain documents. For more information on boosting, see [Boosting](https://cloud.google.com/generative-ai-app-builder/docs/boost-search-results)
         "conditionBoostSpecs": [ # Condition boost specifications. If a document matches multiple conditions in the specifications, boost scores from these specifications are all applied and combined in a non-linear way. Maximum number of specifications is 20.
@@ -2658,7 +2660,7 @@ 
Method Details

       "A String",
     ],
   },
-  "dataStoreSpecs": [ # Specifications that define the specific DataStores to be searched, along with configurations for those data stores. This is only considered for Engines with multiple data stores. For engines with a single data store, the specs directly under SearchRequest should be used.
+  "dataStoreSpecs": [ # Specifications that define the specific DataStores to be searched, along with configurations for those data stores. This is only considered for Engines with multiple data stores. For engines with a single data store, the specs directly under SearchRequest should be used. On an engine with multiple data stores, this field is optional. If it's empty, all of the engine's data stores are searched (blended search). Unless it specifies exactly one data store, some request fields, such as `order_by` and `query_expansion_spec`, aren't supported and return an `INVALID_ARGUMENT` error.
     { # A struct to define data stores to filter on in a search call and configurations for those data stores. Otherwise, an `INVALID_ARGUMENT` error is returned.
       "boostSpec": { # Boost specification to boost certain documents. # Optional. Boost specification to boost certain documents. For more information on boosting, see [Boosting](https://cloud.google.com/generative-ai-app-builder/docs/boost-search-results)
         "conditionBoostSpecs": [ # Condition boost specifications. If a document matches multiple conditions in the specifications, boost scores from these specifications are all applied and combined in a non-linear way. Maximum number of specifications is 20.
diff --git a/docs/dyn/discoveryengine_v1alpha.projects.locations.collections.engines.widgetConfigs.html b/docs/dyn/discoveryengine_v1alpha.projects.locations.collections.engines.widgetConfigs.html
index 94b301326a..009cf6a828 100644
--- a/docs/dyn/discoveryengine_v1alpha.projects.locations.collections.engines.widgetConfigs.html
+++ b/docs/dyn/discoveryengine_v1alpha.projects.locations.collections.engines.widgetConfigs.html
@@ -341,7 +341,7 @@ 
Method Details

     "enableSafeSearch": True or False, # Whether to enable safe search.
     "enableSearchAsYouType": True or False, # Whether to enable search-as-you-type behavior for the search widget.
     "enableVisualContentSummary": True or False, # If set to true, the widget will enable visual content summary on applicable search requests. Only used by healthcare search.
-    "features": { # Output only. Feature config for the engine to opt in or opt out of features. Supported keys: * `agent-gallery` * `no-code-agent-builder` * `prompt-gallery` * `model-selector` * `notebook-lm` * `people-search` * `people-search-org-chart` * `bi-directional-audio` * `speech-to-text` * `feedback` * `session-sharing` * `personalization-memory` * `personalization-suggested-highlights` * `mobile-app-access` * `disable-agent-sharing` * `disable-image-generation` * `disable-video-generation` * `disable-onedrive-upload` * `disable-talk-to-content` * `disable-google-drive-upload` * `disable-welcome-emails` * `disable-canvas` * `canvas-workspace` * `canvas-app-builder` * `skills` * `skill-sharing` * `skill-sharing-without-admin-approval` * `disable-projects` * `sobi` * `enable-end-user-sharing-with-groups` * `single-agent-orchestration` * `multi-agent-orchestration` * `cross-product-intelligence` * `workflow-agents` * `in-app-notifications`
+    "features": { # Output only. Feature config for the engine to opt in or opt out of features. Supported keys: * `agent-gallery` * `no-code-agent-builder` * `prompt-gallery` * `model-selector` * `notebook-lm` * `people-search` * `people-search-org-chart` * `bi-directional-audio` * `speech-to-text` * `feedback` * `session-sharing` * `personalization-memory` * `personalization-suggested-highlights` * `mobile-app-access` * `disable-agent-sharing` * `disable-image-generation` * `disable-video-generation` * `disable-onedrive-upload` * `disable-talk-to-content` * `disable-google-drive-upload` * `disable-welcome-emails` * `disable-canvas` * `canvas-workspace` * `canvas-app-builder` * `skills` * `skill-sharing` * `skill-sharing-without-admin-approval` * `disable-projects` * `sobi` * `enable-end-user-sharing-with-groups` * `single-agent-orchestration` * `multi-agent-orchestration` * `cross-product-intelligence` * `workflow-agents` * `in-app-notifications` * `code-extraction`
       "a_key": "A String",
     },
     "generativeAnswerConfig": { # Describes configuration for generative answer. # Describes generative answer configuration.
@@ -636,7 +636,7 @@ 
Method Details

     "enableSafeSearch": True or False, # Whether to enable safe search.
     "enableSearchAsYouType": True or False, # Whether to enable search-as-you-type behavior for the search widget.
     "enableVisualContentSummary": True or False, # If set to true, the widget will enable visual content summary on applicable search requests. Only used by healthcare search.
-    "features": { # Output only. Feature config for the engine to opt in or opt out of features. Supported keys: * `agent-gallery` * `no-code-agent-builder` * `prompt-gallery` * `model-selector` * `notebook-lm` * `people-search` * `people-search-org-chart` * `bi-directional-audio` * `speech-to-text` * `feedback` * `session-sharing` * `personalization-memory` * `personalization-suggested-highlights` * `mobile-app-access` * `disable-agent-sharing` * `disable-image-generation` * `disable-video-generation` * `disable-onedrive-upload` * `disable-talk-to-content` * `disable-google-drive-upload` * `disable-welcome-emails` * `disable-canvas` * `canvas-workspace` * `canvas-app-builder` * `skills` * `skill-sharing` * `skill-sharing-without-admin-approval` * `disable-projects` * `sobi` * `enable-end-user-sharing-with-groups` * `single-agent-orchestration` * `multi-agent-orchestration` * `cross-product-intelligence` * `workflow-agents` * `in-app-notifications`
+    "features": { # Output only. Feature config for the engine to opt in or opt out of features. Supported keys: * `agent-gallery` * `no-code-agent-builder` * `prompt-gallery` * `model-selector` * `notebook-lm` * `people-search` * `people-search-org-chart` * `bi-directional-audio` * `speech-to-text` * `feedback` * `session-sharing` * `personalization-memory` * `personalization-suggested-highlights` * `mobile-app-access` * `disable-agent-sharing` * `disable-image-generation` * `disable-video-generation` * `disable-onedrive-upload` * `disable-talk-to-content` * `disable-google-drive-upload` * `disable-welcome-emails` * `disable-canvas` * `canvas-workspace` * `canvas-app-builder` * `skills` * `skill-sharing` * `skill-sharing-without-admin-approval` * `disable-projects` * `sobi` * `enable-end-user-sharing-with-groups` * `single-agent-orchestration` * `multi-agent-orchestration` * `cross-product-intelligence` * `workflow-agents` * `in-app-notifications` * `code-extraction`
       "a_key": "A String",
     },
     "generativeAnswerConfig": { # Describes configuration for generative answer. # Describes generative answer configuration.
@@ -930,7 +930,7 @@ 
Method Details

     "enableSafeSearch": True or False, # Whether to enable safe search.
     "enableSearchAsYouType": True or False, # Whether to enable search-as-you-type behavior for the search widget.
     "enableVisualContentSummary": True or False, # If set to true, the widget will enable visual content summary on applicable search requests. Only used by healthcare search.
-    "features": { # Output only. Feature config for the engine to opt in or opt out of features. Supported keys: * `agent-gallery` * `no-code-agent-builder` * `prompt-gallery` * `model-selector` * `notebook-lm` * `people-search` * `people-search-org-chart` * `bi-directional-audio` * `speech-to-text` * `feedback` * `session-sharing` * `personalization-memory` * `personalization-suggested-highlights` * `mobile-app-access` * `disable-agent-sharing` * `disable-image-generation` * `disable-video-generation` * `disable-onedrive-upload` * `disable-talk-to-content` * `disable-google-drive-upload` * `disable-welcome-emails` * `disable-canvas` * `canvas-workspace` * `canvas-app-builder` * `skills` * `skill-sharing` * `skill-sharing-without-admin-approval` * `disable-projects` * `sobi` * `enable-end-user-sharing-with-groups` * `single-agent-orchestration` * `multi-agent-orchestration` * `cross-product-intelligence` * `workflow-agents` * `in-app-notifications`
+    "features": { # Output only. Feature config for the engine to opt in or opt out of features. Supported keys: * `agent-gallery` * `no-code-agent-builder` * `prompt-gallery` * `model-selector` * `notebook-lm` * `people-search` * `people-search-org-chart` * `bi-directional-audio` * `speech-to-text` * `feedback` * `session-sharing` * `personalization-memory` * `personalization-suggested-highlights` * `mobile-app-access` * `disable-agent-sharing` * `disable-image-generation` * `disable-video-generation` * `disable-onedrive-upload` * `disable-talk-to-content` * `disable-google-drive-upload` * `disable-welcome-emails` * `disable-canvas` * `canvas-workspace` * `canvas-app-builder` * `skills` * `skill-sharing` * `skill-sharing-without-admin-approval` * `disable-projects` * `sobi` * `enable-end-user-sharing-with-groups` * `single-agent-orchestration` * `multi-agent-orchestration` * `cross-product-intelligence` * `workflow-agents` * `in-app-notifications` * `code-extraction`
       "a_key": "A String",
     },
     "generativeAnswerConfig": { # Describes configuration for generative answer. # Describes generative answer configuration.
diff --git a/docs/dyn/discoveryengine_v1alpha.projects.locations.collections.html b/docs/dyn/discoveryengine_v1alpha.projects.locations.collections.html
index 32d4f81e84..654aae7962 100644
--- a/docs/dyn/discoveryengine_v1alpha.projects.locations.collections.html
+++ b/docs/dyn/discoveryengine_v1alpha.projects.locations.collections.html
@@ -321,6 +321,8 @@ 
Method Details

               "indexableOption": "A String", # If indexable_option is INDEXABLE_ENABLED, field values are indexed so that it can be filtered or faceted in SearchService.Search. If indexable_option is unset, the server behavior defaults to INDEXABLE_DISABLED for fields that support setting indexable options. For those fields that do not support setting indexable options, such as `object` and `boolean` and key properties, the server will skip indexable_option setting, and setting indexable_option for those fields will throw `INVALID_ARGUMENT` error.
               "keyPropertyType": "A String", # Output only. Type of the key property that this field is mapped to. Empty string if this is not annotated as mapped to a key property. Example types are `title`, `description`. Full list is defined by `keyPropertyMapping` in the schema field annotation. If the schema field has a `KeyPropertyMapping` annotation, `indexable_option` and `searchable_option` of this field cannot be modified.
               "metatagName": "A String", # Optional. The metatag name found in the HTML page. If user defines this field, the value of this metatag name will be used to extract metatag. If the user does not define this field, the FieldConfig.field_path will be used to extract metatag.
+              "partialMatchableOption": "A String", # Optional. If partial_matchable_option is PARTIAL_MATCHABLE_OPTION_ENABLED, field values are partial matchable. If partial_matchable_option is unset, the server behavior defaults to PARTIAL_MATCHABLE_OPTION_DISABLED for fields that support setting partial matchable options. For those fields that do not support setting partial matchable options, the server will skip partial matchable option setting, and setting partial_matchable_option for those fields will throw `INVALID_ARGUMENT` error.
+              "prefixMatchableOption": "A String", # Optional. If prefix_matchable_option is PREFIX_MATCHABLE_OPTION_ENABLED, field values are prefix matchable. If prefix_matchable_option is unset, the server behavior defaults to PREFIX_MATCHABLE_OPTION_DISABLED for fields that support setting prefix matchable options. For those fields that do not support setting prefix matchable options, the server will skip prefix matchable option setting, and setting prefix_matchable_option for those fields will throw `INVALID_ARGUMENT` error.
               "recsFilterableOption": "A String", # If recs_filterable_option is FILTERABLE_ENABLED, field values are filterable by filter expression in RecommendationService.Recommend. If FILTERABLE_ENABLED but the field type is numerical, field values are not filterable by text queries in RecommendationService.Recommend. Only textual fields are supported. If recs_filterable_option is unset, the default setting is FILTERABLE_DISABLED for fields that support setting filterable options. When a field set to [FILTERABLE_DISABLED] is filtered, a warning is generated and an empty result is returned.
               "retrievableOption": "A String", # If retrievable_option is RETRIEVABLE_ENABLED, field values are included in the search results. If retrievable_option is unset, the server behavior defaults to RETRIEVABLE_DISABLED for fields that support setting retrievable options. For those fields that do not support setting retrievable options, such as `object` and `boolean`, the server will skip retrievable option setting, and setting retrievable_option for those fields will throw `INVALID_ARGUMENT` error.
               "schemaOrgPaths": [ # Field paths for indexing custom attribute from schema.org data. More details of schema.org and its defined types can be found at [schema.org](https://schema.org). It is only used on advanced site search schema. Currently only support full path from root. The full path to a field is constructed by concatenating field names, starting from `_root`, with a period `.` as the delimiter. Examples: * Publish date of the root: _root.datePublished * Publish date of the reviews: _root.review.datePublished
@@ -602,6 +604,8 @@ 
Method Details

             "indexableOption": "A String", # If indexable_option is INDEXABLE_ENABLED, field values are indexed so that it can be filtered or faceted in SearchService.Search. If indexable_option is unset, the server behavior defaults to INDEXABLE_DISABLED for fields that support setting indexable options. For those fields that do not support setting indexable options, such as `object` and `boolean` and key properties, the server will skip indexable_option setting, and setting indexable_option for those fields will throw `INVALID_ARGUMENT` error.
             "keyPropertyType": "A String", # Output only. Type of the key property that this field is mapped to. Empty string if this is not annotated as mapped to a key property. Example types are `title`, `description`. Full list is defined by `keyPropertyMapping` in the schema field annotation. If the schema field has a `KeyPropertyMapping` annotation, `indexable_option` and `searchable_option` of this field cannot be modified.
             "metatagName": "A String", # Optional. The metatag name found in the HTML page. If user defines this field, the value of this metatag name will be used to extract metatag. If the user does not define this field, the FieldConfig.field_path will be used to extract metatag.
+            "partialMatchableOption": "A String", # Optional. If partial_matchable_option is PARTIAL_MATCHABLE_OPTION_ENABLED, field values are partial matchable. If partial_matchable_option is unset, the server behavior defaults to PARTIAL_MATCHABLE_OPTION_DISABLED for fields that support setting partial matchable options. For those fields that do not support setting partial matchable options, the server will skip partial matchable option setting, and setting partial_matchable_option for those fields will throw `INVALID_ARGUMENT` error.
+            "prefixMatchableOption": "A String", # Optional. If prefix_matchable_option is PREFIX_MATCHABLE_OPTION_ENABLED, field values are prefix matchable. If prefix_matchable_option is unset, the server behavior defaults to PREFIX_MATCHABLE_OPTION_DISABLED for fields that support setting prefix matchable options. For those fields that do not support setting prefix matchable options, the server will skip prefix matchable option setting, and setting prefix_matchable_option for those fields will throw `INVALID_ARGUMENT` error.
             "recsFilterableOption": "A String", # If recs_filterable_option is FILTERABLE_ENABLED, field values are filterable by filter expression in RecommendationService.Recommend. If FILTERABLE_ENABLED but the field type is numerical, field values are not filterable by text queries in RecommendationService.Recommend. Only textual fields are supported. If recs_filterable_option is unset, the default setting is FILTERABLE_DISABLED for fields that support setting filterable options. When a field set to [FILTERABLE_DISABLED] is filtered, a warning is generated and an empty result is returned.
             "retrievableOption": "A String", # If retrievable_option is RETRIEVABLE_ENABLED, field values are included in the search results. If retrievable_option is unset, the server behavior defaults to RETRIEVABLE_DISABLED for fields that support setting retrievable options. For those fields that do not support setting retrievable options, such as `object` and `boolean`, the server will skip retrievable option setting, and setting retrievable_option for those fields will throw `INVALID_ARGUMENT` error.
             "schemaOrgPaths": [ # Field paths for indexing custom attribute from schema.org data. More details of schema.org and its defined types can be found at [schema.org](https://schema.org). It is only used on advanced site search schema. Currently only support full path from root. The full path to a field is constructed by concatenating field names, starting from `_root`, with a period `.` as the delimiter. Examples: * Publish date of the root: _root.datePublished * Publish date of the reviews: _root.review.datePublished
@@ -922,6 +926,8 @@ 
Method Details

                   "indexableOption": "A String", # If indexable_option is INDEXABLE_ENABLED, field values are indexed so that it can be filtered or faceted in SearchService.Search. If indexable_option is unset, the server behavior defaults to INDEXABLE_DISABLED for fields that support setting indexable options. For those fields that do not support setting indexable options, such as `object` and `boolean` and key properties, the server will skip indexable_option setting, and setting indexable_option for those fields will throw `INVALID_ARGUMENT` error.
                   "keyPropertyType": "A String", # Output only. Type of the key property that this field is mapped to. Empty string if this is not annotated as mapped to a key property. Example types are `title`, `description`. Full list is defined by `keyPropertyMapping` in the schema field annotation. If the schema field has a `KeyPropertyMapping` annotation, `indexable_option` and `searchable_option` of this field cannot be modified.
                   "metatagName": "A String", # Optional. The metatag name found in the HTML page. If user defines this field, the value of this metatag name will be used to extract metatag. If the user does not define this field, the FieldConfig.field_path will be used to extract metatag.
+                  "partialMatchableOption": "A String", # Optional. If partial_matchable_option is PARTIAL_MATCHABLE_OPTION_ENABLED, field values are partial matchable. If partial_matchable_option is unset, the server behavior defaults to PARTIAL_MATCHABLE_OPTION_DISABLED for fields that support setting partial matchable options. For those fields that do not support setting partial matchable options, the server will skip partial matchable option setting, and setting partial_matchable_option for those fields will throw `INVALID_ARGUMENT` error.
+                  "prefixMatchableOption": "A String", # Optional. If prefix_matchable_option is PREFIX_MATCHABLE_OPTION_ENABLED, field values are prefix matchable. If prefix_matchable_option is unset, the server behavior defaults to PREFIX_MATCHABLE_OPTION_DISABLED for fields that support setting prefix matchable options. For those fields that do not support setting prefix matchable options, the server will skip prefix matchable option setting, and setting prefix_matchable_option for those fields will throw `INVALID_ARGUMENT` error.
                   "recsFilterableOption": "A String", # If recs_filterable_option is FILTERABLE_ENABLED, field values are filterable by filter expression in RecommendationService.Recommend. If FILTERABLE_ENABLED but the field type is numerical, field values are not filterable by text queries in RecommendationService.Recommend. Only textual fields are supported. If recs_filterable_option is unset, the default setting is FILTERABLE_DISABLED for fields that support setting filterable options. When a field set to [FILTERABLE_DISABLED] is filtered, a warning is generated and an empty result is returned.
                   "retrievableOption": "A String", # If retrievable_option is RETRIEVABLE_ENABLED, field values are included in the search results. If retrievable_option is unset, the server behavior defaults to RETRIEVABLE_DISABLED for fields that support setting retrievable options. For those fields that do not support setting retrievable options, such as `object` and `boolean`, the server will skip retrievable option setting, and setting retrievable_option for those fields will throw `INVALID_ARGUMENT` error.
                   "schemaOrgPaths": [ # Field paths for indexing custom attribute from schema.org data. More details of schema.org and its defined types can be found at [schema.org](https://schema.org). It is only used on advanced site search schema. Currently only support full path from root. The full path to a field is constructed by concatenating field names, starting from `_root`, with a period `.` as the delimiter. Examples: * Publish date of the root: _root.datePublished * Publish date of the reviews: _root.review.datePublished
@@ -1217,6 +1223,8 @@ 
Method Details

               "indexableOption": "A String", # If indexable_option is INDEXABLE_ENABLED, field values are indexed so that it can be filtered or faceted in SearchService.Search. If indexable_option is unset, the server behavior defaults to INDEXABLE_DISABLED for fields that support setting indexable options. For those fields that do not support setting indexable options, such as `object` and `boolean` and key properties, the server will skip indexable_option setting, and setting indexable_option for those fields will throw `INVALID_ARGUMENT` error.
               "keyPropertyType": "A String", # Output only. Type of the key property that this field is mapped to. Empty string if this is not annotated as mapped to a key property. Example types are `title`, `description`. Full list is defined by `keyPropertyMapping` in the schema field annotation. If the schema field has a `KeyPropertyMapping` annotation, `indexable_option` and `searchable_option` of this field cannot be modified.
               "metatagName": "A String", # Optional. The metatag name found in the HTML page. If user defines this field, the value of this metatag name will be used to extract metatag. If the user does not define this field, the FieldConfig.field_path will be used to extract metatag.
+              "partialMatchableOption": "A String", # Optional. If partial_matchable_option is PARTIAL_MATCHABLE_OPTION_ENABLED, field values are partial matchable. If partial_matchable_option is unset, the server behavior defaults to PARTIAL_MATCHABLE_OPTION_DISABLED for fields that support setting partial matchable options. For those fields that do not support setting partial matchable options, the server will skip partial matchable option setting, and setting partial_matchable_option for those fields will throw `INVALID_ARGUMENT` error.
+              "prefixMatchableOption": "A String", # Optional. If prefix_matchable_option is PREFIX_MATCHABLE_OPTION_ENABLED, field values are prefix matchable. If prefix_matchable_option is unset, the server behavior defaults to PREFIX_MATCHABLE_OPTION_DISABLED for fields that support setting prefix matchable options. For those fields that do not support setting prefix matchable options, the server will skip prefix matchable option setting, and setting prefix_matchable_option for those fields will throw `INVALID_ARGUMENT` error.
               "recsFilterableOption": "A String", # If recs_filterable_option is FILTERABLE_ENABLED, field values are filterable by filter expression in RecommendationService.Recommend. If FILTERABLE_ENABLED but the field type is numerical, field values are not filterable by text queries in RecommendationService.Recommend. Only textual fields are supported. If recs_filterable_option is unset, the default setting is FILTERABLE_DISABLED for fields that support setting filterable options. When a field set to [FILTERABLE_DISABLED] is filtered, a warning is generated and an empty result is returned.
               "retrievableOption": "A String", # If retrievable_option is RETRIEVABLE_ENABLED, field values are included in the search results. If retrievable_option is unset, the server behavior defaults to RETRIEVABLE_DISABLED for fields that support setting retrievable options. For those fields that do not support setting retrievable options, such as `object` and `boolean`, the server will skip retrievable option setting, and setting retrievable_option for those fields will throw `INVALID_ARGUMENT` error.
               "schemaOrgPaths": [ # Field paths for indexing custom attribute from schema.org data. More details of schema.org and its defined types can be found at [schema.org](https://schema.org). It is only used on advanced site search schema. Currently only support full path from root. The full path to a field is constructed by concatenating field names, starting from `_root`, with a period `.` as the delimiter. Examples: * Publish date of the root: _root.datePublished * Publish date of the reviews: _root.review.datePublished
@@ -1580,6 +1588,8 @@ 
Method Details

             "indexableOption": "A String", # If indexable_option is INDEXABLE_ENABLED, field values are indexed so that it can be filtered or faceted in SearchService.Search. If indexable_option is unset, the server behavior defaults to INDEXABLE_DISABLED for fields that support setting indexable options. For those fields that do not support setting indexable options, such as `object` and `boolean` and key properties, the server will skip indexable_option setting, and setting indexable_option for those fields will throw `INVALID_ARGUMENT` error.
             "keyPropertyType": "A String", # Output only. Type of the key property that this field is mapped to. Empty string if this is not annotated as mapped to a key property. Example types are `title`, `description`. Full list is defined by `keyPropertyMapping` in the schema field annotation. If the schema field has a `KeyPropertyMapping` annotation, `indexable_option` and `searchable_option` of this field cannot be modified.
             "metatagName": "A String", # Optional. The metatag name found in the HTML page. If user defines this field, the value of this metatag name will be used to extract metatag. If the user does not define this field, the FieldConfig.field_path will be used to extract metatag.
+            "partialMatchableOption": "A String", # Optional. If partial_matchable_option is PARTIAL_MATCHABLE_OPTION_ENABLED, field values are partial matchable. If partial_matchable_option is unset, the server behavior defaults to PARTIAL_MATCHABLE_OPTION_DISABLED for fields that support setting partial matchable options. For those fields that do not support setting partial matchable options, the server will skip partial matchable option setting, and setting partial_matchable_option for those fields will throw `INVALID_ARGUMENT` error.
+            "prefixMatchableOption": "A String", # Optional. If prefix_matchable_option is PREFIX_MATCHABLE_OPTION_ENABLED, field values are prefix matchable. If prefix_matchable_option is unset, the server behavior defaults to PREFIX_MATCHABLE_OPTION_DISABLED for fields that support setting prefix matchable options. For those fields that do not support setting prefix matchable options, the server will skip prefix matchable option setting, and setting prefix_matchable_option for those fields will throw `INVALID_ARGUMENT` error.
             "recsFilterableOption": "A String", # If recs_filterable_option is FILTERABLE_ENABLED, field values are filterable by filter expression in RecommendationService.Recommend. If FILTERABLE_ENABLED but the field type is numerical, field values are not filterable by text queries in RecommendationService.Recommend. Only textual fields are supported. If recs_filterable_option is unset, the default setting is FILTERABLE_DISABLED for fields that support setting filterable options. When a field set to [FILTERABLE_DISABLED] is filtered, a warning is generated and an empty result is returned.
             "retrievableOption": "A String", # If retrievable_option is RETRIEVABLE_ENABLED, field values are included in the search results. If retrievable_option is unset, the server behavior defaults to RETRIEVABLE_DISABLED for fields that support setting retrievable options. For those fields that do not support setting retrievable options, such as `object` and `boolean`, the server will skip retrievable option setting, and setting retrievable_option for those fields will throw `INVALID_ARGUMENT` error.
             "schemaOrgPaths": [ # Field paths for indexing custom attribute from schema.org data. More details of schema.org and its defined types can be found at [schema.org](https://schema.org). It is only used on advanced site search schema. Currently only support full path from root. The full path to a field is constructed by concatenating field names, starting from `_root`, with a period `.` as the delimiter. Examples: * Publish date of the root: _root.datePublished * Publish date of the reviews: _root.review.datePublished
@@ -1852,6 +1862,8 @@ 
Method Details

             "indexableOption": "A String", # If indexable_option is INDEXABLE_ENABLED, field values are indexed so that it can be filtered or faceted in SearchService.Search. If indexable_option is unset, the server behavior defaults to INDEXABLE_DISABLED for fields that support setting indexable options. For those fields that do not support setting indexable options, such as `object` and `boolean` and key properties, the server will skip indexable_option setting, and setting indexable_option for those fields will throw `INVALID_ARGUMENT` error.
             "keyPropertyType": "A String", # Output only. Type of the key property that this field is mapped to. Empty string if this is not annotated as mapped to a key property. Example types are `title`, `description`. Full list is defined by `keyPropertyMapping` in the schema field annotation. If the schema field has a `KeyPropertyMapping` annotation, `indexable_option` and `searchable_option` of this field cannot be modified.
             "metatagName": "A String", # Optional. The metatag name found in the HTML page. If user defines this field, the value of this metatag name will be used to extract metatag. If the user does not define this field, the FieldConfig.field_path will be used to extract metatag.
+            "partialMatchableOption": "A String", # Optional. If partial_matchable_option is PARTIAL_MATCHABLE_OPTION_ENABLED, field values are partial matchable. If partial_matchable_option is unset, the server behavior defaults to PARTIAL_MATCHABLE_OPTION_DISABLED for fields that support setting partial matchable options. For those fields that do not support setting partial matchable options, the server will skip partial matchable option setting, and setting partial_matchable_option for those fields will throw `INVALID_ARGUMENT` error.
+            "prefixMatchableOption": "A String", # Optional. If prefix_matchable_option is PREFIX_MATCHABLE_OPTION_ENABLED, field values are prefix matchable. If prefix_matchable_option is unset, the server behavior defaults to PREFIX_MATCHABLE_OPTION_DISABLED for fields that support setting prefix matchable options. For those fields that do not support setting prefix matchable options, the server will skip prefix matchable option setting, and setting prefix_matchable_option for those fields will throw `INVALID_ARGUMENT` error.
             "recsFilterableOption": "A String", # If recs_filterable_option is FILTERABLE_ENABLED, field values are filterable by filter expression in RecommendationService.Recommend. If FILTERABLE_ENABLED but the field type is numerical, field values are not filterable by text queries in RecommendationService.Recommend. Only textual fields are supported. If recs_filterable_option is unset, the default setting is FILTERABLE_DISABLED for fields that support setting filterable options. When a field set to [FILTERABLE_DISABLED] is filtered, a warning is generated and an empty result is returned.
             "retrievableOption": "A String", # If retrievable_option is RETRIEVABLE_ENABLED, field values are included in the search results. If retrievable_option is unset, the server behavior defaults to RETRIEVABLE_DISABLED for fields that support setting retrievable options. For those fields that do not support setting retrievable options, such as `object` and `boolean`, the server will skip retrievable option setting, and setting retrievable_option for those fields will throw `INVALID_ARGUMENT` error.
             "schemaOrgPaths": [ # Field paths for indexing custom attribute from schema.org data. More details of schema.org and its defined types can be found at [schema.org](https://schema.org). It is only used on advanced site search schema. Currently only support full path from root. The full path to a field is constructed by concatenating field names, starting from `_root`, with a period `.` as the delimiter. Examples: * Publish date of the root: _root.datePublished * Publish date of the reviews: _root.review.datePublished
diff --git a/docs/dyn/discoveryengine_v1alpha.projects.locations.dataStores.html b/docs/dyn/discoveryengine_v1alpha.projects.locations.dataStores.html
index 700722016c..e0fae4e9d4 100644
--- a/docs/dyn/discoveryengine_v1alpha.projects.locations.dataStores.html
+++ b/docs/dyn/discoveryengine_v1alpha.projects.locations.dataStores.html
@@ -416,6 +416,9 @@ 
Method Details

       ],
     },
     "notebooklmConfig": { # Config for connecting to NotebookLM Enterprise. # NotebookLM config. If set, this DataStore is connected to NotebookLM Enterprise.
+      "notebooks": [ # Optional. Restricts this data store to the given notebooks. When empty, the data store covers every notebook the querying user can access, which is the existing behaviour. Each entry is a full notebook resource name, such as `projects/*/locations/*/notebooks/*`. Scoping is enforced on results as well as requested upstream, so a notebook outside this list cannot appear in a search response through this data store even if the backend returns one.
+        "A String",
+      ],
       "searchConfig": "A String", # Required. Search config name. Format: projects/*/locations/global/notebookLmSearchConfigs/*
     },
     "thirdPartyOauthConfig": { # Stores information for third party applicationOAuth. # Third Party OAuth config. If set, this DataStore is connected to a third party application.
@@ -470,6 +473,8 @@ 
Method Details

         "indexableOption": "A String", # If indexable_option is INDEXABLE_ENABLED, field values are indexed so that it can be filtered or faceted in SearchService.Search. If indexable_option is unset, the server behavior defaults to INDEXABLE_DISABLED for fields that support setting indexable options. For those fields that do not support setting indexable options, such as `object` and `boolean` and key properties, the server will skip indexable_option setting, and setting indexable_option for those fields will throw `INVALID_ARGUMENT` error.
         "keyPropertyType": "A String", # Output only. Type of the key property that this field is mapped to. Empty string if this is not annotated as mapped to a key property. Example types are `title`, `description`. Full list is defined by `keyPropertyMapping` in the schema field annotation. If the schema field has a `KeyPropertyMapping` annotation, `indexable_option` and `searchable_option` of this field cannot be modified.
         "metatagName": "A String", # Optional. The metatag name found in the HTML page. If user defines this field, the value of this metatag name will be used to extract metatag. If the user does not define this field, the FieldConfig.field_path will be used to extract metatag.
+        "partialMatchableOption": "A String", # Optional. If partial_matchable_option is PARTIAL_MATCHABLE_OPTION_ENABLED, field values are partial matchable. If partial_matchable_option is unset, the server behavior defaults to PARTIAL_MATCHABLE_OPTION_DISABLED for fields that support setting partial matchable options. For those fields that do not support setting partial matchable options, the server will skip partial matchable option setting, and setting partial_matchable_option for those fields will throw `INVALID_ARGUMENT` error.
+        "prefixMatchableOption": "A String", # Optional. If prefix_matchable_option is PREFIX_MATCHABLE_OPTION_ENABLED, field values are prefix matchable. If prefix_matchable_option is unset, the server behavior defaults to PREFIX_MATCHABLE_OPTION_DISABLED for fields that support setting prefix matchable options. For those fields that do not support setting prefix matchable options, the server will skip prefix matchable option setting, and setting prefix_matchable_option for those fields will throw `INVALID_ARGUMENT` error.
         "recsFilterableOption": "A String", # If recs_filterable_option is FILTERABLE_ENABLED, field values are filterable by filter expression in RecommendationService.Recommend. If FILTERABLE_ENABLED but the field type is numerical, field values are not filterable by text queries in RecommendationService.Recommend. Only textual fields are supported. If recs_filterable_option is unset, the default setting is FILTERABLE_DISABLED for fields that support setting filterable options. When a field set to [FILTERABLE_DISABLED] is filtered, a warning is generated and an empty result is returned.
         "retrievableOption": "A String", # If retrievable_option is RETRIEVABLE_ENABLED, field values are included in the search results. If retrievable_option is unset, the server behavior defaults to RETRIEVABLE_DISABLED for fields that support setting retrievable options. For those fields that do not support setting retrievable options, such as `object` and `boolean`, the server will skip retrievable option setting, and setting retrievable_option for those fields will throw `INVALID_ARGUMENT` error.
         "schemaOrgPaths": [ # Field paths for indexing custom attribute from schema.org data. More details of schema.org and its defined types can be found at [schema.org](https://schema.org). It is only used on advanced site search schema. Currently only support full path from root. The full path to a field is constructed by concatenating field names, starting from `_root`, with a period `.` as the delimiter. Examples: * Publish date of the root: _root.datePublished * Publish date of the reviews: _root.review.datePublished
@@ -747,6 +752,9 @@ 
Method Details

       ],
     },
     "notebooklmConfig": { # Config for connecting to NotebookLM Enterprise. # NotebookLM config. If set, this DataStore is connected to NotebookLM Enterprise.
+      "notebooks": [ # Optional. Restricts this data store to the given notebooks. When empty, the data store covers every notebook the querying user can access, which is the existing behaviour. Each entry is a full notebook resource name, such as `projects/*/locations/*/notebooks/*`. Scoping is enforced on results as well as requested upstream, so a notebook outside this list cannot appear in a search response through this data store even if the backend returns one.
+        "A String",
+      ],
       "searchConfig": "A String", # Required. Search config name. Format: projects/*/locations/global/notebookLmSearchConfigs/*
     },
     "thirdPartyOauthConfig": { # Stores information for third party applicationOAuth. # Third Party OAuth config. If set, this DataStore is connected to a third party application.
@@ -801,6 +809,8 @@ 
Method Details

         "indexableOption": "A String", # If indexable_option is INDEXABLE_ENABLED, field values are indexed so that it can be filtered or faceted in SearchService.Search. If indexable_option is unset, the server behavior defaults to INDEXABLE_DISABLED for fields that support setting indexable options. For those fields that do not support setting indexable options, such as `object` and `boolean` and key properties, the server will skip indexable_option setting, and setting indexable_option for those fields will throw `INVALID_ARGUMENT` error.
         "keyPropertyType": "A String", # Output only. Type of the key property that this field is mapped to. Empty string if this is not annotated as mapped to a key property. Example types are `title`, `description`. Full list is defined by `keyPropertyMapping` in the schema field annotation. If the schema field has a `KeyPropertyMapping` annotation, `indexable_option` and `searchable_option` of this field cannot be modified.
         "metatagName": "A String", # Optional. The metatag name found in the HTML page. If user defines this field, the value of this metatag name will be used to extract metatag. If the user does not define this field, the FieldConfig.field_path will be used to extract metatag.
+        "partialMatchableOption": "A String", # Optional. If partial_matchable_option is PARTIAL_MATCHABLE_OPTION_ENABLED, field values are partial matchable. If partial_matchable_option is unset, the server behavior defaults to PARTIAL_MATCHABLE_OPTION_DISABLED for fields that support setting partial matchable options. For those fields that do not support setting partial matchable options, the server will skip partial matchable option setting, and setting partial_matchable_option for those fields will throw `INVALID_ARGUMENT` error.
+        "prefixMatchableOption": "A String", # Optional. If prefix_matchable_option is PREFIX_MATCHABLE_OPTION_ENABLED, field values are prefix matchable. If prefix_matchable_option is unset, the server behavior defaults to PREFIX_MATCHABLE_OPTION_DISABLED for fields that support setting prefix matchable options. For those fields that do not support setting prefix matchable options, the server will skip prefix matchable option setting, and setting prefix_matchable_option for those fields will throw `INVALID_ARGUMENT` error.
         "recsFilterableOption": "A String", # If recs_filterable_option is FILTERABLE_ENABLED, field values are filterable by filter expression in RecommendationService.Recommend. If FILTERABLE_ENABLED but the field type is numerical, field values are not filterable by text queries in RecommendationService.Recommend. Only textual fields are supported. If recs_filterable_option is unset, the default setting is FILTERABLE_DISABLED for fields that support setting filterable options. When a field set to [FILTERABLE_DISABLED] is filtered, a warning is generated and an empty result is returned.
         "retrievableOption": "A String", # If retrievable_option is RETRIEVABLE_ENABLED, field values are included in the search results. If retrievable_option is unset, the server behavior defaults to RETRIEVABLE_DISABLED for fields that support setting retrievable options. For those fields that do not support setting retrievable options, such as `object` and `boolean`, the server will skip retrievable option setting, and setting retrievable_option for those fields will throw `INVALID_ARGUMENT` error.
         "schemaOrgPaths": [ # Field paths for indexing custom attribute from schema.org data. More details of schema.org and its defined types can be found at [schema.org](https://schema.org). It is only used on advanced site search schema. Currently only support full path from root. The full path to a field is constructed by concatenating field names, starting from `_root`, with a period `.` as the delimiter. Examples: * Publish date of the root: _root.datePublished * Publish date of the reviews: _root.review.datePublished
@@ -1138,6 +1148,9 @@ 
Method Details

           ],
         },
         "notebooklmConfig": { # Config for connecting to NotebookLM Enterprise. # NotebookLM config. If set, this DataStore is connected to NotebookLM Enterprise.
+          "notebooks": [ # Optional. Restricts this data store to the given notebooks. When empty, the data store covers every notebook the querying user can access, which is the existing behaviour. Each entry is a full notebook resource name, such as `projects/*/locations/*/notebooks/*`. Scoping is enforced on results as well as requested upstream, so a notebook outside this list cannot appear in a search response through this data store even if the backend returns one.
+            "A String",
+          ],
           "searchConfig": "A String", # Required. Search config name. Format: projects/*/locations/global/notebookLmSearchConfigs/*
         },
         "thirdPartyOauthConfig": { # Stores information for third party applicationOAuth. # Third Party OAuth config. If set, this DataStore is connected to a third party application.
@@ -1192,6 +1205,8 @@ 
Method Details

             "indexableOption": "A String", # If indexable_option is INDEXABLE_ENABLED, field values are indexed so that it can be filtered or faceted in SearchService.Search. If indexable_option is unset, the server behavior defaults to INDEXABLE_DISABLED for fields that support setting indexable options. For those fields that do not support setting indexable options, such as `object` and `boolean` and key properties, the server will skip indexable_option setting, and setting indexable_option for those fields will throw `INVALID_ARGUMENT` error.
             "keyPropertyType": "A String", # Output only. Type of the key property that this field is mapped to. Empty string if this is not annotated as mapped to a key property. Example types are `title`, `description`. Full list is defined by `keyPropertyMapping` in the schema field annotation. If the schema field has a `KeyPropertyMapping` annotation, `indexable_option` and `searchable_option` of this field cannot be modified.
             "metatagName": "A String", # Optional. The metatag name found in the HTML page. If user defines this field, the value of this metatag name will be used to extract metatag. If the user does not define this field, the FieldConfig.field_path will be used to extract metatag.
+            "partialMatchableOption": "A String", # Optional. If partial_matchable_option is PARTIAL_MATCHABLE_OPTION_ENABLED, field values are partial matchable. If partial_matchable_option is unset, the server behavior defaults to PARTIAL_MATCHABLE_OPTION_DISABLED for fields that support setting partial matchable options. For those fields that do not support setting partial matchable options, the server will skip partial matchable option setting, and setting partial_matchable_option for those fields will throw `INVALID_ARGUMENT` error.
+            "prefixMatchableOption": "A String", # Optional. If prefix_matchable_option is PREFIX_MATCHABLE_OPTION_ENABLED, field values are prefix matchable. If prefix_matchable_option is unset, the server behavior defaults to PREFIX_MATCHABLE_OPTION_DISABLED for fields that support setting prefix matchable options. For those fields that do not support setting prefix matchable options, the server will skip prefix matchable option setting, and setting prefix_matchable_option for those fields will throw `INVALID_ARGUMENT` error.
             "recsFilterableOption": "A String", # If recs_filterable_option is FILTERABLE_ENABLED, field values are filterable by filter expression in RecommendationService.Recommend. If FILTERABLE_ENABLED but the field type is numerical, field values are not filterable by text queries in RecommendationService.Recommend. Only textual fields are supported. If recs_filterable_option is unset, the default setting is FILTERABLE_DISABLED for fields that support setting filterable options. When a field set to [FILTERABLE_DISABLED] is filtered, a warning is generated and an empty result is returned.
             "retrievableOption": "A String", # If retrievable_option is RETRIEVABLE_ENABLED, field values are included in the search results. If retrievable_option is unset, the server behavior defaults to RETRIEVABLE_DISABLED for fields that support setting retrievable options. For those fields that do not support setting retrievable options, such as `object` and `boolean`, the server will skip retrievable option setting, and setting retrievable_option for those fields will throw `INVALID_ARGUMENT` error.
             "schemaOrgPaths": [ # Field paths for indexing custom attribute from schema.org data. More details of schema.org and its defined types can be found at [schema.org](https://schema.org). It is only used on advanced site search schema. Currently only support full path from root. The full path to a field is constructed by concatenating field names, starting from `_root`, with a period `.` as the delimiter. Examples: * Publish date of the root: _root.datePublished * Publish date of the reviews: _root.review.datePublished
@@ -1366,6 +1381,9 @@ 
Method Details

       ],
     },
     "notebooklmConfig": { # Config for connecting to NotebookLM Enterprise. # NotebookLM config. If set, this DataStore is connected to NotebookLM Enterprise.
+      "notebooks": [ # Optional. Restricts this data store to the given notebooks. When empty, the data store covers every notebook the querying user can access, which is the existing behaviour. Each entry is a full notebook resource name, such as `projects/*/locations/*/notebooks/*`. Scoping is enforced on results as well as requested upstream, so a notebook outside this list cannot appear in a search response through this data store even if the backend returns one.
+        "A String",
+      ],
       "searchConfig": "A String", # Required. Search config name. Format: projects/*/locations/global/notebookLmSearchConfigs/*
     },
     "thirdPartyOauthConfig": { # Stores information for third party applicationOAuth. # Third Party OAuth config. If set, this DataStore is connected to a third party application.
@@ -1420,6 +1438,8 @@ 
Method Details

         "indexableOption": "A String", # If indexable_option is INDEXABLE_ENABLED, field values are indexed so that it can be filtered or faceted in SearchService.Search. If indexable_option is unset, the server behavior defaults to INDEXABLE_DISABLED for fields that support setting indexable options. For those fields that do not support setting indexable options, such as `object` and `boolean` and key properties, the server will skip indexable_option setting, and setting indexable_option for those fields will throw `INVALID_ARGUMENT` error.
         "keyPropertyType": "A String", # Output only. Type of the key property that this field is mapped to. Empty string if this is not annotated as mapped to a key property. Example types are `title`, `description`. Full list is defined by `keyPropertyMapping` in the schema field annotation. If the schema field has a `KeyPropertyMapping` annotation, `indexable_option` and `searchable_option` of this field cannot be modified.
         "metatagName": "A String", # Optional. The metatag name found in the HTML page. If user defines this field, the value of this metatag name will be used to extract metatag. If the user does not define this field, the FieldConfig.field_path will be used to extract metatag.
+        "partialMatchableOption": "A String", # Optional. If partial_matchable_option is PARTIAL_MATCHABLE_OPTION_ENABLED, field values are partial matchable. If partial_matchable_option is unset, the server behavior defaults to PARTIAL_MATCHABLE_OPTION_DISABLED for fields that support setting partial matchable options. For those fields that do not support setting partial matchable options, the server will skip partial matchable option setting, and setting partial_matchable_option for those fields will throw `INVALID_ARGUMENT` error.
+        "prefixMatchableOption": "A String", # Optional. If prefix_matchable_option is PREFIX_MATCHABLE_OPTION_ENABLED, field values are prefix matchable. If prefix_matchable_option is unset, the server behavior defaults to PREFIX_MATCHABLE_OPTION_DISABLED for fields that support setting prefix matchable options. For those fields that do not support setting prefix matchable options, the server will skip prefix matchable option setting, and setting prefix_matchable_option for those fields will throw `INVALID_ARGUMENT` error.
         "recsFilterableOption": "A String", # If recs_filterable_option is FILTERABLE_ENABLED, field values are filterable by filter expression in RecommendationService.Recommend. If FILTERABLE_ENABLED but the field type is numerical, field values are not filterable by text queries in RecommendationService.Recommend. Only textual fields are supported. If recs_filterable_option is unset, the default setting is FILTERABLE_DISABLED for fields that support setting filterable options. When a field set to [FILTERABLE_DISABLED] is filtered, a warning is generated and an empty result is returned.
         "retrievableOption": "A String", # If retrievable_option is RETRIEVABLE_ENABLED, field values are included in the search results. If retrievable_option is unset, the server behavior defaults to RETRIEVABLE_DISABLED for fields that support setting retrievable options. For those fields that do not support setting retrievable options, such as `object` and `boolean`, the server will skip retrievable option setting, and setting retrievable_option for those fields will throw `INVALID_ARGUMENT` error.
         "schemaOrgPaths": [ # Field paths for indexing custom attribute from schema.org data. More details of schema.org and its defined types can be found at [schema.org](https://schema.org). It is only used on advanced site search schema. Currently only support full path from root. The full path to a field is constructed by concatenating field names, starting from `_root`, with a period `.` as the delimiter. Examples: * Publish date of the root: _root.datePublished * Publish date of the reviews: _root.review.datePublished
@@ -1576,6 +1596,9 @@ 
Method Details

       ],
     },
     "notebooklmConfig": { # Config for connecting to NotebookLM Enterprise. # NotebookLM config. If set, this DataStore is connected to NotebookLM Enterprise.
+      "notebooks": [ # Optional. Restricts this data store to the given notebooks. When empty, the data store covers every notebook the querying user can access, which is the existing behaviour. Each entry is a full notebook resource name, such as `projects/*/locations/*/notebooks/*`. Scoping is enforced on results as well as requested upstream, so a notebook outside this list cannot appear in a search response through this data store even if the backend returns one.
+        "A String",
+      ],
       "searchConfig": "A String", # Required. Search config name. Format: projects/*/locations/global/notebookLmSearchConfigs/*
     },
     "thirdPartyOauthConfig": { # Stores information for third party applicationOAuth. # Third Party OAuth config. If set, this DataStore is connected to a third party application.
@@ -1630,6 +1653,8 @@ 
Method Details

         "indexableOption": "A String", # If indexable_option is INDEXABLE_ENABLED, field values are indexed so that it can be filtered or faceted in SearchService.Search. If indexable_option is unset, the server behavior defaults to INDEXABLE_DISABLED for fields that support setting indexable options. For those fields that do not support setting indexable options, such as `object` and `boolean` and key properties, the server will skip indexable_option setting, and setting indexable_option for those fields will throw `INVALID_ARGUMENT` error.
         "keyPropertyType": "A String", # Output only. Type of the key property that this field is mapped to. Empty string if this is not annotated as mapped to a key property. Example types are `title`, `description`. Full list is defined by `keyPropertyMapping` in the schema field annotation. If the schema field has a `KeyPropertyMapping` annotation, `indexable_option` and `searchable_option` of this field cannot be modified.
         "metatagName": "A String", # Optional. The metatag name found in the HTML page. If user defines this field, the value of this metatag name will be used to extract metatag. If the user does not define this field, the FieldConfig.field_path will be used to extract metatag.
+        "partialMatchableOption": "A String", # Optional. If partial_matchable_option is PARTIAL_MATCHABLE_OPTION_ENABLED, field values are partial matchable. If partial_matchable_option is unset, the server behavior defaults to PARTIAL_MATCHABLE_OPTION_DISABLED for fields that support setting partial matchable options. For those fields that do not support setting partial matchable options, the server will skip partial matchable option setting, and setting partial_matchable_option for those fields will throw `INVALID_ARGUMENT` error.
+        "prefixMatchableOption": "A String", # Optional. If prefix_matchable_option is PREFIX_MATCHABLE_OPTION_ENABLED, field values are prefix matchable. If prefix_matchable_option is unset, the server behavior defaults to PREFIX_MATCHABLE_OPTION_DISABLED for fields that support setting prefix matchable options. For those fields that do not support setting prefix matchable options, the server will skip prefix matchable option setting, and setting prefix_matchable_option for those fields will throw `INVALID_ARGUMENT` error.
         "recsFilterableOption": "A String", # If recs_filterable_option is FILTERABLE_ENABLED, field values are filterable by filter expression in RecommendationService.Recommend. If FILTERABLE_ENABLED but the field type is numerical, field values are not filterable by text queries in RecommendationService.Recommend. Only textual fields are supported. If recs_filterable_option is unset, the default setting is FILTERABLE_DISABLED for fields that support setting filterable options. When a field set to [FILTERABLE_DISABLED] is filtered, a warning is generated and an empty result is returned.
         "retrievableOption": "A String", # If retrievable_option is RETRIEVABLE_ENABLED, field values are included in the search results. If retrievable_option is unset, the server behavior defaults to RETRIEVABLE_DISABLED for fields that support setting retrievable options. For those fields that do not support setting retrievable options, such as `object` and `boolean`, the server will skip retrievable option setting, and setting retrievable_option for those fields will throw `INVALID_ARGUMENT` error.
         "schemaOrgPaths": [ # Field paths for indexing custom attribute from schema.org data. More details of schema.org and its defined types can be found at [schema.org](https://schema.org). It is only used on advanced site search schema. Currently only support full path from root. The full path to a field is constructed by concatenating field names, starting from `_root`, with a period `.` as the delimiter. Examples: * Publish date of the root: _root.datePublished * Publish date of the reviews: _root.review.datePublished
diff --git a/docs/dyn/discoveryengine_v1alpha.projects.locations.dataStores.schemas.html b/docs/dyn/discoveryengine_v1alpha.projects.locations.dataStores.schemas.html
index 6cfc352bae..f73b84e7f5 100644
--- a/docs/dyn/discoveryengine_v1alpha.projects.locations.dataStores.schemas.html
+++ b/docs/dyn/discoveryengine_v1alpha.projects.locations.dataStores.schemas.html
@@ -123,6 +123,8 @@ 
Method Details

       "indexableOption": "A String", # If indexable_option is INDEXABLE_ENABLED, field values are indexed so that it can be filtered or faceted in SearchService.Search. If indexable_option is unset, the server behavior defaults to INDEXABLE_DISABLED for fields that support setting indexable options. For those fields that do not support setting indexable options, such as `object` and `boolean` and key properties, the server will skip indexable_option setting, and setting indexable_option for those fields will throw `INVALID_ARGUMENT` error.
       "keyPropertyType": "A String", # Output only. Type of the key property that this field is mapped to. Empty string if this is not annotated as mapped to a key property. Example types are `title`, `description`. Full list is defined by `keyPropertyMapping` in the schema field annotation. If the schema field has a `KeyPropertyMapping` annotation, `indexable_option` and `searchable_option` of this field cannot be modified.
       "metatagName": "A String", # Optional. The metatag name found in the HTML page. If user defines this field, the value of this metatag name will be used to extract metatag. If the user does not define this field, the FieldConfig.field_path will be used to extract metatag.
+      "partialMatchableOption": "A String", # Optional. If partial_matchable_option is PARTIAL_MATCHABLE_OPTION_ENABLED, field values are partial matchable. If partial_matchable_option is unset, the server behavior defaults to PARTIAL_MATCHABLE_OPTION_DISABLED for fields that support setting partial matchable options. For those fields that do not support setting partial matchable options, the server will skip partial matchable option setting, and setting partial_matchable_option for those fields will throw `INVALID_ARGUMENT` error.
+      "prefixMatchableOption": "A String", # Optional. If prefix_matchable_option is PREFIX_MATCHABLE_OPTION_ENABLED, field values are prefix matchable. If prefix_matchable_option is unset, the server behavior defaults to PREFIX_MATCHABLE_OPTION_DISABLED for fields that support setting prefix matchable options. For those fields that do not support setting prefix matchable options, the server will skip prefix matchable option setting, and setting prefix_matchable_option for those fields will throw `INVALID_ARGUMENT` error.
       "recsFilterableOption": "A String", # If recs_filterable_option is FILTERABLE_ENABLED, field values are filterable by filter expression in RecommendationService.Recommend. If FILTERABLE_ENABLED but the field type is numerical, field values are not filterable by text queries in RecommendationService.Recommend. Only textual fields are supported. If recs_filterable_option is unset, the default setting is FILTERABLE_DISABLED for fields that support setting filterable options. When a field set to [FILTERABLE_DISABLED] is filtered, a warning is generated and an empty result is returned.
       "retrievableOption": "A String", # If retrievable_option is RETRIEVABLE_ENABLED, field values are included in the search results. If retrievable_option is unset, the server behavior defaults to RETRIEVABLE_DISABLED for fields that support setting retrievable options. For those fields that do not support setting retrievable options, such as `object` and `boolean`, the server will skip retrievable option setting, and setting retrievable_option for those fields will throw `INVALID_ARGUMENT` error.
       "schemaOrgPaths": [ # Field paths for indexing custom attribute from schema.org data. More details of schema.org and its defined types can be found at [schema.org](https://schema.org). It is only used on advanced site search schema. Currently only support full path from root. The full path to a field is constructed by concatenating field names, starting from `_root`, with a period `.` as the delimiter. Examples: * Publish date of the root: _root.datePublished * Publish date of the reviews: _root.review.datePublished
@@ -231,6 +233,8 @@ 
Method Details

       "indexableOption": "A String", # If indexable_option is INDEXABLE_ENABLED, field values are indexed so that it can be filtered or faceted in SearchService.Search. If indexable_option is unset, the server behavior defaults to INDEXABLE_DISABLED for fields that support setting indexable options. For those fields that do not support setting indexable options, such as `object` and `boolean` and key properties, the server will skip indexable_option setting, and setting indexable_option for those fields will throw `INVALID_ARGUMENT` error.
       "keyPropertyType": "A String", # Output only. Type of the key property that this field is mapped to. Empty string if this is not annotated as mapped to a key property. Example types are `title`, `description`. Full list is defined by `keyPropertyMapping` in the schema field annotation. If the schema field has a `KeyPropertyMapping` annotation, `indexable_option` and `searchable_option` of this field cannot be modified.
       "metatagName": "A String", # Optional. The metatag name found in the HTML page. If user defines this field, the value of this metatag name will be used to extract metatag. If the user does not define this field, the FieldConfig.field_path will be used to extract metatag.
+      "partialMatchableOption": "A String", # Optional. If partial_matchable_option is PARTIAL_MATCHABLE_OPTION_ENABLED, field values are partial matchable. If partial_matchable_option is unset, the server behavior defaults to PARTIAL_MATCHABLE_OPTION_DISABLED for fields that support setting partial matchable options. For those fields that do not support setting partial matchable options, the server will skip partial matchable option setting, and setting partial_matchable_option for those fields will throw `INVALID_ARGUMENT` error.
+      "prefixMatchableOption": "A String", # Optional. If prefix_matchable_option is PREFIX_MATCHABLE_OPTION_ENABLED, field values are prefix matchable. If prefix_matchable_option is unset, the server behavior defaults to PREFIX_MATCHABLE_OPTION_DISABLED for fields that support setting prefix matchable options. For those fields that do not support setting prefix matchable options, the server will skip prefix matchable option setting, and setting prefix_matchable_option for those fields will throw `INVALID_ARGUMENT` error.
       "recsFilterableOption": "A String", # If recs_filterable_option is FILTERABLE_ENABLED, field values are filterable by filter expression in RecommendationService.Recommend. If FILTERABLE_ENABLED but the field type is numerical, field values are not filterable by text queries in RecommendationService.Recommend. Only textual fields are supported. If recs_filterable_option is unset, the default setting is FILTERABLE_DISABLED for fields that support setting filterable options. When a field set to [FILTERABLE_DISABLED] is filtered, a warning is generated and an empty result is returned.
       "retrievableOption": "A String", # If retrievable_option is RETRIEVABLE_ENABLED, field values are included in the search results. If retrievable_option is unset, the server behavior defaults to RETRIEVABLE_DISABLED for fields that support setting retrievable options. For those fields that do not support setting retrievable options, such as `object` and `boolean`, the server will skip retrievable option setting, and setting retrievable_option for those fields will throw `INVALID_ARGUMENT` error.
       "schemaOrgPaths": [ # Field paths for indexing custom attribute from schema.org data. More details of schema.org and its defined types can be found at [schema.org](https://schema.org). It is only used on advanced site search schema. Currently only support full path from root. The full path to a field is constructed by concatenating field names, starting from `_root`, with a period `.` as the delimiter. Examples: * Publish date of the root: _root.datePublished * Publish date of the reviews: _root.review.datePublished
@@ -280,6 +284,8 @@ 
Method Details

           "indexableOption": "A String", # If indexable_option is INDEXABLE_ENABLED, field values are indexed so that it can be filtered or faceted in SearchService.Search. If indexable_option is unset, the server behavior defaults to INDEXABLE_DISABLED for fields that support setting indexable options. For those fields that do not support setting indexable options, such as `object` and `boolean` and key properties, the server will skip indexable_option setting, and setting indexable_option for those fields will throw `INVALID_ARGUMENT` error.
           "keyPropertyType": "A String", # Output only. Type of the key property that this field is mapped to. Empty string if this is not annotated as mapped to a key property. Example types are `title`, `description`. Full list is defined by `keyPropertyMapping` in the schema field annotation. If the schema field has a `KeyPropertyMapping` annotation, `indexable_option` and `searchable_option` of this field cannot be modified.
           "metatagName": "A String", # Optional. The metatag name found in the HTML page. If user defines this field, the value of this metatag name will be used to extract metatag. If the user does not define this field, the FieldConfig.field_path will be used to extract metatag.
+          "partialMatchableOption": "A String", # Optional. If partial_matchable_option is PARTIAL_MATCHABLE_OPTION_ENABLED, field values are partial matchable. If partial_matchable_option is unset, the server behavior defaults to PARTIAL_MATCHABLE_OPTION_DISABLED for fields that support setting partial matchable options. For those fields that do not support setting partial matchable options, the server will skip partial matchable option setting, and setting partial_matchable_option for those fields will throw `INVALID_ARGUMENT` error.
+          "prefixMatchableOption": "A String", # Optional. If prefix_matchable_option is PREFIX_MATCHABLE_OPTION_ENABLED, field values are prefix matchable. If prefix_matchable_option is unset, the server behavior defaults to PREFIX_MATCHABLE_OPTION_DISABLED for fields that support setting prefix matchable options. For those fields that do not support setting prefix matchable options, the server will skip prefix matchable option setting, and setting prefix_matchable_option for those fields will throw `INVALID_ARGUMENT` error.
           "recsFilterableOption": "A String", # If recs_filterable_option is FILTERABLE_ENABLED, field values are filterable by filter expression in RecommendationService.Recommend. If FILTERABLE_ENABLED but the field type is numerical, field values are not filterable by text queries in RecommendationService.Recommend. Only textual fields are supported. If recs_filterable_option is unset, the default setting is FILTERABLE_DISABLED for fields that support setting filterable options. When a field set to [FILTERABLE_DISABLED] is filtered, a warning is generated and an empty result is returned.
           "retrievableOption": "A String", # If retrievable_option is RETRIEVABLE_ENABLED, field values are included in the search results. If retrievable_option is unset, the server behavior defaults to RETRIEVABLE_DISABLED for fields that support setting retrievable options. For those fields that do not support setting retrievable options, such as `object` and `boolean`, the server will skip retrievable option setting, and setting retrievable_option for those fields will throw `INVALID_ARGUMENT` error.
           "schemaOrgPaths": [ # Field paths for indexing custom attribute from schema.org data. More details of schema.org and its defined types can be found at [schema.org](https://schema.org). It is only used on advanced site search schema. Currently only support full path from root. The full path to a field is constructed by concatenating field names, starting from `_root`, with a period `.` as the delimiter. Examples: * Publish date of the root: _root.datePublished * Publish date of the reviews: _root.review.datePublished
@@ -335,6 +341,8 @@ 
Method Details

       "indexableOption": "A String", # If indexable_option is INDEXABLE_ENABLED, field values are indexed so that it can be filtered or faceted in SearchService.Search. If indexable_option is unset, the server behavior defaults to INDEXABLE_DISABLED for fields that support setting indexable options. For those fields that do not support setting indexable options, such as `object` and `boolean` and key properties, the server will skip indexable_option setting, and setting indexable_option for those fields will throw `INVALID_ARGUMENT` error.
       "keyPropertyType": "A String", # Output only. Type of the key property that this field is mapped to. Empty string if this is not annotated as mapped to a key property. Example types are `title`, `description`. Full list is defined by `keyPropertyMapping` in the schema field annotation. If the schema field has a `KeyPropertyMapping` annotation, `indexable_option` and `searchable_option` of this field cannot be modified.
       "metatagName": "A String", # Optional. The metatag name found in the HTML page. If user defines this field, the value of this metatag name will be used to extract metatag. If the user does not define this field, the FieldConfig.field_path will be used to extract metatag.
+      "partialMatchableOption": "A String", # Optional. If partial_matchable_option is PARTIAL_MATCHABLE_OPTION_ENABLED, field values are partial matchable. If partial_matchable_option is unset, the server behavior defaults to PARTIAL_MATCHABLE_OPTION_DISABLED for fields that support setting partial matchable options. For those fields that do not support setting partial matchable options, the server will skip partial matchable option setting, and setting partial_matchable_option for those fields will throw `INVALID_ARGUMENT` error.
+      "prefixMatchableOption": "A String", # Optional. If prefix_matchable_option is PREFIX_MATCHABLE_OPTION_ENABLED, field values are prefix matchable. If prefix_matchable_option is unset, the server behavior defaults to PREFIX_MATCHABLE_OPTION_DISABLED for fields that support setting prefix matchable options. For those fields that do not support setting prefix matchable options, the server will skip prefix matchable option setting, and setting prefix_matchable_option for those fields will throw `INVALID_ARGUMENT` error.
       "recsFilterableOption": "A String", # If recs_filterable_option is FILTERABLE_ENABLED, field values are filterable by filter expression in RecommendationService.Recommend. If FILTERABLE_ENABLED but the field type is numerical, field values are not filterable by text queries in RecommendationService.Recommend. Only textual fields are supported. If recs_filterable_option is unset, the default setting is FILTERABLE_DISABLED for fields that support setting filterable options. When a field set to [FILTERABLE_DISABLED] is filtered, a warning is generated and an empty result is returned.
       "retrievableOption": "A String", # If retrievable_option is RETRIEVABLE_ENABLED, field values are included in the search results. If retrievable_option is unset, the server behavior defaults to RETRIEVABLE_DISABLED for fields that support setting retrievable options. For those fields that do not support setting retrievable options, such as `object` and `boolean`, the server will skip retrievable option setting, and setting retrievable_option for those fields will throw `INVALID_ARGUMENT` error.
       "schemaOrgPaths": [ # Field paths for indexing custom attribute from schema.org data. More details of schema.org and its defined types can be found at [schema.org](https://schema.org). It is only used on advanced site search schema. Currently only support full path from root. The full path to a field is constructed by concatenating field names, starting from `_root`, with a period `.` as the delimiter. Examples: * Publish date of the root: _root.datePublished * Publish date of the reviews: _root.review.datePublished
diff --git a/docs/dyn/discoveryengine_v1alpha.projects.locations.dataStores.servingConfigs.html b/docs/dyn/discoveryengine_v1alpha.projects.locations.dataStores.servingConfigs.html
index c6745db009..a63a8a7df3 100644
--- a/docs/dyn/discoveryengine_v1alpha.projects.locations.dataStores.servingConfigs.html
+++ b/docs/dyn/discoveryengine_v1alpha.projects.locations.dataStores.servingConfigs.html
@@ -1714,7 +1714,9 @@ 
Method Details

         },
         "questionIndex": 42, # The index of the user input within the conversation messages.
         "session": "A String", # Name of the newly generated or continued session.
-        "taskName": "A String", # Optional. The full resource name of the Sobi task if the conversation was handled by a long-running agent task. Format: projects/{project}/locations/{location}/tasks/{task_id}
+        "stepSeqNum": "A String", # Optional. The `TaskServerEvent.seq_num` of the step that opened the rated agent task reply.
+        "taskName": "A String", # Optional. The full resource name of the Sobi task if the conversation was handled by a long-running agent task. Format (canonical, or the short alias the Task API also accepts): projects/{project}/locations/{location}/agents/{agent}/tasks/{task} projects/{project}/locations/{location}/tasks/{task}
+        "trajectoryId": "A String", # Optional. The runtime trajectory id of the rated agent task turn, as set on `TaskServerEvent.trajectory_id`. Shared by all steps of the turn.
       },
       "dataTermsAccepted": True or False, # Optional. Whether the customer accepted data use terms.
       "feedbackSource": "A String", # Optional. The UI component the user feedback comes from, which could be GOOGLE_CONSOLE, GOOGLE_WIDGET, GOOGLE_WEBAPP.
@@ -1972,7 +1974,7 @@ 
Method Details

       "A String",
     ],
   },
-  "dataStoreSpecs": [ # Specifications that define the specific DataStores to be searched, along with configurations for those data stores. This is only considered for Engines with multiple data stores. For engines with a single data store, the specs directly under SearchRequest should be used.
+  "dataStoreSpecs": [ # Specifications that define the specific DataStores to be searched, along with configurations for those data stores. This is only considered for Engines with multiple data stores. For engines with a single data store, the specs directly under SearchRequest should be used. On an engine with multiple data stores, this field is optional. If it's empty, all of the engine's data stores are searched (blended search). Unless it specifies exactly one data store, some request fields, such as `order_by` and `query_expansion_spec`, aren't supported and return an `INVALID_ARGUMENT` error.
     { # A struct to define data stores to filter on in a search call and configurations for those data stores. Otherwise, an `INVALID_ARGUMENT` error is returned.
       "boostSpec": { # Boost specification to boost certain documents. # Optional. Boost specification to boost certain documents. For more information on boosting, see [Boosting](https://cloud.google.com/generative-ai-app-builder/docs/boost-search-results)
         "conditionBoostSpecs": [ # Condition boost specifications. If a document matches multiple conditions in the specifications, boost scores from these specifications are all applied and combined in a non-linear way. Maximum number of specifications is 20.
@@ -2658,7 +2660,7 @@ 
Method Details

       "A String",
     ],
   },
-  "dataStoreSpecs": [ # Specifications that define the specific DataStores to be searched, along with configurations for those data stores. This is only considered for Engines with multiple data stores. For engines with a single data store, the specs directly under SearchRequest should be used.
+  "dataStoreSpecs": [ # Specifications that define the specific DataStores to be searched, along with configurations for those data stores. This is only considered for Engines with multiple data stores. For engines with a single data store, the specs directly under SearchRequest should be used. On an engine with multiple data stores, this field is optional. If it's empty, all of the engine's data stores are searched (blended search). Unless it specifies exactly one data store, some request fields, such as `order_by` and `query_expansion_spec`, aren't supported and return an `INVALID_ARGUMENT` error.
     { # A struct to define data stores to filter on in a search call and configurations for those data stores. Otherwise, an `INVALID_ARGUMENT` error is returned.
       "boostSpec": { # Boost specification to boost certain documents. # Optional. Boost specification to boost certain documents. For more information on boosting, see [Boosting](https://cloud.google.com/generative-ai-app-builder/docs/boost-search-results)
         "conditionBoostSpecs": [ # Condition boost specifications. If a document matches multiple conditions in the specifications, boost scores from these specifications are all applied and combined in a non-linear way. Maximum number of specifications is 20.
diff --git a/docs/dyn/discoveryengine_v1alpha.projects.locations.dataStores.userEvents.html b/docs/dyn/discoveryengine_v1alpha.projects.locations.dataStores.userEvents.html
index c4ce56645d..3b43f8a839 100644
--- a/docs/dyn/discoveryengine_v1alpha.projects.locations.dataStores.userEvents.html
+++ b/docs/dyn/discoveryengine_v1alpha.projects.locations.dataStores.userEvents.html
@@ -241,7 +241,9 @@ 
Method Details

             },
             "questionIndex": 42, # The index of the user input within the conversation messages.
             "session": "A String", # Name of the newly generated or continued session.
-            "taskName": "A String", # Optional. The full resource name of the Sobi task if the conversation was handled by a long-running agent task. Format: projects/{project}/locations/{location}/tasks/{task_id}
+            "stepSeqNum": "A String", # Optional. The `TaskServerEvent.seq_num` of the step that opened the rated agent task reply.
+            "taskName": "A String", # Optional. The full resource name of the Sobi task if the conversation was handled by a long-running agent task. Format (canonical, or the short alias the Task API also accepts): projects/{project}/locations/{location}/agents/{agent}/tasks/{task} projects/{project}/locations/{location}/tasks/{task}
+            "trajectoryId": "A String", # Optional. The runtime trajectory id of the rated agent task turn, as set on `TaskServerEvent.trajectory_id`. Shared by all steps of the turn.
           },
           "dataTermsAccepted": True or False, # Optional. Whether the customer accepted data use terms.
           "feedbackSource": "A String", # Optional. The UI component the user feedback comes from, which could be GOOGLE_CONSOLE, GOOGLE_WIDGET, GOOGLE_WEBAPP.
@@ -506,7 +508,9 @@ 
Method Details

       },
       "questionIndex": 42, # The index of the user input within the conversation messages.
       "session": "A String", # Name of the newly generated or continued session.
-      "taskName": "A String", # Optional. The full resource name of the Sobi task if the conversation was handled by a long-running agent task. Format: projects/{project}/locations/{location}/tasks/{task_id}
+      "stepSeqNum": "A String", # Optional. The `TaskServerEvent.seq_num` of the step that opened the rated agent task reply.
+      "taskName": "A String", # Optional. The full resource name of the Sobi task if the conversation was handled by a long-running agent task. Format (canonical, or the short alias the Task API also accepts): projects/{project}/locations/{location}/agents/{agent}/tasks/{task} projects/{project}/locations/{location}/tasks/{task}
+      "trajectoryId": "A String", # Optional. The runtime trajectory id of the rated agent task turn, as set on `TaskServerEvent.trajectory_id`. Shared by all steps of the turn.
     },
     "dataTermsAccepted": True or False, # Optional. Whether the customer accepted data use terms.
     "feedbackSource": "A String", # Optional. The UI component the user feedback comes from, which could be GOOGLE_CONSOLE, GOOGLE_WIDGET, GOOGLE_WEBAPP.
@@ -696,7 +700,9 @@ 
Method Details

       },
       "questionIndex": 42, # The index of the user input within the conversation messages.
       "session": "A String", # Name of the newly generated or continued session.
-      "taskName": "A String", # Optional. The full resource name of the Sobi task if the conversation was handled by a long-running agent task. Format: projects/{project}/locations/{location}/tasks/{task_id}
+      "stepSeqNum": "A String", # Optional. The `TaskServerEvent.seq_num` of the step that opened the rated agent task reply.
+      "taskName": "A String", # Optional. The full resource name of the Sobi task if the conversation was handled by a long-running agent task. Format (canonical, or the short alias the Task API also accepts): projects/{project}/locations/{location}/agents/{agent}/tasks/{task} projects/{project}/locations/{location}/tasks/{task}
+      "trajectoryId": "A String", # Optional. The runtime trajectory id of the rated agent task turn, as set on `TaskServerEvent.trajectory_id`. Shared by all steps of the turn.
     },
     "dataTermsAccepted": True or False, # Optional. Whether the customer accepted data use terms.
     "feedbackSource": "A String", # Optional. The UI component the user feedback comes from, which could be GOOGLE_CONSOLE, GOOGLE_WIDGET, GOOGLE_WEBAPP.
diff --git a/docs/dyn/discoveryengine_v1alpha.projects.locations.dataStores.widgetConfigs.html b/docs/dyn/discoveryengine_v1alpha.projects.locations.dataStores.widgetConfigs.html
index f10fb4fe36..d8dddc88c6 100644
--- a/docs/dyn/discoveryengine_v1alpha.projects.locations.dataStores.widgetConfigs.html
+++ b/docs/dyn/discoveryengine_v1alpha.projects.locations.dataStores.widgetConfigs.html
@@ -341,7 +341,7 @@ 
Method Details

     "enableSafeSearch": True or False, # Whether to enable safe search.
     "enableSearchAsYouType": True or False, # Whether to enable search-as-you-type behavior for the search widget.
     "enableVisualContentSummary": True or False, # If set to true, the widget will enable visual content summary on applicable search requests. Only used by healthcare search.
-    "features": { # Output only. Feature config for the engine to opt in or opt out of features. Supported keys: * `agent-gallery` * `no-code-agent-builder` * `prompt-gallery` * `model-selector` * `notebook-lm` * `people-search` * `people-search-org-chart` * `bi-directional-audio` * `speech-to-text` * `feedback` * `session-sharing` * `personalization-memory` * `personalization-suggested-highlights` * `mobile-app-access` * `disable-agent-sharing` * `disable-image-generation` * `disable-video-generation` * `disable-onedrive-upload` * `disable-talk-to-content` * `disable-google-drive-upload` * `disable-welcome-emails` * `disable-canvas` * `canvas-workspace` * `canvas-app-builder` * `skills` * `skill-sharing` * `skill-sharing-without-admin-approval` * `disable-projects` * `sobi` * `enable-end-user-sharing-with-groups` * `single-agent-orchestration` * `multi-agent-orchestration` * `cross-product-intelligence` * `workflow-agents` * `in-app-notifications`
+    "features": { # Output only. Feature config for the engine to opt in or opt out of features. Supported keys: * `agent-gallery` * `no-code-agent-builder` * `prompt-gallery` * `model-selector` * `notebook-lm` * `people-search` * `people-search-org-chart` * `bi-directional-audio` * `speech-to-text` * `feedback` * `session-sharing` * `personalization-memory` * `personalization-suggested-highlights` * `mobile-app-access` * `disable-agent-sharing` * `disable-image-generation` * `disable-video-generation` * `disable-onedrive-upload` * `disable-talk-to-content` * `disable-google-drive-upload` * `disable-welcome-emails` * `disable-canvas` * `canvas-workspace` * `canvas-app-builder` * `skills` * `skill-sharing` * `skill-sharing-without-admin-approval` * `disable-projects` * `sobi` * `enable-end-user-sharing-with-groups` * `single-agent-orchestration` * `multi-agent-orchestration` * `cross-product-intelligence` * `workflow-agents` * `in-app-notifications` * `code-extraction`
       "a_key": "A String",
     },
     "generativeAnswerConfig": { # Describes configuration for generative answer. # Describes generative answer configuration.
@@ -636,7 +636,7 @@ 
Method Details

     "enableSafeSearch": True or False, # Whether to enable safe search.
     "enableSearchAsYouType": True or False, # Whether to enable search-as-you-type behavior for the search widget.
     "enableVisualContentSummary": True or False, # If set to true, the widget will enable visual content summary on applicable search requests. Only used by healthcare search.
-    "features": { # Output only. Feature config for the engine to opt in or opt out of features. Supported keys: * `agent-gallery` * `no-code-agent-builder` * `prompt-gallery` * `model-selector` * `notebook-lm` * `people-search` * `people-search-org-chart` * `bi-directional-audio` * `speech-to-text` * `feedback` * `session-sharing` * `personalization-memory` * `personalization-suggested-highlights` * `mobile-app-access` * `disable-agent-sharing` * `disable-image-generation` * `disable-video-generation` * `disable-onedrive-upload` * `disable-talk-to-content` * `disable-google-drive-upload` * `disable-welcome-emails` * `disable-canvas` * `canvas-workspace` * `canvas-app-builder` * `skills` * `skill-sharing` * `skill-sharing-without-admin-approval` * `disable-projects` * `sobi` * `enable-end-user-sharing-with-groups` * `single-agent-orchestration` * `multi-agent-orchestration` * `cross-product-intelligence` * `workflow-agents` * `in-app-notifications`
+    "features": { # Output only. Feature config for the engine to opt in or opt out of features. Supported keys: * `agent-gallery` * `no-code-agent-builder` * `prompt-gallery` * `model-selector` * `notebook-lm` * `people-search` * `people-search-org-chart` * `bi-directional-audio` * `speech-to-text` * `feedback` * `session-sharing` * `personalization-memory` * `personalization-suggested-highlights` * `mobile-app-access` * `disable-agent-sharing` * `disable-image-generation` * `disable-video-generation` * `disable-onedrive-upload` * `disable-talk-to-content` * `disable-google-drive-upload` * `disable-welcome-emails` * `disable-canvas` * `canvas-workspace` * `canvas-app-builder` * `skills` * `skill-sharing` * `skill-sharing-without-admin-approval` * `disable-projects` * `sobi` * `enable-end-user-sharing-with-groups` * `single-agent-orchestration` * `multi-agent-orchestration` * `cross-product-intelligence` * `workflow-agents` * `in-app-notifications` * `code-extraction`
       "a_key": "A String",
     },
     "generativeAnswerConfig": { # Describes configuration for generative answer. # Describes generative answer configuration.
@@ -930,7 +930,7 @@ 
Method Details

     "enableSafeSearch": True or False, # Whether to enable safe search.
     "enableSearchAsYouType": True or False, # Whether to enable search-as-you-type behavior for the search widget.
     "enableVisualContentSummary": True or False, # If set to true, the widget will enable visual content summary on applicable search requests. Only used by healthcare search.
-    "features": { # Output only. Feature config for the engine to opt in or opt out of features. Supported keys: * `agent-gallery` * `no-code-agent-builder` * `prompt-gallery` * `model-selector` * `notebook-lm` * `people-search` * `people-search-org-chart` * `bi-directional-audio` * `speech-to-text` * `feedback` * `session-sharing` * `personalization-memory` * `personalization-suggested-highlights` * `mobile-app-access` * `disable-agent-sharing` * `disable-image-generation` * `disable-video-generation` * `disable-onedrive-upload` * `disable-talk-to-content` * `disable-google-drive-upload` * `disable-welcome-emails` * `disable-canvas` * `canvas-workspace` * `canvas-app-builder` * `skills` * `skill-sharing` * `skill-sharing-without-admin-approval` * `disable-projects` * `sobi` * `enable-end-user-sharing-with-groups` * `single-agent-orchestration` * `multi-agent-orchestration` * `cross-product-intelligence` * `workflow-agents` * `in-app-notifications`
+    "features": { # Output only. Feature config for the engine to opt in or opt out of features. Supported keys: * `agent-gallery` * `no-code-agent-builder` * `prompt-gallery` * `model-selector` * `notebook-lm` * `people-search` * `people-search-org-chart` * `bi-directional-audio` * `speech-to-text` * `feedback` * `session-sharing` * `personalization-memory` * `personalization-suggested-highlights` * `mobile-app-access` * `disable-agent-sharing` * `disable-image-generation` * `disable-video-generation` * `disable-onedrive-upload` * `disable-talk-to-content` * `disable-google-drive-upload` * `disable-welcome-emails` * `disable-canvas` * `canvas-workspace` * `canvas-app-builder` * `skills` * `skill-sharing` * `skill-sharing-without-admin-approval` * `disable-projects` * `sobi` * `enable-end-user-sharing-with-groups` * `single-agent-orchestration` * `multi-agent-orchestration` * `cross-product-intelligence` * `workflow-agents` * `in-app-notifications` * `code-extraction`
       "a_key": "A String",
     },
     "generativeAnswerConfig": { # Describes configuration for generative answer. # Describes generative answer configuration.
diff --git a/docs/dyn/discoveryengine_v1alpha.projects.locations.evaluations.html b/docs/dyn/discoveryengine_v1alpha.projects.locations.evaluations.html
index 47e68c3ad9..ee0078f6ec 100644
--- a/docs/dyn/discoveryengine_v1alpha.projects.locations.evaluations.html
+++ b/docs/dyn/discoveryengine_v1alpha.projects.locations.evaluations.html
@@ -217,7 +217,7 @@ 
Method Details

           "A String",
         ],
       },
-      "dataStoreSpecs": [ # Specifications that define the specific DataStores to be searched, along with configurations for those data stores. This is only considered for Engines with multiple data stores. For engines with a single data store, the specs directly under SearchRequest should be used.
+      "dataStoreSpecs": [ # Specifications that define the specific DataStores to be searched, along with configurations for those data stores. This is only considered for Engines with multiple data stores. For engines with a single data store, the specs directly under SearchRequest should be used. On an engine with multiple data stores, this field is optional. If it's empty, all of the engine's data stores are searched (blended search). Unless it specifies exactly one data store, some request fields, such as `order_by` and `query_expansion_spec`, aren't supported and return an `INVALID_ARGUMENT` error.
         { # A struct to define data stores to filter on in a search call and configurations for those data stores. Otherwise, an `INVALID_ARGUMENT` error is returned.
           "boostSpec": { # Boost specification to boost certain documents. # Optional. Boost specification to boost certain documents. For more information on boosting, see [Boosting](https://cloud.google.com/generative-ai-app-builder/docs/boost-search-results)
             "conditionBoostSpecs": [ # Condition boost specifications. If a document matches multiple conditions in the specifications, boost scores from these specifications are all applied and combined in a non-linear way. Maximum number of specifications is 20.
@@ -566,7 +566,7 @@ 
Method Details

           "A String",
         ],
       },
-      "dataStoreSpecs": [ # Specifications that define the specific DataStores to be searched, along with configurations for those data stores. This is only considered for Engines with multiple data stores. For engines with a single data store, the specs directly under SearchRequest should be used.
+      "dataStoreSpecs": [ # Specifications that define the specific DataStores to be searched, along with configurations for those data stores. This is only considered for Engines with multiple data stores. For engines with a single data store, the specs directly under SearchRequest should be used. On an engine with multiple data stores, this field is optional. If it's empty, all of the engine's data stores are searched (blended search). Unless it specifies exactly one data store, some request fields, such as `order_by` and `query_expansion_spec`, aren't supported and return an `INVALID_ARGUMENT` error.
         { # A struct to define data stores to filter on in a search call and configurations for those data stores. Otherwise, an `INVALID_ARGUMENT` error is returned.
           "boostSpec": { # Boost specification to boost certain documents. # Optional. Boost specification to boost certain documents. For more information on boosting, see [Boosting](https://cloud.google.com/generative-ai-app-builder/docs/boost-search-results)
             "conditionBoostSpecs": [ # Condition boost specifications. If a document matches multiple conditions in the specifications, boost scores from these specifications are all applied and combined in a non-linear way. Maximum number of specifications is 20.
@@ -891,7 +891,7 @@ 
Method Details

               "A String",
             ],
           },
-          "dataStoreSpecs": [ # Specifications that define the specific DataStores to be searched, along with configurations for those data stores. This is only considered for Engines with multiple data stores. For engines with a single data store, the specs directly under SearchRequest should be used.
+          "dataStoreSpecs": [ # Specifications that define the specific DataStores to be searched, along with configurations for those data stores. This is only considered for Engines with multiple data stores. For engines with a single data store, the specs directly under SearchRequest should be used. On an engine with multiple data stores, this field is optional. If it's empty, all of the engine's data stores are searched (blended search). Unless it specifies exactly one data store, some request fields, such as `order_by` and `query_expansion_spec`, aren't supported and return an `INVALID_ARGUMENT` error.
             { # A struct to define data stores to filter on in a search call and configurations for those data stores. Otherwise, an `INVALID_ARGUMENT` error is returned.
               "boostSpec": { # Boost specification to boost certain documents. # Optional. Boost specification to boost certain documents. For more information on boosting, see [Boosting](https://cloud.google.com/generative-ai-app-builder/docs/boost-search-results)
                 "conditionBoostSpecs": [ # Condition boost specifications. If a document matches multiple conditions in the specifications, boost scores from these specifications are all applied and combined in a non-linear way. Maximum number of specifications is 20.
diff --git a/docs/dyn/discoveryengine_v1alpha.projects.locations.html b/docs/dyn/discoveryengine_v1alpha.projects.locations.html
index 11cc2796c5..d663a0b300 100644
--- a/docs/dyn/discoveryengine_v1alpha.projects.locations.html
+++ b/docs/dyn/discoveryengine_v1alpha.projects.locations.html
@@ -109,6 +109,11 @@ 
Instance Methods

 

 
Returns the identityMappingStores Resource.

 
+

+  knowledgeSpaces()
+

+
Returns the knowledgeSpaces Resource.

+
 

   licenseConfigs()
 

@@ -1233,6 +1238,8 @@ 
Method Details

               "indexableOption": "A String", # If indexable_option is INDEXABLE_ENABLED, field values are indexed so that it can be filtered or faceted in SearchService.Search. If indexable_option is unset, the server behavior defaults to INDEXABLE_DISABLED for fields that support setting indexable options. For those fields that do not support setting indexable options, such as `object` and `boolean` and key properties, the server will skip indexable_option setting, and setting indexable_option for those fields will throw `INVALID_ARGUMENT` error.
               "keyPropertyType": "A String", # Output only. Type of the key property that this field is mapped to. Empty string if this is not annotated as mapped to a key property. Example types are `title`, `description`. Full list is defined by `keyPropertyMapping` in the schema field annotation. If the schema field has a `KeyPropertyMapping` annotation, `indexable_option` and `searchable_option` of this field cannot be modified.
               "metatagName": "A String", # Optional. The metatag name found in the HTML page. If user defines this field, the value of this metatag name will be used to extract metatag. If the user does not define this field, the FieldConfig.field_path will be used to extract metatag.
+              "partialMatchableOption": "A String", # Optional. If partial_matchable_option is PARTIAL_MATCHABLE_OPTION_ENABLED, field values are partial matchable. If partial_matchable_option is unset, the server behavior defaults to PARTIAL_MATCHABLE_OPTION_DISABLED for fields that support setting partial matchable options. For those fields that do not support setting partial matchable options, the server will skip partial matchable option setting, and setting partial_matchable_option for those fields will throw `INVALID_ARGUMENT` error.
+              "prefixMatchableOption": "A String", # Optional. If prefix_matchable_option is PREFIX_MATCHABLE_OPTION_ENABLED, field values are prefix matchable. If prefix_matchable_option is unset, the server behavior defaults to PREFIX_MATCHABLE_OPTION_DISABLED for fields that support setting prefix matchable options. For those fields that do not support setting prefix matchable options, the server will skip prefix matchable option setting, and setting prefix_matchable_option for those fields will throw `INVALID_ARGUMENT` error.
               "recsFilterableOption": "A String", # If recs_filterable_option is FILTERABLE_ENABLED, field values are filterable by filter expression in RecommendationService.Recommend. If FILTERABLE_ENABLED but the field type is numerical, field values are not filterable by text queries in RecommendationService.Recommend. Only textual fields are supported. If recs_filterable_option is unset, the default setting is FILTERABLE_DISABLED for fields that support setting filterable options. When a field set to [FILTERABLE_DISABLED] is filtered, a warning is generated and an empty result is returned.
               "retrievableOption": "A String", # If retrievable_option is RETRIEVABLE_ENABLED, field values are included in the search results. If retrievable_option is unset, the server behavior defaults to RETRIEVABLE_DISABLED for fields that support setting retrievable options. For those fields that do not support setting retrievable options, such as `object` and `boolean`, the server will skip retrievable option setting, and setting retrievable_option for those fields will throw `INVALID_ARGUMENT` error.
               "schemaOrgPaths": [ # Field paths for indexing custom attribute from schema.org data. More details of schema.org and its defined types can be found at [schema.org](https://schema.org). It is only used on advanced site search schema. Currently only support full path from root. The full path to a field is constructed by concatenating field names, starting from `_root`, with a period `.` as the delimiter. Examples: * Publish date of the root: _root.datePublished * Publish date of the reviews: _root.review.datePublished
@@ -1535,6 +1542,8 @@ 
Method Details

             "indexableOption": "A String", # If indexable_option is INDEXABLE_ENABLED, field values are indexed so that it can be filtered or faceted in SearchService.Search. If indexable_option is unset, the server behavior defaults to INDEXABLE_DISABLED for fields that support setting indexable options. For those fields that do not support setting indexable options, such as `object` and `boolean` and key properties, the server will skip indexable_option setting, and setting indexable_option for those fields will throw `INVALID_ARGUMENT` error.
             "keyPropertyType": "A String", # Output only. Type of the key property that this field is mapped to. Empty string if this is not annotated as mapped to a key property. Example types are `title`, `description`. Full list is defined by `keyPropertyMapping` in the schema field annotation. If the schema field has a `KeyPropertyMapping` annotation, `indexable_option` and `searchable_option` of this field cannot be modified.
             "metatagName": "A String", # Optional. The metatag name found in the HTML page. If user defines this field, the value of this metatag name will be used to extract metatag. If the user does not define this field, the FieldConfig.field_path will be used to extract metatag.
+            "partialMatchableOption": "A String", # Optional. If partial_matchable_option is PARTIAL_MATCHABLE_OPTION_ENABLED, field values are partial matchable. If partial_matchable_option is unset, the server behavior defaults to PARTIAL_MATCHABLE_OPTION_DISABLED for fields that support setting partial matchable options. For those fields that do not support setting partial matchable options, the server will skip partial matchable option setting, and setting partial_matchable_option for those fields will throw `INVALID_ARGUMENT` error.
+            "prefixMatchableOption": "A String", # Optional. If prefix_matchable_option is PREFIX_MATCHABLE_OPTION_ENABLED, field values are prefix matchable. If prefix_matchable_option is unset, the server behavior defaults to PREFIX_MATCHABLE_OPTION_DISABLED for fields that support setting prefix matchable options. For those fields that do not support setting prefix matchable options, the server will skip prefix matchable option setting, and setting prefix_matchable_option for those fields will throw `INVALID_ARGUMENT` error.
             "recsFilterableOption": "A String", # If recs_filterable_option is FILTERABLE_ENABLED, field values are filterable by filter expression in RecommendationService.Recommend. If FILTERABLE_ENABLED but the field type is numerical, field values are not filterable by text queries in RecommendationService.Recommend. Only textual fields are supported. If recs_filterable_option is unset, the default setting is FILTERABLE_DISABLED for fields that support setting filterable options. When a field set to [FILTERABLE_DISABLED] is filtered, a warning is generated and an empty result is returned.
             "retrievableOption": "A String", # If retrievable_option is RETRIEVABLE_ENABLED, field values are included in the search results. If retrievable_option is unset, the server behavior defaults to RETRIEVABLE_DISABLED for fields that support setting retrievable options. For those fields that do not support setting retrievable options, such as `object` and `boolean`, the server will skip retrievable option setting, and setting retrievable_option for those fields will throw `INVALID_ARGUMENT` error.
             "schemaOrgPaths": [ # Field paths for indexing custom attribute from schema.org data. More details of schema.org and its defined types can be found at [schema.org](https://schema.org). It is only used on advanced site search schema. Currently only support full path from root. The full path to a field is constructed by concatenating field names, starting from `_root`, with a period `.` as the delimiter. Examples: * Publish date of the root: _root.datePublished * Publish date of the reviews: _root.review.datePublished
diff --git a/docs/dyn/discoveryengine_v1alpha.projects.locations.knowledgeSpaces.html b/docs/dyn/discoveryengine_v1alpha.projects.locations.knowledgeSpaces.html
new file mode 100644
index 0000000000..cd76fc5126
--- /dev/null
+++ b/docs/dyn/discoveryengine_v1alpha.projects.locations.knowledgeSpaces.html
@@ -0,0 +1,91 @@
+
+
+
+
Discovery Engine API . projects . locations . knowledgeSpaces

+
Instance Methods

+

+  operations()
+

+
Returns the operations Resource.

+
+

+  close()

+
Close httplib2 connections.

+
Method Details

+

+    close()
+  
Close httplib2 connections.

+

+
+
\ No newline at end of file
diff --git a/docs/dyn/discoveryengine_v1alpha.projects.locations.knowledgeSpaces.operations.html b/docs/dyn/discoveryengine_v1alpha.projects.locations.knowledgeSpaces.operations.html
new file mode 100644
index 0000000000..6ecea68e22
--- /dev/null
+++ b/docs/dyn/discoveryengine_v1alpha.projects.locations.knowledgeSpaces.operations.html
@@ -0,0 +1,124 @@
+
+
+
+
Discovery Engine API . projects . locations . knowledgeSpaces . operations

+
Instance Methods

+

+  close()

+
Close httplib2 connections.

+

+  get(name, x__xgafv=None)

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

+
Method Details

+

+    close()
+  
Close httplib2 connections.

+

+
+

+    get(name, x__xgafv=None)
+  
Gets the latest state of a long-running operation. Clients can use this method to poll the operation result at intervals as recommended by the API service.
+
+Args:
+  name: string, The name of the operation resource. (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.
+  },
+}

+

+
+
\ No newline at end of file
diff --git a/docs/dyn/discoveryengine_v1alpha.projects.locations.userEvents.html b/docs/dyn/discoveryengine_v1alpha.projects.locations.userEvents.html
index 7174a0a254..38deff94b2 100644
--- a/docs/dyn/discoveryengine_v1alpha.projects.locations.userEvents.html
+++ b/docs/dyn/discoveryengine_v1alpha.projects.locations.userEvents.html
@@ -238,7 +238,9 @@ 
Method Details

             },
             "questionIndex": 42, # The index of the user input within the conversation messages.
             "session": "A String", # Name of the newly generated or continued session.
-            "taskName": "A String", # Optional. The full resource name of the Sobi task if the conversation was handled by a long-running agent task. Format: projects/{project}/locations/{location}/tasks/{task_id}
+            "stepSeqNum": "A String", # Optional. The `TaskServerEvent.seq_num` of the step that opened the rated agent task reply.
+            "taskName": "A String", # Optional. The full resource name of the Sobi task if the conversation was handled by a long-running agent task. Format (canonical, or the short alias the Task API also accepts): projects/{project}/locations/{location}/agents/{agent}/tasks/{task} projects/{project}/locations/{location}/tasks/{task}
+            "trajectoryId": "A String", # Optional. The runtime trajectory id of the rated agent task turn, as set on `TaskServerEvent.trajectory_id`. Shared by all steps of the turn.
           },
           "dataTermsAccepted": True or False, # Optional. Whether the customer accepted data use terms.
           "feedbackSource": "A String", # Optional. The UI component the user feedback comes from, which could be GOOGLE_CONSOLE, GOOGLE_WIDGET, GOOGLE_WEBAPP.
@@ -460,7 +462,9 @@ 
Method Details

       },
       "questionIndex": 42, # The index of the user input within the conversation messages.
       "session": "A String", # Name of the newly generated or continued session.
-      "taskName": "A String", # Optional. The full resource name of the Sobi task if the conversation was handled by a long-running agent task. Format: projects/{project}/locations/{location}/tasks/{task_id}
+      "stepSeqNum": "A String", # Optional. The `TaskServerEvent.seq_num` of the step that opened the rated agent task reply.
+      "taskName": "A String", # Optional. The full resource name of the Sobi task if the conversation was handled by a long-running agent task. Format (canonical, or the short alias the Task API also accepts): projects/{project}/locations/{location}/agents/{agent}/tasks/{task} projects/{project}/locations/{location}/tasks/{task}
+      "trajectoryId": "A String", # Optional. The runtime trajectory id of the rated agent task turn, as set on `TaskServerEvent.trajectory_id`. Shared by all steps of the turn.
     },
     "dataTermsAccepted": True or False, # Optional. Whether the customer accepted data use terms.
     "feedbackSource": "A String", # Optional. The UI component the user feedback comes from, which could be GOOGLE_CONSOLE, GOOGLE_WIDGET, GOOGLE_WEBAPP.
@@ -650,7 +654,9 @@ 
Method Details

       },
       "questionIndex": 42, # The index of the user input within the conversation messages.
       "session": "A String", # Name of the newly generated or continued session.
-      "taskName": "A String", # Optional. The full resource name of the Sobi task if the conversation was handled by a long-running agent task. Format: projects/{project}/locations/{location}/tasks/{task_id}
+      "stepSeqNum": "A String", # Optional. The `TaskServerEvent.seq_num` of the step that opened the rated agent task reply.
+      "taskName": "A String", # Optional. The full resource name of the Sobi task if the conversation was handled by a long-running agent task. Format (canonical, or the short alias the Task API also accepts): projects/{project}/locations/{location}/agents/{agent}/tasks/{task} projects/{project}/locations/{location}/tasks/{task}
+      "trajectoryId": "A String", # Optional. The runtime trajectory id of the rated agent task turn, as set on `TaskServerEvent.trajectory_id`. Shared by all steps of the turn.
     },
     "dataTermsAccepted": True or False, # Optional. Whether the customer accepted data use terms.
     "feedbackSource": "A String", # Optional. The UI component the user feedback comes from, which could be GOOGLE_CONSOLE, GOOGLE_WIDGET, GOOGLE_WEBAPP.
diff --git a/docs/dyn/discoveryengine_v1beta.projects.locations.collections.dataStores.html b/docs/dyn/discoveryengine_v1beta.projects.locations.collections.dataStores.html
index fd4787fa29..47016ad55f 100644
--- a/docs/dyn/discoveryengine_v1beta.projects.locations.collections.dataStores.html
+++ b/docs/dyn/discoveryengine_v1beta.projects.locations.collections.dataStores.html
@@ -350,6 +350,9 @@ 
Method Details

       ],
     },
     "notebooklmConfig": { # Config for connecting to NotebookLM Enterprise. # NotebookLM config. If set, this DataStore is connected to NotebookLM Enterprise.
+      "notebooks": [ # Optional. Restricts this data store to the given notebooks. When empty, the data store covers every notebook the querying user can access, which is the existing behaviour. Each entry is a full notebook resource name, such as `projects/*/locations/*/notebooks/*`. Scoping is enforced on results as well as requested upstream, so a notebook outside this list cannot appear in a search response through this data store even if the backend returns one.
+        "A String",
+      ],
       "searchConfig": "A String", # Required. Search config name. Format: projects/*/locations/global/notebookLmSearchConfigs/*
     },
     "thirdPartyOauthConfig": { # Stores information for third party applicationOAuth. # Third Party OAuth config. If set, this DataStore is connected to a third party application.
@@ -606,6 +609,9 @@ 
Method Details

       ],
     },
     "notebooklmConfig": { # Config for connecting to NotebookLM Enterprise. # NotebookLM config. If set, this DataStore is connected to NotebookLM Enterprise.
+      "notebooks": [ # Optional. Restricts this data store to the given notebooks. When empty, the data store covers every notebook the querying user can access, which is the existing behaviour. Each entry is a full notebook resource name, such as `projects/*/locations/*/notebooks/*`. Scoping is enforced on results as well as requested upstream, so a notebook outside this list cannot appear in a search response through this data store even if the backend returns one.
+        "A String",
+      ],
       "searchConfig": "A String", # Required. Search config name. Format: projects/*/locations/global/notebookLmSearchConfigs/*
     },
     "thirdPartyOauthConfig": { # Stores information for third party applicationOAuth. # Third Party OAuth config. If set, this DataStore is connected to a third party application.
@@ -853,6 +859,9 @@ 
Method Details

           ],
         },
         "notebooklmConfig": { # Config for connecting to NotebookLM Enterprise. # NotebookLM config. If set, this DataStore is connected to NotebookLM Enterprise.
+          "notebooks": [ # Optional. Restricts this data store to the given notebooks. When empty, the data store covers every notebook the querying user can access, which is the existing behaviour. Each entry is a full notebook resource name, such as `projects/*/locations/*/notebooks/*`. Scoping is enforced on results as well as requested upstream, so a notebook outside this list cannot appear in a search response through this data store even if the backend returns one.
+            "A String",
+          ],
           "searchConfig": "A String", # Required. Search config name. Format: projects/*/locations/global/notebookLmSearchConfigs/*
         },
         "thirdPartyOauthConfig": { # Stores information for third party applicationOAuth. # Third Party OAuth config. If set, this DataStore is connected to a third party application.
@@ -1053,6 +1062,9 @@ 
Method Details

       ],
     },
     "notebooklmConfig": { # Config for connecting to NotebookLM Enterprise. # NotebookLM config. If set, this DataStore is connected to NotebookLM Enterprise.
+      "notebooks": [ # Optional. Restricts this data store to the given notebooks. When empty, the data store covers every notebook the querying user can access, which is the existing behaviour. Each entry is a full notebook resource name, such as `projects/*/locations/*/notebooks/*`. Scoping is enforced on results as well as requested upstream, so a notebook outside this list cannot appear in a search response through this data store even if the backend returns one.
+        "A String",
+      ],
       "searchConfig": "A String", # Required. Search config name. Format: projects/*/locations/global/notebookLmSearchConfigs/*
     },
     "thirdPartyOauthConfig": { # Stores information for third party applicationOAuth. # Third Party OAuth config. If set, this DataStore is connected to a third party application.
@@ -1235,6 +1247,9 @@ 
Method Details

       ],
     },
     "notebooklmConfig": { # Config for connecting to NotebookLM Enterprise. # NotebookLM config. If set, this DataStore is connected to NotebookLM Enterprise.
+      "notebooks": [ # Optional. Restricts this data store to the given notebooks. When empty, the data store covers every notebook the querying user can access, which is the existing behaviour. Each entry is a full notebook resource name, such as `projects/*/locations/*/notebooks/*`. Scoping is enforced on results as well as requested upstream, so a notebook outside this list cannot appear in a search response through this data store even if the backend returns one.
+        "A String",
+      ],
       "searchConfig": "A String", # Required. Search config name. Format: projects/*/locations/global/notebookLmSearchConfigs/*
     },
     "thirdPartyOauthConfig": { # Stores information for third party applicationOAuth. # Third Party OAuth config. If set, this DataStore is connected to a third party application.
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 679380e9c2..775c32a68b 100644
--- a/docs/dyn/discoveryengine_v1beta.projects.locations.collections.dataStores.servingConfigs.html
+++ b/docs/dyn/discoveryengine_v1beta.projects.locations.collections.dataStores.servingConfigs.html
@@ -1551,7 +1551,9 @@ 
Method Details

         },
         "questionIndex": 42, # The index of the user input within the conversation messages.
         "session": "A String", # Name of the newly generated or continued session.
-        "taskName": "A String", # Optional. The full resource name of the Sobi task if the conversation was handled by a long-running agent task. Format: projects/{project}/locations/{location}/tasks/{task_id}
+        "stepSeqNum": "A String", # Optional. The `TaskServerEvent.seq_num` of the step that opened the rated agent task reply.
+        "taskName": "A String", # Optional. The full resource name of the Sobi task if the conversation was handled by a long-running agent task. Format (canonical, or the short alias the Task API also accepts): projects/{project}/locations/{location}/agents/{agent}/tasks/{task} projects/{project}/locations/{location}/tasks/{task}
+        "trajectoryId": "A String", # Optional. The runtime trajectory id of the rated agent task turn, as set on `TaskServerEvent.trajectory_id`. Shared by all steps of the turn.
       },
       "dataTermsAccepted": True or False, # Optional. Whether the customer accepted data use terms.
       "feedbackSource": "A String", # Optional. The UI component the user feedback comes from, which could be GOOGLE_CONSOLE, GOOGLE_WIDGET, GOOGLE_WEBAPP.
@@ -1806,7 +1808,7 @@ 
Method Details

       "A String",
     ],
   },
-  "dataStoreSpecs": [ # Specifications that define the specific DataStores to be searched, along with configurations for those data stores. This is only considered for Engines with multiple data stores. For engines with a single data store, the specs directly under SearchRequest should be used.
+  "dataStoreSpecs": [ # Specifications that define the specific DataStores to be searched, along with configurations for those data stores. This is only considered for Engines with multiple data stores. For engines with a single data store, the specs directly under SearchRequest should be used. On an engine with multiple data stores, this field is optional. If it's empty, all of the engine's data stores are searched (blended search). Unless it specifies exactly one data store, some request fields, such as `order_by` and `query_expansion_spec`, aren't supported and return an `INVALID_ARGUMENT` error.
     { # A struct to define data stores to filter on in a search call and configurations for those data stores. Otherwise, an `INVALID_ARGUMENT` error is returned.
       "boostSpec": { # Boost specification to boost certain documents. # Optional. Boost specification to boost certain documents. For more information on boosting, see [Boosting](https://cloud.google.com/generative-ai-app-builder/docs/boost-search-results)
         "conditionBoostSpecs": [ # Condition boost specifications. If a document matches multiple conditions in the specifications, boost scores from these specifications are all applied and combined in a non-linear way. Maximum number of specifications is 20.
@@ -2488,7 +2490,7 @@ 
Method Details

       "A String",
     ],
   },
-  "dataStoreSpecs": [ # Specifications that define the specific DataStores to be searched, along with configurations for those data stores. This is only considered for Engines with multiple data stores. For engines with a single data store, the specs directly under SearchRequest should be used.
+  "dataStoreSpecs": [ # Specifications that define the specific DataStores to be searched, along with configurations for those data stores. This is only considered for Engines with multiple data stores. For engines with a single data store, the specs directly under SearchRequest should be used. On an engine with multiple data stores, this field is optional. If it's empty, all of the engine's data stores are searched (blended search). Unless it specifies exactly one data store, some request fields, such as `order_by` and `query_expansion_spec`, aren't supported and return an `INVALID_ARGUMENT` error.
     { # A struct to define data stores to filter on in a search call and configurations for those data stores. Otherwise, an `INVALID_ARGUMENT` error is returned.
       "boostSpec": { # Boost specification to boost certain documents. # Optional. Boost specification to boost certain documents. For more information on boosting, see [Boosting](https://cloud.google.com/generative-ai-app-builder/docs/boost-search-results)
         "conditionBoostSpecs": [ # Condition boost specifications. If a document matches multiple conditions in the specifications, boost scores from these specifications are all applied and combined in a non-linear way. Maximum number of specifications is 20.
diff --git a/docs/dyn/discoveryengine_v1beta.projects.locations.collections.dataStores.userEvents.html b/docs/dyn/discoveryengine_v1beta.projects.locations.collections.dataStores.userEvents.html
index 30752db899..9bc474b4bf 100644
--- a/docs/dyn/discoveryengine_v1beta.projects.locations.collections.dataStores.userEvents.html
+++ b/docs/dyn/discoveryengine_v1beta.projects.locations.collections.dataStores.userEvents.html
@@ -204,7 +204,9 @@ 
Method Details

             },
             "questionIndex": 42, # The index of the user input within the conversation messages.
             "session": "A String", # Name of the newly generated or continued session.
-            "taskName": "A String", # Optional. The full resource name of the Sobi task if the conversation was handled by a long-running agent task. Format: projects/{project}/locations/{location}/tasks/{task_id}
+            "stepSeqNum": "A String", # Optional. The `TaskServerEvent.seq_num` of the step that opened the rated agent task reply.
+            "taskName": "A String", # Optional. The full resource name of the Sobi task if the conversation was handled by a long-running agent task. Format (canonical, or the short alias the Task API also accepts): projects/{project}/locations/{location}/agents/{agent}/tasks/{task} projects/{project}/locations/{location}/tasks/{task}
+            "trajectoryId": "A String", # Optional. The runtime trajectory id of the rated agent task turn, as set on `TaskServerEvent.trajectory_id`. Shared by all steps of the turn.
           },
           "dataTermsAccepted": True or False, # Optional. Whether the customer accepted data use terms.
           "feedbackSource": "A String", # Optional. The UI component the user feedback comes from, which could be GOOGLE_CONSOLE, GOOGLE_WIDGET, GOOGLE_WEBAPP.
@@ -432,7 +434,9 @@ 
Method Details

       },
       "questionIndex": 42, # The index of the user input within the conversation messages.
       "session": "A String", # Name of the newly generated or continued session.
-      "taskName": "A String", # Optional. The full resource name of the Sobi task if the conversation was handled by a long-running agent task. Format: projects/{project}/locations/{location}/tasks/{task_id}
+      "stepSeqNum": "A String", # Optional. The `TaskServerEvent.seq_num` of the step that opened the rated agent task reply.
+      "taskName": "A String", # Optional. The full resource name of the Sobi task if the conversation was handled by a long-running agent task. Format (canonical, or the short alias the Task API also accepts): projects/{project}/locations/{location}/agents/{agent}/tasks/{task} projects/{project}/locations/{location}/tasks/{task}
+      "trajectoryId": "A String", # Optional. The runtime trajectory id of the rated agent task turn, as set on `TaskServerEvent.trajectory_id`. Shared by all steps of the turn.
     },
     "dataTermsAccepted": True or False, # Optional. Whether the customer accepted data use terms.
     "feedbackSource": "A String", # Optional. The UI component the user feedback comes from, which could be GOOGLE_CONSOLE, GOOGLE_WIDGET, GOOGLE_WEBAPP.
@@ -585,7 +589,9 @@ 
Method Details

       },
       "questionIndex": 42, # The index of the user input within the conversation messages.
       "session": "A String", # Name of the newly generated or continued session.
-      "taskName": "A String", # Optional. The full resource name of the Sobi task if the conversation was handled by a long-running agent task. Format: projects/{project}/locations/{location}/tasks/{task_id}
+      "stepSeqNum": "A String", # Optional. The `TaskServerEvent.seq_num` of the step that opened the rated agent task reply.
+      "taskName": "A String", # Optional. The full resource name of the Sobi task if the conversation was handled by a long-running agent task. Format (canonical, or the short alias the Task API also accepts): projects/{project}/locations/{location}/agents/{agent}/tasks/{task} projects/{project}/locations/{location}/tasks/{task}
+      "trajectoryId": "A String", # Optional. The runtime trajectory id of the rated agent task turn, as set on `TaskServerEvent.trajectory_id`. Shared by all steps of the turn.
     },
     "dataTermsAccepted": True or False, # Optional. Whether the customer accepted data use terms.
     "feedbackSource": "A String", # Optional. The UI component the user feedback comes from, which could be GOOGLE_CONSOLE, GOOGLE_WIDGET, GOOGLE_WEBAPP.
diff --git a/docs/dyn/discoveryengine_v1beta.projects.locations.collections.engines.html b/docs/dyn/discoveryengine_v1beta.projects.locations.collections.engines.html
index f6f8ce3d11..32bed9edbf 100644
--- a/docs/dyn/discoveryengine_v1beta.projects.locations.collections.engines.html
+++ b/docs/dyn/discoveryengine_v1beta.projects.locations.collections.engines.html
@@ -208,7 +208,7 @@ 
Method Details

   ],
   "disableAnalytics": True or False, # Optional. Whether to disable analytics for searches performed on this engine.
   "displayName": "A String", # Required. The display name of the engine. Should be human readable. UTF-8 encoded string with limit of 1024 characters.
-  "features": { # Optional. Feature config for the engine to opt in or opt out of features. Supported keys: * `*`: all features, if it's present, all other feature state settings are ignored. * `agent-gallery` * `no-code-agent-builder` * `prompt-gallery` * `model-selector` * `notebook-lm` * `people-search` * `people-search-org-chart` * `bi-directional-audio` * `speech-to-text` * `feedback` * `session-sharing` * `personalization-memory` * `personalization-suggested-highlights` * `mobile-app-access` * `disable-agent-sharing` * `disable-image-generation` * `disable-video-generation` * `disable-onedrive-upload` * `disable-talk-to-content` * `disable-google-drive-upload` * `disable-welcome-emails` * `disable-canvas` * `canvas-workspace` * `canvas-app-builder` * `skills` * `skill-sharing` * `skill-sharing-without-admin-approval` * `disable-projects` * `sobi` * `enable-end-user-sharing-with-groups` * `single-agent-orchestration` * `multi-agent-orchestration` * `cross-product-intelligence` * `workflow-agents` * `in-app-notifications`
+  "features": { # Optional. Feature config for the engine to opt in or opt out of features. Supported keys: * `*`: all features, if it's present, all other feature state settings are ignored. * `agent-gallery` * `no-code-agent-builder` * `prompt-gallery` * `model-selector` * `notebook-lm` * `people-search` * `people-search-org-chart` * `bi-directional-audio` * `speech-to-text` * `feedback` * `session-sharing` * `personalization-memory` * `personalization-suggested-highlights` * `mobile-app-access` * `disable-agent-sharing` * `disable-image-generation` * `disable-video-generation` * `disable-onedrive-upload` * `disable-talk-to-content` * `disable-google-drive-upload` * `disable-welcome-emails` * `disable-canvas` * `canvas-workspace` * `canvas-app-builder` * `skills` * `skill-sharing` * `skill-sharing-without-admin-approval` * `disable-projects` * `sobi` * `enable-end-user-sharing-with-groups` * `single-agent-orchestration` * `multi-agent-orchestration` * `cross-product-intelligence` * `workflow-agents` * `in-app-notifications` * `code-extraction`
     "a_key": "A String",
   },
   "industryVertical": "A String", # Optional. The industry vertical that the engine registers. The restriction of the Engine industry vertical is based on DataStore: Vertical on Engine has to match vertical of the DataStore linked to the engine.
@@ -401,7 +401,7 @@ 
Method Details

   ],
   "disableAnalytics": True or False, # Optional. Whether to disable analytics for searches performed on this engine.
   "displayName": "A String", # Required. The display name of the engine. Should be human readable. UTF-8 encoded string with limit of 1024 characters.
-  "features": { # Optional. Feature config for the engine to opt in or opt out of features. Supported keys: * `*`: all features, if it's present, all other feature state settings are ignored. * `agent-gallery` * `no-code-agent-builder` * `prompt-gallery` * `model-selector` * `notebook-lm` * `people-search` * `people-search-org-chart` * `bi-directional-audio` * `speech-to-text` * `feedback` * `session-sharing` * `personalization-memory` * `personalization-suggested-highlights` * `mobile-app-access` * `disable-agent-sharing` * `disable-image-generation` * `disable-video-generation` * `disable-onedrive-upload` * `disable-talk-to-content` * `disable-google-drive-upload` * `disable-welcome-emails` * `disable-canvas` * `canvas-workspace` * `canvas-app-builder` * `skills` * `skill-sharing` * `skill-sharing-without-admin-approval` * `disable-projects` * `sobi` * `enable-end-user-sharing-with-groups` * `single-agent-orchestration` * `multi-agent-orchestration` * `cross-product-intelligence` * `workflow-agents` * `in-app-notifications`
+  "features": { # Optional. Feature config for the engine to opt in or opt out of features. Supported keys: * `*`: all features, if it's present, all other feature state settings are ignored. * `agent-gallery` * `no-code-agent-builder` * `prompt-gallery` * `model-selector` * `notebook-lm` * `people-search` * `people-search-org-chart` * `bi-directional-audio` * `speech-to-text` * `feedback` * `session-sharing` * `personalization-memory` * `personalization-suggested-highlights` * `mobile-app-access` * `disable-agent-sharing` * `disable-image-generation` * `disable-video-generation` * `disable-onedrive-upload` * `disable-talk-to-content` * `disable-google-drive-upload` * `disable-welcome-emails` * `disable-canvas` * `canvas-workspace` * `canvas-app-builder` * `skills` * `skill-sharing` * `skill-sharing-without-admin-approval` * `disable-projects` * `sobi` * `enable-end-user-sharing-with-groups` * `single-agent-orchestration` * `multi-agent-orchestration` * `cross-product-intelligence` * `workflow-agents` * `in-app-notifications` * `code-extraction`
     "a_key": "A String",
   },
   "industryVertical": "A String", # Optional. The industry vertical that the engine registers. The restriction of the Engine industry vertical is based on DataStore: Vertical on Engine has to match vertical of the DataStore linked to the engine.
@@ -570,7 +570,7 @@ 
Method Details

       ],
       "disableAnalytics": True or False, # Optional. Whether to disable analytics for searches performed on this engine.
       "displayName": "A String", # Required. The display name of the engine. Should be human readable. UTF-8 encoded string with limit of 1024 characters.
-      "features": { # Optional. Feature config for the engine to opt in or opt out of features. Supported keys: * `*`: all features, if it's present, all other feature state settings are ignored. * `agent-gallery` * `no-code-agent-builder` * `prompt-gallery` * `model-selector` * `notebook-lm` * `people-search` * `people-search-org-chart` * `bi-directional-audio` * `speech-to-text` * `feedback` * `session-sharing` * `personalization-memory` * `personalization-suggested-highlights` * `mobile-app-access` * `disable-agent-sharing` * `disable-image-generation` * `disable-video-generation` * `disable-onedrive-upload` * `disable-talk-to-content` * `disable-google-drive-upload` * `disable-welcome-emails` * `disable-canvas` * `canvas-workspace` * `canvas-app-builder` * `skills` * `skill-sharing` * `skill-sharing-without-admin-approval` * `disable-projects` * `sobi` * `enable-end-user-sharing-with-groups` * `single-agent-orchestration` * `multi-agent-orchestration` * `cross-product-intelligence` * `workflow-agents` * `in-app-notifications`
+      "features": { # Optional. Feature config for the engine to opt in or opt out of features. Supported keys: * `*`: all features, if it's present, all other feature state settings are ignored. * `agent-gallery` * `no-code-agent-builder` * `prompt-gallery` * `model-selector` * `notebook-lm` * `people-search` * `people-search-org-chart` * `bi-directional-audio` * `speech-to-text` * `feedback` * `session-sharing` * `personalization-memory` * `personalization-suggested-highlights` * `mobile-app-access` * `disable-agent-sharing` * `disable-image-generation` * `disable-video-generation` * `disable-onedrive-upload` * `disable-talk-to-content` * `disable-google-drive-upload` * `disable-welcome-emails` * `disable-canvas` * `canvas-workspace` * `canvas-app-builder` * `skills` * `skill-sharing` * `skill-sharing-without-admin-approval` * `disable-projects` * `sobi` * `enable-end-user-sharing-with-groups` * `single-agent-orchestration` * `multi-agent-orchestration` * `cross-product-intelligence` * `workflow-agents` * `in-app-notifications` * `code-extraction`
         "a_key": "A String",
       },
       "industryVertical": "A String", # Optional. The industry vertical that the engine registers. The restriction of the Engine industry vertical is based on DataStore: Vertical on Engine has to match vertical of the DataStore linked to the engine.
@@ -711,7 +711,7 @@ 
Method Details

   ],
   "disableAnalytics": True or False, # Optional. Whether to disable analytics for searches performed on this engine.
   "displayName": "A String", # Required. The display name of the engine. Should be human readable. UTF-8 encoded string with limit of 1024 characters.
-  "features": { # Optional. Feature config for the engine to opt in or opt out of features. Supported keys: * `*`: all features, if it's present, all other feature state settings are ignored. * `agent-gallery` * `no-code-agent-builder` * `prompt-gallery` * `model-selector` * `notebook-lm` * `people-search` * `people-search-org-chart` * `bi-directional-audio` * `speech-to-text` * `feedback` * `session-sharing` * `personalization-memory` * `personalization-suggested-highlights` * `mobile-app-access` * `disable-agent-sharing` * `disable-image-generation` * `disable-video-generation` * `disable-onedrive-upload` * `disable-talk-to-content` * `disable-google-drive-upload` * `disable-welcome-emails` * `disable-canvas` * `canvas-workspace` * `canvas-app-builder` * `skills` * `skill-sharing` * `skill-sharing-without-admin-approval` * `disable-projects` * `sobi` * `enable-end-user-sharing-with-groups` * `single-agent-orchestration` * `multi-agent-orchestration` * `cross-product-intelligence` * `workflow-agents` * `in-app-notifications`
+  "features": { # Optional. Feature config for the engine to opt in or opt out of features. Supported keys: * `*`: all features, if it's present, all other feature state settings are ignored. * `agent-gallery` * `no-code-agent-builder` * `prompt-gallery` * `model-selector` * `notebook-lm` * `people-search` * `people-search-org-chart` * `bi-directional-audio` * `speech-to-text` * `feedback` * `session-sharing` * `personalization-memory` * `personalization-suggested-highlights` * `mobile-app-access` * `disable-agent-sharing` * `disable-image-generation` * `disable-video-generation` * `disable-onedrive-upload` * `disable-talk-to-content` * `disable-google-drive-upload` * `disable-welcome-emails` * `disable-canvas` * `canvas-workspace` * `canvas-app-builder` * `skills` * `skill-sharing` * `skill-sharing-without-admin-approval` * `disable-projects` * `sobi` * `enable-end-user-sharing-with-groups` * `single-agent-orchestration` * `multi-agent-orchestration` * `cross-product-intelligence` * `workflow-agents` * `in-app-notifications` * `code-extraction`
     "a_key": "A String",
   },
   "industryVertical": "A String", # Optional. The industry vertical that the engine registers. The restriction of the Engine industry vertical is based on DataStore: Vertical on Engine has to match vertical of the DataStore linked to the engine.
@@ -834,7 +834,7 @@ 
Method Details

   ],
   "disableAnalytics": True or False, # Optional. Whether to disable analytics for searches performed on this engine.
   "displayName": "A String", # Required. The display name of the engine. Should be human readable. UTF-8 encoded string with limit of 1024 characters.
-  "features": { # Optional. Feature config for the engine to opt in or opt out of features. Supported keys: * `*`: all features, if it's present, all other feature state settings are ignored. * `agent-gallery` * `no-code-agent-builder` * `prompt-gallery` * `model-selector` * `notebook-lm` * `people-search` * `people-search-org-chart` * `bi-directional-audio` * `speech-to-text` * `feedback` * `session-sharing` * `personalization-memory` * `personalization-suggested-highlights` * `mobile-app-access` * `disable-agent-sharing` * `disable-image-generation` * `disable-video-generation` * `disable-onedrive-upload` * `disable-talk-to-content` * `disable-google-drive-upload` * `disable-welcome-emails` * `disable-canvas` * `canvas-workspace` * `canvas-app-builder` * `skills` * `skill-sharing` * `skill-sharing-without-admin-approval` * `disable-projects` * `sobi` * `enable-end-user-sharing-with-groups` * `single-agent-orchestration` * `multi-agent-orchestration` * `cross-product-intelligence` * `workflow-agents` * `in-app-notifications`
+  "features": { # Optional. Feature config for the engine to opt in or opt out of features. Supported keys: * `*`: all features, if it's present, all other feature state settings are ignored. * `agent-gallery` * `no-code-agent-builder` * `prompt-gallery` * `model-selector` * `notebook-lm` * `people-search` * `people-search-org-chart` * `bi-directional-audio` * `speech-to-text` * `feedback` * `session-sharing` * `personalization-memory` * `personalization-suggested-highlights` * `mobile-app-access` * `disable-agent-sharing` * `disable-image-generation` * `disable-video-generation` * `disable-onedrive-upload` * `disable-talk-to-content` * `disable-google-drive-upload` * `disable-welcome-emails` * `disable-canvas` * `canvas-workspace` * `canvas-app-builder` * `skills` * `skill-sharing` * `skill-sharing-without-admin-approval` * `disable-projects` * `sobi` * `enable-end-user-sharing-with-groups` * `single-agent-orchestration` * `multi-agent-orchestration` * `cross-product-intelligence` * `workflow-agents` * `in-app-notifications` * `code-extraction`
     "a_key": "A String",
   },
   "industryVertical": "A String", # Optional. The industry vertical that the engine registers. The restriction of the Engine industry vertical is based on DataStore: Vertical on Engine has to match vertical of the DataStore linked to the engine.
@@ -969,7 +969,7 @@ 
Method Details

   ],
   "disableAnalytics": True or False, # Optional. Whether to disable analytics for searches performed on this engine.
   "displayName": "A String", # Required. The display name of the engine. Should be human readable. UTF-8 encoded string with limit of 1024 characters.
-  "features": { # Optional. Feature config for the engine to opt in or opt out of features. Supported keys: * `*`: all features, if it's present, all other feature state settings are ignored. * `agent-gallery` * `no-code-agent-builder` * `prompt-gallery` * `model-selector` * `notebook-lm` * `people-search` * `people-search-org-chart` * `bi-directional-audio` * `speech-to-text` * `feedback` * `session-sharing` * `personalization-memory` * `personalization-suggested-highlights` * `mobile-app-access` * `disable-agent-sharing` * `disable-image-generation` * `disable-video-generation` * `disable-onedrive-upload` * `disable-talk-to-content` * `disable-google-drive-upload` * `disable-welcome-emails` * `disable-canvas` * `canvas-workspace` * `canvas-app-builder` * `skills` * `skill-sharing` * `skill-sharing-without-admin-approval` * `disable-projects` * `sobi` * `enable-end-user-sharing-with-groups` * `single-agent-orchestration` * `multi-agent-orchestration` * `cross-product-intelligence` * `workflow-agents` * `in-app-notifications`
+  "features": { # Optional. Feature config for the engine to opt in or opt out of features. Supported keys: * `*`: all features, if it's present, all other feature state settings are ignored. * `agent-gallery` * `no-code-agent-builder` * `prompt-gallery` * `model-selector` * `notebook-lm` * `people-search` * `people-search-org-chart` * `bi-directional-audio` * `speech-to-text` * `feedback` * `session-sharing` * `personalization-memory` * `personalization-suggested-highlights` * `mobile-app-access` * `disable-agent-sharing` * `disable-image-generation` * `disable-video-generation` * `disable-onedrive-upload` * `disable-talk-to-content` * `disable-google-drive-upload` * `disable-welcome-emails` * `disable-canvas` * `canvas-workspace` * `canvas-app-builder` * `skills` * `skill-sharing` * `skill-sharing-without-admin-approval` * `disable-projects` * `sobi` * `enable-end-user-sharing-with-groups` * `single-agent-orchestration` * `multi-agent-orchestration` * `cross-product-intelligence` * `workflow-agents` * `in-app-notifications` * `code-extraction`
     "a_key": "A String",
   },
   "industryVertical": "A String", # Optional. The industry vertical that the engine registers. The restriction of the Engine industry vertical is based on DataStore: Vertical on Engine has to match vertical of the DataStore linked to the engine.
@@ -1104,7 +1104,7 @@ 
Method Details

   ],
   "disableAnalytics": True or False, # Optional. Whether to disable analytics for searches performed on this engine.
   "displayName": "A String", # Required. The display name of the engine. Should be human readable. UTF-8 encoded string with limit of 1024 characters.
-  "features": { # Optional. Feature config for the engine to opt in or opt out of features. Supported keys: * `*`: all features, if it's present, all other feature state settings are ignored. * `agent-gallery` * `no-code-agent-builder` * `prompt-gallery` * `model-selector` * `notebook-lm` * `people-search` * `people-search-org-chart` * `bi-directional-audio` * `speech-to-text` * `feedback` * `session-sharing` * `personalization-memory` * `personalization-suggested-highlights` * `mobile-app-access` * `disable-agent-sharing` * `disable-image-generation` * `disable-video-generation` * `disable-onedrive-upload` * `disable-talk-to-content` * `disable-google-drive-upload` * `disable-welcome-emails` * `disable-canvas` * `canvas-workspace` * `canvas-app-builder` * `skills` * `skill-sharing` * `skill-sharing-without-admin-approval` * `disable-projects` * `sobi` * `enable-end-user-sharing-with-groups` * `single-agent-orchestration` * `multi-agent-orchestration` * `cross-product-intelligence` * `workflow-agents` * `in-app-notifications`
+  "features": { # Optional. Feature config for the engine to opt in or opt out of features. Supported keys: * `*`: all features, if it's present, all other feature state settings are ignored. * `agent-gallery` * `no-code-agent-builder` * `prompt-gallery` * `model-selector` * `notebook-lm` * `people-search` * `people-search-org-chart` * `bi-directional-audio` * `speech-to-text` * `feedback` * `session-sharing` * `personalization-memory` * `personalization-suggested-highlights` * `mobile-app-access` * `disable-agent-sharing` * `disable-image-generation` * `disable-video-generation` * `disable-onedrive-upload` * `disable-talk-to-content` * `disable-google-drive-upload` * `disable-welcome-emails` * `disable-canvas` * `canvas-workspace` * `canvas-app-builder` * `skills` * `skill-sharing` * `skill-sharing-without-admin-approval` * `disable-projects` * `sobi` * `enable-end-user-sharing-with-groups` * `single-agent-orchestration` * `multi-agent-orchestration` * `cross-product-intelligence` * `workflow-agents` * `in-app-notifications` * `code-extraction`
     "a_key": "A String",
   },
   "industryVertical": "A String", # Optional. The industry vertical that the engine registers. The restriction of the Engine industry vertical is based on DataStore: Vertical on Engine has to match vertical of the DataStore linked to the engine.
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 93339632c8..253a8754c2 100644
--- a/docs/dyn/discoveryengine_v1beta.projects.locations.collections.engines.servingConfigs.html
+++ b/docs/dyn/discoveryengine_v1beta.projects.locations.collections.engines.servingConfigs.html
@@ -1551,7 +1551,9 @@ 
Method Details

         },
         "questionIndex": 42, # The index of the user input within the conversation messages.
         "session": "A String", # Name of the newly generated or continued session.
-        "taskName": "A String", # Optional. The full resource name of the Sobi task if the conversation was handled by a long-running agent task. Format: projects/{project}/locations/{location}/tasks/{task_id}
+        "stepSeqNum": "A String", # Optional. The `TaskServerEvent.seq_num` of the step that opened the rated agent task reply.
+        "taskName": "A String", # Optional. The full resource name of the Sobi task if the conversation was handled by a long-running agent task. Format (canonical, or the short alias the Task API also accepts): projects/{project}/locations/{location}/agents/{agent}/tasks/{task} projects/{project}/locations/{location}/tasks/{task}
+        "trajectoryId": "A String", # Optional. The runtime trajectory id of the rated agent task turn, as set on `TaskServerEvent.trajectory_id`. Shared by all steps of the turn.
       },
       "dataTermsAccepted": True or False, # Optional. Whether the customer accepted data use terms.
       "feedbackSource": "A String", # Optional. The UI component the user feedback comes from, which could be GOOGLE_CONSOLE, GOOGLE_WIDGET, GOOGLE_WEBAPP.
@@ -1806,7 +1808,7 @@ 
Method Details

       "A String",
     ],
   },
-  "dataStoreSpecs": [ # Specifications that define the specific DataStores to be searched, along with configurations for those data stores. This is only considered for Engines with multiple data stores. For engines with a single data store, the specs directly under SearchRequest should be used.
+  "dataStoreSpecs": [ # Specifications that define the specific DataStores to be searched, along with configurations for those data stores. This is only considered for Engines with multiple data stores. For engines with a single data store, the specs directly under SearchRequest should be used. On an engine with multiple data stores, this field is optional. If it's empty, all of the engine's data stores are searched (blended search). Unless it specifies exactly one data store, some request fields, such as `order_by` and `query_expansion_spec`, aren't supported and return an `INVALID_ARGUMENT` error.
     { # A struct to define data stores to filter on in a search call and configurations for those data stores. Otherwise, an `INVALID_ARGUMENT` error is returned.
       "boostSpec": { # Boost specification to boost certain documents. # Optional. Boost specification to boost certain documents. For more information on boosting, see [Boosting](https://cloud.google.com/generative-ai-app-builder/docs/boost-search-results)
         "conditionBoostSpecs": [ # Condition boost specifications. If a document matches multiple conditions in the specifications, boost scores from these specifications are all applied and combined in a non-linear way. Maximum number of specifications is 20.
@@ -2488,7 +2490,7 @@ 
Method Details

       "A String",
     ],
   },
-  "dataStoreSpecs": [ # Specifications that define the specific DataStores to be searched, along with configurations for those data stores. This is only considered for Engines with multiple data stores. For engines with a single data store, the specs directly under SearchRequest should be used.
+  "dataStoreSpecs": [ # Specifications that define the specific DataStores to be searched, along with configurations for those data stores. This is only considered for Engines with multiple data stores. For engines with a single data store, the specs directly under SearchRequest should be used. On an engine with multiple data stores, this field is optional. If it's empty, all of the engine's data stores are searched (blended search). Unless it specifies exactly one data store, some request fields, such as `order_by` and `query_expansion_spec`, aren't supported and return an `INVALID_ARGUMENT` error.
     { # A struct to define data stores to filter on in a search call and configurations for those data stores. Otherwise, an `INVALID_ARGUMENT` error is returned.
       "boostSpec": { # Boost specification to boost certain documents. # Optional. Boost specification to boost certain documents. For more information on boosting, see [Boosting](https://cloud.google.com/generative-ai-app-builder/docs/boost-search-results)
         "conditionBoostSpecs": [ # Condition boost specifications. If a document matches multiple conditions in the specifications, boost scores from these specifications are all applied and combined in a non-linear way. Maximum number of specifications is 20.
diff --git a/docs/dyn/discoveryengine_v1beta.projects.locations.dataStores.html b/docs/dyn/discoveryengine_v1beta.projects.locations.dataStores.html
index 0e77add2a4..8a7b25255f 100644
--- a/docs/dyn/discoveryengine_v1beta.projects.locations.dataStores.html
+++ b/docs/dyn/discoveryengine_v1beta.projects.locations.dataStores.html
@@ -342,6 +342,9 @@ 
Method Details

       ],
     },
     "notebooklmConfig": { # Config for connecting to NotebookLM Enterprise. # NotebookLM config. If set, this DataStore is connected to NotebookLM Enterprise.
+      "notebooks": [ # Optional. Restricts this data store to the given notebooks. When empty, the data store covers every notebook the querying user can access, which is the existing behaviour. Each entry is a full notebook resource name, such as `projects/*/locations/*/notebooks/*`. Scoping is enforced on results as well as requested upstream, so a notebook outside this list cannot appear in a search response through this data store even if the backend returns one.
+        "A String",
+      ],
       "searchConfig": "A String", # Required. Search config name. Format: projects/*/locations/global/notebookLmSearchConfigs/*
     },
     "thirdPartyOauthConfig": { # Stores information for third party applicationOAuth. # Third Party OAuth config. If set, this DataStore is connected to a third party application.
@@ -598,6 +601,9 @@ 
Method Details

       ],
     },
     "notebooklmConfig": { # Config for connecting to NotebookLM Enterprise. # NotebookLM config. If set, this DataStore is connected to NotebookLM Enterprise.
+      "notebooks": [ # Optional. Restricts this data store to the given notebooks. When empty, the data store covers every notebook the querying user can access, which is the existing behaviour. Each entry is a full notebook resource name, such as `projects/*/locations/*/notebooks/*`. Scoping is enforced on results as well as requested upstream, so a notebook outside this list cannot appear in a search response through this data store even if the backend returns one.
+        "A String",
+      ],
       "searchConfig": "A String", # Required. Search config name. Format: projects/*/locations/global/notebookLmSearchConfigs/*
     },
     "thirdPartyOauthConfig": { # Stores information for third party applicationOAuth. # Third Party OAuth config. If set, this DataStore is connected to a third party application.
@@ -845,6 +851,9 @@ 
Method Details

           ],
         },
         "notebooklmConfig": { # Config for connecting to NotebookLM Enterprise. # NotebookLM config. If set, this DataStore is connected to NotebookLM Enterprise.
+          "notebooks": [ # Optional. Restricts this data store to the given notebooks. When empty, the data store covers every notebook the querying user can access, which is the existing behaviour. Each entry is a full notebook resource name, such as `projects/*/locations/*/notebooks/*`. Scoping is enforced on results as well as requested upstream, so a notebook outside this list cannot appear in a search response through this data store even if the backend returns one.
+            "A String",
+          ],
           "searchConfig": "A String", # Required. Search config name. Format: projects/*/locations/global/notebookLmSearchConfigs/*
         },
         "thirdPartyOauthConfig": { # Stores information for third party applicationOAuth. # Third Party OAuth config. If set, this DataStore is connected to a third party application.
@@ -1045,6 +1054,9 @@ 
Method Details

       ],
     },
     "notebooklmConfig": { # Config for connecting to NotebookLM Enterprise. # NotebookLM config. If set, this DataStore is connected to NotebookLM Enterprise.
+      "notebooks": [ # Optional. Restricts this data store to the given notebooks. When empty, the data store covers every notebook the querying user can access, which is the existing behaviour. Each entry is a full notebook resource name, such as `projects/*/locations/*/notebooks/*`. Scoping is enforced on results as well as requested upstream, so a notebook outside this list cannot appear in a search response through this data store even if the backend returns one.
+        "A String",
+      ],
       "searchConfig": "A String", # Required. Search config name. Format: projects/*/locations/global/notebookLmSearchConfigs/*
     },
     "thirdPartyOauthConfig": { # Stores information for third party applicationOAuth. # Third Party OAuth config. If set, this DataStore is connected to a third party application.
@@ -1227,6 +1239,9 @@ 
Method Details

       ],
     },
     "notebooklmConfig": { # Config for connecting to NotebookLM Enterprise. # NotebookLM config. If set, this DataStore is connected to NotebookLM Enterprise.
+      "notebooks": [ # Optional. Restricts this data store to the given notebooks. When empty, the data store covers every notebook the querying user can access, which is the existing behaviour. Each entry is a full notebook resource name, such as `projects/*/locations/*/notebooks/*`. Scoping is enforced on results as well as requested upstream, so a notebook outside this list cannot appear in a search response through this data store even if the backend returns one.
+        "A String",
+      ],
       "searchConfig": "A String", # Required. Search config name. Format: projects/*/locations/global/notebookLmSearchConfigs/*
     },
     "thirdPartyOauthConfig": { # Stores information for third party applicationOAuth. # Third Party OAuth config. If set, this DataStore is connected to a third party application.
diff --git a/docs/dyn/discoveryengine_v1beta.projects.locations.dataStores.servingConfigs.html b/docs/dyn/discoveryengine_v1beta.projects.locations.dataStores.servingConfigs.html
index ef12908aaf..e2d7d8020a 100644
--- a/docs/dyn/discoveryengine_v1beta.projects.locations.dataStores.servingConfigs.html
+++ b/docs/dyn/discoveryengine_v1beta.projects.locations.dataStores.servingConfigs.html
@@ -1551,7 +1551,9 @@ 
Method Details

         },
         "questionIndex": 42, # The index of the user input within the conversation messages.
         "session": "A String", # Name of the newly generated or continued session.
-        "taskName": "A String", # Optional. The full resource name of the Sobi task if the conversation was handled by a long-running agent task. Format: projects/{project}/locations/{location}/tasks/{task_id}
+        "stepSeqNum": "A String", # Optional. The `TaskServerEvent.seq_num` of the step that opened the rated agent task reply.
+        "taskName": "A String", # Optional. The full resource name of the Sobi task if the conversation was handled by a long-running agent task. Format (canonical, or the short alias the Task API also accepts): projects/{project}/locations/{location}/agents/{agent}/tasks/{task} projects/{project}/locations/{location}/tasks/{task}
+        "trajectoryId": "A String", # Optional. The runtime trajectory id of the rated agent task turn, as set on `TaskServerEvent.trajectory_id`. Shared by all steps of the turn.
       },
       "dataTermsAccepted": True or False, # Optional. Whether the customer accepted data use terms.
       "feedbackSource": "A String", # Optional. The UI component the user feedback comes from, which could be GOOGLE_CONSOLE, GOOGLE_WIDGET, GOOGLE_WEBAPP.
@@ -1806,7 +1808,7 @@ 
Method Details

       "A String",
     ],
   },
-  "dataStoreSpecs": [ # Specifications that define the specific DataStores to be searched, along with configurations for those data stores. This is only considered for Engines with multiple data stores. For engines with a single data store, the specs directly under SearchRequest should be used.
+  "dataStoreSpecs": [ # Specifications that define the specific DataStores to be searched, along with configurations for those data stores. This is only considered for Engines with multiple data stores. For engines with a single data store, the specs directly under SearchRequest should be used. On an engine with multiple data stores, this field is optional. If it's empty, all of the engine's data stores are searched (blended search). Unless it specifies exactly one data store, some request fields, such as `order_by` and `query_expansion_spec`, aren't supported and return an `INVALID_ARGUMENT` error.
     { # A struct to define data stores to filter on in a search call and configurations for those data stores. Otherwise, an `INVALID_ARGUMENT` error is returned.
       "boostSpec": { # Boost specification to boost certain documents. # Optional. Boost specification to boost certain documents. For more information on boosting, see [Boosting](https://cloud.google.com/generative-ai-app-builder/docs/boost-search-results)
         "conditionBoostSpecs": [ # Condition boost specifications. If a document matches multiple conditions in the specifications, boost scores from these specifications are all applied and combined in a non-linear way. Maximum number of specifications is 20.
@@ -2488,7 +2490,7 @@ 
Method Details

       "A String",
     ],
   },
-  "dataStoreSpecs": [ # Specifications that define the specific DataStores to be searched, along with configurations for those data stores. This is only considered for Engines with multiple data stores. For engines with a single data store, the specs directly under SearchRequest should be used.
+  "dataStoreSpecs": [ # Specifications that define the specific DataStores to be searched, along with configurations for those data stores. This is only considered for Engines with multiple data stores. For engines with a single data store, the specs directly under SearchRequest should be used. On an engine with multiple data stores, this field is optional. If it's empty, all of the engine's data stores are searched (blended search). Unless it specifies exactly one data store, some request fields, such as `order_by` and `query_expansion_spec`, aren't supported and return an `INVALID_ARGUMENT` error.
     { # A struct to define data stores to filter on in a search call and configurations for those data stores. Otherwise, an `INVALID_ARGUMENT` error is returned.
       "boostSpec": { # Boost specification to boost certain documents. # Optional. Boost specification to boost certain documents. For more information on boosting, see [Boosting](https://cloud.google.com/generative-ai-app-builder/docs/boost-search-results)
         "conditionBoostSpecs": [ # Condition boost specifications. If a document matches multiple conditions in the specifications, boost scores from these specifications are all applied and combined in a non-linear way. Maximum number of specifications is 20.
diff --git a/docs/dyn/discoveryengine_v1beta.projects.locations.dataStores.userEvents.html b/docs/dyn/discoveryengine_v1beta.projects.locations.dataStores.userEvents.html
index 2ffe557538..b1162b7215 100644
--- a/docs/dyn/discoveryengine_v1beta.projects.locations.dataStores.userEvents.html
+++ b/docs/dyn/discoveryengine_v1beta.projects.locations.dataStores.userEvents.html
@@ -204,7 +204,9 @@ 
Method Details

             },
             "questionIndex": 42, # The index of the user input within the conversation messages.
             "session": "A String", # Name of the newly generated or continued session.
-            "taskName": "A String", # Optional. The full resource name of the Sobi task if the conversation was handled by a long-running agent task. Format: projects/{project}/locations/{location}/tasks/{task_id}
+            "stepSeqNum": "A String", # Optional. The `TaskServerEvent.seq_num` of the step that opened the rated agent task reply.
+            "taskName": "A String", # Optional. The full resource name of the Sobi task if the conversation was handled by a long-running agent task. Format (canonical, or the short alias the Task API also accepts): projects/{project}/locations/{location}/agents/{agent}/tasks/{task} projects/{project}/locations/{location}/tasks/{task}
+            "trajectoryId": "A String", # Optional. The runtime trajectory id of the rated agent task turn, as set on `TaskServerEvent.trajectory_id`. Shared by all steps of the turn.
           },
           "dataTermsAccepted": True or False, # Optional. Whether the customer accepted data use terms.
           "feedbackSource": "A String", # Optional. The UI component the user feedback comes from, which could be GOOGLE_CONSOLE, GOOGLE_WIDGET, GOOGLE_WEBAPP.
@@ -432,7 +434,9 @@ 
Method Details

       },
       "questionIndex": 42, # The index of the user input within the conversation messages.
       "session": "A String", # Name of the newly generated or continued session.
-      "taskName": "A String", # Optional. The full resource name of the Sobi task if the conversation was handled by a long-running agent task. Format: projects/{project}/locations/{location}/tasks/{task_id}
+      "stepSeqNum": "A String", # Optional. The `TaskServerEvent.seq_num` of the step that opened the rated agent task reply.
+      "taskName": "A String", # Optional. The full resource name of the Sobi task if the conversation was handled by a long-running agent task. Format (canonical, or the short alias the Task API also accepts): projects/{project}/locations/{location}/agents/{agent}/tasks/{task} projects/{project}/locations/{location}/tasks/{task}
+      "trajectoryId": "A String", # Optional. The runtime trajectory id of the rated agent task turn, as set on `TaskServerEvent.trajectory_id`. Shared by all steps of the turn.
     },
     "dataTermsAccepted": True or False, # Optional. Whether the customer accepted data use terms.
     "feedbackSource": "A String", # Optional. The UI component the user feedback comes from, which could be GOOGLE_CONSOLE, GOOGLE_WIDGET, GOOGLE_WEBAPP.
@@ -585,7 +589,9 @@ 
Method Details

       },
       "questionIndex": 42, # The index of the user input within the conversation messages.
       "session": "A String", # Name of the newly generated or continued session.
-      "taskName": "A String", # Optional. The full resource name of the Sobi task if the conversation was handled by a long-running agent task. Format: projects/{project}/locations/{location}/tasks/{task_id}
+      "stepSeqNum": "A String", # Optional. The `TaskServerEvent.seq_num` of the step that opened the rated agent task reply.
+      "taskName": "A String", # Optional. The full resource name of the Sobi task if the conversation was handled by a long-running agent task. Format (canonical, or the short alias the Task API also accepts): projects/{project}/locations/{location}/agents/{agent}/tasks/{task} projects/{project}/locations/{location}/tasks/{task}
+      "trajectoryId": "A String", # Optional. The runtime trajectory id of the rated agent task turn, as set on `TaskServerEvent.trajectory_id`. Shared by all steps of the turn.
     },
     "dataTermsAccepted": True or False, # Optional. Whether the customer accepted data use terms.
     "feedbackSource": "A String", # Optional. The UI component the user feedback comes from, which could be GOOGLE_CONSOLE, GOOGLE_WIDGET, GOOGLE_WEBAPP.
diff --git a/docs/dyn/discoveryengine_v1beta.projects.locations.evaluations.html b/docs/dyn/discoveryengine_v1beta.projects.locations.evaluations.html
index 53000c2dbc..589d08262a 100644
--- a/docs/dyn/discoveryengine_v1beta.projects.locations.evaluations.html
+++ b/docs/dyn/discoveryengine_v1beta.projects.locations.evaluations.html
@@ -214,7 +214,7 @@ 
Method Details

           "A String",
         ],
       },
-      "dataStoreSpecs": [ # Specifications that define the specific DataStores to be searched, along with configurations for those data stores. This is only considered for Engines with multiple data stores. For engines with a single data store, the specs directly under SearchRequest should be used.
+      "dataStoreSpecs": [ # Specifications that define the specific DataStores to be searched, along with configurations for those data stores. This is only considered for Engines with multiple data stores. For engines with a single data store, the specs directly under SearchRequest should be used. On an engine with multiple data stores, this field is optional. If it's empty, all of the engine's data stores are searched (blended search). Unless it specifies exactly one data store, some request fields, such as `order_by` and `query_expansion_spec`, aren't supported and return an `INVALID_ARGUMENT` error.
         { # A struct to define data stores to filter on in a search call and configurations for those data stores. Otherwise, an `INVALID_ARGUMENT` error is returned.
           "boostSpec": { # Boost specification to boost certain documents. # Optional. Boost specification to boost certain documents. For more information on boosting, see [Boosting](https://cloud.google.com/generative-ai-app-builder/docs/boost-search-results)
             "conditionBoostSpecs": [ # Condition boost specifications. If a document matches multiple conditions in the specifications, boost scores from these specifications are all applied and combined in a non-linear way. Maximum number of specifications is 20.
@@ -559,7 +559,7 @@ 
Method Details

           "A String",
         ],
       },
-      "dataStoreSpecs": [ # Specifications that define the specific DataStores to be searched, along with configurations for those data stores. This is only considered for Engines with multiple data stores. For engines with a single data store, the specs directly under SearchRequest should be used.
+      "dataStoreSpecs": [ # Specifications that define the specific DataStores to be searched, along with configurations for those data stores. This is only considered for Engines with multiple data stores. For engines with a single data store, the specs directly under SearchRequest should be used. On an engine with multiple data stores, this field is optional. If it's empty, all of the engine's data stores are searched (blended search). Unless it specifies exactly one data store, some request fields, such as `order_by` and `query_expansion_spec`, aren't supported and return an `INVALID_ARGUMENT` error.
         { # A struct to define data stores to filter on in a search call and configurations for those data stores. Otherwise, an `INVALID_ARGUMENT` error is returned.
           "boostSpec": { # Boost specification to boost certain documents. # Optional. Boost specification to boost certain documents. For more information on boosting, see [Boosting](https://cloud.google.com/generative-ai-app-builder/docs/boost-search-results)
             "conditionBoostSpecs": [ # Condition boost specifications. If a document matches multiple conditions in the specifications, boost scores from these specifications are all applied and combined in a non-linear way. Maximum number of specifications is 20.
@@ -880,7 +880,7 @@ 
Method Details

               "A String",
             ],
           },
-          "dataStoreSpecs": [ # Specifications that define the specific DataStores to be searched, along with configurations for those data stores. This is only considered for Engines with multiple data stores. For engines with a single data store, the specs directly under SearchRequest should be used.
+          "dataStoreSpecs": [ # Specifications that define the specific DataStores to be searched, along with configurations for those data stores. This is only considered for Engines with multiple data stores. For engines with a single data store, the specs directly under SearchRequest should be used. On an engine with multiple data stores, this field is optional. If it's empty, all of the engine's data stores are searched (blended search). Unless it specifies exactly one data store, some request fields, such as `order_by` and `query_expansion_spec`, aren't supported and return an `INVALID_ARGUMENT` error.
             { # A struct to define data stores to filter on in a search call and configurations for those data stores. Otherwise, an `INVALID_ARGUMENT` error is returned.
               "boostSpec": { # Boost specification to boost certain documents. # Optional. Boost specification to boost certain documents. For more information on boosting, see [Boosting](https://cloud.google.com/generative-ai-app-builder/docs/boost-search-results)
                 "conditionBoostSpecs": [ # Condition boost specifications. If a document matches multiple conditions in the specifications, boost scores from these specifications are all applied and combined in a non-linear way. Maximum number of specifications is 20.
diff --git a/docs/dyn/discoveryengine_v1beta.projects.locations.userEvents.html b/docs/dyn/discoveryengine_v1beta.projects.locations.userEvents.html
index b858947e56..3ac3bd5794 100644
--- a/docs/dyn/discoveryengine_v1beta.projects.locations.userEvents.html
+++ b/docs/dyn/discoveryengine_v1beta.projects.locations.userEvents.html
@@ -201,7 +201,9 @@ 
Method Details

             },
             "questionIndex": 42, # The index of the user input within the conversation messages.
             "session": "A String", # Name of the newly generated or continued session.
-            "taskName": "A String", # Optional. The full resource name of the Sobi task if the conversation was handled by a long-running agent task. Format: projects/{project}/locations/{location}/tasks/{task_id}
+            "stepSeqNum": "A String", # Optional. The `TaskServerEvent.seq_num` of the step that opened the rated agent task reply.
+            "taskName": "A String", # Optional. The full resource name of the Sobi task if the conversation was handled by a long-running agent task. Format (canonical, or the short alias the Task API also accepts): projects/{project}/locations/{location}/agents/{agent}/tasks/{task} projects/{project}/locations/{location}/tasks/{task}
+            "trajectoryId": "A String", # Optional. The runtime trajectory id of the rated agent task turn, as set on `TaskServerEvent.trajectory_id`. Shared by all steps of the turn.
           },
           "dataTermsAccepted": True or False, # Optional. Whether the customer accepted data use terms.
           "feedbackSource": "A String", # Optional. The UI component the user feedback comes from, which could be GOOGLE_CONSOLE, GOOGLE_WIDGET, GOOGLE_WEBAPP.
@@ -386,7 +388,9 @@ 
Method Details

       },
       "questionIndex": 42, # The index of the user input within the conversation messages.
       "session": "A String", # Name of the newly generated or continued session.
-      "taskName": "A String", # Optional. The full resource name of the Sobi task if the conversation was handled by a long-running agent task. Format: projects/{project}/locations/{location}/tasks/{task_id}
+      "stepSeqNum": "A String", # Optional. The `TaskServerEvent.seq_num` of the step that opened the rated agent task reply.
+      "taskName": "A String", # Optional. The full resource name of the Sobi task if the conversation was handled by a long-running agent task. Format (canonical, or the short alias the Task API also accepts): projects/{project}/locations/{location}/agents/{agent}/tasks/{task} projects/{project}/locations/{location}/tasks/{task}
+      "trajectoryId": "A String", # Optional. The runtime trajectory id of the rated agent task turn, as set on `TaskServerEvent.trajectory_id`. Shared by all steps of the turn.
     },
     "dataTermsAccepted": True or False, # Optional. Whether the customer accepted data use terms.
     "feedbackSource": "A String", # Optional. The UI component the user feedback comes from, which could be GOOGLE_CONSOLE, GOOGLE_WIDGET, GOOGLE_WEBAPP.
@@ -539,7 +543,9 @@ 
Method Details

       },
       "questionIndex": 42, # The index of the user input within the conversation messages.
       "session": "A String", # Name of the newly generated or continued session.
-      "taskName": "A String", # Optional. The full resource name of the Sobi task if the conversation was handled by a long-running agent task. Format: projects/{project}/locations/{location}/tasks/{task_id}
+      "stepSeqNum": "A String", # Optional. The `TaskServerEvent.seq_num` of the step that opened the rated agent task reply.
+      "taskName": "A String", # Optional. The full resource name of the Sobi task if the conversation was handled by a long-running agent task. Format (canonical, or the short alias the Task API also accepts): projects/{project}/locations/{location}/agents/{agent}/tasks/{task} projects/{project}/locations/{location}/tasks/{task}
+      "trajectoryId": "A String", # Optional. The runtime trajectory id of the rated agent task turn, as set on `TaskServerEvent.trajectory_id`. Shared by all steps of the turn.
     },
     "dataTermsAccepted": True or False, # Optional. Whether the customer accepted data use terms.
     "feedbackSource": "A String", # Optional. The UI component the user feedback comes from, which could be GOOGLE_CONSOLE, GOOGLE_WIDGET, GOOGLE_WEBAPP.
diff --git a/googleapiclient/discovery_cache/documents/discoveryengine.v1.json b/googleapiclient/discovery_cache/documents/discoveryengine.v1.json
index 965da06794..037c88c14a 100644
--- a/googleapiclient/discovery_cache/documents/discoveryengine.v1.json
+++ b/googleapiclient/discovery_cache/documents/discoveryengine.v1.json
@@ -9902,7 +9902,7 @@
 }
 }
 },
-"revision": "20261004",
+"revision": "20261013",
 "rootUrl": "https://discoveryengine.googleapis.com/",
 "schemas": {
 "A2aV1APIKeySecurityScheme": {
@@ -16203,6 +16203,13 @@
 "description": "Config for connecting to NotebookLM Enterprise.",
 "id": "GoogleCloudDiscoveryengineV1DataStoreFederatedSearchConfigNotebooklmConfig",
 "properties": {
+"notebooks": {
+"description": "Optional. Restricts this data store to the given notebooks. When empty, the data store covers every notebook the querying user can access, which is the existing behaviour. Each entry is a full notebook resource name, such as `projects/*/locations/*/notebooks/*`. Scoping is enforced on results as well as requested upstream, so a notebook outside this list cannot appear in a search response through this data store even if the backend returns one.",
+"items": {
+"type": "string"
+},
+"type": "array"
+},
 "searchConfig": {
 "description": "Required. Search config name. Format: projects/*/locations/global/notebookLmSearchConfigs/*",
 "type": "string"
@@ -16974,7 +16981,7 @@
 ],
 "type": "string"
 },
-"description": "Optional. Feature config for the engine to opt in or opt out of features. Supported keys: * `*`: all features, if it's present, all other feature state settings are ignored. * `agent-gallery` * `no-code-agent-builder` * `prompt-gallery` * `model-selector` * `notebook-lm` * `people-search` * `people-search-org-chart` * `bi-directional-audio` * `speech-to-text` * `feedback` * `session-sharing` * `personalization-memory` * `personalization-suggested-highlights` * `mobile-app-access` * `disable-agent-sharing` * `disable-image-generation` * `disable-video-generation` * `disable-onedrive-upload` * `disable-talk-to-content` * `disable-google-drive-upload` * `disable-welcome-emails` * `disable-canvas` * `canvas-workspace` * `canvas-app-builder` * `skills` * `skill-sharing` * `skill-sharing-without-admin-approval` * `disable-projects` * `sobi` * `enable-end-user-sharing-with-groups` * `single-agent-orchestration` * `multi-agent-orchestration` * `cross-product-intelligence` * `workflow-agents` * `in-app-notifications`",
+"description": "Optional. Feature config for the engine to opt in or opt out of features. Supported keys: * `*`: all features, if it's present, all other feature state settings are ignored. * `agent-gallery` * `no-code-agent-builder` * `prompt-gallery` * `model-selector` * `notebook-lm` * `people-search` * `people-search-org-chart` * `bi-directional-audio` * `speech-to-text` * `feedback` * `session-sharing` * `personalization-memory` * `personalization-suggested-highlights` * `mobile-app-access` * `disable-agent-sharing` * `disable-image-generation` * `disable-video-generation` * `disable-onedrive-upload` * `disable-talk-to-content` * `disable-google-drive-upload` * `disable-welcome-emails` * `disable-canvas` * `canvas-workspace` * `canvas-app-builder` * `skills` * `skill-sharing` * `skill-sharing-without-admin-approval` * `disable-projects` * `sobi` * `enable-end-user-sharing-with-groups` * `single-agent-orchestration` * `multi-agent-orchestration` * `cross-product-intelligence` * `workflow-agents` * `in-app-notifications` * `code-extraction`",
 "type": "object"
 },
 "industryVertical": {
@@ -17441,14 +17448,16 @@
 "GOOGLE_CONSOLE",
 "GOOGLE_WIDGET",
 "GOOGLE_WEBAPP",
-"GOOGLE_AGENTSPACE_MOBILE"
+"GOOGLE_AGENTSPACE_MOBILE",
+"GOOGLE_AGENTSPACE_DESKTOP"
 ],
 "enumDescriptions": [
 "Unspecified feedback source.",
 "Feedback source is Google Console.",
 "Feedback source is Google Widget.",
 "Feedback source is Google Webapp.",
-"Feedback source is Google AgentSpace Mobile app."
+"Feedback source is Google AgentSpace Mobile app.",
+"Feedback source is Google AgentSpace Desktop app."
 ],
 "type": "string"
 },
@@ -17529,8 +17538,17 @@
 "description": "Name of the newly generated or continued session.",
 "type": "string"
 },
+"stepSeqNum": {
+"description": "Optional. The `TaskServerEvent.seq_num` of the step that opened the rated agent task reply.",
+"format": "int64",
+"type": "string"
+},
 "taskName": {
-"description": "Optional. The full resource name of the Sobi task if the conversation was handled by a long-running agent task. Format: projects/{project}/locations/{location}/tasks/{task_id}",
+"description": "Optional. The full resource name of the Sobi task if the conversation was handled by a long-running agent task. Format (canonical, or the short alias the Task API also accepts): projects/{project}/locations/{location}/agents/{agent}/tasks/{task} projects/{project}/locations/{location}/tasks/{task}",
+"type": "string"
+},
+"trajectoryId": {
+"description": "Optional. The runtime trajectory id of the rated agent task turn, as set on `TaskServerEvent.trajectory_id`. Shared by all steps of the turn.",
 "type": "string"
 }
 },
@@ -18337,7 +18355,7 @@
 "The license config has expired.",
 "The license config has not started yet, and its start date is in the future.",
 "This is when a sub license config has returned all its seats back to BillingAccountLicenseConfig that it belongs to. Similar to EXPIRED.",
-"The license config is terminated earlier than the expiration date and it is deactivating. The customer will still have access in this state. It will be converted to EXPIRED after the deactivating period ends (14 days) or when the end date is reached, whichever comes first."
+"The license config is in a grace period. Its subscription has ended, either through early termination or by reaching its end date, but the customer keeps access for a limited time. It becomes EXPIRED when the grace period ends."
 ],
 "readOnly": true,
 "type": "string"
@@ -19839,7 +19857,7 @@
 "description": "Optional. Optional configuration for the Custom Ranking feature."
 },
 "dataStoreSpecs": {
-"description": "Specifications that define the specific DataStores to be searched, along with configurations for those data stores. This is only considered for Engines with multiple data stores. For engines with a single data store, the specs directly under SearchRequest should be used.",
+"description": "Specifications that define the specific DataStores to be searched, along with configurations for those data stores. This is only considered for Engines with multiple data stores. For engines with a single data store, the specs directly under SearchRequest should be used. On an engine with multiple data stores, this field is optional. If it's empty, all of the engine's data stores are searched (blended search). Unless it specifies exactly one data store, some request fields, such as `order_by` and `query_expansion_spec`, aren't supported and return an `INVALID_ARGUMENT` error.",
 "items": {
 "$ref": "GoogleCloudDiscoveryengineV1SearchRequestDataStoreSpec"
 },
@@ -23409,7 +23427,7 @@ false
 ],
 "type": "string"
 },
-"description": "Output only. Feature config for the engine to opt in or opt out of features. Supported keys: * `agent-gallery` * `no-code-agent-builder` * `prompt-gallery` * `model-selector` * `notebook-lm` * `people-search` * `people-search-org-chart` * `bi-directional-audio` * `speech-to-text` * `feedback` * `session-sharing` * `personalization-memory` * `personalization-suggested-highlights` * `mobile-app-access` * `disable-agent-sharing` * `disable-image-generation` * `disable-video-generation` * `disable-onedrive-upload` * `disable-talk-to-content` * `disable-google-drive-upload` * `disable-welcome-emails` * `disable-canvas` * `canvas-workspace` * `canvas-app-builder` * `skills` * `skill-sharing` * `skill-sharing-without-admin-approval` * `disable-projects` * `sobi` * `enable-end-user-sharing-with-groups` * `single-agent-orchestration` * `multi-agent-orchestration` * `cross-product-intelligence` * `workflow-agents` * `in-app-notifications`",
+"description": "Output only. Feature config for the engine to opt in or opt out of features. Supported keys: * `agent-gallery` * `no-code-agent-builder` * `prompt-gallery` * `model-selector` * `notebook-lm` * `people-search` * `people-search-org-chart` * `bi-directional-audio` * `speech-to-text` * `feedback` * `session-sharing` * `personalization-memory` * `personalization-suggested-highlights` * `mobile-app-access` * `disable-agent-sharing` * `disable-image-generation` * `disable-video-generation` * `disable-onedrive-upload` * `disable-talk-to-content` * `disable-google-drive-upload` * `disable-welcome-emails` * `disable-canvas` * `canvas-workspace` * `canvas-app-builder` * `skills` * `skill-sharing` * `skill-sharing-without-admin-approval` * `disable-projects` * `sobi` * `enable-end-user-sharing-with-groups` * `single-agent-orchestration` * `multi-agent-orchestration` * `cross-product-intelligence` * `workflow-agents` * `in-app-notifications` * `code-extraction`",
 "readOnly": true,
 "type": "object"
 },
@@ -27292,6 +27310,13 @@ false
 "description": "Config for connecting to NotebookLM Enterprise.",
 "id": "GoogleCloudDiscoveryengineV1alphaDataStoreFederatedSearchConfigNotebooklmConfig",
 "properties": {
+"notebooks": {
+"description": "Optional. Restricts this data store to the given notebooks. When empty, the data store covers every notebook the querying user can access, which is the existing behaviour. Each entry is a full notebook resource name, such as `projects/*/locations/*/notebooks/*`. Scoping is enforced on results as well as requested upstream, so a notebook outside this list cannot appear in a search response through this data store even if the backend returns one.",
+"items": {
+"type": "string"
+},
+"type": "array"
+},
 "searchConfig": {
 "description": "Required. Search config name. Format: projects/*/locations/global/notebookLmSearchConfigs/*",
 "type": "string"
@@ -27905,7 +27930,7 @@ false
 ],
 "type": "string"
 },
-"description": "Optional. Feature config for the engine to opt in or opt out of features. Supported keys: * `*`: all features, if it's present, all other feature state settings are ignored. * `agent-gallery` * `no-code-agent-builder` * `prompt-gallery` * `model-selector` * `notebook-lm` * `people-search` * `people-search-org-chart` * `bi-directional-audio` * `speech-to-text` * `feedback` * `session-sharing` * `personalization-memory` * `personalization-suggested-highlights` * `mobile-app-access` * `disable-agent-sharing` * `disable-image-generation` * `disable-video-generation` * `disable-onedrive-upload` * `disable-talk-to-content` * `disable-google-drive-upload` * `disable-welcome-emails` * `disable-canvas` * `canvas-workspace` * `canvas-app-builder` * `skills` * `skill-sharing` * `skill-sharing-without-admin-approval` * `disable-projects` * `sobi` * `enable-end-user-sharing-with-groups` * `single-agent-orchestration` * `multi-agent-orchestration` * `cross-product-intelligence` * `workflow-agents` * `in-app-notifications`",
+"description": "Optional. Feature config for the engine to opt in or opt out of features. Supported keys: * `*`: all features, if it's present, all other feature state settings are ignored. * `agent-gallery` * `no-code-agent-builder` * `prompt-gallery` * `model-selector` * `notebook-lm` * `people-search` * `people-search-org-chart` * `bi-directional-audio` * `speech-to-text` * `feedback` * `session-sharing` * `personalization-memory` * `personalization-suggested-highlights` * `mobile-app-access` * `disable-agent-sharing` * `disable-image-generation` * `disable-video-generation` * `disable-onedrive-upload` * `disable-talk-to-content` * `disable-google-drive-upload` * `disable-welcome-emails` * `disable-canvas` * `canvas-workspace` * `canvas-app-builder` * `skills` * `skill-sharing` * `skill-sharing-without-admin-approval` * `disable-projects` * `sobi` * `enable-end-user-sharing-with-groups` * `single-agent-orchestration` * `multi-agent-orchestration` * `cross-product-intelligence` * `workflow-agents` * `in-app-notifications` * `code-extraction`",
 "type": "object"
 },
 "industryVertical": {
@@ -28624,6 +28649,34 @@ false
 "description": "Optional. The metatag name found in the HTML page. If user defines this field, the value of this metatag name will be used to extract metatag. If the user does not define this field, the FieldConfig.field_path will be used to extract metatag.",
 "type": "string"
 },
+"partialMatchableOption": {
+"description": "Optional. If partial_matchable_option is PARTIAL_MATCHABLE_OPTION_ENABLED, field values are partial matchable. If partial_matchable_option is unset, the server behavior defaults to PARTIAL_MATCHABLE_OPTION_DISABLED for fields that support setting partial matchable options. For those fields that do not support setting partial matchable options, the server will skip partial matchable option setting, and setting partial_matchable_option for those fields will throw `INVALID_ARGUMENT` error.",
+"enum": [
+"PARTIAL_MATCHABLE_OPTION_UNSPECIFIED",
+"PARTIAL_MATCHABLE_OPTION_ENABLED",
+"PARTIAL_MATCHABLE_OPTION_DISABLED"
+],
+"enumDescriptions": [
+"Value used when unset.",
+"Partial Matchable option enabled.",
+"Partial Matchable option disabled."
+],
+"type": "string"
+},
+"prefixMatchableOption": {
+"description": "Optional. If prefix_matchable_option is PREFIX_MATCHABLE_OPTION_ENABLED, field values are prefix matchable. If prefix_matchable_option is unset, the server behavior defaults to PREFIX_MATCHABLE_OPTION_DISABLED for fields that support setting prefix matchable options. For those fields that do not support setting prefix matchable options, the server will skip prefix matchable option setting, and setting prefix_matchable_option for those fields will throw `INVALID_ARGUMENT` error.",
+"enum": [
+"PREFIX_MATCHABLE_OPTION_UNSPECIFIED",
+"PREFIX_MATCHABLE_OPTION_ENABLED",
+"PREFIX_MATCHABLE_OPTION_DISABLED"
+],
+"enumDescriptions": [
+"Value used when unset.",
+"Prefix Matchable option enabled.",
+"Prefix Matchable option disabled."
+],
+"type": "string"
+},
 "recsFilterableOption": {
 "description": "If recs_filterable_option is FILTERABLE_ENABLED, field values are filterable by filter expression in RecommendationService.Recommend. If FILTERABLE_ENABLED but the field type is numerical, field values are not filterable by text queries in RecommendationService.Recommend. Only textual fields are supported. If recs_filterable_option is unset, the default setting is FILTERABLE_DISABLED for fields that support setting filterable options. When a field set to [FILTERABLE_DISABLED] is filtered, a warning is generated and an empty result is returned.",
 "enum": [
@@ -29219,7 +29272,7 @@ false
 "The license config has expired.",
 "The license config has not started yet, and its start date is in the future.",
 "This is when a sub license config has returned all its seats back to BillingAccountLicenseConfig that it belongs to. Similar to EXPIRED.",
-"The license config is terminated earlier than the expiration date and it is deactivating. The customer will still have access in this state. It will be converted to EXPIRED after the deactivating period ends (14 days) or when the end date is reached, whichever comes first."
+"The license config is in a grace period. Its subscription has ended, either through early termination or by reaching its end date, but the customer keeps access for a limited time. It becomes EXPIRED when the grace period ends."
 ],
 "readOnly": true,
 "type": "string"
@@ -30549,7 +30602,7 @@ false
 "description": "Optional. Optional configuration for the Custom Ranking feature."
 },
 "dataStoreSpecs": {
-"description": "Specifications that define the specific DataStores to be searched, along with configurations for those data stores. This is only considered for Engines with multiple data stores. For engines with a single data store, the specs directly under SearchRequest should be used.",
+"description": "Specifications that define the specific DataStores to be searched, along with configurations for those data stores. This is only considered for Engines with multiple data stores. For engines with a single data store, the specs directly under SearchRequest should be used. On an engine with multiple data stores, this field is optional. If it's empty, all of the engine's data stores are searched (blended search). Unless it specifies exactly one data store, some request fields, such as `order_by` and `query_expansion_spec`, aren't supported and return an `INVALID_ARGUMENT` error.",
 "items": {
 "$ref": "GoogleCloudDiscoveryengineV1alphaSearchRequestDataStoreSpec"
 },
@@ -33174,6 +33227,13 @@ false
 "description": "Config for connecting to NotebookLM Enterprise.",
 "id": "GoogleCloudDiscoveryengineV1betaDataStoreFederatedSearchConfigNotebooklmConfig",
 "properties": {
+"notebooks": {
+"description": "Optional. Restricts this data store to the given notebooks. When empty, the data store covers every notebook the querying user can access, which is the existing behaviour. Each entry is a full notebook resource name, such as `projects/*/locations/*/notebooks/*`. Scoping is enforced on results as well as requested upstream, so a notebook outside this list cannot appear in a search response through this data store even if the backend returns one.",
+"items": {
+"type": "string"
+},
+"type": "array"
+},
 "searchConfig": {
 "description": "Required. Search config name. Format: projects/*/locations/global/notebookLmSearchConfigs/*",
 "type": "string"
@@ -33623,7 +33683,7 @@ false
 ],
 "type": "string"
 },
-"description": "Optional. Feature config for the engine to opt in or opt out of features. Supported keys: * `*`: all features, if it's present, all other feature state settings are ignored. * `agent-gallery` * `no-code-agent-builder` * `prompt-gallery` * `model-selector` * `notebook-lm` * `people-search` * `people-search-org-chart` * `bi-directional-audio` * `speech-to-text` * `feedback` * `session-sharing` * `personalization-memory` * `personalization-suggested-highlights` * `mobile-app-access` * `disable-agent-sharing` * `disable-image-generation` * `disable-video-generation` * `disable-onedrive-upload` * `disable-talk-to-content` * `disable-google-drive-upload` * `disable-welcome-emails` * `disable-canvas` * `canvas-workspace` * `canvas-app-builder` * `skills` * `skill-sharing` * `skill-sharing-without-admin-approval` * `disable-projects` * `sobi` * `enable-end-user-sharing-with-groups` * `single-agent-orchestration` * `multi-agent-orchestration` * `cross-product-intelligence` * `workflow-agents` * `in-app-notifications`",
+"description": "Optional. Feature config for the engine to opt in or opt out of features. Supported keys: * `*`: all features, if it's present, all other feature state settings are ignored. * `agent-gallery` * `no-code-agent-builder` * `prompt-gallery` * `model-selector` * `notebook-lm` * `people-search` * `people-search-org-chart` * `bi-directional-audio` * `speech-to-text` * `feedback` * `session-sharing` * `personalization-memory` * `personalization-suggested-highlights` * `mobile-app-access` * `disable-agent-sharing` * `disable-image-generation` * `disable-video-generation` * `disable-onedrive-upload` * `disable-talk-to-content` * `disable-google-drive-upload` * `disable-welcome-emails` * `disable-canvas` * `canvas-workspace` * `canvas-app-builder` * `skills` * `skill-sharing` * `skill-sharing-without-admin-approval` * `disable-projects` * `sobi` * `enable-end-user-sharing-with-groups` * `single-agent-orchestration` * `multi-agent-orchestration` * `cross-product-intelligence` * `workflow-agents` * `in-app-notifications` * `code-extraction`",
 "type": "object"
 },
 "industryVertical": {
@@ -34579,7 +34639,7 @@ false
 "The license config has expired.",
 "The license config has not started yet, and its start date is in the future.",
 "This is when a sub license config has returned all its seats back to BillingAccountLicenseConfig that it belongs to. Similar to EXPIRED.",
-"The license config is terminated earlier than the expiration date and it is deactivating. The customer will still have access in this state. It will be converted to EXPIRED after the deactivating period ends (14 days) or when the end date is reached, whichever comes first."
+"The license config is in a grace period. Its subscription has ended, either through early termination or by reaching its end date, but the customer keeps access for a limited time. It becomes EXPIRED when the grace period ends."
 ],
 "readOnly": true,
 "type": "string"
@@ -35296,7 +35356,7 @@ false
 "description": "Optional. Optional configuration for the Custom Ranking feature."
 },
 "dataStoreSpecs": {
-"description": "Specifications that define the specific DataStores to be searched, along with configurations for those data stores. This is only considered for Engines with multiple data stores. For engines with a single data store, the specs directly under SearchRequest should be used.",
+"description": "Specifications that define the specific DataStores to be searched, along with configurations for those data stores. This is only considered for Engines with multiple data stores. For engines with a single data store, the specs directly under SearchRequest should be used. On an engine with multiple data stores, this field is optional. If it's empty, all of the engine's data stores are searched (blended search). Unless it specifies exactly one data store, some request fields, such as `order_by` and `query_expansion_spec`, aren't supported and return an `INVALID_ARGUMENT` error.",
 "items": {
 "$ref": "GoogleCloudDiscoveryengineV1betaSearchRequestDataStoreSpec"
 },
diff --git a/googleapiclient/discovery_cache/documents/discoveryengine.v1alpha.json b/googleapiclient/discovery_cache/documents/discoveryengine.v1alpha.json
index ef0ee2568a..17e69eec15 100644
--- a/googleapiclient/discovery_cache/documents/discoveryengine.v1alpha.json
+++ b/googleapiclient/discovery_cache/documents/discoveryengine.v1alpha.json
@@ -6402,41 +6402,6 @@
 ]
 }
 }
-},
-"toolCalls": {
-"resources": {
-"operations": {
-"methods": {
-"get": {
-"description": "Gets the latest state of a long-running operation. Clients can use this method to poll the operation result at intervals as recommended by the API service.",
-"flatPath": "v1alpha/projects/{projectsId}/locations/{locationsId}/collections/{collectionsId}/engines/{enginesId}/assistants/{assistantsId}/agents/{agentsId}/toolCalls/{toolCallsId}/operations/{operationsId}",
-"httpMethod": "GET",
-"id": "discoveryengine.projects.locations.collections.engines.assistants.agents.toolCalls.operations.get",
-"parameterOrder": [
-"name"
-],
-"parameters": {
-"name": {
-"description": "The name of the operation resource.",
-"location": "path",
-"pattern": "^projects/[^/]+/locations/[^/]+/collections/[^/]+/engines/[^/]+/assistants/[^/]+/agents/[^/]+/toolCalls/[^/]+/operations/[^/]+$",
-"required": true,
-"type": "string"
-}
-},
-"path": "v1alpha/{+name}",
-"response": {
-"$ref": "GoogleLongrunningOperation"
-},
-"scopes": [
-"https://www.googleapis.com/auth/cloud-platform",
-"https://www.googleapis.com/auth/discoveryengine.readwrite",
-"https://www.googleapis.com/auth/discoveryengine.serving.readwrite"
-]
-}
-}
-}
-}
 }
 }
 },
@@ -6619,45 +6584,6 @@
 }
 }
 },
-"collaborativeProjects": {
-"resources": {
-"knowledgeSpaces": {
-"resources": {
-"operations": {
-"methods": {
-"get": {
-"description": "Gets the latest state of a long-running operation. Clients can use this method to poll the operation result at intervals as recommended by the API service.",
-"flatPath": "v1alpha/projects/{projectsId}/locations/{locationsId}/collections/{collectionsId}/engines/{enginesId}/collaborativeProjects/{collaborativeProjectsId}/knowledgeSpaces/{knowledgeSpacesId}/operations/{operationsId}",
-"httpMethod": "GET",
-"id": "discoveryengine.projects.locations.collections.engines.collaborativeProjects.knowledgeSpaces.operations.get",
-"parameterOrder": [
-"name"
-],
-"parameters": {
-"name": {
-"description": "The name of the operation resource.",
-"location": "path",
-"pattern": "^projects/[^/]+/locations/[^/]+/collections/[^/]+/engines/[^/]+/collaborativeProjects/[^/]+/knowledgeSpaces/[^/]+/operations/[^/]+$",
-"required": true,
-"type": "string"
-}
-},
-"path": "v1alpha/{+name}",
-"response": {
-"$ref": "GoogleLongrunningOperation"
-},
-"scopes": [
-"https://www.googleapis.com/auth/cloud-platform",
-"https://www.googleapis.com/auth/discoveryengine.readwrite",
-"https://www.googleapis.com/auth/discoveryengine.serving.readwrite"
-]
-}
-}
-}
-}
-}
-}
-},
 "completionConfig": {
 "methods": {
 "completeQuery": {
@@ -12164,6 +12090,41 @@
 }
 }
 },
+"knowledgeSpaces": {
+"resources": {
+"operations": {
+"methods": {
+"get": {
+"description": "Gets the latest state of a long-running operation. Clients can use this method to poll the operation result at intervals as recommended by the API service.",
+"flatPath": "v1alpha/projects/{projectsId}/locations/{locationsId}/knowledgeSpaces/{knowledgeSpacesId}/operations/{operationsId}",
+"httpMethod": "GET",
+"id": "discoveryengine.projects.locations.knowledgeSpaces.operations.get",
+"parameterOrder": [
+"name"
+],
+"parameters": {
+"name": {
+"description": "The name of the operation resource.",
+"location": "path",
+"pattern": "^projects/[^/]+/locations/[^/]+/knowledgeSpaces/[^/]+/operations/[^/]+$",
+"required": true,
+"type": "string"
+}
+},
+"path": "v1alpha/{+name}",
+"response": {
+"$ref": "GoogleLongrunningOperation"
+},
+"scopes": [
+"https://www.googleapis.com/auth/cloud-platform",
+"https://www.googleapis.com/auth/discoveryengine.readwrite",
+"https://www.googleapis.com/auth/discoveryengine.serving.readwrite"
+]
+}
+}
+}
+}
+},
 "licenseConfigs": {
 "methods": {
 "create": {
@@ -13692,7 +13653,7 @@
 }
 }
 },
-"revision": "20261004",
+"revision": "20261013",
 "rootUrl": "https://discoveryengine.googleapis.com/",
 "schemas": {
 "GoogleApiDistribution": {
@@ -16046,6 +16007,13 @@
 "description": "Config for connecting to NotebookLM Enterprise.",
 "id": "GoogleCloudDiscoveryengineV1DataStoreFederatedSearchConfigNotebooklmConfig",
 "properties": {
+"notebooks": {
+"description": "Optional. Restricts this data store to the given notebooks. When empty, the data store covers every notebook the querying user can access, which is the existing behaviour. Each entry is a full notebook resource name, such as `projects/*/locations/*/notebooks/*`. Scoping is enforced on results as well as requested upstream, so a notebook outside this list cannot appear in a search response through this data store even if the backend returns one.",
+"items": {
+"type": "string"
+},
+"type": "array"
+},
 "searchConfig": {
 "description": "Required. Search config name. Format: projects/*/locations/global/notebookLmSearchConfigs/*",
 "type": "string"
@@ -16575,7 +16543,7 @@
 ],
 "type": "string"
 },
-"description": "Optional. Feature config for the engine to opt in or opt out of features. Supported keys: * `*`: all features, if it's present, all other feature state settings are ignored. * `agent-gallery` * `no-code-agent-builder` * `prompt-gallery` * `model-selector` * `notebook-lm` * `people-search` * `people-search-org-chart` * `bi-directional-audio` * `speech-to-text` * `feedback` * `session-sharing` * `personalization-memory` * `personalization-suggested-highlights` * `mobile-app-access` * `disable-agent-sharing` * `disable-image-generation` * `disable-video-generation` * `disable-onedrive-upload` * `disable-talk-to-content` * `disable-google-drive-upload` * `disable-welcome-emails` * `disable-canvas` * `canvas-workspace` * `canvas-app-builder` * `skills` * `skill-sharing` * `skill-sharing-without-admin-approval` * `disable-projects` * `sobi` * `enable-end-user-sharing-with-groups` * `single-agent-orchestration` * `multi-agent-orchestration` * `cross-product-intelligence` * `workflow-agents` * `in-app-notifications`",
+"description": "Optional. Feature config for the engine to opt in or opt out of features. Supported keys: * `*`: all features, if it's present, all other feature state settings are ignored. * `agent-gallery` * `no-code-agent-builder` * `prompt-gallery` * `model-selector` * `notebook-lm` * `people-search` * `people-search-org-chart` * `bi-directional-audio` * `speech-to-text` * `feedback` * `session-sharing` * `personalization-memory` * `personalization-suggested-highlights` * `mobile-app-access` * `disable-agent-sharing` * `disable-image-generation` * `disable-video-generation` * `disable-onedrive-upload` * `disable-talk-to-content` * `disable-google-drive-upload` * `disable-welcome-emails` * `disable-canvas` * `canvas-workspace` * `canvas-app-builder` * `skills` * `skill-sharing` * `skill-sharing-without-admin-approval` * `disable-projects` * `sobi` * `enable-end-user-sharing-with-groups` * `single-agent-orchestration` * `multi-agent-orchestration` * `cross-product-intelligence` * `workflow-agents` * `in-app-notifications` * `code-extraction`",
 "type": "object"
 },
 "industryVertical": {
@@ -17354,7 +17322,7 @@
 "The license config has expired.",
 "The license config has not started yet, and its start date is in the future.",
 "This is when a sub license config has returned all its seats back to BillingAccountLicenseConfig that it belongs to. Similar to EXPIRED.",
-"The license config is terminated earlier than the expiration date and it is deactivating. The customer will still have access in this state. It will be converted to EXPIRED after the deactivating period ends (14 days) or when the end date is reached, whichever comes first."
+"The license config is in a grace period. Its subscription has ended, either through early termination or by reaching its end date, but the customer keeps access for a limited time. It becomes EXPIRED when the grace period ends."
 ],
 "readOnly": true,
 "type": "string"
@@ -22114,6 +22082,10 @@
 "description": "Optional. Whether to enable PKCE verification. https://datatracker.ietf.org/doc/html/rfc7636#section-3.1/",
 "type": "boolean"
 },
+"privateNetworkConfig": {
+"$ref": "GoogleCloudDiscoveryengineV1alphaAuthorizationServerSideOAuth2PrivateNetworkConfig",
+"description": "Optional. Set only when the OAuth provider publishes no public endpoint, in which case a token exchange has to be routed over the private network the instance is on instead of over public egress. Leaving it unset keeps the exchange on public egress."
+},
 "scopes": {
 "description": "Optional. The scopes to request. Example: `https://www.googleapis.com/auth/calendar.events` If omitted, no additional scopes are requested beyond those required by the authorization uri. If set, it will overwrite the scopes in the authorization uri when acquiring user authorization.",
 "items": {
@@ -22128,6 +22100,17 @@
 },
 "type": "object"
 },
+"GoogleCloudDiscoveryengineV1alphaAuthorizationServerSideOAuth2PrivateNetworkConfig": {
+"description": "Identifies the instance hosting an OAuth provider that is reachable only over a private network.",
+"id": "GoogleCloudDiscoveryengineV1alphaAuthorizationServerSideOAuth2PrivateNetworkConfig",
+"properties": {
+"instanceResource": {
+"description": "Required. Resource name of the instance hosting the OAuth provider. For Looker, the Looker instance, in the form `projects/{project}/locations/{location}/instances/{instance}`.",
+"type": "string"
+}
+},
+"type": "object"
+},
 "GoogleCloudDiscoveryengineV1alphaBAPConfig": {
 "description": "The configuration for the BAP connector.",
 "id": "GoogleCloudDiscoveryengineV1alphaBAPConfig",
@@ -22645,7 +22628,7 @@
 "The BillingAccountLicenseConfig is active and being used.",
 "The BillingAccountLicenseConfig has expired.",
 "The BillingAccountLicenseConfig has not started yet, and its start date is in the future.",
-"The license config is terminated earlier than the expiration date and it is deactivating. The customer will still have access in this state. It will be converted to EXPIRED after the deactivating period ends (14 days) or when the end date is reached, whichever comes first."
+"The BillingAccountLicenseConfig is in a grace period. Its subscription has ended, either through early termination or by reaching its end date, but the customer keeps access for a limited time. It becomes EXPIRED when the grace period ends."
 ],
 "readOnly": true,
 "type": "string"
@@ -25430,6 +25413,13 @@
 "description": "Config for connecting to NotebookLM Enterprise.",
 "id": "GoogleCloudDiscoveryengineV1alphaDataStoreFederatedSearchConfigNotebooklmConfig",
 "properties": {
+"notebooks": {
+"description": "Optional. Restricts this data store to the given notebooks. When empty, the data store covers every notebook the querying user can access, which is the existing behaviour. Each entry is a full notebook resource name, such as `projects/*/locations/*/notebooks/*`. Scoping is enforced on results as well as requested upstream, so a notebook outside this list cannot appear in a search response through this data store even if the backend returns one.",
+"items": {
+"type": "string"
+},
+"type": "array"
+},
 "searchConfig": {
 "description": "Required. Search config name. Format: projects/*/locations/global/notebookLmSearchConfigs/*",
 "type": "string"
@@ -26307,7 +26297,7 @@
 ],
 "type": "string"
 },
-"description": "Optional. Feature config for the engine to opt in or opt out of features. Supported keys: * `*`: all features, if it's present, all other feature state settings are ignored. * `agent-gallery` * `no-code-agent-builder` * `prompt-gallery` * `model-selector` * `notebook-lm` * `people-search` * `people-search-org-chart` * `bi-directional-audio` * `speech-to-text` * `feedback` * `session-sharing` * `personalization-memory` * `personalization-suggested-highlights` * `mobile-app-access` * `disable-agent-sharing` * `disable-image-generation` * `disable-video-generation` * `disable-onedrive-upload` * `disable-talk-to-content` * `disable-google-drive-upload` * `disable-welcome-emails` * `disable-canvas` * `canvas-workspace` * `canvas-app-builder` * `skills` * `skill-sharing` * `skill-sharing-without-admin-approval` * `disable-projects` * `sobi` * `enable-end-user-sharing-with-groups` * `single-agent-orchestration` * `multi-agent-orchestration` * `cross-product-intelligence` * `workflow-agents` * `in-app-notifications`",
+"description": "Optional. Feature config for the engine to opt in or opt out of features. Supported keys: * `*`: all features, if it's present, all other feature state settings are ignored. * `agent-gallery` * `no-code-agent-builder` * `prompt-gallery` * `model-selector` * `notebook-lm` * `people-search` * `people-search-org-chart` * `bi-directional-audio` * `speech-to-text` * `feedback` * `session-sharing` * `personalization-memory` * `personalization-suggested-highlights` * `mobile-app-access` * `disable-agent-sharing` * `disable-image-generation` * `disable-video-generation` * `disable-onedrive-upload` * `disable-talk-to-content` * `disable-google-drive-upload` * `disable-welcome-emails` * `disable-canvas` * `canvas-workspace` * `canvas-app-builder` * `skills` * `skill-sharing` * `skill-sharing-without-admin-approval` * `disable-projects` * `sobi` * `enable-end-user-sharing-with-groups` * `single-agent-orchestration` * `multi-agent-orchestration` * `cross-product-intelligence` * `workflow-agents` * `in-app-notifications` * `code-extraction`",
 "type": "object"
 },
 "industryVertical": {
@@ -27136,14 +27126,16 @@
 "GOOGLE_CONSOLE",
 "GOOGLE_WIDGET",
 "GOOGLE_WEBAPP",
-"GOOGLE_AGENTSPACE_MOBILE"
+"GOOGLE_AGENTSPACE_MOBILE",
+"GOOGLE_AGENTSPACE_DESKTOP"
 ],
 "enumDescriptions": [
 "Unspecified feedback source.",
 "Feedback source is Google Console.",
 "Feedback source is Google Widget.",
 "Feedback source is Google Webapp.",
-"Feedback source is Google AgentSpace Mobile app."
+"Feedback source is Google AgentSpace Mobile app.",
+"Feedback source is Google AgentSpace Desktop app."
 ],
 "type": "string"
 },
@@ -27224,8 +27216,17 @@
 "description": "Name of the newly generated or continued session.",
 "type": "string"
 },
+"stepSeqNum": {
+"description": "Optional. The `TaskServerEvent.seq_num` of the step that opened the rated agent task reply.",
+"format": "int64",
+"type": "string"
+},
 "taskName": {
-"description": "Optional. The full resource name of the Sobi task if the conversation was handled by a long-running agent task. Format: projects/{project}/locations/{location}/tasks/{task_id}",
+"description": "Optional. The full resource name of the Sobi task if the conversation was handled by a long-running agent task. Format (canonical, or the short alias the Task API also accepts): projects/{project}/locations/{location}/agents/{agent}/tasks/{task} projects/{project}/locations/{location}/tasks/{task}",
+"type": "string"
+},
+"trajectoryId": {
+"description": "Optional. The runtime trajectory id of the rated agent task turn, as set on `TaskServerEvent.trajectory_id`. Shared by all steps of the turn.",
 "type": "string"
 }
 },
@@ -27410,6 +27411,34 @@
 "description": "Optional. The metatag name found in the HTML page. If user defines this field, the value of this metatag name will be used to extract metatag. If the user does not define this field, the FieldConfig.field_path will be used to extract metatag.",
 "type": "string"
 },
+"partialMatchableOption": {
+"description": "Optional. If partial_matchable_option is PARTIAL_MATCHABLE_OPTION_ENABLED, field values are partial matchable. If partial_matchable_option is unset, the server behavior defaults to PARTIAL_MATCHABLE_OPTION_DISABLED for fields that support setting partial matchable options. For those fields that do not support setting partial matchable options, the server will skip partial matchable option setting, and setting partial_matchable_option for those fields will throw `INVALID_ARGUMENT` error.",
+"enum": [
+"PARTIAL_MATCHABLE_OPTION_UNSPECIFIED",
+"PARTIAL_MATCHABLE_OPTION_ENABLED",
+"PARTIAL_MATCHABLE_OPTION_DISABLED"
+],
+"enumDescriptions": [
+"Value used when unset.",
+"Partial Matchable option enabled.",
+"Partial Matchable option disabled."
+],
+"type": "string"
+},
+"prefixMatchableOption": {
+"description": "Optional. If prefix_matchable_option is PREFIX_MATCHABLE_OPTION_ENABLED, field values are prefix matchable. If prefix_matchable_option is unset, the server behavior defaults to PREFIX_MATCHABLE_OPTION_DISABLED for fields that support setting prefix matchable options. For those fields that do not support setting prefix matchable options, the server will skip prefix matchable option setting, and setting prefix_matchable_option for those fields will throw `INVALID_ARGUMENT` error.",
+"enum": [
+"PREFIX_MATCHABLE_OPTION_UNSPECIFIED",
+"PREFIX_MATCHABLE_OPTION_ENABLED",
+"PREFIX_MATCHABLE_OPTION_DISABLED"
+],
+"enumDescriptions": [
+"Value used when unset.",
+"Prefix Matchable option enabled.",
+"Prefix Matchable option disabled."
+],
+"type": "string"
+},
 "recsFilterableOption": {
 "description": "If recs_filterable_option is FILTERABLE_ENABLED, field values are filterable by filter expression in RecommendationService.Recommend. If FILTERABLE_ENABLED but the field type is numerical, field values are not filterable by text queries in RecommendationService.Recommend. Only textual fields are supported. If recs_filterable_option is unset, the default setting is FILTERABLE_DISABLED for fields that support setting filterable options. When a field set to [FILTERABLE_DISABLED] is filtered, a warning is generated and an empty result is returned.",
 "enum": [
@@ -28697,7 +28726,7 @@
 "The license config has expired.",
 "The license config has not started yet, and its start date is in the future.",
 "This is when a sub license config has returned all its seats back to BillingAccountLicenseConfig that it belongs to. Similar to EXPIRED.",
-"The license config is terminated earlier than the expiration date and it is deactivating. The customer will still have access in this state. It will be converted to EXPIRED after the deactivating period ends (14 days) or when the end date is reached, whichever comes first."
+"The license config is in a grace period. Its subscription has ended, either through early termination or by reaching its end date, but the customer keeps access for a limited time. It becomes EXPIRED when the grace period ends."
 ],
 "readOnly": true,
 "type": "string"
@@ -31595,7 +31624,7 @@
 "description": "Optional. Optional configuration for the Custom Ranking feature."
 },
 "dataStoreSpecs": {
-"description": "Specifications that define the specific DataStores to be searched, along with configurations for those data stores. This is only considered for Engines with multiple data stores. For engines with a single data store, the specs directly under SearchRequest should be used.",
+"description": "Specifications that define the specific DataStores to be searched, along with configurations for those data stores. This is only considered for Engines with multiple data stores. For engines with a single data store, the specs directly under SearchRequest should be used. On an engine with multiple data stores, this field is optional. If it's empty, all of the engine's data stores are searched (blended search). Unless it specifies exactly one data store, some request fields, such as `order_by` and `query_expansion_spec`, aren't supported and return an `INVALID_ARGUMENT` error.",
 "items": {
 "$ref": "GoogleCloudDiscoveryengineV1alphaSearchRequestDataStoreSpec"
 },
@@ -35850,7 +35879,7 @@ false
 ],
 "type": "string"
 },
-"description": "Output only. Feature config for the engine to opt in or opt out of features. Supported keys: * `agent-gallery` * `no-code-agent-builder` * `prompt-gallery` * `model-selector` * `notebook-lm` * `people-search` * `people-search-org-chart` * `bi-directional-audio` * `speech-to-text` * `feedback` * `session-sharing` * `personalization-memory` * `personalization-suggested-highlights` * `mobile-app-access` * `disable-agent-sharing` * `disable-image-generation` * `disable-video-generation` * `disable-onedrive-upload` * `disable-talk-to-content` * `disable-google-drive-upload` * `disable-welcome-emails` * `disable-canvas` * `canvas-workspace` * `canvas-app-builder` * `skills` * `skill-sharing` * `skill-sharing-without-admin-approval` * `disable-projects` * `sobi` * `enable-end-user-sharing-with-groups` * `single-agent-orchestration` * `multi-agent-orchestration` * `cross-product-intelligence` * `workflow-agents` * `in-app-notifications`",
+"description": "Output only. Feature config for the engine to opt in or opt out of features. Supported keys: * `agent-gallery` * `no-code-agent-builder` * `prompt-gallery` * `model-selector` * `notebook-lm` * `people-search` * `people-search-org-chart` * `bi-directional-audio` * `speech-to-text` * `feedback` * `session-sharing` * `personalization-memory` * `personalization-suggested-highlights` * `mobile-app-access` * `disable-agent-sharing` * `disable-image-generation` * `disable-video-generation` * `disable-onedrive-upload` * `disable-talk-to-content` * `disable-google-drive-upload` * `disable-welcome-emails` * `disable-canvas` * `canvas-workspace` * `canvas-app-builder` * `skills` * `skill-sharing` * `skill-sharing-without-admin-approval` * `disable-projects` * `sobi` * `enable-end-user-sharing-with-groups` * `single-agent-orchestration` * `multi-agent-orchestration` * `cross-product-intelligence` * `workflow-agents` * `in-app-notifications` * `code-extraction`",
 "readOnly": true,
 "type": "object"
 },
@@ -37113,6 +37142,13 @@ false
 "description": "Config for connecting to NotebookLM Enterprise.",
 "id": "GoogleCloudDiscoveryengineV1betaDataStoreFederatedSearchConfigNotebooklmConfig",
 "properties": {
+"notebooks": {
+"description": "Optional. Restricts this data store to the given notebooks. When empty, the data store covers every notebook the querying user can access, which is the existing behaviour. Each entry is a full notebook resource name, such as `projects/*/locations/*/notebooks/*`. Scoping is enforced on results as well as requested upstream, so a notebook outside this list cannot appear in a search response through this data store even if the backend returns one.",
+"items": {
+"type": "string"
+},
+"type": "array"
+},
 "searchConfig": {
 "description": "Required. Search config name. Format: projects/*/locations/global/notebookLmSearchConfigs/*",
 "type": "string"
@@ -37562,7 +37598,7 @@ false
 ],
 "type": "string"
 },
-"description": "Optional. Feature config for the engine to opt in or opt out of features. Supported keys: * `*`: all features, if it's present, all other feature state settings are ignored. * `agent-gallery` * `no-code-agent-builder` * `prompt-gallery` * `model-selector` * `notebook-lm` * `people-search` * `people-search-org-chart` * `bi-directional-audio` * `speech-to-text` * `feedback` * `session-sharing` * `personalization-memory` * `personalization-suggested-highlights` * `mobile-app-access` * `disable-agent-sharing` * `disable-image-generation` * `disable-video-generation` * `disable-onedrive-upload` * `disable-talk-to-content` * `disable-google-drive-upload` * `disable-welcome-emails` * `disable-canvas` * `canvas-workspace` * `canvas-app-builder` * `skills` * `skill-sharing` * `skill-sharing-without-admin-approval` * `disable-projects` * `sobi` * `enable-end-user-sharing-with-groups` * `single-agent-orchestration` * `multi-agent-orchestration` * `cross-product-intelligence` * `workflow-agents` * `in-app-notifications`",
+"description": "Optional. Feature config for the engine to opt in or opt out of features. Supported keys: * `*`: all features, if it's present, all other feature state settings are ignored. * `agent-gallery` * `no-code-agent-builder` * `prompt-gallery` * `model-selector` * `notebook-lm` * `people-search` * `people-search-org-chart` * `bi-directional-audio` * `speech-to-text` * `feedback` * `session-sharing` * `personalization-memory` * `personalization-suggested-highlights` * `mobile-app-access` * `disable-agent-sharing` * `disable-image-generation` * `disable-video-generation` * `disable-onedrive-upload` * `disable-talk-to-content` * `disable-google-drive-upload` * `disable-welcome-emails` * `disable-canvas` * `canvas-workspace` * `canvas-app-builder` * `skills` * `skill-sharing` * `skill-sharing-without-admin-approval` * `disable-projects` * `sobi` * `enable-end-user-sharing-with-groups` * `single-agent-orchestration` * `multi-agent-orchestration` * `cross-product-intelligence` * `workflow-agents` * `in-app-notifications` * `code-extraction`",
 "type": "object"
 },
 "industryVertical": {
@@ -38518,7 +38554,7 @@ false
 "The license config has expired.",
 "The license config has not started yet, and its start date is in the future.",
 "This is when a sub license config has returned all its seats back to BillingAccountLicenseConfig that it belongs to. Similar to EXPIRED.",
-"The license config is terminated earlier than the expiration date and it is deactivating. The customer will still have access in this state. It will be converted to EXPIRED after the deactivating period ends (14 days) or when the end date is reached, whichever comes first."
+"The license config is in a grace period. Its subscription has ended, either through early termination or by reaching its end date, but the customer keeps access for a limited time. It becomes EXPIRED when the grace period ends."
 ],
 "readOnly": true,
 "type": "string"
@@ -39235,7 +39271,7 @@ false
 "description": "Optional. Optional configuration for the Custom Ranking feature."
 },
 "dataStoreSpecs": {
-"description": "Specifications that define the specific DataStores to be searched, along with configurations for those data stores. This is only considered for Engines with multiple data stores. For engines with a single data store, the specs directly under SearchRequest should be used.",
+"description": "Specifications that define the specific DataStores to be searched, along with configurations for those data stores. This is only considered for Engines with multiple data stores. For engines with a single data store, the specs directly under SearchRequest should be used. On an engine with multiple data stores, this field is optional. If it's empty, all of the engine's data stores are searched (blended search). Unless it specifies exactly one data store, some request fields, such as `order_by` and `query_expansion_spec`, aren't supported and return an `INVALID_ARGUMENT` error.",
 "items": {
 "$ref": "GoogleCloudDiscoveryengineV1betaSearchRequestDataStoreSpec"
 },
diff --git a/googleapiclient/discovery_cache/documents/discoveryengine.v1beta.json b/googleapiclient/discovery_cache/documents/discoveryengine.v1beta.json
index 9c741581db..5891f2e53a 100644
--- a/googleapiclient/discovery_cache/documents/discoveryengine.v1beta.json
+++ b/googleapiclient/discovery_cache/documents/discoveryengine.v1beta.json
@@ -9645,7 +9645,7 @@
 }
 }
 },
-"revision": "20261004",
+"revision": "20261013",
 "rootUrl": "https://discoveryengine.googleapis.com/",
 "schemas": {
 "GoogleApiDistribution": {
@@ -11999,6 +11999,13 @@
 "description": "Config for connecting to NotebookLM Enterprise.",
 "id": "GoogleCloudDiscoveryengineV1DataStoreFederatedSearchConfigNotebooklmConfig",
 "properties": {
+"notebooks": {
+"description": "Optional. Restricts this data store to the given notebooks. When empty, the data store covers every notebook the querying user can access, which is the existing behaviour. Each entry is a full notebook resource name, such as `projects/*/locations/*/notebooks/*`. Scoping is enforced on results as well as requested upstream, so a notebook outside this list cannot appear in a search response through this data store even if the backend returns one.",
+"items": {
+"type": "string"
+},
+"type": "array"
+},
 "searchConfig": {
 "description": "Required. Search config name. Format: projects/*/locations/global/notebookLmSearchConfigs/*",
 "type": "string"
@@ -12528,7 +12535,7 @@
 ],
 "type": "string"
 },
-"description": "Optional. Feature config for the engine to opt in or opt out of features. Supported keys: * `*`: all features, if it's present, all other feature state settings are ignored. * `agent-gallery` * `no-code-agent-builder` * `prompt-gallery` * `model-selector` * `notebook-lm` * `people-search` * `people-search-org-chart` * `bi-directional-audio` * `speech-to-text` * `feedback` * `session-sharing` * `personalization-memory` * `personalization-suggested-highlights` * `mobile-app-access` * `disable-agent-sharing` * `disable-image-generation` * `disable-video-generation` * `disable-onedrive-upload` * `disable-talk-to-content` * `disable-google-drive-upload` * `disable-welcome-emails` * `disable-canvas` * `canvas-workspace` * `canvas-app-builder` * `skills` * `skill-sharing` * `skill-sharing-without-admin-approval` * `disable-projects` * `sobi` * `enable-end-user-sharing-with-groups` * `single-agent-orchestration` * `multi-agent-orchestration` * `cross-product-intelligence` * `workflow-agents` * `in-app-notifications`",
+"description": "Optional. Feature config for the engine to opt in or opt out of features. Supported keys: * `*`: all features, if it's present, all other feature state settings are ignored. * `agent-gallery` * `no-code-agent-builder` * `prompt-gallery` * `model-selector` * `notebook-lm` * `people-search` * `people-search-org-chart` * `bi-directional-audio` * `speech-to-text` * `feedback` * `session-sharing` * `personalization-memory` * `personalization-suggested-highlights` * `mobile-app-access` * `disable-agent-sharing` * `disable-image-generation` * `disable-video-generation` * `disable-onedrive-upload` * `disable-talk-to-content` * `disable-google-drive-upload` * `disable-welcome-emails` * `disable-canvas` * `canvas-workspace` * `canvas-app-builder` * `skills` * `skill-sharing` * `skill-sharing-without-admin-approval` * `disable-projects` * `sobi` * `enable-end-user-sharing-with-groups` * `single-agent-orchestration` * `multi-agent-orchestration` * `cross-product-intelligence` * `workflow-agents` * `in-app-notifications` * `code-extraction`",
 "type": "object"
 },
 "industryVertical": {
@@ -13307,7 +13314,7 @@
 "The license config has expired.",
 "The license config has not started yet, and its start date is in the future.",
 "This is when a sub license config has returned all its seats back to BillingAccountLicenseConfig that it belongs to. Similar to EXPIRED.",
-"The license config is terminated earlier than the expiration date and it is deactivating. The customer will still have access in this state. It will be converted to EXPIRED after the deactivating period ends (14 days) or when the end date is reached, whichever comes first."
+"The license config is in a grace period. Its subscription has ended, either through early termination or by reaching its end date, but the customer keeps access for a limited time. It becomes EXPIRED when the grace period ends."
 ],
 "readOnly": true,
 "type": "string"
@@ -18264,6 +18271,13 @@
 "description": "Config for connecting to NotebookLM Enterprise.",
 "id": "GoogleCloudDiscoveryengineV1alphaDataStoreFederatedSearchConfigNotebooklmConfig",
 "properties": {
+"notebooks": {
+"description": "Optional. Restricts this data store to the given notebooks. When empty, the data store covers every notebook the querying user can access, which is the existing behaviour. Each entry is a full notebook resource name, such as `projects/*/locations/*/notebooks/*`. Scoping is enforced on results as well as requested upstream, so a notebook outside this list cannot appear in a search response through this data store even if the backend returns one.",
+"items": {
+"type": "string"
+},
+"type": "array"
+},
 "searchConfig": {
 "description": "Required. Search config name. Format: projects/*/locations/global/notebookLmSearchConfigs/*",
 "type": "string"
@@ -18877,7 +18891,7 @@
 ],
 "type": "string"
 },
-"description": "Optional. Feature config for the engine to opt in or opt out of features. Supported keys: * `*`: all features, if it's present, all other feature state settings are ignored. * `agent-gallery` * `no-code-agent-builder` * `prompt-gallery` * `model-selector` * `notebook-lm` * `people-search` * `people-search-org-chart` * `bi-directional-audio` * `speech-to-text` * `feedback` * `session-sharing` * `personalization-memory` * `personalization-suggested-highlights` * `mobile-app-access` * `disable-agent-sharing` * `disable-image-generation` * `disable-video-generation` * `disable-onedrive-upload` * `disable-talk-to-content` * `disable-google-drive-upload` * `disable-welcome-emails` * `disable-canvas` * `canvas-workspace` * `canvas-app-builder` * `skills` * `skill-sharing` * `skill-sharing-without-admin-approval` * `disable-projects` * `sobi` * `enable-end-user-sharing-with-groups` * `single-agent-orchestration` * `multi-agent-orchestration` * `cross-product-intelligence` * `workflow-agents` * `in-app-notifications`",
+"description": "Optional. Feature config for the engine to opt in or opt out of features. Supported keys: * `*`: all features, if it's present, all other feature state settings are ignored. * `agent-gallery` * `no-code-agent-builder` * `prompt-gallery` * `model-selector` * `notebook-lm` * `people-search` * `people-search-org-chart` * `bi-directional-audio` * `speech-to-text` * `feedback` * `session-sharing` * `personalization-memory` * `personalization-suggested-highlights` * `mobile-app-access` * `disable-agent-sharing` * `disable-image-generation` * `disable-video-generation` * `disable-onedrive-upload` * `disable-talk-to-content` * `disable-google-drive-upload` * `disable-welcome-emails` * `disable-canvas` * `canvas-workspace` * `canvas-app-builder` * `skills` * `skill-sharing` * `skill-sharing-without-admin-approval` * `disable-projects` * `sobi` * `enable-end-user-sharing-with-groups` * `single-agent-orchestration` * `multi-agent-orchestration` * `cross-product-intelligence` * `workflow-agents` * `in-app-notifications` * `code-extraction`",
 "type": "object"
 },
 "industryVertical": {
@@ -19596,6 +19610,34 @@
 "description": "Optional. The metatag name found in the HTML page. If user defines this field, the value of this metatag name will be used to extract metatag. If the user does not define this field, the FieldConfig.field_path will be used to extract metatag.",
 "type": "string"
 },
+"partialMatchableOption": {
+"description": "Optional. If partial_matchable_option is PARTIAL_MATCHABLE_OPTION_ENABLED, field values are partial matchable. If partial_matchable_option is unset, the server behavior defaults to PARTIAL_MATCHABLE_OPTION_DISABLED for fields that support setting partial matchable options. For those fields that do not support setting partial matchable options, the server will skip partial matchable option setting, and setting partial_matchable_option for those fields will throw `INVALID_ARGUMENT` error.",
+"enum": [
+"PARTIAL_MATCHABLE_OPTION_UNSPECIFIED",
+"PARTIAL_MATCHABLE_OPTION_ENABLED",
+"PARTIAL_MATCHABLE_OPTION_DISABLED"
+],
+"enumDescriptions": [
+"Value used when unset.",
+"Partial Matchable option enabled.",
+"Partial Matchable option disabled."
+],
+"type": "string"
+},
+"prefixMatchableOption": {
+"description": "Optional. If prefix_matchable_option is PREFIX_MATCHABLE_OPTION_ENABLED, field values are prefix matchable. If prefix_matchable_option is unset, the server behavior defaults to PREFIX_MATCHABLE_OPTION_DISABLED for fields that support setting prefix matchable options. For those fields that do not support setting prefix matchable options, the server will skip prefix matchable option setting, and setting prefix_matchable_option for those fields will throw `INVALID_ARGUMENT` error.",
+"enum": [
+"PREFIX_MATCHABLE_OPTION_UNSPECIFIED",
+"PREFIX_MATCHABLE_OPTION_ENABLED",
+"PREFIX_MATCHABLE_OPTION_DISABLED"
+],
+"enumDescriptions": [
+"Value used when unset.",
+"Prefix Matchable option enabled.",
+"Prefix Matchable option disabled."
+],
+"type": "string"
+},
 "recsFilterableOption": {
 "description": "If recs_filterable_option is FILTERABLE_ENABLED, field values are filterable by filter expression in RecommendationService.Recommend. If FILTERABLE_ENABLED but the field type is numerical, field values are not filterable by text queries in RecommendationService.Recommend. Only textual fields are supported. If recs_filterable_option is unset, the default setting is FILTERABLE_DISABLED for fields that support setting filterable options. When a field set to [FILTERABLE_DISABLED] is filtered, a warning is generated and an empty result is returned.",
 "enum": [
@@ -20191,7 +20233,7 @@
 "The license config has expired.",
 "The license config has not started yet, and its start date is in the future.",
 "This is when a sub license config has returned all its seats back to BillingAccountLicenseConfig that it belongs to. Similar to EXPIRED.",
-"The license config is terminated earlier than the expiration date and it is deactivating. The customer will still have access in this state. It will be converted to EXPIRED after the deactivating period ends (14 days) or when the end date is reached, whichever comes first."
+"The license config is in a grace period. Its subscription has ended, either through early termination or by reaching its end date, but the customer keeps access for a limited time. It becomes EXPIRED when the grace period ends."
 ],
 "readOnly": true,
 "type": "string"
@@ -21521,7 +21563,7 @@
 "description": "Optional. Optional configuration for the Custom Ranking feature."
 },
 "dataStoreSpecs": {
-"description": "Specifications that define the specific DataStores to be searched, along with configurations for those data stores. This is only considered for Engines with multiple data stores. For engines with a single data store, the specs directly under SearchRequest should be used.",
+"description": "Specifications that define the specific DataStores to be searched, along with configurations for those data stores. This is only considered for Engines with multiple data stores. For engines with a single data store, the specs directly under SearchRequest should be used. On an engine with multiple data stores, this field is optional. If it's empty, all of the engine's data stores are searched (blended search). Unless it specifies exactly one data store, some request fields, such as `order_by` and `query_expansion_spec`, aren't supported and return an `INVALID_ARGUMENT` error.",
 "items": {
 "$ref": "GoogleCloudDiscoveryengineV1alphaSearchRequestDataStoreSpec"
 },
@@ -27516,6 +27558,13 @@ false
 "description": "Config for connecting to NotebookLM Enterprise.",
 "id": "GoogleCloudDiscoveryengineV1betaDataStoreFederatedSearchConfigNotebooklmConfig",
 "properties": {
+"notebooks": {
+"description": "Optional. Restricts this data store to the given notebooks. When empty, the data store covers every notebook the querying user can access, which is the existing behaviour. Each entry is a full notebook resource name, such as `projects/*/locations/*/notebooks/*`. Scoping is enforced on results as well as requested upstream, so a notebook outside this list cannot appear in a search response through this data store even if the backend returns one.",
+"items": {
+"type": "string"
+},
+"type": "array"
+},
 "searchConfig": {
 "description": "Required. Search config name. Format: projects/*/locations/global/notebookLmSearchConfigs/*",
 "type": "string"
@@ -28218,7 +28267,7 @@ false
 ],
 "type": "string"
 },
-"description": "Optional. Feature config for the engine to opt in or opt out of features. Supported keys: * `*`: all features, if it's present, all other feature state settings are ignored. * `agent-gallery` * `no-code-agent-builder` * `prompt-gallery` * `model-selector` * `notebook-lm` * `people-search` * `people-search-org-chart` * `bi-directional-audio` * `speech-to-text` * `feedback` * `session-sharing` * `personalization-memory` * `personalization-suggested-highlights` * `mobile-app-access` * `disable-agent-sharing` * `disable-image-generation` * `disable-video-generation` * `disable-onedrive-upload` * `disable-talk-to-content` * `disable-google-drive-upload` * `disable-welcome-emails` * `disable-canvas` * `canvas-workspace` * `canvas-app-builder` * `skills` * `skill-sharing` * `skill-sharing-without-admin-approval` * `disable-projects` * `sobi` * `enable-end-user-sharing-with-groups` * `single-agent-orchestration` * `multi-agent-orchestration` * `cross-product-intelligence` * `workflow-agents` * `in-app-notifications`",
+"description": "Optional. Feature config for the engine to opt in or opt out of features. Supported keys: * `*`: all features, if it's present, all other feature state settings are ignored. * `agent-gallery` * `no-code-agent-builder` * `prompt-gallery` * `model-selector` * `notebook-lm` * `people-search` * `people-search-org-chart` * `bi-directional-audio` * `speech-to-text` * `feedback` * `session-sharing` * `personalization-memory` * `personalization-suggested-highlights` * `mobile-app-access` * `disable-agent-sharing` * `disable-image-generation` * `disable-video-generation` * `disable-onedrive-upload` * `disable-talk-to-content` * `disable-google-drive-upload` * `disable-welcome-emails` * `disable-canvas` * `canvas-workspace` * `canvas-app-builder` * `skills` * `skill-sharing` * `skill-sharing-without-admin-approval` * `disable-projects` * `sobi` * `enable-end-user-sharing-with-groups` * `single-agent-orchestration` * `multi-agent-orchestration` * `cross-product-intelligence` * `workflow-agents` * `in-app-notifications` * `code-extraction`",
 "type": "object"
 },
 "industryVertical": {
@@ -28775,14 +28824,16 @@ false
 "GOOGLE_CONSOLE",
 "GOOGLE_WIDGET",
 "GOOGLE_WEBAPP",
-"GOOGLE_AGENTSPACE_MOBILE"
+"GOOGLE_AGENTSPACE_MOBILE",
+"GOOGLE_AGENTSPACE_DESKTOP"
 ],
 "enumDescriptions": [
 "Unspecified feedback source.",
 "Feedback source is Google Console.",
 "Feedback source is Google Widget.",
 "Feedback source is Google Webapp.",
-"Feedback source is Google AgentSpace Mobile app."
+"Feedback source is Google AgentSpace Mobile app.",
+"Feedback source is Google AgentSpace Desktop app."
 ],
 "type": "string"
 },
@@ -28863,8 +28914,17 @@ false
 "description": "Name of the newly generated or continued session.",
 "type": "string"
 },
+"stepSeqNum": {
+"description": "Optional. The `TaskServerEvent.seq_num` of the step that opened the rated agent task reply.",
+"format": "int64",
+"type": "string"
+},
 "taskName": {
-"description": "Optional. The full resource name of the Sobi task if the conversation was handled by a long-running agent task. Format: projects/{project}/locations/{location}/tasks/{task_id}",
+"description": "Optional. The full resource name of the Sobi task if the conversation was handled by a long-running agent task. Format (canonical, or the short alias the Task API also accepts): projects/{project}/locations/{location}/agents/{agent}/tasks/{task} projects/{project}/locations/{location}/tasks/{task}",
+"type": "string"
+},
+"trajectoryId": {
+"description": "Optional. The runtime trajectory id of the rated agent task turn, as set on `TaskServerEvent.trajectory_id`. Shared by all steps of the turn.",
 "type": "string"
 }
 },
@@ -29768,7 +29828,7 @@ false
 "The license config has expired.",
 "The license config has not started yet, and its start date is in the future.",
 "This is when a sub license config has returned all its seats back to BillingAccountLicenseConfig that it belongs to. Similar to EXPIRED.",
-"The license config is terminated earlier than the expiration date and it is deactivating. The customer will still have access in this state. It will be converted to EXPIRED after the deactivating period ends (14 days) or when the end date is reached, whichever comes first."
+"The license config is in a grace period. Its subscription has ended, either through early termination or by reaching its end date, but the customer keeps access for a limited time. It becomes EXPIRED when the grace period ends."
 ],
 "readOnly": true,
 "type": "string"
@@ -31665,7 +31725,7 @@ false
 "description": "Optional. Optional configuration for the Custom Ranking feature."
 },
 "dataStoreSpecs": {
-"description": "Specifications that define the specific DataStores to be searched, along with configurations for those data stores. This is only considered for Engines with multiple data stores. For engines with a single data store, the specs directly under SearchRequest should be used.",
+"description": "Specifications that define the specific DataStores to be searched, along with configurations for those data stores. This is only considered for Engines with multiple data stores. For engines with a single data store, the specs directly under SearchRequest should be used. On an engine with multiple data stores, this field is optional. If it's empty, all of the engine's data stores are searched (blended search). Unless it specifies exactly one data store, some request fields, such as `order_by` and `query_expansion_spec`, aren't supported and return an `INVALID_ARGUMENT` error.",
 "items": {
 "$ref": "GoogleCloudDiscoveryengineV1betaSearchRequestDataStoreSpec"
 },

From 1a9f01658957c7dfc5f1e1dfa1fe95a346991089 Mon Sep 17 00:00:00 2001
From: Yoshi Automation 
Date: Tue, 20 Oct 2026 07:24:01 +0000
Subject: [PATCH 17/34] feat(drive): update the api

#### drive:v3

The following keys were deleted:
- schemas.Approval.properties.completeTime.readOnly (Total Keys: 1)
- schemas.Approval.properties.createTime.readOnly (Total Keys: 1)
- schemas.Approval.properties.fileContentChangeBehavior.readOnly (Total Keys: 1)
- schemas.Approval.properties.modifyTime.readOnly (Total Keys: 1)
- schemas.Approval.properties.status.readOnly (Total Keys: 1)
---
 docs/dyn/drive_v3.approvals.html              | 80 +++++++++----------
 .../discovery_cache/documents/drive.v3.json   | 17 ++--
 2 files changed, 46 insertions(+), 51 deletions(-)

diff --git a/docs/dyn/drive_v3.approvals.html b/docs/dyn/drive_v3.approvals.html
index 1526332682..83702c099f 100644
--- a/docs/dyn/drive_v3.approvals.html
+++ b/docs/dyn/drive_v3.approvals.html
@@ -129,10 +129,10 @@ 
Method Details

 
     { # Metadata for an approval. An approval is a review or approve process for a Drive item.
   "approvalId": "A String", # The approval ID.
-  "completeTime": "A String", # Output only. The time the approval was completed.
-  "createTime": "A String", # Output only. The time the approval was created.
+  "completeTime": "A String", # The time the approval was completed.
+  "createTime": "A String", # The time the approval was created.
   "dueTime": "A String", # The time that the approval is due.
-  "fileContentChangeBehavior": "A String", # Output only. The behavior of the approval when the file content changes.
+  "fileContentChangeBehavior": "A String", # The behavior of the approval when the file content changes.
   "initiator": { # Information about a Drive user. # The user that requested the approval.
     "displayName": "A String", # Output only. A plain text displayable name for this user.
     "emailAddress": "A String", # Output only. The email address of the user. This may not be present in certain contexts if the user has not made their email address visible to the requester.
@@ -142,7 +142,7 @@ 
Method Details

     "photoLink": "A String", # Output only. A link to the user's profile photo, if available.
   },
   "kind": "A String", # This is always drive#approval.
-  "modifyTime": "A String", # Output only. The most recent time the approval was modified.
+  "modifyTime": "A String", # The most recent time the approval was modified.
   "reviewerResponses": [ # The responses made on the approval by reviewers.
     { # A response on an approval made by a specific reviewer.
       "kind": "A String", # This is always drive#reviewerResponse.
@@ -157,7 +157,7 @@ 
Method Details

       },
     },
   ],
-  "status": "A String", # Output only. The status of the approval at the time this resource was requested.
+  "status": "A String", # The status of the approval at the time this resource was requested.
   "targetFileId": "A String", # Target file id of the approval.
 }
@@ -186,10 +186,10 @@

Method Details

{ # Metadata for an approval. An approval is a review or approve process for a Drive item. "approvalId": "A String", # The approval ID. - "completeTime": "A String", # Output only. The time the approval was completed. - "createTime": "A String", # Output only. The time the approval was created. + "completeTime": "A String", # The time the approval was completed. + "createTime": "A String", # The time the approval was created. "dueTime": "A String", # The time that the approval is due. - "fileContentChangeBehavior": "A String", # Output only. The behavior of the approval when the file content changes. + "fileContentChangeBehavior": "A String", # The behavior of the approval when the file content changes. "initiator": { # Information about a Drive user. # The user that requested the approval. "displayName": "A String", # Output only. A plain text displayable name for this user. "emailAddress": "A String", # Output only. The email address of the user. This may not be present in certain contexts if the user has not made their email address visible to the requester. @@ -199,7 +199,7 @@

Method Details

"photoLink": "A String", # Output only. A link to the user's profile photo, if available. }, "kind": "A String", # This is always drive#approval. - "modifyTime": "A String", # Output only. The most recent time the approval was modified. + "modifyTime": "A String", # The most recent time the approval was modified. "reviewerResponses": [ # The responses made on the approval by reviewers. { # A response on an approval made by a specific reviewer. "kind": "A String", # This is always drive#reviewerResponse. @@ -214,7 +214,7 @@

Method Details

}, }, ], - "status": "A String", # Output only. The status of the approval at the time this resource was requested. + "status": "A String", # The status of the approval at the time this resource was requested. "targetFileId": "A String", # Target file id of the approval. } @@ -248,10 +248,10 @@

Method Details

{ # Metadata for an approval. An approval is a review or approve process for a Drive item. "approvalId": "A String", # The approval ID. - "completeTime": "A String", # Output only. The time the approval was completed. - "createTime": "A String", # Output only. The time the approval was created. + "completeTime": "A String", # The time the approval was completed. + "createTime": "A String", # The time the approval was created. "dueTime": "A String", # The time that the approval is due. - "fileContentChangeBehavior": "A String", # Output only. The behavior of the approval when the file content changes. + "fileContentChangeBehavior": "A String", # The behavior of the approval when the file content changes. "initiator": { # Information about a Drive user. # The user that requested the approval. "displayName": "A String", # Output only. A plain text displayable name for this user. "emailAddress": "A String", # Output only. The email address of the user. This may not be present in certain contexts if the user has not made their email address visible to the requester. @@ -261,7 +261,7 @@

Method Details

"photoLink": "A String", # Output only. A link to the user's profile photo, if available. }, "kind": "A String", # This is always drive#approval. - "modifyTime": "A String", # Output only. The most recent time the approval was modified. + "modifyTime": "A String", # The most recent time the approval was modified. "reviewerResponses": [ # The responses made on the approval by reviewers. { # A response on an approval made by a specific reviewer. "kind": "A String", # This is always drive#reviewerResponse. @@ -276,7 +276,7 @@

Method Details

}, }, ], - "status": "A String", # Output only. The status of the approval at the time this resource was requested. + "status": "A String", # The status of the approval at the time this resource was requested. "targetFileId": "A String", # Target file id of the approval. } @@ -305,10 +305,10 @@

Method Details

{ # Metadata for an approval. An approval is a review or approve process for a Drive item. "approvalId": "A String", # The approval ID. - "completeTime": "A String", # Output only. The time the approval was completed. - "createTime": "A String", # Output only. The time the approval was created. + "completeTime": "A String", # The time the approval was completed. + "createTime": "A String", # The time the approval was created. "dueTime": "A String", # The time that the approval is due. - "fileContentChangeBehavior": "A String", # Output only. The behavior of the approval when the file content changes. + "fileContentChangeBehavior": "A String", # The behavior of the approval when the file content changes. "initiator": { # Information about a Drive user. # The user that requested the approval. "displayName": "A String", # Output only. A plain text displayable name for this user. "emailAddress": "A String", # Output only. The email address of the user. This may not be present in certain contexts if the user has not made their email address visible to the requester. @@ -318,7 +318,7 @@

Method Details

"photoLink": "A String", # Output only. A link to the user's profile photo, if available. }, "kind": "A String", # This is always drive#approval. - "modifyTime": "A String", # Output only. The most recent time the approval was modified. + "modifyTime": "A String", # The most recent time the approval was modified. "reviewerResponses": [ # The responses made on the approval by reviewers. { # A response on an approval made by a specific reviewer. "kind": "A String", # This is always drive#reviewerResponse. @@ -333,7 +333,7 @@

Method Details

}, }, ], - "status": "A String", # Output only. The status of the approval at the time this resource was requested. + "status": "A String", # The status of the approval at the time this resource was requested. "targetFileId": "A String", # Target file id of the approval. } @@ -355,10 +355,10 @@

Method Details

{ # Metadata for an approval. An approval is a review or approve process for a Drive item. "approvalId": "A String", # The approval ID. - "completeTime": "A String", # Output only. The time the approval was completed. - "createTime": "A String", # Output only. The time the approval was created. + "completeTime": "A String", # The time the approval was completed. + "createTime": "A String", # The time the approval was created. "dueTime": "A String", # The time that the approval is due. - "fileContentChangeBehavior": "A String", # Output only. The behavior of the approval when the file content changes. + "fileContentChangeBehavior": "A String", # The behavior of the approval when the file content changes. "initiator": { # Information about a Drive user. # The user that requested the approval. "displayName": "A String", # Output only. A plain text displayable name for this user. "emailAddress": "A String", # Output only. The email address of the user. This may not be present in certain contexts if the user has not made their email address visible to the requester. @@ -368,7 +368,7 @@

Method Details

"photoLink": "A String", # Output only. A link to the user's profile photo, if available. }, "kind": "A String", # This is always drive#approval. - "modifyTime": "A String", # Output only. The most recent time the approval was modified. + "modifyTime": "A String", # The most recent time the approval was modified. "reviewerResponses": [ # The responses made on the approval by reviewers. { # A response on an approval made by a specific reviewer. "kind": "A String", # This is always drive#reviewerResponse. @@ -383,7 +383,7 @@

Method Details

}, }, ], - "status": "A String", # Output only. The status of the approval at the time this resource was requested. + "status": "A String", # The status of the approval at the time this resource was requested. "targetFileId": "A String", # Target file id of the approval. } @@ -408,10 +408,10 @@

Method Details

"items": [ # The list of approvals. If `nextPageToken` is populated, then this list may be incomplete and an additional page of results should be fetched. { # Metadata for an approval. An approval is a review or approve process for a Drive item. "approvalId": "A String", # The approval ID. - "completeTime": "A String", # Output only. The time the approval was completed. - "createTime": "A String", # Output only. The time the approval was created. + "completeTime": "A String", # The time the approval was completed. + "createTime": "A String", # The time the approval was created. "dueTime": "A String", # The time that the approval is due. - "fileContentChangeBehavior": "A String", # Output only. The behavior of the approval when the file content changes. + "fileContentChangeBehavior": "A String", # The behavior of the approval when the file content changes. "initiator": { # Information about a Drive user. # The user that requested the approval. "displayName": "A String", # Output only. A plain text displayable name for this user. "emailAddress": "A String", # Output only. The email address of the user. This may not be present in certain contexts if the user has not made their email address visible to the requester. @@ -421,7 +421,7 @@

Method Details

"photoLink": "A String", # Output only. A link to the user's profile photo, if available. }, "kind": "A String", # This is always drive#approval. - "modifyTime": "A String", # Output only. The most recent time the approval was modified. + "modifyTime": "A String", # The most recent time the approval was modified. "reviewerResponses": [ # The responses made on the approval by reviewers. { # A response on an approval made by a specific reviewer. "kind": "A String", # This is always drive#reviewerResponse. @@ -436,7 +436,7 @@

Method Details

}, }, ], - "status": "A String", # Output only. The status of the approval at the time this resource was requested. + "status": "A String", # The status of the approval at the time this resource was requested. "targetFileId": "A String", # Target file id of the approval. }, ], @@ -494,10 +494,10 @@

Method Details

{ # Metadata for an approval. An approval is a review or approve process for a Drive item. "approvalId": "A String", # The approval ID. - "completeTime": "A String", # Output only. The time the approval was completed. - "createTime": "A String", # Output only. The time the approval was created. + "completeTime": "A String", # The time the approval was completed. + "createTime": "A String", # The time the approval was created. "dueTime": "A String", # The time that the approval is due. - "fileContentChangeBehavior": "A String", # Output only. The behavior of the approval when the file content changes. + "fileContentChangeBehavior": "A String", # The behavior of the approval when the file content changes. "initiator": { # Information about a Drive user. # The user that requested the approval. "displayName": "A String", # Output only. A plain text displayable name for this user. "emailAddress": "A String", # Output only. The email address of the user. This may not be present in certain contexts if the user has not made their email address visible to the requester. @@ -507,7 +507,7 @@

Method Details

"photoLink": "A String", # Output only. A link to the user's profile photo, if available. }, "kind": "A String", # This is always drive#approval. - "modifyTime": "A String", # Output only. The most recent time the approval was modified. + "modifyTime": "A String", # The most recent time the approval was modified. "reviewerResponses": [ # The responses made on the approval by reviewers. { # A response on an approval made by a specific reviewer. "kind": "A String", # This is always drive#reviewerResponse. @@ -522,7 +522,7 @@

Method Details

}, }, ], - "status": "A String", # Output only. The status of the approval at the time this resource was requested. + "status": "A String", # The status of the approval at the time this resource was requested. "targetFileId": "A String", # Target file id of the approval. } @@ -556,10 +556,10 @@

Method Details

{ # Metadata for an approval. An approval is a review or approve process for a Drive item. "approvalId": "A String", # The approval ID. - "completeTime": "A String", # Output only. The time the approval was completed. - "createTime": "A String", # Output only. The time the approval was created. + "completeTime": "A String", # The time the approval was completed. + "createTime": "A String", # The time the approval was created. "dueTime": "A String", # The time that the approval is due. - "fileContentChangeBehavior": "A String", # Output only. The behavior of the approval when the file content changes. + "fileContentChangeBehavior": "A String", # The behavior of the approval when the file content changes. "initiator": { # Information about a Drive user. # The user that requested the approval. "displayName": "A String", # Output only. A plain text displayable name for this user. "emailAddress": "A String", # Output only. The email address of the user. This may not be present in certain contexts if the user has not made their email address visible to the requester. @@ -569,7 +569,7 @@

Method Details

"photoLink": "A String", # Output only. A link to the user's profile photo, if available. }, "kind": "A String", # This is always drive#approval. - "modifyTime": "A String", # Output only. The most recent time the approval was modified. + "modifyTime": "A String", # The most recent time the approval was modified. "reviewerResponses": [ # The responses made on the approval by reviewers. { # A response on an approval made by a specific reviewer. "kind": "A String", # This is always drive#reviewerResponse. @@ -584,7 +584,7 @@

Method Details

}, }, ], - "status": "A String", # Output only. The status of the approval at the time this resource was requested. + "status": "A String", # The status of the approval at the time this resource was requested. "targetFileId": "A String", # Target file id of the approval. } diff --git a/googleapiclient/discovery_cache/documents/drive.v3.json b/googleapiclient/discovery_cache/documents/drive.v3.json index 030038876f..77c206fd6b 100644 --- a/googleapiclient/discovery_cache/documents/drive.v3.json +++ b/googleapiclient/discovery_cache/documents/drive.v3.json @@ -3044,7 +3044,7 @@ } } }, -"revision": "20260916", +"revision": "20261011", "rootUrl": "https://www.googleapis.com/", "schemas": { "About": { @@ -3430,15 +3430,13 @@ "type": "string" }, "completeTime": { -"description": "Output only. The time the approval was completed.", +"description": "The time the approval was completed.", "format": "google-datetime", -"readOnly": true, "type": "string" }, "createTime": { -"description": "Output only. The time the approval was created.", +"description": "The time the approval was created.", "format": "google-datetime", -"readOnly": true, "type": "string" }, "dueTime": { @@ -3447,7 +3445,7 @@ "type": "string" }, "fileContentChangeBehavior": { -"description": "Output only. The behavior of the approval when the file content changes.", +"description": "The behavior of the approval when the file content changes.", "enum": [ "FILE_CONTENT_CHANGE_BEHAVIOR_UNSPECIFIED", "RESET_APPROVAL", @@ -3458,7 +3456,6 @@ "Any ReviewerResponse with a Response of APPROVED will be reset to NO_DECISION when the file content changes while the approval has a Status of IN_PROGRESS. When the approval has a Status of APPROVED and RESET_APPROVAL is selected, the file is locked.", "No action is taken when the file content changes." ], -"readOnly": true, "type": "string" }, "initiator": { @@ -3470,9 +3467,8 @@ "type": "string" }, "modifyTime": { -"description": "Output only. The most recent time the approval was modified.", +"description": "The most recent time the approval was modified.", "format": "google-datetime", -"readOnly": true, "type": "string" }, "reviewerResponses": { @@ -3483,7 +3479,7 @@ "type": "array" }, "status": { -"description": "Output only. The status of the approval at the time this resource was requested.", +"description": "The status of the approval at the time this resource was requested.", "enum": [ "STATUS_UNSPECIFIED", "IN_PROGRESS", @@ -3498,7 +3494,6 @@ "The approval process was cancelled before it finished.", "The approval process is finished and the target was declined." ], -"readOnly": true, "type": "string" }, "targetFileId": { From e4390a5ff072e0ba8d8a7afddc7f8d8d1283b2e1 Mon Sep 17 00:00:00 2001 From: Yoshi Automation Date: Tue, 20 Oct 2026 07:24:01 +0000 Subject: [PATCH 18/34] feat(fcm): update the api #### fcm:v1 The following keys were added: - schemas.AndroidBackgroundSyncMessage (Total Keys: 2) - schemas.AndroidConfigV2 (Total Keys: 14) - schemas.AndroidNotificationV2 (Total Keys: 31) - schemas.AndroidRemoteNotification (Total Keys: 5) - schemas.GoogleFirebaseFcmV1AndroidNotificationV2LightSettings (Total Keys: 7) - schemas.Message.properties.androidV2.$ref (Total Keys: 1) --- docs/dyn/fcm_v1.projects.messages.html | 126 +++++++++ .../discovery_cache/documents/fcm.v1.json | 255 +++++++++++++++++- 2 files changed, 380 insertions(+), 1 deletion(-) diff --git a/docs/dyn/fcm_v1.projects.messages.html b/docs/dyn/fcm_v1.projects.messages.html index 28460efa43..7f1d012794 100644 --- a/docs/dyn/fcm_v1.projects.messages.html +++ b/docs/dyn/fcm_v1.projects.messages.html @@ -156,6 +156,69 @@

Method Details

"restrictedSatelliteOk": True or False, # Optional. If set to true, messages will be allowed to be delivered to the app while the device is connected over a restricted satellite network. This should only be enabled for messages that can be handled over a restricted satellite network and only for apps that are enabled to work over a restricted satellite network. Note that the ability of the app to connect to a restricted satellite network is dependent on the carrier's settings and the device model. "ttl": "A String", # How long (in seconds) the message should be kept in FCM storage if the device is offline. The maximum time to live supported is 4 weeks, and the default value is 4 weeks if not set. Set it to 0 if want to send the message immediately. In JSON format, the Duration type is encoded as a string rather than an object, where the string ends in the suffix "s" (indicating seconds) and is preceded by the number of seconds, with nanoseconds expressed as fractional seconds. For example, 3 seconds with 0 nanoseconds should be encoded in JSON format as "3s", while 3 seconds and 1 nanosecond should be expressed in JSON format as "3.000000001s". The ttl will be rounded down to the nearest second. }, + "androidV2": { # Android specific V2 options for messages sent through [FCM connection server](https://goo.gl/4GLdUl). This is a v2 version of the AndroidConfig message and will replace it in the v2 API. # Optional. Input only. Android specific V2 options for messages sent through FCM connection server. Mutually exclusive with `android`. Requests with both `AndroidConfig` and `AndroidConfigV2` will be rejected. + "backgroundSync": { # A Background Sync message that is sent to an Android device. # Optional. Non-urgent background sync message to send to android devices. + }, + "bandwidthConstrainedOk": True or False, # Optional. If set to true, messages will be allowed to be delivered to the app while the device is in bandwidth constrained mode. This should only be enabled when the app has been tested to properly handle messages in bandwidth constrained mode. + "collapseKey": "A String", # An identifier of a group of messages that can be collapsed, so that only the last message gets sent when delivery can be resumed. A maximum of 4 different collapse keys is allowed at any given time. + "data": { # Arbitrary key/value payload. If present, it will override google.firebase.fcm.v1.Message.data. + "a_key": "A String", + }, + "directBootOk": True or False, # Optional. If set to true, messages will be allowed to be delivered to the app while the device is in direct boot mode. See [Support Direct Boot mode](https://developer.android.com/training/articles/direct-boot). + "fcmOptions": { # Options for features provided by the FCM SDK for Android. # Options for features provided by the FCM SDK for Android. If present, it will override google.firebase.fcm.v1.Message.fcm_options. + "analyticsLabel": "A String", # Label associated with the message's analytics data. + }, + "remoteNotification": { # A Remote Notification message that is sent to an Android device. # Optional. User-facing notification to send to android devices. + "mutableContent": True or False, # Optional. If set to true, the notification content can be updated by the app after the notification is received on the device. + "notification": { # Notification v2 to send to android devices. This is a v2 version of the AndroidNotification message and will replace it in the v2 API. # Optional. Notification to send to android devices. + "body": "A String", # The notification's body text. If present, it will override google.firebase.fcm.v1.Notification.body. + "bodyLocArgs": [ # Variable string values to be used in place of the format specifiers in body_loc_key to use to localize the body text to the user's current localization. See [Formatting and Styling](https://goo.gl/MalYE3) for more information. + "A String", + ], + "bodyLocKey": "A String", # The key to the body string in the app's string resources to use to localize the body text to the user's current localization. See [String Resources](https://goo.gl/NdFZGI) for more information. + "channelId": "A String", # The [notification's channel id](https://developer.android.com/guide/topics/ui/notifiers/notifications#ManageChannels) (new in Android O). The app must create a channel with this channel ID before any notification with this channel ID is received. If you don't send this channel ID in the request, or if the channel ID provided has not yet been created by the app, FCM uses the channel ID specified in the app manifest. + "clickAction": "A String", # The action associated with a user click on the notification. If specified, an activity with a matching intent filter is launched when a user clicks on the notification. + "color": "A String", # The notification's icon color, expressed in #rrggbb format. + "defaultLightSettings": True or False, # If set to true, use the Android framework's default LED light settings for the notification. Default values are specified in [config.xml](https://android.googlesource.com/platform/frameworks/base/+/master/core/res/res/values/config.xml). If `default_light_settings` is set to true and `light_settings` is also set, the user-specified `light_settings` is used instead of the default value. + "defaultSound": True or False, # If set to true, use the Android framework's default sound for the notification. Default values are specified in [config.xml](https://android.googlesource.com/platform/frameworks/base/+/master/core/res/res/values/config.xml). + "defaultVibrateTimings": True or False, # If set to true, use the Android framework's default vibrate pattern for the notification. Default values are specified in [config.xml](https://android.googlesource.com/platform/frameworks/base/+/master/core/res/res/values/config.xml). If `default_vibrate_timings` is set to true and `vibrate_timings` is also set, the default value is used instead of the user-specified `vibrate_timings`. + "eventTime": "A String", # Set the time that the event in the notification occurred. Notifications in the panel are sorted by this time. A point in time is represented using [protobuf.Timestamp](https://developers.google.com/protocol-buffers/docs/reference/java/com/google/protobuf/Timestamp). + "icon": "A String", # The notification's icon. Sets the notification icon to myicon for drawable resource myicon. If you don't send this key in the request, FCM displays the launcher icon specified in your app manifest. + "id": 42, # Optional. Identifier used to replace existing notifications in the notification drawer. It is used in conjunction with `tag` to form a unique identifier `(tag, id`)` within the app. If not specified, each request creates a new notification. If specified and a notification with the same `(tag, id)` is already being shown, the new notification replaces the existing one in the notification drawer. + "image": "A String", # Contains the URL of an image that is going to be displayed in a notification. If present, it will override google.firebase.fcm.v1.Notification.image. + "lightSettings": { # Settings to control notification LED. # Settings to control the notification's LED blinking rate and color if LED is available on the device. The total blinking time is controlled by the OS. + "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(''); }; // ... # Required. Set `color` of the LED with [google.type.Color](https://github.com/googleapis/googleapis/blob/master/google/type/color.proto). + "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). + "blue": 3.14, # The amount of blue in the color as a value in the interval [0, 1]. + "green": 3.14, # The amount of green in the color as a value in the interval [0, 1]. + "red": 3.14, # The amount of red in the color as a value in the interval [0, 1]. + }, + "lightOffDuration": "A String", # Required. Along with `light_on_duration`, define the blink rate of LED flashes. Resolution defined by [proto.Duration](https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#google.protobuf.Duration) + "lightOnDuration": "A String", # Required. Along with `light_off_duration`, define the blink rate of LED flashes. Resolution defined by [proto.Duration](https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#google.protobuf.Duration) + }, + "localOnly": True or False, # Set whether or not this notification is relevant only to the current device. Some notifications can be bridged to other devices for remote display, such as a Wear OS watch. This hint can be set to recommend this notification not be bridged. See [Wear OS guides](https://developer.android.com/training/wearables/notifications/bridger#existing-method-of-preventing-bridging) + "notificationCount": 42, # Sets the number of items this notification represents. May be displayed as a badge count for launchers that support badging.See [Notification Badge](https://developer.android.com/training/notify-user/badges). For example, this might be useful if you're using just one notification to represent multiple new messages but you want the count here to represent the number of total new messages. If non-positive or unspecified, systems that support badging use the default, which is to increment a number displayed on the long-press menu each time a new notification arrives. + "notificationPriority": "A String", # Set the relative priority for this notification. Priority is an indication of how much of the user's attention should be consumed by this notification. Low-priority notifications may be hidden from the user in certain situations, while the user might be interrupted for a higher-priority notification. This parameter affects notification priority only on devices running Android 7.1 (API level 25) and lower. On Android 8.0 (API level 26) and higher, priority is ignored in favor of channel [importance](https://developer.android.com/develop/ui/views/notifications/channels#importance). Note this priority differs from `AndroidMessagePriority`. This priority is processed by the client after the message has been delivered, whereas [AndroidMessagePriority](https://firebase.google.com/docs/reference/fcm/rest/v1/projects.messages#androidmessagepriority) is an FCM concept that controls when the message is delivered. + "sound": "A String", # The sound to play when the device receives the notification. Supports "default" or the filename of a sound resource bundled in the app. Sound files must reside in /res/raw/. + "sticky": True or False, # When set to false or unset, the notification is automatically dismissed when the user clicks it in the panel. When set to true, the notification persists even when the user clicks it. + "tag": "A String", # Identifier used to replace existing notifications in the notification drawer. It is used in conjunction with `id` to form a unique identifier `(tag, id`)` within the app. If not specified, each request creates a new notification. If specified and a notification with the same `(tag, id)` is already being shown, the new notification replaces the existing one in the notification drawer. + "ticker": "A String", # Sets the "ticker" text, which is sent to accessibility services. Prior to API level 21 (`Lollipop`), sets the text that is displayed in the status bar when the notification first arrives. + "title": "A String", # The notification's title. If present, it will override google.firebase.fcm.v1.Notification.title. + "titleLocArgs": [ # Variable string values to be used in place of the format specifiers in title_loc_key to use to localize the title text to the user's current localization. See [Formatting and Styling](https://goo.gl/MalYE3) for more information. + "A String", + ], + "titleLocKey": "A String", # The key to the title string in the app's string resources to use to localize the title text to the user's current localization. See [String Resources](https://goo.gl/NdFZGI) for more information. + "vibrateTimings": [ # Set the vibration pattern to use. Pass in an array of [protobuf.Duration](https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#google.protobuf.Duration) to turn on or off the vibrator. The first value indicates the `Duration` to wait before turning the vibrator on. The next value indicates the `Duration` to keep the vibrator on. Subsequent values alternate between `Duration` to turn the vibrator off and to turn the vibrator on. If `vibrate_timings` is set and `default_vibrate_timings` is set to `true`, the default value is used instead of the user-specified `vibrate_timings`. + "A String", + ], + "visibility": "A String", # Set the [Notification.visibility](https://developer.android.com/reference/android/app/Notification.html#visibility) of the notification. + }, + "useAsV1DataMessage": True or False, # Optional. If set to true, this RemoteNotification message will be delivered to legacy V1 clients as data messages by omitting the google.firebase.fcm.v1.Message.android_v2.remote_notification.notification. This should only be enabled when migration from legacy V1 data messages. Note that by default (when set to false), RemoteNotification messages are automatically translated to V1 notification message for legacy clients; + }, + "restrictedPackageName": "A String", # Package name of the application where the registration token must match in order to receive the message. + "restrictedSatelliteOk": True or False, # Optional. If set to true, messages will be allowed to be delivered to the app while the device is connected over a restricted satellite network. This should only be enabled for messages that can be handled over a restricted satellite network and only for apps that are enabled to work over a restricted satellite network. Note that the ability of the app to connect to a restricted satellite network is dependent on the carrier's settings and the device model. + "ttl": "A String", # How long (in seconds) the message should be kept in FCM storage if the device is offline. The maximum time to live supported is 4 weeks, and the default value is 4 weeks if not set. Set it to 0 if want to send the message immediately. In JSON format, the Duration type is encoded as a string rather than an object, where the string ends in the suffix "s" (indicating seconds) and is preceded by the number of seconds, with nanoseconds expressed as fractional seconds. For example, 3 seconds with 0 nanoseconds should be encoded in JSON format as "3s", while 3 seconds and 1 nanosecond should be expressed in JSON format as "3.000000001s". The ttl will be rounded down to the nearest second. + }, "apns": { # [Apple Push Notification Service](https://goo.gl/MXRTPa) specific options. # Input only. [Apple Push Notification Service](https://goo.gl/MXRTPa) specific options. "fcmOptions": { # Options for features provided by the FCM SDK for iOS. # Options for features provided by the FCM SDK for iOS. "analyticsLabel": "A String", # Label associated with the message's analytics data. @@ -272,6 +335,69 @@

Method Details

"restrictedSatelliteOk": True or False, # Optional. If set to true, messages will be allowed to be delivered to the app while the device is connected over a restricted satellite network. This should only be enabled for messages that can be handled over a restricted satellite network and only for apps that are enabled to work over a restricted satellite network. Note that the ability of the app to connect to a restricted satellite network is dependent on the carrier's settings and the device model. "ttl": "A String", # How long (in seconds) the message should be kept in FCM storage if the device is offline. The maximum time to live supported is 4 weeks, and the default value is 4 weeks if not set. Set it to 0 if want to send the message immediately. In JSON format, the Duration type is encoded as a string rather than an object, where the string ends in the suffix "s" (indicating seconds) and is preceded by the number of seconds, with nanoseconds expressed as fractional seconds. For example, 3 seconds with 0 nanoseconds should be encoded in JSON format as "3s", while 3 seconds and 1 nanosecond should be expressed in JSON format as "3.000000001s". The ttl will be rounded down to the nearest second. }, + "androidV2": { # Android specific V2 options for messages sent through [FCM connection server](https://goo.gl/4GLdUl). This is a v2 version of the AndroidConfig message and will replace it in the v2 API. # Optional. Input only. Android specific V2 options for messages sent through FCM connection server. Mutually exclusive with `android`. Requests with both `AndroidConfig` and `AndroidConfigV2` will be rejected. + "backgroundSync": { # A Background Sync message that is sent to an Android device. # Optional. Non-urgent background sync message to send to android devices. + }, + "bandwidthConstrainedOk": True or False, # Optional. If set to true, messages will be allowed to be delivered to the app while the device is in bandwidth constrained mode. This should only be enabled when the app has been tested to properly handle messages in bandwidth constrained mode. + "collapseKey": "A String", # An identifier of a group of messages that can be collapsed, so that only the last message gets sent when delivery can be resumed. A maximum of 4 different collapse keys is allowed at any given time. + "data": { # Arbitrary key/value payload. If present, it will override google.firebase.fcm.v1.Message.data. + "a_key": "A String", + }, + "directBootOk": True or False, # Optional. If set to true, messages will be allowed to be delivered to the app while the device is in direct boot mode. See [Support Direct Boot mode](https://developer.android.com/training/articles/direct-boot). + "fcmOptions": { # Options for features provided by the FCM SDK for Android. # Options for features provided by the FCM SDK for Android. If present, it will override google.firebase.fcm.v1.Message.fcm_options. + "analyticsLabel": "A String", # Label associated with the message's analytics data. + }, + "remoteNotification": { # A Remote Notification message that is sent to an Android device. # Optional. User-facing notification to send to android devices. + "mutableContent": True or False, # Optional. If set to true, the notification content can be updated by the app after the notification is received on the device. + "notification": { # Notification v2 to send to android devices. This is a v2 version of the AndroidNotification message and will replace it in the v2 API. # Optional. Notification to send to android devices. + "body": "A String", # The notification's body text. If present, it will override google.firebase.fcm.v1.Notification.body. + "bodyLocArgs": [ # Variable string values to be used in place of the format specifiers in body_loc_key to use to localize the body text to the user's current localization. See [Formatting and Styling](https://goo.gl/MalYE3) for more information. + "A String", + ], + "bodyLocKey": "A String", # The key to the body string in the app's string resources to use to localize the body text to the user's current localization. See [String Resources](https://goo.gl/NdFZGI) for more information. + "channelId": "A String", # The [notification's channel id](https://developer.android.com/guide/topics/ui/notifiers/notifications#ManageChannels) (new in Android O). The app must create a channel with this channel ID before any notification with this channel ID is received. If you don't send this channel ID in the request, or if the channel ID provided has not yet been created by the app, FCM uses the channel ID specified in the app manifest. + "clickAction": "A String", # The action associated with a user click on the notification. If specified, an activity with a matching intent filter is launched when a user clicks on the notification. + "color": "A String", # The notification's icon color, expressed in #rrggbb format. + "defaultLightSettings": True or False, # If set to true, use the Android framework's default LED light settings for the notification. Default values are specified in [config.xml](https://android.googlesource.com/platform/frameworks/base/+/master/core/res/res/values/config.xml). If `default_light_settings` is set to true and `light_settings` is also set, the user-specified `light_settings` is used instead of the default value. + "defaultSound": True or False, # If set to true, use the Android framework's default sound for the notification. Default values are specified in [config.xml](https://android.googlesource.com/platform/frameworks/base/+/master/core/res/res/values/config.xml). + "defaultVibrateTimings": True or False, # If set to true, use the Android framework's default vibrate pattern for the notification. Default values are specified in [config.xml](https://android.googlesource.com/platform/frameworks/base/+/master/core/res/res/values/config.xml). If `default_vibrate_timings` is set to true and `vibrate_timings` is also set, the default value is used instead of the user-specified `vibrate_timings`. + "eventTime": "A String", # Set the time that the event in the notification occurred. Notifications in the panel are sorted by this time. A point in time is represented using [protobuf.Timestamp](https://developers.google.com/protocol-buffers/docs/reference/java/com/google/protobuf/Timestamp). + "icon": "A String", # The notification's icon. Sets the notification icon to myicon for drawable resource myicon. If you don't send this key in the request, FCM displays the launcher icon specified in your app manifest. + "id": 42, # Optional. Identifier used to replace existing notifications in the notification drawer. It is used in conjunction with `tag` to form a unique identifier `(tag, id`)` within the app. If not specified, each request creates a new notification. If specified and a notification with the same `(tag, id)` is already being shown, the new notification replaces the existing one in the notification drawer. + "image": "A String", # Contains the URL of an image that is going to be displayed in a notification. If present, it will override google.firebase.fcm.v1.Notification.image. + "lightSettings": { # Settings to control notification LED. # Settings to control the notification's LED blinking rate and color if LED is available on the device. The total blinking time is controlled by the OS. + "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(''); }; // ... # Required. Set `color` of the LED with [google.type.Color](https://github.com/googleapis/googleapis/blob/master/google/type/color.proto). + "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). + "blue": 3.14, # The amount of blue in the color as a value in the interval [0, 1]. + "green": 3.14, # The amount of green in the color as a value in the interval [0, 1]. + "red": 3.14, # The amount of red in the color as a value in the interval [0, 1]. + }, + "lightOffDuration": "A String", # Required. Along with `light_on_duration`, define the blink rate of LED flashes. Resolution defined by [proto.Duration](https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#google.protobuf.Duration) + "lightOnDuration": "A String", # Required. Along with `light_off_duration`, define the blink rate of LED flashes. Resolution defined by [proto.Duration](https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#google.protobuf.Duration) + }, + "localOnly": True or False, # Set whether or not this notification is relevant only to the current device. Some notifications can be bridged to other devices for remote display, such as a Wear OS watch. This hint can be set to recommend this notification not be bridged. See [Wear OS guides](https://developer.android.com/training/wearables/notifications/bridger#existing-method-of-preventing-bridging) + "notificationCount": 42, # Sets the number of items this notification represents. May be displayed as a badge count for launchers that support badging.See [Notification Badge](https://developer.android.com/training/notify-user/badges). For example, this might be useful if you're using just one notification to represent multiple new messages but you want the count here to represent the number of total new messages. If non-positive or unspecified, systems that support badging use the default, which is to increment a number displayed on the long-press menu each time a new notification arrives. + "notificationPriority": "A String", # Set the relative priority for this notification. Priority is an indication of how much of the user's attention should be consumed by this notification. Low-priority notifications may be hidden from the user in certain situations, while the user might be interrupted for a higher-priority notification. This parameter affects notification priority only on devices running Android 7.1 (API level 25) and lower. On Android 8.0 (API level 26) and higher, priority is ignored in favor of channel [importance](https://developer.android.com/develop/ui/views/notifications/channels#importance). Note this priority differs from `AndroidMessagePriority`. This priority is processed by the client after the message has been delivered, whereas [AndroidMessagePriority](https://firebase.google.com/docs/reference/fcm/rest/v1/projects.messages#androidmessagepriority) is an FCM concept that controls when the message is delivered. + "sound": "A String", # The sound to play when the device receives the notification. Supports "default" or the filename of a sound resource bundled in the app. Sound files must reside in /res/raw/. + "sticky": True or False, # When set to false or unset, the notification is automatically dismissed when the user clicks it in the panel. When set to true, the notification persists even when the user clicks it. + "tag": "A String", # Identifier used to replace existing notifications in the notification drawer. It is used in conjunction with `id` to form a unique identifier `(tag, id`)` within the app. If not specified, each request creates a new notification. If specified and a notification with the same `(tag, id)` is already being shown, the new notification replaces the existing one in the notification drawer. + "ticker": "A String", # Sets the "ticker" text, which is sent to accessibility services. Prior to API level 21 (`Lollipop`), sets the text that is displayed in the status bar when the notification first arrives. + "title": "A String", # The notification's title. If present, it will override google.firebase.fcm.v1.Notification.title. + "titleLocArgs": [ # Variable string values to be used in place of the format specifiers in title_loc_key to use to localize the title text to the user's current localization. See [Formatting and Styling](https://goo.gl/MalYE3) for more information. + "A String", + ], + "titleLocKey": "A String", # The key to the title string in the app's string resources to use to localize the title text to the user's current localization. See [String Resources](https://goo.gl/NdFZGI) for more information. + "vibrateTimings": [ # Set the vibration pattern to use. Pass in an array of [protobuf.Duration](https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#google.protobuf.Duration) to turn on or off the vibrator. The first value indicates the `Duration` to wait before turning the vibrator on. The next value indicates the `Duration` to keep the vibrator on. Subsequent values alternate between `Duration` to turn the vibrator off and to turn the vibrator on. If `vibrate_timings` is set and `default_vibrate_timings` is set to `true`, the default value is used instead of the user-specified `vibrate_timings`. + "A String", + ], + "visibility": "A String", # Set the [Notification.visibility](https://developer.android.com/reference/android/app/Notification.html#visibility) of the notification. + }, + "useAsV1DataMessage": True or False, # Optional. If set to true, this RemoteNotification message will be delivered to legacy V1 clients as data messages by omitting the google.firebase.fcm.v1.Message.android_v2.remote_notification.notification. This should only be enabled when migration from legacy V1 data messages. Note that by default (when set to false), RemoteNotification messages are automatically translated to V1 notification message for legacy clients; + }, + "restrictedPackageName": "A String", # Package name of the application where the registration token must match in order to receive the message. + "restrictedSatelliteOk": True or False, # Optional. If set to true, messages will be allowed to be delivered to the app while the device is connected over a restricted satellite network. This should only be enabled for messages that can be handled over a restricted satellite network and only for apps that are enabled to work over a restricted satellite network. Note that the ability of the app to connect to a restricted satellite network is dependent on the carrier's settings and the device model. + "ttl": "A String", # How long (in seconds) the message should be kept in FCM storage if the device is offline. The maximum time to live supported is 4 weeks, and the default value is 4 weeks if not set. Set it to 0 if want to send the message immediately. In JSON format, the Duration type is encoded as a string rather than an object, where the string ends in the suffix "s" (indicating seconds) and is preceded by the number of seconds, with nanoseconds expressed as fractional seconds. For example, 3 seconds with 0 nanoseconds should be encoded in JSON format as "3s", while 3 seconds and 1 nanosecond should be expressed in JSON format as "3.000000001s". The ttl will be rounded down to the nearest second. + }, "apns": { # [Apple Push Notification Service](https://goo.gl/MXRTPa) specific options. # Input only. [Apple Push Notification Service](https://goo.gl/MXRTPa) specific options. "fcmOptions": { # Options for features provided by the FCM SDK for iOS. # Options for features provided by the FCM SDK for iOS. "analyticsLabel": "A String", # Label associated with the message's analytics data. diff --git a/googleapiclient/discovery_cache/documents/fcm.v1.json b/googleapiclient/discovery_cache/documents/fcm.v1.json index 68839caeff..61c05f845c 100644 --- a/googleapiclient/discovery_cache/documents/fcm.v1.json +++ b/googleapiclient/discovery_cache/documents/fcm.v1.json @@ -316,9 +316,15 @@ } } }, -"revision": "20260925", +"revision": "20261013", "rootUrl": "https://fcm.googleapis.com/", "schemas": { +"AndroidBackgroundSyncMessage": { +"description": "A Background Sync message that is sent to an Android device.", +"id": "AndroidBackgroundSyncMessage", +"properties": {}, +"type": "object" +}, "AndroidConfig": { "description": "Android specific options for messages sent through [FCM connection server](https://goo.gl/4GLdUl).", "id": "AndroidConfig", @@ -378,6 +384,57 @@ }, "type": "object" }, +"AndroidConfigV2": { +"description": "Android specific V2 options for messages sent through [FCM connection server](https://goo.gl/4GLdUl). This is a v2 version of the AndroidConfig message and will replace it in the v2 API.", +"id": "AndroidConfigV2", +"properties": { +"backgroundSync": { +"$ref": "AndroidBackgroundSyncMessage", +"description": "Optional. Non-urgent background sync message to send to android devices." +}, +"bandwidthConstrainedOk": { +"description": "Optional. If set to true, messages will be allowed to be delivered to the app while the device is in bandwidth constrained mode. This should only be enabled when the app has been tested to properly handle messages in bandwidth constrained mode.", +"type": "boolean" +}, +"collapseKey": { +"description": "An identifier of a group of messages that can be collapsed, so that only the last message gets sent when delivery can be resumed. A maximum of 4 different collapse keys is allowed at any given time.", +"type": "string" +}, +"data": { +"additionalProperties": { +"type": "string" +}, +"description": "Arbitrary key/value payload. If present, it will override google.firebase.fcm.v1.Message.data.", +"type": "object" +}, +"directBootOk": { +"description": "Optional. If set to true, messages will be allowed to be delivered to the app while the device is in direct boot mode. See [Support Direct Boot mode](https://developer.android.com/training/articles/direct-boot).", +"type": "boolean" +}, +"fcmOptions": { +"$ref": "AndroidFcmOptions", +"description": "Options for features provided by the FCM SDK for Android. If present, it will override google.firebase.fcm.v1.Message.fcm_options." +}, +"remoteNotification": { +"$ref": "AndroidRemoteNotification", +"description": "Optional. User-facing notification to send to android devices." +}, +"restrictedPackageName": { +"description": "Package name of the application where the registration token must match in order to receive the message.", +"type": "string" +}, +"restrictedSatelliteOk": { +"description": "Optional. If set to true, messages will be allowed to be delivered to the app while the device is connected over a restricted satellite network. This should only be enabled for messages that can be handled over a restricted satellite network and only for apps that are enabled to work over a restricted satellite network. Note that the ability of the app to connect to a restricted satellite network is dependent on the carrier's settings and the device model.", +"type": "boolean" +}, +"ttl": { +"description": "How long (in seconds) the message should be kept in FCM storage if the device is offline. The maximum time to live supported is 4 weeks, and the default value is 4 weeks if not set. Set it to 0 if want to send the message immediately. In JSON format, the Duration type is encoded as a string rather than an object, where the string ends in the suffix \"s\" (indicating seconds) and is preceded by the number of seconds, with nanoseconds expressed as fractional seconds. For example, 3 seconds with 0 nanoseconds should be encoded in JSON format as \"3s\", while 3 seconds and 1 nanosecond should be expressed in JSON format as \"3.000000001s\". The ttl will be rounded down to the nearest second.", +"format": "google-duration", +"type": "string" +} +}, +"type": "object" +}, "AndroidFcmOptions": { "description": "Options for features provided by the FCM SDK for Android.", "id": "AndroidFcmOptions", @@ -557,6 +614,177 @@ }, "type": "object" }, +"AndroidNotificationV2": { +"description": "Notification v2 to send to android devices. This is a v2 version of the AndroidNotification message and will replace it in the v2 API.", +"id": "AndroidNotificationV2", +"properties": { +"body": { +"description": "The notification's body text. If present, it will override google.firebase.fcm.v1.Notification.body.", +"type": "string" +}, +"bodyLocArgs": { +"description": "Variable string values to be used in place of the format specifiers in body_loc_key to use to localize the body text to the user's current localization. See [Formatting and Styling](https://goo.gl/MalYE3) for more information.", +"items": { +"type": "string" +}, +"type": "array" +}, +"bodyLocKey": { +"description": "The key to the body string in the app's string resources to use to localize the body text to the user's current localization. See [String Resources](https://goo.gl/NdFZGI) for more information.", +"type": "string" +}, +"channelId": { +"description": "The [notification's channel id](https://developer.android.com/guide/topics/ui/notifiers/notifications#ManageChannels) (new in Android O). The app must create a channel with this channel ID before any notification with this channel ID is received. If you don't send this channel ID in the request, or if the channel ID provided has not yet been created by the app, FCM uses the channel ID specified in the app manifest.", +"type": "string" +}, +"clickAction": { +"description": "The action associated with a user click on the notification. If specified, an activity with a matching intent filter is launched when a user clicks on the notification.", +"type": "string" +}, +"color": { +"description": "The notification's icon color, expressed in #rrggbb format.", +"type": "string" +}, +"defaultLightSettings": { +"description": "If set to true, use the Android framework's default LED light settings for the notification. Default values are specified in [config.xml](https://android.googlesource.com/platform/frameworks/base/+/master/core/res/res/values/config.xml). If `default_light_settings` is set to true and `light_settings` is also set, the user-specified `light_settings` is used instead of the default value.", +"type": "boolean" +}, +"defaultSound": { +"description": "If set to true, use the Android framework's default sound for the notification. Default values are specified in [config.xml](https://android.googlesource.com/platform/frameworks/base/+/master/core/res/res/values/config.xml).", +"type": "boolean" +}, +"defaultVibrateTimings": { +"description": "If set to true, use the Android framework's default vibrate pattern for the notification. Default values are specified in [config.xml](https://android.googlesource.com/platform/frameworks/base/+/master/core/res/res/values/config.xml). If `default_vibrate_timings` is set to true and `vibrate_timings` is also set, the default value is used instead of the user-specified `vibrate_timings`.", +"type": "boolean" +}, +"eventTime": { +"description": "Set the time that the event in the notification occurred. Notifications in the panel are sorted by this time. A point in time is represented using [protobuf.Timestamp](https://developers.google.com/protocol-buffers/docs/reference/java/com/google/protobuf/Timestamp).", +"format": "google-datetime", +"type": "string" +}, +"icon": { +"description": "The notification's icon. Sets the notification icon to myicon for drawable resource myicon. If you don't send this key in the request, FCM displays the launcher icon specified in your app manifest.", +"type": "string" +}, +"id": { +"description": "Optional. Identifier used to replace existing notifications in the notification drawer. It is used in conjunction with `tag` to form a unique identifier `(tag, id`)` within the app. If not specified, each request creates a new notification. If specified and a notification with the same `(tag, id)` is already being shown, the new notification replaces the existing one in the notification drawer.", +"format": "int32", +"type": "integer" +}, +"image": { +"description": "Contains the URL of an image that is going to be displayed in a notification. If present, it will override google.firebase.fcm.v1.Notification.image.", +"type": "string" +}, +"lightSettings": { +"$ref": "GoogleFirebaseFcmV1AndroidNotificationV2LightSettings", +"description": "Settings to control the notification's LED blinking rate and color if LED is available on the device. The total blinking time is controlled by the OS." +}, +"localOnly": { +"description": "Set whether or not this notification is relevant only to the current device. Some notifications can be bridged to other devices for remote display, such as a Wear OS watch. This hint can be set to recommend this notification not be bridged. See [Wear OS guides](https://developer.android.com/training/wearables/notifications/bridger#existing-method-of-preventing-bridging)", +"type": "boolean" +}, +"notificationCount": { +"description": "Sets the number of items this notification represents. May be displayed as a badge count for launchers that support badging.See [Notification Badge](https://developer.android.com/training/notify-user/badges). For example, this might be useful if you're using just one notification to represent multiple new messages but you want the count here to represent the number of total new messages. If non-positive or unspecified, systems that support badging use the default, which is to increment a number displayed on the long-press menu each time a new notification arrives.", +"format": "int32", +"type": "integer" +}, +"notificationPriority": { +"description": "Set the relative priority for this notification. Priority is an indication of how much of the user's attention should be consumed by this notification. Low-priority notifications may be hidden from the user in certain situations, while the user might be interrupted for a higher-priority notification. This parameter affects notification priority only on devices running Android 7.1 (API level 25) and lower. On Android 8.0 (API level 26) and higher, priority is ignored in favor of channel [importance](https://developer.android.com/develop/ui/views/notifications/channels#importance). Note this priority differs from `AndroidMessagePriority`. This priority is processed by the client after the message has been delivered, whereas [AndroidMessagePriority](https://firebase.google.com/docs/reference/fcm/rest/v1/projects.messages#androidmessagepriority) is an FCM concept that controls when the message is delivered.", +"enum": [ +"PRIORITY_UNSPECIFIED", +"PRIORITY_MIN", +"PRIORITY_LOW", +"PRIORITY_DEFAULT", +"PRIORITY_HIGH", +"PRIORITY_MAX" +], +"enumDescriptions": [ +"If priority is unspecified, notification priority is set to `PRIORITY_DEFAULT`.", +"Lowest notification priority. Notifications with this `PRIORITY_MIN` might not be shown to the user except under special circumstances, such as detailed notification logs.", +"Lower notification priority. The UI may choose to show the notifications smaller, or at a different position in the list, compared with notifications with `PRIORITY_DEFAULT`.", +"Default notification priority. If the application does not prioritize its own notifications, use this value for all notifications.", +"Higher notification priority. Use this for more important notifications or alerts. The UI may choose to show these notifications larger, or at a different position in the notification lists, compared with notifications with `PRIORITY_DEFAULT`.", +"Highest notification priority. Use this for the application's most important items that require the user's prompt attention or input." +], +"type": "string" +}, +"sound": { +"description": "The sound to play when the device receives the notification. Supports \"default\" or the filename of a sound resource bundled in the app. Sound files must reside in /res/raw/.", +"type": "string" +}, +"sticky": { +"description": "When set to false or unset, the notification is automatically dismissed when the user clicks it in the panel. When set to true, the notification persists even when the user clicks it.", +"type": "boolean" +}, +"tag": { +"description": "Identifier used to replace existing notifications in the notification drawer. It is used in conjunction with `id` to form a unique identifier `(tag, id`)` within the app. If not specified, each request creates a new notification. If specified and a notification with the same `(tag, id)` is already being shown, the new notification replaces the existing one in the notification drawer.", +"type": "string" +}, +"ticker": { +"description": "Sets the \"ticker\" text, which is sent to accessibility services. Prior to API level 21 (`Lollipop`), sets the text that is displayed in the status bar when the notification first arrives.", +"type": "string" +}, +"title": { +"description": "The notification's title. If present, it will override google.firebase.fcm.v1.Notification.title.", +"type": "string" +}, +"titleLocArgs": { +"description": "Variable string values to be used in place of the format specifiers in title_loc_key to use to localize the title text to the user's current localization. See [Formatting and Styling](https://goo.gl/MalYE3) for more information.", +"items": { +"type": "string" +}, +"type": "array" +}, +"titleLocKey": { +"description": "The key to the title string in the app's string resources to use to localize the title text to the user's current localization. See [String Resources](https://goo.gl/NdFZGI) for more information.", +"type": "string" +}, +"vibrateTimings": { +"description": "Set the vibration pattern to use. Pass in an array of [protobuf.Duration](https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#google.protobuf.Duration) to turn on or off the vibrator. The first value indicates the `Duration` to wait before turning the vibrator on. The next value indicates the `Duration` to keep the vibrator on. Subsequent values alternate between `Duration` to turn the vibrator off and to turn the vibrator on. If `vibrate_timings` is set and `default_vibrate_timings` is set to `true`, the default value is used instead of the user-specified `vibrate_timings`.", +"items": { +"format": "google-duration", +"type": "string" +}, +"type": "array" +}, +"visibility": { +"description": "Set the [Notification.visibility](https://developer.android.com/reference/android/app/Notification.html#visibility) of the notification.", +"enum": [ +"VISIBILITY_UNSPECIFIED", +"PRIVATE", +"PUBLIC", +"SECRET" +], +"enumDescriptions": [ +"If unspecified, default to `Visibility.PRIVATE`.", +"Show this notification on all lockscreens, but conceal sensitive or private information on secure lockscreens.", +"Show this notification in its entirety on all lockscreens.", +"Do not reveal any part of this notification on a secure lockscreen." +], +"type": "string" +} +}, +"type": "object" +}, +"AndroidRemoteNotification": { +"description": "A Remote Notification message that is sent to an Android device.", +"id": "AndroidRemoteNotification", +"properties": { +"mutableContent": { +"description": "Optional. If set to true, the notification content can be updated by the app after the notification is received on the device.", +"type": "boolean" +}, +"notification": { +"$ref": "AndroidNotificationV2", +"description": "Optional. Notification to send to android devices." +}, +"useAsV1DataMessage": { +"description": "Optional. If set to true, this RemoteNotification message will be delivered to legacy V1 clients as data messages by omitting the google.firebase.fcm.v1.Message.android_v2.remote_notification.notification. This should only be enabled when migration from legacy V1 data messages. Note that by default (when set to false), RemoteNotification messages are automatically translated to V1 notification message for legacy clients;", +"type": "boolean" +} +}, +"type": "object" +}, "ApnsConfig": { "description": "[Apple Push Notification Service](https://goo.gl/MXRTPa) specific options.", "id": "ApnsConfig", @@ -646,6 +874,27 @@ }, "type": "object" }, +"GoogleFirebaseFcmV1AndroidNotificationV2LightSettings": { +"description": "Settings to control notification LED.", +"id": "GoogleFirebaseFcmV1AndroidNotificationV2LightSettings", +"properties": { +"color": { +"$ref": "Color", +"description": "Required. Set `color` of the LED with [google.type.Color](https://github.com/googleapis/googleapis/blob/master/google/type/color.proto)." +}, +"lightOffDuration": { +"description": "Required. Along with `light_on_duration`, define the blink rate of LED flashes. Resolution defined by [proto.Duration](https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#google.protobuf.Duration)", +"format": "google-duration", +"type": "string" +}, +"lightOnDuration": { +"description": "Required. Along with `light_off_duration`, define the blink rate of LED flashes. Resolution defined by [proto.Duration](https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#google.protobuf.Duration)", +"format": "google-duration", +"type": "string" +} +}, +"type": "object" +}, "LightSettings": { "description": "Settings to control notification LED.", "id": "LightSettings", @@ -693,6 +942,10 @@ "$ref": "AndroidConfig", "description": "Input only. Android specific options for messages sent through [FCM connection server](https://goo.gl/4GLdUl)." }, +"androidV2": { +"$ref": "AndroidConfigV2", +"description": "Optional. Input only. Android specific V2 options for messages sent through FCM connection server. Mutually exclusive with `android`. Requests with both `AndroidConfig` and `AndroidConfigV2` will be rejected." +}, "apns": { "$ref": "ApnsConfig", "description": "Input only. [Apple Push Notification Service](https://goo.gl/MXRTPa) specific options." From 60be8ea315c76deddab913619e685bda04f6e933 Mon Sep 17 00:00:00 2001 From: Yoshi Automation Date: Tue, 20 Oct 2026 07:24:01 +0000 Subject: [PATCH 19/34] feat(file): update the api #### file:v1beta1 The following keys were added: - schemas.CreateFromSourceRequest.properties.requestId.type (Total Keys: 1) - schemas.UnfreezeVolumeRequest.properties.requestId.type (Total Keys: 1) --- .../file_v1beta1.projects.locations.instances.html | 8 ++++---- ...beta1.projects.locations.volumePools.volumes.html | 2 ++ .../discovery_cache/documents/file.v1beta1.json | 12 ++++++++++-- 3 files changed, 16 insertions(+), 6 deletions(-) diff --git a/docs/dyn/file_v1beta1.projects.locations.instances.html b/docs/dyn/file_v1beta1.projects.locations.instances.html index dc6f2e137b..207431d836 100644 --- a/docs/dyn/file_v1beta1.projects.locations.instances.html +++ b/docs/dyn/file_v1beta1.projects.locations.instances.html @@ -179,7 +179,7 @@

Method Details

}, ], "restoreConfig": { # Optional configuration for restore backup operations. # Optional. Input only. Specifies options for restoring from a backup source. Use this field to configure a partial restore, allowing recovery of specific files or directories instead of the entire backup. This field is only valid if the source oneof is set to `source_backup` or `source_backupdr_backup`. If this field is not provided, restoring from a backup will perform a full restore. - "pathPatterns": [ # Optional. Example: If you want to restore `/mnt/share/dir1/file.txt`, the path pattern must be `/dir1/file.txt`. If you want to restore `/mnt/share/dir1/`, the path pattern must be `/dir1`. Currently only single path is supported, Glob patterns are not supported. + "pathPatterns": [ # Optional. A collection of paths/patterns to restore from the backup. If empty, a full restore is performed. A valid path is relative to the file share's mount point and must not include a trailing slash. The path must start with a leading `/`. Example: If you want to restore `/mnt/share/dir1/file.txt`, the path pattern must be `/dir1/file.txt`. If you want to restore `/mnt/share/dir1/`, the path pattern must be `/dir1`. Currently only single path is supported, Glob patterns are not supported. "A String", ], }, @@ -380,7 +380,7 @@

Method Details

}, ], "restoreConfig": { # Optional configuration for restore backup operations. # Optional. Input only. Specifies options for restoring from a backup source. Use this field to configure a partial restore, allowing recovery of specific files or directories instead of the entire backup. This field is only valid if the source oneof is set to `source_backup` or `source_backupdr_backup`. If this field is not provided, restoring from a backup will perform a full restore. - "pathPatterns": [ # Optional. Example: If you want to restore `/mnt/share/dir1/file.txt`, the path pattern must be `/dir1/file.txt`. If you want to restore `/mnt/share/dir1/`, the path pattern must be `/dir1`. Currently only single path is supported, Glob patterns are not supported. + "pathPatterns": [ # Optional. A collection of paths/patterns to restore from the backup. If empty, a full restore is performed. A valid path is relative to the file share's mount point and must not include a trailing slash. The path must start with a leading `/`. Example: If you want to restore `/mnt/share/dir1/file.txt`, the path pattern must be `/dir1/file.txt`. If you want to restore `/mnt/share/dir1/`, the path pattern must be `/dir1`. Currently only single path is supported, Glob patterns are not supported. "A String", ], }, @@ -522,7 +522,7 @@

Method Details

}, ], "restoreConfig": { # Optional configuration for restore backup operations. # Optional. Input only. Specifies options for restoring from a backup source. Use this field to configure a partial restore, allowing recovery of specific files or directories instead of the entire backup. This field is only valid if the source oneof is set to `source_backup` or `source_backupdr_backup`. If this field is not provided, restoring from a backup will perform a full restore. - "pathPatterns": [ # Optional. Example: If you want to restore `/mnt/share/dir1/file.txt`, the path pattern must be `/dir1/file.txt`. If you want to restore `/mnt/share/dir1/`, the path pattern must be `/dir1`. Currently only single path is supported, Glob patterns are not supported. + "pathPatterns": [ # Optional. A collection of paths/patterns to restore from the backup. If empty, a full restore is performed. A valid path is relative to the file share's mount point and must not include a trailing slash. The path must start with a leading `/`. Example: If you want to restore `/mnt/share/dir1/file.txt`, the path pattern must be `/dir1/file.txt`. If you want to restore `/mnt/share/dir1/`, the path pattern must be `/dir1`. Currently only single path is supported, Glob patterns are not supported. "A String", ], }, @@ -673,7 +673,7 @@

Method Details

}, ], "restoreConfig": { # Optional configuration for restore backup operations. # Optional. Input only. Specifies options for restoring from a backup source. Use this field to configure a partial restore, allowing recovery of specific files or directories instead of the entire backup. This field is only valid if the source oneof is set to `source_backup` or `source_backupdr_backup`. If this field is not provided, restoring from a backup will perform a full restore. - "pathPatterns": [ # Optional. Example: If you want to restore `/mnt/share/dir1/file.txt`, the path pattern must be `/dir1/file.txt`. If you want to restore `/mnt/share/dir1/`, the path pattern must be `/dir1`. Currently only single path is supported, Glob patterns are not supported. + "pathPatterns": [ # Optional. A collection of paths/patterns to restore from the backup. If empty, a full restore is performed. A valid path is relative to the file share's mount point and must not include a trailing slash. The path must start with a leading `/`. Example: If you want to restore `/mnt/share/dir1/file.txt`, the path pattern must be `/dir1/file.txt`. If you want to restore `/mnt/share/dir1/`, the path pattern must be `/dir1`. Currently only single path is supported, Glob patterns are not supported. "A String", ], }, diff --git a/docs/dyn/file_v1beta1.projects.locations.volumePools.volumes.html b/docs/dyn/file_v1beta1.projects.locations.volumePools.volumes.html index 035f625be4..5e0a171123 100644 --- a/docs/dyn/file_v1beta1.projects.locations.volumePools.volumes.html +++ b/docs/dyn/file_v1beta1.projects.locations.volumePools.volumes.html @@ -219,6 +219,7 @@

Method Details

}, ], "quota": "A String", # Optional. The limit for how much data can be written to this volume, in MiB. + "requestId": "A String", # Optional. A unique ID used to identify the request, so retries are idempotent. Must be a valid UUID4; the zero UUID (`00000000-0000-0000-0000-000000000000`) is not supported. "volumeId": "A String", # Required. Unique identifier for the volume which also appears in the volumes resource name. } @@ -593,6 +594,7 @@

Method Details

}, ], "quota": "A String", # Optional. The limit for how much data can be written to this volume, in MiB. + "requestId": "A String", # Optional. A unique ID used to identify the request, so retries are idempotent. Must be a valid UUID4; the zero UUID (`00000000-0000-0000-0000-000000000000`) is not supported. } x__xgafv: string, V1 error format. diff --git a/googleapiclient/discovery_cache/documents/file.v1beta1.json b/googleapiclient/discovery_cache/documents/file.v1beta1.json index 3c7bac953c..72709985e3 100644 --- a/googleapiclient/discovery_cache/documents/file.v1beta1.json +++ b/googleapiclient/discovery_cache/documents/file.v1beta1.json @@ -1886,7 +1886,7 @@ } } }, -"revision": "20260927", +"revision": "20261006", "rootUrl": "https://file.googleapis.com/", "schemas": { "AcquireShareRequest": { @@ -2089,6 +2089,10 @@ "format": "int64", "type": "string" }, +"requestId": { +"description": "Optional. A unique ID used to identify the request, so retries are idempotent. Must be a valid UUID4; the zero UUID (`00000000-0000-0000-0000-000000000000`) is not supported.", +"type": "string" +}, "volumeId": { "description": "Required. Unique identifier for the volume which also appears in the volumes resource name.", "type": "string" @@ -3529,7 +3533,7 @@ "id": "RestoreConfig", "properties": { "pathPatterns": { -"description": "Optional. Example: If you want to restore `/mnt/share/dir1/file.txt`, the path pattern must be `/dir1/file.txt`. If you want to restore `/mnt/share/dir1/`, the path pattern must be `/dir1`. Currently only single path is supported, Glob patterns are not supported.", +"description": "Optional. A collection of paths/patterns to restore from the backup. If empty, a full restore is performed. A valid path is relative to the file share's mount point and must not include a trailing slash. The path must start with a leading `/`. Example: If you want to restore `/mnt/share/dir1/file.txt`, the path pattern must be `/dir1/file.txt`. If you want to restore `/mnt/share/dir1/`, the path pattern must be `/dir1`. Currently only single path is supported, Glob patterns are not supported.", "items": { "type": "string" }, @@ -3814,6 +3818,10 @@ "description": "Optional. The limit for how much data can be written to this volume, in MiB.", "format": "int64", "type": "string" +}, +"requestId": { +"description": "Optional. A unique ID used to identify the request, so retries are idempotent. Must be a valid UUID4; the zero UUID (`00000000-0000-0000-0000-000000000000`) is not supported.", +"type": "string" } }, "type": "object" From 726c9a0f931e43e9be15eb71e96cb35c9338dfad Mon Sep 17 00:00:00 2001 From: Yoshi Automation Date: Tue, 20 Oct 2026 07:24:01 +0000 Subject: [PATCH 20/34] feat(firebaseappcheck): update the api #### firebaseappcheck:v1beta The following keys were added: - resources.projects.resources.services.resources.automations.methods.get (Total Keys: 11) - resources.projects.resources.services.resources.automations.methods.list (Total Keys: 16) - resources.projects.resources.services.resources.automations.methods.patch (Total Keys: 15) - resources.projects.resources.services.resources.resourcePolicies.resources.automations.methods.get (Total Keys: 11) - resources.projects.resources.services.resources.resourcePolicies.resources.automations.methods.list (Total Keys: 16) - resources.projects.resources.services.resources.resourcePolicies.resources.automations.methods.patch (Total Keys: 15) - schemas.GoogleFirebaseAppcheckV1betaAutomation (Total Keys: 15) - schemas.GoogleFirebaseAppcheckV1betaListAutomationsResponse (Total Keys: 5) --- ..._v1beta.projects.services.automations.html | 208 +++++++++++++ ...baseappcheck_v1beta.projects.services.html | 5 + ...services.resourcePolicies.automations.html | 208 +++++++++++++ ...ta.projects.services.resourcePolicies.html | 5 + .../documents/firebaseappcheck.v1beta.json | 290 +++++++++++++++++- 5 files changed, 715 insertions(+), 1 deletion(-) create mode 100644 docs/dyn/firebaseappcheck_v1beta.projects.services.automations.html create mode 100644 docs/dyn/firebaseappcheck_v1beta.projects.services.resourcePolicies.automations.html diff --git a/docs/dyn/firebaseappcheck_v1beta.projects.services.automations.html b/docs/dyn/firebaseappcheck_v1beta.projects.services.automations.html new file mode 100644 index 0000000000..471e8a6709 --- /dev/null +++ b/docs/dyn/firebaseappcheck_v1beta.projects.services.automations.html @@ -0,0 +1,208 @@ + + + +

Firebase App Check API . projects . services . automations

+

Instance Methods

+

+ close()

+

Close httplib2 connections.

+

+ get(name, x__xgafv=None)

+

Gets the specified Automation configuration.

+

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

+

Lists all Automations for the specified service or resource policy.

+

+ list_next(previous_request, previous_response)

+

Retrieves the next page of results.

+

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

+

Updates the specified Automation.

+

Method Details

+
+ close() + 
Close httplib2 connections.
+
+ +
+ get(name, x__xgafv=None) + 
Gets the specified Automation configuration.
+
+Args:
+  name: string, Required. The relative resource name of the Automation to retrieve, in one of the following supported formats: ``` projects/{project_number}/services/{service_id}/automations/{automation_id} projects/{project_number}/services/{service_id}/resourcePolicies/{resource_policy_id}/automations/{automation_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 **enforcement automation** is useful for automatically enforcing a service or a resource policy within a service when a certain condition is met. For example, you may create an automation that automatically turns on enforcement for your Cloud Firestore service at a specified timestamp in the future. For your security, an automation object may be created by the system in order to protect sensitive services by default. These *system-created* automations can be opted out, if you so choose, by calling the SuspendAutomation method on them. Suspending a system-created automation is not recommended, but is supported for advanced use cases. The system will not execute nor modify any suspended automations. Also, system-created automations **cannot** be deleted, but can be freely modified, which is also not recommended, as the system may later overwrite your changes with its own default settings without notice (assuming it has not been suspended). An automation's condition is evaluated periodically; the frequency of this periodic evaluation depends on the exact condition. While the details are unspecified, evaluations will be conducted reasonably frequently so that a satisfied condition will be detected in a timely fashion. Once a condition has been detected to be satisfied, the enforcement action will be executed immediately. Currently, the only enforcement action supported is to **enforce** App Check protections on the associated parent service or parent resource policy. Once executed, the automation becomes immutable, and serves as a historical record of that execution. Its `update_time` field will be populated with the timestamp at which the execution occurred, and its `state` field will be set to `SUCCEEDED`. Successful automations not created by the system can still be deleted. If, during the evaluation or execution of an automation, App Check discovers that it is no longer possible for the service or resource to receive App Check protection, App Check may suspend your automation without warning. For example, if you have disabled a service, or have deleted all resources within a service, and that service does not support storing your App Check preferences while it is in such a state, then an automation created for this service may be suspended. Please ensure that the service or resource is correctly configured and operating normally throughout the lifetime of the automation to avoid suspension.
+  "createTime": "A String", # Output only. Timestamp at which this automation object was created.
+  "etag": "A String", # This checksum is computed by the server based on the value of other fields, and may be sent on update and delete requests to ensure the client has an up-to-date value before proceeding. This etag is strongly validated as defined by RFC 7232.
+  "name": "A String", # Identifier. The relative resource name of the automation object, in one of the following supported formats: ``` projects/{project_number}/services/{service_id}/automations/{automation_id} projects/{project_number}/services/{service_id}/resourcePolicies/{resource_policy_id}/automations/{automation_id} ```
+  "origin": "A String", # Output only. The original creator of this automation object.
+  "state": "A String", # Output only. The state that this automation object is currently in.
+  "triggerTime": "A String", # A condition that is satisfied if the current time is greater than or equal to the specified timestamp.
+  "updateTime": "A String", # Output only. Timestamp at which this automation object was most recently updated, either by the system or by the user. If this automation has already been executed, this field indicates the exact timestamp at which it was executed.
+}
+
+ +
+ list(parent, pageSize=None, pageToken=None, x__xgafv=None) + 
Lists all Automations for the specified service or resource policy.
+
+Args:
+  parent: string, Required. The relative resource name of the parent service or resource policy for which to list each associated Automation, in one of the following formats: ``` projects/{project_number}/services/{service_id} projects/{project_number}/services/{service_id}/resourcePolicies/{resource_policy_id} ``` (required)
+  pageSize: integer, The maximum number of Automations to return in the response. Note that a service or resource policy can have at most 10 automations. The server may return fewer than this at its own discretion. If no value is specified (or too large a value is specified), the server will impose its own limit.
+  pageToken: string, Token returned from a previous call to ListAutomations indicating where in the set of Automations to resume listing. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to ListAutomations must match the call that provided the page token; if they do not match, the result is undefined.
+  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 ListAutomations method.
+  "automations": [ # The Automations retrieved.
+    { # An **enforcement automation** is useful for automatically enforcing a service or a resource policy within a service when a certain condition is met. For example, you may create an automation that automatically turns on enforcement for your Cloud Firestore service at a specified timestamp in the future. For your security, an automation object may be created by the system in order to protect sensitive services by default. These *system-created* automations can be opted out, if you so choose, by calling the SuspendAutomation method on them. Suspending a system-created automation is not recommended, but is supported for advanced use cases. The system will not execute nor modify any suspended automations. Also, system-created automations **cannot** be deleted, but can be freely modified, which is also not recommended, as the system may later overwrite your changes with its own default settings without notice (assuming it has not been suspended). An automation's condition is evaluated periodically; the frequency of this periodic evaluation depends on the exact condition. While the details are unspecified, evaluations will be conducted reasonably frequently so that a satisfied condition will be detected in a timely fashion. Once a condition has been detected to be satisfied, the enforcement action will be executed immediately. Currently, the only enforcement action supported is to **enforce** App Check protections on the associated parent service or parent resource policy. Once executed, the automation becomes immutable, and serves as a historical record of that execution. Its `update_time` field will be populated with the timestamp at which the execution occurred, and its `state` field will be set to `SUCCEEDED`. Successful automations not created by the system can still be deleted. If, during the evaluation or execution of an automation, App Check discovers that it is no longer possible for the service or resource to receive App Check protection, App Check may suspend your automation without warning. For example, if you have disabled a service, or have deleted all resources within a service, and that service does not support storing your App Check preferences while it is in such a state, then an automation created for this service may be suspended. Please ensure that the service or resource is correctly configured and operating normally throughout the lifetime of the automation to avoid suspension.
+      "createTime": "A String", # Output only. Timestamp at which this automation object was created.
+      "etag": "A String", # This checksum is computed by the server based on the value of other fields, and may be sent on update and delete requests to ensure the client has an up-to-date value before proceeding. This etag is strongly validated as defined by RFC 7232.
+      "name": "A String", # Identifier. The relative resource name of the automation object, in one of the following supported formats: ``` projects/{project_number}/services/{service_id}/automations/{automation_id} projects/{project_number}/services/{service_id}/resourcePolicies/{resource_policy_id}/automations/{automation_id} ```
+      "origin": "A String", # Output only. The original creator of this automation object.
+      "state": "A String", # Output only. The state that this automation object is currently in.
+      "triggerTime": "A String", # A condition that is satisfied if the current time is greater than or equal to the specified timestamp.
+      "updateTime": "A String", # Output only. Timestamp at which this automation object was most recently updated, either by the system or by the user. If this automation has already been executed, this field indicates the exact timestamp at which it was executed.
+    },
+  ],
+  "nextPageToken": "A String", # If the result list is too large to fit in a single response, then a token is returned. If the string is empty or omitted, then this response is the last page of results. This token can be used in a subsequent call to ListAutomations to find the next group of Automations. Page tokens are short-lived and should not be persisted.
+}
+
+ +
+ list_next(previous_request, previous_response) + 
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 specified Automation.
+
+Args:
+  name: string, Identifier. The relative resource name of the automation object, in one of the following supported formats: ``` projects/{project_number}/services/{service_id}/automations/{automation_id} projects/{project_number}/services/{service_id}/resourcePolicies/{resource_policy_id}/automations/{automation_id} ``` (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # An **enforcement automation** is useful for automatically enforcing a service or a resource policy within a service when a certain condition is met. For example, you may create an automation that automatically turns on enforcement for your Cloud Firestore service at a specified timestamp in the future. For your security, an automation object may be created by the system in order to protect sensitive services by default. These *system-created* automations can be opted out, if you so choose, by calling the SuspendAutomation method on them. Suspending a system-created automation is not recommended, but is supported for advanced use cases. The system will not execute nor modify any suspended automations. Also, system-created automations **cannot** be deleted, but can be freely modified, which is also not recommended, as the system may later overwrite your changes with its own default settings without notice (assuming it has not been suspended). An automation's condition is evaluated periodically; the frequency of this periodic evaluation depends on the exact condition. While the details are unspecified, evaluations will be conducted reasonably frequently so that a satisfied condition will be detected in a timely fashion. Once a condition has been detected to be satisfied, the enforcement action will be executed immediately. Currently, the only enforcement action supported is to **enforce** App Check protections on the associated parent service or parent resource policy. Once executed, the automation becomes immutable, and serves as a historical record of that execution. Its `update_time` field will be populated with the timestamp at which the execution occurred, and its `state` field will be set to `SUCCEEDED`. Successful automations not created by the system can still be deleted. If, during the evaluation or execution of an automation, App Check discovers that it is no longer possible for the service or resource to receive App Check protection, App Check may suspend your automation without warning. For example, if you have disabled a service, or have deleted all resources within a service, and that service does not support storing your App Check preferences while it is in such a state, then an automation created for this service may be suspended. Please ensure that the service or resource is correctly configured and operating normally throughout the lifetime of the automation to avoid suspension.
+  "createTime": "A String", # Output only. Timestamp at which this automation object was created.
+  "etag": "A String", # This checksum is computed by the server based on the value of other fields, and may be sent on update and delete requests to ensure the client has an up-to-date value before proceeding. This etag is strongly validated as defined by RFC 7232.
+  "name": "A String", # Identifier. The relative resource name of the automation object, in one of the following supported formats: ``` projects/{project_number}/services/{service_id}/automations/{automation_id} projects/{project_number}/services/{service_id}/resourcePolicies/{resource_policy_id}/automations/{automation_id} ```
+  "origin": "A String", # Output only. The original creator of this automation object.
+  "state": "A String", # Output only. The state that this automation object is currently in.
+  "triggerTime": "A String", # A condition that is satisfied if the current time is greater than or equal to the specified timestamp.
+  "updateTime": "A String", # Output only. Timestamp at which this automation object was most recently updated, either by the system or by the user. If this automation has already been executed, this field indicates the exact timestamp at which it was executed.
+}
+
+  updateMask: string, Required. A comma-separated list of names of fields in the Automation to update. Example: `timestamp_condition.enforce_time`.
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # An **enforcement automation** is useful for automatically enforcing a service or a resource policy within a service when a certain condition is met. For example, you may create an automation that automatically turns on enforcement for your Cloud Firestore service at a specified timestamp in the future. For your security, an automation object may be created by the system in order to protect sensitive services by default. These *system-created* automations can be opted out, if you so choose, by calling the SuspendAutomation method on them. Suspending a system-created automation is not recommended, but is supported for advanced use cases. The system will not execute nor modify any suspended automations. Also, system-created automations **cannot** be deleted, but can be freely modified, which is also not recommended, as the system may later overwrite your changes with its own default settings without notice (assuming it has not been suspended). An automation's condition is evaluated periodically; the frequency of this periodic evaluation depends on the exact condition. While the details are unspecified, evaluations will be conducted reasonably frequently so that a satisfied condition will be detected in a timely fashion. Once a condition has been detected to be satisfied, the enforcement action will be executed immediately. Currently, the only enforcement action supported is to **enforce** App Check protections on the associated parent service or parent resource policy. Once executed, the automation becomes immutable, and serves as a historical record of that execution. Its `update_time` field will be populated with the timestamp at which the execution occurred, and its `state` field will be set to `SUCCEEDED`. Successful automations not created by the system can still be deleted. If, during the evaluation or execution of an automation, App Check discovers that it is no longer possible for the service or resource to receive App Check protection, App Check may suspend your automation without warning. For example, if you have disabled a service, or have deleted all resources within a service, and that service does not support storing your App Check preferences while it is in such a state, then an automation created for this service may be suspended. Please ensure that the service or resource is correctly configured and operating normally throughout the lifetime of the automation to avoid suspension.
+  "createTime": "A String", # Output only. Timestamp at which this automation object was created.
+  "etag": "A String", # This checksum is computed by the server based on the value of other fields, and may be sent on update and delete requests to ensure the client has an up-to-date value before proceeding. This etag is strongly validated as defined by RFC 7232.
+  "name": "A String", # Identifier. The relative resource name of the automation object, in one of the following supported formats: ``` projects/{project_number}/services/{service_id}/automations/{automation_id} projects/{project_number}/services/{service_id}/resourcePolicies/{resource_policy_id}/automations/{automation_id} ```
+  "origin": "A String", # Output only. The original creator of this automation object.
+  "state": "A String", # Output only. The state that this automation object is currently in.
+  "triggerTime": "A String", # A condition that is satisfied if the current time is greater than or equal to the specified timestamp.
+  "updateTime": "A String", # Output only. Timestamp at which this automation object was most recently updated, either by the system or by the user. If this automation has already been executed, this field indicates the exact timestamp at which it was executed.
+}
+
+ + \ No newline at end of file diff --git a/docs/dyn/firebaseappcheck_v1beta.projects.services.html b/docs/dyn/firebaseappcheck_v1beta.projects.services.html index 030cf70990..10b7ad6daa 100644 --- a/docs/dyn/firebaseappcheck_v1beta.projects.services.html +++ b/docs/dyn/firebaseappcheck_v1beta.projects.services.html @@ -74,6 +74,11 @@

Firebase App Check API . projects . services

Instance Methods

+

+ automations() +

+

Returns the automations Resource.

+

resourcePolicies()

diff --git a/docs/dyn/firebaseappcheck_v1beta.projects.services.resourcePolicies.automations.html b/docs/dyn/firebaseappcheck_v1beta.projects.services.resourcePolicies.automations.html new file mode 100644 index 0000000000..be7833278d --- /dev/null +++ b/docs/dyn/firebaseappcheck_v1beta.projects.services.resourcePolicies.automations.html @@ -0,0 +1,208 @@ + + + +

Firebase App Check API . projects . services . resourcePolicies . automations

+

Instance Methods

+

+ close()

+

Close httplib2 connections.

+

+ get(name, x__xgafv=None)

+

Gets the specified Automation configuration.

+

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

+

Lists all Automations for the specified service or resource policy.

+

+ list_next(previous_request, previous_response)

+

Retrieves the next page of results.

+

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

+

Updates the specified Automation.

+

Method Details

+
+ close() + 
Close httplib2 connections.
+
+ +
+ get(name, x__xgafv=None) + 
Gets the specified Automation configuration.
+
+Args:
+  name: string, Required. The relative resource name of the Automation to retrieve, in one of the following supported formats: ``` projects/{project_number}/services/{service_id}/automations/{automation_id} projects/{project_number}/services/{service_id}/resourcePolicies/{resource_policy_id}/automations/{automation_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 **enforcement automation** is useful for automatically enforcing a service or a resource policy within a service when a certain condition is met. For example, you may create an automation that automatically turns on enforcement for your Cloud Firestore service at a specified timestamp in the future. For your security, an automation object may be created by the system in order to protect sensitive services by default. These *system-created* automations can be opted out, if you so choose, by calling the SuspendAutomation method on them. Suspending a system-created automation is not recommended, but is supported for advanced use cases. The system will not execute nor modify any suspended automations. Also, system-created automations **cannot** be deleted, but can be freely modified, which is also not recommended, as the system may later overwrite your changes with its own default settings without notice (assuming it has not been suspended). An automation's condition is evaluated periodically; the frequency of this periodic evaluation depends on the exact condition. While the details are unspecified, evaluations will be conducted reasonably frequently so that a satisfied condition will be detected in a timely fashion. Once a condition has been detected to be satisfied, the enforcement action will be executed immediately. Currently, the only enforcement action supported is to **enforce** App Check protections on the associated parent service or parent resource policy. Once executed, the automation becomes immutable, and serves as a historical record of that execution. Its `update_time` field will be populated with the timestamp at which the execution occurred, and its `state` field will be set to `SUCCEEDED`. Successful automations not created by the system can still be deleted. If, during the evaluation or execution of an automation, App Check discovers that it is no longer possible for the service or resource to receive App Check protection, App Check may suspend your automation without warning. For example, if you have disabled a service, or have deleted all resources within a service, and that service does not support storing your App Check preferences while it is in such a state, then an automation created for this service may be suspended. Please ensure that the service or resource is correctly configured and operating normally throughout the lifetime of the automation to avoid suspension.
+  "createTime": "A String", # Output only. Timestamp at which this automation object was created.
+  "etag": "A String", # This checksum is computed by the server based on the value of other fields, and may be sent on update and delete requests to ensure the client has an up-to-date value before proceeding. This etag is strongly validated as defined by RFC 7232.
+  "name": "A String", # Identifier. The relative resource name of the automation object, in one of the following supported formats: ``` projects/{project_number}/services/{service_id}/automations/{automation_id} projects/{project_number}/services/{service_id}/resourcePolicies/{resource_policy_id}/automations/{automation_id} ```
+  "origin": "A String", # Output only. The original creator of this automation object.
+  "state": "A String", # Output only. The state that this automation object is currently in.
+  "triggerTime": "A String", # A condition that is satisfied if the current time is greater than or equal to the specified timestamp.
+  "updateTime": "A String", # Output only. Timestamp at which this automation object was most recently updated, either by the system or by the user. If this automation has already been executed, this field indicates the exact timestamp at which it was executed.
+}
+
+ +
+ list(parent, pageSize=None, pageToken=None, x__xgafv=None) + 
Lists all Automations for the specified service or resource policy.
+
+Args:
+  parent: string, Required. The relative resource name of the parent service or resource policy for which to list each associated Automation, in one of the following formats: ``` projects/{project_number}/services/{service_id} projects/{project_number}/services/{service_id}/resourcePolicies/{resource_policy_id} ``` (required)
+  pageSize: integer, The maximum number of Automations to return in the response. Note that a service or resource policy can have at most 10 automations. The server may return fewer than this at its own discretion. If no value is specified (or too large a value is specified), the server will impose its own limit.
+  pageToken: string, Token returned from a previous call to ListAutomations indicating where in the set of Automations to resume listing. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to ListAutomations must match the call that provided the page token; if they do not match, the result is undefined.
+  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 ListAutomations method.
+  "automations": [ # The Automations retrieved.
+    { # An **enforcement automation** is useful for automatically enforcing a service or a resource policy within a service when a certain condition is met. For example, you may create an automation that automatically turns on enforcement for your Cloud Firestore service at a specified timestamp in the future. For your security, an automation object may be created by the system in order to protect sensitive services by default. These *system-created* automations can be opted out, if you so choose, by calling the SuspendAutomation method on them. Suspending a system-created automation is not recommended, but is supported for advanced use cases. The system will not execute nor modify any suspended automations. Also, system-created automations **cannot** be deleted, but can be freely modified, which is also not recommended, as the system may later overwrite your changes with its own default settings without notice (assuming it has not been suspended). An automation's condition is evaluated periodically; the frequency of this periodic evaluation depends on the exact condition. While the details are unspecified, evaluations will be conducted reasonably frequently so that a satisfied condition will be detected in a timely fashion. Once a condition has been detected to be satisfied, the enforcement action will be executed immediately. Currently, the only enforcement action supported is to **enforce** App Check protections on the associated parent service or parent resource policy. Once executed, the automation becomes immutable, and serves as a historical record of that execution. Its `update_time` field will be populated with the timestamp at which the execution occurred, and its `state` field will be set to `SUCCEEDED`. Successful automations not created by the system can still be deleted. If, during the evaluation or execution of an automation, App Check discovers that it is no longer possible for the service or resource to receive App Check protection, App Check may suspend your automation without warning. For example, if you have disabled a service, or have deleted all resources within a service, and that service does not support storing your App Check preferences while it is in such a state, then an automation created for this service may be suspended. Please ensure that the service or resource is correctly configured and operating normally throughout the lifetime of the automation to avoid suspension.
+      "createTime": "A String", # Output only. Timestamp at which this automation object was created.
+      "etag": "A String", # This checksum is computed by the server based on the value of other fields, and may be sent on update and delete requests to ensure the client has an up-to-date value before proceeding. This etag is strongly validated as defined by RFC 7232.
+      "name": "A String", # Identifier. The relative resource name of the automation object, in one of the following supported formats: ``` projects/{project_number}/services/{service_id}/automations/{automation_id} projects/{project_number}/services/{service_id}/resourcePolicies/{resource_policy_id}/automations/{automation_id} ```
+      "origin": "A String", # Output only. The original creator of this automation object.
+      "state": "A String", # Output only. The state that this automation object is currently in.
+      "triggerTime": "A String", # A condition that is satisfied if the current time is greater than or equal to the specified timestamp.
+      "updateTime": "A String", # Output only. Timestamp at which this automation object was most recently updated, either by the system or by the user. If this automation has already been executed, this field indicates the exact timestamp at which it was executed.
+    },
+  ],
+  "nextPageToken": "A String", # If the result list is too large to fit in a single response, then a token is returned. If the string is empty or omitted, then this response is the last page of results. This token can be used in a subsequent call to ListAutomations to find the next group of Automations. Page tokens are short-lived and should not be persisted.
+}
+
+ +
+ list_next(previous_request, previous_response) + 
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 specified Automation.
+
+Args:
+  name: string, Identifier. The relative resource name of the automation object, in one of the following supported formats: ``` projects/{project_number}/services/{service_id}/automations/{automation_id} projects/{project_number}/services/{service_id}/resourcePolicies/{resource_policy_id}/automations/{automation_id} ``` (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # An **enforcement automation** is useful for automatically enforcing a service or a resource policy within a service when a certain condition is met. For example, you may create an automation that automatically turns on enforcement for your Cloud Firestore service at a specified timestamp in the future. For your security, an automation object may be created by the system in order to protect sensitive services by default. These *system-created* automations can be opted out, if you so choose, by calling the SuspendAutomation method on them. Suspending a system-created automation is not recommended, but is supported for advanced use cases. The system will not execute nor modify any suspended automations. Also, system-created automations **cannot** be deleted, but can be freely modified, which is also not recommended, as the system may later overwrite your changes with its own default settings without notice (assuming it has not been suspended). An automation's condition is evaluated periodically; the frequency of this periodic evaluation depends on the exact condition. While the details are unspecified, evaluations will be conducted reasonably frequently so that a satisfied condition will be detected in a timely fashion. Once a condition has been detected to be satisfied, the enforcement action will be executed immediately. Currently, the only enforcement action supported is to **enforce** App Check protections on the associated parent service or parent resource policy. Once executed, the automation becomes immutable, and serves as a historical record of that execution. Its `update_time` field will be populated with the timestamp at which the execution occurred, and its `state` field will be set to `SUCCEEDED`. Successful automations not created by the system can still be deleted. If, during the evaluation or execution of an automation, App Check discovers that it is no longer possible for the service or resource to receive App Check protection, App Check may suspend your automation without warning. For example, if you have disabled a service, or have deleted all resources within a service, and that service does not support storing your App Check preferences while it is in such a state, then an automation created for this service may be suspended. Please ensure that the service or resource is correctly configured and operating normally throughout the lifetime of the automation to avoid suspension.
+  "createTime": "A String", # Output only. Timestamp at which this automation object was created.
+  "etag": "A String", # This checksum is computed by the server based on the value of other fields, and may be sent on update and delete requests to ensure the client has an up-to-date value before proceeding. This etag is strongly validated as defined by RFC 7232.
+  "name": "A String", # Identifier. The relative resource name of the automation object, in one of the following supported formats: ``` projects/{project_number}/services/{service_id}/automations/{automation_id} projects/{project_number}/services/{service_id}/resourcePolicies/{resource_policy_id}/automations/{automation_id} ```
+  "origin": "A String", # Output only. The original creator of this automation object.
+  "state": "A String", # Output only. The state that this automation object is currently in.
+  "triggerTime": "A String", # A condition that is satisfied if the current time is greater than or equal to the specified timestamp.
+  "updateTime": "A String", # Output only. Timestamp at which this automation object was most recently updated, either by the system or by the user. If this automation has already been executed, this field indicates the exact timestamp at which it was executed.
+}
+
+  updateMask: string, Required. A comma-separated list of names of fields in the Automation to update. Example: `timestamp_condition.enforce_time`.
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # An **enforcement automation** is useful for automatically enforcing a service or a resource policy within a service when a certain condition is met. For example, you may create an automation that automatically turns on enforcement for your Cloud Firestore service at a specified timestamp in the future. For your security, an automation object may be created by the system in order to protect sensitive services by default. These *system-created* automations can be opted out, if you so choose, by calling the SuspendAutomation method on them. Suspending a system-created automation is not recommended, but is supported for advanced use cases. The system will not execute nor modify any suspended automations. Also, system-created automations **cannot** be deleted, but can be freely modified, which is also not recommended, as the system may later overwrite your changes with its own default settings without notice (assuming it has not been suspended). An automation's condition is evaluated periodically; the frequency of this periodic evaluation depends on the exact condition. While the details are unspecified, evaluations will be conducted reasonably frequently so that a satisfied condition will be detected in a timely fashion. Once a condition has been detected to be satisfied, the enforcement action will be executed immediately. Currently, the only enforcement action supported is to **enforce** App Check protections on the associated parent service or parent resource policy. Once executed, the automation becomes immutable, and serves as a historical record of that execution. Its `update_time` field will be populated with the timestamp at which the execution occurred, and its `state` field will be set to `SUCCEEDED`. Successful automations not created by the system can still be deleted. If, during the evaluation or execution of an automation, App Check discovers that it is no longer possible for the service or resource to receive App Check protection, App Check may suspend your automation without warning. For example, if you have disabled a service, or have deleted all resources within a service, and that service does not support storing your App Check preferences while it is in such a state, then an automation created for this service may be suspended. Please ensure that the service or resource is correctly configured and operating normally throughout the lifetime of the automation to avoid suspension.
+  "createTime": "A String", # Output only. Timestamp at which this automation object was created.
+  "etag": "A String", # This checksum is computed by the server based on the value of other fields, and may be sent on update and delete requests to ensure the client has an up-to-date value before proceeding. This etag is strongly validated as defined by RFC 7232.
+  "name": "A String", # Identifier. The relative resource name of the automation object, in one of the following supported formats: ``` projects/{project_number}/services/{service_id}/automations/{automation_id} projects/{project_number}/services/{service_id}/resourcePolicies/{resource_policy_id}/automations/{automation_id} ```
+  "origin": "A String", # Output only. The original creator of this automation object.
+  "state": "A String", # Output only. The state that this automation object is currently in.
+  "triggerTime": "A String", # A condition that is satisfied if the current time is greater than or equal to the specified timestamp.
+  "updateTime": "A String", # Output only. Timestamp at which this automation object was most recently updated, either by the system or by the user. If this automation has already been executed, this field indicates the exact timestamp at which it was executed.
+}
+
+ + \ No newline at end of file diff --git a/docs/dyn/firebaseappcheck_v1beta.projects.services.resourcePolicies.html b/docs/dyn/firebaseappcheck_v1beta.projects.services.resourcePolicies.html index b5b25b03d3..8297f800db 100644 --- a/docs/dyn/firebaseappcheck_v1beta.projects.services.resourcePolicies.html +++ b/docs/dyn/firebaseappcheck_v1beta.projects.services.resourcePolicies.html @@ -74,6 +74,11 @@

Firebase App Check API . projects . services . resourcePolicies

Instance Methods

+

+ automations() +

+

Returns the automations Resource.

+

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

Atomically updates the specified ResourcePolicy configurations.

diff --git a/googleapiclient/discovery_cache/documents/firebaseappcheck.v1beta.json b/googleapiclient/discovery_cache/documents/firebaseappcheck.v1beta.json index e72a7cb54f..57594a892e 100644 --- a/googleapiclient/discovery_cache/documents/firebaseappcheck.v1beta.json +++ b/googleapiclient/discovery_cache/documents/firebaseappcheck.v1beta.json @@ -1525,6 +1525,108 @@ } }, "resources": { +"automations": { +"methods": { +"get": { +"description": "Gets the specified Automation configuration.", +"flatPath": "v1beta/projects/{projectsId}/services/{servicesId}/automations/{automationsId}", +"httpMethod": "GET", +"id": "firebaseappcheck.projects.services.automations.get", +"parameterOrder": [ +"name" +], +"parameters": { +"name": { +"description": "Required. The relative resource name of the Automation to retrieve, in one of the following supported formats: ``` projects/{project_number}/services/{service_id}/automations/{automation_id} projects/{project_number}/services/{service_id}/resourcePolicies/{resource_policy_id}/automations/{automation_id} ```", +"location": "path", +"pattern": "^projects/[^/]+/services/[^/]+/automations/[^/]+$", +"required": true, +"type": "string" +} +}, +"path": "v1beta/{+name}", +"response": { +"$ref": "GoogleFirebaseAppcheckV1betaAutomation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/firebase" +] +}, +"list": { +"description": "Lists all Automations for the specified service or resource policy.", +"flatPath": "v1beta/projects/{projectsId}/services/{servicesId}/automations", +"httpMethod": "GET", +"id": "firebaseappcheck.projects.services.automations.list", +"parameterOrder": [ +"parent" +], +"parameters": { +"pageSize": { +"description": "The maximum number of Automations to return in the response. Note that a service or resource policy can have at most 10 automations. The server may return fewer than this at its own discretion. If no value is specified (or too large a value is specified), the server will impose its own limit.", +"format": "int32", +"location": "query", +"type": "integer" +}, +"pageToken": { +"description": "Token returned from a previous call to ListAutomations indicating where in the set of Automations to resume listing. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to ListAutomations must match the call that provided the page token; if they do not match, the result is undefined.", +"location": "query", +"type": "string" +}, +"parent": { +"description": "Required. The relative resource name of the parent service or resource policy for which to list each associated Automation, in one of the following formats: ``` projects/{project_number}/services/{service_id} projects/{project_number}/services/{service_id}/resourcePolicies/{resource_policy_id} ```", +"location": "path", +"pattern": "^projects/[^/]+/services/[^/]+$", +"required": true, +"type": "string" +} +}, +"path": "v1beta/{+parent}/automations", +"response": { +"$ref": "GoogleFirebaseAppcheckV1betaListAutomationsResponse" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/firebase" +] +}, +"patch": { +"description": "Updates the specified Automation.", +"flatPath": "v1beta/projects/{projectsId}/services/{servicesId}/automations/{automationsId}", +"httpMethod": "PATCH", +"id": "firebaseappcheck.projects.services.automations.patch", +"parameterOrder": [ +"name" +], +"parameters": { +"name": { +"description": "Identifier. The relative resource name of the automation object, in one of the following supported formats: ``` projects/{project_number}/services/{service_id}/automations/{automation_id} projects/{project_number}/services/{service_id}/resourcePolicies/{resource_policy_id}/automations/{automation_id} ```", +"location": "path", +"pattern": "^projects/[^/]+/services/[^/]+/automations/[^/]+$", +"required": true, +"type": "string" +}, +"updateMask": { +"description": "Required. A comma-separated list of names of fields in the Automation to update. Example: `timestamp_condition.enforce_time`.", +"format": "google-fieldmask", +"location": "query", +"type": "string" +} +}, +"path": "v1beta/{+name}", +"request": { +"$ref": "GoogleFirebaseAppcheckV1betaAutomation" +}, +"response": { +"$ref": "GoogleFirebaseAppcheckV1betaAutomation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/firebase" +] +} +} +}, "resourcePolicies": { "methods": { "batchUpdate": { @@ -1719,6 +1821,110 @@ "https://www.googleapis.com/auth/firebase" ] } +}, +"resources": { +"automations": { +"methods": { +"get": { +"description": "Gets the specified Automation configuration.", +"flatPath": "v1beta/projects/{projectsId}/services/{servicesId}/resourcePolicies/{resourcePoliciesId}/automations/{automationsId}", +"httpMethod": "GET", +"id": "firebaseappcheck.projects.services.resourcePolicies.automations.get", +"parameterOrder": [ +"name" +], +"parameters": { +"name": { +"description": "Required. The relative resource name of the Automation to retrieve, in one of the following supported formats: ``` projects/{project_number}/services/{service_id}/automations/{automation_id} projects/{project_number}/services/{service_id}/resourcePolicies/{resource_policy_id}/automations/{automation_id} ```", +"location": "path", +"pattern": "^projects/[^/]+/services/[^/]+/resourcePolicies/[^/]+/automations/[^/]+$", +"required": true, +"type": "string" +} +}, +"path": "v1beta/{+name}", +"response": { +"$ref": "GoogleFirebaseAppcheckV1betaAutomation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/firebase" +] +}, +"list": { +"description": "Lists all Automations for the specified service or resource policy.", +"flatPath": "v1beta/projects/{projectsId}/services/{servicesId}/resourcePolicies/{resourcePoliciesId}/automations", +"httpMethod": "GET", +"id": "firebaseappcheck.projects.services.resourcePolicies.automations.list", +"parameterOrder": [ +"parent" +], +"parameters": { +"pageSize": { +"description": "The maximum number of Automations to return in the response. Note that a service or resource policy can have at most 10 automations. The server may return fewer than this at its own discretion. If no value is specified (or too large a value is specified), the server will impose its own limit.", +"format": "int32", +"location": "query", +"type": "integer" +}, +"pageToken": { +"description": "Token returned from a previous call to ListAutomations indicating where in the set of Automations to resume listing. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to ListAutomations must match the call that provided the page token; if they do not match, the result is undefined.", +"location": "query", +"type": "string" +}, +"parent": { +"description": "Required. The relative resource name of the parent service or resource policy for which to list each associated Automation, in one of the following formats: ``` projects/{project_number}/services/{service_id} projects/{project_number}/services/{service_id}/resourcePolicies/{resource_policy_id} ```", +"location": "path", +"pattern": "^projects/[^/]+/services/[^/]+/resourcePolicies/[^/]+$", +"required": true, +"type": "string" +} +}, +"path": "v1beta/{+parent}/automations", +"response": { +"$ref": "GoogleFirebaseAppcheckV1betaListAutomationsResponse" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/firebase" +] +}, +"patch": { +"description": "Updates the specified Automation.", +"flatPath": "v1beta/projects/{projectsId}/services/{servicesId}/resourcePolicies/{resourcePoliciesId}/automations/{automationsId}", +"httpMethod": "PATCH", +"id": "firebaseappcheck.projects.services.resourcePolicies.automations.patch", +"parameterOrder": [ +"name" +], +"parameters": { +"name": { +"description": "Identifier. The relative resource name of the automation object, in one of the following supported formats: ``` projects/{project_number}/services/{service_id}/automations/{automation_id} projects/{project_number}/services/{service_id}/resourcePolicies/{resource_policy_id}/automations/{automation_id} ```", +"location": "path", +"pattern": "^projects/[^/]+/services/[^/]+/resourcePolicies/[^/]+/automations/[^/]+$", +"required": true, +"type": "string" +}, +"updateMask": { +"description": "Required. A comma-separated list of names of fields in the Automation to update. Example: `timestamp_condition.enforce_time`.", +"format": "google-fieldmask", +"location": "query", +"type": "string" +} +}, +"path": "v1beta/{+name}", +"request": { +"$ref": "GoogleFirebaseAppcheckV1betaAutomation" +}, +"response": { +"$ref": "GoogleFirebaseAppcheckV1betaAutomation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/firebase" +] +} +} +} } } } @@ -1726,7 +1932,7 @@ } } }, -"revision": "20260918", +"revision": "20261010", "rootUrl": "https://firebaseappcheck.googleapis.com/", "schemas": { "GoogleFirebaseAppcheckV1betaAppAttestConfig": { @@ -1783,6 +1989,70 @@ }, "type": "object" }, +"GoogleFirebaseAppcheckV1betaAutomation": { +"description": "An **enforcement automation** is useful for automatically enforcing a service or a resource policy within a service when a certain condition is met. For example, you may create an automation that automatically turns on enforcement for your Cloud Firestore service at a specified timestamp in the future. For your security, an automation object may be created by the system in order to protect sensitive services by default. These *system-created* automations can be opted out, if you so choose, by calling the SuspendAutomation method on them. Suspending a system-created automation is not recommended, but is supported for advanced use cases. The system will not execute nor modify any suspended automations. Also, system-created automations **cannot** be deleted, but can be freely modified, which is also not recommended, as the system may later overwrite your changes with its own default settings without notice (assuming it has not been suspended). An automation's condition is evaluated periodically; the frequency of this periodic evaluation depends on the exact condition. While the details are unspecified, evaluations will be conducted reasonably frequently so that a satisfied condition will be detected in a timely fashion. Once a condition has been detected to be satisfied, the enforcement action will be executed immediately. Currently, the only enforcement action supported is to **enforce** App Check protections on the associated parent service or parent resource policy. Once executed, the automation becomes immutable, and serves as a historical record of that execution. Its `update_time` field will be populated with the timestamp at which the execution occurred, and its `state` field will be set to `SUCCEEDED`. Successful automations not created by the system can still be deleted. If, during the evaluation or execution of an automation, App Check discovers that it is no longer possible for the service or resource to receive App Check protection, App Check may suspend your automation without warning. For example, if you have disabled a service, or have deleted all resources within a service, and that service does not support storing your App Check preferences while it is in such a state, then an automation created for this service may be suspended. Please ensure that the service or resource is correctly configured and operating normally throughout the lifetime of the automation to avoid suspension.", +"id": "GoogleFirebaseAppcheckV1betaAutomation", +"properties": { +"createTime": { +"description": "Output only. Timestamp at which this automation object was created.", +"format": "google-datetime", +"readOnly": true, +"type": "string" +}, +"etag": { +"description": "This checksum is computed by the server based on the value of other fields, and may be sent on update and delete requests to ensure the client has an up-to-date value before proceeding. This etag is strongly validated as defined by RFC 7232.", +"type": "string" +}, +"name": { +"description": "Identifier. The relative resource name of the automation object, in one of the following supported formats: ``` projects/{project_number}/services/{service_id}/automations/{automation_id} projects/{project_number}/services/{service_id}/resourcePolicies/{resource_policy_id}/automations/{automation_id} ```", +"type": "string" +}, +"origin": { +"description": "Output only. The original creator of this automation object.", +"enum": [ +"ORIGIN_UNSPECIFIED", +"SYSTEM", +"USER" +], +"enumDescriptions": [ +"A placeholder default value. This value should never appear in actual responses.", +"Indicates that the automation object was created by the service being protected by App Check. These automations cannot be deleted, but can be suspended in order to opt out.", +"Indicates that a user created the automation object." +], +"readOnly": true, +"type": "string" +}, +"state": { +"description": "Output only. The state that this automation object is currently in.", +"enum": [ +"STATE_UNSPECIFIED", +"EVALUATING", +"SUCCEEDED", +"SUSPENDED" +], +"enumDescriptions": [ +"A placeholder default value. This value should never appear in actual responses.", +"An automation in this state is being actively evaluated. When its condition is met, its enforcement action will be executed.", +"An automation in this state has already been successfully executed. It serves as a historical record of the execution, and it can no longer be modified in any way except be deleted.", +"An Automation in this state has been paused. Its enforcement action will not be executed, and its conditions will no longer be actively evaluated until it is resumed. System-created automations in this state will no longer be modified by the system." +], +"readOnly": true, +"type": "string" +}, +"triggerTime": { +"description": "A condition that is satisfied if the current time is greater than or equal to the specified timestamp.", +"format": "google-datetime", +"type": "string" +}, +"updateTime": { +"description": "Output only. Timestamp at which this automation object was most recently updated, either by the system or by the user. If this automation has already been executed, this field indicates the exact timestamp at which it was executed.", +"format": "google-datetime", +"readOnly": true, +"type": "string" +} +}, +"type": "object" +}, "GoogleFirebaseAppcheckV1betaBatchGetAppAttestConfigsResponse": { "description": "Response message for the BatchGetAppAttestConfigs method.", "id": "GoogleFirebaseAppcheckV1betaBatchGetAppAttestConfigsResponse", @@ -2227,6 +2497,24 @@ }, "type": "object" }, +"GoogleFirebaseAppcheckV1betaListAutomationsResponse": { +"description": "Response message for the ListAutomations method.", +"id": "GoogleFirebaseAppcheckV1betaListAutomationsResponse", +"properties": { +"automations": { +"description": "The Automations retrieved.", +"items": { +"$ref": "GoogleFirebaseAppcheckV1betaAutomation" +}, +"type": "array" +}, +"nextPageToken": { +"description": "If the result list is too large to fit in a single response, then a token is returned. If the string is empty or omitted, then this response is the last page of results. This token can be used in a subsequent call to ListAutomations to find the next group of Automations. Page tokens are short-lived and should not be persisted.", +"type": "string" +} +}, +"type": "object" +}, "GoogleFirebaseAppcheckV1betaListDebugTokensResponse": { "description": "Response message for the ListDebugTokens method.", "id": "GoogleFirebaseAppcheckV1betaListDebugTokensResponse", From 5f59c6cfc6266f3319b350dc097f7f19199ba333 Mon Sep 17 00:00:00 2001 From: Yoshi Automation Date: Tue, 20 Oct 2026 07:24:01 +0000 Subject: [PATCH 21/34] feat(firebasecrashlytics): update the api #### firebasecrashlytics:v1alpha The following keys were added: - schemas.CustomAttribute (Total Keys: 6) - schemas.ReportGroup.properties.customAttribute.$ref (Total Keys: 1) --- ...hlytics_v1alpha.projects.apps.reports.html | 8 +++++++ .../firebasecrashlytics.v1alpha.json | 23 ++++++++++++++++++- 2 files changed, 30 insertions(+), 1 deletion(-) diff --git a/docs/dyn/firebasecrashlytics_v1alpha.projects.apps.reports.html b/docs/dyn/firebasecrashlytics_v1alpha.projects.apps.reports.html index cb567939ec..5eeac6b04b 100644 --- a/docs/dyn/firebasecrashlytics_v1alpha.projects.apps.reports.html +++ b/docs/dyn/firebasecrashlytics_v1alpha.projects.apps.reports.html @@ -175,6 +175,10 @@

Method Details

"displayName": "A String", # Browser name and version number. Formatted to be suitable for passing to BrowserFilter. "displayVersion": "A String", # Browser display version number. }, + "customAttribute": { # Developer-provided custom key-value pair metadata. # Custom attribute metrics group. + "key": "A String", # Output only. Custom attribute key name. + "value": "A String", # Output only. Custom attribute value. + }, "device": { # Mobile device metadata. # Device metrics group. "architecture": "A String", # Device processor architecture. "companyName": "A String", # An invariant name of the manufacturer that submitted this product in its most recognizable public form, e.g. "Google". @@ -310,6 +314,10 @@

Method Details

"displayName": "A String", # Browser name and version number. Formatted to be suitable for passing to BrowserFilter. "displayVersion": "A String", # Browser display version number. }, + "customAttribute": { # Developer-provided custom key-value pair metadata. # Custom attribute metrics group. + "key": "A String", # Output only. Custom attribute key name. + "value": "A String", # Output only. Custom attribute value. + }, "device": { # Mobile device metadata. # Device metrics group. "architecture": "A String", # Device processor architecture. "companyName": "A String", # An invariant name of the manufacturer that submitted this product in its most recognizable public form, e.g. "Google". diff --git a/googleapiclient/discovery_cache/documents/firebasecrashlytics.v1alpha.json b/googleapiclient/discovery_cache/documents/firebasecrashlytics.v1alpha.json index f75d0fffbc..c460a10639 100644 --- a/googleapiclient/discovery_cache/documents/firebasecrashlytics.v1alpha.json +++ b/googleapiclient/discovery_cache/documents/firebasecrashlytics.v1alpha.json @@ -852,7 +852,7 @@ } } }, -"revision": "20261008", +"revision": "20261012", "rootUrl": "https://firebasecrashlytics.googleapis.com/", "schemas": { "BatchGetEventsResponse": { @@ -944,6 +944,23 @@ }, "type": "object" }, +"CustomAttribute": { +"description": "Developer-provided custom key-value pair metadata.", +"id": "CustomAttribute", +"properties": { +"key": { +"description": "Output only. Custom attribute key name.", +"readOnly": true, +"type": "string" +}, +"value": { +"description": "Output only. Custom attribute value.", +"readOnly": true, +"type": "string" +} +}, +"type": "object" +}, "DeleteUserCrashReportsResponse": { "description": "Response message for the DeleteUserCrashReports method. All crash reports associated with the specified user will be deleted typically within 24 hours of receiving the crash report.", "id": "DeleteUserCrashReportsResponse", @@ -1794,6 +1811,10 @@ "$ref": "Browser", "description": "Browser metrics group." }, +"customAttribute": { +"$ref": "CustomAttribute", +"description": "Custom attribute metrics group." +}, "device": { "$ref": "Device", "description": "Device metrics group." From 08e04d0263713e40daff761dd51d87418e15599a Mon Sep 17 00:00:00 2001 From: Yoshi Automation Date: Tue, 20 Oct 2026 07:24:01 +0000 Subject: [PATCH 22/34] feat(firebasedataconnect): update the api #### firebasedataconnect:v1 The following keys were deleted: - schemas.Service.properties.schemas.readOnly (Total Keys: 1) The following keys were added: - schemas.Service.properties.graphqlSource.$ref (Total Keys: 1) - schemas.Service.properties.source.deprecated (Total Keys: 1) - schemas.Service.properties.sqlSource.$ref (Total Keys: 1) #### firebasedataconnect:v1beta The following keys were deleted: - schemas.Service.properties.schemas.readOnly (Total Keys: 1) The following keys were added: - schemas.Service.properties.graphqlSource.$ref (Total Keys: 1) - schemas.Service.properties.source.deprecated (Total Keys: 1) - schemas.Service.properties.sqlSource.$ref (Total Keys: 1) --- ...onnect_v1.projects.locations.services.html | 80 +++++++++++++++++-- ...ct_v1beta.projects.locations.services.html | 80 +++++++++++++++++-- .../documents/firebasedataconnect.v1.json | 16 +++- .../documents/firebasedataconnect.v1beta.json | 16 +++- 4 files changed, 168 insertions(+), 24 deletions(-) diff --git a/docs/dyn/firebasedataconnect_v1.projects.locations.services.html b/docs/dyn/firebasedataconnect_v1.projects.locations.services.html index 3bbe6a38ea..b16439ab6c 100644 --- a/docs/dyn/firebasedataconnect_v1.projects.locations.services.html +++ b/docs/dyn/firebasedataconnect_v1.projects.locations.services.html @@ -176,12 +176,20 @@

Method Details

"createTime": "A String", # Output only. [Output only] Create time stamp. "displayName": "A String", # Optional. Mutable human-readable name. 63 character limit. "etag": "A String", # Output only. This checksum is computed by the server based on the value of other fields, and may be sent on update and delete requests to ensure the client has an up-to-date value before proceeding. [AIP-154](https://google.aip.dev/154) + "graphqlSource": { # Used to represent a set of source files. # Optional. Input only. The GraphQL source files like `dataconnect.yaml` and `*.gql`. + "files": [ # Required. The files that comprise the source set. + { # Individual files. + "content": "A String", # Required. The file's textual content. + "path": "A String", # Required. The file name including folder path, if applicable. The path should be relative to a local workspace (e.g. dataconnect/(schema|connector)/*.gql) and not an absolute path (e.g. /absolute/path/(schema|connector)/*.gql). + }, + ], + }, "labels": { # Optional. Labels as key value pairs. "a_key": "A String", }, "name": "A String", # Identifier. The relative resource name of the Firebase SQL Connect service, in the format: ``` projects/{project}/locations/{location}/services/{service} ``` Note that the service ID is specific to Firebase SQL Connect and does not correspond to any of the instance IDs of the underlying data source connections. "reconciling": True or False, # Output only. A field that if true, indicates that the system is working update the service. - "schemas": [ # Output only. The list of schemas in this service. + "schemas": [ # Optional. The list of schemas in this service. { # The application schema of a Firebase SQL Connect service. "annotations": { # Optional. Stores small amounts of arbitrary data. "a_key": "A String", @@ -226,7 +234,15 @@

Method Details

"updateTime": "A String", # Output only. [Output only] Update time stamp. }, ], - "source": { # Used to represent a set of source files. # Optional. Input only. The source files for service, schemas, and connectors. + "source": { # Used to represent a set of source files. # Optional. Input only. Deprecated: Use `sql_source` or `graphql_source` instead. The source files for service, schemas, and connectors. + "files": [ # Required. The files that comprise the source set. + { # Individual files. + "content": "A String", # Required. The file's textual content. + "path": "A String", # Required. The file name including folder path, if applicable. The path should be relative to a local workspace (e.g. dataconnect/(schema|connector)/*.gql) and not an absolute path (e.g. /absolute/path/(schema|connector)/*.gql). + }, + ], + }, + "sqlSource": { # Used to represent a set of source files. # Optional. Input only. The SQL source files like `*.sql` for deploying a PostgREST service. "files": [ # Required. The files that comprise the source set. { # Individual files. "content": "A String", # Required. The file's textual content. @@ -645,12 +661,20 @@

Method Details

"createTime": "A String", # Output only. [Output only] Create time stamp. "displayName": "A String", # Optional. Mutable human-readable name. 63 character limit. "etag": "A String", # Output only. This checksum is computed by the server based on the value of other fields, and may be sent on update and delete requests to ensure the client has an up-to-date value before proceeding. [AIP-154](https://google.aip.dev/154) + "graphqlSource": { # Used to represent a set of source files. # Optional. Input only. The GraphQL source files like `dataconnect.yaml` and `*.gql`. + "files": [ # Required. The files that comprise the source set. + { # Individual files. + "content": "A String", # Required. The file's textual content. + "path": "A String", # Required. The file name including folder path, if applicable. The path should be relative to a local workspace (e.g. dataconnect/(schema|connector)/*.gql) and not an absolute path (e.g. /absolute/path/(schema|connector)/*.gql). + }, + ], + }, "labels": { # Optional. Labels as key value pairs. "a_key": "A String", }, "name": "A String", # Identifier. The relative resource name of the Firebase SQL Connect service, in the format: ``` projects/{project}/locations/{location}/services/{service} ``` Note that the service ID is specific to Firebase SQL Connect and does not correspond to any of the instance IDs of the underlying data source connections. "reconciling": True or False, # Output only. A field that if true, indicates that the system is working update the service. - "schemas": [ # Output only. The list of schemas in this service. + "schemas": [ # Optional. The list of schemas in this service. { # The application schema of a Firebase SQL Connect service. "annotations": { # Optional. Stores small amounts of arbitrary data. "a_key": "A String", @@ -695,7 +719,15 @@

Method Details

"updateTime": "A String", # Output only. [Output only] Update time stamp. }, ], - "source": { # Used to represent a set of source files. # Optional. Input only. The source files for service, schemas, and connectors. + "source": { # Used to represent a set of source files. # Optional. Input only. Deprecated: Use `sql_source` or `graphql_source` instead. The source files for service, schemas, and connectors. + "files": [ # Required. The files that comprise the source set. + { # Individual files. + "content": "A String", # Required. The file's textual content. + "path": "A String", # Required. The file name including folder path, if applicable. The path should be relative to a local workspace (e.g. dataconnect/(schema|connector)/*.gql) and not an absolute path (e.g. /absolute/path/(schema|connector)/*.gql). + }, + ], + }, + "sqlSource": { # Used to represent a set of source files. # Optional. Input only. The SQL source files like `*.sql` for deploying a PostgREST service. "files": [ # Required. The files that comprise the source set. { # Individual files. "content": "A String", # Required. The file's textual content. @@ -847,12 +879,20 @@

Method Details

"createTime": "A String", # Output only. [Output only] Create time stamp. "displayName": "A String", # Optional. Mutable human-readable name. 63 character limit. "etag": "A String", # Output only. This checksum is computed by the server based on the value of other fields, and may be sent on update and delete requests to ensure the client has an up-to-date value before proceeding. [AIP-154](https://google.aip.dev/154) + "graphqlSource": { # Used to represent a set of source files. # Optional. Input only. The GraphQL source files like `dataconnect.yaml` and `*.gql`. + "files": [ # Required. The files that comprise the source set. + { # Individual files. + "content": "A String", # Required. The file's textual content. + "path": "A String", # Required. The file name including folder path, if applicable. The path should be relative to a local workspace (e.g. dataconnect/(schema|connector)/*.gql) and not an absolute path (e.g. /absolute/path/(schema|connector)/*.gql). + }, + ], + }, "labels": { # Optional. Labels as key value pairs. "a_key": "A String", }, "name": "A String", # Identifier. The relative resource name of the Firebase SQL Connect service, in the format: ``` projects/{project}/locations/{location}/services/{service} ``` Note that the service ID is specific to Firebase SQL Connect and does not correspond to any of the instance IDs of the underlying data source connections. "reconciling": True or False, # Output only. A field that if true, indicates that the system is working update the service. - "schemas": [ # Output only. The list of schemas in this service. + "schemas": [ # Optional. The list of schemas in this service. { # The application schema of a Firebase SQL Connect service. "annotations": { # Optional. Stores small amounts of arbitrary data. "a_key": "A String", @@ -897,7 +937,15 @@

Method Details

"updateTime": "A String", # Output only. [Output only] Update time stamp. }, ], - "source": { # Used to represent a set of source files. # Optional. Input only. The source files for service, schemas, and connectors. + "source": { # Used to represent a set of source files. # Optional. Input only. Deprecated: Use `sql_source` or `graphql_source` instead. The source files for service, schemas, and connectors. + "files": [ # Required. The files that comprise the source set. + { # Individual files. + "content": "A String", # Required. The file's textual content. + "path": "A String", # Required. The file name including folder path, if applicable. The path should be relative to a local workspace (e.g. dataconnect/(schema|connector)/*.gql) and not an absolute path (e.g. /absolute/path/(schema|connector)/*.gql). + }, + ], + }, + "sqlSource": { # Used to represent a set of source files. # Optional. Input only. The SQL source files like `*.sql` for deploying a PostgREST service. "files": [ # Required. The files that comprise the source set. { # Individual files. "content": "A String", # Required. The file's textual content. @@ -974,12 +1022,20 @@

Method Details

"createTime": "A String", # Output only. [Output only] Create time stamp. "displayName": "A String", # Optional. Mutable human-readable name. 63 character limit. "etag": "A String", # Output only. This checksum is computed by the server based on the value of other fields, and may be sent on update and delete requests to ensure the client has an up-to-date value before proceeding. [AIP-154](https://google.aip.dev/154) + "graphqlSource": { # Used to represent a set of source files. # Optional. Input only. The GraphQL source files like `dataconnect.yaml` and `*.gql`. + "files": [ # Required. The files that comprise the source set. + { # Individual files. + "content": "A String", # Required. The file's textual content. + "path": "A String", # Required. The file name including folder path, if applicable. The path should be relative to a local workspace (e.g. dataconnect/(schema|connector)/*.gql) and not an absolute path (e.g. /absolute/path/(schema|connector)/*.gql). + }, + ], + }, "labels": { # Optional. Labels as key value pairs. "a_key": "A String", }, "name": "A String", # Identifier. The relative resource name of the Firebase SQL Connect service, in the format: ``` projects/{project}/locations/{location}/services/{service} ``` Note that the service ID is specific to Firebase SQL Connect and does not correspond to any of the instance IDs of the underlying data source connections. "reconciling": True or False, # Output only. A field that if true, indicates that the system is working update the service. - "schemas": [ # Output only. The list of schemas in this service. + "schemas": [ # Optional. The list of schemas in this service. { # The application schema of a Firebase SQL Connect service. "annotations": { # Optional. Stores small amounts of arbitrary data. "a_key": "A String", @@ -1024,7 +1080,15 @@

Method Details

"updateTime": "A String", # Output only. [Output only] Update time stamp. }, ], - "source": { # Used to represent a set of source files. # Optional. Input only. The source files for service, schemas, and connectors. + "source": { # Used to represent a set of source files. # Optional. Input only. Deprecated: Use `sql_source` or `graphql_source` instead. The source files for service, schemas, and connectors. + "files": [ # Required. The files that comprise the source set. + { # Individual files. + "content": "A String", # Required. The file's textual content. + "path": "A String", # Required. The file name including folder path, if applicable. The path should be relative to a local workspace (e.g. dataconnect/(schema|connector)/*.gql) and not an absolute path (e.g. /absolute/path/(schema|connector)/*.gql). + }, + ], + }, + "sqlSource": { # Used to represent a set of source files. # Optional. Input only. The SQL source files like `*.sql` for deploying a PostgREST service. "files": [ # Required. The files that comprise the source set. { # Individual files. "content": "A String", # Required. The file's textual content. diff --git a/docs/dyn/firebasedataconnect_v1beta.projects.locations.services.html b/docs/dyn/firebasedataconnect_v1beta.projects.locations.services.html index dca94ded81..cd2aaa7915 100644 --- a/docs/dyn/firebasedataconnect_v1beta.projects.locations.services.html +++ b/docs/dyn/firebasedataconnect_v1beta.projects.locations.services.html @@ -176,12 +176,20 @@

Method Details

"createTime": "A String", # Output only. [Output only] Create time stamp. "displayName": "A String", # Optional. Mutable human-readable name. 63 character limit. "etag": "A String", # Output only. This checksum is computed by the server based on the value of other fields, and may be sent on update and delete requests to ensure the client has an up-to-date value before proceeding. [AIP-154](https://google.aip.dev/154) + "graphqlSource": { # Used to represent a set of source files. # Optional. Input only. The GraphQL source files like `dataconnect.yaml` and `*.gql`. + "files": [ # Required. The files that comprise the source set. + { # Individual files. + "content": "A String", # Required. The file's textual content. + "path": "A String", # Required. The file name including folder path, if applicable. The path should be relative to a local workspace (e.g. dataconnect/(schema|connector)/*.gql) and not an absolute path (e.g. /absolute/path/(schema|connector)/*.gql). + }, + ], + }, "labels": { # Optional. Labels as key value pairs. "a_key": "A String", }, "name": "A String", # Identifier. The relative resource name of the Firebase SQL Connect service, in the format: ``` projects/{project}/locations/{location}/services/{service} ``` Note that the service ID is specific to Firebase SQL Connect and does not correspond to any of the instance IDs of the underlying data source connections. "reconciling": True or False, # Output only. A field that if true, indicates that the system is working update the service. - "schemas": [ # Output only. The list of schemas in this service. + "schemas": [ # Optional. The list of schemas in this service. { # The application schema of a Firebase SQL Connect service. "annotations": { # Optional. Stores small amounts of arbitrary data. "a_key": "A String", @@ -226,7 +234,15 @@

Method Details

"updateTime": "A String", # Output only. [Output only] Update time stamp. }, ], - "source": { # Used to represent a set of source files. # Optional. Input only. The source files for service, schemas, and connectors. + "source": { # Used to represent a set of source files. # Optional. Input only. Deprecated: Use `sql_source` or `graphql_source` instead. The source files for service, schemas, and connectors. + "files": [ # Required. The files that comprise the source set. + { # Individual files. + "content": "A String", # Required. The file's textual content. + "path": "A String", # Required. The file name including folder path, if applicable. The path should be relative to a local workspace (e.g. dataconnect/(schema|connector)/*.gql) and not an absolute path (e.g. /absolute/path/(schema|connector)/*.gql). + }, + ], + }, + "sqlSource": { # Used to represent a set of source files. # Optional. Input only. The SQL source files like `*.sql` for deploying a PostgREST service. "files": [ # Required. The files that comprise the source set. { # Individual files. "content": "A String", # Required. The file's textual content. @@ -645,12 +661,20 @@

Method Details

"createTime": "A String", # Output only. [Output only] Create time stamp. "displayName": "A String", # Optional. Mutable human-readable name. 63 character limit. "etag": "A String", # Output only. This checksum is computed by the server based on the value of other fields, and may be sent on update and delete requests to ensure the client has an up-to-date value before proceeding. [AIP-154](https://google.aip.dev/154) + "graphqlSource": { # Used to represent a set of source files. # Optional. Input only. The GraphQL source files like `dataconnect.yaml` and `*.gql`. + "files": [ # Required. The files that comprise the source set. + { # Individual files. + "content": "A String", # Required. The file's textual content. + "path": "A String", # Required. The file name including folder path, if applicable. The path should be relative to a local workspace (e.g. dataconnect/(schema|connector)/*.gql) and not an absolute path (e.g. /absolute/path/(schema|connector)/*.gql). + }, + ], + }, "labels": { # Optional. Labels as key value pairs. "a_key": "A String", }, "name": "A String", # Identifier. The relative resource name of the Firebase SQL Connect service, in the format: ``` projects/{project}/locations/{location}/services/{service} ``` Note that the service ID is specific to Firebase SQL Connect and does not correspond to any of the instance IDs of the underlying data source connections. "reconciling": True or False, # Output only. A field that if true, indicates that the system is working update the service. - "schemas": [ # Output only. The list of schemas in this service. + "schemas": [ # Optional. The list of schemas in this service. { # The application schema of a Firebase SQL Connect service. "annotations": { # Optional. Stores small amounts of arbitrary data. "a_key": "A String", @@ -695,7 +719,15 @@

Method Details

"updateTime": "A String", # Output only. [Output only] Update time stamp. }, ], - "source": { # Used to represent a set of source files. # Optional. Input only. The source files for service, schemas, and connectors. + "source": { # Used to represent a set of source files. # Optional. Input only. Deprecated: Use `sql_source` or `graphql_source` instead. The source files for service, schemas, and connectors. + "files": [ # Required. The files that comprise the source set. + { # Individual files. + "content": "A String", # Required. The file's textual content. + "path": "A String", # Required. The file name including folder path, if applicable. The path should be relative to a local workspace (e.g. dataconnect/(schema|connector)/*.gql) and not an absolute path (e.g. /absolute/path/(schema|connector)/*.gql). + }, + ], + }, + "sqlSource": { # Used to represent a set of source files. # Optional. Input only. The SQL source files like `*.sql` for deploying a PostgREST service. "files": [ # Required. The files that comprise the source set. { # Individual files. "content": "A String", # Required. The file's textual content. @@ -847,12 +879,20 @@

Method Details

"createTime": "A String", # Output only. [Output only] Create time stamp. "displayName": "A String", # Optional. Mutable human-readable name. 63 character limit. "etag": "A String", # Output only. This checksum is computed by the server based on the value of other fields, and may be sent on update and delete requests to ensure the client has an up-to-date value before proceeding. [AIP-154](https://google.aip.dev/154) + "graphqlSource": { # Used to represent a set of source files. # Optional. Input only. The GraphQL source files like `dataconnect.yaml` and `*.gql`. + "files": [ # Required. The files that comprise the source set. + { # Individual files. + "content": "A String", # Required. The file's textual content. + "path": "A String", # Required. The file name including folder path, if applicable. The path should be relative to a local workspace (e.g. dataconnect/(schema|connector)/*.gql) and not an absolute path (e.g. /absolute/path/(schema|connector)/*.gql). + }, + ], + }, "labels": { # Optional. Labels as key value pairs. "a_key": "A String", }, "name": "A String", # Identifier. The relative resource name of the Firebase SQL Connect service, in the format: ``` projects/{project}/locations/{location}/services/{service} ``` Note that the service ID is specific to Firebase SQL Connect and does not correspond to any of the instance IDs of the underlying data source connections. "reconciling": True or False, # Output only. A field that if true, indicates that the system is working update the service. - "schemas": [ # Output only. The list of schemas in this service. + "schemas": [ # Optional. The list of schemas in this service. { # The application schema of a Firebase SQL Connect service. "annotations": { # Optional. Stores small amounts of arbitrary data. "a_key": "A String", @@ -897,7 +937,15 @@

Method Details

"updateTime": "A String", # Output only. [Output only] Update time stamp. }, ], - "source": { # Used to represent a set of source files. # Optional. Input only. The source files for service, schemas, and connectors. + "source": { # Used to represent a set of source files. # Optional. Input only. Deprecated: Use `sql_source` or `graphql_source` instead. The source files for service, schemas, and connectors. + "files": [ # Required. The files that comprise the source set. + { # Individual files. + "content": "A String", # Required. The file's textual content. + "path": "A String", # Required. The file name including folder path, if applicable. The path should be relative to a local workspace (e.g. dataconnect/(schema|connector)/*.gql) and not an absolute path (e.g. /absolute/path/(schema|connector)/*.gql). + }, + ], + }, + "sqlSource": { # Used to represent a set of source files. # Optional. Input only. The SQL source files like `*.sql` for deploying a PostgREST service. "files": [ # Required. The files that comprise the source set. { # Individual files. "content": "A String", # Required. The file's textual content. @@ -974,12 +1022,20 @@

Method Details

"createTime": "A String", # Output only. [Output only] Create time stamp. "displayName": "A String", # Optional. Mutable human-readable name. 63 character limit. "etag": "A String", # Output only. This checksum is computed by the server based on the value of other fields, and may be sent on update and delete requests to ensure the client has an up-to-date value before proceeding. [AIP-154](https://google.aip.dev/154) + "graphqlSource": { # Used to represent a set of source files. # Optional. Input only. The GraphQL source files like `dataconnect.yaml` and `*.gql`. + "files": [ # Required. The files that comprise the source set. + { # Individual files. + "content": "A String", # Required. The file's textual content. + "path": "A String", # Required. The file name including folder path, if applicable. The path should be relative to a local workspace (e.g. dataconnect/(schema|connector)/*.gql) and not an absolute path (e.g. /absolute/path/(schema|connector)/*.gql). + }, + ], + }, "labels": { # Optional. Labels as key value pairs. "a_key": "A String", }, "name": "A String", # Identifier. The relative resource name of the Firebase SQL Connect service, in the format: ``` projects/{project}/locations/{location}/services/{service} ``` Note that the service ID is specific to Firebase SQL Connect and does not correspond to any of the instance IDs of the underlying data source connections. "reconciling": True or False, # Output only. A field that if true, indicates that the system is working update the service. - "schemas": [ # Output only. The list of schemas in this service. + "schemas": [ # Optional. The list of schemas in this service. { # The application schema of a Firebase SQL Connect service. "annotations": { # Optional. Stores small amounts of arbitrary data. "a_key": "A String", @@ -1024,7 +1080,15 @@

Method Details

"updateTime": "A String", # Output only. [Output only] Update time stamp. }, ], - "source": { # Used to represent a set of source files. # Optional. Input only. The source files for service, schemas, and connectors. + "source": { # Used to represent a set of source files. # Optional. Input only. Deprecated: Use `sql_source` or `graphql_source` instead. The source files for service, schemas, and connectors. + "files": [ # Required. The files that comprise the source set. + { # Individual files. + "content": "A String", # Required. The file's textual content. + "path": "A String", # Required. The file name including folder path, if applicable. The path should be relative to a local workspace (e.g. dataconnect/(schema|connector)/*.gql) and not an absolute path (e.g. /absolute/path/(schema|connector)/*.gql). + }, + ], + }, + "sqlSource": { # Used to represent a set of source files. # Optional. Input only. The SQL source files like `*.sql` for deploying a PostgREST service. "files": [ # Required. The files that comprise the source set. { # Individual files. "content": "A String", # Required. The file's textual content. diff --git a/googleapiclient/discovery_cache/documents/firebasedataconnect.v1.json b/googleapiclient/discovery_cache/documents/firebasedataconnect.v1.json index d09681a55d..1b29d10961 100644 --- a/googleapiclient/discovery_cache/documents/firebasedataconnect.v1.json +++ b/googleapiclient/discovery_cache/documents/firebasedataconnect.v1.json @@ -1502,7 +1502,7 @@ } } }, -"revision": "20261004", +"revision": "20261011", "rootUrl": "https://firebasedataconnect.googleapis.com/", "schemas": { "CancelOperationRequest": { @@ -2612,6 +2612,10 @@ "readOnly": true, "type": "string" }, +"graphqlSource": { +"$ref": "Source", +"description": "Optional. Input only. The GraphQL source files like `dataconnect.yaml` and `*.gql`." +}, "labels": { "additionalProperties": { "type": "string" @@ -2629,16 +2633,20 @@ "type": "boolean" }, "schemas": { -"description": "Output only. The list of schemas in this service.", +"description": "Optional. The list of schemas in this service.", "items": { "$ref": "Schema" }, -"readOnly": true, "type": "array" }, "source": { "$ref": "Source", -"description": "Optional. Input only. The source files for service, schemas, and connectors." +"deprecated": true, +"description": "Optional. Input only. Deprecated: Use `sql_source` or `graphql_source` instead. The source files for service, schemas, and connectors." +}, +"sqlSource": { +"$ref": "Source", +"description": "Optional. Input only. The SQL source files like `*.sql` for deploying a PostgREST service." }, "uid": { "description": "Output only. System-assigned, unique identifier.", diff --git a/googleapiclient/discovery_cache/documents/firebasedataconnect.v1beta.json b/googleapiclient/discovery_cache/documents/firebasedataconnect.v1beta.json index 3fdf7391b4..a03757959c 100644 --- a/googleapiclient/discovery_cache/documents/firebasedataconnect.v1beta.json +++ b/googleapiclient/discovery_cache/documents/firebasedataconnect.v1beta.json @@ -1502,7 +1502,7 @@ } } }, -"revision": "20261004", +"revision": "20261011", "rootUrl": "https://firebasedataconnect.googleapis.com/", "schemas": { "CancelOperationRequest": { @@ -2612,6 +2612,10 @@ "readOnly": true, "type": "string" }, +"graphqlSource": { +"$ref": "Source", +"description": "Optional. Input only. The GraphQL source files like `dataconnect.yaml` and `*.gql`." +}, "labels": { "additionalProperties": { "type": "string" @@ -2629,16 +2633,20 @@ "type": "boolean" }, "schemas": { -"description": "Output only. The list of schemas in this service.", +"description": "Optional. The list of schemas in this service.", "items": { "$ref": "Schema" }, -"readOnly": true, "type": "array" }, "source": { "$ref": "Source", -"description": "Optional. Input only. The source files for service, schemas, and connectors." +"deprecated": true, +"description": "Optional. Input only. Deprecated: Use `sql_source` or `graphql_source` instead. The source files for service, schemas, and connectors." +}, +"sqlSource": { +"$ref": "Source", +"description": "Optional. Input only. The SQL source files like `*.sql` for deploying a PostgREST service." }, "uid": { "description": "Output only. System-assigned, unique identifier.", From 54a533649a4b63645087b2fe9606162481d30989 Mon Sep 17 00:00:00 2001 From: Yoshi Automation Date: Tue, 20 Oct 2026 07:24:01 +0000 Subject: [PATCH 23/34] feat(health): update the api #### health:v4beta The following keys were deleted: - schemas.DailyRollupDataPoint.properties.skinTemperature.$ref (Total Keys: 1) - schemas.DataPoint.properties.skinTemperature.$ref (Total Keys: 1) - schemas.ReconciledDataPoint.properties.skinTemperature.$ref (Total Keys: 1) - schemas.RollupDataPoint.properties.skinTemperature.$ref (Total Keys: 1) - schemas.SkinTemperature (Total Keys: 20) --- ...lth_v4beta.users.dataTypes.dataPoints.html | 135 ------------------ .../documents/health.v4beta.json | 106 +------------- 2 files changed, 1 insertion(+), 240 deletions(-) diff --git a/docs/dyn/health_v4beta.users.dataTypes.dataPoints.html b/docs/dyn/health_v4beta.users.dataTypes.dataPoints.html index 67745c3e5b..6f285ce1f0 100644 --- a/docs/dyn/health_v4beta.users.dataTypes.dataPoints.html +++ b/docs/dyn/health_v4beta.users.dataTypes.dataPoints.html @@ -1342,31 +1342,6 @@

Method Details

"startUtcOffset": "A String", # Required. The offset of the user's local time at the start of the observation relative to the Coordinated Universal Time (UTC). }, }, - "skinTemperature": { # Skin temperature measurement. # Optional. Data for points in the `skin-temperature` sample data type collection. - "baselineTemperatureCelsius": 3.14, # Required. The baseline skin temperature in Celsius. Must be in the range `[0, 100]`. - "metadata": { # Metadata for the skin temperature measurement. # Optional. Metadata for the skin temperature measurement. - "measurementLocation": "A String", # Optional. The location of the skin temperature measurement. - "measurementState": "A String", # Optional. The motion state of the skin temperature measurement. - }, - "sampleTime": { # Represents a sample time of an observed data point. # Required. The time at which skin temperature was measured. - "civilTime": { # Civil time representation similar to google.type.DateTime, but ensures that neither the timezone nor the UTC offset can be set to avoid confusion between civil and physical time queries. # Output only. The civil time in the timezone the subject is in at the time of the observation. - "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 # Required. Calendar date. - "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. - }, - "time": { # 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. Time of day. Defaults to the start of the day, at midnight if omitted. - "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. - }, - }, - "physicalTime": "A String", # Required. The time of the observation. - "utcOffset": "A String", # Required. The offset of the user's local time during the observation relative to the Coordinated Universal Time (UTC). - }, - "temperatureCelsius": 3.14, # Required. The skin temperature in Celsius. Must be in the range `[0, 100]`. - }, "skinTemperatureSensors": { # Skin temperature sensor data containing multi-sensor readings. # Optional. Data for points in the `skin-temperature-sensors` sample data type collection. "sampleTime": { # Represents a sample time of an observed data point. # Required. The observation sample time. "civilTime": { # Civil time representation similar to google.type.DateTime, but ensures that neither the timezone nor the UTC offset can be set to avoid confusion between civil and physical time queries. # Output only. The civil time in the timezone the subject is in at the time of the observation. @@ -1874,11 +1849,6 @@

Method Details

"sedentaryPeriod": { # Represents the result of the rollup of the user's sedentary periods. # Returned by default when rolling up data points from the `sedentary-period` data type, or when requested explicitly using the `sedentary-period` rollup type identifier. "durationSum": "A String", # The total time user spent sedentary during the interval. }, - "skinTemperature": { # Represents the result of the rollup of the skin temperature data type. # Returned by default when rolling up data points from the `skin-temperature` data type. - "temperatureCelsiusAvg": 3.14, # Average skin temperature in Celsius. - "temperatureCelsiusMax": 3.14, # Maximum skin temperature in Celsius. - "temperatureCelsiusMin": 3.14, # Minimum skin temperature in Celsius. - }, "steps": { # Represents the result of the rollup of the steps data type. # Returned by default when rolling up data points from the `steps` data type, or when requested explicitly using the `steps` rollup type identifier. "countSum": "A String", # Total number of steps in the interval. }, @@ -3134,31 +3104,6 @@

Method Details

"startUtcOffset": "A String", # Required. The offset of the user's local time at the start of the observation relative to the Coordinated Universal Time (UTC). }, }, - "skinTemperature": { # Skin temperature measurement. # Optional. Data for points in the `skin-temperature` sample data type collection. - "baselineTemperatureCelsius": 3.14, # Required. The baseline skin temperature in Celsius. Must be in the range `[0, 100]`. - "metadata": { # Metadata for the skin temperature measurement. # Optional. Metadata for the skin temperature measurement. - "measurementLocation": "A String", # Optional. The location of the skin temperature measurement. - "measurementState": "A String", # Optional. The motion state of the skin temperature measurement. - }, - "sampleTime": { # Represents a sample time of an observed data point. # Required. The time at which skin temperature was measured. - "civilTime": { # Civil time representation similar to google.type.DateTime, but ensures that neither the timezone nor the UTC offset can be set to avoid confusion between civil and physical time queries. # Output only. The civil time in the timezone the subject is in at the time of the observation. - "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 # Required. Calendar date. - "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. - }, - "time": { # 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. Time of day. Defaults to the start of the day, at midnight if omitted. - "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. - }, - }, - "physicalTime": "A String", # Required. The time of the observation. - "utcOffset": "A String", # Required. The offset of the user's local time during the observation relative to the Coordinated Universal Time (UTC). - }, - "temperatureCelsius": 3.14, # Required. The skin temperature in Celsius. Must be in the range `[0, 100]`. - }, "skinTemperatureSensors": { # Skin temperature sensor data containing multi-sensor readings. # Optional. Data for points in the `skin-temperature-sensors` sample data type collection. "sampleTime": { # Represents a sample time of an observed data point. # Required. The observation sample time. "civilTime": { # Civil time representation similar to google.type.DateTime, but ensures that neither the timezone nor the UTC offset can be set to avoid confusion between civil and physical time queries. # Output only. The civil time in the timezone the subject is in at the time of the observation. @@ -4634,31 +4579,6 @@

Method Details

"startUtcOffset": "A String", # Required. The offset of the user's local time at the start of the observation relative to the Coordinated Universal Time (UTC). }, }, - "skinTemperature": { # Skin temperature measurement. # Optional. Data for points in the `skin-temperature` sample data type collection. - "baselineTemperatureCelsius": 3.14, # Required. The baseline skin temperature in Celsius. Must be in the range `[0, 100]`. - "metadata": { # Metadata for the skin temperature measurement. # Optional. Metadata for the skin temperature measurement. - "measurementLocation": "A String", # Optional. The location of the skin temperature measurement. - "measurementState": "A String", # Optional. The motion state of the skin temperature measurement. - }, - "sampleTime": { # Represents a sample time of an observed data point. # Required. The time at which skin temperature was measured. - "civilTime": { # Civil time representation similar to google.type.DateTime, but ensures that neither the timezone nor the UTC offset can be set to avoid confusion between civil and physical time queries. # Output only. The civil time in the timezone the subject is in at the time of the observation. - "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 # Required. Calendar date. - "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. - }, - "time": { # 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. Time of day. Defaults to the start of the day, at midnight if omitted. - "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. - }, - }, - "physicalTime": "A String", # Required. The time of the observation. - "utcOffset": "A String", # Required. The offset of the user's local time during the observation relative to the Coordinated Universal Time (UTC). - }, - "temperatureCelsius": 3.14, # Required. The skin temperature in Celsius. Must be in the range `[0, 100]`. - }, "skinTemperatureSensors": { # Skin temperature sensor data containing multi-sensor readings. # Optional. Data for points in the `skin-temperature-sensors` sample data type collection. "sampleTime": { # Represents a sample time of an observed data point. # Required. The observation sample time. "civilTime": { # Civil time representation similar to google.type.DateTime, but ensures that neither the timezone nor the UTC offset can be set to avoid confusion between civil and physical time queries. # Output only. The civil time in the timezone the subject is in at the time of the observation. @@ -6140,31 +6060,6 @@

Method Details

"startUtcOffset": "A String", # Required. The offset of the user's local time at the start of the observation relative to the Coordinated Universal Time (UTC). }, }, - "skinTemperature": { # Skin temperature measurement. # Optional. Data for points in the `skin-temperature` sample data type collection. - "baselineTemperatureCelsius": 3.14, # Required. The baseline skin temperature in Celsius. Must be in the range `[0, 100]`. - "metadata": { # Metadata for the skin temperature measurement. # Optional. Metadata for the skin temperature measurement. - "measurementLocation": "A String", # Optional. The location of the skin temperature measurement. - "measurementState": "A String", # Optional. The motion state of the skin temperature measurement. - }, - "sampleTime": { # Represents a sample time of an observed data point. # Required. The time at which skin temperature was measured. - "civilTime": { # Civil time representation similar to google.type.DateTime, but ensures that neither the timezone nor the UTC offset can be set to avoid confusion between civil and physical time queries. # Output only. The civil time in the timezone the subject is in at the time of the observation. - "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 # Required. Calendar date. - "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. - }, - "time": { # 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. Time of day. Defaults to the start of the day, at midnight if omitted. - "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. - }, - }, - "physicalTime": "A String", # Required. The time of the observation. - "utcOffset": "A String", # Required. The offset of the user's local time during the observation relative to the Coordinated Universal Time (UTC). - }, - "temperatureCelsius": 3.14, # Required. The skin temperature in Celsius. Must be in the range `[0, 100]`. - }, "skinTemperatureSensors": { # Skin temperature sensor data containing multi-sensor readings. # Optional. Data for points in the `skin-temperature-sensors` sample data type collection. "sampleTime": { # Represents a sample time of an observed data point. # Required. The observation sample time. "civilTime": { # Civil time representation similar to google.type.DateTime, but ensures that neither the timezone nor the UTC offset can be set to avoid confusion between civil and physical time queries. # Output only. The civil time in the timezone the subject is in at the time of the observation. @@ -7368,31 +7263,6 @@

Method Details

"startUtcOffset": "A String", # Required. The offset of the user's local time at the start of the observation relative to the Coordinated Universal Time (UTC). }, }, - "skinTemperature": { # Skin temperature measurement. # Data for points in the `skin-temperature` sample data type collection. - "baselineTemperatureCelsius": 3.14, # Required. The baseline skin temperature in Celsius. Must be in the range `[0, 100]`. - "metadata": { # Metadata for the skin temperature measurement. # Optional. Metadata for the skin temperature measurement. - "measurementLocation": "A String", # Optional. The location of the skin temperature measurement. - "measurementState": "A String", # Optional. The motion state of the skin temperature measurement. - }, - "sampleTime": { # Represents a sample time of an observed data point. # Required. The time at which skin temperature was measured. - "civilTime": { # Civil time representation similar to google.type.DateTime, but ensures that neither the timezone nor the UTC offset can be set to avoid confusion between civil and physical time queries. # Output only. The civil time in the timezone the subject is in at the time of the observation. - "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 # Required. Calendar date. - "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. - }, - "time": { # 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. Time of day. Defaults to the start of the day, at midnight if omitted. - "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. - }, - }, - "physicalTime": "A String", # Required. The time of the observation. - "utcOffset": "A String", # Required. The offset of the user's local time during the observation relative to the Coordinated Universal Time (UTC). - }, - "temperatureCelsius": 3.14, # Required. The skin temperature in Celsius. Must be in the range `[0, 100]`. - }, "skinTemperatureSensors": { # Skin temperature sensor data containing multi-sensor readings. # Data for points in the `skin-temperature-sensors` sample data type collection. "sampleTime": { # Represents a sample time of an observed data point. # Required. The observation sample time. "civilTime": { # Civil time representation similar to google.type.DateTime, but ensures that neither the timezone nor the UTC offset can be set to avoid confusion between civil and physical time queries. # Output only. The civil time in the timezone the subject is in at the time of the observation. @@ -7810,11 +7680,6 @@

Method Details

"sedentaryPeriod": { # Represents the result of the rollup of the user's sedentary periods. # Returned by default when rolling up data points from the `sedentary-period` data type, or when requested explicitly using the `sedentary-period` rollup type identifier. "durationSum": "A String", # The total time user spent sedentary during the interval. }, - "skinTemperature": { # Represents the result of the rollup of the skin temperature data type. # Returned by default when rolling up data points from the `skin-temperature` data type. - "temperatureCelsiusAvg": 3.14, # Average skin temperature in Celsius. - "temperatureCelsiusMax": 3.14, # Maximum skin temperature in Celsius. - "temperatureCelsiusMin": 3.14, # Minimum skin temperature in Celsius. - }, "startTime": "A String", # Start time of the window this value aggregates over "steps": { # Represents the result of the rollup of the steps data type. # Returned by default when rolling up data points from the `steps` data type, or when requested explicitly using the `steps` rollup type identifier. "countSum": "A String", # Total number of steps in the interval. diff --git a/googleapiclient/discovery_cache/documents/health.v4beta.json b/googleapiclient/discovery_cache/documents/health.v4beta.json index 5cc4cfaa59..10a3fcf0ab 100644 --- a/googleapiclient/discovery_cache/documents/health.v4beta.json +++ b/googleapiclient/discovery_cache/documents/health.v4beta.json @@ -1149,7 +1149,7 @@ } } }, -"revision": "20261007", +"revision": "20261013", "rootUrl": "https://health.googleapis.com/", "schemas": { "ActiveEnergyBurned": { @@ -2130,10 +2130,6 @@ "$ref": "SedentaryPeriodRollupValue", "description": "Returned by default when rolling up data points from the `sedentary-period` data type, or when requested explicitly using the `sedentary-period` rollup type identifier." }, -"skinTemperature": { -"$ref": "SkinTemperatureRollupValue", -"description": "Returned by default when rolling up data points from the `skin-temperature` data type." -}, "steps": { "$ref": "StepsRollupValue", "description": "Returned by default when rolling up data points from the `steps` data type, or when requested explicitly using the `steps` rollup type identifier." @@ -2382,10 +2378,6 @@ "$ref": "SedentaryPeriod", "description": "Optional. Data for points in the `sedentary-period` interval data type collection." }, -"skinTemperature": { -"$ref": "SkinTemperature", -"description": "Optional. Data for points in the `skin-temperature` sample data type collection." -}, "skinTemperatureSensors": { "$ref": "SkinTemperatureSensors", "description": "Optional. Data for points in the `skin-temperature-sensors` sample data type collection." @@ -5068,10 +5060,6 @@ "$ref": "SedentaryPeriod", "description": "Data for points in the `sedentary-period` interval data type collection." }, -"skinTemperature": { -"$ref": "SkinTemperature", -"description": "Data for points in the `skin-temperature` sample data type collection." -}, "skinTemperatureSensors": { "$ref": "SkinTemperatureSensors", "description": "Data for points in the `skin-temperature-sensors` sample data type collection." @@ -5289,10 +5277,6 @@ "$ref": "SedentaryPeriodRollupValue", "description": "Returned by default when rolling up data points from the `sedentary-period` data type, or when requested explicitly using the `sedentary-period` rollup type identifier." }, -"skinTemperature": { -"$ref": "SkinTemperatureRollupValue", -"description": "Returned by default when rolling up data points from the `skin-temperature` data type." -}, "startTime": { "description": "Start time of the window this value aggregates over", "format": "google-datetime", @@ -5678,94 +5662,6 @@ }, "type": "object" }, -"SkinTemperature": { -"description": "Skin temperature measurement.", -"id": "SkinTemperature", -"properties": { -"baselineTemperatureCelsius": { -"description": "Required. The baseline skin temperature in Celsius. Must be in the range `[0, 100]`.", -"format": "double", -"type": "number" -}, -"metadata": { -"$ref": "SkinTemperatureMetadata", -"description": "Optional. Metadata for the skin temperature measurement." -}, -"sampleTime": { -"$ref": "ObservationSampleTime", -"description": "Required. The time at which skin temperature was measured." -}, -"temperatureCelsius": { -"description": "Required. The skin temperature in Celsius. Must be in the range `[0, 100]`.", -"format": "double", -"type": "number" -} -}, -"type": "object" -}, -"SkinTemperatureMetadata": { -"description": "Metadata for the skin temperature measurement.", -"id": "SkinTemperatureMetadata", -"properties": { -"measurementLocation": { -"description": "Optional. The location of the skin temperature measurement.", -"enum": [ -"MEASUREMENT_LOCATION_UNSPECIFIED", -"OTHER", -"FINGER", -"TOE", -"WRIST" -], -"enumDescriptions": [ -"Measurement location is unspecified.", -"Other measurement location.", -"Finger measurement location.", -"Toe measurement location.", -"Wrist measurement location." -], -"type": "string" -}, -"measurementState": { -"description": "Optional. The motion state of the skin temperature measurement.", -"enum": [ -"MEASUREMENT_STATE_UNSPECIFIED", -"MEASUREMENT_STATE_OTHER", -"MEASUREMENT_STATE_AT_REST", -"MEASUREMENT_STATE_SLEEP" -], -"enumDescriptions": [ -"Measurement state is unspecified.", -"Other measurement state.", -"Measurement state at rest.", -"Measurement state during sleep." -], -"type": "string" -} -}, -"type": "object" -}, -"SkinTemperatureRollupValue": { -"description": "Represents the result of the rollup of the skin temperature data type.", -"id": "SkinTemperatureRollupValue", -"properties": { -"temperatureCelsiusAvg": { -"description": "Average skin temperature in Celsius.", -"format": "double", -"type": "number" -}, -"temperatureCelsiusMax": { -"description": "Maximum skin temperature in Celsius.", -"format": "double", -"type": "number" -}, -"temperatureCelsiusMin": { -"description": "Minimum skin temperature in Celsius.", -"format": "double", -"type": "number" -} -}, -"type": "object" -}, "SkinTemperatureSensors": { "description": "Skin temperature sensor data containing multi-sensor readings.", "id": "SkinTemperatureSensors", From d0b8c14255bfb66a0ac9f8f843be618d16ebd198 Mon Sep 17 00:00:00 2001 From: Yoshi Automation Date: Tue, 20 Oct 2026 07:24:02 +0000 Subject: [PATCH 24/34] feat(iam): update the api #### iam:v1 The following keys were added: - schemas.Oidc.properties.discoveryUri.type (Total Keys: 1) - schemas.WorkloadIdentityPoolProvider.properties.actorProviders (Total Keys: 2) --- ...am_v1.locations.workforcePools.subjects.html | 6 +++--- ...cations.workloadIdentityPools.providers.html | 16 ++++++++++++++++ .../discovery_cache/documents/iam.v1.json | 17 ++++++++++++++--- 3 files changed, 33 insertions(+), 6 deletions(-) diff --git a/docs/dyn/iam_v1.locations.workforcePools.subjects.html b/docs/dyn/iam_v1.locations.workforcePools.subjects.html index 90fa33418a..ced3614a42 100644 --- a/docs/dyn/iam_v1.locations.workforcePools.subjects.html +++ b/docs/dyn/iam_v1.locations.workforcePools.subjects.html @@ -87,7 +87,7 @@

Instance Methods

Deletes a WorkforcePoolSubject. Subject must not already be in a deleted state. A WorkforcePoolSubject is automatically created the first time an external credential is exchanged for a Google Cloud credential using a mapped `google.subject` attribute. There is no endpoint to manually create a WorkforcePoolSubject. For 30 days after a WorkforcePoolSubject is deleted, using the same `google.subject` attribute in token exchanges with Google Cloud STS fails. Call UndeleteWorkforcePoolSubject to undelete a WorkforcePoolSubject that has been deleted, within within 30 days of deleting it. After 30 days, the WorkforcePoolSubject is permanently deleted. At this point, a token exchange with Google Cloud STS that uses the same mapped `google.subject` attribute automatically creates a new WorkforcePoolSubject that is unrelated to the previously deleted WorkforcePoolSubject but has the same `google.subject` value.

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

-

Revokes all sessions for a given WorkforcePoolSubject.

+

Revokes all sessions for the specified WorkforcePoolSubject. Revoking sessions invalidates all active sessions and previously issued credentials for the subject, requiring the user to re-authenticate with the identity provider.

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

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

@@ -134,10 +134,10 @@

Method Details

revokeSessions(name, body=None, x__xgafv=None) - 
Revokes all sessions for a given WorkforcePoolSubject.
+  
Revokes all sessions for the specified WorkforcePoolSubject. Revoking sessions invalidates all active sessions and previously issued credentials for the subject, requiring the user to re-authenticate with the identity provider.
 
 Args:
-  name: string, Required. The resource name of the WorkforcePoolSubject. Special characters, like `/` and `:`, must be escaped, because all URLs need to conform to the "When to Escape and Unescape" section of [RFC3986](https://www.ietf.org/rfc/rfc2396.txt). Format: `locations/{location}/workforcePools/{workforce_pool_id}/subjects/{subject_id}` (required)
+  name: string, Required. The resource name of the WorkforcePoolSubject. Special characters, such as `/` and `:`, must be escaped, because all URLs must conform to the "When to Escape and Unescape" section of [RFC 3986](https://www.rfc-editor.org/info/rfc3986/). Format: `locations/{location}/workforcePools/{workforce_pool_id}/subjects/{subject_id}` (required)
   body: object, The request body.
     The object takes the form of:
 
diff --git a/docs/dyn/iam_v1.projects.locations.workloadIdentityPools.providers.html b/docs/dyn/iam_v1.projects.locations.workloadIdentityPools.providers.html
index e8c4c101b9..41484f877e 100644
--- a/docs/dyn/iam_v1.projects.locations.workloadIdentityPools.providers.html
+++ b/docs/dyn/iam_v1.projects.locations.workloadIdentityPools.providers.html
@@ -124,6 +124,9 @@ 
Method Details

     The object takes the form of:
 
 { # A configuration for an external identity provider.
+  "actorProviders": [ # Optional. A list of the resource names of WorkloadIdentityPoolProviders in the same pool that are authorized to issue actor tokens for this provider. An actor token represents the identity of the acting party to whom authority is delegated. At most 3 actor providers can be specified.
+    "A String",
+  ],
   "attributeCondition": "A String", # Optional. [A Common Expression Language](https://opensource.google/projects/cel) expression, in plain text, to restrict what otherwise valid authentication credentials issued by the provider should not be accepted. The expression must output a boolean representing whether to allow the federation. The following keywords may be referenced in the expressions: * `assertion`: JSON representing the authentication credential issued by the provider. * `google`: The Google attributes mapped from the assertion in the `attribute_mappings`. * `attribute`: The custom attributes mapped from the assertion in the `attribute_mappings`. The maximum length of the `attribute_condition` expression is 4,096 characters. Providing a condition longer than this will result in an error. If unspecified, all valid authentication credentials are accepted. However, multi-tenant identity providers (such as GitHub or Terraform Cloud) require an `attribute_condition` to prevent token spoofing. The following example shows how to only allow credentials with a mapped `google.groups` value of `admins`: ``` "'admins' in google.groups" ```
   "attributeMapping": { # Optional. Maps attributes from authentication credentials issued by an external identity provider to Google Cloud attributes, such as `subject` and `segment`. Each key must be a string specifying the Google Cloud IAM attribute to map to. The following keys are supported: * `google.subject`: The principal IAM is authenticating. You can reference this value in IAM bindings. This is also the subject that appears in Cloud Logging logs. Cannot exceed 127 bytes. * `google.groups`: Groups the external identity belongs to. You can grant groups access to resources using an IAM `principalSet` binding; access applies to all members of the group. You can also provide custom attributes by specifying `attribute.{custom_attribute}`, where `{custom_attribute}` is the name of the custom attribute to be mapped. You can define a maximum of 50 custom attributes. The maximum length of a mapped attribute key is 100 characters, and the key may only contain the characters [a-z0-9_]. You can reference these attributes in IAM policies to define fine-grained access for a workload to Google Cloud resources. For example: * `google.subject`: `principal://iam.googleapis.com/projects/{project}/locations/{location}/workloadIdentityPools/{pool}/subject/{value}` * `google.groups`: `principalSet://iam.googleapis.com/projects/{project}/locations/{location}/workloadIdentityPools/{pool}/group/{value}` * `attribute.{custom_attribute}`: `principalSet://iam.googleapis.com/projects/{project}/locations/{location}/workloadIdentityPools/{pool}/attribute.{custom_attribute}/{value}` Each value must be a [Common Expression Language] (https://opensource.google/projects/cel) function that maps an identity provider credential to the normalized attribute specified by the corresponding map key. You can use the `assertion` keyword in the expression to access a JSON representation of the authentication credential issued by the provider. The maximum length of an attribute mapping expression is 2048 characters. When evaluated, the total size of all mapped attributes must not exceed 8KB. For AWS providers, if no attribute mapping is defined, the following default mapping applies: ``` { "google.subject":"assertion.arn", "attribute.aws_role": "assertion.arn.contains('assumed-role')" " ? assertion.arn.extract('{account_arn}assumed-role/')" " + 'assumed-role/'" " + assertion.arn.extract('assumed-role/{role_name}/')" " : assertion.arn", } ``` If any custom attribute mappings are defined, they must include a mapping to the `google.subject` attribute. For OIDC providers, you must supply a custom mapping, which must include the `google.subject` attribute. For example, the following maps the `sub` claim of the incoming credential to the `subject` attribute on a Google token: ``` {"google.subject": "assertion.sub"} ```
     "a_key": "A String",
@@ -140,6 +143,7 @@ 
Method Details

     "allowedAudiences": [ # Optional. Acceptable values for the `aud` field (audience) in the OIDC token. Token exchange requests are rejected if the token audience does not match one of the configured values. Each audience may be at most 256 characters. A maximum of 10 audiences may be configured. If this list is empty, the OIDC token audience must be equal to the full canonical resource name of the WorkloadIdentityPoolProvider, with or without the HTTPS prefix. For example: ``` //iam.googleapis.com/projects//locations//workloadIdentityPools//providers/ https://iam.googleapis.com/projects//locations//workloadIdentityPools//providers/ ```
       "A String",
     ],
+    "discoveryUri": "A String", # Optional. The URL to fetch the OIDC discovery document from, overriding the default URL derived from `issuer_uri`. If not set, `discovery_uri` defaults to `issuer_uri` with `/.well-known/openid-configuration` appended, as per the OpenID Connect Discovery 1.0 specification. If set, `discovery_uri` must meet the following requirements: - Must start with `https://`. - Must not exceed 2000 characters. - The scheme, host, and port must match `issuer_uri`. - The path must contain `/.well-known/` (where `` is not empty, such as `openid-configuration`) and conform to the `issuer_uri` topology: - The well-known path segment is inserted before the issuer path (for example, `https://example.com/.well-known/openid-configuration/tenant1` for issuer `https://example.com/tenant1`), or - The well-known path segment is appended under the issuer path (for example, `https://example.com/tenant1/.well-known/openid-configuration` for issuer `https://example.com/tenant1`).
     "issuerUri": "A String", # Required. The OIDC `issuer_uri`. Must be an HTTPS endpoint. Per OpenID Connect Discovery 1.0 spec, the OIDC issuer URL is used to locate the provider's public keys (via `jwks_uri`) for verifying tokens like the OIDC ID token. These public key types must be 'EC' or 'RSA'.
     "jwksJson": "A String", # Optional. OIDC JWKs in JSON String format. For details on the definition of a JWK, see https://tools.ietf.org/html/rfc7517. If not set, the `jwks_uri` from the discovery document(fetched from the .well-known path of the `issuer_uri`) will be used. Currently, RSA and EC asymmetric keys are supported. The JWK must use following format and include only the following fields: { "keys": [ { "kty": "RSA/EC", "alg": "", "use": "sig", "kid": "", "n": "", "e": "", "x": "", "y": "", "crv": "" } ] }
   },
@@ -244,6 +248,9 @@ 
Method Details

   An object of the form:
 
     { # A configuration for an external identity provider.
+  "actorProviders": [ # Optional. A list of the resource names of WorkloadIdentityPoolProviders in the same pool that are authorized to issue actor tokens for this provider. An actor token represents the identity of the acting party to whom authority is delegated. At most 3 actor providers can be specified.
+    "A String",
+  ],
   "attributeCondition": "A String", # Optional. [A Common Expression Language](https://opensource.google/projects/cel) expression, in plain text, to restrict what otherwise valid authentication credentials issued by the provider should not be accepted. The expression must output a boolean representing whether to allow the federation. The following keywords may be referenced in the expressions: * `assertion`: JSON representing the authentication credential issued by the provider. * `google`: The Google attributes mapped from the assertion in the `attribute_mappings`. * `attribute`: The custom attributes mapped from the assertion in the `attribute_mappings`. The maximum length of the `attribute_condition` expression is 4,096 characters. Providing a condition longer than this will result in an error. If unspecified, all valid authentication credentials are accepted. However, multi-tenant identity providers (such as GitHub or Terraform Cloud) require an `attribute_condition` to prevent token spoofing. The following example shows how to only allow credentials with a mapped `google.groups` value of `admins`: ``` "'admins' in google.groups" ```
   "attributeMapping": { # Optional. Maps attributes from authentication credentials issued by an external identity provider to Google Cloud attributes, such as `subject` and `segment`. Each key must be a string specifying the Google Cloud IAM attribute to map to. The following keys are supported: * `google.subject`: The principal IAM is authenticating. You can reference this value in IAM bindings. This is also the subject that appears in Cloud Logging logs. Cannot exceed 127 bytes. * `google.groups`: Groups the external identity belongs to. You can grant groups access to resources using an IAM `principalSet` binding; access applies to all members of the group. You can also provide custom attributes by specifying `attribute.{custom_attribute}`, where `{custom_attribute}` is the name of the custom attribute to be mapped. You can define a maximum of 50 custom attributes. The maximum length of a mapped attribute key is 100 characters, and the key may only contain the characters [a-z0-9_]. You can reference these attributes in IAM policies to define fine-grained access for a workload to Google Cloud resources. For example: * `google.subject`: `principal://iam.googleapis.com/projects/{project}/locations/{location}/workloadIdentityPools/{pool}/subject/{value}` * `google.groups`: `principalSet://iam.googleapis.com/projects/{project}/locations/{location}/workloadIdentityPools/{pool}/group/{value}` * `attribute.{custom_attribute}`: `principalSet://iam.googleapis.com/projects/{project}/locations/{location}/workloadIdentityPools/{pool}/attribute.{custom_attribute}/{value}` Each value must be a [Common Expression Language] (https://opensource.google/projects/cel) function that maps an identity provider credential to the normalized attribute specified by the corresponding map key. You can use the `assertion` keyword in the expression to access a JSON representation of the authentication credential issued by the provider. The maximum length of an attribute mapping expression is 2048 characters. When evaluated, the total size of all mapped attributes must not exceed 8KB. For AWS providers, if no attribute mapping is defined, the following default mapping applies: ``` { "google.subject":"assertion.arn", "attribute.aws_role": "assertion.arn.contains('assumed-role')" " ? assertion.arn.extract('{account_arn}assumed-role/')" " + 'assumed-role/'" " + assertion.arn.extract('assumed-role/{role_name}/')" " : assertion.arn", } ``` If any custom attribute mappings are defined, they must include a mapping to the `google.subject` attribute. For OIDC providers, you must supply a custom mapping, which must include the `google.subject` attribute. For example, the following maps the `sub` claim of the incoming credential to the `subject` attribute on a Google token: ``` {"google.subject": "assertion.sub"} ```
     "a_key": "A String",
@@ -260,6 +267,7 @@ 
Method Details

     "allowedAudiences": [ # Optional. Acceptable values for the `aud` field (audience) in the OIDC token. Token exchange requests are rejected if the token audience does not match one of the configured values. Each audience may be at most 256 characters. A maximum of 10 audiences may be configured. If this list is empty, the OIDC token audience must be equal to the full canonical resource name of the WorkloadIdentityPoolProvider, with or without the HTTPS prefix. For example: ``` //iam.googleapis.com/projects//locations//workloadIdentityPools//providers/ https://iam.googleapis.com/projects//locations//workloadIdentityPools//providers/ ```
       "A String",
     ],
+    "discoveryUri": "A String", # Optional. The URL to fetch the OIDC discovery document from, overriding the default URL derived from `issuer_uri`. If not set, `discovery_uri` defaults to `issuer_uri` with `/.well-known/openid-configuration` appended, as per the OpenID Connect Discovery 1.0 specification. If set, `discovery_uri` must meet the following requirements: - Must start with `https://`. - Must not exceed 2000 characters. - The scheme, host, and port must match `issuer_uri`. - The path must contain `/.well-known/` (where `` is not empty, such as `openid-configuration`) and conform to the `issuer_uri` topology: - The well-known path segment is inserted before the issuer path (for example, `https://example.com/.well-known/openid-configuration/tenant1` for issuer `https://example.com/tenant1`), or - The well-known path segment is appended under the issuer path (for example, `https://example.com/tenant1/.well-known/openid-configuration` for issuer `https://example.com/tenant1`).
     "issuerUri": "A String", # Required. The OIDC `issuer_uri`. Must be an HTTPS endpoint. Per OpenID Connect Discovery 1.0 spec, the OIDC issuer URL is used to locate the provider's public keys (via `jwks_uri`) for verifying tokens like the OIDC ID token. These public key types must be 'EC' or 'RSA'.
     "jwksJson": "A String", # Optional. OIDC JWKs in JSON String format. For details on the definition of a JWK, see https://tools.ietf.org/html/rfc7517. If not set, the `jwks_uri` from the discovery document(fetched from the .well-known path of the `issuer_uri`) will be used. Currently, RSA and EC asymmetric keys are supported. The JWK must use following format and include only the following fields: { "keys": [ { "kty": "RSA/EC", "alg": "", "use": "sig", "kid": "", "n": "", "e": "", "x": "", "y": "", "crv": "" } ] }
   },
@@ -306,6 +314,9 @@ 
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.
   "workloadIdentityPoolProviders": [ # A list of providers.
     { # A configuration for an external identity provider.
+      "actorProviders": [ # Optional. A list of the resource names of WorkloadIdentityPoolProviders in the same pool that are authorized to issue actor tokens for this provider. An actor token represents the identity of the acting party to whom authority is delegated. At most 3 actor providers can be specified.
+        "A String",
+      ],
       "attributeCondition": "A String", # Optional. [A Common Expression Language](https://opensource.google/projects/cel) expression, in plain text, to restrict what otherwise valid authentication credentials issued by the provider should not be accepted. The expression must output a boolean representing whether to allow the federation. The following keywords may be referenced in the expressions: * `assertion`: JSON representing the authentication credential issued by the provider. * `google`: The Google attributes mapped from the assertion in the `attribute_mappings`. * `attribute`: The custom attributes mapped from the assertion in the `attribute_mappings`. The maximum length of the `attribute_condition` expression is 4,096 characters. Providing a condition longer than this will result in an error. If unspecified, all valid authentication credentials are accepted. However, multi-tenant identity providers (such as GitHub or Terraform Cloud) require an `attribute_condition` to prevent token spoofing. The following example shows how to only allow credentials with a mapped `google.groups` value of `admins`: ``` "'admins' in google.groups" ```
       "attributeMapping": { # Optional. Maps attributes from authentication credentials issued by an external identity provider to Google Cloud attributes, such as `subject` and `segment`. Each key must be a string specifying the Google Cloud IAM attribute to map to. The following keys are supported: * `google.subject`: The principal IAM is authenticating. You can reference this value in IAM bindings. This is also the subject that appears in Cloud Logging logs. Cannot exceed 127 bytes. * `google.groups`: Groups the external identity belongs to. You can grant groups access to resources using an IAM `principalSet` binding; access applies to all members of the group. You can also provide custom attributes by specifying `attribute.{custom_attribute}`, where `{custom_attribute}` is the name of the custom attribute to be mapped. You can define a maximum of 50 custom attributes. The maximum length of a mapped attribute key is 100 characters, and the key may only contain the characters [a-z0-9_]. You can reference these attributes in IAM policies to define fine-grained access for a workload to Google Cloud resources. For example: * `google.subject`: `principal://iam.googleapis.com/projects/{project}/locations/{location}/workloadIdentityPools/{pool}/subject/{value}` * `google.groups`: `principalSet://iam.googleapis.com/projects/{project}/locations/{location}/workloadIdentityPools/{pool}/group/{value}` * `attribute.{custom_attribute}`: `principalSet://iam.googleapis.com/projects/{project}/locations/{location}/workloadIdentityPools/{pool}/attribute.{custom_attribute}/{value}` Each value must be a [Common Expression Language] (https://opensource.google/projects/cel) function that maps an identity provider credential to the normalized attribute specified by the corresponding map key. You can use the `assertion` keyword in the expression to access a JSON representation of the authentication credential issued by the provider. The maximum length of an attribute mapping expression is 2048 characters. When evaluated, the total size of all mapped attributes must not exceed 8KB. For AWS providers, if no attribute mapping is defined, the following default mapping applies: ``` { "google.subject":"assertion.arn", "attribute.aws_role": "assertion.arn.contains('assumed-role')" " ? assertion.arn.extract('{account_arn}assumed-role/')" " + 'assumed-role/'" " + assertion.arn.extract('assumed-role/{role_name}/')" " : assertion.arn", } ``` If any custom attribute mappings are defined, they must include a mapping to the `google.subject` attribute. For OIDC providers, you must supply a custom mapping, which must include the `google.subject` attribute. For example, the following maps the `sub` claim of the incoming credential to the `subject` attribute on a Google token: ``` {"google.subject": "assertion.sub"} ```
         "a_key": "A String",
@@ -322,6 +333,7 @@ 
Method Details

         "allowedAudiences": [ # Optional. Acceptable values for the `aud` field (audience) in the OIDC token. Token exchange requests are rejected if the token audience does not match one of the configured values. Each audience may be at most 256 characters. A maximum of 10 audiences may be configured. If this list is empty, the OIDC token audience must be equal to the full canonical resource name of the WorkloadIdentityPoolProvider, with or without the HTTPS prefix. For example: ``` //iam.googleapis.com/projects//locations//workloadIdentityPools//providers/ https://iam.googleapis.com/projects//locations//workloadIdentityPools//providers/ ```
           "A String",
         ],
+        "discoveryUri": "A String", # Optional. The URL to fetch the OIDC discovery document from, overriding the default URL derived from `issuer_uri`. If not set, `discovery_uri` defaults to `issuer_uri` with `/.well-known/openid-configuration` appended, as per the OpenID Connect Discovery 1.0 specification. If set, `discovery_uri` must meet the following requirements: - Must start with `https://`. - Must not exceed 2000 characters. - The scheme, host, and port must match `issuer_uri`. - The path must contain `/.well-known/` (where `` is not empty, such as `openid-configuration`) and conform to the `issuer_uri` topology: - The well-known path segment is inserted before the issuer path (for example, `https://example.com/.well-known/openid-configuration/tenant1` for issuer `https://example.com/tenant1`), or - The well-known path segment is appended under the issuer path (for example, `https://example.com/tenant1/.well-known/openid-configuration` for issuer `https://example.com/tenant1`).
         "issuerUri": "A String", # Required. The OIDC `issuer_uri`. Must be an HTTPS endpoint. Per OpenID Connect Discovery 1.0 spec, the OIDC issuer URL is used to locate the provider's public keys (via `jwks_uri`) for verifying tokens like the OIDC ID token. These public key types must be 'EC' or 'RSA'.
         "jwksJson": "A String", # Optional. OIDC JWKs in JSON String format. For details on the definition of a JWK, see https://tools.ietf.org/html/rfc7517. If not set, the `jwks_uri` from the discovery document(fetched from the .well-known path of the `issuer_uri`) will be used. Currently, RSA and EC asymmetric keys are supported. The JWK must use following format and include only the following fields: { "keys": [ { "kty": "RSA/EC", "alg": "", "use": "sig", "kid": "", "n": "", "e": "", "x": "", "y": "", "crv": "" } ] }
       },
@@ -373,6 +385,9 @@ 
Method Details

     The object takes the form of:
 
 { # A configuration for an external identity provider.
+  "actorProviders": [ # Optional. A list of the resource names of WorkloadIdentityPoolProviders in the same pool that are authorized to issue actor tokens for this provider. An actor token represents the identity of the acting party to whom authority is delegated. At most 3 actor providers can be specified.
+    "A String",
+  ],
   "attributeCondition": "A String", # Optional. [A Common Expression Language](https://opensource.google/projects/cel) expression, in plain text, to restrict what otherwise valid authentication credentials issued by the provider should not be accepted. The expression must output a boolean representing whether to allow the federation. The following keywords may be referenced in the expressions: * `assertion`: JSON representing the authentication credential issued by the provider. * `google`: The Google attributes mapped from the assertion in the `attribute_mappings`. * `attribute`: The custom attributes mapped from the assertion in the `attribute_mappings`. The maximum length of the `attribute_condition` expression is 4,096 characters. Providing a condition longer than this will result in an error. If unspecified, all valid authentication credentials are accepted. However, multi-tenant identity providers (such as GitHub or Terraform Cloud) require an `attribute_condition` to prevent token spoofing. The following example shows how to only allow credentials with a mapped `google.groups` value of `admins`: ``` "'admins' in google.groups" ```
   "attributeMapping": { # Optional. Maps attributes from authentication credentials issued by an external identity provider to Google Cloud attributes, such as `subject` and `segment`. Each key must be a string specifying the Google Cloud IAM attribute to map to. The following keys are supported: * `google.subject`: The principal IAM is authenticating. You can reference this value in IAM bindings. This is also the subject that appears in Cloud Logging logs. Cannot exceed 127 bytes. * `google.groups`: Groups the external identity belongs to. You can grant groups access to resources using an IAM `principalSet` binding; access applies to all members of the group. You can also provide custom attributes by specifying `attribute.{custom_attribute}`, where `{custom_attribute}` is the name of the custom attribute to be mapped. You can define a maximum of 50 custom attributes. The maximum length of a mapped attribute key is 100 characters, and the key may only contain the characters [a-z0-9_]. You can reference these attributes in IAM policies to define fine-grained access for a workload to Google Cloud resources. For example: * `google.subject`: `principal://iam.googleapis.com/projects/{project}/locations/{location}/workloadIdentityPools/{pool}/subject/{value}` * `google.groups`: `principalSet://iam.googleapis.com/projects/{project}/locations/{location}/workloadIdentityPools/{pool}/group/{value}` * `attribute.{custom_attribute}`: `principalSet://iam.googleapis.com/projects/{project}/locations/{location}/workloadIdentityPools/{pool}/attribute.{custom_attribute}/{value}` Each value must be a [Common Expression Language] (https://opensource.google/projects/cel) function that maps an identity provider credential to the normalized attribute specified by the corresponding map key. You can use the `assertion` keyword in the expression to access a JSON representation of the authentication credential issued by the provider. The maximum length of an attribute mapping expression is 2048 characters. When evaluated, the total size of all mapped attributes must not exceed 8KB. For AWS providers, if no attribute mapping is defined, the following default mapping applies: ``` { "google.subject":"assertion.arn", "attribute.aws_role": "assertion.arn.contains('assumed-role')" " ? assertion.arn.extract('{account_arn}assumed-role/')" " + 'assumed-role/'" " + assertion.arn.extract('assumed-role/{role_name}/')" " : assertion.arn", } ``` If any custom attribute mappings are defined, they must include a mapping to the `google.subject` attribute. For OIDC providers, you must supply a custom mapping, which must include the `google.subject` attribute. For example, the following maps the `sub` claim of the incoming credential to the `subject` attribute on a Google token: ``` {"google.subject": "assertion.sub"} ```
     "a_key": "A String",
@@ -389,6 +404,7 @@ 
Method Details

     "allowedAudiences": [ # Optional. Acceptable values for the `aud` field (audience) in the OIDC token. Token exchange requests are rejected if the token audience does not match one of the configured values. Each audience may be at most 256 characters. A maximum of 10 audiences may be configured. If this list is empty, the OIDC token audience must be equal to the full canonical resource name of the WorkloadIdentityPoolProvider, with or without the HTTPS prefix. For example: ``` //iam.googleapis.com/projects//locations//workloadIdentityPools//providers/ https://iam.googleapis.com/projects//locations//workloadIdentityPools//providers/ ```
       "A String",
     ],
+    "discoveryUri": "A String", # Optional. The URL to fetch the OIDC discovery document from, overriding the default URL derived from `issuer_uri`. If not set, `discovery_uri` defaults to `issuer_uri` with `/.well-known/openid-configuration` appended, as per the OpenID Connect Discovery 1.0 specification. If set, `discovery_uri` must meet the following requirements: - Must start with `https://`. - Must not exceed 2000 characters. - The scheme, host, and port must match `issuer_uri`. - The path must contain `/.well-known/` (where `` is not empty, such as `openid-configuration`) and conform to the `issuer_uri` topology: - The well-known path segment is inserted before the issuer path (for example, `https://example.com/.well-known/openid-configuration/tenant1` for issuer `https://example.com/tenant1`), or - The well-known path segment is appended under the issuer path (for example, `https://example.com/tenant1/.well-known/openid-configuration` for issuer `https://example.com/tenant1`).
     "issuerUri": "A String", # Required. The OIDC `issuer_uri`. Must be an HTTPS endpoint. Per OpenID Connect Discovery 1.0 spec, the OIDC issuer URL is used to locate the provider's public keys (via `jwks_uri`) for verifying tokens like the OIDC ID token. These public key types must be 'EC' or 'RSA'.
     "jwksJson": "A String", # Optional. OIDC JWKs in JSON String format. For details on the definition of a JWK, see https://tools.ietf.org/html/rfc7517. If not set, the `jwks_uri` from the discovery document(fetched from the .well-known path of the `issuer_uri`) will be used. Currently, RSA and EC asymmetric keys are supported. The JWK must use following format and include only the following fields: { "keys": [ { "kty": "RSA/EC", "alg": "", "use": "sig", "kid": "", "n": "", "e": "", "x": "", "y": "", "crv": "" } ] }
   },
diff --git a/googleapiclient/discovery_cache/documents/iam.v1.json b/googleapiclient/discovery_cache/documents/iam.v1.json
index a8f959bf13..25b612ccc9 100644
--- a/googleapiclient/discovery_cache/documents/iam.v1.json
+++ b/googleapiclient/discovery_cache/documents/iam.v1.json
@@ -1334,7 +1334,7 @@
 ]
 },
 "revokeSessions": {
-"description": "Revokes all sessions for a given WorkforcePoolSubject.",
+"description": "Revokes all sessions for the specified WorkforcePoolSubject. Revoking sessions invalidates all active sessions and previously issued credentials for the subject, requiring the user to re-authenticate with the identity provider.",
 "flatPath": "v1/locations/{locationsId}/workforcePools/{workforcePoolsId}/subjects/{subjectsId}:revokeSessions",
 "httpMethod": "POST",
 "id": "iam.locations.workforcePools.subjects.revokeSessions",
@@ -1343,7 +1343,7 @@
 ],
 "parameters": {
 "name": {
-"description": "Required. The resource name of the WorkforcePoolSubject. Special characters, like `/` and `:`, must be escaped, because all URLs need to conform to the \"When to Escape and Unescape\" section of [RFC3986](https://www.ietf.org/rfc/rfc2396.txt). Format: `locations/{location}/workforcePools/{workforce_pool_id}/subjects/{subject_id}`",
+"description": "Required. The resource name of the WorkforcePoolSubject. Special characters, such as `/` and `:`, must be escaped, because all URLs must conform to the \"When to Escape and Unescape\" section of [RFC 3986](https://www.rfc-editor.org/info/rfc3986/). Format: `locations/{location}/workforcePools/{workforce_pool_id}/subjects/{subject_id}`",
 "location": "path",
 "pattern": "^locations/[^/]+/workforcePools/[^/]+/subjects/[^/]+$",
 "required": true,
@@ -4369,7 +4369,7 @@
 }
 }
 },
-"revision": "20260925",
+"revision": "20261012",
 "rootUrl": "https://iam.googleapis.com/",
 "schemas": {
 "AccessRestrictions": {
@@ -5504,6 +5504,10 @@
 },
 "type": "array"
 },
+"discoveryUri": {
+"description": "Optional. The URL to fetch the OIDC discovery document from, overriding the default URL derived from `issuer_uri`. If not set, `discovery_uri` defaults to `issuer_uri` with `/.well-known/openid-configuration` appended, as per the OpenID Connect Discovery 1.0 specification. If set, `discovery_uri` must meet the following requirements: - Must start with `https://`. - Must not exceed 2000 characters. - The scheme, host, and port must match `issuer_uri`. - The path must contain `/.well-known/` (where `` is not empty, such as `openid-configuration`) and conform to the `issuer_uri` topology: - The well-known path segment is inserted before the issuer path (for example, `https://example.com/.well-known/openid-configuration/tenant1` for issuer `https://example.com/tenant1`), or - The well-known path segment is appended under the issuer path (for example, `https://example.com/tenant1/.well-known/openid-configuration` for issuer `https://example.com/tenant1`).",
+"type": "string"
+},
 "issuerUri": {
 "description": "Required. The OIDC `issuer_uri`. Must be an HTTPS endpoint. Per OpenID Connect Discovery 1.0 spec, the OIDC issuer URL is used to locate the provider's public keys (via `jwks_uri`) for verifying tokens like the OIDC ID token. These public key types must be 'EC' or 'RSA'.",
 "type": "string"
@@ -6885,6 +6889,13 @@ false
 "description": "A configuration for an external identity provider.",
 "id": "WorkloadIdentityPoolProvider",
 "properties": {
+"actorProviders": {
+"description": "Optional. A list of the resource names of WorkloadIdentityPoolProviders in the same pool that are authorized to issue actor tokens for this provider. An actor token represents the identity of the acting party to whom authority is delegated. At most 3 actor providers can be specified.",
+"items": {
+"type": "string"
+},
+"type": "array"
+},
 "attributeCondition": {
 "description": "Optional. [A Common Expression Language](https://opensource.google/projects/cel) expression, in plain text, to restrict what otherwise valid authentication credentials issued by the provider should not be accepted. The expression must output a boolean representing whether to allow the federation. The following keywords may be referenced in the expressions: * `assertion`: JSON representing the authentication credential issued by the provider. * `google`: The Google attributes mapped from the assertion in the `attribute_mappings`. * `attribute`: The custom attributes mapped from the assertion in the `attribute_mappings`. The maximum length of the `attribute_condition` expression is 4,096 characters. Providing a condition longer than this will result in an error. If unspecified, all valid authentication credentials are accepted. However, multi-tenant identity providers (such as GitHub or Terraform Cloud) require an `attribute_condition` to prevent token spoofing. The following example shows how to only allow credentials with a mapped `google.groups` value of `admins`: ``` \"'admins' in google.groups\" ```",
 "type": "string"

From ba84fd8b08e18b43940cc52f9ff1146c57fef84f Mon Sep 17 00:00:00 2001
From: Yoshi Automation 
Date: Tue, 20 Oct 2026 07:24:02 +0000
Subject: [PATCH 25/34] feat(networksecurity): update the api

#### networksecurity:v1

The following keys were added:
- schemas.MTLSPolicy.properties.clientValidationRelaxations (Total Keys: 2)

#### networksecurity:v1beta1

The following keys were added:
- schemas.MTLSPolicy.properties.clientValidationRelaxations (Total Keys: 2)
---
 ....projects.locations.serverTlsPolicies.html | 12 +++++++++
 ....projects.locations.serverTlsPolicies.html | 12 +++++++++
 .../documents/networksecurity.v1.json         | 27 ++++++++++++++++---
 .../documents/networksecurity.v1beta1.json    | 27 ++++++++++++++++---
 4 files changed, 72 insertions(+), 6 deletions(-)

diff --git a/docs/dyn/networksecurity_v1.projects.locations.serverTlsPolicies.html b/docs/dyn/networksecurity_v1.projects.locations.serverTlsPolicies.html
index 1a41c989bd..8733f1491a 100644
--- a/docs/dyn/networksecurity_v1.projects.locations.serverTlsPolicies.html
+++ b/docs/dyn/networksecurity_v1.projects.locations.serverTlsPolicies.html
@@ -138,6 +138,9 @@ 
Method Details

       },
     ],
     "clientValidationMode": "A String", # When the client presents an invalid certificate or no certificate to the load balancer, the `client_validation_mode` specifies how the client connection is handled. Required if the policy is to be used with the Application Load Balancers. For Traffic Director it must be empty.
+    "clientValidationRelaxations": [ # A list of validation relaxations to apply when `client_validation_mode` is set to ALLOW_VALIDATION_RELAXATIONS.
+      "A String",
+    ],
     "clientValidationTrustConfig": "A String", # Reference to the TrustConfig from certificatemanager.googleapis.com namespace. If specified, the chain validation will be performed against certificates configured in the given TrustConfig. Allowed only if the policy is to be used with Application Load Balancers.
   },
   "name": "A String", # Required. Name of the ServerTlsPolicy resource. It matches the pattern `projects/*/locations/{location}/serverTlsPolicies/{server_tls_policy}`
@@ -250,6 +253,9 @@ 
Method Details

       },
     ],
     "clientValidationMode": "A String", # When the client presents an invalid certificate or no certificate to the load balancer, the `client_validation_mode` specifies how the client connection is handled. Required if the policy is to be used with the Application Load Balancers. For Traffic Director it must be empty.
+    "clientValidationRelaxations": [ # A list of validation relaxations to apply when `client_validation_mode` is set to ALLOW_VALIDATION_RELAXATIONS.
+      "A String",
+    ],
     "clientValidationTrustConfig": "A String", # Reference to the TrustConfig from certificatemanager.googleapis.com namespace. If specified, the chain validation will be performed against certificates configured in the given TrustConfig. Allowed only if the policy is to be used with Application Load Balancers.
   },
   "name": "A String", # Required. Name of the ServerTlsPolicy resource. It matches the pattern `projects/*/locations/{location}/serverTlsPolicies/{server_tls_policy}`
@@ -352,6 +358,9 @@ 
Method Details

           },
         ],
         "clientValidationMode": "A String", # When the client presents an invalid certificate or no certificate to the load balancer, the `client_validation_mode` specifies how the client connection is handled. Required if the policy is to be used with the Application Load Balancers. For Traffic Director it must be empty.
+        "clientValidationRelaxations": [ # A list of validation relaxations to apply when `client_validation_mode` is set to ALLOW_VALIDATION_RELAXATIONS.
+          "A String",
+        ],
         "clientValidationTrustConfig": "A String", # Reference to the TrustConfig from certificatemanager.googleapis.com namespace. If specified, the chain validation will be performed against certificates configured in the given TrustConfig. Allowed only if the policy is to be used with Application Load Balancers.
       },
       "name": "A String", # Required. Name of the ServerTlsPolicy resource. It matches the pattern `projects/*/locations/{location}/serverTlsPolicies/{server_tls_policy}`
@@ -414,6 +423,9 @@ 
Method Details

       },
     ],
     "clientValidationMode": "A String", # When the client presents an invalid certificate or no certificate to the load balancer, the `client_validation_mode` specifies how the client connection is handled. Required if the policy is to be used with the Application Load Balancers. For Traffic Director it must be empty.
+    "clientValidationRelaxations": [ # A list of validation relaxations to apply when `client_validation_mode` is set to ALLOW_VALIDATION_RELAXATIONS.
+      "A String",
+    ],
     "clientValidationTrustConfig": "A String", # Reference to the TrustConfig from certificatemanager.googleapis.com namespace. If specified, the chain validation will be performed against certificates configured in the given TrustConfig. Allowed only if the policy is to be used with Application Load Balancers.
   },
   "name": "A String", # Required. Name of the ServerTlsPolicy resource. It matches the pattern `projects/*/locations/{location}/serverTlsPolicies/{server_tls_policy}`
diff --git a/docs/dyn/networksecurity_v1beta1.projects.locations.serverTlsPolicies.html b/docs/dyn/networksecurity_v1beta1.projects.locations.serverTlsPolicies.html
index 295c525d6f..4219dac8d8 100644
--- a/docs/dyn/networksecurity_v1beta1.projects.locations.serverTlsPolicies.html
+++ b/docs/dyn/networksecurity_v1beta1.projects.locations.serverTlsPolicies.html
@@ -138,6 +138,9 @@ 
Method Details

       },
     ],
     "clientValidationMode": "A String", # When the client presents an invalid certificate or no certificate to the load balancer, the `client_validation_mode` specifies how the client connection is handled. Required if the policy is to be used with the Application Load Balancers. For Traffic Director it must be empty.
+    "clientValidationRelaxations": [ # A list of validation relaxations to apply when `client_validation_mode` is set to ALLOW_VALIDATION_RELAXATIONS.
+      "A String",
+    ],
     "clientValidationTrustConfig": "A String", # Reference to the TrustConfig from certificatemanager.googleapis.com namespace. If specified, the chain validation will be performed against certificates configured in the given TrustConfig. Allowed only if the policy is to be used with Application Load Balancers.
   },
   "name": "A String", # Required. Name of the ServerTlsPolicy resource. It matches the pattern `projects/*/locations/{location}/serverTlsPolicies/{server_tls_policy}`
@@ -250,6 +253,9 @@ 
Method Details

       },
     ],
     "clientValidationMode": "A String", # When the client presents an invalid certificate or no certificate to the load balancer, the `client_validation_mode` specifies how the client connection is handled. Required if the policy is to be used with the Application Load Balancers. For Traffic Director it must be empty.
+    "clientValidationRelaxations": [ # A list of validation relaxations to apply when `client_validation_mode` is set to ALLOW_VALIDATION_RELAXATIONS.
+      "A String",
+    ],
     "clientValidationTrustConfig": "A String", # Reference to the TrustConfig from certificatemanager.googleapis.com namespace. If specified, the chain validation will be performed against certificates configured in the given TrustConfig. Allowed only if the policy is to be used with Application Load Balancers.
   },
   "name": "A String", # Required. Name of the ServerTlsPolicy resource. It matches the pattern `projects/*/locations/{location}/serverTlsPolicies/{server_tls_policy}`
@@ -352,6 +358,9 @@ 
Method Details

           },
         ],
         "clientValidationMode": "A String", # When the client presents an invalid certificate or no certificate to the load balancer, the `client_validation_mode` specifies how the client connection is handled. Required if the policy is to be used with the Application Load Balancers. For Traffic Director it must be empty.
+        "clientValidationRelaxations": [ # A list of validation relaxations to apply when `client_validation_mode` is set to ALLOW_VALIDATION_RELAXATIONS.
+          "A String",
+        ],
         "clientValidationTrustConfig": "A String", # Reference to the TrustConfig from certificatemanager.googleapis.com namespace. If specified, the chain validation will be performed against certificates configured in the given TrustConfig. Allowed only if the policy is to be used with Application Load Balancers.
       },
       "name": "A String", # Required. Name of the ServerTlsPolicy resource. It matches the pattern `projects/*/locations/{location}/serverTlsPolicies/{server_tls_policy}`
@@ -414,6 +423,9 @@ 
Method Details

       },
     ],
     "clientValidationMode": "A String", # When the client presents an invalid certificate or no certificate to the load balancer, the `client_validation_mode` specifies how the client connection is handled. Required if the policy is to be used with the Application Load Balancers. For Traffic Director it must be empty.
+    "clientValidationRelaxations": [ # A list of validation relaxations to apply when `client_validation_mode` is set to ALLOW_VALIDATION_RELAXATIONS.
+      "A String",
+    ],
     "clientValidationTrustConfig": "A String", # Reference to the TrustConfig from certificatemanager.googleapis.com namespace. If specified, the chain validation will be performed against certificates configured in the given TrustConfig. Allowed only if the policy is to be used with Application Load Balancers.
   },
   "name": "A String", # Required. Name of the ServerTlsPolicy resource. It matches the pattern `projects/*/locations/{location}/serverTlsPolicies/{server_tls_policy}`
diff --git a/googleapiclient/discovery_cache/documents/networksecurity.v1.json b/googleapiclient/discovery_cache/documents/networksecurity.v1.json
index 9a7a756f1c..75c5f76331 100644
--- a/googleapiclient/discovery_cache/documents/networksecurity.v1.json
+++ b/googleapiclient/discovery_cache/documents/networksecurity.v1.json
@@ -6341,7 +6341,7 @@
 }
 }
 },
-"revision": "20260924",
+"revision": "20261011",
 "rootUrl": "https://networksecurity.googleapis.com/",
 "schemas": {
 "AddAddressGroupItemsRequest": {
@@ -9108,15 +9108,36 @@
 "enum": [
 "CLIENT_VALIDATION_MODE_UNSPECIFIED",
 "ALLOW_INVALID_OR_MISSING_CLIENT_CERT",
-"REJECT_INVALID"
+"REJECT_INVALID",
+"ALLOW_VALIDATION_RELAXATIONS"
 ],
 "enumDescriptions": [
 "Not allowed.",
 "Allow connection even if certificate chain validation of the client certificate failed or no client certificate was presented. The proof of possession of the private key is always checked if client certificate was presented. This mode requires the backend to implement processing of data extracted from a client certificate to authenticate the peer, or to reject connections if the client certificate fingerprint is missing.",
-"Require a client certificate and allow connection to the backend only if validation of the client certificate passed. If set, requires a reference to non-empty TrustConfig specified in `client_validation_trust_config`."
+"Require a client certificate and allow connection to the backend only if validation of the client certificate passed. If set, requires a reference to non-empty TrustConfig specified in `client_validation_trust_config`.",
+"Require a client certificate, but apply the specific validation relaxations requested in `client_validation_relaxations`. All selected relaxations are applied simultaneously."
 ],
 "type": "string"
 },
+"clientValidationRelaxations": {
+"description": "A list of validation relaxations to apply when `client_validation_mode` is set to ALLOW_VALIDATION_RELAXATIONS.",
+"items": {
+"enum": [
+"CLIENT_VALIDATION_RELAXATION_UNSPECIFIED",
+"ALLOW_MISSING_EKU",
+"ALLOW_SHA1_HASHING",
+"ALLOW_EXPIRED_LEAF_CERTIFICATE"
+],
+"enumDescriptions": [
+"Not allowed.",
+"Allows the client certificate to completely omit the Extended Key Usage (EKU) extension. If the EKU extension is present, it must permit the `clientAuth` key purpose (OID 1.3.6.1.5.5.7.3.2). Security Warning: Enabling this option is risky if the customer uses a Root CA that issues certificates for multiple different purposes. Without EKU enforcement, a certificate intended for a non-authentication purpose (like S/MIME or server-only auth) might be accepted for mTLS client authentication. Customers should only use this relaxation if they are using a dedicated Private CA solely for issuing client authentication certificates.",
+"Allows validation of client certificate chains signed using legacy SHA-1 message digests. Enabling this is insecure and should only be used to support legacy clients during migration periods.",
+"Allows validation of an expired client leaf certificate. The certificate will be validated as if the current time was one second before the end of its validity period (the `notAfter` timestamp). This relaxation applies strictly to the leaf certificate and not to the rest of the chain."
+],
+"type": "string"
+},
+"type": "array"
+},
 "clientValidationTrustConfig": {
 "description": "Reference to the TrustConfig from certificatemanager.googleapis.com namespace. If specified, the chain validation will be performed against certificates configured in the given TrustConfig. Allowed only if the policy is to be used with Application Load Balancers.",
 "type": "string"
diff --git a/googleapiclient/discovery_cache/documents/networksecurity.v1beta1.json b/googleapiclient/discovery_cache/documents/networksecurity.v1beta1.json
index 8b9e218f14..f7b6e50726 100644
--- a/googleapiclient/discovery_cache/documents/networksecurity.v1beta1.json
+++ b/googleapiclient/discovery_cache/documents/networksecurity.v1beta1.json
@@ -6528,7 +6528,7 @@
 }
 }
 },
-"revision": "20260924",
+"revision": "20261011",
 "rootUrl": "https://networksecurity.googleapis.com/",
 "schemas": {
 "AddAddressGroupItemsRequest": {
@@ -9325,15 +9325,36 @@
 "enum": [
 "CLIENT_VALIDATION_MODE_UNSPECIFIED",
 "ALLOW_INVALID_OR_MISSING_CLIENT_CERT",
-"REJECT_INVALID"
+"REJECT_INVALID",
+"ALLOW_VALIDATION_RELAXATIONS"
 ],
 "enumDescriptions": [
 "Not allowed.",
 "Allow connection even if certificate chain validation of the client certificate failed or no client certificate was presented. The proof of possession of the private key is always checked if client certificate was presented. This mode requires the backend to implement processing of data extracted from a client certificate to authenticate the peer, or to reject connections if the client certificate fingerprint is missing.",
-"Require a client certificate and allow connection to the backend only if validation of the client certificate passed. If set, requires a reference to non-empty TrustConfig specified in `client_validation_trust_config`."
+"Require a client certificate and allow connection to the backend only if validation of the client certificate passed. If set, requires a reference to non-empty TrustConfig specified in `client_validation_trust_config`.",
+"Require a client certificate, but apply the specific validation relaxations requested in `client_validation_relaxations`. All selected relaxations are applied simultaneously."
 ],
 "type": "string"
 },
+"clientValidationRelaxations": {
+"description": "A list of validation relaxations to apply when `client_validation_mode` is set to ALLOW_VALIDATION_RELAXATIONS.",
+"items": {
+"enum": [
+"CLIENT_VALIDATION_RELAXATION_UNSPECIFIED",
+"ALLOW_MISSING_EKU",
+"ALLOW_SHA1_HASHING",
+"ALLOW_EXPIRED_LEAF_CERTIFICATE"
+],
+"enumDescriptions": [
+"Not allowed.",
+"Allows the client certificate to completely omit the Extended Key Usage (EKU) extension. If the EKU extension is present, it must permit the `clientAuth` key purpose (OID 1.3.6.1.5.5.7.3.2). Security Warning: Enabling this option is risky if the customer uses a Root CA that issues certificates for multiple different purposes. Without EKU enforcement, a certificate intended for a non-authentication purpose (like S/MIME or server-only auth) might be accepted for mTLS client authentication. Customers should only use this relaxation if they are using a dedicated Private CA solely for issuing client authentication certificates.",
+"Allows validation of client certificate chains signed using legacy SHA-1 message digests. Enabling this is insecure and should only be used to support legacy clients during migration periods.",
+"Allows validation of an expired client leaf certificate. The certificate will be validated as if the current time was one second before the end of its validity period (the `notAfter` timestamp). This relaxation applies strictly to the leaf certificate and not to the rest of the chain."
+],
+"type": "string"
+},
+"type": "array"
+},
 "clientValidationTrustConfig": {
 "description": "Reference to the TrustConfig from certificatemanager.googleapis.com namespace. If specified, the chain validation will be performed against certificates configured in the given TrustConfig. Allowed only if the policy is to be used with Application Load Balancers.",
 "type": "string"

From b7c10cb48ff921ed0f815b2cc576e54c2304d143 Mon Sep 17 00:00:00 2001
From: Yoshi Automation 
Date: Tue, 20 Oct 2026 07:24:02 +0000
Subject: [PATCH 26/34] feat(notebooks): update the api

#### notebooks:v2

The following keys were added:
- schemas.NetworkInterface.properties.internalIp.type (Total Keys: 1)
- schemas.VmImage.properties.imageId (Total Keys: 2)
---
 ...books_v2.projects.locations.instances.html |  8 ++++
 .../documents/notebooks.v2.json               | 39 ++++++++++++++++---
 2 files changed, 42 insertions(+), 5 deletions(-)

diff --git a/docs/dyn/notebooks_v2.projects.locations.instances.html b/docs/dyn/notebooks_v2.projects.locations.instances.html
index 7ba8969c52..960a6d5a32 100644
--- a/docs/dyn/notebooks_v2.projects.locations.instances.html
+++ b/docs/dyn/notebooks_v2.projects.locations.instances.html
@@ -270,6 +270,7 @@ 
Method Details

             "externalIp": "A String", # Optional. An external IP address associated with this instance. Specify an unused static external IP address available to the project or leave this field undefined to use an IP from a shared ephemeral IP address pool. If you specify a static external IP address, it must live in the same region as the zone of the instance.
           },
         ],
+        "internalIp": "A String", # Optional. An internal IP address associated with this instance. Specify an unused static internal IP address available to the subnet this instance is in, or leave this field undefined to use an IP from the subnet's ephemeral range.
         "network": "A String", # Optional. The name of the VPC that this VM instance is in. Format: `projects/{project_id}/global/networks/{network_id}`
         "nicType": "A String", # Optional. The type of vNIC to be used on this interface. This may be gVNIC or VirtioNet.
         "subnet": "A String", # Optional. The name of the subnet that this VM instance is in. Format: `projects/{project_id}/regions/{region}/subnetworks/{subnetwork_id}`
@@ -304,6 +305,7 @@ 
Method Details

     "vmImage": { # Definition of a custom Compute Engine virtual machine image for starting a notebook instance with the environment installed directly on the VM. # Optional. Use a Compute Engine VM image to start the notebook instance.
       "family": "A String", # Optional. Use this VM image family to find the image; the newest image in this family will be used.
       "imageDescription": "A String", # Output only. A human-readable description of the image running on the instance (for example, "Debian 11, Python 3.10"), derived at read time from the image release configuration (the source of truth). Set to "Custom" for unrecognized boot-disk images.
+      "imageId": "A String", # Output only. The ID of the specific Compute Engine VM image the instance is currently running (for example, "workbench-instances-2603-20260918-2130-rc0").
       "name": "A String", # Optional. Use VM image name to find the image.
       "project": "A String", # Required. The name of the Google Cloud project that this VM image belongs to. Format: `{project_id}`
     },
@@ -557,6 +559,7 @@ 
Method Details

             "externalIp": "A String", # Optional. An external IP address associated with this instance. Specify an unused static external IP address available to the project or leave this field undefined to use an IP from a shared ephemeral IP address pool. If you specify a static external IP address, it must live in the same region as the zone of the instance.
           },
         ],
+        "internalIp": "A String", # Optional. An internal IP address associated with this instance. Specify an unused static internal IP address available to the subnet this instance is in, or leave this field undefined to use an IP from the subnet's ephemeral range.
         "network": "A String", # Optional. The name of the VPC that this VM instance is in. Format: `projects/{project_id}/global/networks/{network_id}`
         "nicType": "A String", # Optional. The type of vNIC to be used on this interface. This may be gVNIC or VirtioNet.
         "subnet": "A String", # Optional. The name of the subnet that this VM instance is in. Format: `projects/{project_id}/regions/{region}/subnetworks/{subnetwork_id}`
@@ -591,6 +594,7 @@ 
Method Details

     "vmImage": { # Definition of a custom Compute Engine virtual machine image for starting a notebook instance with the environment installed directly on the VM. # Optional. Use a Compute Engine VM image to start the notebook instance.
       "family": "A String", # Optional. Use this VM image family to find the image; the newest image in this family will be used.
       "imageDescription": "A String", # Output only. A human-readable description of the image running on the instance (for example, "Debian 11, Python 3.10"), derived at read time from the image release configuration (the source of truth). Set to "Custom" for unrecognized boot-disk images.
+      "imageId": "A String", # Output only. The ID of the specific Compute Engine VM image the instance is currently running (for example, "workbench-instances-2603-20260918-2130-rc0").
       "name": "A String", # Optional. Use VM image name to find the image.
       "project": "A String", # Required. The name of the Google Cloud project that this VM image belongs to. Format: `{project_id}`
     },
@@ -779,6 +783,7 @@ 
Method Details

                 "externalIp": "A String", # Optional. An external IP address associated with this instance. Specify an unused static external IP address available to the project or leave this field undefined to use an IP from a shared ephemeral IP address pool. If you specify a static external IP address, it must live in the same region as the zone of the instance.
               },
             ],
+            "internalIp": "A String", # Optional. An internal IP address associated with this instance. Specify an unused static internal IP address available to the subnet this instance is in, or leave this field undefined to use an IP from the subnet's ephemeral range.
             "network": "A String", # Optional. The name of the VPC that this VM instance is in. Format: `projects/{project_id}/global/networks/{network_id}`
             "nicType": "A String", # Optional. The type of vNIC to be used on this interface. This may be gVNIC or VirtioNet.
             "subnet": "A String", # Optional. The name of the subnet that this VM instance is in. Format: `projects/{project_id}/regions/{region}/subnetworks/{subnetwork_id}`
@@ -813,6 +818,7 @@ 
Method Details

         "vmImage": { # Definition of a custom Compute Engine virtual machine image for starting a notebook instance with the environment installed directly on the VM. # Optional. Use a Compute Engine VM image to start the notebook instance.
           "family": "A String", # Optional. Use this VM image family to find the image; the newest image in this family will be used.
           "imageDescription": "A String", # Output only. A human-readable description of the image running on the instance (for example, "Debian 11, Python 3.10"), derived at read time from the image release configuration (the source of truth). Set to "Custom" for unrecognized boot-disk images.
+          "imageId": "A String", # Output only. The ID of the specific Compute Engine VM image the instance is currently running (for example, "workbench-instances-2603-20260918-2130-rc0").
           "name": "A String", # Optional. Use VM image name to find the image.
           "project": "A String", # Required. The name of the Google Cloud project that this VM image belongs to. Format: `{project_id}`
         },
@@ -937,6 +943,7 @@ 
Method Details

             "externalIp": "A String", # Optional. An external IP address associated with this instance. Specify an unused static external IP address available to the project or leave this field undefined to use an IP from a shared ephemeral IP address pool. If you specify a static external IP address, it must live in the same region as the zone of the instance.
           },
         ],
+        "internalIp": "A String", # Optional. An internal IP address associated with this instance. Specify an unused static internal IP address available to the subnet this instance is in, or leave this field undefined to use an IP from the subnet's ephemeral range.
         "network": "A String", # Optional. The name of the VPC that this VM instance is in. Format: `projects/{project_id}/global/networks/{network_id}`
         "nicType": "A String", # Optional. The type of vNIC to be used on this interface. This may be gVNIC or VirtioNet.
         "subnet": "A String", # Optional. The name of the subnet that this VM instance is in. Format: `projects/{project_id}/regions/{region}/subnetworks/{subnetwork_id}`
@@ -971,6 +978,7 @@ 
Method Details

     "vmImage": { # Definition of a custom Compute Engine virtual machine image for starting a notebook instance with the environment installed directly on the VM. # Optional. Use a Compute Engine VM image to start the notebook instance.
       "family": "A String", # Optional. Use this VM image family to find the image; the newest image in this family will be used.
       "imageDescription": "A String", # Output only. A human-readable description of the image running on the instance (for example, "Debian 11, Python 3.10"), derived at read time from the image release configuration (the source of truth). Set to "Custom" for unrecognized boot-disk images.
+      "imageId": "A String", # Output only. The ID of the specific Compute Engine VM image the instance is currently running (for example, "workbench-instances-2603-20260918-2130-rc0").
       "name": "A String", # Optional. Use VM image name to find the image.
       "project": "A String", # Required. The name of the Google Cloud project that this VM image belongs to. Format: `{project_id}`
     },
diff --git a/googleapiclient/discovery_cache/documents/notebooks.v2.json b/googleapiclient/discovery_cache/documents/notebooks.v2.json
index bd2a6132c3..00c36bf761 100644
--- a/googleapiclient/discovery_cache/documents/notebooks.v2.json
+++ b/googleapiclient/discovery_cache/documents/notebooks.v2.json
@@ -1002,7 +1002,7 @@
 }
 }
 },
-"revision": "20260909",
+"revision": "20261006",
 "rootUrl": "https://notebooks.googleapis.com/",
 "schemas": {
 "AcceleratorConfig": {
@@ -1034,9 +1034,27 @@
 "NVIDIA_B200",
 "NVIDIA_RTX6000"
 ],
+"enumDeprecated": [
+false,
+true,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+true,
+false,
+false,
+false
+],
 "enumDescriptions": [
 "Accelerator type is not specified.",
-"Accelerator type is Nvidia Tesla P100.",
+"Deprecated: Use `NVIDIA_TESLA_T4` (N1) or `NVIDIA_L4` (G2) instead. The NVIDIA Tesla P100 GPU is being decommissioned fleet-wide by Compute Engine and is no longer available for new instances.",
 "Accelerator type is Nvidia Tesla V100.",
 "Accelerator type is Nvidia Tesla P4.",
 "Accelerator type is Nvidia Tesla T4.",
@@ -1047,7 +1065,7 @@
 "Accelerator type is Nvidia Tesla H100 - MEGA 80GB.",
 "Accelerator type is Nvidia Tesla H200 - 141GB.",
 "Accelerator type is NVIDIA Tesla T4 Virtual Workstations.",
-"Accelerator type is NVIDIA Tesla P100 Virtual Workstations.",
+"Deprecated: Use `NVIDIA_TESLA_T4_VWS` instead. The NVIDIA Tesla P100 GPU (Virtual Workstations) is being decommissioned fleet-wide by Compute Engine and is no longer available for new instances.",
 "Accelerator type is NVIDIA Tesla P4 Virtual Workstations.",
 "Accelerator type is NVIDIA B200.",
 "NVIDIA RTX 6000."
@@ -1761,7 +1779,8 @@
 "UPGRADING",
 "INITIALIZING",
 "SUSPENDING",
-"SUSPENDED"
+"SUSPENDED",
+"ORPHANED"
 ],
 "enumDescriptions": [
 "State is not specified.",
@@ -1774,7 +1793,8 @@
 "The instance is upgrading.",
 "The instance is being created.",
 "The instance is suspending.",
-"The instance is suspended."
+"The instance is suspended.",
+"The instance has no VM. An upgrade removed the original and could not create its replacement; the data disk and any snapshots are intact. Retry the upgrade to finish it, or roll the instance back to the snapshot taken before it started."
 ],
 "readOnly": true,
 "type": "string"
@@ -1914,6 +1934,10 @@
 },
 "type": "array"
 },
+"internalIp": {
+"description": "Optional. An internal IP address associated with this instance. Specify an unused static internal IP address available to the subnet this instance is in, or leave this field undefined to use an IP from the subnet's ephemeral range.",
+"type": "string"
+},
 "network": {
 "description": "Optional. The name of the VPC that this VM instance is in. Format: `projects/{project_id}/global/networks/{network_id}`",
 "type": "string"
@@ -2392,6 +2416,11 @@
 "readOnly": true,
 "type": "string"
 },
+"imageId": {
+"description": "Output only. The ID of the specific Compute Engine VM image the instance is currently running (for example, \"workbench-instances-2603-20260918-2130-rc0\").",
+"readOnly": true,
+"type": "string"
+},
 "name": {
 "description": "Optional. Use VM image name to find the image.",
 "type": "string"

From c96e58502cc667d63820b96aff3a2dbffd66aad4 Mon Sep 17 00:00:00 2001
From: Yoshi Automation 
Date: Tue, 20 Oct 2026 07:24:02 +0000
Subject: [PATCH 27/34] feat(ondemandscanning): update the api

#### ondemandscanning:v1

The following keys were added:
- schemas.LayerAttribute (Total Keys: 4)
- schemas.LayerDetails.properties.attributes (Total Keys: 2)

#### ondemandscanning:v1beta1

The following keys were added:
- schemas.LayerAttribute (Total Keys: 4)
- schemas.LayerDetails.properties.attributes (Total Keys: 2)
---
 ...dscanning_v1.projects.locations.scans.html | 12 ++++++++++
 ...ning_v1beta1.projects.locations.scans.html | 12 ++++++++++
 .../documents/ondemandscanning.v1.json        | 24 ++++++++++++++++++-
 .../documents/ondemandscanning.v1beta1.json   | 24 ++++++++++++++++++-
 4 files changed, 70 insertions(+), 2 deletions(-)

diff --git a/docs/dyn/ondemandscanning_v1.projects.locations.scans.html b/docs/dyn/ondemandscanning_v1.projects.locations.scans.html
index 9bb0a3ff4a..ac55f498e3 100644
--- a/docs/dyn/ondemandscanning_v1.projects.locations.scans.html
+++ b/docs/dyn/ondemandscanning_v1.projects.locations.scans.html
@@ -136,6 +136,12 @@ 
Method Details

         { # Indicates the location at which a package was found.
           "filePath": "A String", # For jars that are contained inside .war files, this filepath can indicate the path to war file combined with the path to jar file.
           "layerDetails": { # Details about the layer a package was found in.
+            "attributes": [ # Attributes attached to this layer by plugins.
+              { # An attribute attached to a layer by a plugin.
+                "plugin": "A String", # The name of the plugin that generated this attribute.
+                "value": "A String", # The value of the attribute, with a meaning defined by the plugin.
+              },
+            ],
             "baseImages": [ # The base images the layer is found within.
               { # BaseImage describes a base image of a container image.
                 "layerCount": 42, # The number of layers that the base image is composed of.
@@ -161,6 +167,12 @@ 
Method Details

         },
       ],
       "layerDetails": { # Details about the layer a package was found in. # Deprecated: Layer details are captured per file location in FileLocation.layer_details. Top-level layer details is not persisted.
+        "attributes": [ # Attributes attached to this layer by plugins.
+          { # An attribute attached to a layer by a plugin.
+            "plugin": "A String", # The name of the plugin that generated this attribute.
+            "value": "A String", # The value of the attribute, with a meaning defined by the plugin.
+          },
+        ],
         "baseImages": [ # The base images the layer is found within.
           { # BaseImage describes a base image of a container image.
             "layerCount": 42, # The number of layers that the base image is composed of.
diff --git a/docs/dyn/ondemandscanning_v1beta1.projects.locations.scans.html b/docs/dyn/ondemandscanning_v1beta1.projects.locations.scans.html
index 2cb4175a32..e573566fd1 100644
--- a/docs/dyn/ondemandscanning_v1beta1.projects.locations.scans.html
+++ b/docs/dyn/ondemandscanning_v1beta1.projects.locations.scans.html
@@ -135,6 +135,12 @@ 
Method Details

         { # Indicates the location at which a package was found.
           "filePath": "A String", # For jars that are contained inside .war files, this filepath can indicate the path to war file combined with the path to jar file.
           "layerDetails": { # Details about the layer a package was found in.
+            "attributes": [ # Attributes attached to this layer by plugins.
+              { # An attribute attached to a layer by a plugin.
+                "plugin": "A String", # The name of the plugin that generated this attribute.
+                "value": "A String", # The value of the attribute, with a meaning defined by the plugin.
+              },
+            ],
             "baseImages": [ # The base images the layer is found within.
               { # BaseImage describes a base image of a container image.
                 "layerCount": 42, # The number of layers that the base image is composed of.
@@ -160,6 +166,12 @@ 
Method Details

         },
       ],
       "layerDetails": { # Details about the layer a package was found in. # Deprecated: Layer details are captured per file location in FileLocation.layer_details. Top-level layer details is not persisted.
+        "attributes": [ # Attributes attached to this layer by plugins.
+          { # An attribute attached to a layer by a plugin.
+            "plugin": "A String", # The name of the plugin that generated this attribute.
+            "value": "A String", # The value of the attribute, with a meaning defined by the plugin.
+          },
+        ],
         "baseImages": [ # The base images the layer is found within.
           { # BaseImage describes a base image of a container image.
             "layerCount": 42, # The number of layers that the base image is composed of.
diff --git a/googleapiclient/discovery_cache/documents/ondemandscanning.v1.json b/googleapiclient/discovery_cache/documents/ondemandscanning.v1.json
index 6a0ff519b2..fca5d54ff5 100644
--- a/googleapiclient/discovery_cache/documents/ondemandscanning.v1.json
+++ b/googleapiclient/discovery_cache/documents/ondemandscanning.v1.json
@@ -344,7 +344,7 @@
 }
 }
 },
-"revision": "20260925",
+"revision": "20261009",
 "rootUrl": "https://ondemandscanning.googleapis.com/",
 "schemas": {
 "AISkillAnalysisOccurrence": {
@@ -2011,10 +2011,32 @@
 },
 "type": "object"
 },
+"LayerAttribute": {
+"description": "An attribute attached to a layer by a plugin.",
+"id": "LayerAttribute",
+"properties": {
+"plugin": {
+"description": "The name of the plugin that generated this attribute.",
+"type": "string"
+},
+"value": {
+"description": "The value of the attribute, with a meaning defined by the plugin.",
+"type": "string"
+}
+},
+"type": "object"
+},
 "LayerDetails": {
 "description": "Details about the layer a package was found in.",
 "id": "LayerDetails",
 "properties": {
+"attributes": {
+"description": "Attributes attached to this layer by plugins.",
+"items": {
+"$ref": "LayerAttribute"
+},
+"type": "array"
+},
 "baseImages": {
 "description": "The base images the layer is found within.",
 "items": {
diff --git a/googleapiclient/discovery_cache/documents/ondemandscanning.v1beta1.json b/googleapiclient/discovery_cache/documents/ondemandscanning.v1beta1.json
index 7eac86a5fd..7139447387 100644
--- a/googleapiclient/discovery_cache/documents/ondemandscanning.v1beta1.json
+++ b/googleapiclient/discovery_cache/documents/ondemandscanning.v1beta1.json
@@ -344,7 +344,7 @@
 }
 }
 },
-"revision": "20260925",
+"revision": "20261009",
 "rootUrl": "https://ondemandscanning.googleapis.com/",
 "schemas": {
 "AISkillAnalysisOccurrence": {
@@ -2006,10 +2006,32 @@
 },
 "type": "object"
 },
+"LayerAttribute": {
+"description": "An attribute attached to a layer by a plugin.",
+"id": "LayerAttribute",
+"properties": {
+"plugin": {
+"description": "The name of the plugin that generated this attribute.",
+"type": "string"
+},
+"value": {
+"description": "The value of the attribute, with a meaning defined by the plugin.",
+"type": "string"
+}
+},
+"type": "object"
+},
 "LayerDetails": {
 "description": "Details about the layer a package was found in.",
 "id": "LayerDetails",
 "properties": {
+"attributes": {
+"description": "Attributes attached to this layer by plugins.",
+"items": {
+"$ref": "LayerAttribute"
+},
+"type": "array"
+},
 "baseImages": {
 "description": "The base images the layer is found within.",
 "items": {

From 039b8b37a1af4cb3645996a4599adf0bd53441d6 Mon Sep 17 00:00:00 2001
From: Yoshi Automation 
Date: Tue, 20 Oct 2026 07:24:02 +0000
Subject: [PATCH 28/34] feat(oracledatabase): update the api

#### oracledatabase:v1

The following keys were added:
- resources.projects.resources.locations.resources.cloudExadataInfrastructures.methods.patch (Total Keys: 17)
- resources.projects.resources.locations.resources.cloudVmClusters.methods.patch (Total Keys: 17)
- resources.projects.resources.locations.resources.dbSystems.methods.patch (Total Keys: 17)
- resources.projects.resources.locations.resources.exascaleDbStorageVaults.methods.patch (Total Keys: 17)
- resources.projects.resources.locations.resources.goldengateConnectionAssignments.methods.patch (Total Keys: 17)
- resources.projects.resources.locations.resources.goldengateConnections.methods.patch (Total Keys: 17)
- resources.projects.resources.locations.resources.goldengateDeployments.methods.patch (Total Keys: 17)
- resources.projects.resources.locations.resources.odbNetworks.resources.odbSubnets.methods.patch (Total Keys: 17)
---
 ...rojects.locations.autonomousDatabases.html |  16 +-
 ...locations.cloudExadataInfrastructures.html | 132 ++++-
 ...v1.projects.locations.cloudVmClusters.html | 176 +++++--
 ...abase_v1.projects.locations.databases.html |  16 +-
 ...abase_v1.projects.locations.dbSystems.html | 188 ++++++-
 ...cts.locations.exascaleDbStorageVaults.html | 104 +++-
 ...tions.goldengateConnectionAssignments.html |  72 ++-
 ...jects.locations.goldengateConnections.html | 464 +++++++++++++++++-
 ...jects.locations.goldengateDeployments.html | 195 +++++++-
 ...ects.locations.odbNetworks.odbSubnets.html |  66 ++-
 .../documents/oracledatabase.v1.json          | 410 ++++++++++++++--
 11 files changed, 1656 insertions(+), 183 deletions(-)

diff --git a/docs/dyn/oracledatabase_v1.projects.locations.autonomousDatabases.html b/docs/dyn/oracledatabase_v1.projects.locations.autonomousDatabases.html
index b0352f93d5..959e82175d 100644
--- a/docs/dyn/oracledatabase_v1.projects.locations.autonomousDatabases.html
+++ b/docs/dyn/oracledatabase_v1.projects.locations.autonomousDatabases.html
@@ -138,8 +138,8 @@ 
Method Details

     The object takes the form of:
 
 { # Details of the Autonomous Database resource. https://docs.oracle.com/en-us/iaas/api/#/en/database/20160918/AutonomousDatabase/
-  "adminPassword": "A String", # Optional. Immutable. The password for the default ADMIN user. Note: Only one of `admin_password_secret_version` or `admin_password` can be populated.
-  "adminPasswordSecretVersion": "A String", # Optional. Immutable. The resource name of a secret version in Secret Manager which contains the database admin user's password. Format: projects/{project}/secrets/{secret}/versions/{version}. Note: Only one of `admin_password_secret_version` or `admin_password` can be populated.
+  "adminPassword": "A String", # Optional. Input only. Immutable. The password for the default ADMIN user. Note: Only one of `admin_password_secret_version` or `admin_password` can be populated.
+  "adminPasswordSecretVersion": "A String", # Optional. Input only. Immutable. The resource name of a secret version in Secret Manager which contains the database admin user's password. Format: projects/{project}/secrets/{secret}/versions/{version}. Note: Only one of `admin_password_secret_version` or `admin_password` can be populated.
   "cidr": "A String", # Optional. Immutable. The subnet CIDR range for the Autonomous Database.
   "createTime": "A String", # Output only. The date and time that the Autonomous Database was created.
   "database": "A String", # Optional. Immutable. The name of the Autonomous Database. The database name must be unique in the project. The name must begin with a letter and can contain a maximum of 30 alphanumeric characters.
@@ -473,8 +473,8 @@ 
Method Details

   An object of the form:
 
     { # Details of the Autonomous Database resource. https://docs.oracle.com/en-us/iaas/api/#/en/database/20160918/AutonomousDatabase/
-  "adminPassword": "A String", # Optional. Immutable. The password for the default ADMIN user. Note: Only one of `admin_password_secret_version` or `admin_password` can be populated.
-  "adminPasswordSecretVersion": "A String", # Optional. Immutable. The resource name of a secret version in Secret Manager which contains the database admin user's password. Format: projects/{project}/secrets/{secret}/versions/{version}. Note: Only one of `admin_password_secret_version` or `admin_password` can be populated.
+  "adminPassword": "A String", # Optional. Input only. Immutable. The password for the default ADMIN user. Note: Only one of `admin_password_secret_version` or `admin_password` can be populated.
+  "adminPasswordSecretVersion": "A String", # Optional. Input only. Immutable. The resource name of a secret version in Secret Manager which contains the database admin user's password. Format: projects/{project}/secrets/{secret}/versions/{version}. Note: Only one of `admin_password_secret_version` or `admin_password` can be populated.
   "cidr": "A String", # Optional. Immutable. The subnet CIDR range for the Autonomous Database.
   "createTime": "A String", # Output only. The date and time that the Autonomous Database was created.
   "database": "A String", # Optional. Immutable. The name of the Autonomous Database. The database name must be unique in the project. The name must begin with a letter and can contain a maximum of 30 alphanumeric characters.
@@ -702,8 +702,8 @@ 
Method Details

     { # The response for `AutonomousDatabase.List`.
   "autonomousDatabases": [ # The list of Autonomous Databases.
     { # Details of the Autonomous Database resource. https://docs.oracle.com/en-us/iaas/api/#/en/database/20160918/AutonomousDatabase/
-      "adminPassword": "A String", # Optional. Immutable. The password for the default ADMIN user. Note: Only one of `admin_password_secret_version` or `admin_password` can be populated.
-      "adminPasswordSecretVersion": "A String", # Optional. Immutable. The resource name of a secret version in Secret Manager which contains the database admin user's password. Format: projects/{project}/secrets/{secret}/versions/{version}. Note: Only one of `admin_password_secret_version` or `admin_password` can be populated.
+      "adminPassword": "A String", # Optional. Input only. Immutable. The password for the default ADMIN user. Note: Only one of `admin_password_secret_version` or `admin_password` can be populated.
+      "adminPasswordSecretVersion": "A String", # Optional. Input only. Immutable. The resource name of a secret version in Secret Manager which contains the database admin user's password. Format: projects/{project}/secrets/{secret}/versions/{version}. Note: Only one of `admin_password_secret_version` or `admin_password` can be populated.
       "cidr": "A String", # Optional. Immutable. The subnet CIDR range for the Autonomous Database.
       "createTime": "A String", # Output only. The date and time that the Autonomous Database was created.
       "database": "A String", # Optional. Immutable. The name of the Autonomous Database. The database name must be unique in the project. The name must begin with a letter and can contain a maximum of 30 alphanumeric characters.
@@ -916,8 +916,8 @@ 
Method Details

     The object takes the form of:
 
 { # Details of the Autonomous Database resource. https://docs.oracle.com/en-us/iaas/api/#/en/database/20160918/AutonomousDatabase/
-  "adminPassword": "A String", # Optional. Immutable. The password for the default ADMIN user. Note: Only one of `admin_password_secret_version` or `admin_password` can be populated.
-  "adminPasswordSecretVersion": "A String", # Optional. Immutable. The resource name of a secret version in Secret Manager which contains the database admin user's password. Format: projects/{project}/secrets/{secret}/versions/{version}. Note: Only one of `admin_password_secret_version` or `admin_password` can be populated.
+  "adminPassword": "A String", # Optional. Input only. Immutable. The password for the default ADMIN user. Note: Only one of `admin_password_secret_version` or `admin_password` can be populated.
+  "adminPasswordSecretVersion": "A String", # Optional. Input only. Immutable. The resource name of a secret version in Secret Manager which contains the database admin user's password. Format: projects/{project}/secrets/{secret}/versions/{version}. Note: Only one of `admin_password_secret_version` or `admin_password` can be populated.
   "cidr": "A String", # Optional. Immutable. The subnet CIDR range for the Autonomous Database.
   "createTime": "A String", # Output only. The date and time that the Autonomous Database was created.
   "database": "A String", # Optional. Immutable. The name of the Autonomous Database. The database name must be unique in the project. The name must begin with a letter and can contain a maximum of 30 alphanumeric characters.
diff --git a/docs/dyn/oracledatabase_v1.projects.locations.cloudExadataInfrastructures.html b/docs/dyn/oracledatabase_v1.projects.locations.cloudExadataInfrastructures.html
index cb72b0bf4e..e388f9a291 100644
--- a/docs/dyn/oracledatabase_v1.projects.locations.cloudExadataInfrastructures.html
+++ b/docs/dyn/oracledatabase_v1.projects.locations.cloudExadataInfrastructures.html
@@ -100,6 +100,9 @@ 
Instance Methods

 

   list_next(previous_request, previous_response)

 
Retrieves the next page of results.

+

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

+
Updates the parameters of a single Exadata Infrastructure.

 
Method Details

 

     close()
@@ -161,14 +164,14 @@ 
Method Details

 
 { # Represents CloudExadataInfrastructure resource. https://docs.oracle.com/en-us/iaas/api/#/en/database/20160918/CloudExadataInfrastructure/
   "createTime": "A String", # Output only. The date and time that the Exadata Infrastructure was created.
-  "displayName": "A String", # Optional. User friendly name for this resource.
+  "displayName": "A String", # Optional. Immutable. User friendly name for this resource.
   "entitlementId": "A String", # Output only. Entitlement ID of the private offer against which this infrastructure resource is provisioned.
-  "gcpOracleZone": "A String", # Optional. The GCP Oracle zone where Oracle Exadata Infrastructure is hosted. Example: us-east4-b-r2. If not specified, the system will pick a zone based on availability.
+  "gcpOracleZone": "A String", # Optional. Immutable. The GCP Oracle zone where Oracle Exadata Infrastructure is hosted. Example: us-east4-b-r2. If not specified, the system will pick a zone based on availability.
   "labels": { # Optional. Labels or tags associated with the resource.
     "a_key": "A String",
   },
   "name": "A String", # Identifier. The name of the Exadata Infrastructure resource with the format: projects/{project}/locations/{region}/cloudExadataInfrastructures/{cloud_exadata_infrastructure}
-  "properties": { # Various properties of Exadata Infrastructure. # Optional. Various properties of the infra.
+  "properties": { # Various properties of Exadata Infrastructure. # Optional. Immutable. Various properties of the infra.
     "activatedStorageCount": 42, # Output only. The requested number of additional storage servers activated for the Exadata Infrastructure.
     "additionalStorageCount": 42, # Output only. The requested number of additional storage servers for the Exadata Infrastructure.
     "availableStorageSizeGb": 42, # Output only. The available storage can be allocated to the Exadata Infrastructure resource, in gigabytes (GB).
@@ -314,14 +317,14 @@ 
Method Details

 
     { # Represents CloudExadataInfrastructure resource. https://docs.oracle.com/en-us/iaas/api/#/en/database/20160918/CloudExadataInfrastructure/
   "createTime": "A String", # Output only. The date and time that the Exadata Infrastructure was created.
-  "displayName": "A String", # Optional. User friendly name for this resource.
+  "displayName": "A String", # Optional. Immutable. User friendly name for this resource.
   "entitlementId": "A String", # Output only. Entitlement ID of the private offer against which this infrastructure resource is provisioned.
-  "gcpOracleZone": "A String", # Optional. The GCP Oracle zone where Oracle Exadata Infrastructure is hosted. Example: us-east4-b-r2. If not specified, the system will pick a zone based on availability.
+  "gcpOracleZone": "A String", # Optional. Immutable. The GCP Oracle zone where Oracle Exadata Infrastructure is hosted. Example: us-east4-b-r2. If not specified, the system will pick a zone based on availability.
   "labels": { # Optional. Labels or tags associated with the resource.
     "a_key": "A String",
   },
   "name": "A String", # Identifier. The name of the Exadata Infrastructure resource with the format: projects/{project}/locations/{region}/cloudExadataInfrastructures/{cloud_exadata_infrastructure}
-  "properties": { # Various properties of Exadata Infrastructure. # Optional. Various properties of the infra.
+  "properties": { # Various properties of Exadata Infrastructure. # Optional. Immutable. Various properties of the infra.
     "activatedStorageCount": 42, # Output only. The requested number of additional storage servers activated for the Exadata Infrastructure.
     "additionalStorageCount": 42, # Output only. The requested number of additional storage servers for the Exadata Infrastructure.
     "availableStorageSizeGb": 42, # Output only. The available storage can be allocated to the Exadata Infrastructure resource, in gigabytes (GB).
@@ -406,14 +409,14 @@ 
Method Details

   "cloudExadataInfrastructures": [ # The list of Exadata Infrastructures.
     { # Represents CloudExadataInfrastructure resource. https://docs.oracle.com/en-us/iaas/api/#/en/database/20160918/CloudExadataInfrastructure/
       "createTime": "A String", # Output only. The date and time that the Exadata Infrastructure was created.
-      "displayName": "A String", # Optional. User friendly name for this resource.
+      "displayName": "A String", # Optional. Immutable. User friendly name for this resource.
       "entitlementId": "A String", # Output only. Entitlement ID of the private offer against which this infrastructure resource is provisioned.
-      "gcpOracleZone": "A String", # Optional. The GCP Oracle zone where Oracle Exadata Infrastructure is hosted. Example: us-east4-b-r2. If not specified, the system will pick a zone based on availability.
+      "gcpOracleZone": "A String", # Optional. Immutable. The GCP Oracle zone where Oracle Exadata Infrastructure is hosted. Example: us-east4-b-r2. If not specified, the system will pick a zone based on availability.
       "labels": { # Optional. Labels or tags associated with the resource.
         "a_key": "A String",
       },
       "name": "A String", # Identifier. The name of the Exadata Infrastructure resource with the format: projects/{project}/locations/{region}/cloudExadataInfrastructures/{cloud_exadata_infrastructure}
-      "properties": { # Various properties of Exadata Infrastructure. # Optional. Various properties of the infra.
+      "properties": { # Various properties of Exadata Infrastructure. # Optional. Immutable. Various properties of the infra.
         "activatedStorageCount": 42, # Output only. The requested number of additional storage servers activated for the Exadata Infrastructure.
         "additionalStorageCount": 42, # Output only. The requested number of additional storage servers for the Exadata Infrastructure.
         "availableStorageSizeGb": 42, # Output only. The available storage can be allocated to the Exadata Infrastructure resource, in gigabytes (GB).
@@ -496,4 +499,115 @@ 
Method Details
+
+ patch(name, body=None, requestId=None, updateMask=None, x__xgafv=None) + 
Updates the parameters of a single Exadata Infrastructure.
+
+Args:
+  name: string, Identifier. The name of the Exadata Infrastructure resource with the format: projects/{project}/locations/{region}/cloudExadataInfrastructures/{cloud_exadata_infrastructure} (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # Represents CloudExadataInfrastructure resource. https://docs.oracle.com/en-us/iaas/api/#/en/database/20160918/CloudExadataInfrastructure/
+  "createTime": "A String", # Output only. The date and time that the Exadata Infrastructure was created.
+  "displayName": "A String", # Optional. Immutable. User friendly name for this resource.
+  "entitlementId": "A String", # Output only. Entitlement ID of the private offer against which this infrastructure resource is provisioned.
+  "gcpOracleZone": "A String", # Optional. Immutable. The GCP Oracle zone where Oracle Exadata Infrastructure is hosted. Example: us-east4-b-r2. If not specified, the system will pick a zone based on availability.
+  "labels": { # Optional. Labels or tags associated with the resource.
+    "a_key": "A String",
+  },
+  "name": "A String", # Identifier. The name of the Exadata Infrastructure resource with the format: projects/{project}/locations/{region}/cloudExadataInfrastructures/{cloud_exadata_infrastructure}
+  "properties": { # Various properties of Exadata Infrastructure. # Optional. Immutable. Various properties of the infra.
+    "activatedStorageCount": 42, # Output only. The requested number of additional storage servers activated for the Exadata Infrastructure.
+    "additionalStorageCount": 42, # Output only. The requested number of additional storage servers for the Exadata Infrastructure.
+    "availableStorageSizeGb": 42, # Output only. The available storage can be allocated to the Exadata Infrastructure resource, in gigabytes (GB).
+    "computeCount": 42, # Optional. The number of compute servers for the Exadata Infrastructure.
+    "computeModel": "A String", # Output only. The compute model of the Exadata Infrastructure.
+    "cpuCount": 42, # Output only. The number of enabled CPU cores.
+    "customerContacts": [ # Optional. The list of customer contacts.
+      { # The CustomerContact reference as defined by Oracle. https://docs.oracle.com/en-us/iaas/api/#/en/database/20160918/datatypes/CustomerContact
+        "email": "A String", # Required. The email address used by Oracle to send notifications regarding databases and infrastructure.
+      },
+    ],
+    "dataStorageSizeTb": 3.14, # Output only. Size, in terabytes, of the DATA disk group.
+    "databaseServerType": "A String", # Optional. The database server type of the Exadata Infrastructure.
+    "dbNodeStorageSizeGb": 42, # Output only. The local node storage allocated in GBs.
+    "dbServerVersion": "A String", # Output only. The software version of the database servers (dom0) in the Exadata Infrastructure.
+    "exascaleConfig": { # Details of the Exascale configuration for the Exadata Infrastructure. # Output only. The Exascale configuration for the Exadata Infrastructure.
+      "availableStorageSizeGb": 42, # Output only. Available storage size for Exascale in GBs.
+      "availableVmStorageSizeGb": 42, # Output only. Available storage size for VM storage on Exascale in GBs.
+      "totalStorageSizeGb": 42, # Output only. Total storage size needed for Exascale in GBs.
+      "totalVmStorageSizeGb": 42, # Output only. Storage size needed for VM storage on Exascale in GBs.
+    },
+    "maintenanceWindow": { # Maintenance window as defined by Oracle. https://docs.oracle.com/en-us/iaas/api/#/en/database/20160918/datatypes/MaintenanceWindow # Optional. Maintenance window for repair.
+      "customActionTimeoutMins": 42, # Optional. Determines the amount of time the system will wait before the start of each database server patching operation. Custom action timeout is in minutes and valid value is between 15 to 120 (inclusive).
+      "daysOfWeek": [ # Optional. Days during the week when maintenance should be performed.
+        "A String",
+      ],
+      "hoursOfDay": [ # Optional. The window of hours during the day when maintenance should be performed. The window is a 4 hour slot. Valid values are: 0 - represents time slot 0:00 - 3:59 UTC 4 - represents time slot 4:00 - 7:59 UTC 8 - represents time slot 8:00 - 11:59 UTC 12 - represents time slot 12:00 - 15:59 UTC 16 - represents time slot 16:00 - 19:59 UTC 20 - represents time slot 20:00 - 23:59 UTC
+        42,
+      ],
+      "isCustomActionTimeoutEnabled": True or False, # Optional. If true, enables the configuration of a custom action timeout (waiting period) between database server patching operations.
+      "leadTimeWeek": 42, # Optional. Lead time window allows user to set a lead time to prepare for a down time. The lead time is in weeks and valid value is between 1 to 4.
+      "months": [ # Optional. Months during the year when maintenance should be performed.
+        "A String",
+      ],
+      "patchingMode": "A String", # Optional. Cloud CloudExadataInfrastructure node patching method, either "ROLLING" or "NONROLLING". Default value is ROLLING.
+      "preference": "A String", # Optional. The maintenance window scheduling preference.
+      "weeksOfMonth": [ # Optional. Weeks during the month when maintenance should be performed. Weeks start on the 1st, 8th, 15th, and 22nd days of the month, and have a duration of 7 days. Weeks start and end based on calendar dates, not days of the week.
+        42,
+      ],
+    },
+    "maxCpuCount": 42, # Output only. The total number of CPU cores available.
+    "maxDataStorageTb": 3.14, # Output only. The total available DATA disk group size.
+    "maxDbNodeStorageSizeGb": 42, # Output only. The total local node storage available in GBs.
+    "maxMemoryGb": 42, # Output only. The total memory available in GBs.
+    "memorySizeGb": 42, # Output only. The memory allocated in GBs.
+    "monthlyDbServerVersion": "A String", # Output only. The monthly software version of the database servers (dom0) in the Exadata Infrastructure. Example: 20.1.15
+    "monthlyStorageServerVersion": "A String", # Output only. The monthly software version of the storage servers (cells) in the Exadata Infrastructure. Example: 20.1.15
+    "nextMaintenanceRunId": "A String", # Output only. The OCID of the next maintenance run.
+    "nextMaintenanceRunTime": "A String", # Output only. The time when the next maintenance run will occur.
+    "nextSecurityMaintenanceRunTime": "A String", # Output only. The time when the next security maintenance run will occur.
+    "ociUrl": "A String", # Output only. Deep link to the OCI console to view this resource.
+    "ocid": "A String", # Output only. OCID of created infra. https://docs.oracle.com/en-us/iaas/Content/General/Concepts/identifiers.htm#Oracle
+    "shape": "A String", # Required. The shape of the Exadata Infrastructure. The shape determines the amount of CPU, storage, and memory resources allocated to the instance.
+    "state": "A String", # Output only. The current lifecycle state of the Exadata Infrastructure.
+    "storageCount": 42, # Optional. The number of Cloud Exadata storage servers for the Exadata Infrastructure.
+    "storageServerType": "A String", # Optional. The storage server type of the Exadata Infrastructure.
+    "storageServerVersion": "A String", # Output only. The software version of the storage servers (cells) in the Exadata Infrastructure.
+    "totalStorageSizeGb": 42, # Optional. The total storage allocated to the Exadata Infrastructure resource, in gigabytes (GB).
+  },
+}
+
+  requestId: string, Optional. An optional ID to identify the request. This value is used to identify duplicate requests. If you make a request with the same request ID and the original request is still in progress or completed, the server 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. Field mask is used to specify the fields to be overwritten in the Exadata resource by the update. The fields specified in the `update_mask` are relative to the resource, not the full request. A field will be overwritten if it is in the mask. If the user does not provide a mask then the service treats this as an implied field mask equivalent to all fields that are populated (have a non-empty value). To clear or unset a field, the field must be explicitly specified in the `update_mask`.
+  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/oracledatabase_v1.projects.locations.cloudVmClusters.html b/docs/dyn/oracledatabase_v1.projects.locations.cloudVmClusters.html index b3643fb8be..d10d4fc048 100644 --- a/docs/dyn/oracledatabase_v1.projects.locations.cloudVmClusters.html +++ b/docs/dyn/oracledatabase_v1.projects.locations.cloudVmClusters.html @@ -97,6 +97,9 @@

Instance Methods

list_next(previous_request, previous_response)

Retrieves the next page of results.

+

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

+

Updates the parameters of a single Vm Cluster.

Method Details

close() @@ -113,13 +116,13 @@

Method Details

The object takes the form of: { # Details of the Cloud VM Cluster resource. https://docs.oracle.com/en-us/iaas/api/#/en/database/20160918/CloudVmCluster/ - "backupOdbSubnet": "A String", # Optional. The name of the backup OdbSubnet associated with the VM Cluster. Format: projects/{project}/locations/{location}/odbNetworks/{odb_network}/odbSubnets/{odb_subnet} - "backupSubnetCidr": "A String", # Optional. CIDR range of the backup subnet. - "cidr": "A String", # Optional. Network settings. CIDR to use for cluster IP allocation. + "backupOdbSubnet": "A String", # Optional. Immutable. The name of the backup OdbSubnet associated with the VM Cluster. Format: projects/{project}/locations/{location}/odbNetworks/{odb_network}/odbSubnets/{odb_subnet} + "backupSubnetCidr": "A String", # Optional. Immutable. CIDR range of the backup subnet. + "cidr": "A String", # Optional. Immutable. Network settings. CIDR to use for cluster IP allocation. "createTime": "A String", # Output only. The date and time that the VM cluster was created. - "displayName": "A String", # Optional. User friendly name for this resource. - "exadataInfrastructure": "A String", # Required. The name of the Exadata Infrastructure resource on which VM cluster resource is created, in the following format: projects/{project}/locations/{region}/cloudExadataInfrastuctures/{cloud_extradata_infrastructure} - "exascaleDbStorageVault": "A String", # Optional. The name of ExascaleDbStorageVault associated with the VM Cluster. Format: projects/{project}/locations/{location}/exascaleDbStorageVaults/{exascale_db_storage_vault} + "displayName": "A String", # Optional. Immutable. User friendly name for this resource. + "exadataInfrastructure": "A String", # Required. Immutable. The name of the Exadata Infrastructure resource on which VM cluster resource is created, in the following format: projects/{project}/locations/{region}/cloudExadataInfrastuctures/{cloud_extradata_infrastructure} + "exascaleDbStorageVault": "A String", # Optional. Immutable. The name of ExascaleDbStorageVault associated with the VM Cluster. Format: projects/{project}/locations/{location}/exascaleDbStorageVaults/{exascale_db_storage_vault} "gcpOracleZone": "A String", # Output only. The GCP Oracle zone where Oracle CloudVmCluster is hosted. This will be the same as the gcp_oracle_zone of the CloudExadataInfrastructure. Example: us-east4-b-r2. "identityConnector": { # The identity connector details which will allow OCI to securely access the resources in the customer project. # Output only. The identity connector details which will allow OCI to securely access the resources in the customer project. "connectionState": "A String", # Output only. The connection state of the identity connector. @@ -129,10 +132,10 @@

Method Details

"a_key": "A String", }, "name": "A String", # Identifier. The name of the VM Cluster resource with the format: projects/{project}/locations/{region}/cloudVmClusters/{cloud_vm_cluster} - "network": "A String", # Optional. The name of the VPC network. Format: projects/{project}/global/networks/{network} - "odbNetwork": "A String", # Optional. The name of the OdbNetwork associated with the VM Cluster. Format: projects/{project}/locations/{location}/odbNetworks/{odb_network} It is optional but if specified, this should match the parent ODBNetwork of the odb_subnet and backup_odb_subnet. - "odbSubnet": "A String", # Optional. The name of the OdbSubnet associated with the VM Cluster for IP allocation. Format: projects/{project}/locations/{location}/odbNetworks/{odb_network}/odbSubnets/{odb_subnet} - "properties": { # Various properties and settings associated with Exadata VM cluster. # Optional. Various properties of the VM Cluster. + "network": "A String", # Optional. Immutable. The name of the VPC network. Format: projects/{project}/global/networks/{network} + "odbNetwork": "A String", # Optional. Immutable. The name of the OdbNetwork associated with the VM Cluster. Format: projects/{project}/locations/{location}/odbNetworks/{odb_network} It is optional but if specified, this should match the parent ODBNetwork of the odb_subnet and backup_odb_subnet. + "odbSubnet": "A String", # Optional. Immutable. The name of the OdbSubnet associated with the VM Cluster for IP allocation. Format: projects/{project}/locations/{location}/odbNetworks/{odb_network}/odbSubnets/{odb_subnet} + "properties": { # Various properties and settings associated with Exadata VM cluster. # Optional. Immutable. Various properties of the VM Cluster. "clusterName": "A String", # Optional. OCI Cluster name. "compartmentId": "A String", # Output only. Compartment ID of cluster. "computeModel": "A String", # Output only. The compute model of the VM Cluster. @@ -268,13 +271,13 @@

Method Details

An object of the form: { # Details of the Cloud VM Cluster resource. https://docs.oracle.com/en-us/iaas/api/#/en/database/20160918/CloudVmCluster/ - "backupOdbSubnet": "A String", # Optional. The name of the backup OdbSubnet associated with the VM Cluster. Format: projects/{project}/locations/{location}/odbNetworks/{odb_network}/odbSubnets/{odb_subnet} - "backupSubnetCidr": "A String", # Optional. CIDR range of the backup subnet. - "cidr": "A String", # Optional. Network settings. CIDR to use for cluster IP allocation. + "backupOdbSubnet": "A String", # Optional. Immutable. The name of the backup OdbSubnet associated with the VM Cluster. Format: projects/{project}/locations/{location}/odbNetworks/{odb_network}/odbSubnets/{odb_subnet} + "backupSubnetCidr": "A String", # Optional. Immutable. CIDR range of the backup subnet. + "cidr": "A String", # Optional. Immutable. Network settings. CIDR to use for cluster IP allocation. "createTime": "A String", # Output only. The date and time that the VM cluster was created. - "displayName": "A String", # Optional. User friendly name for this resource. - "exadataInfrastructure": "A String", # Required. The name of the Exadata Infrastructure resource on which VM cluster resource is created, in the following format: projects/{project}/locations/{region}/cloudExadataInfrastuctures/{cloud_extradata_infrastructure} - "exascaleDbStorageVault": "A String", # Optional. The name of ExascaleDbStorageVault associated with the VM Cluster. Format: projects/{project}/locations/{location}/exascaleDbStorageVaults/{exascale_db_storage_vault} + "displayName": "A String", # Optional. Immutable. User friendly name for this resource. + "exadataInfrastructure": "A String", # Required. Immutable. The name of the Exadata Infrastructure resource on which VM cluster resource is created, in the following format: projects/{project}/locations/{region}/cloudExadataInfrastuctures/{cloud_extradata_infrastructure} + "exascaleDbStorageVault": "A String", # Optional. Immutable. The name of ExascaleDbStorageVault associated with the VM Cluster. Format: projects/{project}/locations/{location}/exascaleDbStorageVaults/{exascale_db_storage_vault} "gcpOracleZone": "A String", # Output only. The GCP Oracle zone where Oracle CloudVmCluster is hosted. This will be the same as the gcp_oracle_zone of the CloudExadataInfrastructure. Example: us-east4-b-r2. "identityConnector": { # The identity connector details which will allow OCI to securely access the resources in the customer project. # Output only. The identity connector details which will allow OCI to securely access the resources in the customer project. "connectionState": "A String", # Output only. The connection state of the identity connector. @@ -284,10 +287,10 @@

Method Details

"a_key": "A String", }, "name": "A String", # Identifier. The name of the VM Cluster resource with the format: projects/{project}/locations/{region}/cloudVmClusters/{cloud_vm_cluster} - "network": "A String", # Optional. The name of the VPC network. Format: projects/{project}/global/networks/{network} - "odbNetwork": "A String", # Optional. The name of the OdbNetwork associated with the VM Cluster. Format: projects/{project}/locations/{location}/odbNetworks/{odb_network} It is optional but if specified, this should match the parent ODBNetwork of the odb_subnet and backup_odb_subnet. - "odbSubnet": "A String", # Optional. The name of the OdbSubnet associated with the VM Cluster for IP allocation. Format: projects/{project}/locations/{location}/odbNetworks/{odb_network}/odbSubnets/{odb_subnet} - "properties": { # Various properties and settings associated with Exadata VM cluster. # Optional. Various properties of the VM Cluster. + "network": "A String", # Optional. Immutable. The name of the VPC network. Format: projects/{project}/global/networks/{network} + "odbNetwork": "A String", # Optional. Immutable. The name of the OdbNetwork associated with the VM Cluster. Format: projects/{project}/locations/{location}/odbNetworks/{odb_network} It is optional but if specified, this should match the parent ODBNetwork of the odb_subnet and backup_odb_subnet. + "odbSubnet": "A String", # Optional. Immutable. The name of the OdbSubnet associated with the VM Cluster for IP allocation. Format: projects/{project}/locations/{location}/odbNetworks/{odb_network}/odbSubnets/{odb_subnet} + "properties": { # Various properties and settings associated with Exadata VM cluster. # Optional. Immutable. Various properties of the VM Cluster. "clusterName": "A String", # Optional. OCI Cluster name. "compartmentId": "A String", # Output only. Compartment ID of cluster. "computeModel": "A String", # Output only. The compute model of the VM Cluster. @@ -361,13 +364,13 @@

Method Details

{ # The response for `CloudVmCluster.List`. "cloudVmClusters": [ # The list of VM Clusters. { # Details of the Cloud VM Cluster resource. https://docs.oracle.com/en-us/iaas/api/#/en/database/20160918/CloudVmCluster/ - "backupOdbSubnet": "A String", # Optional. The name of the backup OdbSubnet associated with the VM Cluster. Format: projects/{project}/locations/{location}/odbNetworks/{odb_network}/odbSubnets/{odb_subnet} - "backupSubnetCidr": "A String", # Optional. CIDR range of the backup subnet. - "cidr": "A String", # Optional. Network settings. CIDR to use for cluster IP allocation. + "backupOdbSubnet": "A String", # Optional. Immutable. The name of the backup OdbSubnet associated with the VM Cluster. Format: projects/{project}/locations/{location}/odbNetworks/{odb_network}/odbSubnets/{odb_subnet} + "backupSubnetCidr": "A String", # Optional. Immutable. CIDR range of the backup subnet. + "cidr": "A String", # Optional. Immutable. Network settings. CIDR to use for cluster IP allocation. "createTime": "A String", # Output only. The date and time that the VM cluster was created. - "displayName": "A String", # Optional. User friendly name for this resource. - "exadataInfrastructure": "A String", # Required. The name of the Exadata Infrastructure resource on which VM cluster resource is created, in the following format: projects/{project}/locations/{region}/cloudExadataInfrastuctures/{cloud_extradata_infrastructure} - "exascaleDbStorageVault": "A String", # Optional. The name of ExascaleDbStorageVault associated with the VM Cluster. Format: projects/{project}/locations/{location}/exascaleDbStorageVaults/{exascale_db_storage_vault} + "displayName": "A String", # Optional. Immutable. User friendly name for this resource. + "exadataInfrastructure": "A String", # Required. Immutable. The name of the Exadata Infrastructure resource on which VM cluster resource is created, in the following format: projects/{project}/locations/{region}/cloudExadataInfrastuctures/{cloud_extradata_infrastructure} + "exascaleDbStorageVault": "A String", # Optional. Immutable. The name of ExascaleDbStorageVault associated with the VM Cluster. Format: projects/{project}/locations/{location}/exascaleDbStorageVaults/{exascale_db_storage_vault} "gcpOracleZone": "A String", # Output only. The GCP Oracle zone where Oracle CloudVmCluster is hosted. This will be the same as the gcp_oracle_zone of the CloudExadataInfrastructure. Example: us-east4-b-r2. "identityConnector": { # The identity connector details which will allow OCI to securely access the resources in the customer project. # Output only. The identity connector details which will allow OCI to securely access the resources in the customer project. "connectionState": "A String", # Output only. The connection state of the identity connector. @@ -377,10 +380,10 @@

Method Details

"a_key": "A String", }, "name": "A String", # Identifier. The name of the VM Cluster resource with the format: projects/{project}/locations/{region}/cloudVmClusters/{cloud_vm_cluster} - "network": "A String", # Optional. The name of the VPC network. Format: projects/{project}/global/networks/{network} - "odbNetwork": "A String", # Optional. The name of the OdbNetwork associated with the VM Cluster. Format: projects/{project}/locations/{location}/odbNetworks/{odb_network} It is optional but if specified, this should match the parent ODBNetwork of the odb_subnet and backup_odb_subnet. - "odbSubnet": "A String", # Optional. The name of the OdbSubnet associated with the VM Cluster for IP allocation. Format: projects/{project}/locations/{location}/odbNetworks/{odb_network}/odbSubnets/{odb_subnet} - "properties": { # Various properties and settings associated with Exadata VM cluster. # Optional. Various properties of the VM Cluster. + "network": "A String", # Optional. Immutable. The name of the VPC network. Format: projects/{project}/global/networks/{network} + "odbNetwork": "A String", # Optional. Immutable. The name of the OdbNetwork associated with the VM Cluster. Format: projects/{project}/locations/{location}/odbNetworks/{odb_network} It is optional but if specified, this should match the parent ODBNetwork of the odb_subnet and backup_odb_subnet. + "odbSubnet": "A String", # Optional. Immutable. The name of the OdbSubnet associated with the VM Cluster for IP allocation. Format: projects/{project}/locations/{location}/odbNetworks/{odb_network}/odbSubnets/{odb_subnet} + "properties": { # Various properties and settings associated with Exadata VM cluster. # Optional. Immutable. Various properties of the VM Cluster. "clusterName": "A String", # Optional. OCI Cluster name. "compartmentId": "A String", # Output only. Compartment ID of cluster. "computeModel": "A String", # Output only. The compute model of the VM Cluster. @@ -454,4 +457,117 @@

Method Details

+
+ patch(name, body=None, requestId=None, updateMask=None, x__xgafv=None) + 
Updates the parameters of a single Vm Cluster.
+
+Args:
+  name: string, Identifier. The name of the VM Cluster resource with the format: projects/{project}/locations/{region}/cloudVmClusters/{cloud_vm_cluster} (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # Details of the Cloud VM Cluster resource. https://docs.oracle.com/en-us/iaas/api/#/en/database/20160918/CloudVmCluster/
+  "backupOdbSubnet": "A String", # Optional. Immutable. The name of the backup OdbSubnet associated with the VM Cluster. Format: projects/{project}/locations/{location}/odbNetworks/{odb_network}/odbSubnets/{odb_subnet}
+  "backupSubnetCidr": "A String", # Optional. Immutable. CIDR range of the backup subnet.
+  "cidr": "A String", # Optional. Immutable. Network settings. CIDR to use for cluster IP allocation.
+  "createTime": "A String", # Output only. The date and time that the VM cluster was created.
+  "displayName": "A String", # Optional. Immutable. User friendly name for this resource.
+  "exadataInfrastructure": "A String", # Required. Immutable. The name of the Exadata Infrastructure resource on which VM cluster resource is created, in the following format: projects/{project}/locations/{region}/cloudExadataInfrastuctures/{cloud_extradata_infrastructure}
+  "exascaleDbStorageVault": "A String", # Optional. Immutable. The name of ExascaleDbStorageVault associated with the VM Cluster. Format: projects/{project}/locations/{location}/exascaleDbStorageVaults/{exascale_db_storage_vault}
+  "gcpOracleZone": "A String", # Output only. The GCP Oracle zone where Oracle CloudVmCluster is hosted. This will be the same as the gcp_oracle_zone of the CloudExadataInfrastructure. Example: us-east4-b-r2.
+  "identityConnector": { # The identity connector details which will allow OCI to securely access the resources in the customer project. # Output only. The identity connector details which will allow OCI to securely access the resources in the customer project.
+    "connectionState": "A String", # Output only. The connection state of the identity connector.
+    "serviceAgentEmail": "A String", # Output only. A google managed service account on which customers can grant roles to access resources in the customer project. Example: `p176944527254-55-75119d87fd8f@gcp-sa-oci.iam.gserviceaccount.com`
+  },
+  "labels": { # Optional. Labels or tags associated with the VM Cluster.
+    "a_key": "A String",
+  },
+  "name": "A String", # Identifier. The name of the VM Cluster resource with the format: projects/{project}/locations/{region}/cloudVmClusters/{cloud_vm_cluster}
+  "network": "A String", # Optional. Immutable. The name of the VPC network. Format: projects/{project}/global/networks/{network}
+  "odbNetwork": "A String", # Optional. Immutable. The name of the OdbNetwork associated with the VM Cluster. Format: projects/{project}/locations/{location}/odbNetworks/{odb_network} It is optional but if specified, this should match the parent ODBNetwork of the odb_subnet and backup_odb_subnet.
+  "odbSubnet": "A String", # Optional. Immutable. The name of the OdbSubnet associated with the VM Cluster for IP allocation. Format: projects/{project}/locations/{location}/odbNetworks/{odb_network}/odbSubnets/{odb_subnet}
+  "properties": { # Various properties and settings associated with Exadata VM cluster. # Optional. Immutable. Various properties of the VM Cluster.
+    "clusterName": "A String", # Optional. OCI Cluster name.
+    "compartmentId": "A String", # Output only. Compartment ID of cluster.
+    "computeModel": "A String", # Output only. The compute model of the VM Cluster.
+    "cpuCoreCount": 42, # Required. Number of enabled CPU cores.
+    "dataStorageSizeTb": 3.14, # Optional. The data disk group size to be allocated in TBs.
+    "dbNodeStorageSizeGb": 42, # Optional. Local storage per VM.
+    "dbServerOcids": [ # Optional. OCID of database servers.
+      "A String",
+    ],
+    "diagnosticsDataCollectionOptions": { # Data collection options for diagnostics. # Optional. Data collection options for diagnostics.
+      "diagnosticsEventsEnabled": True or False, # Optional. Indicates whether diagnostic collection is enabled for the VM cluster
+      "healthMonitoringEnabled": True or False, # Optional. Indicates whether health monitoring is enabled for the VM cluster
+      "incidentLogsEnabled": True or False, # Optional. Indicates whether incident logs and trace collection are enabled for the VM cluster
+    },
+    "diskRedundancy": "A String", # Optional. The type of redundancy.
+    "dnsListenerIp": "A String", # Output only. DNS listener IP.
+    "domain": "A String", # Output only. Parent DNS domain where SCAN DNS and hosts names are qualified. ex: ocispdelegated.ocisp10jvnet.oraclevcn.com
+    "giVersion": "A String", # Optional. Grid Infrastructure Version.
+    "hostname": "A String", # Output only. host name without domain. format: "-" with some suffix. ex: sp2-yi0xq where "sp2" is the hostname_prefix.
+    "hostnamePrefix": "A String", # Optional. Prefix for VM cluster host names.
+    "licenseType": "A String", # Required. License type of VM Cluster.
+    "localBackupEnabled": True or False, # Optional. Use local backup.
+    "memorySizeGb": 42, # Optional. Memory allocated in GBs.
+    "nodeCount": 42, # Optional. Number of database servers.
+    "ociUrl": "A String", # Output only. Deep link to the OCI console to view this resource.
+    "ocid": "A String", # Output only. Oracle Cloud Infrastructure ID of VM Cluster.
+    "ocpuCount": 3.14, # Optional. OCPU count per VM. Minimum is 0.1.
+    "scanDns": "A String", # Output only. SCAN DNS name. ex: sp2-yi0xq-scan.ocispdelegated.ocisp10jvnet.oraclevcn.com
+    "scanDnsRecordId": "A String", # Output only. OCID of scan DNS record.
+    "scanIpIds": [ # Output only. OCIDs of scan IPs.
+      "A String",
+    ],
+    "scanListenerPortTcp": 42, # Optional. SCAN listener port - TCP
+    "scanListenerPortTcpSsl": 42, # Optional. SCAN listener port - TLS
+    "shape": "A String", # Output only. Shape of VM Cluster.
+    "sparseDiskgroupEnabled": True or False, # Optional. Use exadata sparse snapshots.
+    "sshPublicKeys": [ # Optional. SSH public keys to be stored with cluster.
+      "A String",
+    ],
+    "state": "A String", # Output only. State of the cluster.
+    "storageManagementType": "A String", # Output only. The storage management type of the VM Cluster.
+    "storageSizeGb": 42, # Output only. The storage allocation for the disk group, in gigabytes (GB).
+    "systemVersion": "A String", # Optional. Operating system version of the image.
+    "timeZone": { # Represents a time zone from the [IANA Time Zone Database](https://www.iana.org/time-zones). # Optional. Time zone of VM Cluster to set. Defaults to UTC if not specified.
+      "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".
+    },
+    "vmBackupStorageType": "A String", # Optional. Specifies whether VM backups are stored on local DB server storage or Exascale storage.
+    "vmFileSystemStorageType": "A String", # Optional. Specifies whether VM file system storage / VM images are stored on local DB server storage or Exascale storage.
+  },
+}
+
+  requestId: string, Optional. An optional ID to identify the request. This value is used to identify duplicate requests. If you make a request with the same request ID and the original request is still in progress or completed, the server 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. A mask specifying which fields in the VM Cluster should be updated. A field specified in the mask is overwritten. If a mask isn't provided, the service treats this as an implied field mask equivalent to all fields that are populated (have a non-empty value). To clear or unset a field, the field must be explicitly specified in the `update_mask`.
+  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/oracledatabase_v1.projects.locations.databases.html b/docs/dyn/oracledatabase_v1.projects.locations.databases.html index 5f91bed44b..66c27a59ba 100644 --- a/docs/dyn/oracledatabase_v1.projects.locations.databases.html +++ b/docs/dyn/oracledatabase_v1.projects.locations.databases.html @@ -107,8 +107,8 @@

Method Details

An object of the form: { # Details of the Database resource. https://docs.oracle.com/en-us/iaas/api/#/en/database/20160918/Database/ - "adminPassword": "A String", # Optional. The password for the default ADMIN user. Note: Only one of `admin_password_secret_version` or `admin_password` can be populated. - "adminPasswordSecretVersion": "A String", # Optional. The resource name of a secret version in Secret Manager which contains the database admin user's password. Format: projects/{project}/secrets/{secret}/versions/{version}. Note: Only one of `admin_password_secret_version` or `admin_password` can be populated. + "adminPassword": "A String", # Optional. Input only. The password for the default ADMIN user. Note: Only one of `admin_password_secret_version` or `admin_password` can be populated. + "adminPasswordSecretVersion": "A String", # Optional. Input only. The resource name of a secret version in Secret Manager which contains the database admin user's password. Format: projects/{project}/secrets/{secret}/versions/{version}. Note: Only one of `admin_password_secret_version` or `admin_password` can be populated. "characterSet": "A String", # Optional. The character set for the database. The default is AL32UTF8. "createTime": "A String", # Output only. The date and time that the Database was created. "databaseId": "A String", # Optional. The database ID of the Database. @@ -143,8 +143,8 @@

Method Details

"dbVersion": "A String", # Required. The Oracle Database version. "state": "A String", # Output only. State of the Database. }, - "tdeWalletPassword": "A String", # Optional. The TDE wallet password for the database. Note: Only one of `tde_wallet_password_secret_version` or `tde_wallet_password` can be populated. - "tdeWalletPasswordSecretVersion": "A String", # Optional. The resource name of a secret version in Secret Manager which contains the TDE wallet password for the database. Format: projects/{project}/secrets/{secret}/versions/{version}. Note: Only one of `tde_wallet_password_secret_version` or `tde_wallet_password` can be populated. + "tdeWalletPassword": "A String", # Optional. Input only. The TDE wallet password for the database. Note: Only one of `tde_wallet_password_secret_version` or `tde_wallet_password` can be populated. + "tdeWalletPasswordSecretVersion": "A String", # Optional. Input only. The resource name of a secret version in Secret Manager which contains the TDE wallet password for the database. Format: projects/{project}/secrets/{secret}/versions/{version}. Note: Only one of `tde_wallet_password_secret_version` or `tde_wallet_password` can be populated. } @@ -168,8 +168,8 @@

Method Details

{ # The response for `Database.List`. "databases": [ # The list of Databases. { # Details of the Database resource. https://docs.oracle.com/en-us/iaas/api/#/en/database/20160918/Database/ - "adminPassword": "A String", # Optional. The password for the default ADMIN user. Note: Only one of `admin_password_secret_version` or `admin_password` can be populated. - "adminPasswordSecretVersion": "A String", # Optional. The resource name of a secret version in Secret Manager which contains the database admin user's password. Format: projects/{project}/secrets/{secret}/versions/{version}. Note: Only one of `admin_password_secret_version` or `admin_password` can be populated. + "adminPassword": "A String", # Optional. Input only. The password for the default ADMIN user. Note: Only one of `admin_password_secret_version` or `admin_password` can be populated. + "adminPasswordSecretVersion": "A String", # Optional. Input only. The resource name of a secret version in Secret Manager which contains the database admin user's password. Format: projects/{project}/secrets/{secret}/versions/{version}. Note: Only one of `admin_password_secret_version` or `admin_password` can be populated. "characterSet": "A String", # Optional. The character set for the database. The default is AL32UTF8. "createTime": "A String", # Output only. The date and time that the Database was created. "databaseId": "A String", # Optional. The database ID of the Database. @@ -204,8 +204,8 @@

Method Details

"dbVersion": "A String", # Required. The Oracle Database version. "state": "A String", # Output only. State of the Database. }, - "tdeWalletPassword": "A String", # Optional. The TDE wallet password for the database. Note: Only one of `tde_wallet_password_secret_version` or `tde_wallet_password` can be populated. - "tdeWalletPasswordSecretVersion": "A String", # Optional. The resource name of a secret version in Secret Manager which contains the TDE wallet password for the database. Format: projects/{project}/secrets/{secret}/versions/{version}. Note: Only one of `tde_wallet_password_secret_version` or `tde_wallet_password` can be populated. + "tdeWalletPassword": "A String", # Optional. Input only. The TDE wallet password for the database. Note: Only one of `tde_wallet_password_secret_version` or `tde_wallet_password` can be populated. + "tdeWalletPasswordSecretVersion": "A String", # Optional. Input only. The resource name of a secret version in Secret Manager which contains the TDE wallet password for the database. Format: projects/{project}/secrets/{secret}/versions/{version}. Note: Only one of `tde_wallet_password_secret_version` or `tde_wallet_password` can be populated. }, ], "nextPageToken": "A String", # A token identifying a page of results the server should return. diff --git a/docs/dyn/oracledatabase_v1.projects.locations.dbSystems.html b/docs/dyn/oracledatabase_v1.projects.locations.dbSystems.html index 69202ac8a2..b2af229ca7 100644 --- a/docs/dyn/oracledatabase_v1.projects.locations.dbSystems.html +++ b/docs/dyn/oracledatabase_v1.projects.locations.dbSystems.html @@ -92,6 +92,9 @@

Instance Methods

list_next(previous_request, previous_response)

Retrieves the next page of results.

+

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

+

Updates the `labels` of a single DbSystem.

Method Details

close() @@ -109,17 +112,17 @@

Method Details

{ # Details of the DbSystem (BaseDB) resource. https://docs.oracle.com/en-us/iaas/api/#/en/database/20160918/DbSystem/ "createTime": "A String", # Output only. The date and time that the DbSystem was created. - "displayName": "A String", # Required. The display name for the System db. The name does not have to be unique within your project. + "displayName": "A String", # Required. Immutable. The display name for the System db. The name does not have to be unique within your project. "entitlementId": "A String", # Output only. The ID of the subscription entitlement associated with the DbSystem - "gcpOracleZone": "A String", # Optional. The GCP Oracle zone where Oracle DbSystem is hosted. Example: us-east4-b-r2. If not specified, the system will pick a zone based on availability. + "gcpOracleZone": "A String", # Optional. Immutable. The GCP Oracle zone where Oracle DbSystem is hosted. Example: us-east4-b-r2. If not specified, the system will pick a zone based on availability. "labels": { # Optional. The labels or tags associated with the DbSystem. "a_key": "A String", }, "name": "A String", # Identifier. The name of the DbSystem resource in the following format: projects/{project}/locations/{region}/dbSystems/{db_system} "ociUrl": "A String", # Output only. HTTPS link to OCI resources exposed to Customer via UI Interface. - "odbNetwork": "A String", # Optional. The name of the OdbNetwork associated with the DbSystem. Format: projects/{project}/locations/{location}/odbNetworks/{odb_network} It is optional but if specified, this should match the parent ODBNetwork of the OdbSubnet. - "odbSubnet": "A String", # Required. The name of the OdbSubnet associated with the DbSystem for IP allocation. Format: projects/{project}/locations/{location}/odbNetworks/{odb_network}/odbSubnets/{odb_subnet} - "properties": { # The properties of a DbSystem. # Optional. The properties of the DbSystem. + "odbNetwork": "A String", # Optional. Immutable. The name of the OdbNetwork associated with the DbSystem. Format: projects/{project}/locations/{location}/odbNetworks/{odb_network} It is optional but if specified, this should match the parent ODBNetwork of the OdbSubnet. + "odbSubnet": "A String", # Required. Immutable. The name of the OdbSubnet associated with the DbSystem for IP allocation. Format: projects/{project}/locations/{location}/odbNetworks/{odb_network}/odbSubnets/{odb_subnet} + "properties": { # The properties of a DbSystem. # Optional. Immutable. The properties of the DbSystem. "computeCount": 42, # Required. The number of CPU cores to enable for the DbSystem. "computeModel": "A String", # Optional. The compute model of the DbSystem. "dataCollectionOptions": { # Data collection options for DbSystem. # Optional. Data collection options for diagnostics. @@ -130,8 +133,8 @@

Method Details

"databaseEdition": "A String", # Required. The database edition of the DbSystem. "dbHome": { # Details of the Database Home resource. # Optional. Details for creating a Database Home. "database": { # Details of the Database resource. https://docs.oracle.com/en-us/iaas/api/#/en/database/20160918/Database/ # Required. The Database resource. - "adminPassword": "A String", # Optional. The password for the default ADMIN user. Note: Only one of `admin_password_secret_version` or `admin_password` can be populated. - "adminPasswordSecretVersion": "A String", # Optional. The resource name of a secret version in Secret Manager which contains the database admin user's password. Format: projects/{project}/secrets/{secret}/versions/{version}. Note: Only one of `admin_password_secret_version` or `admin_password` can be populated. + "adminPassword": "A String", # Optional. Input only. The password for the default ADMIN user. Note: Only one of `admin_password_secret_version` or `admin_password` can be populated. + "adminPasswordSecretVersion": "A String", # Optional. Input only. The resource name of a secret version in Secret Manager which contains the database admin user's password. Format: projects/{project}/secrets/{secret}/versions/{version}. Note: Only one of `admin_password_secret_version` or `admin_password` can be populated. "characterSet": "A String", # Optional. The character set for the database. The default is AL32UTF8. "createTime": "A String", # Output only. The date and time that the Database was created. "databaseId": "A String", # Optional. The database ID of the Database. @@ -166,8 +169,8 @@

Method Details

"dbVersion": "A String", # Required. The Oracle Database version. "state": "A String", # Output only. State of the Database. }, - "tdeWalletPassword": "A String", # Optional. The TDE wallet password for the database. Note: Only one of `tde_wallet_password_secret_version` or `tde_wallet_password` can be populated. - "tdeWalletPasswordSecretVersion": "A String", # Optional. The resource name of a secret version in Secret Manager which contains the TDE wallet password for the database. Format: projects/{project}/secrets/{secret}/versions/{version}. Note: Only one of `tde_wallet_password_secret_version` or `tde_wallet_password` can be populated. + "tdeWalletPassword": "A String", # Optional. Input only. The TDE wallet password for the database. Note: Only one of `tde_wallet_password_secret_version` or `tde_wallet_password` can be populated. + "tdeWalletPasswordSecretVersion": "A String", # Optional. Input only. The resource name of a secret version in Secret Manager which contains the TDE wallet password for the database. Format: projects/{project}/secrets/{secret}/versions/{version}. Note: Only one of `tde_wallet_password_secret_version` or `tde_wallet_password` can be populated. }, "dbVersion": "A String", # Required. A valid Oracle Database version. For a list of supported versions, use the ListDbVersions operation. "displayName": "A String", # Optional. The display name for the Database Home. The name does not have to be unique within your project. @@ -281,17 +284,17 @@

Method Details

{ # Details of the DbSystem (BaseDB) resource. https://docs.oracle.com/en-us/iaas/api/#/en/database/20160918/DbSystem/ "createTime": "A String", # Output only. The date and time that the DbSystem was created. - "displayName": "A String", # Required. The display name for the System db. The name does not have to be unique within your project. + "displayName": "A String", # Required. Immutable. The display name for the System db. The name does not have to be unique within your project. "entitlementId": "A String", # Output only. The ID of the subscription entitlement associated with the DbSystem - "gcpOracleZone": "A String", # Optional. The GCP Oracle zone where Oracle DbSystem is hosted. Example: us-east4-b-r2. If not specified, the system will pick a zone based on availability. + "gcpOracleZone": "A String", # Optional. Immutable. The GCP Oracle zone where Oracle DbSystem is hosted. Example: us-east4-b-r2. If not specified, the system will pick a zone based on availability. "labels": { # Optional. The labels or tags associated with the DbSystem. "a_key": "A String", }, "name": "A String", # Identifier. The name of the DbSystem resource in the following format: projects/{project}/locations/{region}/dbSystems/{db_system} "ociUrl": "A String", # Output only. HTTPS link to OCI resources exposed to Customer via UI Interface. - "odbNetwork": "A String", # Optional. The name of the OdbNetwork associated with the DbSystem. Format: projects/{project}/locations/{location}/odbNetworks/{odb_network} It is optional but if specified, this should match the parent ODBNetwork of the OdbSubnet. - "odbSubnet": "A String", # Required. The name of the OdbSubnet associated with the DbSystem for IP allocation. Format: projects/{project}/locations/{location}/odbNetworks/{odb_network}/odbSubnets/{odb_subnet} - "properties": { # The properties of a DbSystem. # Optional. The properties of the DbSystem. + "odbNetwork": "A String", # Optional. Immutable. The name of the OdbNetwork associated with the DbSystem. Format: projects/{project}/locations/{location}/odbNetworks/{odb_network} It is optional but if specified, this should match the parent ODBNetwork of the OdbSubnet. + "odbSubnet": "A String", # Required. Immutable. The name of the OdbSubnet associated with the DbSystem for IP allocation. Format: projects/{project}/locations/{location}/odbNetworks/{odb_network}/odbSubnets/{odb_subnet} + "properties": { # The properties of a DbSystem. # Optional. Immutable. The properties of the DbSystem. "computeCount": 42, # Required. The number of CPU cores to enable for the DbSystem. "computeModel": "A String", # Optional. The compute model of the DbSystem. "dataCollectionOptions": { # Data collection options for DbSystem. # Optional. Data collection options for diagnostics. @@ -302,8 +305,8 @@

Method Details

"databaseEdition": "A String", # Required. The database edition of the DbSystem. "dbHome": { # Details of the Database Home resource. # Optional. Details for creating a Database Home. "database": { # Details of the Database resource. https://docs.oracle.com/en-us/iaas/api/#/en/database/20160918/Database/ # Required. The Database resource. - "adminPassword": "A String", # Optional. The password for the default ADMIN user. Note: Only one of `admin_password_secret_version` or `admin_password` can be populated. - "adminPasswordSecretVersion": "A String", # Optional. The resource name of a secret version in Secret Manager which contains the database admin user's password. Format: projects/{project}/secrets/{secret}/versions/{version}. Note: Only one of `admin_password_secret_version` or `admin_password` can be populated. + "adminPassword": "A String", # Optional. Input only. The password for the default ADMIN user. Note: Only one of `admin_password_secret_version` or `admin_password` can be populated. + "adminPasswordSecretVersion": "A String", # Optional. Input only. The resource name of a secret version in Secret Manager which contains the database admin user's password. Format: projects/{project}/secrets/{secret}/versions/{version}. Note: Only one of `admin_password_secret_version` or `admin_password` can be populated. "characterSet": "A String", # Optional. The character set for the database. The default is AL32UTF8. "createTime": "A String", # Output only. The date and time that the Database was created. "databaseId": "A String", # Optional. The database ID of the Database. @@ -338,8 +341,8 @@

Method Details

"dbVersion": "A String", # Required. The Oracle Database version. "state": "A String", # Output only. State of the Database. }, - "tdeWalletPassword": "A String", # Optional. The TDE wallet password for the database. Note: Only one of `tde_wallet_password_secret_version` or `tde_wallet_password` can be populated. - "tdeWalletPasswordSecretVersion": "A String", # Optional. The resource name of a secret version in Secret Manager which contains the TDE wallet password for the database. Format: projects/{project}/secrets/{secret}/versions/{version}. Note: Only one of `tde_wallet_password_secret_version` or `tde_wallet_password` can be populated. + "tdeWalletPassword": "A String", # Optional. Input only. The TDE wallet password for the database. Note: Only one of `tde_wallet_password_secret_version` or `tde_wallet_password` can be populated. + "tdeWalletPasswordSecretVersion": "A String", # Optional. Input only. The resource name of a secret version in Secret Manager which contains the TDE wallet password for the database. Format: projects/{project}/secrets/{secret}/versions/{version}. Note: Only one of `tde_wallet_password_secret_version` or `tde_wallet_password` can be populated. }, "dbVersion": "A String", # Required. A valid Oracle Database version. For a list of supported versions, use the ListDbVersions operation. "displayName": "A String", # Optional. The display name for the Database Home. The name does not have to be unique within your project. @@ -393,17 +396,17 @@

Method Details

"dbSystems": [ # The list of DbSystems. { # Details of the DbSystem (BaseDB) resource. https://docs.oracle.com/en-us/iaas/api/#/en/database/20160918/DbSystem/ "createTime": "A String", # Output only. The date and time that the DbSystem was created. - "displayName": "A String", # Required. The display name for the System db. The name does not have to be unique within your project. + "displayName": "A String", # Required. Immutable. The display name for the System db. The name does not have to be unique within your project. "entitlementId": "A String", # Output only. The ID of the subscription entitlement associated with the DbSystem - "gcpOracleZone": "A String", # Optional. The GCP Oracle zone where Oracle DbSystem is hosted. Example: us-east4-b-r2. If not specified, the system will pick a zone based on availability. + "gcpOracleZone": "A String", # Optional. Immutable. The GCP Oracle zone where Oracle DbSystem is hosted. Example: us-east4-b-r2. If not specified, the system will pick a zone based on availability. "labels": { # Optional. The labels or tags associated with the DbSystem. "a_key": "A String", }, "name": "A String", # Identifier. The name of the DbSystem resource in the following format: projects/{project}/locations/{region}/dbSystems/{db_system} "ociUrl": "A String", # Output only. HTTPS link to OCI resources exposed to Customer via UI Interface. - "odbNetwork": "A String", # Optional. The name of the OdbNetwork associated with the DbSystem. Format: projects/{project}/locations/{location}/odbNetworks/{odb_network} It is optional but if specified, this should match the parent ODBNetwork of the OdbSubnet. - "odbSubnet": "A String", # Required. The name of the OdbSubnet associated with the DbSystem for IP allocation. Format: projects/{project}/locations/{location}/odbNetworks/{odb_network}/odbSubnets/{odb_subnet} - "properties": { # The properties of a DbSystem. # Optional. The properties of the DbSystem. + "odbNetwork": "A String", # Optional. Immutable. The name of the OdbNetwork associated with the DbSystem. Format: projects/{project}/locations/{location}/odbNetworks/{odb_network} It is optional but if specified, this should match the parent ODBNetwork of the OdbSubnet. + "odbSubnet": "A String", # Required. Immutable. The name of the OdbSubnet associated with the DbSystem for IP allocation. Format: projects/{project}/locations/{location}/odbNetworks/{odb_network}/odbSubnets/{odb_subnet} + "properties": { # The properties of a DbSystem. # Optional. Immutable. The properties of the DbSystem. "computeCount": 42, # Required. The number of CPU cores to enable for the DbSystem. "computeModel": "A String", # Optional. The compute model of the DbSystem. "dataCollectionOptions": { # Data collection options for DbSystem. # Optional. Data collection options for diagnostics. @@ -414,8 +417,8 @@

Method Details

"databaseEdition": "A String", # Required. The database edition of the DbSystem. "dbHome": { # Details of the Database Home resource. # Optional. Details for creating a Database Home. "database": { # Details of the Database resource. https://docs.oracle.com/en-us/iaas/api/#/en/database/20160918/Database/ # Required. The Database resource. - "adminPassword": "A String", # Optional. The password for the default ADMIN user. Note: Only one of `admin_password_secret_version` or `admin_password` can be populated. - "adminPasswordSecretVersion": "A String", # Optional. The resource name of a secret version in Secret Manager which contains the database admin user's password. Format: projects/{project}/secrets/{secret}/versions/{version}. Note: Only one of `admin_password_secret_version` or `admin_password` can be populated. + "adminPassword": "A String", # Optional. Input only. The password for the default ADMIN user. Note: Only one of `admin_password_secret_version` or `admin_password` can be populated. + "adminPasswordSecretVersion": "A String", # Optional. Input only. The resource name of a secret version in Secret Manager which contains the database admin user's password. Format: projects/{project}/secrets/{secret}/versions/{version}. Note: Only one of `admin_password_secret_version` or `admin_password` can be populated. "characterSet": "A String", # Optional. The character set for the database. The default is AL32UTF8. "createTime": "A String", # Output only. The date and time that the Database was created. "databaseId": "A String", # Optional. The database ID of the Database. @@ -450,8 +453,8 @@

Method Details

"dbVersion": "A String", # Required. The Oracle Database version. "state": "A String", # Output only. State of the Database. }, - "tdeWalletPassword": "A String", # Optional. The TDE wallet password for the database. Note: Only one of `tde_wallet_password_secret_version` or `tde_wallet_password` can be populated. - "tdeWalletPasswordSecretVersion": "A String", # Optional. The resource name of a secret version in Secret Manager which contains the TDE wallet password for the database. Format: projects/{project}/secrets/{secret}/versions/{version}. Note: Only one of `tde_wallet_password_secret_version` or `tde_wallet_password` can be populated. + "tdeWalletPassword": "A String", # Optional. Input only. The TDE wallet password for the database. Note: Only one of `tde_wallet_password_secret_version` or `tde_wallet_password` can be populated. + "tdeWalletPasswordSecretVersion": "A String", # Optional. Input only. The resource name of a secret version in Secret Manager which contains the TDE wallet password for the database. Format: projects/{project}/secrets/{secret}/versions/{version}. Note: Only one of `tde_wallet_password_secret_version` or `tde_wallet_password` can be populated. }, "dbVersion": "A String", # Required. A valid Oracle Database version. For a list of supported versions, use the ListDbVersions operation. "displayName": "A String", # Optional. The display name for the Database Home. The name does not have to be unique within your project. @@ -503,4 +506,135 @@

Method Details

+
+ patch(name, body=None, requestId=None, updateMask=None, x__xgafv=None) + 
Updates the `labels` of a single DbSystem.
+
+Args:
+  name: string, Identifier. The name of the DbSystem resource in the following format: projects/{project}/locations/{region}/dbSystems/{db_system} (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # Details of the DbSystem (BaseDB) resource. https://docs.oracle.com/en-us/iaas/api/#/en/database/20160918/DbSystem/
+  "createTime": "A String", # Output only. The date and time that the DbSystem was created.
+  "displayName": "A String", # Required. Immutable. The display name for the System db. The name does not have to be unique within your project.
+  "entitlementId": "A String", # Output only. The ID of the subscription entitlement associated with the DbSystem
+  "gcpOracleZone": "A String", # Optional. Immutable. The GCP Oracle zone where Oracle DbSystem is hosted. Example: us-east4-b-r2. If not specified, the system will pick a zone based on availability.
+  "labels": { # Optional. The labels or tags associated with the DbSystem.
+    "a_key": "A String",
+  },
+  "name": "A String", # Identifier. The name of the DbSystem resource in the following format: projects/{project}/locations/{region}/dbSystems/{db_system}
+  "ociUrl": "A String", # Output only. HTTPS link to OCI resources exposed to Customer via UI Interface.
+  "odbNetwork": "A String", # Optional. Immutable. The name of the OdbNetwork associated with the DbSystem. Format: projects/{project}/locations/{location}/odbNetworks/{odb_network} It is optional but if specified, this should match the parent ODBNetwork of the OdbSubnet.
+  "odbSubnet": "A String", # Required. Immutable. The name of the OdbSubnet associated with the DbSystem for IP allocation. Format: projects/{project}/locations/{location}/odbNetworks/{odb_network}/odbSubnets/{odb_subnet}
+  "properties": { # The properties of a DbSystem. # Optional. Immutable. The properties of the DbSystem.
+    "computeCount": 42, # Required. The number of CPU cores to enable for the DbSystem.
+    "computeModel": "A String", # Optional. The compute model of the DbSystem.
+    "dataCollectionOptions": { # Data collection options for DbSystem. # Optional. Data collection options for diagnostics.
+      "isDiagnosticsEventsEnabled": True or False, # Optional. Indicates whether to enable data collection for diagnostics.
+      "isIncidentLogsEnabled": True or False, # Optional. Indicates whether to enable incident logs and trace collection.
+    },
+    "dataStorageSizeGb": 42, # Optional. The data storage size in GB that is currently available to DbSystems. The value is same as initial_data_storage_size_gb. This can be modified from OCI console.
+    "databaseEdition": "A String", # Required. The database edition of the DbSystem.
+    "dbHome": { # Details of the Database Home resource. # Optional. Details for creating a Database Home.
+      "database": { # Details of the Database resource. https://docs.oracle.com/en-us/iaas/api/#/en/database/20160918/Database/ # Required. The Database resource.
+        "adminPassword": "A String", # Optional. Input only. The password for the default ADMIN user. Note: Only one of `admin_password_secret_version` or `admin_password` can be populated.
+        "adminPasswordSecretVersion": "A String", # Optional. Input only. The resource name of a secret version in Secret Manager which contains the database admin user's password. Format: projects/{project}/secrets/{secret}/versions/{version}. Note: Only one of `admin_password_secret_version` or `admin_password` can be populated.
+        "characterSet": "A String", # Optional. The character set for the database. The default is AL32UTF8.
+        "createTime": "A String", # Output only. The date and time that the Database was created.
+        "databaseId": "A String", # Optional. The database ID of the Database.
+        "dbHomeName": "A String", # Optional. The name of the DbHome resource associated with the Database.
+        "dbName": "A String", # Optional. The database name. The name must begin with an alphabetic character and can contain a maximum of eight alphanumeric characters. Special characters are not permitted.
+        "dbUniqueName": "A String", # Optional. The DB_UNIQUE_NAME of the Oracle Database being backed up.
+        "gcpOracleZone": "A String", # Output only. The GCP Oracle zone where the Database is created.
+        "name": "A String", # Identifier. The name of the Database resource in the following format: projects/{project}/locations/{region}/databases/{database}
+        "ncharacterSet": "A String", # Optional. The national character set for the database. The default is AL16UTF16.
+        "ociUrl": "A String", # Output only. HTTPS link to OCI resources exposed to Customer via UI Interface.
+        "opsInsightsStatus": "A String", # Output only. The Status of Operations Insights for this Database.
+        "pluggableDatabaseId": "A String", # Optional. The ID of the pluggable database associated with the Database. The ID must be unique within the project and location.
+        "pluggableDatabaseName": "A String", # Optional. The pluggable database associated with the Database. The name must begin with an alphabetic character and can contain a maximum of thirty alphanumeric characters.
+        "properties": { # The properties of a Database. # Optional. The properties of the Database.
+          "databaseManagementConfig": { # The configuration of the Database Management service. # Output only. The Database Management config.
+            "managementState": "A String", # Output only. The status of the Database Management service.
+            "managementType": "A String", # Output only. The Database Management type.
+          },
+          "dbBackupConfig": { # Backup Options for the Database. # Optional. Backup options for the Database.
+            "autoBackupEnabled": True or False, # Optional. If set to true, enables automatic backups on the database.
+            "autoFullBackupDay": "A String", # Optional. The day of the week on which the full backup should be performed on the database. If no value is provided, it will default to Sunday.
+            "autoFullBackupWindow": "A String", # Optional. The window in which the full backup should be performed on the database. If no value is provided, the default is anytime.
+            "autoIncrementalBackupWindow": "A String", # Optional. The window in which the incremental backup should be performed on the database. If no value is provided, the default is anytime except the auto full backup day.
+            "backupDeletionPolicy": "A String", # Optional. This defines when the backups will be deleted after Database termination.
+            "backupDestinationDetails": [ # Optional. Details of the database backup destinations.
+              { # The details of the database backup destination.
+                "type": "A String", # Optional. The type of the database backup destination.
+              },
+            ],
+            "retentionPeriodDays": 42, # Optional. The number of days an automatic backup is retained before being automatically deleted. This value determines the earliest point in time to which a database can be restored. Min: 1, Max: 60.
+          },
+          "dbVersion": "A String", # Required. The Oracle Database version.
+          "state": "A String", # Output only. State of the Database.
+        },
+        "tdeWalletPassword": "A String", # Optional. Input only. The TDE wallet password for the database. Note: Only one of `tde_wallet_password_secret_version` or `tde_wallet_password` can be populated.
+        "tdeWalletPasswordSecretVersion": "A String", # Optional. Input only. The resource name of a secret version in Secret Manager which contains the TDE wallet password for the database. Format: projects/{project}/secrets/{secret}/versions/{version}. Note: Only one of `tde_wallet_password_secret_version` or `tde_wallet_password` can be populated.
+      },
+      "dbVersion": "A String", # Required. A valid Oracle Database version. For a list of supported versions, use the ListDbVersions operation.
+      "displayName": "A String", # Optional. The display name for the Database Home. The name does not have to be unique within your project.
+      "isUnifiedAuditingEnabled": True or False, # Optional. Whether unified auditing is enabled for the Database Home.
+    },
+    "dbSystemOptions": { # Details of the DbSystem Options. # Optional. The options for the DbSystem.
+      "storageManagement": "A String", # Optional. The storage option used in DB system.
+    },
+    "domain": "A String", # Optional. The host domain name of the DbSystem.
+    "hostname": "A String", # Output only. The hostname of the DbSystem.
+    "hostnamePrefix": "A String", # Optional. Prefix for DB System host names.
+    "initialDataStorageSizeGb": 42, # Required. The initial data storage size in GB.
+    "licenseModel": "A String", # Required. The license model of the DbSystem.
+    "lifecycleState": "A String", # Output only. State of the DbSystem.
+    "memorySizeGb": 42, # Optional. The memory size in GB. This value can not be set and is automatically calculated based on the number of ECPUs allocated to the DbSystem.
+    "nodeCount": 42, # Optional. The number of nodes to launch for a virtual machine DbSystem. By default this will be set to 1.
+    "ocid": "A String", # Output only. OCID of the DbSystem.
+    "privateIp": "A String", # Optional. The private IP address of the DbSystem.
+    "recoStorageSizeGb": 42, # Optional. The reco/redo storage size in GB. The value for recovery storage size is based on the available data storage size.
+    "shape": "A String", # Required. Shape of DB System.
+    "sshPublicKeys": [ # Required. SSH public keys to be stored with the DbSystem.
+      "A String",
+    ],
+    "timeZone": { # Represents a time zone from the [IANA Time Zone Database](https://www.iana.org/time-zones). # Optional. Time zone of the DbSystem.
+      "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".
+    },
+  },
+}
+
+  requestId: string, Optional. An optional ID to identify the request. This value is used to identify duplicate requests. If you make a request with the same request ID and the original request is still in progress or completed, the server 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. A mask specifying which fields in the DbSystem should be updated. A field specified in the mask is updated. If a mask isn't provided, the service treats this as an implied field mask equivalent to all fields that are populated (have a non-empty value).
+  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/oracledatabase_v1.projects.locations.exascaleDbStorageVaults.html b/docs/dyn/oracledatabase_v1.projects.locations.exascaleDbStorageVaults.html index 6fb23d6a4a..6450298507 100644 --- a/docs/dyn/oracledatabase_v1.projects.locations.exascaleDbStorageVaults.html +++ b/docs/dyn/oracledatabase_v1.projects.locations.exascaleDbStorageVaults.html @@ -92,6 +92,9 @@

Instance Methods

list_next(previous_request, previous_response)

Retrieves the next page of results.

+

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

+

Updates the `labels` of a single ExascaleDbStorageVault.

Method Details

close() @@ -109,15 +112,15 @@

Method Details

{ # ExascaleDbStorageVault represents a storage vault exadb vm cluster resource. https://docs.oracle.com/en-us/iaas/api/#/en/database/20160918/ExascaleDbStorageVault/ "createTime": "A String", # Output only. The date and time when the ExascaleDbStorageVault was created. - "displayName": "A String", # Required. The display name for the ExascaleDbStorageVault. The name does not have to be unique within your project. The name must be 1-255 characters long and can only contain alphanumeric characters. + "displayName": "A String", # Required. Immutable. The display name for the ExascaleDbStorageVault. The name does not have to be unique within your project. The name must be 1-255 characters long and can only contain alphanumeric characters. "entitlementId": "A String", # Output only. The ID of the subscription entitlement associated with the ExascaleDbStorageVault. - "exadataInfrastructure": "A String", # Optional. The Exadata Infrastructure resource on which ExascaleDbStorageVault resource is created, in the following format: projects/{project}/locations/{region}/cloudExadataInfrastuctures/{cloud_extradata_infrastructure} - "gcpOracleZone": "A String", # Optional. The GCP Oracle zone where Oracle ExascaleDbStorageVault is hosted. Example: us-east4-b-r2. If not specified, the system will pick a zone based on availability. + "exadataInfrastructure": "A String", # Optional. Immutable. The Exadata Infrastructure resource on which ExascaleDbStorageVault resource is created, in the following format: projects/{project}/locations/{region}/cloudExadataInfrastuctures/{cloud_extradata_infrastructure} + "gcpOracleZone": "A String", # Optional. Immutable. The GCP Oracle zone where Oracle ExascaleDbStorageVault is hosted. Example: us-east4-b-r2. If not specified, the system will pick a zone based on availability. "labels": { # Optional. The labels or tags associated with the ExascaleDbStorageVault. "a_key": "A String", }, "name": "A String", # Identifier. The resource name of the ExascaleDbStorageVault. Format: projects/{project}/locations/{location}/exascaleDbStorageVaults/{exascale_db_storage_vault} - "properties": { # The properties of the ExascaleDbStorageVault. next ID: 12 # Required. The properties of the ExascaleDbStorageVault. + "properties": { # The properties of the ExascaleDbStorageVault. next ID: 12 # Required. Immutable. The properties of the ExascaleDbStorageVault. "additionalFlashCachePercent": 42, # Optional. The size of additional flash cache in percentage of high capacity database storage. "attachedShapeAttributes": [ # Output only. The shape attributes of the VM clusters attached to the ExascaleDbStorageVault. "A String", @@ -227,15 +230,15 @@

Method Details

{ # ExascaleDbStorageVault represents a storage vault exadb vm cluster resource. https://docs.oracle.com/en-us/iaas/api/#/en/database/20160918/ExascaleDbStorageVault/ "createTime": "A String", # Output only. The date and time when the ExascaleDbStorageVault was created. - "displayName": "A String", # Required. The display name for the ExascaleDbStorageVault. The name does not have to be unique within your project. The name must be 1-255 characters long and can only contain alphanumeric characters. + "displayName": "A String", # Required. Immutable. The display name for the ExascaleDbStorageVault. The name does not have to be unique within your project. The name must be 1-255 characters long and can only contain alphanumeric characters. "entitlementId": "A String", # Output only. The ID of the subscription entitlement associated with the ExascaleDbStorageVault. - "exadataInfrastructure": "A String", # Optional. The Exadata Infrastructure resource on which ExascaleDbStorageVault resource is created, in the following format: projects/{project}/locations/{region}/cloudExadataInfrastuctures/{cloud_extradata_infrastructure} - "gcpOracleZone": "A String", # Optional. The GCP Oracle zone where Oracle ExascaleDbStorageVault is hosted. Example: us-east4-b-r2. If not specified, the system will pick a zone based on availability. + "exadataInfrastructure": "A String", # Optional. Immutable. The Exadata Infrastructure resource on which ExascaleDbStorageVault resource is created, in the following format: projects/{project}/locations/{region}/cloudExadataInfrastuctures/{cloud_extradata_infrastructure} + "gcpOracleZone": "A String", # Optional. Immutable. The GCP Oracle zone where Oracle ExascaleDbStorageVault is hosted. Example: us-east4-b-r2. If not specified, the system will pick a zone based on availability. "labels": { # Optional. The labels or tags associated with the ExascaleDbStorageVault. "a_key": "A String", }, "name": "A String", # Identifier. The resource name of the ExascaleDbStorageVault. Format: projects/{project}/locations/{location}/exascaleDbStorageVaults/{exascale_db_storage_vault} - "properties": { # The properties of the ExascaleDbStorageVault. next ID: 12 # Required. The properties of the ExascaleDbStorageVault. + "properties": { # The properties of the ExascaleDbStorageVault. next ID: 12 # Required. Immutable. The properties of the ExascaleDbStorageVault. "additionalFlashCachePercent": 42, # Optional. The size of additional flash cache in percentage of high capacity database storage. "attachedShapeAttributes": [ # Output only. The shape attributes of the VM clusters attached to the ExascaleDbStorageVault. "A String", @@ -285,15 +288,15 @@

Method Details

"exascaleDbStorageVaults": [ # The ExascaleDbStorageVaults. { # ExascaleDbStorageVault represents a storage vault exadb vm cluster resource. https://docs.oracle.com/en-us/iaas/api/#/en/database/20160918/ExascaleDbStorageVault/ "createTime": "A String", # Output only. The date and time when the ExascaleDbStorageVault was created. - "displayName": "A String", # Required. The display name for the ExascaleDbStorageVault. The name does not have to be unique within your project. The name must be 1-255 characters long and can only contain alphanumeric characters. + "displayName": "A String", # Required. Immutable. The display name for the ExascaleDbStorageVault. The name does not have to be unique within your project. The name must be 1-255 characters long and can only contain alphanumeric characters. "entitlementId": "A String", # Output only. The ID of the subscription entitlement associated with the ExascaleDbStorageVault. - "exadataInfrastructure": "A String", # Optional. The Exadata Infrastructure resource on which ExascaleDbStorageVault resource is created, in the following format: projects/{project}/locations/{region}/cloudExadataInfrastuctures/{cloud_extradata_infrastructure} - "gcpOracleZone": "A String", # Optional. The GCP Oracle zone where Oracle ExascaleDbStorageVault is hosted. Example: us-east4-b-r2. If not specified, the system will pick a zone based on availability. + "exadataInfrastructure": "A String", # Optional. Immutable. The Exadata Infrastructure resource on which ExascaleDbStorageVault resource is created, in the following format: projects/{project}/locations/{region}/cloudExadataInfrastuctures/{cloud_extradata_infrastructure} + "gcpOracleZone": "A String", # Optional. Immutable. The GCP Oracle zone where Oracle ExascaleDbStorageVault is hosted. Example: us-east4-b-r2. If not specified, the system will pick a zone based on availability. "labels": { # Optional. The labels or tags associated with the ExascaleDbStorageVault. "a_key": "A String", }, "name": "A String", # Identifier. The resource name of the ExascaleDbStorageVault. Format: projects/{project}/locations/{location}/exascaleDbStorageVaults/{exascale_db_storage_vault} - "properties": { # The properties of the ExascaleDbStorageVault. next ID: 12 # Required. The properties of the ExascaleDbStorageVault. + "properties": { # The properties of the ExascaleDbStorageVault. next ID: 12 # Required. Immutable. The properties of the ExascaleDbStorageVault. "additionalFlashCachePercent": 42, # Optional. The size of additional flash cache in percentage of high capacity database storage. "attachedShapeAttributes": [ # Output only. The shape attributes of the VM clusters attached to the ExascaleDbStorageVault. "A String", @@ -341,4 +344,81 @@

Method Details

+
+ patch(name, body=None, requestId=None, updateMask=None, x__xgafv=None) + 
Updates the `labels` of a single ExascaleDbStorageVault.
+
+Args:
+  name: string, Identifier. The resource name of the ExascaleDbStorageVault. Format: projects/{project}/locations/{location}/exascaleDbStorageVaults/{exascale_db_storage_vault} (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # ExascaleDbStorageVault represents a storage vault exadb vm cluster resource. https://docs.oracle.com/en-us/iaas/api/#/en/database/20160918/ExascaleDbStorageVault/
+  "createTime": "A String", # Output only. The date and time when the ExascaleDbStorageVault was created.
+  "displayName": "A String", # Required. Immutable. The display name for the ExascaleDbStorageVault. The name does not have to be unique within your project. The name must be 1-255 characters long and can only contain alphanumeric characters.
+  "entitlementId": "A String", # Output only. The ID of the subscription entitlement associated with the ExascaleDbStorageVault.
+  "exadataInfrastructure": "A String", # Optional. Immutable. The Exadata Infrastructure resource on which ExascaleDbStorageVault resource is created, in the following format: projects/{project}/locations/{region}/cloudExadataInfrastuctures/{cloud_extradata_infrastructure}
+  "gcpOracleZone": "A String", # Optional. Immutable. The GCP Oracle zone where Oracle ExascaleDbStorageVault is hosted. Example: us-east4-b-r2. If not specified, the system will pick a zone based on availability.
+  "labels": { # Optional. The labels or tags associated with the ExascaleDbStorageVault.
+    "a_key": "A String",
+  },
+  "name": "A String", # Identifier. The resource name of the ExascaleDbStorageVault. Format: projects/{project}/locations/{location}/exascaleDbStorageVaults/{exascale_db_storage_vault}
+  "properties": { # The properties of the ExascaleDbStorageVault. next ID: 12 # Required. Immutable. The properties of the ExascaleDbStorageVault.
+    "additionalFlashCachePercent": 42, # Optional. The size of additional flash cache in percentage of high capacity database storage.
+    "attachedShapeAttributes": [ # Output only. The shape attributes of the VM clusters attached to the ExascaleDbStorageVault.
+      "A String",
+    ],
+    "availableShapeAttributes": [ # Output only. The shape attributes available for the VM clusters to be attached to the ExascaleDbStorageVault.
+      "A String",
+    ],
+    "description": "A String", # Optional. The description of the ExascaleDbStorageVault.
+    "exascaleDbStorageDetails": { # The storage details of the ExascaleDbStorageVault. # Required. The storage details of the ExascaleDbStorageVault.
+      "availableSizeGbs": 42, # Output only. The available storage capacity for the ExascaleDbStorageVault, in gigabytes (GB).
+      "totalSizeGbs": 42, # Required. The total storage allocation for the ExascaleDbStorageVault, in gigabytes (GB).
+    },
+    "ociUri": "A String", # Output only. Deep link to the OCI console to view this resource.
+    "ocid": "A String", # Output only. The OCID for the ExascaleDbStorageVault.
+    "state": "A String", # Output only. The state of the ExascaleDbStorageVault.
+    "timeZone": { # Represents a time zone from the [IANA Time Zone Database](https://www.iana.org/time-zones). # Output only. The time zone of the ExascaleDbStorageVault.
+      "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".
+    },
+    "vmClusterCount": 42, # Output only. The number of VM clusters associated with the ExascaleDbStorageVault.
+    "vmClusterIds": [ # Output only. The list of VM cluster OCIDs associated with the ExascaleDbStorageVault.
+      "A String",
+    ],
+  },
+}
+
+  requestId: string, Optional. An optional ID to identify the request. This value is used to identify duplicate requests. If you make a request with the same request ID and the original request is still in progress or completed, the server 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. A mask specifying which fields in the ExascaleDbStorageVault should be updated. A field specified in the mask is updated. If a mask isn't provided, the service treats this as an implied field mask equivalent to all fields that are populated (have a non-empty value). To clear or unset a field, the field must be explicitly specified in the `update_mask`.
+  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/oracledatabase_v1.projects.locations.goldengateConnectionAssignments.html b/docs/dyn/oracledatabase_v1.projects.locations.goldengateConnectionAssignments.html index ded77f493c..5c30438601 100644 --- a/docs/dyn/oracledatabase_v1.projects.locations.goldengateConnectionAssignments.html +++ b/docs/dyn/oracledatabase_v1.projects.locations.goldengateConnectionAssignments.html @@ -92,6 +92,9 @@

Instance Methods

list_next(previous_request, previous_response)

Retrieves the next page of results.

+

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

+

Updates the `labels` of a single GoldengateConnectionAssignment.

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

Tests a single GoldengateConnectionAssignment.

@@ -112,13 +115,13 @@

Method Details

{ # Represents the metadata of a Goldengate Connection Assignment. "createTime": "A String", # Output only. The time when the connection assignment was created. - "displayName": "A String", # Optional. The display name for the GoldengateConnectionAssignment. + "displayName": "A String", # Optional. Immutable. The display name for the GoldengateConnectionAssignment. "entitlementId": "A String", # Output only. The OCID of the entitlement linked to this resource. "labels": { # Optional. The labels or tags associated with the GoldengateConnectionAssignment. "a_key": "A String", }, "name": "A String", # Identifier. The name of the GoldengateConnectionAssignment resource in the following format: projects/{project}/locations/{region}/goldengateConnectionAssignments/{goldengate_connection_assignment} - "properties": { # The properties of a GoldengateConnectionAssignment. # Required. The properties of the GoldengateConnectionAssignment. + "properties": { # The properties of a GoldengateConnectionAssignment. # Required. Immutable. The properties of the GoldengateConnectionAssignment. "alias": "A String", # Output only. Credential store alias. "goldengateConnection": "A String", # Required. The GoldengateConnection resource to be assigned. Format: projects/{project}/locations/{location}/goldengateConnections/{goldengate_connection} "goldengateDeployment": "A String", # Required. The GoldenGateDeployment to assign the connection to. Format: projects/{project}/locations/{location}/goldengateDeployments/{goldengate_deployment} @@ -210,13 +213,13 @@

Method Details

{ # Represents the metadata of a Goldengate Connection Assignment. "createTime": "A String", # Output only. The time when the connection assignment was created. - "displayName": "A String", # Optional. The display name for the GoldengateConnectionAssignment. + "displayName": "A String", # Optional. Immutable. The display name for the GoldengateConnectionAssignment. "entitlementId": "A String", # Output only. The OCID of the entitlement linked to this resource. "labels": { # Optional. The labels or tags associated with the GoldengateConnectionAssignment. "a_key": "A String", }, "name": "A String", # Identifier. The name of the GoldengateConnectionAssignment resource in the following format: projects/{project}/locations/{region}/goldengateConnectionAssignments/{goldengate_connection_assignment} - "properties": { # The properties of a GoldengateConnectionAssignment. # Required. The properties of the GoldengateConnectionAssignment. + "properties": { # The properties of a GoldengateConnectionAssignment. # Required. Immutable. The properties of the GoldengateConnectionAssignment. "alias": "A String", # Output only. Credential store alias. "goldengateConnection": "A String", # Required. The GoldengateConnection resource to be assigned. Format: projects/{project}/locations/{location}/goldengateConnections/{goldengate_connection} "goldengateDeployment": "A String", # Required. The GoldenGateDeployment to assign the connection to. Format: projects/{project}/locations/{location}/goldengateDeployments/{goldengate_deployment} @@ -248,13 +251,13 @@

Method Details

"goldengateConnectionAssignments": [ # The list of GoldengateConnectionAssignments. { # Represents the metadata of a Goldengate Connection Assignment. "createTime": "A String", # Output only. The time when the connection assignment was created. - "displayName": "A String", # Optional. The display name for the GoldengateConnectionAssignment. + "displayName": "A String", # Optional. Immutable. The display name for the GoldengateConnectionAssignment. "entitlementId": "A String", # Output only. The OCID of the entitlement linked to this resource. "labels": { # Optional. The labels or tags associated with the GoldengateConnectionAssignment. "a_key": "A String", }, "name": "A String", # Identifier. The name of the GoldengateConnectionAssignment resource in the following format: projects/{project}/locations/{region}/goldengateConnectionAssignments/{goldengate_connection_assignment} - "properties": { # The properties of a GoldengateConnectionAssignment. # Required. The properties of the GoldengateConnectionAssignment. + "properties": { # The properties of a GoldengateConnectionAssignment. # Required. Immutable. The properties of the GoldengateConnectionAssignment. "alias": "A String", # Output only. Credential store alias. "goldengateConnection": "A String", # Required. The GoldengateConnection resource to be assigned. Format: projects/{project}/locations/{location}/goldengateConnections/{goldengate_connection} "goldengateDeployment": "A String", # Required. The GoldenGateDeployment to assign the connection to. Format: projects/{project}/locations/{location}/goldengateDeployments/{goldengate_deployment} @@ -284,6 +287,63 @@

Method Details

+
+ patch(name, body=None, requestId=None, updateMask=None, x__xgafv=None) + 
Updates the `labels` of a single GoldengateConnectionAssignment.
+
+Args:
+  name: string, Identifier. The name of the GoldengateConnectionAssignment resource in the following format: projects/{project}/locations/{region}/goldengateConnectionAssignments/{goldengate_connection_assignment} (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # Represents the metadata of a Goldengate Connection Assignment.
+  "createTime": "A String", # Output only. The time when the connection assignment was created.
+  "displayName": "A String", # Optional. Immutable. The display name for the GoldengateConnectionAssignment.
+  "entitlementId": "A String", # Output only. The OCID of the entitlement linked to this resource.
+  "labels": { # Optional. The labels or tags associated with the GoldengateConnectionAssignment.
+    "a_key": "A String",
+  },
+  "name": "A String", # Identifier. The name of the GoldengateConnectionAssignment resource in the following format: projects/{project}/locations/{region}/goldengateConnectionAssignments/{goldengate_connection_assignment}
+  "properties": { # The properties of a GoldengateConnectionAssignment. # Required. Immutable. The properties of the GoldengateConnectionAssignment.
+    "alias": "A String", # Output only. Credential store alias.
+    "goldengateConnection": "A String", # Required. The GoldengateConnection resource to be assigned. Format: projects/{project}/locations/{location}/goldengateConnections/{goldengate_connection}
+    "goldengateDeployment": "A String", # Required. The GoldenGateDeployment to assign the connection to. Format: projects/{project}/locations/{location}/goldengateDeployments/{goldengate_deployment}
+    "ocid": "A String", # Output only. The [OCID](https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm) of the connection assignment being referenced.
+    "state": "A String", # Output only. The lifecycle state of the connection assignment.
+  },
+}
+
+  requestId: string, Optional. An optional ID to identify the request. This value is used to identify duplicate requests. If you make a request with the same request ID and the original request is still in progress or completed, the server 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. A mask specifying which fields in the GoldengateConnectionAssignment should be updated. A field specified in the mask is updated. If a mask isn't provided, the service treats this as an implied field mask equivalent to all fields that are populated (have a non-empty value). To clear or unset a field, the field must be explicitly specified in the `update_mask`.
+  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.
+  },
+}
+
+
test(name, body=None, x__xgafv=None) 
Tests a single GoldengateConnectionAssignment.
diff --git a/docs/dyn/oracledatabase_v1.projects.locations.goldengateConnections.html b/docs/dyn/oracledatabase_v1.projects.locations.goldengateConnections.html
index 97889a6ff4..f790762ef5 100644
--- a/docs/dyn/oracledatabase_v1.projects.locations.goldengateConnections.html
+++ b/docs/dyn/oracledatabase_v1.projects.locations.goldengateConnections.html
@@ -92,6 +92,9 @@ 
Instance Methods

 

   list_next(previous_request, previous_response)

 
Retrieves the next page of results.

+

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

+
Updates the `labels` of a single GoldengateConnection.

 
Method Details

 

     close()
@@ -110,15 +113,15 @@ 
Method Details

 { # Details of the GoldengateConnection resource.
   "createTime": "A String", # Output only. The date and time that the GoldengateConnection was created.
   "entitlementId": "A String", # Output only. The ID of the subscription entitlement associated with the GoldengateConnection.
-  "gcpOracleZone": "A String", # Optional. The GCP Oracle zone where Oracle GoldengateConnection is hosted. Example: us-east4-b-r2. If not specified, the system will pick a zone based on availability.
+  "gcpOracleZone": "A String", # Optional. Immutable. The GCP Oracle zone where Oracle GoldengateConnection is hosted. Example: us-east4-b-r2. If not specified, the system will pick a zone based on availability.
   "labels": { # Optional. The labels or tags associated with the GoldengateConnection.
     "a_key": "A String",
   },
   "name": "A String", # Identifier. The name of the GoldengateConnection resource in the following format: projects/{project}/locations/{region}/goldengateConnections/{goldengate_connection}
   "ociUrl": "A String", # Output only. HTTPS link to OCI resources exposed to Customer via UI Interface.
-  "odbNetwork": "A String", # Optional. The name of the OdbNetwork associated with the GoldengateConnection. The format is projects/{project}/locations/{location}/odbNetworks/{odb_network}. It is optional but if specified, this should match the parent ODBNetwork of the OdbSubnet.
-  "odbSubnet": "A String", # Optional. The name of the OdbSubnet associated with the GoldengateConnection for IP allocation. Format: projects/{project}/locations/{location}/odbNetworks/{odb_network}/odbSubnets/{odb_subnet}
-  "properties": { # The properties of a GoldengateConnection. # Required. The properties of the GoldengateConnection.
+  "odbNetwork": "A String", # Optional. Immutable. The name of the OdbNetwork associated with the GoldengateConnection. The format is projects/{project}/locations/{location}/odbNetworks/{odb_network}. It is optional but if specified, this should match the parent ODBNetwork of the OdbSubnet.
+  "odbSubnet": "A String", # Optional. Immutable. The name of the OdbSubnet associated with the GoldengateConnection for IP allocation. Format: projects/{project}/locations/{location}/odbNetworks/{odb_network}/odbSubnets/{odb_subnet}
+  "properties": { # The properties of a GoldengateConnection. # Required. Immutable. The properties of the GoldengateConnection.
     "amazonKinesisConnectionProperties": { # The properties of GoldengateAmazonKinesisConnection. # Properties for an Amazon Kinesis connection.
       "accessKeyId": "A String", # Optional. Access key ID to access the Amazon Kinesis.
       "awsRegion": "A String", # Optional. The name of the AWS region. If not provided, Goldengate will default to 'us-west-1'.
@@ -588,15 +591,15 @@ 
Method Details

     { # Details of the GoldengateConnection resource.
   "createTime": "A String", # Output only. The date and time that the GoldengateConnection was created.
   "entitlementId": "A String", # Output only. The ID of the subscription entitlement associated with the GoldengateConnection.
-  "gcpOracleZone": "A String", # Optional. The GCP Oracle zone where Oracle GoldengateConnection is hosted. Example: us-east4-b-r2. If not specified, the system will pick a zone based on availability.
+  "gcpOracleZone": "A String", # Optional. Immutable. The GCP Oracle zone where Oracle GoldengateConnection is hosted. Example: us-east4-b-r2. If not specified, the system will pick a zone based on availability.
   "labels": { # Optional. The labels or tags associated with the GoldengateConnection.
     "a_key": "A String",
   },
   "name": "A String", # Identifier. The name of the GoldengateConnection resource in the following format: projects/{project}/locations/{region}/goldengateConnections/{goldengate_connection}
   "ociUrl": "A String", # Output only. HTTPS link to OCI resources exposed to Customer via UI Interface.
-  "odbNetwork": "A String", # Optional. The name of the OdbNetwork associated with the GoldengateConnection. The format is projects/{project}/locations/{location}/odbNetworks/{odb_network}. It is optional but if specified, this should match the parent ODBNetwork of the OdbSubnet.
-  "odbSubnet": "A String", # Optional. The name of the OdbSubnet associated with the GoldengateConnection for IP allocation. Format: projects/{project}/locations/{location}/odbNetworks/{odb_network}/odbSubnets/{odb_subnet}
-  "properties": { # The properties of a GoldengateConnection. # Required. The properties of the GoldengateConnection.
+  "odbNetwork": "A String", # Optional. Immutable. The name of the OdbNetwork associated with the GoldengateConnection. The format is projects/{project}/locations/{location}/odbNetworks/{odb_network}. It is optional but if specified, this should match the parent ODBNetwork of the OdbSubnet.
+  "odbSubnet": "A String", # Optional. Immutable. The name of the OdbSubnet associated with the GoldengateConnection for IP allocation. Format: projects/{project}/locations/{location}/odbNetworks/{odb_network}/odbSubnets/{odb_subnet}
+  "properties": { # The properties of a GoldengateConnection. # Required. Immutable. The properties of the GoldengateConnection.
     "amazonKinesisConnectionProperties": { # The properties of GoldengateAmazonKinesisConnection. # Properties for an Amazon Kinesis connection.
       "accessKeyId": "A String", # Optional. Access key ID to access the Amazon Kinesis.
       "awsRegion": "A String", # Optional. The name of the AWS region. If not provided, Goldengate will default to 'us-west-1'.
@@ -1006,15 +1009,15 @@ 
Method Details

     { # Details of the GoldengateConnection resource.
       "createTime": "A String", # Output only. The date and time that the GoldengateConnection was created.
       "entitlementId": "A String", # Output only. The ID of the subscription entitlement associated with the GoldengateConnection.
-      "gcpOracleZone": "A String", # Optional. The GCP Oracle zone where Oracle GoldengateConnection is hosted. Example: us-east4-b-r2. If not specified, the system will pick a zone based on availability.
+      "gcpOracleZone": "A String", # Optional. Immutable. The GCP Oracle zone where Oracle GoldengateConnection is hosted. Example: us-east4-b-r2. If not specified, the system will pick a zone based on availability.
       "labels": { # Optional. The labels or tags associated with the GoldengateConnection.
         "a_key": "A String",
       },
       "name": "A String", # Identifier. The name of the GoldengateConnection resource in the following format: projects/{project}/locations/{region}/goldengateConnections/{goldengate_connection}
       "ociUrl": "A String", # Output only. HTTPS link to OCI resources exposed to Customer via UI Interface.
-      "odbNetwork": "A String", # Optional. The name of the OdbNetwork associated with the GoldengateConnection. The format is projects/{project}/locations/{location}/odbNetworks/{odb_network}. It is optional but if specified, this should match the parent ODBNetwork of the OdbSubnet.
-      "odbSubnet": "A String", # Optional. The name of the OdbSubnet associated with the GoldengateConnection for IP allocation. Format: projects/{project}/locations/{location}/odbNetworks/{odb_network}/odbSubnets/{odb_subnet}
-      "properties": { # The properties of a GoldengateConnection. # Required. The properties of the GoldengateConnection.
+      "odbNetwork": "A String", # Optional. Immutable. The name of the OdbNetwork associated with the GoldengateConnection. The format is projects/{project}/locations/{location}/odbNetworks/{odb_network}. It is optional but if specified, this should match the parent ODBNetwork of the OdbSubnet.
+      "odbSubnet": "A String", # Optional. Immutable. The name of the OdbSubnet associated with the GoldengateConnection for IP allocation. Format: projects/{project}/locations/{location}/odbNetworks/{odb_network}/odbSubnets/{odb_subnet}
+      "properties": { # The properties of a GoldengateConnection. # Required. Immutable. The properties of the GoldengateConnection.
         "amazonKinesisConnectionProperties": { # The properties of GoldengateAmazonKinesisConnection. # Properties for an Amazon Kinesis connection.
           "accessKeyId": "A String", # Optional. Access key ID to access the Amazon Kinesis.
           "awsRegion": "A String", # Optional. The name of the AWS region. If not provided, Goldengate will default to 'us-west-1'.
@@ -1421,4 +1424,441 @@ 
Method Details
+
+ patch(name, body=None, requestId=None, updateMask=None, x__xgafv=None) + 
Updates the `labels` of a single GoldengateConnection.
+
+Args:
+  name: string, Identifier. The name of the GoldengateConnection resource in the following format: projects/{project}/locations/{region}/goldengateConnections/{goldengate_connection} (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # Details of the GoldengateConnection resource.
+  "createTime": "A String", # Output only. The date and time that the GoldengateConnection was created.
+  "entitlementId": "A String", # Output only. The ID of the subscription entitlement associated with the GoldengateConnection.
+  "gcpOracleZone": "A String", # Optional. Immutable. The GCP Oracle zone where Oracle GoldengateConnection is hosted. Example: us-east4-b-r2. If not specified, the system will pick a zone based on availability.
+  "labels": { # Optional. The labels or tags associated with the GoldengateConnection.
+    "a_key": "A String",
+  },
+  "name": "A String", # Identifier. The name of the GoldengateConnection resource in the following format: projects/{project}/locations/{region}/goldengateConnections/{goldengate_connection}
+  "ociUrl": "A String", # Output only. HTTPS link to OCI resources exposed to Customer via UI Interface.
+  "odbNetwork": "A String", # Optional. Immutable. The name of the OdbNetwork associated with the GoldengateConnection. The format is projects/{project}/locations/{location}/odbNetworks/{odb_network}. It is optional but if specified, this should match the parent ODBNetwork of the OdbSubnet.
+  "odbSubnet": "A String", # Optional. Immutable. The name of the OdbSubnet associated with the GoldengateConnection for IP allocation. Format: projects/{project}/locations/{location}/odbNetworks/{odb_network}/odbSubnets/{odb_subnet}
+  "properties": { # The properties of a GoldengateConnection. # Required. Immutable. The properties of the GoldengateConnection.
+    "amazonKinesisConnectionProperties": { # The properties of GoldengateAmazonKinesisConnection. # Properties for an Amazon Kinesis connection.
+      "accessKeyId": "A String", # Optional. Access key ID to access the Amazon Kinesis.
+      "awsRegion": "A String", # Optional. The name of the AWS region. If not provided, Goldengate will default to 'us-west-1'.
+      "endpoint": "A String", # Optional. The endpoint URL of the Amazon Kinesis service. e.g.: 'https://kinesis.us-east-1.amazonaws.com' If not provided, Goldengate will default to 'https://kinesis..amazonaws.com'.
+      "secretAccessKeySecret": "A String", # Optional. Secret access key to access the Amazon Kinesis.
+      "technologyType": "A String", # Optional. The technology type of AmazonKinesisConnection.
+    },
+    "amazonRedshiftConnectionProperties": { # The properties of GoldengateAmazonRedshiftConnection. # Properties for an Amazon Redshift connection.
+      "connectionUrl": "A String", # Optional. Connection URL. e.g.: 'jdbc:redshift://aws-redshift-instance.aaaaaaaaaaaa.us-east-2.redshift.amazonaws.com:5439/mydb'
+      "password": "A String", # Optional. Input only. The password Oracle Goldengate uses for Amazon Redshift connection in plain text.
+      "passwordSecretVersion": "A String", # Optional. Input only. The resource name of a secret version in Secret Manager which contains the password Oracle Goldengate uses for Amazon Redshift connection. Format: projects/{project}/secrets/{secret}/versions/{version}.
+      "technologyType": "A String", # Optional. The technology type of AmazonRedshiftConnection.
+      "username": "A String", # Optional. The username Oracle Goldengate uses to connect the associated system of the given technology.
+    },
+    "amazonS3ConnectionProperties": { # The properties of GoldengateAmazonS3Connection. # Properties for an Amazon S3 connection.
+      "accessKeyId": "A String", # Optional. Access key ID to access the Amazon S3 bucket.
+      "endpoint": "A String", # Optional. The Amazon Endpoint for S3.
+      "region": "A String", # Optional. The name of the AWS region where the bucket is created.
+      "secretAccessKeySecret": "A String", # Optional. Secret access key to access the Amazon S3 bucket.
+      "technologyType": "A String", # Optional. The technology type of AmazonS3Connection.
+    },
+    "azureDataLakeStorageConnectionProperties": { # The properties of GoldengateAzureDataLakeStorageConnection. # Properties for an Azure Data Lake Storage Connection.
+      "account": "A String", # Optional. Sets the Azure storage account name.
+      "accountKeySecret": "A String", # Optional. Azure storage account key. This property is required when 'authentication_type' is set to 'SHARED_KEY'.
+      "authenticationType": "A String", # Optional. Authentication mechanism to access Azure Data Lake Storage.
+      "azureAuthorityHost": "A String", # Optional. The endpoint used for authentication with Microsoft Entra ID (formerly Azure Active Directory). Default value: https://login.microsoftonline.com
+      "azureTenantId": "A String", # Optional. Azure tenant ID of the application. This property is required when 'authentication_type' is set to 'AZURE_ACTIVE_DIRECTORY'.
+      "clientId": "A String", # Optional. Azure client ID of the application. This property is required when 'authentication_type' is set to 'AZURE_ACTIVE_DIRECTORY'.
+      "clientSecret": "A String", # Optional. Azure client secret (aka application password) for authentication.
+      "endpoint": "A String", # Optional. Azure Storage service endpoint. e.g: https://test.blob.core.windows.net
+      "sasTokenSecret": "A String", # Optional. Credential that uses a shared access signature (SAS) to authenticate to an Azure Service.
+      "technologyType": "A String", # Optional. The technology type of AzureDataLakeStorageConnection.
+    },
+    "azureSynapseAnalyticsConnectionProperties": { # The properties of GoldengateAzureSynapseAnalyticsConnection. # Properties for an Azure Synapse Analytics connection.
+      "connectionString": "A String", # Optional. JDBC connection string. e.g.: 'jdbc:sqlserver://.sql.azuresynapse.net:1433;database=;encrypt=true;trustServerCertificate=false;hostNameInCertificate=*.sql.azuresynapse.net;loginTimeout=300;'
+      "password": "A String", # Optional. Input only. The password Oracle Goldengate uses for Azure Synapse Analytics connection in plain text.
+      "passwordSecretVersion": "A String", # Optional. Input only. The resource name of a secret version in Secret Manager which contains the password Oracle Goldengate uses for Azure Synapse Analytics connection. Format: projects/{project}/secrets/{secret}/versions/{version}.
+      "technologyType": "A String", # Optional. The technology type of AzureSynapseAnalyticsConnection.
+      "username": "A String", # Optional. The username Oracle Goldengate uses to connect the associated system of the given technology.
+    },
+    "connectionType": "A String", # Required. The connection type.
+    "databricksConnectionProperties": { # The properties of GoldengateDatabricksConnection. # Properties for a Databricks connection.
+      "authenticationType": "A String", # Optional. Authentication type for Databricks.
+      "clientId": "A String", # Optional. OAuth client id, only applicable for authentication_type == OAUTH_M2M
+      "clientSecret": "A String", # Optional. OAuth client secret, only applicable for authentication_type == OAUTH_M2M
+      "connectionUrl": "A String", # Optional. Connection URL. e.g.: 'jdbc:databricks://adb-33934.4.azuredatabricks.net:443/default;transportMode=http;ssl=1;httpPath=sql/protocolv1/o/3393########44/0##3-7-hlrb'
+      "password": "A String", # Optional. Input only. The password used to connect to Databricks in plain text.
+      "passwordSecretVersion": "A String", # Optional. Input only. The resource name of a secret version in Secret Manager which contains the password used to connect to Databricks. Format: projects/{project}/secrets/{secret}/versions/{version}.
+      "storageCredential": "A String", # Optional. External storage credential name to access files on object storage such as ADLS Gen2, S3 or Cloud Storage.
+      "technologyType": "A String", # Optional. The technology type of DatabricksConnection.
+    },
+    "db2ConnectionProperties": { # The properties of GoldengateDb2Connection. # Properties for a DB2 connection.
+      "additionalAttributes": [ # Optional. An array of name-value pair attribute entries. Used as additional parameters in connection string.
+        { # A name-value pair representing an attribute entry usable in a list of attributes.
+          "key": "A String", # Required. The name of the property entry.
+          "value": "A String", # Required. The value of the property entry.
+        },
+      ],
+      "database": "A String", # Optional. The name of the database.
+      "host": "A String", # Optional. The name or address of a host.
+      "password": "A String", # Optional. Input only. The password Oracle Goldengate uses for Db2 connection in plain text.
+      "passwordSecretVersion": "A String", # Optional. Input only. The resource name of a secret version in Secret Manager which contains the password Oracle Goldengate uses for Db2 connection. Format: projects/{project}/secrets/{secret}/versions/{version}.
+      "port": 42, # Optional. The port of an endpoint usually specified for a connection.
+      "securityProtocol": "A String", # Optional. Security protocol for the DB2 database.
+      "sslClientKeystashFile": "A String", # Optional. The keystash file which contains the encrypted password to the key database file. Not supported for IBM Db2 for i.
+      "sslClientKeystoredbFile": "A String", # Optional. The keystore file created at the client containing the server certificate / CA root certificate. Not supported for IBM Db2 for i.
+      "sslServerCertificateFile": "A String", # Optional. The file which contains the self-signed server certificate / Certificate Authority (CA) certificate.
+      "technologyType": "A String", # Optional. The technology type of Db2Connection.
+      "username": "A String", # Optional. The username Oracle Goldengate uses to connect to the DB2 database.
+    },
+    "description": "A String", # Optional. Metadata about this specific object.
+    "displayName": "A String", # Required. An object's Display Name.
+    "elasticsearchConnectionProperties": { # The properties of GoldengateElasticsearchConnection. # Properties for an Elasticsearch connection.
+      "authenticationType": "A String", # Optional. Authentication type for Elasticsearch.
+      "fingerprint": "A String", # Optional. Fingerprint required by TLS security protocol. Eg.: '6152b2dfbff200f973c5074a5b91d06ab3b472c07c09a1ea57bb7fd406cdce9c'
+      "password": "A String", # Optional. Input only. The password Oracle Goldengate uses for Elastic Search connection in plain text.
+      "passwordSecretVersion": "A String", # Optional. Input only. The resource name of a secret version in Secret Manager which contains the password Oracle Goldengate uses for Elastic Search connection. Format: projects/{project}/secrets/{secret}/versions/{version}.
+      "securityProtocol": "A String", # Optional. Security protocol for Elasticsearch.
+      "servers": "A String", # Optional. Comma separated list of Elasticsearch server addresses, specified as host:port entries, where :port is optional. If port is not specified, it defaults to 9200. Example: "server1.example.com:4000,server2.example.com:4000"
+      "technologyType": "A String", # Optional. The technology type of ElasticsearchConnection.
+      "username": "A String", # Optional. The username Oracle Goldengate uses to connect the associated system of the given technology.
+    },
+    "genericConnectionProperties": { # The properties of GoldengateGenericConnectionProperties. # Properties for a Generic Connection.
+      "host": "A String", # Optional. The host of the GenericConnection.
+      "technologyType": "A String", # Optional. The technology type.
+    },
+    "goldengateConnectionProperties": { # The properties of GoldengateGoldengateConnectionProperties. # Properties for a Goldengate Connection.
+      "goldengateDeploymentId": "A String", # Optional. The name of the GoldengateDeployment associated with the GoldengateConnection. Format: projects/{project}/locations/{location}/goldengateDeployments/{goldengate_deployment}
+      "host": "A String", # Optional. The host of the GoldengateConnection.
+      "password": "A String", # Optional. Input only. The password used to connect to the Oracle Goldengate in plain text.
+      "passwordSecretVersion": "A String", # Optional. Input only. The resource name of a secret version in Secret Manager which contains the password used to connect to the Oracle Goldengate. Format: projects/{project}/secrets/{secret}/versions/{version}.
+      "port": 42, # Optional. The port of the GoldengateConnection.
+      "technologyType": "A String", # Optional. The technology type.
+      "username": "A String", # Optional. The username credential.
+    },
+    "googleBigQueryConnectionProperties": { # The properties of GoldengateGoogleBigQueryConnectionProperties. # Properties for a Google BigQuery Connection.
+      "serviceAccountKeyFile": "A String", # Optional. The base64 encoded content of the service account key file containing the credentials required to use Google BigQuery.
+      "technologyType": "A String", # Optional. The technology type.
+    },
+    "googleCloudStorageConnectionProperties": { # The properties of GoldengateGoogleCloudStorageConnectionProperties. # Properties for a Google Cloud Storage Connection.
+      "serviceAccountKeyFile": "A String", # Optional. The base64 encoded content of the service account key file containing the credentials required to use Google Cloud Storage.
+      "technologyType": "A String", # Optional. The technology type.
+    },
+    "googlePubsubConnectionProperties": { # The properties of GoldengateGooglePubsubConnection. # Properties for a Google Pub/Sub connection.
+      "serviceAccountKeyFile": "A String", # Optional. The base64 encoded content of the service account key file containing the credentials required to use Google Pub/Sub.
+      "technologyType": "A String", # Optional. The technology type of GooglePubsubConnection.
+    },
+    "hdfsConnectionProperties": { # The properties of GoldengateHdfsConnection. # Properties for an HDFS connection.
+      "coreSiteXml": "A String", # Optional. The content of the Hadoop Distributed File System configuration file (core-site.xml).
+      "technologyType": "A String", # Optional. The technology type of HdfsConnection.
+    },
+    "icebergConnectionProperties": { # The properties of GoldengateIcebergConnection. # Properties for an Iceberg connection.
+      "catalog": { # The Iceberg catalog details. # Required. The Iceberg catalog.
+        "catalogType": "A String", # Required. The type of Iceberg catalog.
+        "glueIcebergCatalog": { # The Glue Iceberg catalog. # The Glue Iceberg catalog.
+          "glueId": "A String", # Required. The catalog ID of Glue.
+        },
+        "nessieIcebergCatalog": { # The Nessie Iceberg catalog. # The Nessie Iceberg catalog.
+          "branch": "A String", # Required. The Nessie branch.
+          "uri": "A String", # Required. The Nessie uri.
+        },
+        "polarisIcebergCatalog": { # The Polaris Iceberg catalog. # The Polaris Iceberg catalog.
+          "clientId": "A String", # Required. The Polaris client ID.
+          "clientSecret": "A String", # Optional. The Polaris client secret.
+          "polarisCatalog": "A String", # Required. The catalog name within Polaris.
+          "principalRole": "A String", # Required. The Polaris principal role.
+          "uri": "A String", # Required. The Polaris uri.
+        },
+        "restIcebergCatalog": { # The REST Iceberg catalog. # The REST Iceberg catalog.
+          "properties": "A String", # Optional. The base64 encoded content of the configuration file containing additional properties for the REST catalog.
+          "uri": "A String", # Required. The REST uri.
+        },
+      },
+      "storage": { # The Iceberg storage details. # Required. The Iceberg storage.
+        "amazonS3IcebergStorage": { # The Amazon S3 Iceberg storage. # The Amazon S3 Iceberg storage.
+          "accessKeyId": "A String", # Required. The access key ID of Amazon S3.
+          "bucket": "A String", # Required. The bucket of Amazon S3.
+          "endpoint": "A String", # Optional. The endpoint of Amazon S3.
+          "region": "A String", # Required. The region of Amazon S3.
+          "schemeType": "A String", # Required. The scheme type of Amazon S3.
+          "secretAccessKeySecret": "A String", # Optional. The secret access key of Amazon S3.
+        },
+        "azureDataLakeStorageIcebergStorage": { # The Azure Data Lake Storage Iceberg storage. # The Azure Data Lake Storage Iceberg storage.
+          "accountKeySecret": "A String", # Optional. The account key of Azure Data Lake Storage.
+          "azureAccount": "A String", # Required. The account of Azure Data Lake Storage.
+          "container": "A String", # Required. The container of Azure Data Lake Storage.
+          "endpoint": "A String", # Optional. The endpoint of Azure Data Lake Storage.
+        },
+        "googleCloudStorageIcebergStorage": { # The Google Cloud Storage Iceberg storage. # The Google Cloud Storage Iceberg storage.
+          "bucket": "A String", # Required. The bucket of Google Cloud Storage.
+          "projectId": "A String", # Required. The project ID of Google Cloud Storage.
+          "serviceAccountKeyFile": "A String", # Optional. The base64 encoded content of the service account key file of Google Cloud Storage.
+        },
+        "storageType": "A String", # Required. The type of Iceberg storage.
+      },
+      "technologyType": "A String", # Required. The technology type of Iceberg connection.
+    },
+    "ingressIpAddresses": [ # Output only. The Ingress IPs of the GoldengateConnection.
+      "A String",
+    ],
+    "javaMessageServiceConnectionProperties": { # The properties of GoldengateJavaMessageServiceConnection. # Properties for a Java Message Service connection.
+      "authenticationType": "A String", # Optional. Authentication type for Java Message Service.
+      "connectionFactory": "A String", # Optional. The Java class implementing javax.jms.ConnectionFactory interface supplied by the JMS provider.
+      "connectionUrl": "A String", # Optional. Connection URL of the Java Message Service, specifying the protocol, host, and port. e.g.: 'mq://myjms.host.domain:7676'
+      "jndiConnectionFactory": "A String", # Optional. The Connection Factory can be looked up using this name. e.g.: 'ConnectionFactory'
+      "jndiInitialContextFactory": "A String", # Optional. The implementation of javax.naming.spi.InitialContextFactory interface used to obtain initial naming context.
+      "jndiProviderUrl": "A String", # Optional. The URL that Java Message Service will use to contact the JNDI provider. e.g.: 'tcp://myjms.host.domain:61616?jms.prefetchPolicy.all=1000'
+      "jndiSecurityCredentialsSecret": "A String", # Optional. The password associated to the principal.
+      "jndiSecurityPrincipal": "A String", # Optional. Specifies the identity of the principal (user) to be authenticated.
+      "keyStoreFile": "A String", # Optional. The base64 encoded content of the KeyStore file.
+      "keyStorePassword": "A String", # Optional. Input only. The KeyStore password in plain text.
+      "keyStorePasswordSecretVersion": "A String", # Optional. Input only. The resource name of a secret version in Secret Manager which contains the KeyStore password. Format: projects/{project}/secrets/{secret}/versions/{version}.
+      "password": "A String", # Optional. Input only. The password Oracle Goldengate uses to connect the Java Message Service in plain text.
+      "passwordSecretVersion": "A String", # Optional. Input only. The resource name of a secret version in Secret Manager which contains the password Oracle Goldengate uses to connect the associated Java Message Service. Format: projects/{project}/secrets/{secret}/versions/{version}.
+      "securityProtocol": "A String", # Optional. Security protocol for Java Message Service.
+      "sslKeyPassword": "A String", # Optional. Input only. The password for the cert inside of the KeyStore in plain text.
+      "sslKeyPasswordSecretVersion": "A String", # Optional. Input only. The resource name of a secret version in Secret Manager which contains the password for the cert inside of the KeyStore. Format: projects/{project}/secrets/{secret}/versions/{version}.
+      "technologyType": "A String", # Optional. The technology type of JavaMessageServiceConnection.
+      "trustStoreFile": "A String", # Optional. The base64 encoded content of the TrustStore file.
+      "trustStorePassword": "A String", # Optional. Input only. The TrustStore password in plain text.
+      "trustStorePasswordSecretVersion": "A String", # Optional. Input only. The resource name of a secret version in Secret Manager which contains the TrustStore password. Format: projects/{project}/secrets/{secret}/versions/{version}.
+      "useJndi": True or False, # Optional. If set to true, Java Naming and Directory Interface (JNDI) properties should be provided.
+      "username": "A String", # Optional. The username Oracle Goldengate uses to connect to the Java Message Service.
+    },
+    "kafkaConnectionProperties": { # The properties of GoldengateKafkaConnection. # Properties for a Kafka Connection.
+      "bootstrapServers": [ # Optional. Kafka bootstrap. Equivalent of bootstrap.servers configuration property in Kafka: list of KafkaBootstrapServer objects specified by host/port. Used for establishing the initial connection to the Kafka cluster. Example: "server1.example.com:9092,server2.example.com:9092"
+        { # Represents a Kafka bootstrap server with host name, optional port defaults to 9092, and an optional private ip.
+          "host": "A String", # Required. The name or address of a host.
+          "port": 42, # Optional. The port of an endpoint usually specified for a connection.
+          "privateIpAddress": "A String", # Optional. The private IP address of the connection's endpoint in the customer's VCN, typically a database endpoint or a big data endpoint (e.g. Kafka bootstrap server). In case the privateIp is provided, the subnetId must also be provided. In case the privateIp (and the subnetId) is not provided it is assumed the datasource is publicly accessible. In case the connection is accessible only privately, the lack of privateIp will result in not being able to access the connection.
+        },
+      ],
+      "clusterId": "A String", # Optional. The OCID of the Kafka cluster being referenced from OCI Streaming with Apache Kafka.
+      "consumerPropertiesFile": "A String", # Optional. The base64 encoded content of the consumer.properties file.
+      "keyStoreFile": "A String", # Optional. The base64 encoded content of the KeyStore file.
+      "keyStorePassword": "A String", # Optional. Input only. The KeyStore password in plain text.
+      "keyStorePasswordSecretVersion": "A String", # Optional. Input only. The resource name of a secret version in Secret Manager which contains the KeyStore password. Format: projects/{project}/secrets/{secret}/versions/{version}.
+      "password": "A String", # Optional. Input only. The password for Kafka basic/SASL auth in plain text.
+      "passwordSecretVersion": "A String", # Optional. Input only. The resource name of a secret version in Secret Manager which contains the password for Kafka basic/SASL auth. Format: projects/{project}/secrets/{secret}/versions/{version}.
+      "producerPropertiesFile": "A String", # Optional. The base64 encoded content of the producer.properties file.
+      "securityProtocol": "A String", # Optional. Security Type for Kafka.
+      "sslKeyPassword": "A String", # Optional. Input only. The password for the cert inside of the KeyStore in plain text.
+      "sslKeyPasswordSecretVersion": "A String", # Optional. Input only. The resource name of a secret version in Secret Manager which contains the password for the cert inside of the KeyStore. Format: projects/{project}/secrets/{secret}/versions/{version}.
+      "streamPoolId": "A String", # Optional. The OCID of the stream pool being referenced.
+      "technologyType": "A String", # Optional. The technology type of KafkaConnection.
+      "trustStoreFile": "A String", # Optional. The base64 encoded content of the TrustStore file.
+      "trustStorePassword": "A String", # Optional. Input only. The TrustStore password in plain text.
+      "trustStorePasswordSecretVersion": "A String", # Optional. Input only. The resource name of a secret version in Secret Manager which contains the TrustStore password. Format: projects/{project}/secrets/{secret}/versions/{version}.
+      "useResourcePrincipal": True or False, # Optional. Specifies that the user intends to authenticate to the instance using a resource principal. Applicable only for OCI Streaming connections.
+      "username": "A String", # Optional. The username Oracle Goldengate uses to connect the associated system of the given technology.
+    },
+    "kafkaSchemaRegistryConnectionProperties": { # The properties of GoldengateKafkaSchemaRegistryConnection. # Properties for a Kafka Schema Registry Connection.
+      "authenticationType": "A String", # Optional. Used authentication mechanism to access Schema Registry.
+      "keyStoreFile": "A String", # Optional. The base64 encoded content of the KeyStore file.
+      "keyStorePassword": "A String", # Optional. Input only. The KeyStore password in plain text.
+      "keyStorePasswordSecretVersion": "A String", # Optional. Input only. The resource name of a secret version in Secret Manager which contains the KeyStore password. Format: projects/{project}/secrets/{secret}/versions/{version}.
+      "password": "A String", # Optional. Input only. The password to access Schema Registry in plain text.
+      "passwordSecretVersion": "A String", # Optional. Input only. The resource name of a secret version in Secret Manager which contains the password to access Schema Registry using basic authentication. Format: projects/{project}/secrets/{secret}/versions/{version}.
+      "sslKeyPassword": "A String", # Optional. Input only. The password for the cert inside the KeyStore in plain text.
+      "sslKeyPasswordSecretVersion": "A String", # Optional. Input only. The resource name of a secret version in Secret Manager which contains the password for the cert inside the KeyStore. Format: projects/{project}/secrets/{secret}/versions/{version}.
+      "technologyType": "A String", # Optional. The technology type of KafkaSchemaRegistryConnection.
+      "trustStoreFile": "A String", # Optional. The base64 encoded content of the TrustStore file.
+      "trustStorePassword": "A String", # Optional. Input only. The TrustStore password in plain text.
+      "trustStorePasswordSecretVersion": "A String", # Optional. Input only. The resource name of a secret version in Secret Manager which contains the TrustStore password. Format: projects/{project}/secrets/{secret}/versions/{version}.
+      "url": "A String", # Optional. Kafka Schema Registry URL. e.g.: 'https://server1.us.oracle.com:8081'
+      "username": "A String", # Optional. The username to access Schema Registry using basic authentication. This value is injected into 'schema.registry.basic.auth.user.info=user:password' configuration property.
+    },
+    "lifecycleDetails": "A String", # Output only. Describes the object's current state in detail. For example, it can be used to provide actionable information for a resource in a Failed state.
+    "lifecycleState": "A String", # Output only. The lifecycle state of the connection.
+    "microsoftFabricConnectionProperties": { # The properties of GoldengateMicrosoftFabricConnection. # Properties for a Microsoft Fabric connection.
+      "clientId": "A String", # Optional. Azure client ID of the application.
+      "clientSecret": "A String", # Optional. Client secret associated with the client id.
+      "endpoint": "A String", # Optional. Optional Microsoft Fabric service endpoint. Default value: https://onelake.dfs.fabric.microsoft.com
+      "technologyType": "A String", # Optional. The technology type of MicrosoftFabricConnection.
+      "tenantId": "A String", # Optional. Azure tenant ID of the application.
+    },
+    "microsoftSqlserverConnectionProperties": { # The properties of GoldengateMicrosoftSqlserverConnection. # Properties for a Microsoft SQL Server connection.
+      "additionalAttributes": [ # Optional. An array of name-value pair attribute entries. Used as additional parameters in connection string.
+        { # A name-value pair representing an attribute entry usable in a list of attributes.
+          "key": "A String", # Required. The name of the property entry.
+          "value": "A String", # Required. The value of the property entry.
+        },
+      ],
+      "database": "A String", # Optional. The name of the database.
+      "host": "A String", # Optional. The name or address of a host.
+      "password": "A String", # Optional. Input only. The password Oracle Goldengate uses for Microsoft SQL Server connection in plain text.
+      "passwordSecretVersion": "A String", # Optional. Input only. The resource name of a secret version in Secret Manager which contains the password Oracle Goldengate uses for Microsoft SQL Server connection. Format: projects/{project}/secrets/{secret}/versions/{version}.
+      "port": 42, # Optional. The port of an endpoint usually specified for a connection.
+      "securityProtocol": "A String", # Optional. Security Type for Microsoft SQL Server.
+      "serverCertificateValidationRequired": True or False, # Optional. If set to true, the driver validates the certificate that is sent by the database server.
+      "sslCaFile": "A String", # Optional. Database Certificate - The base64 encoded content of a .pem or .crt file containing the server public key (for 1-way SSL).
+      "technologyType": "A String", # Optional. The technology type of MicrosoftSqlserverConnection.
+      "username": "A String", # Optional. The username Oracle Goldengate uses to connect to the Microsoft SQL Server.
+    },
+    "mongodbConnectionProperties": { # The properties of GoldengateMongodbConnection. # Properties for a MongoDB connection.
+      "connectionString": "A String", # Optional. MongoDB connection string. e.g.: 'mongodb://mongodb0.example.com:27017/recordsrecords'
+      "databaseId": "A String", # Optional. The OCID of the Oracle Autonomous Json Database.
+      "password": "A String", # Optional. Input only. The password Oracle Goldengate uses to connect the Mongodb connection in plain text.
+      "passwordSecretVersion": "A String", # Optional. Input only. The resource name of a secret version in Secret Manager which contains the password Oracle Goldengate uses to connect the Mongodb connection. Format: projects/{project}/secrets/{secret}/versions/{version}.
+      "securityProtocol": "A String", # Optional. Security Type for MongoDB.
+      "technologyType": "A String", # Optional. The technology type of MongodbConnection.
+      "tlsCaFile": "A String", # Optional. Database Certificate - The base64 encoded content of a .pem file, containing the server public key (for 1 and 2-way SSL).
+      "tlsCertificateKeyFile": "A String", # Optional. Client Certificate - The base64 encoded content of a .pem file, containing the client public key (for 2-way SSL).
+      "tlsCertificateKeyFilePassword": "A String", # Optional. Input only. The Client Certificate key file password in plain text.
+      "tlsCertificateKeyFilePasswordSecretVersion": "A String", # Optional. Input only. The resource name of a secret version in Secret Manager which contains the Client Certificate key file password in Secret Manager. Format: projects/{project}/secrets/{secret}/versions/{version}.
+      "username": "A String", # Optional. The username Oracle Goldengate uses to connect to the database.
+    },
+    "mysqlConnectionProperties": { # Properties of GoldengateMysqlConnection. # Properties for a Mysql Connection.
+      "additionalAttributes": [ # Optional. An array of name-value pair attribute entries. Used as additional parameters in connection string.
+        { # A name-value pair representing an attribute entry usable in a list of attributes.
+          "key": "A String", # Required. The name of the property entry.
+          "value": "A String", # Required. The value of the property entry.
+        },
+      ],
+      "database": "A String", # Optional. The name of the database.
+      "dbSystemId": "A String", # Optional. The OCID of the database system being referenced.
+      "host": "A String", # Optional. The name or address of a host.
+      "password": "A String", # Optional. Input only. The password Oracle Goldengate uses to connect to MySQL in plain text.
+      "passwordSecretVersion": "A String", # Optional. Input only. The resource name of a secret version in Secret Manager which contains the password Oracle Goldengate uses to connect to MySQL. Format: projects/{project}/secrets/{secret}/versions/{version}.
+      "port": 42, # Optional. The port of an endpoint usually specified for a connection.
+      "securityProtocol": "A String", # Optional. Security Type for MySQL.
+      "sslCaFile": "A String", # Optional. Database Certificate - The base64 encoded content of a .pem or .crt file containing the server public key (for 1 and 2-way SSL).
+      "sslCertFile": "A String", # Optional. Client Certificate - The base64 encoded content of a .pem or .crt file containing the client public key (for 2-way SSL).
+      "sslCrlFile": "A String", # Optional. The base64 encoded list of certificates revoked by the trusted certificate authorities (Trusted CA).
+      "sslKeyFile": "A String", # Optional. Client Key - The base64 encoded content of a .pem or .crt file containing the client private key (for 2-way SSL).
+      "sslMode": "A String", # Optional. SSL modes for MySQL.
+      "technologyType": "A String", # Optional. The technology type of MysqlConnection.
+      "username": "A String", # Optional. The username Oracle Goldengate uses to connect the associated system of the given technology.
+    },
+    "ociObjectStorageConnectionProperties": { # The properties of GoldengateOciObjectStorageConnection. # Properties for an OCI Object Storage Connection.
+      "privateKeyFile": "A String", # Optional. The content of the private key file (PEM file) corresponding to the API key of the fingerprint.
+      "privateKeyPassphraseSecret": "A String", # Optional. The passphrase of the private key.
+      "publicKeyFingerprint": "A String", # Optional. The fingerprint of the API Key of the user specified by the userId.
+      "region": "A String", # Optional. The name of the region of OCI Object Storage. e.g.: us-ashburn-1 If the region is not provided, backend will default to the default region.
+      "technologyType": "A String", # Optional. The technology type of OciObjectStorageConnection.
+      "tenancyId": "A String", # Optional. The OCID of the related OCI tenancy.
+      "useResourcePrincipal": True or False, # Optional. Specifies that the user intends to authenticate to the instance using a resource principal.
+      "userId": "A String", # Optional. The OCID of the OCI user who will access the Object Storage. The user must have write access to the bucket they want to connect to.
+    },
+    "ocid": "A String", # Output only. The [OCID] of the connection being referenced.
+    "oracleAiDataPlatformConnectionProperties": { # The properties of GoldengateOracleAIDataPlatformConnection. # Properties for an Oracle AI Data Platform connection.
+      "connectionUrl": "A String", # Optional. Connection URL. It must start with 'jdbc:spark://'
+      "privateKeyFile": "A String", # Optional. The content of the private key file (PEM file) corresponding to the API key of the fingerprint.
+      "privateKeyPassphraseSecret": "A String", # Optional. The passphrase of the private key.
+      "publicKeyFingerprint": "A String", # Optional. The fingerprint of the API Key of the user specified by the user_id.
+      "region": "A String", # Optional. The name of the region. e.g.: us-ashburn-1
+      "technologyType": "A String", # Optional. The technology type of OracleAiDataPlatformConnection.
+      "tenancyId": "A String", # Optional. The OCID of the related OCI tenancy.
+      "useResourcePrincipal": True or False, # Optional. Specifies that the user intends to authenticate to the instance using a resource principal.
+      "userId": "A String", # Optional. The OCID of the OCI user who will access.
+    },
+    "oracleConnectionProperties": { # The properties of Goldengate Oracle Database Connection. # Properties for an Oracle Database Connection.
+      "authenticationMode": "A String", # Optional. Authentication mode.
+      "connectionString": "A String", # Optional. Connect descriptor or Easy Connect Naming method used to connect to a database.
+      "gcpOracleDatabaseId": "A String", # Optional. Autonomous AI Database instance id of database in Oracle Database @ Google Cloud. If gcp_oracle_database_id is provided, connection_string must be empty. Format: projects/{project}/locations/{location}/autonomousDatabases/{autonomous_database}
+      "password": "A String", # Optional. Input only. The password Oracle Goldengate uses in plain text.
+      "passwordSecretVersion": "A String", # Optional. Input only. The resource name of a secret version in Secret Manager which contains the password Oracle Goldengate uses. Format: projects/{project}/secrets/{secret}/versions/{version}.
+      "sessionMode": "A String", # Optional. The mode of the database connection session to be established by the data client.
+      "technologyType": "A String", # Optional. The technology type.
+      "username": "A String", # Optional. The username Oracle Goldengate uses to connect.
+      "walletFile": "A String", # Optional. The wallet contents Oracle Goldengate uses to make connections to a database. This attribute is expected to be base64 encoded.
+    },
+    "oracleNosqlConnectionProperties": { # The properties of GoldengateOracleNosqlConnection. # Properties for an Oracle NoSQL connection.
+      "privateKeyFile": "A String", # Optional. The content of the private key file (PEM file) corresponding to the API key of the fingerprint.
+      "privateKeyPassphraseSecret": "A String", # Optional. The passphrase of the private key.
+      "publicKeyFingerprint": "A String", # Optional. The fingerprint of the API Key of the user specified by the userId.
+      "region": "A String", # Optional. The name of the region. e.g.: us-ashburn-1
+      "technologyType": "A String", # Optional. The technology type of OracleNosqlConnection.
+      "tenancyId": "A String", # Optional. The OCID of the OCI tenancy.
+      "useResourcePrincipal": True or False, # Optional. Specifies that the user intends to authenticate to the instance using a resource principal.
+      "userId": "A String", # Optional. The OCID of the OCI user who will access the Oracle NoSQL database.
+    },
+    "postgresqlConnectionProperties": { # The properties of GoldengatePostgresqlConnection. # Properties for a PostgreSQL connection.
+      "additionalAttributes": [ # Optional. An array of name-value pair attribute entries. Used as additional parameters in connection string.
+        { # A name-value pair representing an attribute entry usable in a list of attributes.
+          "key": "A String", # Required. The name of the property entry.
+          "value": "A String", # Required. The value of the property entry.
+        },
+      ],
+      "database": "A String", # Optional. The name of the database.
+      "dbSystemId": "A String", # Optional. The OCID of the database system being referenced.
+      "host": "A String", # Optional. The name or address of a host.
+      "password": "A String", # Optional. Input only. The password Oracle Goldengate uses for PostgreSQL connection in plain text.
+      "passwordSecretVersion": "A String", # Optional. Input only. The resource name of a secret version in Secret Manager which contains the password Oracle Goldengate uses for PostgreSQL connection. Format: projects/{project}/secrets/{secret}/versions/{version}.
+      "port": 42, # Optional. The port of an endpoint usually specified for a connection.
+      "securityProtocol": "A String", # Optional. Security protocol for PostgreSQL.
+      "sslCaFile": "A String", # Optional. The base64 encoded certificate of the trusted certificate authorities (Trusted CA) for PostgreSQL.
+      "sslCertFile": "A String", # Optional. The base64 encoded certificate of the PostgreSQL server.
+      "sslCrlFile": "A String", # Optional. The base64 encoded list of certificates revoked by the trusted certificate authorities (Trusted CA).
+      "sslKeyFile": "A String", # Optional. The base64 encoded private key of the PostgreSQL server.
+      "sslMode": "A String", # Optional. SSL modes for PostgreSQL.
+      "technologyType": "A String", # Optional. The technology type of PostgresqlConnection.
+      "username": "A String", # Optional. The username Oracle Goldengate uses to connect the associated system of the given technology.
+    },
+    "redisConnectionProperties": { # The properties of GoldengateRedisConnection. # Properties for a Redis connection.
+      "authenticationType": "A String", # Optional. Authentication type for Redis.
+      "keyStoreFile": "A String", # Optional. The base64 encoded content of the KeyStore file.
+      "keyStorePassword": "A String", # Optional. Input only. The KeyStore password in plain text.
+      "keyStorePasswordSecretVersion": "A String", # Optional. Input only. The resource name of a secret version in Secret Manager which contains the KeyStore password. Format: projects/{project}/secrets/{secret}/versions/{version}.
+      "password": "A String", # Optional. Input only. The password Oracle Goldengate uses for Redis connection in plain text.
+      "passwordSecretVersion": "A String", # Optional. Input only. The resource name of a secret version in Secret Manager which contains the password Oracle Goldengate uses for Redis connection. Format: projects/{project}/secrets/{secret}/versions/{version}.
+      "redisClusterId": "A String", # Optional. The OCID of the Redis cluster.
+      "securityProtocol": "A String", # Optional. Security protocol for Redis.
+      "servers": "A String", # Optional. Comma separated list of Redis server addresses, specified as host:port entries, where :port is optional. If port is not specified, it defaults to 6379. Example: "server1.example.com:6379,server2.example.com:6379"
+      "technologyType": "A String", # Optional. The technology type of RedisConnection.
+      "trustStoreFile": "A String", # Optional. The base64 encoded content of the TrustStore file.
+      "trustStorePassword": "A String", # Optional. Input only. The TrustStore password in plain text.
+      "trustStorePasswordSecretVersion": "A String", # Optional. Input only. The resource name of a secret version in Secret Manager which contains the TrustStore password. Format: projects/{project}/secrets/{secret}/versions/{version}.
+      "username": "A String", # Optional. The username Oracle Goldengate uses to connect the associated system of the given technology.
+    },
+    "routingMethod": "A String", # Optional. The routing method for the GoldengateConnection.
+    "snowflakeConnectionProperties": { # The properties of GoldengateSnowflakeConnection. # Properties for a Snowflake connection.
+      "authenticationType": "A String", # Optional. Used authentication mechanism to access Snowflake.
+      "connectionUrl": "A String", # Optional. JDBC connection URL. e.g.: 'jdbc:snowflake://.snowflakecomputing.com/?warehouse=&db='
+      "password": "A String", # Optional. Input only. The password Oracle Goldengate uses to connect to Snowflake platform in plain text.
+      "passwordSecretVersion": "A String", # Optional. Input only. The resource name of a secret version in Secret Manager which contains the password Oracle Goldengate uses to connect to Snowflake platform. Format: projects/{project}/secrets/{secret}/versions/{version}.
+      "privateKeyFile": "A String", # Optional. The content of private key file in PEM format.
+      "privateKeyPassphraseSecret": "A String", # Optional. Password if the private key file is encrypted.
+      "technologyType": "A String", # Optional. The technology type of SnowflakeConnection.
+      "username": "A String", # Optional. The username Oracle Goldengate uses to connect to Snowflake.
+    },
+    "updateTime": "A String", # Output only. The time the resource was last updated.
+  },
+}
+
+  requestId: string, Optional. An optional ID to identify the request. This value is used to identify duplicate requests. If you make a request with the same request ID and the original request is still in progress or completed, the server 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. A mask specifying which fields in the GoldengateConnection should be updated. A field specified in the mask is updated. If a mask isn't provided, the service treats this as an implied field mask equivalent to all fields that are populated (have a non-empty value). To clear or unset a field, the field must be explicitly specified in the `update_mask`.
+  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/oracledatabase_v1.projects.locations.goldengateDeployments.html b/docs/dyn/oracledatabase_v1.projects.locations.goldengateDeployments.html index 9e83df0434..f8faf84721 100644 --- a/docs/dyn/oracledatabase_v1.projects.locations.goldengateDeployments.html +++ b/docs/dyn/oracledatabase_v1.projects.locations.goldengateDeployments.html @@ -92,6 +92,9 @@

Instance Methods

list_next(previous_request, previous_response)

Retrieves the next page of results.

+

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

+

Updates the `labels` of a single GoldengateDeployment.

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

Starts a single GoldengateDeployment.

@@ -115,17 +118,17 @@

Method Details

{ # GoldengateDeployment Goldengate Deployment resource model. "createTime": "A String", # Output only. The date and time that the GoldengateDeployment was created. - "displayName": "A String", # Required. The display name for the GoldengateDeployment. + "displayName": "A String", # Required. Immutable. The display name for the GoldengateDeployment. "entitlementId": "A String", # Output only. The ID of the subscription entitlement associated with the GoldengateDeployment - "gcpOracleZone": "A String", # Optional. The GCP Oracle zone where Oracle GoldengateDeployment is hosted. Example: us-east4-b-r2. If not specified, the system will pick a zone based on availability. + "gcpOracleZone": "A String", # Optional. Immutable. The GCP Oracle zone where Oracle GoldengateDeployment is hosted. Example: us-east4-b-r2. If not specified, the system will pick a zone based on availability. "labels": { # Optional. The labels or tags associated with the GoldengateDeployment. "a_key": "A String", }, "name": "A String", # Identifier. The name of the GoldengateDeployment resource in the following format: projects/{project}/locations/{region}/goldengateDeployments/{goldengate_deployment} "ociUrl": "A String", # Output only. HTTPS link to OCI resources exposed to Customer via UI Interface. - "odbNetwork": "A String", # Optional. The name of the OdbNetwork associated with the GoldengateDeployment. - "odbSubnet": "A String", # Required. The name of the OdbSubnet associated with the GoldengateDeployment for IP allocation. - "properties": { # Properties of GoldengateDeployment. # Required. The properties of the GoldengateDeployment. + "odbNetwork": "A String", # Optional. Immutable. The name of the OdbNetwork associated with the GoldengateDeployment. + "odbSubnet": "A String", # Required. Immutable. The name of the OdbSubnet associated with the GoldengateDeployment for IP allocation. + "properties": { # Properties of GoldengateDeployment. # Required. Immutable. The properties of the GoldengateDeployment. "backupSchedule": { # The backup schedule of the GoldengateDeployment. # Output only. The backup schedule of the GoldengateDeployment. "backupScheduledTime": "A String", # Output only. The timestamp of when the backup was scheduled. "bucket": "A String", # Output only. The bucket name. @@ -197,7 +200,7 @@

Method Details

], "ocid": "A String", # Output only. OCID of the GoldengateDeployment. "oggData": { # The Ogg data of the GoldengateDeployment. # Required. The ogg data of the GoldengateDeployment. - "adminPassword": "A String", # Optional. The Goldengate deployment console password in plain text. + "adminPassword": "A String", # Optional. Input only. The Goldengate deployment console password in plain text. "adminPasswordSecretVersion": "A String", # Optional. Input only. The Goldengate deployment console password secret version. "adminUsername": "A String", # Required. The Goldengate deployment console username. "certificate": "A String", # Output only. The certificate of the GoldengateDeployment. @@ -312,17 +315,17 @@

Method Details

{ # GoldengateDeployment Goldengate Deployment resource model. "createTime": "A String", # Output only. The date and time that the GoldengateDeployment was created. - "displayName": "A String", # Required. The display name for the GoldengateDeployment. + "displayName": "A String", # Required. Immutable. The display name for the GoldengateDeployment. "entitlementId": "A String", # Output only. The ID of the subscription entitlement associated with the GoldengateDeployment - "gcpOracleZone": "A String", # Optional. The GCP Oracle zone where Oracle GoldengateDeployment is hosted. Example: us-east4-b-r2. If not specified, the system will pick a zone based on availability. + "gcpOracleZone": "A String", # Optional. Immutable. The GCP Oracle zone where Oracle GoldengateDeployment is hosted. Example: us-east4-b-r2. If not specified, the system will pick a zone based on availability. "labels": { # Optional. The labels or tags associated with the GoldengateDeployment. "a_key": "A String", }, "name": "A String", # Identifier. The name of the GoldengateDeployment resource in the following format: projects/{project}/locations/{region}/goldengateDeployments/{goldengate_deployment} "ociUrl": "A String", # Output only. HTTPS link to OCI resources exposed to Customer via UI Interface. - "odbNetwork": "A String", # Optional. The name of the OdbNetwork associated with the GoldengateDeployment. - "odbSubnet": "A String", # Required. The name of the OdbSubnet associated with the GoldengateDeployment for IP allocation. - "properties": { # Properties of GoldengateDeployment. # Required. The properties of the GoldengateDeployment. + "odbNetwork": "A String", # Optional. Immutable. The name of the OdbNetwork associated with the GoldengateDeployment. + "odbSubnet": "A String", # Required. Immutable. The name of the OdbSubnet associated with the GoldengateDeployment for IP allocation. + "properties": { # Properties of GoldengateDeployment. # Required. Immutable. The properties of the GoldengateDeployment. "backupSchedule": { # The backup schedule of the GoldengateDeployment. # Output only. The backup schedule of the GoldengateDeployment. "backupScheduledTime": "A String", # Output only. The timestamp of when the backup was scheduled. "bucket": "A String", # Output only. The bucket name. @@ -394,7 +397,7 @@

Method Details

], "ocid": "A String", # Output only. OCID of the GoldengateDeployment. "oggData": { # The Ogg data of the GoldengateDeployment. # Required. The ogg data of the GoldengateDeployment. - "adminPassword": "A String", # Optional. The Goldengate deployment console password in plain text. + "adminPassword": "A String", # Optional. Input only. The Goldengate deployment console password in plain text. "adminPasswordSecretVersion": "A String", # Optional. Input only. The Goldengate deployment console password secret version. "adminUsername": "A String", # Required. The Goldengate deployment console username. "certificate": "A String", # Output only. The certificate of the GoldengateDeployment. @@ -449,17 +452,17 @@

Method Details

"goldengateDeployments": [ # The list of GoldengateDeployments. { # GoldengateDeployment Goldengate Deployment resource model. "createTime": "A String", # Output only. The date and time that the GoldengateDeployment was created. - "displayName": "A String", # Required. The display name for the GoldengateDeployment. + "displayName": "A String", # Required. Immutable. The display name for the GoldengateDeployment. "entitlementId": "A String", # Output only. The ID of the subscription entitlement associated with the GoldengateDeployment - "gcpOracleZone": "A String", # Optional. The GCP Oracle zone where Oracle GoldengateDeployment is hosted. Example: us-east4-b-r2. If not specified, the system will pick a zone based on availability. + "gcpOracleZone": "A String", # Optional. Immutable. The GCP Oracle zone where Oracle GoldengateDeployment is hosted. Example: us-east4-b-r2. If not specified, the system will pick a zone based on availability. "labels": { # Optional. The labels or tags associated with the GoldengateDeployment. "a_key": "A String", }, "name": "A String", # Identifier. The name of the GoldengateDeployment resource in the following format: projects/{project}/locations/{region}/goldengateDeployments/{goldengate_deployment} "ociUrl": "A String", # Output only. HTTPS link to OCI resources exposed to Customer via UI Interface. - "odbNetwork": "A String", # Optional. The name of the OdbNetwork associated with the GoldengateDeployment. - "odbSubnet": "A String", # Required. The name of the OdbSubnet associated with the GoldengateDeployment for IP allocation. - "properties": { # Properties of GoldengateDeployment. # Required. The properties of the GoldengateDeployment. + "odbNetwork": "A String", # Optional. Immutable. The name of the OdbNetwork associated with the GoldengateDeployment. + "odbSubnet": "A String", # Required. Immutable. The name of the OdbSubnet associated with the GoldengateDeployment for IP allocation. + "properties": { # Properties of GoldengateDeployment. # Required. Immutable. The properties of the GoldengateDeployment. "backupSchedule": { # The backup schedule of the GoldengateDeployment. # Output only. The backup schedule of the GoldengateDeployment. "backupScheduledTime": "A String", # Output only. The timestamp of when the backup was scheduled. "bucket": "A String", # Output only. The bucket name. @@ -531,7 +534,7 @@

Method Details

], "ocid": "A String", # Output only. OCID of the GoldengateDeployment. "oggData": { # The Ogg data of the GoldengateDeployment. # Required. The ogg data of the GoldengateDeployment. - "adminPassword": "A String", # Optional. The Goldengate deployment console password in plain text. + "adminPassword": "A String", # Optional. Input only. The Goldengate deployment console password in plain text. "adminPasswordSecretVersion": "A String", # Optional. Input only. The Goldengate deployment console password secret version. "adminUsername": "A String", # Required. The Goldengate deployment console username. "certificate": "A String", # Output only. The certificate of the GoldengateDeployment. @@ -584,6 +587,162 @@

Method Details

+
+ patch(name, body=None, requestId=None, updateMask=None, x__xgafv=None) + 
Updates the `labels` of a single GoldengateDeployment.
+
+Args:
+  name: string, Identifier. The name of the GoldengateDeployment resource in the following format: projects/{project}/locations/{region}/goldengateDeployments/{goldengate_deployment} (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # GoldengateDeployment Goldengate Deployment resource model.
+  "createTime": "A String", # Output only. The date and time that the GoldengateDeployment was created.
+  "displayName": "A String", # Required. Immutable. The display name for the GoldengateDeployment.
+  "entitlementId": "A String", # Output only. The ID of the subscription entitlement associated with the GoldengateDeployment
+  "gcpOracleZone": "A String", # Optional. Immutable. The GCP Oracle zone where Oracle GoldengateDeployment is hosted. Example: us-east4-b-r2. If not specified, the system will pick a zone based on availability.
+  "labels": { # Optional. The labels or tags associated with the GoldengateDeployment.
+    "a_key": "A String",
+  },
+  "name": "A String", # Identifier. The name of the GoldengateDeployment resource in the following format: projects/{project}/locations/{region}/goldengateDeployments/{goldengate_deployment}
+  "ociUrl": "A String", # Output only. HTTPS link to OCI resources exposed to Customer via UI Interface.
+  "odbNetwork": "A String", # Optional. Immutable. The name of the OdbNetwork associated with the GoldengateDeployment.
+  "odbSubnet": "A String", # Required. Immutable. The name of the OdbSubnet associated with the GoldengateDeployment for IP allocation.
+  "properties": { # Properties of GoldengateDeployment. # Required. Immutable. The properties of the GoldengateDeployment.
+    "backupSchedule": { # The backup schedule of the GoldengateDeployment. # Output only. The backup schedule of the GoldengateDeployment.
+      "backupScheduledTime": "A String", # Output only. The timestamp of when the backup was scheduled.
+      "bucket": "A String", # Output only. The bucket name.
+      "compartmentId": "A String", # Output only. The compartment id.
+      "frequencyBackupScheduled": "A String", # Output only. The frequency backup scheduled.
+      "metadataOnly": True or False, # Output only. If metadata only.
+      "namespace": "A String", # Output only. The namespace name.
+    },
+    "category": "A String", # Output only. The category of the GoldengateDeployment.
+    "cpuCoreCount": 42, # Optional. The Minimum number of OCPUs to be made available for this Deployment.
+    "deploymentBackupId": "A String", # Output only. The deployment backup id of the GoldengateDeployment.
+    "deploymentDiagnosticData": { # The deployment diagnostic data. # Output only. The deployment diagnostic data of the GoldengateDeployment.
+      "bucket": "A String", # Output only. The bucket name.
+      "diagnosticEndTime": "A String", # Output only. The time diagnostic end.
+      "diagnosticStartTime": "A String", # Output only. The time diagnostic start.
+      "diagnosticState": "A String", # Output only. The diagnostic state.
+      "namespace": "A String", # Output only. The namespace name.
+      "object": "A String", # Output only. The object name.
+    },
+    "deploymentRole": "A String", # Output only. The deployment role of the GoldengateDeployment.
+    "deploymentType": "A String", # Required. A valid Goldengate Deployment type. For a list of supported types, use the `ListGoldengateDeploymentTypes` operation.
+    "deploymentUrl": "A String", # Output only. The deployment url of the GoldengateDeployment.
+    "description": "A String", # Optional. The description of the GoldengateDeployment.
+    "environmentType": "A String", # Optional. The environment type of the GoldengateDeployment.
+    "fqdn": "A String", # Output only. The Fully Qualified Domain Name of the GoldengateDeployment.
+    "healthy": True or False, # Output only. Whether the GoldengateDeployment is healthy.
+    "ingressIps": [ # Output only. The ingress ips of the GoldengateDeployment.
+      { # The ingress IPs of the GoldengateDeployment.
+        "ingressIpAddress": "A String", # Output only. The ingress IP.
+      },
+    ],
+    "isAutoScalingEnabled": True or False, # Optional. Indicates if auto scaling is enabled for the Deployment's CPU core count.
+    "isLatestVersion": True or False, # Output only. Whether the GoldengateDeployment is of the latest version.
+    "isPublic": True or False, # Output only. Whether the GoldengateDeployment is public.
+    "isStorageUtilizationLimitExceeded": True or False, # Output only. Whether storage utilization limit is exceeded of the GoldengateDeployment.
+    "lastBackupScheduleTime": "A String", # Output only. The time last backup scheduled of the GoldengateDeployment.
+    "licenseModel": "A String", # Optional. The Oracle license model that applies to a Deployment.
+    "lifecycleDetails": "A String", # Output only. The lifecycle details of the GoldengateDeployment.
+    "lifecycleState": "A String", # Output only. State of the GoldengateDeployment.
+    "lifecycleSubState": "A String", # Output only. The lifecycle sub-state of the GoldengateDeployment.
+    "loadBalancerId": "A String", # Output only. The load balancer id of the GoldengateDeployment.
+    "loadBalancerSubnetId": "A String", # Output only. The load balancer subnet id of the GoldengateDeployment.
+    "locks": [ # Output only. The locks of the GoldengateDeployment.
+      { # The lock of the GoldengateDeployment.
+        "compartmentId": "A String", # Output only. The compartment id.
+        "createTime": "A String", # Output only. The time created.
+        "message": "A String", # Output only. The message.
+        "relatedResourceId": "A String", # Output only. The related resource id.
+        "type": "A String", # Output only. The type of lock.
+      },
+    ],
+    "maintenanceConfig": { # The maintenance configuration of the GoldengateDeployment. # Optional. The maintenance configuration of the GoldengateDeployment.
+      "bundleReleaseUpgradePeriodDays": 42, # Optional. Defines auto upgrade period for bundle releases. Manually configured period cannot be longer than service defined period for bundle releases. This period must be shorter or equal to major release upgrade period. Not passing this field during create will equate to using the service default.
+      "interimReleaseUpgradePeriodDays": 42, # Optional. Defines auto upgrade period for interim releases. This period must be shorter or equal to bundle release upgrade period.
+      "isInterimReleaseAutoUpgradeEnabled": True or False, # Optional. By default auto upgrade for interim releases are not enabled. If auto-upgrade is enabled for interim release, you have to specify interim_release_upgrade_period_days too.
+      "majorReleaseUpgradePeriodDays": 42, # Optional. Defines auto upgrade period for major releases. Manually configured period cannot be longer than service defined period for major releases. Not passing this field during create will equate to using the service default.
+      "securityPatchUpgradePeriodDays": 42, # Optional. Defines auto upgrade period for releases with security fix. Manually configured period cannot be longer than service defined period for security releases. Not passing this field during create will equate to using the service default.
+    },
+    "maintenanceWindow": { # The maintenance window of the GoldengateDeployment. # Optional. The maintenance window of the GoldengateDeployment.
+      "day": "A String", # Required. Days of the week.
+      "startHour": 42, # Required. Start hour for maintenance period. Hour is in UTC.
+    },
+    "nextBackupScheduleTime": "A String", # Output only. The time next backup scheduled of the GoldengateDeployment.
+    "nextMaintenanceActionType": "A String", # Output only. The next maintenance action type of the GoldengateDeployment.
+    "nextMaintenanceDescription": "A String", # Output only. The next maintenance description of the GoldengateDeployment.
+    "nextMaintenanceTime": "A String", # Output only. The time of next maintenance of the GoldengateDeployment.
+    "nsgIds": [ # Output only. The nsg ids of the GoldengateDeployment.
+      "A String",
+    ],
+    "ocid": "A String", # Output only. OCID of the GoldengateDeployment.
+    "oggData": { # The Ogg data of the GoldengateDeployment. # Required. The ogg data of the GoldengateDeployment.
+      "adminPassword": "A String", # Optional. Input only. The Goldengate deployment console password in plain text.
+      "adminPasswordSecretVersion": "A String", # Optional. Input only. The Goldengate deployment console password secret version.
+      "adminUsername": "A String", # Required. The Goldengate deployment console username.
+      "certificate": "A String", # Output only. The certificate of the GoldengateDeployment.
+      "credentialStore": "A String", # Output only. The credential store of the GoldengateDeployment.
+      "deployment": "A String", # Required. The name given to the Goldengate service deployment. The name must be 1 to 32 characters long, must contain only alphanumeric characters and must start with a letter.
+      "groupRolesMapping": { # The group to roles mapping of the GoldengateDeployment. # Output only. The group to roles mapping of the GoldengateDeployment.
+        "administratorGroupId": "A String", # Output only. The administrator group id.
+        "operatorGroupId": "A String", # Output only. The operator group id.
+        "securityGroupId": "A String", # Output only. The security group id.
+        "userGroupId": "A String", # Output only. The user group id.
+      },
+      "identityDomainId": "A String", # Output only. The identity domain id of the GoldengateDeployment.
+      "oggVersion": "A String", # Optional. Version of OGG
+      "passwordSecretId": "A String", # Output only. The password secret id of the GoldengateDeployment.
+    },
+    "oggVersionSupportEndTime": "A String", # Output only. The time ogg version supported until of the GoldengateDeployment.
+    "placements": [ # Output only. The placements of the GoldengateDeployment.
+      { # The placement of the GoldengateDeployment.
+        "availabilityDomain": "A String", # Output only. The availability domain.
+        "faultDomain": "A String", # Output only. The fault domain.
+      },
+    ],
+    "privateIpAddress": "A String", # Output only. The private ip address of the GoldengateDeployment.
+    "publicIpAddress": "A String", # Output only. The public ip address of the GoldengateDeployment.
+    "roleChangeTime": "A String", # Output only. The time when the role of the GoldengateDeployment was changed.
+    "storageUtilizationBytes": "A String", # Output only. The storage utilization in bytes of the GoldengateDeployment.
+    "updateTime": "A String", # Output only. The time the GoldengateDeployment was updated.
+    "upgradeRequiredTime": "A String", # Output only. The time upgrade required of the GoldengateDeployment.
+  },
+}
+
+  requestId: string, Optional. An optional ID to identify the request. This value is used to identify duplicate requests. If you make a request with the same request ID and the original request is still in progress or completed, the server 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. A mask specifying which fields in the GoldengateDeployment should be updated. A field specified in the mask is updated. If a mask isn't provided, the service treats this as an implied field mask equivalent to all fields that are populated (have a non-empty value). To clear or unset a field, the field must be explicitly specified in the `update_mask`.
+  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.
+  },
+}
+
+
start(name, body=None, x__xgafv=None) 
Starts a single GoldengateDeployment.
diff --git a/docs/dyn/oracledatabase_v1.projects.locations.odbNetworks.odbSubnets.html b/docs/dyn/oracledatabase_v1.projects.locations.odbNetworks.odbSubnets.html
index 76204f7024..7025184f91 100644
--- a/docs/dyn/oracledatabase_v1.projects.locations.odbNetworks.odbSubnets.html
+++ b/docs/dyn/oracledatabase_v1.projects.locations.odbNetworks.odbSubnets.html
@@ -92,6 +92,9 @@ 
Instance Methods

 

   list_next(previous_request, previous_response)

 
Retrieves the next page of results.

+

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

+
Updates the `labels` of a single ODB Subnet.

 
Method Details

 

     close()
@@ -108,13 +111,13 @@ 
Method Details

     The object takes the form of:
 
 { # Represents OdbSubnet resource.
-  "cidrRange": "A String", # Required. The CIDR range of the subnet.
+  "cidrRange": "A String", # Required. Immutable. The CIDR range of the subnet.
   "createTime": "A String", # Output only. The date and time that the OdbNetwork was created.
   "labels": { # Optional. Labels or tags associated with the resource.
     "a_key": "A String",
   },
   "name": "A String", # Identifier. The name of the OdbSubnet resource in the following format: projects/{project}/locations/{location}/odbNetworks/{odb_network}/odbSubnets/{odb_subnet}
-  "purpose": "A String", # Required. Purpose of the subnet.
+  "purpose": "A String", # Required. Immutable. Purpose of the subnet.
   "state": "A String", # Output only. State of the ODB Subnet.
 }
 
@@ -200,13 +203,13 @@ 
Method Details

   An object of the form:
 
     { # Represents OdbSubnet resource.
-  "cidrRange": "A String", # Required. The CIDR range of the subnet.
+  "cidrRange": "A String", # Required. Immutable. The CIDR range of the subnet.
   "createTime": "A String", # Output only. The date and time that the OdbNetwork was created.
   "labels": { # Optional. Labels or tags associated with the resource.
     "a_key": "A String",
   },
   "name": "A String", # Identifier. The name of the OdbSubnet resource in the following format: projects/{project}/locations/{location}/odbNetworks/{odb_network}/odbSubnets/{odb_subnet}
-  "purpose": "A String", # Required. Purpose of the subnet.
+  "purpose": "A String", # Required. Immutable. Purpose of the subnet.
   "state": "A String", # Output only. State of the ODB Subnet.
 }
@@ -233,13 +236,13 @@

Method Details

"nextPageToken": "A String", # A token identifying a page of results the server should return. "odbSubnets": [ # The list of ODB Subnets. { # Represents OdbSubnet resource. - "cidrRange": "A String", # Required. The CIDR range of the subnet. + "cidrRange": "A String", # Required. Immutable. The CIDR range of the subnet. "createTime": "A String", # Output only. The date and time that the OdbNetwork was created. "labels": { # Optional. Labels or tags associated with the resource. "a_key": "A String", }, "name": "A String", # Identifier. The name of the OdbSubnet resource in the following format: projects/{project}/locations/{location}/odbNetworks/{odb_network}/odbSubnets/{odb_subnet} - "purpose": "A String", # Required. Purpose of the subnet. + "purpose": "A String", # Required. Immutable. Purpose of the subnet. "state": "A String", # Output only. State of the ODB Subnet. }, ], @@ -263,4 +266,55 @@

Method Details

+
+ patch(name, body=None, requestId=None, updateMask=None, x__xgafv=None) + 
Updates the `labels` of a single ODB Subnet.
+
+Args:
+  name: string, Identifier. The name of the OdbSubnet resource in the following format: projects/{project}/locations/{location}/odbNetworks/{odb_network}/odbSubnets/{odb_subnet} (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # Represents OdbSubnet resource.
+  "cidrRange": "A String", # Required. Immutable. The CIDR range of the subnet.
+  "createTime": "A String", # Output only. The date and time that the OdbNetwork was created.
+  "labels": { # Optional. Labels or tags associated with the resource.
+    "a_key": "A String",
+  },
+  "name": "A String", # Identifier. The name of the OdbSubnet resource in the following format: projects/{project}/locations/{location}/odbNetworks/{odb_network}/odbSubnets/{odb_subnet}
+  "purpose": "A String", # Required. Immutable. Purpose of the subnet.
+  "state": "A String", # Output only. State of the ODB Subnet.
+}
+
+  requestId: string, Optional. An optional ID to identify the request. This value is used to identify duplicate requests. If you make a request with the same request ID and the original request is still in progress or completed, the server 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. A mask specifying which fields in the OdbSubnet should be updated. A field specified in the mask is updated. If a mask isn't provided, the service treats this as an implied field mask equivalent to all fields that are populated (have a non-empty value). To clear or unset a field, the field must be explicitly specified in the `update_mask`.
+  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/oracledatabase.v1.json b/googleapiclient/discovery_cache/documents/oracledatabase.v1.json index 83267f74c0..440b5ee120 100644 --- a/googleapiclient/discovery_cache/documents/oracledatabase.v1.json +++ b/googleapiclient/discovery_cache/documents/oracledatabase.v1.json @@ -949,6 +949,45 @@ "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ] +}, +"patch": { +"description": "Updates the parameters of a single Exadata Infrastructure.", +"flatPath": "v1/projects/{projectsId}/locations/{locationsId}/cloudExadataInfrastructures/{cloudExadataInfrastructuresId}", +"httpMethod": "PATCH", +"id": "oracledatabase.projects.locations.cloudExadataInfrastructures.patch", +"parameterOrder": [ +"name" +], +"parameters": { +"name": { +"description": "Identifier. The name of the Exadata Infrastructure resource with the format: projects/{project}/locations/{region}/cloudExadataInfrastructures/{cloud_exadata_infrastructure}", +"location": "path", +"pattern": "^projects/[^/]+/locations/[^/]+/cloudExadataInfrastructures/[^/]+$", +"required": true, +"type": "string" +}, +"requestId": { +"description": "Optional. An optional ID to identify the request. This value is used to identify duplicate requests. If you make a request with the same request ID and the original request is still in progress or completed, the server 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. Field mask is used to specify the fields to be overwritten in the Exadata resource by the update. The fields specified in the `update_mask` are relative to the resource, not the full request. A field will be overwritten if it is in the mask. If the user does not provide a mask then the service treats this as an implied field mask equivalent to all fields that are populated (have a non-empty value). To clear or unset a field, the field must be explicitly specified in the `update_mask`.", +"format": "google-fieldmask", +"location": "query", +"type": "string" +} +}, +"path": "v1/{+name}", +"request": { +"$ref": "CloudExadataInfrastructure" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform" +] } }, "resources": { @@ -1134,6 +1173,45 @@ "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ] +}, +"patch": { +"description": "Updates the parameters of a single Vm Cluster.", +"flatPath": "v1/projects/{projectsId}/locations/{locationsId}/cloudVmClusters/{cloudVmClustersId}", +"httpMethod": "PATCH", +"id": "oracledatabase.projects.locations.cloudVmClusters.patch", +"parameterOrder": [ +"name" +], +"parameters": { +"name": { +"description": "Identifier. The name of the VM Cluster resource with the format: projects/{project}/locations/{region}/cloudVmClusters/{cloud_vm_cluster}", +"location": "path", +"pattern": "^projects/[^/]+/locations/[^/]+/cloudVmClusters/[^/]+$", +"required": true, +"type": "string" +}, +"requestId": { +"description": "Optional. An optional ID to identify the request. This value is used to identify duplicate requests. If you make a request with the same request ID and the original request is still in progress or completed, the server 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. A mask specifying which fields in the VM Cluster should be updated. A field specified in the mask is overwritten. If a mask isn't provided, the service treats this as an implied field mask equivalent to all fields that are populated (have a non-empty value). To clear or unset a field, the field must be explicitly specified in the `update_mask`.", +"format": "google-fieldmask", +"location": "query", +"type": "string" +} +}, +"path": "v1/{+name}", +"request": { +"$ref": "CloudVmCluster" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform" +] } }, "resources": { @@ -1519,6 +1597,45 @@ "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ] +}, +"patch": { +"description": "Updates the `labels` of a single DbSystem.", +"flatPath": "v1/projects/{projectsId}/locations/{locationsId}/dbSystems/{dbSystemsId}", +"httpMethod": "PATCH", +"id": "oracledatabase.projects.locations.dbSystems.patch", +"parameterOrder": [ +"name" +], +"parameters": { +"name": { +"description": "Identifier. The name of the DbSystem resource in the following format: projects/{project}/locations/{region}/dbSystems/{db_system}", +"location": "path", +"pattern": "^projects/[^/]+/locations/[^/]+/dbSystems/[^/]+$", +"required": true, +"type": "string" +}, +"requestId": { +"description": "Optional. An optional ID to identify the request. This value is used to identify duplicate requests. If you make a request with the same request ID and the original request is still in progress or completed, the server 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. A mask specifying which fields in the DbSystem should be updated. A field specified in the mask is updated. If a mask isn't provided, the service treats this as an implied field mask equivalent to all fields that are populated (have a non-empty value).", +"format": "google-fieldmask", +"location": "query", +"type": "string" +} +}, +"path": "v1/{+name}", +"request": { +"$ref": "DbSystem" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform" +] } } }, @@ -1999,6 +2116,45 @@ "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ] +}, +"patch": { +"description": "Updates the `labels` of a single ExascaleDbStorageVault.", +"flatPath": "v1/projects/{projectsId}/locations/{locationsId}/exascaleDbStorageVaults/{exascaleDbStorageVaultsId}", +"httpMethod": "PATCH", +"id": "oracledatabase.projects.locations.exascaleDbStorageVaults.patch", +"parameterOrder": [ +"name" +], +"parameters": { +"name": { +"description": "Identifier. The resource name of the ExascaleDbStorageVault. Format: projects/{project}/locations/{location}/exascaleDbStorageVaults/{exascale_db_storage_vault}", +"location": "path", +"pattern": "^projects/[^/]+/locations/[^/]+/exascaleDbStorageVaults/[^/]+$", +"required": true, +"type": "string" +}, +"requestId": { +"description": "Optional. An optional ID to identify the request. This value is used to identify duplicate requests. If you make a request with the same request ID and the original request is still in progress or completed, the server 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. A mask specifying which fields in the ExascaleDbStorageVault should be updated. A field specified in the mask is updated. If a mask isn't provided, the service treats this as an implied field mask equivalent to all fields that are populated (have a non-empty value). To clear or unset a field, the field must be explicitly specified in the `update_mask`.", +"format": "google-fieldmask", +"location": "query", +"type": "string" +} +}, +"path": "v1/{+name}", +"request": { +"$ref": "ExascaleDbStorageVault" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform" +] } } }, @@ -2235,6 +2391,45 @@ "https://www.googleapis.com/auth/cloud-platform" ] }, +"patch": { +"description": "Updates the `labels` of a single GoldengateConnectionAssignment.", +"flatPath": "v1/projects/{projectsId}/locations/{locationsId}/goldengateConnectionAssignments/{goldengateConnectionAssignmentsId}", +"httpMethod": "PATCH", +"id": "oracledatabase.projects.locations.goldengateConnectionAssignments.patch", +"parameterOrder": [ +"name" +], +"parameters": { +"name": { +"description": "Identifier. The name of the GoldengateConnectionAssignment resource in the following format: projects/{project}/locations/{region}/goldengateConnectionAssignments/{goldengate_connection_assignment}", +"location": "path", +"pattern": "^projects/[^/]+/locations/[^/]+/goldengateConnectionAssignments/[^/]+$", +"required": true, +"type": "string" +}, +"requestId": { +"description": "Optional. An optional ID to identify the request. This value is used to identify duplicate requests. If you make a request with the same request ID and the original request is still in progress or completed, the server 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. A mask specifying which fields in the GoldengateConnectionAssignment should be updated. A field specified in the mask is updated. If a mask isn't provided, the service treats this as an implied field mask equivalent to all fields that are populated (have a non-empty value). To clear or unset a field, the field must be explicitly specified in the `update_mask`.", +"format": "google-fieldmask", +"location": "query", +"type": "string" +} +}, +"path": "v1/{+name}", +"request": { +"$ref": "GoldengateConnectionAssignment" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform" +] +}, "test": { "description": "Tests a single GoldengateConnectionAssignment.", "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/goldengateConnectionAssignments/{goldengateConnectionAssignmentsId}:test", @@ -2450,6 +2645,45 @@ "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ] +}, +"patch": { +"description": "Updates the `labels` of a single GoldengateConnection.", +"flatPath": "v1/projects/{projectsId}/locations/{locationsId}/goldengateConnections/{goldengateConnectionsId}", +"httpMethod": "PATCH", +"id": "oracledatabase.projects.locations.goldengateConnections.patch", +"parameterOrder": [ +"name" +], +"parameters": { +"name": { +"description": "Identifier. The name of the GoldengateConnection resource in the following format: projects/{project}/locations/{region}/goldengateConnections/{goldengate_connection}", +"location": "path", +"pattern": "^projects/[^/]+/locations/[^/]+/goldengateConnections/[^/]+$", +"required": true, +"type": "string" +}, +"requestId": { +"description": "Optional. An optional ID to identify the request. This value is used to identify duplicate requests. If you make a request with the same request ID and the original request is still in progress or completed, the server 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. A mask specifying which fields in the GoldengateConnection should be updated. A field specified in the mask is updated. If a mask isn't provided, the service treats this as an implied field mask equivalent to all fields that are populated (have a non-empty value). To clear or unset a field, the field must be explicitly specified in the `update_mask`.", +"format": "google-fieldmask", +"location": "query", +"type": "string" +} +}, +"path": "v1/{+name}", +"request": { +"$ref": "GoldengateConnection" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform" +] } } }, @@ -2729,6 +2963,45 @@ "https://www.googleapis.com/auth/cloud-platform" ] }, +"patch": { +"description": "Updates the `labels` of a single GoldengateDeployment.", +"flatPath": "v1/projects/{projectsId}/locations/{locationsId}/goldengateDeployments/{goldengateDeploymentsId}", +"httpMethod": "PATCH", +"id": "oracledatabase.projects.locations.goldengateDeployments.patch", +"parameterOrder": [ +"name" +], +"parameters": { +"name": { +"description": "Identifier. The name of the GoldengateDeployment resource in the following format: projects/{project}/locations/{region}/goldengateDeployments/{goldengate_deployment}", +"location": "path", +"pattern": "^projects/[^/]+/locations/[^/]+/goldengateDeployments/[^/]+$", +"required": true, +"type": "string" +}, +"requestId": { +"description": "Optional. An optional ID to identify the request. This value is used to identify duplicate requests. If you make a request with the same request ID and the original request is still in progress or completed, the server 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. A mask specifying which fields in the GoldengateDeployment should be updated. A field specified in the mask is updated. If a mask isn't provided, the service treats this as an implied field mask equivalent to all fields that are populated (have a non-empty value). To clear or unset a field, the field must be explicitly specified in the `update_mask`.", +"format": "google-fieldmask", +"location": "query", +"type": "string" +} +}, +"path": "v1/{+name}", +"request": { +"$ref": "GoldengateDeployment" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform" +] +}, "start": { "description": "Starts a single GoldengateDeployment.", "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/goldengateDeployments/{goldengateDeploymentsId}:start", @@ -3070,6 +3343,45 @@ "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ] +}, +"patch": { +"description": "Updates the `labels` of a single ODB Subnet.", +"flatPath": "v1/projects/{projectsId}/locations/{locationsId}/odbNetworks/{odbNetworksId}/odbSubnets/{odbSubnetsId}", +"httpMethod": "PATCH", +"id": "oracledatabase.projects.locations.odbNetworks.odbSubnets.patch", +"parameterOrder": [ +"name" +], +"parameters": { +"name": { +"description": "Identifier. The name of the OdbSubnet resource in the following format: projects/{project}/locations/{location}/odbNetworks/{odb_network}/odbSubnets/{odb_subnet}", +"location": "path", +"pattern": "^projects/[^/]+/locations/[^/]+/odbNetworks/[^/]+/odbSubnets/[^/]+$", +"required": true, +"type": "string" +}, +"requestId": { +"description": "Optional. An optional ID to identify the request. This value is used to identify duplicate requests. If you make a request with the same request ID and the original request is still in progress or completed, the server 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. A mask specifying which fields in the OdbSubnet should be updated. A field specified in the mask is updated. If a mask isn't provided, the service treats this as an implied field mask equivalent to all fields that are populated (have a non-empty value). To clear or unset a field, the field must be explicitly specified in the `update_mask`.", +"format": "google-fieldmask", +"location": "query", +"type": "string" +} +}, +"path": "v1/{+name}", +"request": { +"$ref": "OdbSubnet" +}, +"response": { +"$ref": "Operation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform" +] } } } @@ -3278,7 +3590,7 @@ } } }, -"revision": "20260910", +"revision": "20261012", "rootUrl": "https://oracledatabase.googleapis.com/", "schemas": { "AllConnectionStrings": { @@ -3349,11 +3661,11 @@ "id": "AutonomousDatabase", "properties": { "adminPassword": { -"description": "Optional. Immutable. The password for the default ADMIN user. Note: Only one of `admin_password_secret_version` or `admin_password` can be populated.", +"description": "Optional. Input only. Immutable. The password for the default ADMIN user. Note: Only one of `admin_password_secret_version` or `admin_password` can be populated.", "type": "string" }, "adminPasswordSecretVersion": { -"description": "Optional. Immutable. The resource name of a secret version in Secret Manager which contains the database admin user's password. Format: projects/{project}/secrets/{secret}/versions/{version}. Note: Only one of `admin_password_secret_version` or `admin_password` can be populated.", +"description": "Optional. Input only. Immutable. The resource name of a secret version in Secret Manager which contains the database admin user's password. Format: projects/{project}/secrets/{secret}/versions/{version}. Note: Only one of `admin_password_secret_version` or `admin_password` can be populated.", "type": "string" }, "cidr": { @@ -3898,14 +4210,16 @@ "OLTP", "DW", "AJD", -"APEX" +"APEX", +"LH" ], "enumDescriptions": [ "Default unspecified value.", "Autonomous Transaction Processing database.", "Autonomous Data Warehouse database.", "Autonomous JSON Database.", -"Autonomous Database with the Oracle APEX Application Development workload type." +"Autonomous Database with the Oracle APEX Application Development workload type.", +"Autonomous Database with the Lakehouse workload type." ], "type": "string" }, @@ -4422,14 +4736,16 @@ "OLTP", "DW", "AJD", -"APEX" +"APEX", +"LH" ], "enumDescriptions": [ "Default unspecified value.", "Autonomous Transaction Processing database.", "Autonomous Data Warehouse database.", "Autonomous JSON Database.", -"Autonomous Database with the Oracle APEX Application Development workload type." +"Autonomous Database with the Oracle APEX Application Development workload type.", +"Autonomous Database with the Lakehouse workload type." ], "readOnly": true, "type": "string" @@ -4545,7 +4861,7 @@ "type": "string" }, "displayName": { -"description": "Optional. User friendly name for this resource.", +"description": "Optional. Immutable. User friendly name for this resource.", "type": "string" }, "entitlementId": { @@ -4554,7 +4870,7 @@ "type": "string" }, "gcpOracleZone": { -"description": "Optional. The GCP Oracle zone where Oracle Exadata Infrastructure is hosted. Example: us-east4-b-r2. If not specified, the system will pick a zone based on availability.", +"description": "Optional. Immutable. The GCP Oracle zone where Oracle Exadata Infrastructure is hosted. Example: us-east4-b-r2. If not specified, the system will pick a zone based on availability.", "type": "string" }, "labels": { @@ -4570,7 +4886,7 @@ }, "properties": { "$ref": "CloudExadataInfrastructureProperties", -"description": "Optional. Various properties of the infra." +"description": "Optional. Immutable. Various properties of the infra." } }, "type": "object" @@ -4783,15 +5099,15 @@ "id": "CloudVmCluster", "properties": { "backupOdbSubnet": { -"description": "Optional. The name of the backup OdbSubnet associated with the VM Cluster. Format: projects/{project}/locations/{location}/odbNetworks/{odb_network}/odbSubnets/{odb_subnet}", +"description": "Optional. Immutable. The name of the backup OdbSubnet associated with the VM Cluster. Format: projects/{project}/locations/{location}/odbNetworks/{odb_network}/odbSubnets/{odb_subnet}", "type": "string" }, "backupSubnetCidr": { -"description": "Optional. CIDR range of the backup subnet.", +"description": "Optional. Immutable. CIDR range of the backup subnet.", "type": "string" }, "cidr": { -"description": "Optional. Network settings. CIDR to use for cluster IP allocation.", +"description": "Optional. Immutable. Network settings. CIDR to use for cluster IP allocation.", "type": "string" }, "createTime": { @@ -4801,15 +5117,15 @@ "type": "string" }, "displayName": { -"description": "Optional. User friendly name for this resource.", +"description": "Optional. Immutable. User friendly name for this resource.", "type": "string" }, "exadataInfrastructure": { -"description": "Required. The name of the Exadata Infrastructure resource on which VM cluster resource is created, in the following format: projects/{project}/locations/{region}/cloudExadataInfrastuctures/{cloud_extradata_infrastructure}", +"description": "Required. Immutable. The name of the Exadata Infrastructure resource on which VM cluster resource is created, in the following format: projects/{project}/locations/{region}/cloudExadataInfrastuctures/{cloud_extradata_infrastructure}", "type": "string" }, "exascaleDbStorageVault": { -"description": "Optional. The name of ExascaleDbStorageVault associated with the VM Cluster. Format: projects/{project}/locations/{location}/exascaleDbStorageVaults/{exascale_db_storage_vault}", +"description": "Optional. Immutable. The name of ExascaleDbStorageVault associated with the VM Cluster. Format: projects/{project}/locations/{location}/exascaleDbStorageVaults/{exascale_db_storage_vault}", "type": "string" }, "gcpOracleZone": { @@ -4834,20 +5150,20 @@ "type": "string" }, "network": { -"description": "Optional. The name of the VPC network. Format: projects/{project}/global/networks/{network}", +"description": "Optional. Immutable. The name of the VPC network. Format: projects/{project}/global/networks/{network}", "type": "string" }, "odbNetwork": { -"description": "Optional. The name of the OdbNetwork associated with the VM Cluster. Format: projects/{project}/locations/{location}/odbNetworks/{odb_network} It is optional but if specified, this should match the parent ODBNetwork of the odb_subnet and backup_odb_subnet.", +"description": "Optional. Immutable. The name of the OdbNetwork associated with the VM Cluster. Format: projects/{project}/locations/{location}/odbNetworks/{odb_network} It is optional but if specified, this should match the parent ODBNetwork of the odb_subnet and backup_odb_subnet.", "type": "string" }, "odbSubnet": { -"description": "Optional. The name of the OdbSubnet associated with the VM Cluster for IP allocation. Format: projects/{project}/locations/{location}/odbNetworks/{odb_network}/odbSubnets/{odb_subnet}", +"description": "Optional. Immutable. The name of the OdbSubnet associated with the VM Cluster for IP allocation. Format: projects/{project}/locations/{location}/odbNetworks/{odb_network}/odbSubnets/{odb_subnet}", "type": "string" }, "properties": { "$ref": "CloudVmClusterProperties", -"description": "Optional. Various properties of the VM Cluster." +"description": "Optional. Immutable. Various properties of the VM Cluster." } }, "type": "object" @@ -5205,11 +5521,11 @@ "id": "Database", "properties": { "adminPassword": { -"description": "Optional. The password for the default ADMIN user. Note: Only one of `admin_password_secret_version` or `admin_password` can be populated.", +"description": "Optional. Input only. The password for the default ADMIN user. Note: Only one of `admin_password_secret_version` or `admin_password` can be populated.", "type": "string" }, "adminPasswordSecretVersion": { -"description": "Optional. The resource name of a secret version in Secret Manager which contains the database admin user's password. Format: projects/{project}/secrets/{secret}/versions/{version}. Note: Only one of `admin_password_secret_version` or `admin_password` can be populated.", +"description": "Optional. Input only. The resource name of a secret version in Secret Manager which contains the database admin user's password. Format: projects/{project}/secrets/{secret}/versions/{version}. Note: Only one of `admin_password_secret_version` or `admin_password` can be populated.", "type": "string" }, "characterSet": { @@ -5292,11 +5608,11 @@ "description": "Optional. The properties of the Database." }, "tdeWalletPassword": { -"description": "Optional. The TDE wallet password for the database. Note: Only one of `tde_wallet_password_secret_version` or `tde_wallet_password` can be populated.", +"description": "Optional. Input only. The TDE wallet password for the database. Note: Only one of `tde_wallet_password_secret_version` or `tde_wallet_password` can be populated.", "type": "string" }, "tdeWalletPasswordSecretVersion": { -"description": "Optional. The resource name of a secret version in Secret Manager which contains the TDE wallet password for the database. Format: projects/{project}/secrets/{secret}/versions/{version}. Note: Only one of `tde_wallet_password_secret_version` or `tde_wallet_password` can be populated.", +"description": "Optional. Input only. The resource name of a secret version in Secret Manager which contains the TDE wallet password for the database. Format: projects/{project}/secrets/{secret}/versions/{version}. Note: Only one of `tde_wallet_password_secret_version` or `tde_wallet_password` can be populated.", "type": "string" } }, @@ -5901,7 +6217,7 @@ "type": "string" }, "displayName": { -"description": "Required. The display name for the System db. The name does not have to be unique within your project.", +"description": "Required. Immutable. The display name for the System db. The name does not have to be unique within your project.", "type": "string" }, "entitlementId": { @@ -5910,7 +6226,7 @@ "type": "string" }, "gcpOracleZone": { -"description": "Optional. The GCP Oracle zone where Oracle DbSystem is hosted. Example: us-east4-b-r2. If not specified, the system will pick a zone based on availability.", +"description": "Optional. Immutable. The GCP Oracle zone where Oracle DbSystem is hosted. Example: us-east4-b-r2. If not specified, the system will pick a zone based on availability.", "type": "string" }, "labels": { @@ -5930,16 +6246,16 @@ "type": "string" }, "odbNetwork": { -"description": "Optional. The name of the OdbNetwork associated with the DbSystem. Format: projects/{project}/locations/{location}/odbNetworks/{odb_network} It is optional but if specified, this should match the parent ODBNetwork of the OdbSubnet.", +"description": "Optional. Immutable. The name of the OdbNetwork associated with the DbSystem. Format: projects/{project}/locations/{location}/odbNetworks/{odb_network} It is optional but if specified, this should match the parent ODBNetwork of the OdbSubnet.", "type": "string" }, "odbSubnet": { -"description": "Required. The name of the OdbSubnet associated with the DbSystem for IP allocation. Format: projects/{project}/locations/{location}/odbNetworks/{odb_network}/odbSubnets/{odb_subnet}", +"description": "Required. Immutable. The name of the OdbSubnet associated with the DbSystem for IP allocation. Format: projects/{project}/locations/{location}/odbNetworks/{odb_network}/odbSubnets/{odb_subnet}", "type": "string" }, "properties": { "$ref": "DbSystemProperties", -"description": "Optional. The properties of the DbSystem." +"description": "Optional. Immutable. The properties of the DbSystem." } }, "type": "object" @@ -6750,7 +7066,7 @@ true "type": "string" }, "displayName": { -"description": "Required. The display name for the ExascaleDbStorageVault. The name does not have to be unique within your project. The name must be 1-255 characters long and can only contain alphanumeric characters.", +"description": "Required. Immutable. The display name for the ExascaleDbStorageVault. The name does not have to be unique within your project. The name must be 1-255 characters long and can only contain alphanumeric characters.", "type": "string" }, "entitlementId": { @@ -6759,11 +7075,11 @@ true "type": "string" }, "exadataInfrastructure": { -"description": "Optional. The Exadata Infrastructure resource on which ExascaleDbStorageVault resource is created, in the following format: projects/{project}/locations/{region}/cloudExadataInfrastuctures/{cloud_extradata_infrastructure}", +"description": "Optional. Immutable. The Exadata Infrastructure resource on which ExascaleDbStorageVault resource is created, in the following format: projects/{project}/locations/{region}/cloudExadataInfrastuctures/{cloud_extradata_infrastructure}", "type": "string" }, "gcpOracleZone": { -"description": "Optional. The GCP Oracle zone where Oracle ExascaleDbStorageVault is hosted. Example: us-east4-b-r2. If not specified, the system will pick a zone based on availability.", +"description": "Optional. Immutable. The GCP Oracle zone where Oracle ExascaleDbStorageVault is hosted. Example: us-east4-b-r2. If not specified, the system will pick a zone based on availability.", "type": "string" }, "labels": { @@ -6779,7 +7095,7 @@ true }, "properties": { "$ref": "ExascaleDbStorageVaultProperties", -"description": "Required. The properties of the ExascaleDbStorageVault." +"description": "Required. Immutable. The properties of the ExascaleDbStorageVault." } }, "type": "object" @@ -7204,7 +7520,7 @@ true "type": "string" }, "gcpOracleZone": { -"description": "Optional. The GCP Oracle zone where Oracle GoldengateConnection is hosted. Example: us-east4-b-r2. If not specified, the system will pick a zone based on availability.", +"description": "Optional. Immutable. The GCP Oracle zone where Oracle GoldengateConnection is hosted. Example: us-east4-b-r2. If not specified, the system will pick a zone based on availability.", "type": "string" }, "labels": { @@ -7224,16 +7540,16 @@ true "type": "string" }, "odbNetwork": { -"description": "Optional. The name of the OdbNetwork associated with the GoldengateConnection. The format is projects/{project}/locations/{location}/odbNetworks/{odb_network}. It is optional but if specified, this should match the parent ODBNetwork of the OdbSubnet.", +"description": "Optional. Immutable. The name of the OdbNetwork associated with the GoldengateConnection. The format is projects/{project}/locations/{location}/odbNetworks/{odb_network}. It is optional but if specified, this should match the parent ODBNetwork of the OdbSubnet.", "type": "string" }, "odbSubnet": { -"description": "Optional. The name of the OdbSubnet associated with the GoldengateConnection for IP allocation. Format: projects/{project}/locations/{location}/odbNetworks/{odb_network}/odbSubnets/{odb_subnet}", +"description": "Optional. Immutable. The name of the OdbSubnet associated with the GoldengateConnection for IP allocation. Format: projects/{project}/locations/{location}/odbNetworks/{odb_network}/odbSubnets/{odb_subnet}", "type": "string" }, "properties": { "$ref": "GoldengateConnectionProperties", -"description": "Required. The properties of the GoldengateConnection." +"description": "Required. Immutable. The properties of the GoldengateConnection." } }, "type": "object" @@ -7249,7 +7565,7 @@ true "type": "string" }, "displayName": { -"description": "Optional. The display name for the GoldengateConnectionAssignment.", +"description": "Optional. Immutable. The display name for the GoldengateConnectionAssignment.", "type": "string" }, "entitlementId": { @@ -7270,7 +7586,7 @@ true }, "properties": { "$ref": "GoldengateConnectionAssignmentProperties", -"description": "Required. The properties of the GoldengateConnectionAssignment." +"description": "Required. Immutable. The properties of the GoldengateConnectionAssignment." } }, "type": "object" @@ -7798,7 +8114,7 @@ true "type": "string" }, "displayName": { -"description": "Required. The display name for the GoldengateDeployment.", +"description": "Required. Immutable. The display name for the GoldengateDeployment.", "type": "string" }, "entitlementId": { @@ -7807,7 +8123,7 @@ true "type": "string" }, "gcpOracleZone": { -"description": "Optional. The GCP Oracle zone where Oracle GoldengateDeployment is hosted. Example: us-east4-b-r2. If not specified, the system will pick a zone based on availability.", +"description": "Optional. Immutable. The GCP Oracle zone where Oracle GoldengateDeployment is hosted. Example: us-east4-b-r2. If not specified, the system will pick a zone based on availability.", "type": "string" }, "labels": { @@ -7827,16 +8143,16 @@ true "type": "string" }, "odbNetwork": { -"description": "Optional. The name of the OdbNetwork associated with the GoldengateDeployment.", +"description": "Optional. Immutable. The name of the OdbNetwork associated with the GoldengateDeployment.", "type": "string" }, "odbSubnet": { -"description": "Required. The name of the OdbSubnet associated with the GoldengateDeployment for IP allocation.", +"description": "Required. Immutable. The name of the OdbSubnet associated with the GoldengateDeployment for IP allocation.", "type": "string" }, "properties": { "$ref": "GoldengateDeploymentProperties", -"description": "Required. The properties of the GoldengateDeployment." +"description": "Required. Immutable. The properties of the GoldengateDeployment." } }, "type": "object" @@ -9370,7 +9686,7 @@ true "id": "GoldengateOggDeployment", "properties": { "adminPassword": { -"description": "Optional. The Goldengate deployment console password in plain text.", +"description": "Optional. Input only. The Goldengate deployment console password in plain text.", "type": "string" }, "adminPasswordSecretVersion": { @@ -10938,7 +11254,7 @@ true "id": "OdbSubnet", "properties": { "cidrRange": { -"description": "Required. The CIDR range of the subnet.", +"description": "Required. Immutable. The CIDR range of the subnet.", "type": "string" }, "createTime": { @@ -10959,7 +11275,7 @@ true "type": "string" }, "purpose": { -"description": "Required. Purpose of the subnet.", +"description": "Required. Immutable. Purpose of the subnet.", "enum": [ "PURPOSE_UNSPECIFIED", "CLIENT_SUBNET", From 0413b0731cd6ce7a191ab5ec2c6963ea5a2cb2a5 Mon Sep 17 00:00:00 2001 From: Yoshi Automation Date: Tue, 20 Oct 2026 07:24:02 +0000 Subject: [PATCH 29/34] feat(saasservicemgmt): update the api #### saasservicemgmt:v1 The following keys were deleted: - schemas.FlagUpdate (Total Keys: 3) - schemas.Rollout.properties.flagRelease.type (Total Keys: 1) - schemas.UnitOperation.properties.flagUpdate.$ref (Total Keys: 1) The following keys were added: - schemas.AppParams (Total Keys: 4) - schemas.ComponentRef (Total Keys: 4) - schemas.CompositeRef (Total Keys: 5) - schemas.Release.properties.applicationTemplateComponent (Total Keys: 2) - schemas.Saas.properties.applicationTemplate.$ref (Total Keys: 1) - schemas.Saas.properties.blueprintRepo (Total Keys: 2) - schemas.Scope (Total Keys: 3) - schemas.Unit.properties.application.type (Total Keys: 1) - schemas.UnitKind.properties.appParams.$ref (Total Keys: 1) - schemas.UnitKind.properties.applicationTemplateComponent.$ref (Total Keys: 1) #### saasservicemgmt:v1beta1 The following keys were added: - schemas.EvaluationSpec.properties.defaultAllocation.type (Total Keys: 1) - schemas.EvaluationSpec.properties.defaultVariant.type (Total Keys: 1) --- ...cemgmt_v1.projects.locations.releases.html | 54 +++++++ ...cemgmt_v1.projects.locations.rollouts.html | 6 - ...ervicemgmt_v1.projects.locations.saas.html | 36 +++++ ...emgmt_v1.projects.locations.unitKinds.html | 108 +++++++++++--- ..._v1.projects.locations.unitOperations.html | 18 --- ...rvicemgmt_v1.projects.locations.units.html | 24 +-- ...eta1.projects.locations.flagRevisions.html | 36 ++++- ...mgmt_v1beta1.projects.locations.flags.html | 24 ++- ...t_v1beta1.projects.locations.releases.html | 12 +- ...t_v1beta1.projects.locations.rollouts.html | 12 +- ...emgmt_v1beta1.projects.locations.saas.html | 12 +- ..._v1beta1.projects.locations.unitKinds.html | 12 +- .../documents/saasservicemgmt.v1.json | 137 +++++++++++++----- .../documents/saasservicemgmt.v1beta1.json | 18 ++- 14 files changed, 373 insertions(+), 136 deletions(-) diff --git a/docs/dyn/saasservicemgmt_v1.projects.locations.releases.html b/docs/dyn/saasservicemgmt_v1.projects.locations.releases.html index d8dbf781e0..7e8c471ee0 100644 --- a/docs/dyn/saasservicemgmt_v1.projects.locations.releases.html +++ b/docs/dyn/saasservicemgmt_v1.projects.locations.releases.html @@ -114,6 +114,15 @@

Method Details

"annotations": { # Optional. Annotations is an unstructured key-value map stored with a resource that may be set by external tools to store and retrieve arbitrary metadata. They are not queryable and should be preserved when modifying objects. More info: https://kubernetes.io/docs/user-guide/annotations "a_key": "A String", }, + "applicationTemplateComponent": { # ComponentRef represents a reference to a component resource. # Output only. Reference to component and revision in a composite ApplicationTemplate. + "component": "A String", # Optional. Name of the component in composite.Components + "compositeRef": { # CompositeRef represents a reference to a composite resource. # Optional. Reference to the Composite ApplicationTemplate. + "applicationTemplate": "A String", # Required. Reference to the ApplicationTemplate resource. + "revision": "A String", # Optional. Revision of the ApplicationTemplate to use. Changes to revision will trigger manual resynchronization. If empty, ApplicationTemplate will be ignored. + "syncOperation": "A String", # Output only. Reference to on-going AppTemplate import and replication operation (i.e. the operation_id for the long-running operation). This field is opaque for external usage. + }, + "revision": "A String", # Optional. Revision of the component. If the component does not have a revision, this field will be explicitly set to the revision of the composite ApplicationTemplate. + }, "blueprint": { # Blueprints are OCI Images that contain all of the artifacts needed to provision a unit. Metadata such as, type of the engine used to actuate the blueprint (Terraform, for example) and version will come from the image manifest. If the hostname is omitted, it will be assumed to be the regional path to Artifact Registry (eg. us-east1-docker.pkg.dev). # Optional. Blueprints are OCI Images that contain all of the artifacts needed to provision a unit. "engine": "A String", # Output only. Type of the engine used to actuate the blueprint. (Terraform, for example) "package": "A String", # Optional. Immutable. URI to a blueprint used by the Unit (required unless unitKind or release is set). @@ -171,6 +180,15 @@

Method Details

"annotations": { # Optional. Annotations is an unstructured key-value map stored with a resource that may be set by external tools to store and retrieve arbitrary metadata. They are not queryable and should be preserved when modifying objects. More info: https://kubernetes.io/docs/user-guide/annotations "a_key": "A String", }, + "applicationTemplateComponent": { # ComponentRef represents a reference to a component resource. # Output only. Reference to component and revision in a composite ApplicationTemplate. + "component": "A String", # Optional. Name of the component in composite.Components + "compositeRef": { # CompositeRef represents a reference to a composite resource. # Optional. Reference to the Composite ApplicationTemplate. + "applicationTemplate": "A String", # Required. Reference to the ApplicationTemplate resource. + "revision": "A String", # Optional. Revision of the ApplicationTemplate to use. Changes to revision will trigger manual resynchronization. If empty, ApplicationTemplate will be ignored. + "syncOperation": "A String", # Output only. Reference to on-going AppTemplate import and replication operation (i.e. the operation_id for the long-running operation). This field is opaque for external usage. + }, + "revision": "A String", # Optional. Revision of the component. If the component does not have a revision, this field will be explicitly set to the revision of the composite ApplicationTemplate. + }, "blueprint": { # Blueprints are OCI Images that contain all of the artifacts needed to provision a unit. Metadata such as, type of the engine used to actuate the blueprint (Terraform, for example) and version will come from the image manifest. If the hostname is omitted, it will be assumed to be the regional path to Artifact Registry (eg. us-east1-docker.pkg.dev). # Optional. Blueprints are OCI Images that contain all of the artifacts needed to provision a unit. "engine": "A String", # Output only. Type of the engine used to actuate the blueprint. (Terraform, for example) "package": "A String", # Optional. Immutable. URI to a blueprint used by the Unit (required unless unitKind or release is set). @@ -253,6 +271,15 @@

Method Details

"annotations": { # Optional. Annotations is an unstructured key-value map stored with a resource that may be set by external tools to store and retrieve arbitrary metadata. They are not queryable and should be preserved when modifying objects. More info: https://kubernetes.io/docs/user-guide/annotations "a_key": "A String", }, + "applicationTemplateComponent": { # ComponentRef represents a reference to a component resource. # Output only. Reference to component and revision in a composite ApplicationTemplate. + "component": "A String", # Optional. Name of the component in composite.Components + "compositeRef": { # CompositeRef represents a reference to a composite resource. # Optional. Reference to the Composite ApplicationTemplate. + "applicationTemplate": "A String", # Required. Reference to the ApplicationTemplate resource. + "revision": "A String", # Optional. Revision of the ApplicationTemplate to use. Changes to revision will trigger manual resynchronization. If empty, ApplicationTemplate will be ignored. + "syncOperation": "A String", # Output only. Reference to on-going AppTemplate import and replication operation (i.e. the operation_id for the long-running operation). This field is opaque for external usage. + }, + "revision": "A String", # Optional. Revision of the component. If the component does not have a revision, this field will be explicitly set to the revision of the composite ApplicationTemplate. + }, "blueprint": { # Blueprints are OCI Images that contain all of the artifacts needed to provision a unit. Metadata such as, type of the engine used to actuate the blueprint (Terraform, for example) and version will come from the image manifest. If the hostname is omitted, it will be assumed to be the regional path to Artifact Registry (eg. us-east1-docker.pkg.dev). # Optional. Blueprints are OCI Images that contain all of the artifacts needed to provision a unit. "engine": "A String", # Output only. Type of the engine used to actuate the blueprint. (Terraform, for example) "package": "A String", # Optional. Immutable. URI to a blueprint used by the Unit (required unless unitKind or release is set). @@ -321,6 +348,15 @@

Method Details

"annotations": { # Optional. Annotations is an unstructured key-value map stored with a resource that may be set by external tools to store and retrieve arbitrary metadata. They are not queryable and should be preserved when modifying objects. More info: https://kubernetes.io/docs/user-guide/annotations "a_key": "A String", }, + "applicationTemplateComponent": { # ComponentRef represents a reference to a component resource. # Output only. Reference to component and revision in a composite ApplicationTemplate. + "component": "A String", # Optional. Name of the component in composite.Components + "compositeRef": { # CompositeRef represents a reference to a composite resource. # Optional. Reference to the Composite ApplicationTemplate. + "applicationTemplate": "A String", # Required. Reference to the ApplicationTemplate resource. + "revision": "A String", # Optional. Revision of the ApplicationTemplate to use. Changes to revision will trigger manual resynchronization. If empty, ApplicationTemplate will be ignored. + "syncOperation": "A String", # Output only. Reference to on-going AppTemplate import and replication operation (i.e. the operation_id for the long-running operation). This field is opaque for external usage. + }, + "revision": "A String", # Optional. Revision of the component. If the component does not have a revision, this field will be explicitly set to the revision of the composite ApplicationTemplate. + }, "blueprint": { # Blueprints are OCI Images that contain all of the artifacts needed to provision a unit. Metadata such as, type of the engine used to actuate the blueprint (Terraform, for example) and version will come from the image manifest. If the hostname is omitted, it will be assumed to be the regional path to Artifact Registry (eg. us-east1-docker.pkg.dev). # Optional. Blueprints are OCI Images that contain all of the artifacts needed to provision a unit. "engine": "A String", # Output only. Type of the engine used to actuate the blueprint. (Terraform, for example) "package": "A String", # Optional. Immutable. URI to a blueprint used by the Unit (required unless unitKind or release is set). @@ -396,6 +432,15 @@

Method Details

"annotations": { # Optional. Annotations is an unstructured key-value map stored with a resource that may be set by external tools to store and retrieve arbitrary metadata. They are not queryable and should be preserved when modifying objects. More info: https://kubernetes.io/docs/user-guide/annotations "a_key": "A String", }, + "applicationTemplateComponent": { # ComponentRef represents a reference to a component resource. # Output only. Reference to component and revision in a composite ApplicationTemplate. + "component": "A String", # Optional. Name of the component in composite.Components + "compositeRef": { # CompositeRef represents a reference to a composite resource. # Optional. Reference to the Composite ApplicationTemplate. + "applicationTemplate": "A String", # Required. Reference to the ApplicationTemplate resource. + "revision": "A String", # Optional. Revision of the ApplicationTemplate to use. Changes to revision will trigger manual resynchronization. If empty, ApplicationTemplate will be ignored. + "syncOperation": "A String", # Output only. Reference to on-going AppTemplate import and replication operation (i.e. the operation_id for the long-running operation). This field is opaque for external usage. + }, + "revision": "A String", # Optional. Revision of the component. If the component does not have a revision, this field will be explicitly set to the revision of the composite ApplicationTemplate. + }, "blueprint": { # Blueprints are OCI Images that contain all of the artifacts needed to provision a unit. Metadata such as, type of the engine used to actuate the blueprint (Terraform, for example) and version will come from the image manifest. If the hostname is omitted, it will be assumed to be the regional path to Artifact Registry (eg. us-east1-docker.pkg.dev). # Optional. Blueprints are OCI Images that contain all of the artifacts needed to provision a unit. "engine": "A String", # Output only. Type of the engine used to actuate the blueprint. (Terraform, for example) "package": "A String", # Optional. Immutable. URI to a blueprint used by the Unit (required unless unitKind or release is set). @@ -453,6 +498,15 @@

Method Details

"annotations": { # Optional. Annotations is an unstructured key-value map stored with a resource that may be set by external tools to store and retrieve arbitrary metadata. They are not queryable and should be preserved when modifying objects. More info: https://kubernetes.io/docs/user-guide/annotations "a_key": "A String", }, + "applicationTemplateComponent": { # ComponentRef represents a reference to a component resource. # Output only. Reference to component and revision in a composite ApplicationTemplate. + "component": "A String", # Optional. Name of the component in composite.Components + "compositeRef": { # CompositeRef represents a reference to a composite resource. # Optional. Reference to the Composite ApplicationTemplate. + "applicationTemplate": "A String", # Required. Reference to the ApplicationTemplate resource. + "revision": "A String", # Optional. Revision of the ApplicationTemplate to use. Changes to revision will trigger manual resynchronization. If empty, ApplicationTemplate will be ignored. + "syncOperation": "A String", # Output only. Reference to on-going AppTemplate import and replication operation (i.e. the operation_id for the long-running operation). This field is opaque for external usage. + }, + "revision": "A String", # Optional. Revision of the component. If the component does not have a revision, this field will be explicitly set to the revision of the composite ApplicationTemplate. + }, "blueprint": { # Blueprints are OCI Images that contain all of the artifacts needed to provision a unit. Metadata such as, type of the engine used to actuate the blueprint (Terraform, for example) and version will come from the image manifest. If the hostname is omitted, it will be assumed to be the regional path to Artifact Registry (eg. us-east1-docker.pkg.dev). # Optional. Blueprints are OCI Images that contain all of the artifacts needed to provision a unit. "engine": "A String", # Output only. Type of the engine used to actuate the blueprint. (Terraform, for example) "package": "A String", # Optional. Immutable. URI to a blueprint used by the Unit (required unless unitKind or release is set). diff --git a/docs/dyn/saasservicemgmt_v1.projects.locations.rollouts.html b/docs/dyn/saasservicemgmt_v1.projects.locations.rollouts.html index beb8cfcf5a..bc52e4ee4a 100644 --- a/docs/dyn/saasservicemgmt_v1.projects.locations.rollouts.html +++ b/docs/dyn/saasservicemgmt_v1.projects.locations.rollouts.html @@ -125,7 +125,6 @@

Method Details

"effectiveUnitFilter": "A String", # Optional. Output only. Output only snapshot of the effective unit filter at Rollout start time. Contains a CEL(https://github.com/google/cel-spec) expression consisting of a conjunction of Rollout.unit_filter and RolloutKind.unit_filter. This field captures the filter applied by the Rollout to determine the Unit population. If the associated RolloutKind's unit_filter is modified after the rollout is started, it will not be updated here. "endTime": "A String", # Optional. Output only. The time when the rollout finished execution (regardless of success, failure, or cancellation). Will be empty if the rollout hasn't finished yet. Once set, the rollout is in terminal state and all the results are final. "etag": "A String", # Output only. An opaque value that uniquely identifies a version or generation of a resource. It can be used to confirm that the client and server agree on the ordering of a resource being written. - "flagRelease": "A String", # Optional. Immutable. Name of the FlagRelease to be rolled out to the target Units. Release and FlagRelease are mutually exclusive. Note: `release` comment needs to be adjusted to mention that "Release and FlagRelease are mutually exclusive" when visibility restriction will be lifted. "labels": { # Optional. The labels on the resource, which can be used for categorization. similar to Kubernetes resource labels. "a_key": "A String", }, @@ -179,7 +178,6 @@

Method Details

"effectiveUnitFilter": "A String", # Optional. Output only. Output only snapshot of the effective unit filter at Rollout start time. Contains a CEL(https://github.com/google/cel-spec) expression consisting of a conjunction of Rollout.unit_filter and RolloutKind.unit_filter. This field captures the filter applied by the Rollout to determine the Unit population. If the associated RolloutKind's unit_filter is modified after the rollout is started, it will not be updated here. "endTime": "A String", # Optional. Output only. The time when the rollout finished execution (regardless of success, failure, or cancellation). Will be empty if the rollout hasn't finished yet. Once set, the rollout is in terminal state and all the results are final. "etag": "A String", # Output only. An opaque value that uniquely identifies a version or generation of a resource. It can be used to confirm that the client and server agree on the ordering of a resource being written. - "flagRelease": "A String", # Optional. Immutable. Name of the FlagRelease to be rolled out to the target Units. Release and FlagRelease are mutually exclusive. Note: `release` comment needs to be adjusted to mention that "Release and FlagRelease are mutually exclusive" when visibility restriction will be lifted. "labels": { # Optional. The labels on the resource, which can be used for categorization. similar to Kubernetes resource labels. "a_key": "A String", }, @@ -258,7 +256,6 @@

Method Details

"effectiveUnitFilter": "A String", # Optional. Output only. Output only snapshot of the effective unit filter at Rollout start time. Contains a CEL(https://github.com/google/cel-spec) expression consisting of a conjunction of Rollout.unit_filter and RolloutKind.unit_filter. This field captures the filter applied by the Rollout to determine the Unit population. If the associated RolloutKind's unit_filter is modified after the rollout is started, it will not be updated here. "endTime": "A String", # Optional. Output only. The time when the rollout finished execution (regardless of success, failure, or cancellation). Will be empty if the rollout hasn't finished yet. Once set, the rollout is in terminal state and all the results are final. "etag": "A String", # Output only. An opaque value that uniquely identifies a version or generation of a resource. It can be used to confirm that the client and server agree on the ordering of a resource being written. - "flagRelease": "A String", # Optional. Immutable. Name of the FlagRelease to be rolled out to the target Units. Release and FlagRelease are mutually exclusive. Note: `release` comment needs to be adjusted to mention that "Release and FlagRelease are mutually exclusive" when visibility restriction will be lifted. "labels": { # Optional. The labels on the resource, which can be used for categorization. similar to Kubernetes resource labels. "a_key": "A String", }, @@ -323,7 +320,6 @@

Method Details

"effectiveUnitFilter": "A String", # Optional. Output only. Output only snapshot of the effective unit filter at Rollout start time. Contains a CEL(https://github.com/google/cel-spec) expression consisting of a conjunction of Rollout.unit_filter and RolloutKind.unit_filter. This field captures the filter applied by the Rollout to determine the Unit population. If the associated RolloutKind's unit_filter is modified after the rollout is started, it will not be updated here. "endTime": "A String", # Optional. Output only. The time when the rollout finished execution (regardless of success, failure, or cancellation). Will be empty if the rollout hasn't finished yet. Once set, the rollout is in terminal state and all the results are final. "etag": "A String", # Output only. An opaque value that uniquely identifies a version or generation of a resource. It can be used to confirm that the client and server agree on the ordering of a resource being written. - "flagRelease": "A String", # Optional. Immutable. Name of the FlagRelease to be rolled out to the target Units. Release and FlagRelease are mutually exclusive. Note: `release` comment needs to be adjusted to mention that "Release and FlagRelease are mutually exclusive" when visibility restriction will be lifted. "labels": { # Optional. The labels on the resource, which can be used for categorization. similar to Kubernetes resource labels. "a_key": "A String", }, @@ -395,7 +391,6 @@

Method Details

"effectiveUnitFilter": "A String", # Optional. Output only. Output only snapshot of the effective unit filter at Rollout start time. Contains a CEL(https://github.com/google/cel-spec) expression consisting of a conjunction of Rollout.unit_filter and RolloutKind.unit_filter. This field captures the filter applied by the Rollout to determine the Unit population. If the associated RolloutKind's unit_filter is modified after the rollout is started, it will not be updated here. "endTime": "A String", # Optional. Output only. The time when the rollout finished execution (regardless of success, failure, or cancellation). Will be empty if the rollout hasn't finished yet. Once set, the rollout is in terminal state and all the results are final. "etag": "A String", # Output only. An opaque value that uniquely identifies a version or generation of a resource. It can be used to confirm that the client and server agree on the ordering of a resource being written. - "flagRelease": "A String", # Optional. Immutable. Name of the FlagRelease to be rolled out to the target Units. Release and FlagRelease are mutually exclusive. Note: `release` comment needs to be adjusted to mention that "Release and FlagRelease are mutually exclusive" when visibility restriction will be lifted. "labels": { # Optional. The labels on the resource, which can be used for categorization. similar to Kubernetes resource labels. "a_key": "A String", }, @@ -449,7 +444,6 @@

Method Details

"effectiveUnitFilter": "A String", # Optional. Output only. Output only snapshot of the effective unit filter at Rollout start time. Contains a CEL(https://github.com/google/cel-spec) expression consisting of a conjunction of Rollout.unit_filter and RolloutKind.unit_filter. This field captures the filter applied by the Rollout to determine the Unit population. If the associated RolloutKind's unit_filter is modified after the rollout is started, it will not be updated here. "endTime": "A String", # Optional. Output only. The time when the rollout finished execution (regardless of success, failure, or cancellation). Will be empty if the rollout hasn't finished yet. Once set, the rollout is in terminal state and all the results are final. "etag": "A String", # Output only. An opaque value that uniquely identifies a version or generation of a resource. It can be used to confirm that the client and server agree on the ordering of a resource being written. - "flagRelease": "A String", # Optional. Immutable. Name of the FlagRelease to be rolled out to the target Units. Release and FlagRelease are mutually exclusive. Note: `release` comment needs to be adjusted to mention that "Release and FlagRelease are mutually exclusive" when visibility restriction will be lifted. "labels": { # Optional. The labels on the resource, which can be used for categorization. similar to Kubernetes resource labels. "a_key": "A String", }, diff --git a/docs/dyn/saasservicemgmt_v1.projects.locations.saas.html b/docs/dyn/saasservicemgmt_v1.projects.locations.saas.html index 35b9bc4ff8..31a8537b6c 100644 --- a/docs/dyn/saasservicemgmt_v1.projects.locations.saas.html +++ b/docs/dyn/saasservicemgmt_v1.projects.locations.saas.html @@ -114,6 +114,12 @@

Method Details

"annotations": { # Optional. Annotations is an unstructured key-value map stored with a resource that may be set by external tools to store and retrieve arbitrary metadata. They are not queryable and should be preserved when modifying objects. More info: https://kubernetes.io/docs/user-guide/annotations "a_key": "A String", }, + "applicationTemplate": { # CompositeRef represents a reference to a composite resource. # Optional. Reference to composite ApplicationTemplate. When specified, the template components will be imported into their equivalent UnitKind, Release and Blueprint resources. Deleted references will not delete imported resources. Should only be specified on source regions, and be unspecified on replica regions. + "applicationTemplate": "A String", # Required. Reference to the ApplicationTemplate resource. + "revision": "A String", # Optional. Revision of the ApplicationTemplate to use. Changes to revision will trigger manual resynchronization. If empty, ApplicationTemplate will be ignored. + "syncOperation": "A String", # Output only. Reference to on-going AppTemplate import and replication operation (i.e. the operation_id for the long-running operation). This field is opaque for external usage. + }, + "blueprintRepo": "A String", # Output only. Name of repository in Artifact Registry for system-generated Blueprints, eg. Blueprints of imported ApplicationTemplates. "conditions": [ # Output only. A set of conditions which indicate the various conditions this resource can have. { # SaasCondition describes the status of a Saas. "lastTransitionTime": "A String", # Required. Last time the condition transited from one status to another. @@ -163,6 +169,12 @@

Method Details

"annotations": { # Optional. Annotations is an unstructured key-value map stored with a resource that may be set by external tools to store and retrieve arbitrary metadata. They are not queryable and should be preserved when modifying objects. More info: https://kubernetes.io/docs/user-guide/annotations "a_key": "A String", }, + "applicationTemplate": { # CompositeRef represents a reference to a composite resource. # Optional. Reference to composite ApplicationTemplate. When specified, the template components will be imported into their equivalent UnitKind, Release and Blueprint resources. Deleted references will not delete imported resources. Should only be specified on source regions, and be unspecified on replica regions. + "applicationTemplate": "A String", # Required. Reference to the ApplicationTemplate resource. + "revision": "A String", # Optional. Revision of the ApplicationTemplate to use. Changes to revision will trigger manual resynchronization. If empty, ApplicationTemplate will be ignored. + "syncOperation": "A String", # Output only. Reference to on-going AppTemplate import and replication operation (i.e. the operation_id for the long-running operation). This field is opaque for external usage. + }, + "blueprintRepo": "A String", # Output only. Name of repository in Artifact Registry for system-generated Blueprints, eg. Blueprints of imported ApplicationTemplates. "conditions": [ # Output only. A set of conditions which indicate the various conditions this resource can have. { # SaasCondition describes the status of a Saas. "lastTransitionTime": "A String", # Required. Last time the condition transited from one status to another. @@ -237,6 +249,12 @@

Method Details

"annotations": { # Optional. Annotations is an unstructured key-value map stored with a resource that may be set by external tools to store and retrieve arbitrary metadata. They are not queryable and should be preserved when modifying objects. More info: https://kubernetes.io/docs/user-guide/annotations "a_key": "A String", }, + "applicationTemplate": { # CompositeRef represents a reference to a composite resource. # Optional. Reference to composite ApplicationTemplate. When specified, the template components will be imported into their equivalent UnitKind, Release and Blueprint resources. Deleted references will not delete imported resources. Should only be specified on source regions, and be unspecified on replica regions. + "applicationTemplate": "A String", # Required. Reference to the ApplicationTemplate resource. + "revision": "A String", # Optional. Revision of the ApplicationTemplate to use. Changes to revision will trigger manual resynchronization. If empty, ApplicationTemplate will be ignored. + "syncOperation": "A String", # Output only. Reference to on-going AppTemplate import and replication operation (i.e. the operation_id for the long-running operation). This field is opaque for external usage. + }, + "blueprintRepo": "A String", # Output only. Name of repository in Artifact Registry for system-generated Blueprints, eg. Blueprints of imported ApplicationTemplates. "conditions": [ # Output only. A set of conditions which indicate the various conditions this resource can have. { # SaasCondition describes the status of a Saas. "lastTransitionTime": "A String", # Required. Last time the condition transited from one status to another. @@ -297,6 +315,12 @@

Method Details

"annotations": { # Optional. Annotations is an unstructured key-value map stored with a resource that may be set by external tools to store and retrieve arbitrary metadata. They are not queryable and should be preserved when modifying objects. More info: https://kubernetes.io/docs/user-guide/annotations "a_key": "A String", }, + "applicationTemplate": { # CompositeRef represents a reference to a composite resource. # Optional. Reference to composite ApplicationTemplate. When specified, the template components will be imported into their equivalent UnitKind, Release and Blueprint resources. Deleted references will not delete imported resources. Should only be specified on source regions, and be unspecified on replica regions. + "applicationTemplate": "A String", # Required. Reference to the ApplicationTemplate resource. + "revision": "A String", # Optional. Revision of the ApplicationTemplate to use. Changes to revision will trigger manual resynchronization. If empty, ApplicationTemplate will be ignored. + "syncOperation": "A String", # Output only. Reference to on-going AppTemplate import and replication operation (i.e. the operation_id for the long-running operation). This field is opaque for external usage. + }, + "blueprintRepo": "A String", # Output only. Name of repository in Artifact Registry for system-generated Blueprints, eg. Blueprints of imported ApplicationTemplates. "conditions": [ # Output only. A set of conditions which indicate the various conditions this resource can have. { # SaasCondition describes the status of a Saas. "lastTransitionTime": "A String", # Required. Last time the condition transited from one status to another. @@ -364,6 +388,12 @@

Method Details

"annotations": { # Optional. Annotations is an unstructured key-value map stored with a resource that may be set by external tools to store and retrieve arbitrary metadata. They are not queryable and should be preserved when modifying objects. More info: https://kubernetes.io/docs/user-guide/annotations "a_key": "A String", }, + "applicationTemplate": { # CompositeRef represents a reference to a composite resource. # Optional. Reference to composite ApplicationTemplate. When specified, the template components will be imported into their equivalent UnitKind, Release and Blueprint resources. Deleted references will not delete imported resources. Should only be specified on source regions, and be unspecified on replica regions. + "applicationTemplate": "A String", # Required. Reference to the ApplicationTemplate resource. + "revision": "A String", # Optional. Revision of the ApplicationTemplate to use. Changes to revision will trigger manual resynchronization. If empty, ApplicationTemplate will be ignored. + "syncOperation": "A String", # Output only. Reference to on-going AppTemplate import and replication operation (i.e. the operation_id for the long-running operation). This field is opaque for external usage. + }, + "blueprintRepo": "A String", # Output only. Name of repository in Artifact Registry for system-generated Blueprints, eg. Blueprints of imported ApplicationTemplates. "conditions": [ # Output only. A set of conditions which indicate the various conditions this resource can have. { # SaasCondition describes the status of a Saas. "lastTransitionTime": "A String", # Required. Last time the condition transited from one status to another. @@ -413,6 +443,12 @@

Method Details

"annotations": { # Optional. Annotations is an unstructured key-value map stored with a resource that may be set by external tools to store and retrieve arbitrary metadata. They are not queryable and should be preserved when modifying objects. More info: https://kubernetes.io/docs/user-guide/annotations "a_key": "A String", }, + "applicationTemplate": { # CompositeRef represents a reference to a composite resource. # Optional. Reference to composite ApplicationTemplate. When specified, the template components will be imported into their equivalent UnitKind, Release and Blueprint resources. Deleted references will not delete imported resources. Should only be specified on source regions, and be unspecified on replica regions. + "applicationTemplate": "A String", # Required. Reference to the ApplicationTemplate resource. + "revision": "A String", # Optional. Revision of the ApplicationTemplate to use. Changes to revision will trigger manual resynchronization. If empty, ApplicationTemplate will be ignored. + "syncOperation": "A String", # Output only. Reference to on-going AppTemplate import and replication operation (i.e. the operation_id for the long-running operation). This field is opaque for external usage. + }, + "blueprintRepo": "A String", # Output only. Name of repository in Artifact Registry for system-generated Blueprints, eg. Blueprints of imported ApplicationTemplates. "conditions": [ # Output only. A set of conditions which indicate the various conditions this resource can have. { # SaasCondition describes the status of a Saas. "lastTransitionTime": "A String", # Required. Last time the condition transited from one status to another. diff --git a/docs/dyn/saasservicemgmt_v1.projects.locations.unitKinds.html b/docs/dyn/saasservicemgmt_v1.projects.locations.unitKinds.html index 292b8d56ef..ac200e6abe 100644 --- a/docs/dyn/saasservicemgmt_v1.projects.locations.unitKinds.html +++ b/docs/dyn/saasservicemgmt_v1.projects.locations.unitKinds.html @@ -114,11 +114,23 @@

Method Details

"annotations": { # Optional. Annotations is an unstructured key-value map stored with a resource that may be set by external tools to store and retrieve arbitrary metadata. They are not queryable and should be preserved when modifying objects. More info: https://kubernetes.io/docs/user-guide/annotations "a_key": "A String", }, + "appParams": { # AppParams contains the parameters for creating an AppHub Application. # Optional. AppParams contains the parameters for creating an AppHub Application. + "group": "A String", # Optional. Grouping used to construct the name of the AppHub Application. Multiple UnitKinds can specify the same group to use the same Application across their respective units. Corresponds to the app_boundary_id in the ADC composite ApplicationTemplate. Defaults to UnitKind.name + "scope": { # Scope of an application. # Optional. Corresponds to the scope in the ADC composite ApplicationTemplate. Defaults to TYPE_REGIONAL. + "type": "A String", # Required. Scope Type. + }, + }, + "applicationTemplateComponent": { # ComponentRef represents a reference to a component resource. # Optional. Reference to component and revision in a composite ApplicationTemplate. + "component": "A String", # Optional. Name of the component in composite.Components + "compositeRef": { # CompositeRef represents a reference to a composite resource. # Optional. Reference to the Composite ApplicationTemplate. + "applicationTemplate": "A String", # Required. Reference to the ApplicationTemplate resource. + "revision": "A String", # Optional. Revision of the ApplicationTemplate to use. Changes to revision will trigger manual resynchronization. If empty, ApplicationTemplate will be ignored. + "syncOperation": "A String", # Output only. Reference to on-going AppTemplate import and replication operation (i.e. the operation_id for the long-running operation). This field is opaque for external usage. + }, + "revision": "A String", # Optional. Revision of the component. If the component does not have a revision, this field will be explicitly set to the revision of the composite ApplicationTemplate. + }, "boundaryType": "A String", # Optional. Output only. BoundaryType describes the type of boundary the Unit Kind represents. "createTime": "A String", # Output only. The timestamp when the resource was created. - "defaultFlagRevisions": [ # Optional. Default revisions of flags for this UnitKind. Newly created units will use the flag default_flag_revisions present at the time of creation. - "A String", - ], "defaultRelease": "A String", # Optional. A reference to the Release object to use as default for creating new units of this UnitKind (optional). If not specified, a new unit must explicitly reference which release to use for its creation. "deleteTime": "A String", # Output only. The timestamp when the resource was marked for deletion (deletion is an asynchronous operation). "dependencies": [ # Optional. Immutable. List of other unit kinds that this release will depend on. Dependencies will be automatically provisioned if not found. Maximum 10. @@ -180,11 +192,23 @@

Method Details

"annotations": { # Optional. Annotations is an unstructured key-value map stored with a resource that may be set by external tools to store and retrieve arbitrary metadata. They are not queryable and should be preserved when modifying objects. More info: https://kubernetes.io/docs/user-guide/annotations "a_key": "A String", }, + "appParams": { # AppParams contains the parameters for creating an AppHub Application. # Optional. AppParams contains the parameters for creating an AppHub Application. + "group": "A String", # Optional. Grouping used to construct the name of the AppHub Application. Multiple UnitKinds can specify the same group to use the same Application across their respective units. Corresponds to the app_boundary_id in the ADC composite ApplicationTemplate. Defaults to UnitKind.name + "scope": { # Scope of an application. # Optional. Corresponds to the scope in the ADC composite ApplicationTemplate. Defaults to TYPE_REGIONAL. + "type": "A String", # Required. Scope Type. + }, + }, + "applicationTemplateComponent": { # ComponentRef represents a reference to a component resource. # Optional. Reference to component and revision in a composite ApplicationTemplate. + "component": "A String", # Optional. Name of the component in composite.Components + "compositeRef": { # CompositeRef represents a reference to a composite resource. # Optional. Reference to the Composite ApplicationTemplate. + "applicationTemplate": "A String", # Required. Reference to the ApplicationTemplate resource. + "revision": "A String", # Optional. Revision of the ApplicationTemplate to use. Changes to revision will trigger manual resynchronization. If empty, ApplicationTemplate will be ignored. + "syncOperation": "A String", # Output only. Reference to on-going AppTemplate import and replication operation (i.e. the operation_id for the long-running operation). This field is opaque for external usage. + }, + "revision": "A String", # Optional. Revision of the component. If the component does not have a revision, this field will be explicitly set to the revision of the composite ApplicationTemplate. + }, "boundaryType": "A String", # Optional. Output only. BoundaryType describes the type of boundary the Unit Kind represents. "createTime": "A String", # Output only. The timestamp when the resource was created. - "defaultFlagRevisions": [ # Optional. Default revisions of flags for this UnitKind. Newly created units will use the flag default_flag_revisions present at the time of creation. - "A String", - ], "defaultRelease": "A String", # Optional. A reference to the Release object to use as default for creating new units of this UnitKind (optional). If not specified, a new unit must explicitly reference which release to use for its creation. "deleteTime": "A String", # Output only. The timestamp when the resource was marked for deletion (deletion is an asynchronous operation). "dependencies": [ # Optional. Immutable. List of other unit kinds that this release will depend on. Dependencies will be automatically provisioned if not found. Maximum 10. @@ -271,11 +295,23 @@

Method Details

"annotations": { # Optional. Annotations is an unstructured key-value map stored with a resource that may be set by external tools to store and retrieve arbitrary metadata. They are not queryable and should be preserved when modifying objects. More info: https://kubernetes.io/docs/user-guide/annotations "a_key": "A String", }, + "appParams": { # AppParams contains the parameters for creating an AppHub Application. # Optional. AppParams contains the parameters for creating an AppHub Application. + "group": "A String", # Optional. Grouping used to construct the name of the AppHub Application. Multiple UnitKinds can specify the same group to use the same Application across their respective units. Corresponds to the app_boundary_id in the ADC composite ApplicationTemplate. Defaults to UnitKind.name + "scope": { # Scope of an application. # Optional. Corresponds to the scope in the ADC composite ApplicationTemplate. Defaults to TYPE_REGIONAL. + "type": "A String", # Required. Scope Type. + }, + }, + "applicationTemplateComponent": { # ComponentRef represents a reference to a component resource. # Optional. Reference to component and revision in a composite ApplicationTemplate. + "component": "A String", # Optional. Name of the component in composite.Components + "compositeRef": { # CompositeRef represents a reference to a composite resource. # Optional. Reference to the Composite ApplicationTemplate. + "applicationTemplate": "A String", # Required. Reference to the ApplicationTemplate resource. + "revision": "A String", # Optional. Revision of the ApplicationTemplate to use. Changes to revision will trigger manual resynchronization. If empty, ApplicationTemplate will be ignored. + "syncOperation": "A String", # Output only. Reference to on-going AppTemplate import and replication operation (i.e. the operation_id for the long-running operation). This field is opaque for external usage. + }, + "revision": "A String", # Optional. Revision of the component. If the component does not have a revision, this field will be explicitly set to the revision of the composite ApplicationTemplate. + }, "boundaryType": "A String", # Optional. Output only. BoundaryType describes the type of boundary the Unit Kind represents. "createTime": "A String", # Output only. The timestamp when the resource was created. - "defaultFlagRevisions": [ # Optional. Default revisions of flags for this UnitKind. Newly created units will use the flag default_flag_revisions present at the time of creation. - "A String", - ], "defaultRelease": "A String", # Optional. A reference to the Release object to use as default for creating new units of this UnitKind (optional). If not specified, a new unit must explicitly reference which release to use for its creation. "deleteTime": "A String", # Output only. The timestamp when the resource was marked for deletion (deletion is an asynchronous operation). "dependencies": [ # Optional. Immutable. List of other unit kinds that this release will depend on. Dependencies will be automatically provisioned if not found. Maximum 10. @@ -348,11 +384,23 @@

Method Details

"annotations": { # Optional. Annotations is an unstructured key-value map stored with a resource that may be set by external tools to store and retrieve arbitrary metadata. They are not queryable and should be preserved when modifying objects. More info: https://kubernetes.io/docs/user-guide/annotations "a_key": "A String", }, + "appParams": { # AppParams contains the parameters for creating an AppHub Application. # Optional. AppParams contains the parameters for creating an AppHub Application. + "group": "A String", # Optional. Grouping used to construct the name of the AppHub Application. Multiple UnitKinds can specify the same group to use the same Application across their respective units. Corresponds to the app_boundary_id in the ADC composite ApplicationTemplate. Defaults to UnitKind.name + "scope": { # Scope of an application. # Optional. Corresponds to the scope in the ADC composite ApplicationTemplate. Defaults to TYPE_REGIONAL. + "type": "A String", # Required. Scope Type. + }, + }, + "applicationTemplateComponent": { # ComponentRef represents a reference to a component resource. # Optional. Reference to component and revision in a composite ApplicationTemplate. + "component": "A String", # Optional. Name of the component in composite.Components + "compositeRef": { # CompositeRef represents a reference to a composite resource. # Optional. Reference to the Composite ApplicationTemplate. + "applicationTemplate": "A String", # Required. Reference to the ApplicationTemplate resource. + "revision": "A String", # Optional. Revision of the ApplicationTemplate to use. Changes to revision will trigger manual resynchronization. If empty, ApplicationTemplate will be ignored. + "syncOperation": "A String", # Output only. Reference to on-going AppTemplate import and replication operation (i.e. the operation_id for the long-running operation). This field is opaque for external usage. + }, + "revision": "A String", # Optional. Revision of the component. If the component does not have a revision, this field will be explicitly set to the revision of the composite ApplicationTemplate. + }, "boundaryType": "A String", # Optional. Output only. BoundaryType describes the type of boundary the Unit Kind represents. "createTime": "A String", # Output only. The timestamp when the resource was created. - "defaultFlagRevisions": [ # Optional. Default revisions of flags for this UnitKind. Newly created units will use the flag default_flag_revisions present at the time of creation. - "A String", - ], "defaultRelease": "A String", # Optional. A reference to the Release object to use as default for creating new units of this UnitKind (optional). If not specified, a new unit must explicitly reference which release to use for its creation. "deleteTime": "A String", # Output only. The timestamp when the resource was marked for deletion (deletion is an asynchronous operation). "dependencies": [ # Optional. Immutable. List of other unit kinds that this release will depend on. Dependencies will be automatically provisioned if not found. Maximum 10. @@ -432,11 +480,23 @@

Method Details

"annotations": { # Optional. Annotations is an unstructured key-value map stored with a resource that may be set by external tools to store and retrieve arbitrary metadata. They are not queryable and should be preserved when modifying objects. More info: https://kubernetes.io/docs/user-guide/annotations "a_key": "A String", }, + "appParams": { # AppParams contains the parameters for creating an AppHub Application. # Optional. AppParams contains the parameters for creating an AppHub Application. + "group": "A String", # Optional. Grouping used to construct the name of the AppHub Application. Multiple UnitKinds can specify the same group to use the same Application across their respective units. Corresponds to the app_boundary_id in the ADC composite ApplicationTemplate. Defaults to UnitKind.name + "scope": { # Scope of an application. # Optional. Corresponds to the scope in the ADC composite ApplicationTemplate. Defaults to TYPE_REGIONAL. + "type": "A String", # Required. Scope Type. + }, + }, + "applicationTemplateComponent": { # ComponentRef represents a reference to a component resource. # Optional. Reference to component and revision in a composite ApplicationTemplate. + "component": "A String", # Optional. Name of the component in composite.Components + "compositeRef": { # CompositeRef represents a reference to a composite resource. # Optional. Reference to the Composite ApplicationTemplate. + "applicationTemplate": "A String", # Required. Reference to the ApplicationTemplate resource. + "revision": "A String", # Optional. Revision of the ApplicationTemplate to use. Changes to revision will trigger manual resynchronization. If empty, ApplicationTemplate will be ignored. + "syncOperation": "A String", # Output only. Reference to on-going AppTemplate import and replication operation (i.e. the operation_id for the long-running operation). This field is opaque for external usage. + }, + "revision": "A String", # Optional. Revision of the component. If the component does not have a revision, this field will be explicitly set to the revision of the composite ApplicationTemplate. + }, "boundaryType": "A String", # Optional. Output only. BoundaryType describes the type of boundary the Unit Kind represents. "createTime": "A String", # Output only. The timestamp when the resource was created. - "defaultFlagRevisions": [ # Optional. Default revisions of flags for this UnitKind. Newly created units will use the flag default_flag_revisions present at the time of creation. - "A String", - ], "defaultRelease": "A String", # Optional. A reference to the Release object to use as default for creating new units of this UnitKind (optional). If not specified, a new unit must explicitly reference which release to use for its creation. "deleteTime": "A String", # Output only. The timestamp when the resource was marked for deletion (deletion is an asynchronous operation). "dependencies": [ # Optional. Immutable. List of other unit kinds that this release will depend on. Dependencies will be automatically provisioned if not found. Maximum 10. @@ -498,11 +558,23 @@

Method Details

"annotations": { # Optional. Annotations is an unstructured key-value map stored with a resource that may be set by external tools to store and retrieve arbitrary metadata. They are not queryable and should be preserved when modifying objects. More info: https://kubernetes.io/docs/user-guide/annotations "a_key": "A String", }, + "appParams": { # AppParams contains the parameters for creating an AppHub Application. # Optional. AppParams contains the parameters for creating an AppHub Application. + "group": "A String", # Optional. Grouping used to construct the name of the AppHub Application. Multiple UnitKinds can specify the same group to use the same Application across their respective units. Corresponds to the app_boundary_id in the ADC composite ApplicationTemplate. Defaults to UnitKind.name + "scope": { # Scope of an application. # Optional. Corresponds to the scope in the ADC composite ApplicationTemplate. Defaults to TYPE_REGIONAL. + "type": "A String", # Required. Scope Type. + }, + }, + "applicationTemplateComponent": { # ComponentRef represents a reference to a component resource. # Optional. Reference to component and revision in a composite ApplicationTemplate. + "component": "A String", # Optional. Name of the component in composite.Components + "compositeRef": { # CompositeRef represents a reference to a composite resource. # Optional. Reference to the Composite ApplicationTemplate. + "applicationTemplate": "A String", # Required. Reference to the ApplicationTemplate resource. + "revision": "A String", # Optional. Revision of the ApplicationTemplate to use. Changes to revision will trigger manual resynchronization. If empty, ApplicationTemplate will be ignored. + "syncOperation": "A String", # Output only. Reference to on-going AppTemplate import and replication operation (i.e. the operation_id for the long-running operation). This field is opaque for external usage. + }, + "revision": "A String", # Optional. Revision of the component. If the component does not have a revision, this field will be explicitly set to the revision of the composite ApplicationTemplate. + }, "boundaryType": "A String", # Optional. Output only. BoundaryType describes the type of boundary the Unit Kind represents. "createTime": "A String", # Output only. The timestamp when the resource was created. - "defaultFlagRevisions": [ # Optional. Default revisions of flags for this UnitKind. Newly created units will use the flag default_flag_revisions present at the time of creation. - "A String", - ], "defaultRelease": "A String", # Optional. A reference to the Release object to use as default for creating new units of this UnitKind (optional). If not specified, a new unit must explicitly reference which release to use for its creation. "deleteTime": "A String", # Output only. The timestamp when the resource was marked for deletion (deletion is an asynchronous operation). "dependencies": [ # Optional. Immutable. List of other unit kinds that this release will depend on. Dependencies will be automatically provisioned if not found. Maximum 10. diff --git a/docs/dyn/saasservicemgmt_v1.projects.locations.unitOperations.html b/docs/dyn/saasservicemgmt_v1.projects.locations.unitOperations.html index fd4d02ff5f..9aed8c569d 100644 --- a/docs/dyn/saasservicemgmt_v1.projects.locations.unitOperations.html +++ b/docs/dyn/saasservicemgmt_v1.projects.locations.unitOperations.html @@ -131,9 +131,6 @@

Method Details

"engineState": "A String", # Optional. Output only. The engine state for on-going deployment engine operation(s). This field is opaque for external usage. "errorCategory": "A String", # Optional. Output only. UnitOperationErrorCategory describe the error category. "etag": "A String", # Output only. An opaque value that uniquely identifies a version or generation of a resource. It can be used to confirm that the client and server agree on the ordering of a resource being written. - "flagUpdate": { # FlagUpdate is a UnitOperation that pushes new flag values to Units. # Optional. Flag update operation. - "flagRelease": "A String", # Required. Flag release being applied by UnitOperation. - }, "labels": { # Optional. The labels on the resource, which can be used for categorization. similar to Kubernetes resource labels. "a_key": "A String", }, @@ -201,9 +198,6 @@

Method Details

"engineState": "A String", # Optional. Output only. The engine state for on-going deployment engine operation(s). This field is opaque for external usage. "errorCategory": "A String", # Optional. Output only. UnitOperationErrorCategory describe the error category. "etag": "A String", # Output only. An opaque value that uniquely identifies a version or generation of a resource. It can be used to confirm that the client and server agree on the ordering of a resource being written. - "flagUpdate": { # FlagUpdate is a UnitOperation that pushes new flag values to Units. # Optional. Flag update operation. - "flagRelease": "A String", # Required. Flag release being applied by UnitOperation. - }, "labels": { # Optional. The labels on the resource, which can be used for categorization. similar to Kubernetes resource labels. "a_key": "A String", }, @@ -296,9 +290,6 @@

Method Details

"engineState": "A String", # Optional. Output only. The engine state for on-going deployment engine operation(s). This field is opaque for external usage. "errorCategory": "A String", # Optional. Output only. UnitOperationErrorCategory describe the error category. "etag": "A String", # Output only. An opaque value that uniquely identifies a version or generation of a resource. It can be used to confirm that the client and server agree on the ordering of a resource being written. - "flagUpdate": { # FlagUpdate is a UnitOperation that pushes new flag values to Units. # Optional. Flag update operation. - "flagRelease": "A String", # Required. Flag release being applied by UnitOperation. - }, "labels": { # Optional. The labels on the resource, which can be used for categorization. similar to Kubernetes resource labels. "a_key": "A String", }, @@ -377,9 +368,6 @@

Method Details

"engineState": "A String", # Optional. Output only. The engine state for on-going deployment engine operation(s). This field is opaque for external usage. "errorCategory": "A String", # Optional. Output only. UnitOperationErrorCategory describe the error category. "etag": "A String", # Output only. An opaque value that uniquely identifies a version or generation of a resource. It can be used to confirm that the client and server agree on the ordering of a resource being written. - "flagUpdate": { # FlagUpdate is a UnitOperation that pushes new flag values to Units. # Optional. Flag update operation. - "flagRelease": "A String", # Required. Flag release being applied by UnitOperation. - }, "labels": { # Optional. The labels on the resource, which can be used for categorization. similar to Kubernetes resource labels. "a_key": "A String", }, @@ -465,9 +453,6 @@

Method Details

"engineState": "A String", # Optional. Output only. The engine state for on-going deployment engine operation(s). This field is opaque for external usage. "errorCategory": "A String", # Optional. Output only. UnitOperationErrorCategory describe the error category. "etag": "A String", # Output only. An opaque value that uniquely identifies a version or generation of a resource. It can be used to confirm that the client and server agree on the ordering of a resource being written. - "flagUpdate": { # FlagUpdate is a UnitOperation that pushes new flag values to Units. # Optional. Flag update operation. - "flagRelease": "A String", # Required. Flag release being applied by UnitOperation. - }, "labels": { # Optional. The labels on the resource, which can be used for categorization. similar to Kubernetes resource labels. "a_key": "A String", }, @@ -535,9 +520,6 @@

Method Details

"engineState": "A String", # Optional. Output only. The engine state for on-going deployment engine operation(s). This field is opaque for external usage. "errorCategory": "A String", # Optional. Output only. UnitOperationErrorCategory describe the error category. "etag": "A String", # Output only. An opaque value that uniquely identifies a version or generation of a resource. It can be used to confirm that the client and server agree on the ordering of a resource being written. - "flagUpdate": { # FlagUpdate is a UnitOperation that pushes new flag values to Units. # Optional. Flag update operation. - "flagRelease": "A String", # Required. Flag release being applied by UnitOperation. - }, "labels": { # Optional. The labels on the resource, which can be used for categorization. similar to Kubernetes resource labels. "a_key": "A String", }, diff --git a/docs/dyn/saasservicemgmt_v1.projects.locations.units.html b/docs/dyn/saasservicemgmt_v1.projects.locations.units.html index f4e1a5acca..2c41be88f2 100644 --- a/docs/dyn/saasservicemgmt_v1.projects.locations.units.html +++ b/docs/dyn/saasservicemgmt_v1.projects.locations.units.html @@ -114,6 +114,7 @@

Method Details

"annotations": { # Optional. Annotations is an unstructured key-value map stored with a resource that may be set by external tools to store and retrieve arbitrary metadata. They are not queryable and should be preserved when modifying objects. More info: https://kubernetes.io/docs/user-guide/annotations "a_key": "A String", }, + "application": "A String", # Optional. Reference to the AppHub Application this unit belongs to. All resources deployed in this Unit will be associated with the specified Application. "conditions": [ # Optional. Output only. A set of conditions which indicate the various conditions this resource can have. { # UnitCondition describes the status of an Unit. UnitCondition is individual components that contribute to an overall state. "lastTransitionTime": "A String", # Required. Last time the condition transited from one status to another. @@ -137,9 +138,6 @@

Method Details

}, ], "etag": "A String", # Output only. An opaque value that uniquely identifies a version or generation of a resource. It can be used to confirm that the client and server agree on the ordering of a resource being written. - "flagRevisions": [ # Optional. Output only. Flag revisions used by this Unit. - "A String", - ], "inputVariables": [ # Optional. Output only. Indicates the current input variables deployed by the unit { # UnitVariable describes a parameter for a Unit. "type": "A String", # Optional. Immutable. Name of a supported variable type. Supported types are string, int, bool. @@ -198,6 +196,7 @@

Method Details

"annotations": { # Optional. Annotations is an unstructured key-value map stored with a resource that may be set by external tools to store and retrieve arbitrary metadata. They are not queryable and should be preserved when modifying objects. More info: https://kubernetes.io/docs/user-guide/annotations "a_key": "A String", }, + "application": "A String", # Optional. Reference to the AppHub Application this unit belongs to. All resources deployed in this Unit will be associated with the specified Application. "conditions": [ # Optional. Output only. A set of conditions which indicate the various conditions this resource can have. { # UnitCondition describes the status of an Unit. UnitCondition is individual components that contribute to an overall state. "lastTransitionTime": "A String", # Required. Last time the condition transited from one status to another. @@ -221,9 +220,6 @@

Method Details

}, ], "etag": "A String", # Output only. An opaque value that uniquely identifies a version or generation of a resource. It can be used to confirm that the client and server agree on the ordering of a resource being written. - "flagRevisions": [ # Optional. Output only. Flag revisions used by this Unit. - "A String", - ], "inputVariables": [ # Optional. Output only. Indicates the current input variables deployed by the unit { # UnitVariable describes a parameter for a Unit. "type": "A String", # Optional. Immutable. Name of a supported variable type. Supported types are string, int, bool. @@ -307,6 +303,7 @@

Method Details

"annotations": { # Optional. Annotations is an unstructured key-value map stored with a resource that may be set by external tools to store and retrieve arbitrary metadata. They are not queryable and should be preserved when modifying objects. More info: https://kubernetes.io/docs/user-guide/annotations "a_key": "A String", }, + "application": "A String", # Optional. Reference to the AppHub Application this unit belongs to. All resources deployed in this Unit will be associated with the specified Application. "conditions": [ # Optional. Output only. A set of conditions which indicate the various conditions this resource can have. { # UnitCondition describes the status of an Unit. UnitCondition is individual components that contribute to an overall state. "lastTransitionTime": "A String", # Required. Last time the condition transited from one status to another. @@ -330,9 +327,6 @@

Method Details

}, ], "etag": "A String", # Output only. An opaque value that uniquely identifies a version or generation of a resource. It can be used to confirm that the client and server agree on the ordering of a resource being written. - "flagRevisions": [ # Optional. Output only. Flag revisions used by this Unit. - "A String", - ], "inputVariables": [ # Optional. Output only. Indicates the current input variables deployed by the unit { # UnitVariable describes a parameter for a Unit. "type": "A String", # Optional. Immutable. Name of a supported variable type. Supported types are string, int, bool. @@ -402,6 +396,7 @@

Method Details

"annotations": { # Optional. Annotations is an unstructured key-value map stored with a resource that may be set by external tools to store and retrieve arbitrary metadata. They are not queryable and should be preserved when modifying objects. More info: https://kubernetes.io/docs/user-guide/annotations "a_key": "A String", }, + "application": "A String", # Optional. Reference to the AppHub Application this unit belongs to. All resources deployed in this Unit will be associated with the specified Application. "conditions": [ # Optional. Output only. A set of conditions which indicate the various conditions this resource can have. { # UnitCondition describes the status of an Unit. UnitCondition is individual components that contribute to an overall state. "lastTransitionTime": "A String", # Required. Last time the condition transited from one status to another. @@ -425,9 +420,6 @@

Method Details

}, ], "etag": "A String", # Output only. An opaque value that uniquely identifies a version or generation of a resource. It can be used to confirm that the client and server agree on the ordering of a resource being written. - "flagRevisions": [ # Optional. Output only. Flag revisions used by this Unit. - "A String", - ], "inputVariables": [ # Optional. Output only. Indicates the current input variables deployed by the unit { # UnitVariable describes a parameter for a Unit. "type": "A String", # Optional. Immutable. Name of a supported variable type. Supported types are string, int, bool. @@ -504,6 +496,7 @@

Method Details

"annotations": { # Optional. Annotations is an unstructured key-value map stored with a resource that may be set by external tools to store and retrieve arbitrary metadata. They are not queryable and should be preserved when modifying objects. More info: https://kubernetes.io/docs/user-guide/annotations "a_key": "A String", }, + "application": "A String", # Optional. Reference to the AppHub Application this unit belongs to. All resources deployed in this Unit will be associated with the specified Application. "conditions": [ # Optional. Output only. A set of conditions which indicate the various conditions this resource can have. { # UnitCondition describes the status of an Unit. UnitCondition is individual components that contribute to an overall state. "lastTransitionTime": "A String", # Required. Last time the condition transited from one status to another. @@ -527,9 +520,6 @@

Method Details

}, ], "etag": "A String", # Output only. An opaque value that uniquely identifies a version or generation of a resource. It can be used to confirm that the client and server agree on the ordering of a resource being written. - "flagRevisions": [ # Optional. Output only. Flag revisions used by this Unit. - "A String", - ], "inputVariables": [ # Optional. Output only. Indicates the current input variables deployed by the unit { # UnitVariable describes a parameter for a Unit. "type": "A String", # Optional. Immutable. Name of a supported variable type. Supported types are string, int, bool. @@ -588,6 +578,7 @@

Method Details

"annotations": { # Optional. Annotations is an unstructured key-value map stored with a resource that may be set by external tools to store and retrieve arbitrary metadata. They are not queryable and should be preserved when modifying objects. More info: https://kubernetes.io/docs/user-guide/annotations "a_key": "A String", }, + "application": "A String", # Optional. Reference to the AppHub Application this unit belongs to. All resources deployed in this Unit will be associated with the specified Application. "conditions": [ # Optional. Output only. A set of conditions which indicate the various conditions this resource can have. { # UnitCondition describes the status of an Unit. UnitCondition is individual components that contribute to an overall state. "lastTransitionTime": "A String", # Required. Last time the condition transited from one status to another. @@ -611,9 +602,6 @@

Method Details

}, ], "etag": "A String", # Output only. An opaque value that uniquely identifies a version or generation of a resource. It can be used to confirm that the client and server agree on the ordering of a resource being written. - "flagRevisions": [ # Optional. Output only. Flag revisions used by this Unit. - "A String", - ], "inputVariables": [ # Optional. Output only. Indicates the current input variables deployed by the unit { # UnitVariable describes a parameter for a Unit. "type": "A String", # Optional. Immutable. Name of a supported variable type. Supported types are string, int, bool. diff --git a/docs/dyn/saasservicemgmt_v1beta1.projects.locations.flagRevisions.html b/docs/dyn/saasservicemgmt_v1beta1.projects.locations.flagRevisions.html index 1918519494..974ccce18d 100644 --- a/docs/dyn/saasservicemgmt_v1beta1.projects.locations.flagRevisions.html +++ b/docs/dyn/saasservicemgmt_v1beta1.projects.locations.flagRevisions.html @@ -133,7 +133,9 @@

Method Details

"attributes": [ # Optional. Names of the context attributes that are used in the evaluation rules and allocations. "A String", ], + "defaultAllocation": "A String", # Optional. The ID of an allocation to use as the default. "defaultTarget": "A String", # Optional. Deprecated: Use `base_target` instead. Default variant or allocation of the flag. + "defaultVariant": "A String", # Optional. The name of a variant to use as the default. "rules": [ # Optional. Evaluation rules define the logic for evaluating the flag against a given context. The rules are evaluated sequentially in their specified order. { # EvaluationRule defines a single rule for evaluating a feature flag. A rule consists of a condition that, if met, assigns a specific variant or allocation to the user. "allocationId": "A String", # Optional. The ID of an allocation to target. @@ -165,7 +167,7 @@

Method Details

"createTime": "A String", # Output only. The timestamp when the resource was created. "description": "A String", # Optional. Description of the flag. Max length: 500 bytes. "etag": "A String", # Output only. An opaque value that uniquely identifies a version or generation of a resource. It can be used to confirm that the client and server agree on the ordering of a resource being written. - "evaluationSpec": { # EvaluationSpec holds rules for evaluating the value of a flag. # Optional. Specification of how the flag value should be evaluated. If a bool flag is created without an evaluation_spec specified, two default variants, "Enabled" (with bool_value = true) and "Disabled" (with bool_value = false), are created by default, and "Disabled" is set as the default_target. + "evaluationSpec": { # EvaluationSpec holds rules for evaluating the value of a flag. # Optional. Specification of how the flag value should be evaluated. If a bool flag is created without an evaluation_spec specified, two default variants, "Enabled" (with boolean_value = true) and "Disabled" (with boolean_value = false), are created by default, and "Disabled" is set as the default_variant. "allocations": [ # Optional. A list of allocations. { # Allocation defines a set of weighted flag variants, specifying how traffic is split based on the randomization unit. "description": "A String", # Optional. Description of the allocation. Max length: 500 bytes. @@ -182,7 +184,9 @@

Method Details

"attributes": [ # Optional. Names of the context attributes that are used in the evaluation rules and allocations. "A String", ], + "defaultAllocation": "A String", # Optional. The ID of an allocation to use as the default. "defaultTarget": "A String", # Optional. Deprecated: Use `base_target` instead. Default variant or allocation of the flag. + "defaultVariant": "A String", # Optional. The name of a variant to use as the default. "rules": [ # Optional. Evaluation rules define the logic for evaluating the flag against a given context. The rules are evaluated sequentially in their specified order. { # EvaluationRule defines a single rule for evaluating a feature flag. A rule consists of a condition that, if met, assigns a specific variant or allocation to the user. "allocationId": "A String", # Optional. The ID of an allocation to target. @@ -264,7 +268,9 @@

Method Details

"attributes": [ # Optional. Names of the context attributes that are used in the evaluation rules and allocations. "A String", ], + "defaultAllocation": "A String", # Optional. The ID of an allocation to use as the default. "defaultTarget": "A String", # Optional. Deprecated: Use `base_target` instead. Default variant or allocation of the flag. + "defaultVariant": "A String", # Optional. The name of a variant to use as the default. "rules": [ # Optional. Evaluation rules define the logic for evaluating the flag against a given context. The rules are evaluated sequentially in their specified order. { # EvaluationRule defines a single rule for evaluating a feature flag. A rule consists of a condition that, if met, assigns a specific variant or allocation to the user. "allocationId": "A String", # Optional. The ID of an allocation to target. @@ -296,7 +302,7 @@

Method Details

"createTime": "A String", # Output only. The timestamp when the resource was created. "description": "A String", # Optional. Description of the flag. Max length: 500 bytes. "etag": "A String", # Output only. An opaque value that uniquely identifies a version or generation of a resource. It can be used to confirm that the client and server agree on the ordering of a resource being written. - "evaluationSpec": { # EvaluationSpec holds rules for evaluating the value of a flag. # Optional. Specification of how the flag value should be evaluated. If a bool flag is created without an evaluation_spec specified, two default variants, "Enabled" (with bool_value = true) and "Disabled" (with bool_value = false), are created by default, and "Disabled" is set as the default_target. + "evaluationSpec": { # EvaluationSpec holds rules for evaluating the value of a flag. # Optional. Specification of how the flag value should be evaluated. If a bool flag is created without an evaluation_spec specified, two default variants, "Enabled" (with boolean_value = true) and "Disabled" (with boolean_value = false), are created by default, and "Disabled" is set as the default_variant. "allocations": [ # Optional. A list of allocations. { # Allocation defines a set of weighted flag variants, specifying how traffic is split based on the randomization unit. "description": "A String", # Optional. Description of the allocation. Max length: 500 bytes. @@ -313,7 +319,9 @@

Method Details

"attributes": [ # Optional. Names of the context attributes that are used in the evaluation rules and allocations. "A String", ], + "defaultAllocation": "A String", # Optional. The ID of an allocation to use as the default. "defaultTarget": "A String", # Optional. Deprecated: Use `base_target` instead. Default variant or allocation of the flag. + "defaultVariant": "A String", # Optional. The name of a variant to use as the default. "rules": [ # Optional. Evaluation rules define the logic for evaluating the flag against a given context. The rules are evaluated sequentially in their specified order. { # EvaluationRule defines a single rule for evaluating a feature flag. A rule consists of a condition that, if met, assigns a specific variant or allocation to the user. "allocationId": "A String", # Optional. The ID of an allocation to target. @@ -420,7 +428,9 @@

Method Details

"attributes": [ # Optional. Names of the context attributes that are used in the evaluation rules and allocations. "A String", ], + "defaultAllocation": "A String", # Optional. The ID of an allocation to use as the default. "defaultTarget": "A String", # Optional. Deprecated: Use `base_target` instead. Default variant or allocation of the flag. + "defaultVariant": "A String", # Optional. The name of a variant to use as the default. "rules": [ # Optional. Evaluation rules define the logic for evaluating the flag against a given context. The rules are evaluated sequentially in their specified order. { # EvaluationRule defines a single rule for evaluating a feature flag. A rule consists of a condition that, if met, assigns a specific variant or allocation to the user. "allocationId": "A String", # Optional. The ID of an allocation to target. @@ -452,7 +462,7 @@

Method Details

"createTime": "A String", # Output only. The timestamp when the resource was created. "description": "A String", # Optional. Description of the flag. Max length: 500 bytes. "etag": "A String", # Output only. An opaque value that uniquely identifies a version or generation of a resource. It can be used to confirm that the client and server agree on the ordering of a resource being written. - "evaluationSpec": { # EvaluationSpec holds rules for evaluating the value of a flag. # Optional. Specification of how the flag value should be evaluated. If a bool flag is created without an evaluation_spec specified, two default variants, "Enabled" (with bool_value = true) and "Disabled" (with bool_value = false), are created by default, and "Disabled" is set as the default_target. + "evaluationSpec": { # EvaluationSpec holds rules for evaluating the value of a flag. # Optional. Specification of how the flag value should be evaluated. If a bool flag is created without an evaluation_spec specified, two default variants, "Enabled" (with boolean_value = true) and "Disabled" (with boolean_value = false), are created by default, and "Disabled" is set as the default_variant. "allocations": [ # Optional. A list of allocations. { # Allocation defines a set of weighted flag variants, specifying how traffic is split based on the randomization unit. "description": "A String", # Optional. Description of the allocation. Max length: 500 bytes. @@ -469,7 +479,9 @@

Method Details

"attributes": [ # Optional. Names of the context attributes that are used in the evaluation rules and allocations. "A String", ], + "defaultAllocation": "A String", # Optional. The ID of an allocation to use as the default. "defaultTarget": "A String", # Optional. Deprecated: Use `base_target` instead. Default variant or allocation of the flag. + "defaultVariant": "A String", # Optional. The name of a variant to use as the default. "rules": [ # Optional. Evaluation rules define the logic for evaluating the flag against a given context. The rules are evaluated sequentially in their specified order. { # EvaluationRule defines a single rule for evaluating a feature flag. A rule consists of a condition that, if met, assigns a specific variant or allocation to the user. "allocationId": "A String", # Optional. The ID of an allocation to target. @@ -561,7 +573,9 @@

Method Details

"attributes": [ # Optional. Names of the context attributes that are used in the evaluation rules and allocations. "A String", ], + "defaultAllocation": "A String", # Optional. The ID of an allocation to use as the default. "defaultTarget": "A String", # Optional. Deprecated: Use `base_target` instead. Default variant or allocation of the flag. + "defaultVariant": "A String", # Optional. The name of a variant to use as the default. "rules": [ # Optional. Evaluation rules define the logic for evaluating the flag against a given context. The rules are evaluated sequentially in their specified order. { # EvaluationRule defines a single rule for evaluating a feature flag. A rule consists of a condition that, if met, assigns a specific variant or allocation to the user. "allocationId": "A String", # Optional. The ID of an allocation to target. @@ -593,7 +607,7 @@

Method Details

"createTime": "A String", # Output only. The timestamp when the resource was created. "description": "A String", # Optional. Description of the flag. Max length: 500 bytes. "etag": "A String", # Output only. An opaque value that uniquely identifies a version or generation of a resource. It can be used to confirm that the client and server agree on the ordering of a resource being written. - "evaluationSpec": { # EvaluationSpec holds rules for evaluating the value of a flag. # Optional. Specification of how the flag value should be evaluated. If a bool flag is created without an evaluation_spec specified, two default variants, "Enabled" (with bool_value = true) and "Disabled" (with bool_value = false), are created by default, and "Disabled" is set as the default_target. + "evaluationSpec": { # EvaluationSpec holds rules for evaluating the value of a flag. # Optional. Specification of how the flag value should be evaluated. If a bool flag is created without an evaluation_spec specified, two default variants, "Enabled" (with boolean_value = true) and "Disabled" (with boolean_value = false), are created by default, and "Disabled" is set as the default_variant. "allocations": [ # Optional. A list of allocations. { # Allocation defines a set of weighted flag variants, specifying how traffic is split based on the randomization unit. "description": "A String", # Optional. Description of the allocation. Max length: 500 bytes. @@ -610,7 +624,9 @@

Method Details

"attributes": [ # Optional. Names of the context attributes that are used in the evaluation rules and allocations. "A String", ], + "defaultAllocation": "A String", # Optional. The ID of an allocation to use as the default. "defaultTarget": "A String", # Optional. Deprecated: Use `base_target` instead. Default variant or allocation of the flag. + "defaultVariant": "A String", # Optional. The name of a variant to use as the default. "rules": [ # Optional. Evaluation rules define the logic for evaluating the flag against a given context. The rules are evaluated sequentially in their specified order. { # EvaluationRule defines a single rule for evaluating a feature flag. A rule consists of a condition that, if met, assigns a specific variant or allocation to the user. "allocationId": "A String", # Optional. The ID of an allocation to target. @@ -711,7 +727,9 @@

Method Details

"attributes": [ # Optional. Names of the context attributes that are used in the evaluation rules and allocations. "A String", ], + "defaultAllocation": "A String", # Optional. The ID of an allocation to use as the default. "defaultTarget": "A String", # Optional. Deprecated: Use `base_target` instead. Default variant or allocation of the flag. + "defaultVariant": "A String", # Optional. The name of a variant to use as the default. "rules": [ # Optional. Evaluation rules define the logic for evaluating the flag against a given context. The rules are evaluated sequentially in their specified order. { # EvaluationRule defines a single rule for evaluating a feature flag. A rule consists of a condition that, if met, assigns a specific variant or allocation to the user. "allocationId": "A String", # Optional. The ID of an allocation to target. @@ -743,7 +761,7 @@

Method Details

"createTime": "A String", # Output only. The timestamp when the resource was created. "description": "A String", # Optional. Description of the flag. Max length: 500 bytes. "etag": "A String", # Output only. An opaque value that uniquely identifies a version or generation of a resource. It can be used to confirm that the client and server agree on the ordering of a resource being written. - "evaluationSpec": { # EvaluationSpec holds rules for evaluating the value of a flag. # Optional. Specification of how the flag value should be evaluated. If a bool flag is created without an evaluation_spec specified, two default variants, "Enabled" (with bool_value = true) and "Disabled" (with bool_value = false), are created by default, and "Disabled" is set as the default_target. + "evaluationSpec": { # EvaluationSpec holds rules for evaluating the value of a flag. # Optional. Specification of how the flag value should be evaluated. If a bool flag is created without an evaluation_spec specified, two default variants, "Enabled" (with boolean_value = true) and "Disabled" (with boolean_value = false), are created by default, and "Disabled" is set as the default_variant. "allocations": [ # Optional. A list of allocations. { # Allocation defines a set of weighted flag variants, specifying how traffic is split based on the randomization unit. "description": "A String", # Optional. Description of the allocation. Max length: 500 bytes. @@ -760,7 +778,9 @@

Method Details

"attributes": [ # Optional. Names of the context attributes that are used in the evaluation rules and allocations. "A String", ], + "defaultAllocation": "A String", # Optional. The ID of an allocation to use as the default. "defaultTarget": "A String", # Optional. Deprecated: Use `base_target` instead. Default variant or allocation of the flag. + "defaultVariant": "A String", # Optional. The name of a variant to use as the default. "rules": [ # Optional. Evaluation rules define the logic for evaluating the flag against a given context. The rules are evaluated sequentially in their specified order. { # EvaluationRule defines a single rule for evaluating a feature flag. A rule consists of a condition that, if met, assigns a specific variant or allocation to the user. "allocationId": "A String", # Optional. The ID of an allocation to target. @@ -842,7 +862,9 @@

Method Details

"attributes": [ # Optional. Names of the context attributes that are used in the evaluation rules and allocations. "A String", ], + "defaultAllocation": "A String", # Optional. The ID of an allocation to use as the default. "defaultTarget": "A String", # Optional. Deprecated: Use `base_target` instead. Default variant or allocation of the flag. + "defaultVariant": "A String", # Optional. The name of a variant to use as the default. "rules": [ # Optional. Evaluation rules define the logic for evaluating the flag against a given context. The rules are evaluated sequentially in their specified order. { # EvaluationRule defines a single rule for evaluating a feature flag. A rule consists of a condition that, if met, assigns a specific variant or allocation to the user. "allocationId": "A String", # Optional. The ID of an allocation to target. @@ -874,7 +896,7 @@

Method Details

"createTime": "A String", # Output only. The timestamp when the resource was created. "description": "A String", # Optional. Description of the flag. Max length: 500 bytes. "etag": "A String", # Output only. An opaque value that uniquely identifies a version or generation of a resource. It can be used to confirm that the client and server agree on the ordering of a resource being written. - "evaluationSpec": { # EvaluationSpec holds rules for evaluating the value of a flag. # Optional. Specification of how the flag value should be evaluated. If a bool flag is created without an evaluation_spec specified, two default variants, "Enabled" (with bool_value = true) and "Disabled" (with bool_value = false), are created by default, and "Disabled" is set as the default_target. + "evaluationSpec": { # EvaluationSpec holds rules for evaluating the value of a flag. # Optional. Specification of how the flag value should be evaluated. If a bool flag is created without an evaluation_spec specified, two default variants, "Enabled" (with boolean_value = true) and "Disabled" (with boolean_value = false), are created by default, and "Disabled" is set as the default_variant. "allocations": [ # Optional. A list of allocations. { # Allocation defines a set of weighted flag variants, specifying how traffic is split based on the randomization unit. "description": "A String", # Optional. Description of the allocation. Max length: 500 bytes. @@ -891,7 +913,9 @@

Method Details

"attributes": [ # Optional. Names of the context attributes that are used in the evaluation rules and allocations. "A String", ], + "defaultAllocation": "A String", # Optional. The ID of an allocation to use as the default. "defaultTarget": "A String", # Optional. Deprecated: Use `base_target` instead. Default variant or allocation of the flag. + "defaultVariant": "A String", # Optional. The name of a variant to use as the default. "rules": [ # Optional. Evaluation rules define the logic for evaluating the flag against a given context. The rules are evaluated sequentially in their specified order. { # EvaluationRule defines a single rule for evaluating a feature flag. A rule consists of a condition that, if met, assigns a specific variant or allocation to the user. "allocationId": "A String", # Optional. The ID of an allocation to target. diff --git a/docs/dyn/saasservicemgmt_v1beta1.projects.locations.flags.html b/docs/dyn/saasservicemgmt_v1beta1.projects.locations.flags.html index 359b743919..1c60e7d0df 100644 --- a/docs/dyn/saasservicemgmt_v1beta1.projects.locations.flags.html +++ b/docs/dyn/saasservicemgmt_v1beta1.projects.locations.flags.html @@ -117,7 +117,7 @@

Method Details

"createTime": "A String", # Output only. The timestamp when the resource was created. "description": "A String", # Optional. Description of the flag. Max length: 500 bytes. "etag": "A String", # Output only. An opaque value that uniquely identifies a version or generation of a resource. It can be used to confirm that the client and server agree on the ordering of a resource being written. - "evaluationSpec": { # EvaluationSpec holds rules for evaluating the value of a flag. # Optional. Specification of how the flag value should be evaluated. If a bool flag is created without an evaluation_spec specified, two default variants, "Enabled" (with bool_value = true) and "Disabled" (with bool_value = false), are created by default, and "Disabled" is set as the default_target. + "evaluationSpec": { # EvaluationSpec holds rules for evaluating the value of a flag. # Optional. Specification of how the flag value should be evaluated. If a bool flag is created without an evaluation_spec specified, two default variants, "Enabled" (with boolean_value = true) and "Disabled" (with boolean_value = false), are created by default, and "Disabled" is set as the default_variant. "allocations": [ # Optional. A list of allocations. { # Allocation defines a set of weighted flag variants, specifying how traffic is split based on the randomization unit. "description": "A String", # Optional. Description of the allocation. Max length: 500 bytes. @@ -134,7 +134,9 @@

Method Details

"attributes": [ # Optional. Names of the context attributes that are used in the evaluation rules and allocations. "A String", ], + "defaultAllocation": "A String", # Optional. The ID of an allocation to use as the default. "defaultTarget": "A String", # Optional. Deprecated: Use `base_target` instead. Default variant or allocation of the flag. + "defaultVariant": "A String", # Optional. The name of a variant to use as the default. "rules": [ # Optional. Evaluation rules define the logic for evaluating the flag against a given context. The rules are evaluated sequentially in their specified order. { # EvaluationRule defines a single rule for evaluating a feature flag. A rule consists of a condition that, if met, assigns a specific variant or allocation to the user. "allocationId": "A String", # Optional. The ID of an allocation to target. @@ -197,7 +199,7 @@

Method Details

"createTime": "A String", # Output only. The timestamp when the resource was created. "description": "A String", # Optional. Description of the flag. Max length: 500 bytes. "etag": "A String", # Output only. An opaque value that uniquely identifies a version or generation of a resource. It can be used to confirm that the client and server agree on the ordering of a resource being written. - "evaluationSpec": { # EvaluationSpec holds rules for evaluating the value of a flag. # Optional. Specification of how the flag value should be evaluated. If a bool flag is created without an evaluation_spec specified, two default variants, "Enabled" (with bool_value = true) and "Disabled" (with bool_value = false), are created by default, and "Disabled" is set as the default_target. + "evaluationSpec": { # EvaluationSpec holds rules for evaluating the value of a flag. # Optional. Specification of how the flag value should be evaluated. If a bool flag is created without an evaluation_spec specified, two default variants, "Enabled" (with boolean_value = true) and "Disabled" (with boolean_value = false), are created by default, and "Disabled" is set as the default_variant. "allocations": [ # Optional. A list of allocations. { # Allocation defines a set of weighted flag variants, specifying how traffic is split based on the randomization unit. "description": "A String", # Optional. Description of the allocation. Max length: 500 bytes. @@ -214,7 +216,9 @@

Method Details

"attributes": [ # Optional. Names of the context attributes that are used in the evaluation rules and allocations. "A String", ], + "defaultAllocation": "A String", # Optional. The ID of an allocation to use as the default. "defaultTarget": "A String", # Optional. Deprecated: Use `base_target` instead. Default variant or allocation of the flag. + "defaultVariant": "A String", # Optional. The name of a variant to use as the default. "rules": [ # Optional. Evaluation rules define the logic for evaluating the flag against a given context. The rules are evaluated sequentially in their specified order. { # EvaluationRule defines a single rule for evaluating a feature flag. A rule consists of a condition that, if met, assigns a specific variant or allocation to the user. "allocationId": "A String", # Optional. The ID of an allocation to target. @@ -302,7 +306,7 @@

Method Details

"createTime": "A String", # Output only. The timestamp when the resource was created. "description": "A String", # Optional. Description of the flag. Max length: 500 bytes. "etag": "A String", # Output only. An opaque value that uniquely identifies a version or generation of a resource. It can be used to confirm that the client and server agree on the ordering of a resource being written. - "evaluationSpec": { # EvaluationSpec holds rules for evaluating the value of a flag. # Optional. Specification of how the flag value should be evaluated. If a bool flag is created without an evaluation_spec specified, two default variants, "Enabled" (with bool_value = true) and "Disabled" (with bool_value = false), are created by default, and "Disabled" is set as the default_target. + "evaluationSpec": { # EvaluationSpec holds rules for evaluating the value of a flag. # Optional. Specification of how the flag value should be evaluated. If a bool flag is created without an evaluation_spec specified, two default variants, "Enabled" (with boolean_value = true) and "Disabled" (with boolean_value = false), are created by default, and "Disabled" is set as the default_variant. "allocations": [ # Optional. A list of allocations. { # Allocation defines a set of weighted flag variants, specifying how traffic is split based on the randomization unit. "description": "A String", # Optional. Description of the allocation. Max length: 500 bytes. @@ -319,7 +323,9 @@

Method Details

"attributes": [ # Optional. Names of the context attributes that are used in the evaluation rules and allocations. "A String", ], + "defaultAllocation": "A String", # Optional. The ID of an allocation to use as the default. "defaultTarget": "A String", # Optional. Deprecated: Use `base_target` instead. Default variant or allocation of the flag. + "defaultVariant": "A String", # Optional. The name of a variant to use as the default. "rules": [ # Optional. Evaluation rules define the logic for evaluating the flag against a given context. The rules are evaluated sequentially in their specified order. { # EvaluationRule defines a single rule for evaluating a feature flag. A rule consists of a condition that, if met, assigns a specific variant or allocation to the user. "allocationId": "A String", # Optional. The ID of an allocation to target. @@ -392,7 +398,7 @@

Method Details

"createTime": "A String", # Output only. The timestamp when the resource was created. "description": "A String", # Optional. Description of the flag. Max length: 500 bytes. "etag": "A String", # Output only. An opaque value that uniquely identifies a version or generation of a resource. It can be used to confirm that the client and server agree on the ordering of a resource being written. - "evaluationSpec": { # EvaluationSpec holds rules for evaluating the value of a flag. # Optional. Specification of how the flag value should be evaluated. If a bool flag is created without an evaluation_spec specified, two default variants, "Enabled" (with bool_value = true) and "Disabled" (with bool_value = false), are created by default, and "Disabled" is set as the default_target. + "evaluationSpec": { # EvaluationSpec holds rules for evaluating the value of a flag. # Optional. Specification of how the flag value should be evaluated. If a bool flag is created without an evaluation_spec specified, two default variants, "Enabled" (with boolean_value = true) and "Disabled" (with boolean_value = false), are created by default, and "Disabled" is set as the default_variant. "allocations": [ # Optional. A list of allocations. { # Allocation defines a set of weighted flag variants, specifying how traffic is split based on the randomization unit. "description": "A String", # Optional. Description of the allocation. Max length: 500 bytes. @@ -409,7 +415,9 @@

Method Details

"attributes": [ # Optional. Names of the context attributes that are used in the evaluation rules and allocations. "A String", ], + "defaultAllocation": "A String", # Optional. The ID of an allocation to use as the default. "defaultTarget": "A String", # Optional. Deprecated: Use `base_target` instead. Default variant or allocation of the flag. + "defaultVariant": "A String", # Optional. The name of a variant to use as the default. "rules": [ # Optional. Evaluation rules define the logic for evaluating the flag against a given context. The rules are evaluated sequentially in their specified order. { # EvaluationRule defines a single rule for evaluating a feature flag. A rule consists of a condition that, if met, assigns a specific variant or allocation to the user. "allocationId": "A String", # Optional. The ID of an allocation to target. @@ -491,7 +499,7 @@

Method Details

"createTime": "A String", # Output only. The timestamp when the resource was created. "description": "A String", # Optional. Description of the flag. Max length: 500 bytes. "etag": "A String", # Output only. An opaque value that uniquely identifies a version or generation of a resource. It can be used to confirm that the client and server agree on the ordering of a resource being written. - "evaluationSpec": { # EvaluationSpec holds rules for evaluating the value of a flag. # Optional. Specification of how the flag value should be evaluated. If a bool flag is created without an evaluation_spec specified, two default variants, "Enabled" (with bool_value = true) and "Disabled" (with bool_value = false), are created by default, and "Disabled" is set as the default_target. + "evaluationSpec": { # EvaluationSpec holds rules for evaluating the value of a flag. # Optional. Specification of how the flag value should be evaluated. If a bool flag is created without an evaluation_spec specified, two default variants, "Enabled" (with boolean_value = true) and "Disabled" (with boolean_value = false), are created by default, and "Disabled" is set as the default_variant. "allocations": [ # Optional. A list of allocations. { # Allocation defines a set of weighted flag variants, specifying how traffic is split based on the randomization unit. "description": "A String", # Optional. Description of the allocation. Max length: 500 bytes. @@ -508,7 +516,9 @@

Method Details

"attributes": [ # Optional. Names of the context attributes that are used in the evaluation rules and allocations. "A String", ], + "defaultAllocation": "A String", # Optional. The ID of an allocation to use as the default. "defaultTarget": "A String", # Optional. Deprecated: Use `base_target` instead. Default variant or allocation of the flag. + "defaultVariant": "A String", # Optional. The name of a variant to use as the default. "rules": [ # Optional. Evaluation rules define the logic for evaluating the flag against a given context. The rules are evaluated sequentially in their specified order. { # EvaluationRule defines a single rule for evaluating a feature flag. A rule consists of a condition that, if met, assigns a specific variant or allocation to the user. "allocationId": "A String", # Optional. The ID of an allocation to target. @@ -571,7 +581,7 @@

Method Details

"createTime": "A String", # Output only. The timestamp when the resource was created. "description": "A String", # Optional. Description of the flag. Max length: 500 bytes. "etag": "A String", # Output only. An opaque value that uniquely identifies a version or generation of a resource. It can be used to confirm that the client and server agree on the ordering of a resource being written. - "evaluationSpec": { # EvaluationSpec holds rules for evaluating the value of a flag. # Optional. Specification of how the flag value should be evaluated. If a bool flag is created without an evaluation_spec specified, two default variants, "Enabled" (with bool_value = true) and "Disabled" (with bool_value = false), are created by default, and "Disabled" is set as the default_target. + "evaluationSpec": { # EvaluationSpec holds rules for evaluating the value of a flag. # Optional. Specification of how the flag value should be evaluated. If a bool flag is created without an evaluation_spec specified, two default variants, "Enabled" (with boolean_value = true) and "Disabled" (with boolean_value = false), are created by default, and "Disabled" is set as the default_variant. "allocations": [ # Optional. A list of allocations. { # Allocation defines a set of weighted flag variants, specifying how traffic is split based on the randomization unit. "description": "A String", # Optional. Description of the allocation. Max length: 500 bytes. @@ -588,7 +598,9 @@

Method Details

"attributes": [ # Optional. Names of the context attributes that are used in the evaluation rules and allocations. "A String", ], + "defaultAllocation": "A String", # Optional. The ID of an allocation to use as the default. "defaultTarget": "A String", # Optional. Deprecated: Use `base_target` instead. Default variant or allocation of the flag. + "defaultVariant": "A String", # Optional. The name of a variant to use as the default. "rules": [ # Optional. Evaluation rules define the logic for evaluating the flag against a given context. The rules are evaluated sequentially in their specified order. { # EvaluationRule defines a single rule for evaluating a feature flag. A rule consists of a condition that, if met, assigns a specific variant or allocation to the user. "allocationId": "A String", # Optional. The ID of an allocation to target. diff --git a/docs/dyn/saasservicemgmt_v1beta1.projects.locations.releases.html b/docs/dyn/saasservicemgmt_v1beta1.projects.locations.releases.html index 17bd0fc0ef..666c70e076 100644 --- a/docs/dyn/saasservicemgmt_v1beta1.projects.locations.releases.html +++ b/docs/dyn/saasservicemgmt_v1beta1.projects.locations.releases.html @@ -116,7 +116,7 @@

Method Details

}, "applicationTemplateComponent": { # ComponentRef represents a reference to a component resource. # Output only. Reference to component and revision in a composite ApplicationTemplate. "component": "A String", # Optional. Name of the component in composite.Components - "compositeRef": { # CompositeRef represents a reference to a composite resource. # Reference to the Composite ApplicationTemplate. + "compositeRef": { # CompositeRef represents a reference to a composite resource. # Optional. Reference to the Composite ApplicationTemplate. "applicationTemplate": "A String", # Required. Reference to the ApplicationTemplate resource. "revision": "A String", # Optional. Revision of the ApplicationTemplate to use. Changes to revision will trigger manual resynchronization. If empty, ApplicationTemplate will be ignored. "syncOperation": "A String", # Output only. Reference to on-going AppTemplate import and replication operation (i.e. the operation_id for the long-running operation). This field is opaque for external usage. @@ -182,7 +182,7 @@

Method Details

}, "applicationTemplateComponent": { # ComponentRef represents a reference to a component resource. # Output only. Reference to component and revision in a composite ApplicationTemplate. "component": "A String", # Optional. Name of the component in composite.Components - "compositeRef": { # CompositeRef represents a reference to a composite resource. # Reference to the Composite ApplicationTemplate. + "compositeRef": { # CompositeRef represents a reference to a composite resource. # Optional. Reference to the Composite ApplicationTemplate. "applicationTemplate": "A String", # Required. Reference to the ApplicationTemplate resource. "revision": "A String", # Optional. Revision of the ApplicationTemplate to use. Changes to revision will trigger manual resynchronization. If empty, ApplicationTemplate will be ignored. "syncOperation": "A String", # Output only. Reference to on-going AppTemplate import and replication operation (i.e. the operation_id for the long-running operation). This field is opaque for external usage. @@ -273,7 +273,7 @@

Method Details

}, "applicationTemplateComponent": { # ComponentRef represents a reference to a component resource. # Output only. Reference to component and revision in a composite ApplicationTemplate. "component": "A String", # Optional. Name of the component in composite.Components - "compositeRef": { # CompositeRef represents a reference to a composite resource. # Reference to the Composite ApplicationTemplate. + "compositeRef": { # CompositeRef represents a reference to a composite resource. # Optional. Reference to the Composite ApplicationTemplate. "applicationTemplate": "A String", # Required. Reference to the ApplicationTemplate resource. "revision": "A String", # Optional. Revision of the ApplicationTemplate to use. Changes to revision will trigger manual resynchronization. If empty, ApplicationTemplate will be ignored. "syncOperation": "A String", # Output only. Reference to on-going AppTemplate import and replication operation (i.e. the operation_id for the long-running operation). This field is opaque for external usage. @@ -350,7 +350,7 @@

Method Details

}, "applicationTemplateComponent": { # ComponentRef represents a reference to a component resource. # Output only. Reference to component and revision in a composite ApplicationTemplate. "component": "A String", # Optional. Name of the component in composite.Components - "compositeRef": { # CompositeRef represents a reference to a composite resource. # Reference to the Composite ApplicationTemplate. + "compositeRef": { # CompositeRef represents a reference to a composite resource. # Optional. Reference to the Composite ApplicationTemplate. "applicationTemplate": "A String", # Required. Reference to the ApplicationTemplate resource. "revision": "A String", # Optional. Revision of the ApplicationTemplate to use. Changes to revision will trigger manual resynchronization. If empty, ApplicationTemplate will be ignored. "syncOperation": "A String", # Output only. Reference to on-going AppTemplate import and replication operation (i.e. the operation_id for the long-running operation). This field is opaque for external usage. @@ -434,7 +434,7 @@

Method Details

}, "applicationTemplateComponent": { # ComponentRef represents a reference to a component resource. # Output only. Reference to component and revision in a composite ApplicationTemplate. "component": "A String", # Optional. Name of the component in composite.Components - "compositeRef": { # CompositeRef represents a reference to a composite resource. # Reference to the Composite ApplicationTemplate. + "compositeRef": { # CompositeRef represents a reference to a composite resource. # Optional. Reference to the Composite ApplicationTemplate. "applicationTemplate": "A String", # Required. Reference to the ApplicationTemplate resource. "revision": "A String", # Optional. Revision of the ApplicationTemplate to use. Changes to revision will trigger manual resynchronization. If empty, ApplicationTemplate will be ignored. "syncOperation": "A String", # Output only. Reference to on-going AppTemplate import and replication operation (i.e. the operation_id for the long-running operation). This field is opaque for external usage. @@ -500,7 +500,7 @@

Method Details

}, "applicationTemplateComponent": { # ComponentRef represents a reference to a component resource. # Output only. Reference to component and revision in a composite ApplicationTemplate. "component": "A String", # Optional. Name of the component in composite.Components - "compositeRef": { # CompositeRef represents a reference to a composite resource. # Reference to the Composite ApplicationTemplate. + "compositeRef": { # CompositeRef represents a reference to a composite resource. # Optional. Reference to the Composite ApplicationTemplate. "applicationTemplate": "A String", # Required. Reference to the ApplicationTemplate resource. "revision": "A String", # Optional. Revision of the ApplicationTemplate to use. Changes to revision will trigger manual resynchronization. If empty, ApplicationTemplate will be ignored. "syncOperation": "A String", # Output only. Reference to on-going AppTemplate import and replication operation (i.e. the operation_id for the long-running operation). This field is opaque for external usage. diff --git a/docs/dyn/saasservicemgmt_v1beta1.projects.locations.rollouts.html b/docs/dyn/saasservicemgmt_v1beta1.projects.locations.rollouts.html index 4a98914736..3db4f04e2d 100644 --- a/docs/dyn/saasservicemgmt_v1beta1.projects.locations.rollouts.html +++ b/docs/dyn/saasservicemgmt_v1beta1.projects.locations.rollouts.html @@ -125,7 +125,7 @@

Method Details

"effectiveUnitFilter": "A String", # Optional. Output only. Output only snapshot of the effective unit filter at Rollout start time. Contains a CEL(https://github.com/google/cel-spec) expression consisting of a conjunction of Rollout.unit_filter and RolloutKind.unit_filter. This field captures the filter applied by the Rollout to determine the Unit population. If the associated RolloutKind's unit_filter is modified after the rollout is started, it will not be updated here. "endTime": "A String", # Optional. Output only. The time when the rollout finished execution (regardless of success, failure, or cancellation). Will be empty if the rollout hasn't finished yet. Once set, the rollout is in terminal state and all the results are final. "etag": "A String", # Output only. An opaque value that uniquely identifies a version or generation of a resource. It can be used to confirm that the client and server agree on the ordering of a resource being written. - "flagRelease": "A String", # Optional. Immutable. Name of the FlagRelease to be rolled out to the target Units. Release and FlagRelease are mutually exclusive. Note: `release` comment needs to be adjusted to mention that "Release and FlagRelease are mutually exclusive" when visibility restriction will be lifted. + "flagRelease": "A String", # Optional. Immutable. Name of the FlagRelease to be rolled out to the target Units. Release and FlagRelease are mutually exclusive. "labels": { # Optional. The labels on the resource, which can be used for categorization. similar to Kubernetes resource labels. "a_key": "A String", }, @@ -179,7 +179,7 @@

Method Details

"effectiveUnitFilter": "A String", # Optional. Output only. Output only snapshot of the effective unit filter at Rollout start time. Contains a CEL(https://github.com/google/cel-spec) expression consisting of a conjunction of Rollout.unit_filter and RolloutKind.unit_filter. This field captures the filter applied by the Rollout to determine the Unit population. If the associated RolloutKind's unit_filter is modified after the rollout is started, it will not be updated here. "endTime": "A String", # Optional. Output only. The time when the rollout finished execution (regardless of success, failure, or cancellation). Will be empty if the rollout hasn't finished yet. Once set, the rollout is in terminal state and all the results are final. "etag": "A String", # Output only. An opaque value that uniquely identifies a version or generation of a resource. It can be used to confirm that the client and server agree on the ordering of a resource being written. - "flagRelease": "A String", # Optional. Immutable. Name of the FlagRelease to be rolled out to the target Units. Release and FlagRelease are mutually exclusive. Note: `release` comment needs to be adjusted to mention that "Release and FlagRelease are mutually exclusive" when visibility restriction will be lifted. + "flagRelease": "A String", # Optional. Immutable. Name of the FlagRelease to be rolled out to the target Units. Release and FlagRelease are mutually exclusive. "labels": { # Optional. The labels on the resource, which can be used for categorization. similar to Kubernetes resource labels. "a_key": "A String", }, @@ -258,7 +258,7 @@

Method Details

"effectiveUnitFilter": "A String", # Optional. Output only. Output only snapshot of the effective unit filter at Rollout start time. Contains a CEL(https://github.com/google/cel-spec) expression consisting of a conjunction of Rollout.unit_filter and RolloutKind.unit_filter. This field captures the filter applied by the Rollout to determine the Unit population. If the associated RolloutKind's unit_filter is modified after the rollout is started, it will not be updated here. "endTime": "A String", # Optional. Output only. The time when the rollout finished execution (regardless of success, failure, or cancellation). Will be empty if the rollout hasn't finished yet. Once set, the rollout is in terminal state and all the results are final. "etag": "A String", # Output only. An opaque value that uniquely identifies a version or generation of a resource. It can be used to confirm that the client and server agree on the ordering of a resource being written. - "flagRelease": "A String", # Optional. Immutable. Name of the FlagRelease to be rolled out to the target Units. Release and FlagRelease are mutually exclusive. Note: `release` comment needs to be adjusted to mention that "Release and FlagRelease are mutually exclusive" when visibility restriction will be lifted. + "flagRelease": "A String", # Optional. Immutable. Name of the FlagRelease to be rolled out to the target Units. Release and FlagRelease are mutually exclusive. "labels": { # Optional. The labels on the resource, which can be used for categorization. similar to Kubernetes resource labels. "a_key": "A String", }, @@ -323,7 +323,7 @@

Method Details

"effectiveUnitFilter": "A String", # Optional. Output only. Output only snapshot of the effective unit filter at Rollout start time. Contains a CEL(https://github.com/google/cel-spec) expression consisting of a conjunction of Rollout.unit_filter and RolloutKind.unit_filter. This field captures the filter applied by the Rollout to determine the Unit population. If the associated RolloutKind's unit_filter is modified after the rollout is started, it will not be updated here. "endTime": "A String", # Optional. Output only. The time when the rollout finished execution (regardless of success, failure, or cancellation). Will be empty if the rollout hasn't finished yet. Once set, the rollout is in terminal state and all the results are final. "etag": "A String", # Output only. An opaque value that uniquely identifies a version or generation of a resource. It can be used to confirm that the client and server agree on the ordering of a resource being written. - "flagRelease": "A String", # Optional. Immutable. Name of the FlagRelease to be rolled out to the target Units. Release and FlagRelease are mutually exclusive. Note: `release` comment needs to be adjusted to mention that "Release and FlagRelease are mutually exclusive" when visibility restriction will be lifted. + "flagRelease": "A String", # Optional. Immutable. Name of the FlagRelease to be rolled out to the target Units. Release and FlagRelease are mutually exclusive. "labels": { # Optional. The labels on the resource, which can be used for categorization. similar to Kubernetes resource labels. "a_key": "A String", }, @@ -395,7 +395,7 @@

Method Details

"effectiveUnitFilter": "A String", # Optional. Output only. Output only snapshot of the effective unit filter at Rollout start time. Contains a CEL(https://github.com/google/cel-spec) expression consisting of a conjunction of Rollout.unit_filter and RolloutKind.unit_filter. This field captures the filter applied by the Rollout to determine the Unit population. If the associated RolloutKind's unit_filter is modified after the rollout is started, it will not be updated here. "endTime": "A String", # Optional. Output only. The time when the rollout finished execution (regardless of success, failure, or cancellation). Will be empty if the rollout hasn't finished yet. Once set, the rollout is in terminal state and all the results are final. "etag": "A String", # Output only. An opaque value that uniquely identifies a version or generation of a resource. It can be used to confirm that the client and server agree on the ordering of a resource being written. - "flagRelease": "A String", # Optional. Immutable. Name of the FlagRelease to be rolled out to the target Units. Release and FlagRelease are mutually exclusive. Note: `release` comment needs to be adjusted to mention that "Release and FlagRelease are mutually exclusive" when visibility restriction will be lifted. + "flagRelease": "A String", # Optional. Immutable. Name of the FlagRelease to be rolled out to the target Units. Release and FlagRelease are mutually exclusive. "labels": { # Optional. The labels on the resource, which can be used for categorization. similar to Kubernetes resource labels. "a_key": "A String", }, @@ -449,7 +449,7 @@

Method Details

"effectiveUnitFilter": "A String", # Optional. Output only. Output only snapshot of the effective unit filter at Rollout start time. Contains a CEL(https://github.com/google/cel-spec) expression consisting of a conjunction of Rollout.unit_filter and RolloutKind.unit_filter. This field captures the filter applied by the Rollout to determine the Unit population. If the associated RolloutKind's unit_filter is modified after the rollout is started, it will not be updated here. "endTime": "A String", # Optional. Output only. The time when the rollout finished execution (regardless of success, failure, or cancellation). Will be empty if the rollout hasn't finished yet. Once set, the rollout is in terminal state and all the results are final. "etag": "A String", # Output only. An opaque value that uniquely identifies a version or generation of a resource. It can be used to confirm that the client and server agree on the ordering of a resource being written. - "flagRelease": "A String", # Optional. Immutable. Name of the FlagRelease to be rolled out to the target Units. Release and FlagRelease are mutually exclusive. Note: `release` comment needs to be adjusted to mention that "Release and FlagRelease are mutually exclusive" when visibility restriction will be lifted. + "flagRelease": "A String", # Optional. Immutable. Name of the FlagRelease to be rolled out to the target Units. Release and FlagRelease are mutually exclusive. "labels": { # Optional. The labels on the resource, which can be used for categorization. similar to Kubernetes resource labels. "a_key": "A String", }, diff --git a/docs/dyn/saasservicemgmt_v1beta1.projects.locations.saas.html b/docs/dyn/saasservicemgmt_v1beta1.projects.locations.saas.html index 5544b27a24..8807df61c2 100644 --- a/docs/dyn/saasservicemgmt_v1beta1.projects.locations.saas.html +++ b/docs/dyn/saasservicemgmt_v1beta1.projects.locations.saas.html @@ -114,7 +114,7 @@

Method Details

"annotations": { # Optional. Annotations is an unstructured key-value map stored with a resource that may be set by external tools to store and retrieve arbitrary metadata. They are not queryable and should be preserved when modifying objects. More info: https://kubernetes.io/docs/user-guide/annotations "a_key": "A String", }, - "applicationTemplate": { # CompositeRef represents a reference to a composite resource. # Reference to composite ApplicationTemplate. When specified, the template components will be imported into their equivalent UnitKind, Release and Blueprint resources. Deleted references will not delete imported resources. Should only be specified on source regions, and be unspecified on replica regions. + "applicationTemplate": { # CompositeRef represents a reference to a composite resource. # Optional. Reference to composite ApplicationTemplate. When specified, the template components will be imported into their equivalent UnitKind, Release and Blueprint resources. Deleted references will not delete imported resources. Should only be specified on source regions, and be unspecified on replica regions. "applicationTemplate": "A String", # Required. Reference to the ApplicationTemplate resource. "revision": "A String", # Optional. Revision of the ApplicationTemplate to use. Changes to revision will trigger manual resynchronization. If empty, ApplicationTemplate will be ignored. "syncOperation": "A String", # Output only. Reference to on-going AppTemplate import and replication operation (i.e. the operation_id for the long-running operation). This field is opaque for external usage. @@ -169,7 +169,7 @@

Method Details

"annotations": { # Optional. Annotations is an unstructured key-value map stored with a resource that may be set by external tools to store and retrieve arbitrary metadata. They are not queryable and should be preserved when modifying objects. More info: https://kubernetes.io/docs/user-guide/annotations "a_key": "A String", }, - "applicationTemplate": { # CompositeRef represents a reference to a composite resource. # Reference to composite ApplicationTemplate. When specified, the template components will be imported into their equivalent UnitKind, Release and Blueprint resources. Deleted references will not delete imported resources. Should only be specified on source regions, and be unspecified on replica regions. + "applicationTemplate": { # CompositeRef represents a reference to a composite resource. # Optional. Reference to composite ApplicationTemplate. When specified, the template components will be imported into their equivalent UnitKind, Release and Blueprint resources. Deleted references will not delete imported resources. Should only be specified on source regions, and be unspecified on replica regions. "applicationTemplate": "A String", # Required. Reference to the ApplicationTemplate resource. "revision": "A String", # Optional. Revision of the ApplicationTemplate to use. Changes to revision will trigger manual resynchronization. If empty, ApplicationTemplate will be ignored. "syncOperation": "A String", # Output only. Reference to on-going AppTemplate import and replication operation (i.e. the operation_id for the long-running operation). This field is opaque for external usage. @@ -249,7 +249,7 @@

Method Details

"annotations": { # Optional. Annotations is an unstructured key-value map stored with a resource that may be set by external tools to store and retrieve arbitrary metadata. They are not queryable and should be preserved when modifying objects. More info: https://kubernetes.io/docs/user-guide/annotations "a_key": "A String", }, - "applicationTemplate": { # CompositeRef represents a reference to a composite resource. # Reference to composite ApplicationTemplate. When specified, the template components will be imported into their equivalent UnitKind, Release and Blueprint resources. Deleted references will not delete imported resources. Should only be specified on source regions, and be unspecified on replica regions. + "applicationTemplate": { # CompositeRef represents a reference to a composite resource. # Optional. Reference to composite ApplicationTemplate. When specified, the template components will be imported into their equivalent UnitKind, Release and Blueprint resources. Deleted references will not delete imported resources. Should only be specified on source regions, and be unspecified on replica regions. "applicationTemplate": "A String", # Required. Reference to the ApplicationTemplate resource. "revision": "A String", # Optional. Revision of the ApplicationTemplate to use. Changes to revision will trigger manual resynchronization. If empty, ApplicationTemplate will be ignored. "syncOperation": "A String", # Output only. Reference to on-going AppTemplate import and replication operation (i.e. the operation_id for the long-running operation). This field is opaque for external usage. @@ -315,7 +315,7 @@

Method Details

"annotations": { # Optional. Annotations is an unstructured key-value map stored with a resource that may be set by external tools to store and retrieve arbitrary metadata. They are not queryable and should be preserved when modifying objects. More info: https://kubernetes.io/docs/user-guide/annotations "a_key": "A String", }, - "applicationTemplate": { # CompositeRef represents a reference to a composite resource. # Reference to composite ApplicationTemplate. When specified, the template components will be imported into their equivalent UnitKind, Release and Blueprint resources. Deleted references will not delete imported resources. Should only be specified on source regions, and be unspecified on replica regions. + "applicationTemplate": { # CompositeRef represents a reference to a composite resource. # Optional. Reference to composite ApplicationTemplate. When specified, the template components will be imported into their equivalent UnitKind, Release and Blueprint resources. Deleted references will not delete imported resources. Should only be specified on source regions, and be unspecified on replica regions. "applicationTemplate": "A String", # Required. Reference to the ApplicationTemplate resource. "revision": "A String", # Optional. Revision of the ApplicationTemplate to use. Changes to revision will trigger manual resynchronization. If empty, ApplicationTemplate will be ignored. "syncOperation": "A String", # Output only. Reference to on-going AppTemplate import and replication operation (i.e. the operation_id for the long-running operation). This field is opaque for external usage. @@ -388,7 +388,7 @@

Method Details

"annotations": { # Optional. Annotations is an unstructured key-value map stored with a resource that may be set by external tools to store and retrieve arbitrary metadata. They are not queryable and should be preserved when modifying objects. More info: https://kubernetes.io/docs/user-guide/annotations "a_key": "A String", }, - "applicationTemplate": { # CompositeRef represents a reference to a composite resource. # Reference to composite ApplicationTemplate. When specified, the template components will be imported into their equivalent UnitKind, Release and Blueprint resources. Deleted references will not delete imported resources. Should only be specified on source regions, and be unspecified on replica regions. + "applicationTemplate": { # CompositeRef represents a reference to a composite resource. # Optional. Reference to composite ApplicationTemplate. When specified, the template components will be imported into their equivalent UnitKind, Release and Blueprint resources. Deleted references will not delete imported resources. Should only be specified on source regions, and be unspecified on replica regions. "applicationTemplate": "A String", # Required. Reference to the ApplicationTemplate resource. "revision": "A String", # Optional. Revision of the ApplicationTemplate to use. Changes to revision will trigger manual resynchronization. If empty, ApplicationTemplate will be ignored. "syncOperation": "A String", # Output only. Reference to on-going AppTemplate import and replication operation (i.e. the operation_id for the long-running operation). This field is opaque for external usage. @@ -443,7 +443,7 @@

Method Details

"annotations": { # Optional. Annotations is an unstructured key-value map stored with a resource that may be set by external tools to store and retrieve arbitrary metadata. They are not queryable and should be preserved when modifying objects. More info: https://kubernetes.io/docs/user-guide/annotations "a_key": "A String", }, - "applicationTemplate": { # CompositeRef represents a reference to a composite resource. # Reference to composite ApplicationTemplate. When specified, the template components will be imported into their equivalent UnitKind, Release and Blueprint resources. Deleted references will not delete imported resources. Should only be specified on source regions, and be unspecified on replica regions. + "applicationTemplate": { # CompositeRef represents a reference to a composite resource. # Optional. Reference to composite ApplicationTemplate. When specified, the template components will be imported into their equivalent UnitKind, Release and Blueprint resources. Deleted references will not delete imported resources. Should only be specified on source regions, and be unspecified on replica regions. "applicationTemplate": "A String", # Required. Reference to the ApplicationTemplate resource. "revision": "A String", # Optional. Revision of the ApplicationTemplate to use. Changes to revision will trigger manual resynchronization. If empty, ApplicationTemplate will be ignored. "syncOperation": "A String", # Output only. Reference to on-going AppTemplate import and replication operation (i.e. the operation_id for the long-running operation). This field is opaque for external usage. diff --git a/docs/dyn/saasservicemgmt_v1beta1.projects.locations.unitKinds.html b/docs/dyn/saasservicemgmt_v1beta1.projects.locations.unitKinds.html index 24b8e35a70..13c5bd4b3e 100644 --- a/docs/dyn/saasservicemgmt_v1beta1.projects.locations.unitKinds.html +++ b/docs/dyn/saasservicemgmt_v1beta1.projects.locations.unitKinds.html @@ -122,7 +122,7 @@

Method Details

}, "applicationTemplateComponent": { # ComponentRef represents a reference to a component resource. # Optional. Reference to component and revision in a composite ApplicationTemplate. "component": "A String", # Optional. Name of the component in composite.Components - "compositeRef": { # CompositeRef represents a reference to a composite resource. # Reference to the Composite ApplicationTemplate. + "compositeRef": { # CompositeRef represents a reference to a composite resource. # Optional. Reference to the Composite ApplicationTemplate. "applicationTemplate": "A String", # Required. Reference to the ApplicationTemplate resource. "revision": "A String", # Optional. Revision of the ApplicationTemplate to use. Changes to revision will trigger manual resynchronization. If empty, ApplicationTemplate will be ignored. "syncOperation": "A String", # Output only. Reference to on-going AppTemplate import and replication operation (i.e. the operation_id for the long-running operation). This field is opaque for external usage. @@ -203,7 +203,7 @@

Method Details

}, "applicationTemplateComponent": { # ComponentRef represents a reference to a component resource. # Optional. Reference to component and revision in a composite ApplicationTemplate. "component": "A String", # Optional. Name of the component in composite.Components - "compositeRef": { # CompositeRef represents a reference to a composite resource. # Reference to the Composite ApplicationTemplate. + "compositeRef": { # CompositeRef represents a reference to a composite resource. # Optional. Reference to the Composite ApplicationTemplate. "applicationTemplate": "A String", # Required. Reference to the ApplicationTemplate resource. "revision": "A String", # Optional. Revision of the ApplicationTemplate to use. Changes to revision will trigger manual resynchronization. If empty, ApplicationTemplate will be ignored. "syncOperation": "A String", # Output only. Reference to on-going AppTemplate import and replication operation (i.e. the operation_id for the long-running operation). This field is opaque for external usage. @@ -309,7 +309,7 @@

Method Details

}, "applicationTemplateComponent": { # ComponentRef represents a reference to a component resource. # Optional. Reference to component and revision in a composite ApplicationTemplate. "component": "A String", # Optional. Name of the component in composite.Components - "compositeRef": { # CompositeRef represents a reference to a composite resource. # Reference to the Composite ApplicationTemplate. + "compositeRef": { # CompositeRef represents a reference to a composite resource. # Optional. Reference to the Composite ApplicationTemplate. "applicationTemplate": "A String", # Required. Reference to the ApplicationTemplate resource. "revision": "A String", # Optional. Revision of the ApplicationTemplate to use. Changes to revision will trigger manual resynchronization. If empty, ApplicationTemplate will be ignored. "syncOperation": "A String", # Output only. Reference to on-going AppTemplate import and replication operation (i.e. the operation_id for the long-running operation). This field is opaque for external usage. @@ -401,7 +401,7 @@

Method Details

}, "applicationTemplateComponent": { # ComponentRef represents a reference to a component resource. # Optional. Reference to component and revision in a composite ApplicationTemplate. "component": "A String", # Optional. Name of the component in composite.Components - "compositeRef": { # CompositeRef represents a reference to a composite resource. # Reference to the Composite ApplicationTemplate. + "compositeRef": { # CompositeRef represents a reference to a composite resource. # Optional. Reference to the Composite ApplicationTemplate. "applicationTemplate": "A String", # Required. Reference to the ApplicationTemplate resource. "revision": "A String", # Optional. Revision of the ApplicationTemplate to use. Changes to revision will trigger manual resynchronization. If empty, ApplicationTemplate will be ignored. "syncOperation": "A String", # Output only. Reference to on-going AppTemplate import and replication operation (i.e. the operation_id for the long-running operation). This field is opaque for external usage. @@ -500,7 +500,7 @@

Method Details

}, "applicationTemplateComponent": { # ComponentRef represents a reference to a component resource. # Optional. Reference to component and revision in a composite ApplicationTemplate. "component": "A String", # Optional. Name of the component in composite.Components - "compositeRef": { # CompositeRef represents a reference to a composite resource. # Reference to the Composite ApplicationTemplate. + "compositeRef": { # CompositeRef represents a reference to a composite resource. # Optional. Reference to the Composite ApplicationTemplate. "applicationTemplate": "A String", # Required. Reference to the ApplicationTemplate resource. "revision": "A String", # Optional. Revision of the ApplicationTemplate to use. Changes to revision will trigger manual resynchronization. If empty, ApplicationTemplate will be ignored. "syncOperation": "A String", # Output only. Reference to on-going AppTemplate import and replication operation (i.e. the operation_id for the long-running operation). This field is opaque for external usage. @@ -581,7 +581,7 @@

Method Details

}, "applicationTemplateComponent": { # ComponentRef represents a reference to a component resource. # Optional. Reference to component and revision in a composite ApplicationTemplate. "component": "A String", # Optional. Name of the component in composite.Components - "compositeRef": { # CompositeRef represents a reference to a composite resource. # Reference to the Composite ApplicationTemplate. + "compositeRef": { # CompositeRef represents a reference to a composite resource. # Optional. Reference to the Composite ApplicationTemplate. "applicationTemplate": "A String", # Required. Reference to the ApplicationTemplate resource. "revision": "A String", # Optional. Revision of the ApplicationTemplate to use. Changes to revision will trigger manual resynchronization. If empty, ApplicationTemplate will be ignored. "syncOperation": "A String", # Output only. Reference to on-going AppTemplate import and replication operation (i.e. the operation_id for the long-running operation). This field is opaque for external usage. diff --git a/googleapiclient/discovery_cache/documents/saasservicemgmt.v1.json b/googleapiclient/discovery_cache/documents/saasservicemgmt.v1.json index e703d8ab7c..ea0b390e0c 100644 --- a/googleapiclient/discovery_cache/documents/saasservicemgmt.v1.json +++ b/googleapiclient/discovery_cache/documents/saasservicemgmt.v1.json @@ -1866,7 +1866,7 @@ } } }, -"revision": "20260928", +"revision": "20261005", "rootUrl": "https://saasservicemgmt.googleapis.com/", "schemas": { "Aggregate": { @@ -1885,6 +1885,21 @@ }, "type": "object" }, +"AppParams": { +"description": "AppParams contains the parameters for creating an AppHub Application.", +"id": "AppParams", +"properties": { +"group": { +"description": "Optional. Grouping used to construct the name of the AppHub Application. Multiple UnitKinds can specify the same group to use the same Application across their respective units. Corresponds to the app_boundary_id in the ADC composite ApplicationTemplate. Defaults to UnitKind.name", +"type": "string" +}, +"scope": { +"$ref": "Scope", +"description": "Optional. Corresponds to the scope in the ADC composite ApplicationTemplate. Defaults to TYPE_REGIONAL." +} +}, +"type": "object" +}, "Blueprint": { "description": "Blueprints are OCI Images that contain all of the artifacts needed to provision a unit. Metadata such as, type of the engine used to actuate the blueprint (Terraform, for example) and version will come from the image manifest. If the hostname is omitted, it will be assumed to be the regional path to Artifact Registry (eg. us-east1-docker.pkg.dev).", "id": "Blueprint", @@ -1906,6 +1921,45 @@ }, "type": "object" }, +"ComponentRef": { +"description": "ComponentRef represents a reference to a component resource.", +"id": "ComponentRef", +"properties": { +"component": { +"description": "Optional. Name of the component in composite.Components", +"type": "string" +}, +"compositeRef": { +"$ref": "CompositeRef", +"description": "Optional. Reference to the Composite ApplicationTemplate." +}, +"revision": { +"description": "Optional. Revision of the component. If the component does not have a revision, this field will be explicitly set to the revision of the composite ApplicationTemplate.", +"type": "string" +} +}, +"type": "object" +}, +"CompositeRef": { +"description": "CompositeRef represents a reference to a composite resource.", +"id": "CompositeRef", +"properties": { +"applicationTemplate": { +"description": "Required. Reference to the ApplicationTemplate resource.", +"type": "string" +}, +"revision": { +"description": "Optional. Revision of the ApplicationTemplate to use. Changes to revision will trigger manual resynchronization. If empty, ApplicationTemplate will be ignored.", +"type": "string" +}, +"syncOperation": { +"description": "Output only. Reference to on-going AppTemplate import and replication operation (i.e. the operation_id for the long-running operation). This field is opaque for external usage.", +"readOnly": true, +"type": "string" +} +}, +"type": "object" +}, "Decimal": { "description": "A representation of a decimal value, such as 2.5. Clients may convert values into language-native decimal formats, such as Java's [BigDecimal](https://docs.oracle.com/en/java/javase/11/docs/api/java.base/java/math/BigDecimal.html) or Python's [decimal.Decimal](https://docs.python.org/3/library/decimal.html).", "id": "Decimal", @@ -1961,17 +2015,6 @@ }, "type": "object" }, -"FlagUpdate": { -"description": "FlagUpdate is a UnitOperation that pushes new flag values to Units.", -"id": "FlagUpdate", -"properties": { -"flagRelease": { -"description": "Required. Flag release being applied by UnitOperation.", -"type": "string" -} -}, -"type": "object" -}, "FromMapping": { "description": "Output variables whose values will be passed on to dependencies", "id": "FromMapping", @@ -2291,6 +2334,11 @@ "description": "Optional. Annotations is an unstructured key-value map stored with a resource that may be set by external tools to store and retrieve arbitrary metadata. They are not queryable and should be preserved when modifying objects. More info: https://kubernetes.io/docs/user-guide/annotations", "type": "object" }, +"applicationTemplateComponent": { +"$ref": "ComponentRef", +"description": "Output only. Reference to component and revision in a composite ApplicationTemplate.", +"readOnly": true +}, "blueprint": { "$ref": "Blueprint", "description": "Optional. Blueprints are OCI Images that contain all of the artifacts needed to provision a unit." @@ -2419,10 +2467,6 @@ "readOnly": true, "type": "string" }, -"flagRelease": { -"description": "Optional. Immutable. Name of the FlagRelease to be rolled out to the target Units. Release and FlagRelease are mutually exclusive. Note: `release` comment needs to be adjusted to mention that \"Release and FlagRelease are mutually exclusive\" when visibility restriction will be lifted.", -"type": "string" -}, "labels": { "additionalProperties": { "type": "string" @@ -2676,6 +2720,15 @@ "description": "Optional. Annotations is an unstructured key-value map stored with a resource that may be set by external tools to store and retrieve arbitrary metadata. They are not queryable and should be preserved when modifying objects. More info: https://kubernetes.io/docs/user-guide/annotations", "type": "object" }, +"applicationTemplate": { +"$ref": "CompositeRef", +"description": "Optional. Reference to composite ApplicationTemplate. When specified, the template components will be imported into their equivalent UnitKind, Release and Blueprint resources. Deleted references will not delete imported resources. Should only be specified on source regions, and be unspecified on replica regions." +}, +"blueprintRepo": { +"description": "Output only. Name of repository in Artifact Registry for system-generated Blueprints, eg. Blueprints of imported ApplicationTemplates.", +"readOnly": true, +"type": "string" +}, "conditions": { "description": "Output only. A set of conditions which indicate the various conditions this resource can have.", "items": { @@ -2820,6 +2873,27 @@ false }, "type": "object" }, +"Scope": { +"description": "Scope of an application.", +"id": "Scope", +"properties": { +"type": { +"description": "Required. Scope Type.", +"enum": [ +"TYPE_UNSPECIFIED", +"TYPE_REGIONAL", +"TYPE_GLOBAL" +], +"enumDescriptions": [ +"Unspecified type.", +"Regional type.", +"Global type." +], +"type": "string" +} +}, +"type": "object" +}, "Status": { "description": "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).", "id": "Status", @@ -2932,6 +3006,10 @@ false "description": "Optional. Annotations is an unstructured key-value map stored with a resource that may be set by external tools to store and retrieve arbitrary metadata. They are not queryable and should be preserved when modifying objects. More info: https://kubernetes.io/docs/user-guide/annotations", "type": "object" }, +"application": { +"description": "Optional. Reference to the AppHub Application this unit belongs to. All resources deployed in this Unit will be associated with the specified Application.", +"type": "string" +}, "conditions": { "description": "Optional. Output only. A set of conditions which indicate the various conditions this resource can have.", "items": { @@ -2967,14 +3045,6 @@ false "readOnly": true, "type": "string" }, -"flagRevisions": { -"description": "Optional. Output only. Flag revisions used by this Unit.", -"items": { -"type": "string" -}, -"readOnly": true, -"type": "array" -}, "inputVariables": { "description": "Optional. Output only. Indicates the current input variables deployed by the unit", "items": { @@ -3215,6 +3285,14 @@ false "description": "Optional. Annotations is an unstructured key-value map stored with a resource that may be set by external tools to store and retrieve arbitrary metadata. They are not queryable and should be preserved when modifying objects. More info: https://kubernetes.io/docs/user-guide/annotations", "type": "object" }, +"appParams": { +"$ref": "AppParams", +"description": "Optional. AppParams contains the parameters for creating an AppHub Application." +}, +"applicationTemplateComponent": { +"$ref": "ComponentRef", +"description": "Optional. Reference to component and revision in a composite ApplicationTemplate." +}, "boundaryType": { "description": "Optional. Output only. BoundaryType describes the type of boundary the Unit Kind represents.", "enum": [ @@ -3236,13 +3314,6 @@ false "readOnly": true, "type": "string" }, -"defaultFlagRevisions": { -"description": "Optional. Default revisions of flags for this UnitKind. Newly created units will use the flag default_flag_revisions present at the time of creation.", -"items": { -"type": "string" -}, -"type": "array" -}, "defaultRelease": { "description": "Optional. A reference to the Release object to use as default for creating new units of this UnitKind (optional). If not specified, a new unit must explicitly reference which release to use for its creation.", "type": "string" @@ -3378,10 +3449,6 @@ false "readOnly": true, "type": "string" }, -"flagUpdate": { -"$ref": "FlagUpdate", -"description": "Optional. Flag update operation." -}, "labels": { "additionalProperties": { "type": "string" diff --git a/googleapiclient/discovery_cache/documents/saasservicemgmt.v1beta1.json b/googleapiclient/discovery_cache/documents/saasservicemgmt.v1beta1.json index e5b7335a30..f16a9890f4 100644 --- a/googleapiclient/discovery_cache/documents/saasservicemgmt.v1beta1.json +++ b/googleapiclient/discovery_cache/documents/saasservicemgmt.v1beta1.json @@ -3323,7 +3323,7 @@ } } }, -"revision": "20260928", +"revision": "20261005", "rootUrl": "https://saasservicemgmt.googleapis.com/", "schemas": { "Aggregate": { @@ -3430,7 +3430,7 @@ }, "compositeRef": { "$ref": "CompositeRef", -"description": "Reference to the Composite ApplicationTemplate." +"description": "Optional. Reference to the Composite ApplicationTemplate." }, "revision": { "description": "Optional. Revision of the component. If the component does not have a revision, this field will be explicitly set to the revision of the composite ApplicationTemplate.", @@ -3560,11 +3560,19 @@ }, "type": "array" }, +"defaultAllocation": { +"description": "Optional. The ID of an allocation to use as the default.", +"type": "string" +}, "defaultTarget": { "deprecated": true, "description": "Optional. Deprecated: Use `base_target` instead. Default variant or allocation of the flag.", "type": "string" }, +"defaultVariant": { +"description": "Optional. The name of a variant to use as the default.", +"type": "string" +}, "rules": { "description": "Optional. Evaluation rules define the logic for evaluating the flag against a given context. The rules are evaluated sequentially in their specified order.", "items": { @@ -3611,7 +3619,7 @@ }, "evaluationSpec": { "$ref": "EvaluationSpec", -"description": "Optional. Specification of how the flag value should be evaluated. If a bool flag is created without an evaluation_spec specified, two default variants, \"Enabled\" (with bool_value = true) and \"Disabled\" (with bool_value = false), are created by default, and \"Disabled\" is set as the default_target." +"description": "Optional. Specification of how the flag value should be evaluated. If a bool flag is created without an evaluation_spec specified, two default variants, \"Enabled\" (with boolean_value = true) and \"Disabled\" (with boolean_value = false), are created by default, and \"Disabled\" is set as the default_variant." }, "flagSet": { "description": "Optional. Flag set this flag belongs to.", @@ -4684,7 +4692,7 @@ "type": "string" }, "flagRelease": { -"description": "Optional. Immutable. Name of the FlagRelease to be rolled out to the target Units. Release and FlagRelease are mutually exclusive. Note: `release` comment needs to be adjusted to mention that \"Release and FlagRelease are mutually exclusive\" when visibility restriction will be lifted.", +"description": "Optional. Immutable. Name of the FlagRelease to be rolled out to the target Units. Release and FlagRelease are mutually exclusive.", "type": "string" }, "labels": { @@ -4944,7 +4952,7 @@ }, "applicationTemplate": { "$ref": "CompositeRef", -"description": "Reference to composite ApplicationTemplate. When specified, the template components will be imported into their equivalent UnitKind, Release and Blueprint resources. Deleted references will not delete imported resources. Should only be specified on source regions, and be unspecified on replica regions." +"description": "Optional. Reference to composite ApplicationTemplate. When specified, the template components will be imported into their equivalent UnitKind, Release and Blueprint resources. Deleted references will not delete imported resources. Should only be specified on source regions, and be unspecified on replica regions." }, "blueprintRepo": { "description": "Output only. Name of repository in Artifact Registry for system-generated Blueprints, eg. Blueprints of imported ApplicationTemplates.", From 5ef0090ae632c70f8a8dbf5980993c2f284522ed Mon Sep 17 00:00:00 2001 From: Yoshi Automation Date: Tue, 20 Oct 2026 07:24:02 +0000 Subject: [PATCH 30/34] feat(spanner): update the api #### spanner:v1 The following keys were added: - schemas.Instance.properties.tags (Total Keys: 2) The following keys were changed: - endpoints (Total Keys: 1) --- docs/dyn/spanner_v1.projects.instances.html | 12 ++++++++++++ .../discovery_cache/documents/spanner.v1.json | 19 +++++++++++++------ 2 files changed, 25 insertions(+), 6 deletions(-) diff --git a/docs/dyn/spanner_v1.projects.instances.html b/docs/dyn/spanner_v1.projects.instances.html index e1b90dfc14..58163350b5 100644 --- a/docs/dyn/spanner_v1.projects.instances.html +++ b/docs/dyn/spanner_v1.projects.instances.html @@ -221,6 +221,9 @@

Method Details

}, ], "state": "A String", # Output only. The current instance state. For CreateInstance, the state must be either omitted or set to `CREATING`. For UpdateInstance, the state must be either omitted or set to `READY`. + "tags": { # Optional. Tag keys/values directly bound to this resource. For example: "123/environment": "prod", "123/costCenter": "marketing" + "a_key": "A String", + }, "updateTime": "A String", # Output only. The time at which the instance was most recently updated. }, "instanceId": "A String", # Required. The ID of the instance to create. Valid identifiers are of the form `a-z*[a-z0-9]` and must be between 2 and 64 characters in length. @@ -351,6 +354,9 @@

Method Details

}, ], "state": "A String", # Output only. The current instance state. For CreateInstance, the state must be either omitted or set to `CREATING`. For UpdateInstance, the state must be either omitted or set to `READY`. + "tags": { # Optional. Tag keys/values directly bound to this resource. For example: "123/environment": "prod", "123/costCenter": "marketing" + "a_key": "A String", + }, "updateTime": "A String", # Output only. The time at which the instance was most recently updated. } @@ -481,6 +487,9 @@

Method Details

}, ], "state": "A String", # Output only. The current instance state. For CreateInstance, the state must be either omitted or set to `CREATING`. For UpdateInstance, the state must be either omitted or set to `READY`. + "tags": { # Optional. Tag keys/values directly bound to this resource. For example: "123/environment": "prod", "123/costCenter": "marketing" + "a_key": "A String", + }, "updateTime": "A String", # Output only. The time at which the instance was most recently updated. }, ], @@ -632,6 +641,9 @@

Method Details

}, ], "state": "A String", # Output only. The current instance state. For CreateInstance, the state must be either omitted or set to `CREATING`. For UpdateInstance, the state must be either omitted or set to `READY`. + "tags": { # Optional. Tag keys/values directly bound to this resource. For example: "123/environment": "prod", "123/costCenter": "marketing" + "a_key": "A String", + }, "updateTime": "A String", # Output only. The time at which the instance was most recently updated. }, } diff --git a/googleapiclient/discovery_cache/documents/spanner.v1.json b/googleapiclient/discovery_cache/documents/spanner.v1.json index 3c4534c2e2..13502d87d9 100644 --- a/googleapiclient/discovery_cache/documents/spanner.v1.json +++ b/googleapiclient/discovery_cache/documents/spanner.v1.json @@ -29,11 +29,6 @@ }, { "description": "Regional Endpoint", -"endpointUrl": "https://spanner.europe-southwest1.rep.googleapis.com/", -"location": "europe-southwest1" -}, -{ -"description": "Regional Endpoint", "endpointUrl": "https://spanner.me-central2.rep.googleapis.com/", "location": "me-central2" }, @@ -94,6 +89,11 @@ }, { "description": "Regional Endpoint", +"endpointUrl": "https://spanner.europe-southwest1.rep.googleapis.com/", +"location": "europe-southwest1" +}, +{ +"description": "Regional Endpoint", "endpointUrl": "https://spanner.us-east7.rep.googleapis.com/", "location": "us-east7" }, @@ -3446,7 +3446,7 @@ } } }, -"revision": "20260928", +"revision": "20261006", "rootUrl": "https://spanner.googleapis.com/", "schemas": { "Ack": { @@ -5539,6 +5539,13 @@ "readOnly": true, "type": "string" }, +"tags": { +"additionalProperties": { +"type": "string" +}, +"description": "Optional. Tag keys/values directly bound to this resource. For example: \"123/environment\": \"prod\", \"123/costCenter\": \"marketing\"", +"type": "object" +}, "updateTime": { "description": "Output only. The time at which the instance was most recently updated.", "format": "google-datetime", From 0717a7d39b48561024f2aa17d7a45264c984d2eb Mon Sep 17 00:00:00 2001 From: Yoshi Automation Date: Tue, 20 Oct 2026 07:24:02 +0000 Subject: [PATCH 31/34] feat(sqladmin): update the api #### sqladmin:v1 The following keys were added: - schemas.DatabaseInstance.properties.databaseCenterIntegration.type (Total Keys: 1) - schemas.DatabaseInstance.properties.skipPrecheck.type (Total Keys: 1) - schemas.PreCheckMajorVersionUpgradeContext.properties.maxRuntime (Total Keys: 2) - schemas.WorkloadCapture.properties.backupId (Total Keys: 2) #### sqladmin:v1beta4 The following keys were added: - schemas.DatabaseInstance.properties.databaseCenterIntegration.type (Total Keys: 1) - schemas.DatabaseInstance.properties.skipPrecheck.type (Total Keys: 1) - schemas.PreCheckMajorVersionUpgradeContext.properties.maxRuntime (Total Keys: 2) - schemas.WorkloadCapture.properties.backupId (Total Keys: 2) --- docs/dyn/sqladmin_v1.Backups.html | 11 +++++ docs/dyn/sqladmin_v1.backupRuns.html | 2 + .../dyn/sqladmin_v1.blueGreenDeployments.html | 3 ++ docs/dyn/sqladmin_v1.databases.html | 4 ++ docs/dyn/sqladmin_v1.instances.html | 44 ++++++++++++++++++- docs/dyn/sqladmin_v1.operations.html | 2 + docs/dyn/sqladmin_v1.projects.instances.html | 4 ++ docs/dyn/sqladmin_v1.sslCerts.html | 2 + docs/dyn/sqladmin_v1.users.html | 3 ++ docs/dyn/sqladmin_v1.workloadCaptures.html | 5 +++ docs/dyn/sqladmin_v1beta4.backupRuns.html | 2 + docs/dyn/sqladmin_v1beta4.backups.html | 11 +++++ ...sqladmin_v1beta4.blueGreenDeployments.html | 3 ++ docs/dyn/sqladmin_v1beta4.databases.html | 4 ++ docs/dyn/sqladmin_v1beta4.instances.html | 44 ++++++++++++++++++- docs/dyn/sqladmin_v1beta4.operations.html | 2 + .../sqladmin_v1beta4.projects.instances.html | 4 ++ docs/dyn/sqladmin_v1beta4.sslCerts.html | 2 + docs/dyn/sqladmin_v1beta4.users.html | 3 ++ .../sqladmin_v1beta4.workloadCaptures.html | 5 +++ .../documents/sqladmin.v1.json | 40 ++++++++++++++--- .../documents/sqladmin.v1beta4.json | 40 ++++++++++++++--- 22 files changed, 228 insertions(+), 12 deletions(-) diff --git a/docs/dyn/sqladmin_v1.Backups.html b/docs/dyn/sqladmin_v1.Backups.html index 1e051b4da6..40ff7f148e 100644 --- a/docs/dyn/sqladmin_v1.Backups.html +++ b/docs/dyn/sqladmin_v1.Backups.html @@ -130,6 +130,7 @@

Method Details

"connectionName": "A String", # Connection name of the Cloud SQL instance used in connection strings. "createTime": "A String", # Output only. The time when the instance was created in [RFC 3339](https://tools.ietf.org/html/rfc3339) format, for example `2012-11-15T16:19:00.094Z`. "currentDiskSize": "A String", # The current disk usage of the instance in bytes. This property has been deprecated. Use the "cloudsql.googleapis.com/database/disk/bytes_used" metric in Cloud Monitoring API instead. Please see [this announcement](https://groups.google.com/d/msg/google-cloud-sql-announce/I_7-F9EBhT0/BtvFtdFeAgAJ) for details. + "databaseCenterIntegration": "A String", # Optional. State of the Database Center integration for this instance. When unspecified, Database Center integration is enabled by default. "databaseCenterIntegrationEnabled": True or False, # Optional. If true, instance metadata is sent to the Database Center. If false, instance metadata is not sent to the Database Center. "databaseInstalledVersion": "A String", # Output only. Stores the current database version running on the instance including minor version such as `MYSQL_8_0_18`. "databaseVersion": "A String", # The database engine type and version. The `databaseVersion` field cannot be changed after instance creation. @@ -527,6 +528,7 @@

Method Details

"a_key": "A String", }, }, + "skipPrecheck": True or False, # Optional. Input only. Determines whether the precheck step is skipped during a major version upgrade. "sqlNetworkArchitecture": "A String", "state": "A String", # The current serving state of the Cloud SQL instance. "suspensionReason": [ # If the instance state is SUSPENDED, the reason for the suspension. @@ -693,6 +695,7 @@

Method Details

"operationType": "A String", # The type of the operation. Valid values are: * `CREATE` * `DELETE` * `UPDATE` * `RESTART` * `IMPORT` * `EXPORT` * `BACKUP_VOLUME` * `RESTORE_VOLUME` * `CREATE_USER` * `DELETE_USER` * `CREATE_DATABASE` * `DELETE_DATABASE` "preCheckMajorVersionUpgradeContext": { # Pre-check major version upgrade context. # This field is only populated when the operation_type is PRE_CHECK_MAJOR_VERSION_UPGRADE. The PreCheckMajorVersionUpgradeContext message itself contains the details for that pre-check, such as the target database version for the upgrade and the results of the check (including any warnings or errors found). "kind": "A String", # Optional. This is always `sql#preCheckMajorVersionUpgradeContext`. + "maxRuntime": "A String", # Optional. The maximum allowed runtime for the precheck operation. "preCheckResponse": [ # Output only. The responses from the precheck operation. { # Structured PreCheckResponse containing message, type, and required actions. "actionsRequired": [ # The actions that the user needs to take. Use repeated for multiple actions. @@ -871,6 +874,7 @@

Method Details

"operationType": "A String", # The type of the operation. Valid values are: * `CREATE` * `DELETE` * `UPDATE` * `RESTART` * `IMPORT` * `EXPORT` * `BACKUP_VOLUME` * `RESTORE_VOLUME` * `CREATE_USER` * `DELETE_USER` * `CREATE_DATABASE` * `DELETE_DATABASE` "preCheckMajorVersionUpgradeContext": { # Pre-check major version upgrade context. # This field is only populated when the operation_type is PRE_CHECK_MAJOR_VERSION_UPGRADE. The PreCheckMajorVersionUpgradeContext message itself contains the details for that pre-check, such as the target database version for the upgrade and the results of the check (including any warnings or errors found). "kind": "A String", # Optional. This is always `sql#preCheckMajorVersionUpgradeContext`. + "maxRuntime": "A String", # Optional. The maximum allowed runtime for the precheck operation. "preCheckResponse": [ # Output only. The responses from the precheck operation. { # Structured PreCheckResponse containing message, type, and required actions. "actionsRequired": [ # The actions that the user needs to take. Use repeated for multiple actions. @@ -949,6 +953,7 @@

Method Details

"connectionName": "A String", # Connection name of the Cloud SQL instance used in connection strings. "createTime": "A String", # Output only. The time when the instance was created in [RFC 3339](https://tools.ietf.org/html/rfc3339) format, for example `2012-11-15T16:19:00.094Z`. "currentDiskSize": "A String", # The current disk usage of the instance in bytes. This property has been deprecated. Use the "cloudsql.googleapis.com/database/disk/bytes_used" metric in Cloud Monitoring API instead. Please see [this announcement](https://groups.google.com/d/msg/google-cloud-sql-announce/I_7-F9EBhT0/BtvFtdFeAgAJ) for details. + "databaseCenterIntegration": "A String", # Optional. State of the Database Center integration for this instance. When unspecified, Database Center integration is enabled by default. "databaseCenterIntegrationEnabled": True or False, # Optional. If true, instance metadata is sent to the Database Center. If false, instance metadata is not sent to the Database Center. "databaseInstalledVersion": "A String", # Output only. Stores the current database version running on the instance including minor version such as `MYSQL_8_0_18`. "databaseVersion": "A String", # The database engine type and version. The `databaseVersion` field cannot be changed after instance creation. @@ -1346,6 +1351,7 @@

Method Details

"a_key": "A String", }, }, + "skipPrecheck": True or False, # Optional. Input only. Determines whether the precheck step is skipped during a major version upgrade. "sqlNetworkArchitecture": "A String", "state": "A String", # The current serving state of the Cloud SQL instance. "suspensionReason": [ # If the instance state is SUSPENDED, the reason for the suspension. @@ -1424,6 +1430,7 @@

Method Details

"connectionName": "A String", # Connection name of the Cloud SQL instance used in connection strings. "createTime": "A String", # Output only. The time when the instance was created in [RFC 3339](https://tools.ietf.org/html/rfc3339) format, for example `2012-11-15T16:19:00.094Z`. "currentDiskSize": "A String", # The current disk usage of the instance in bytes. This property has been deprecated. Use the "cloudsql.googleapis.com/database/disk/bytes_used" metric in Cloud Monitoring API instead. Please see [this announcement](https://groups.google.com/d/msg/google-cloud-sql-announce/I_7-F9EBhT0/BtvFtdFeAgAJ) for details. + "databaseCenterIntegration": "A String", # Optional. State of the Database Center integration for this instance. When unspecified, Database Center integration is enabled by default. "databaseCenterIntegrationEnabled": True or False, # Optional. If true, instance metadata is sent to the Database Center. If false, instance metadata is not sent to the Database Center. "databaseInstalledVersion": "A String", # Output only. Stores the current database version running on the instance including minor version such as `MYSQL_8_0_18`. "databaseVersion": "A String", # The database engine type and version. The `databaseVersion` field cannot be changed after instance creation. @@ -1821,6 +1828,7 @@

Method Details

"a_key": "A String", }, }, + "skipPrecheck": True or False, # Optional. Input only. Determines whether the precheck step is skipped during a major version upgrade. "sqlNetworkArchitecture": "A String", "state": "A String", # The current serving state of the Cloud SQL instance. "suspensionReason": [ # If the instance state is SUSPENDED, the reason for the suspension. @@ -1913,6 +1921,7 @@

Method Details

"connectionName": "A String", # Connection name of the Cloud SQL instance used in connection strings. "createTime": "A String", # Output only. The time when the instance was created in [RFC 3339](https://tools.ietf.org/html/rfc3339) format, for example `2012-11-15T16:19:00.094Z`. "currentDiskSize": "A String", # The current disk usage of the instance in bytes. This property has been deprecated. Use the "cloudsql.googleapis.com/database/disk/bytes_used" metric in Cloud Monitoring API instead. Please see [this announcement](https://groups.google.com/d/msg/google-cloud-sql-announce/I_7-F9EBhT0/BtvFtdFeAgAJ) for details. + "databaseCenterIntegration": "A String", # Optional. State of the Database Center integration for this instance. When unspecified, Database Center integration is enabled by default. "databaseCenterIntegrationEnabled": True or False, # Optional. If true, instance metadata is sent to the Database Center. If false, instance metadata is not sent to the Database Center. "databaseInstalledVersion": "A String", # Output only. Stores the current database version running on the instance including minor version such as `MYSQL_8_0_18`. "databaseVersion": "A String", # The database engine type and version. The `databaseVersion` field cannot be changed after instance creation. @@ -2310,6 +2319,7 @@

Method Details

"a_key": "A String", }, }, + "skipPrecheck": True or False, # Optional. Input only. Determines whether the precheck step is skipped during a major version upgrade. "sqlNetworkArchitecture": "A String", "state": "A String", # The current serving state of the Cloud SQL instance. "suspensionReason": [ # If the instance state is SUSPENDED, the reason for the suspension. @@ -2477,6 +2487,7 @@

Method Details

"operationType": "A String", # The type of the operation. Valid values are: * `CREATE` * `DELETE` * `UPDATE` * `RESTART` * `IMPORT` * `EXPORT` * `BACKUP_VOLUME` * `RESTORE_VOLUME` * `CREATE_USER` * `DELETE_USER` * `CREATE_DATABASE` * `DELETE_DATABASE` "preCheckMajorVersionUpgradeContext": { # Pre-check major version upgrade context. # This field is only populated when the operation_type is PRE_CHECK_MAJOR_VERSION_UPGRADE. The PreCheckMajorVersionUpgradeContext message itself contains the details for that pre-check, such as the target database version for the upgrade and the results of the check (including any warnings or errors found). "kind": "A String", # Optional. This is always `sql#preCheckMajorVersionUpgradeContext`. + "maxRuntime": "A String", # Optional. The maximum allowed runtime for the precheck operation. "preCheckResponse": [ # Output only. The responses from the precheck operation. { # Structured PreCheckResponse containing message, type, and required actions. "actionsRequired": [ # The actions that the user needs to take. Use repeated for multiple actions. diff --git a/docs/dyn/sqladmin_v1.backupRuns.html b/docs/dyn/sqladmin_v1.backupRuns.html index b2bd87f725..02213583f2 100644 --- a/docs/dyn/sqladmin_v1.backupRuns.html +++ b/docs/dyn/sqladmin_v1.backupRuns.html @@ -239,6 +239,7 @@

Method Details

"operationType": "A String", # The type of the operation. Valid values are: * `CREATE` * `DELETE` * `UPDATE` * `RESTART` * `IMPORT` * `EXPORT` * `BACKUP_VOLUME` * `RESTORE_VOLUME` * `CREATE_USER` * `DELETE_USER` * `CREATE_DATABASE` * `DELETE_DATABASE` "preCheckMajorVersionUpgradeContext": { # Pre-check major version upgrade context. # This field is only populated when the operation_type is PRE_CHECK_MAJOR_VERSION_UPGRADE. The PreCheckMajorVersionUpgradeContext message itself contains the details for that pre-check, such as the target database version for the upgrade and the results of the check (including any warnings or errors found). "kind": "A String", # Optional. This is always `sql#preCheckMajorVersionUpgradeContext`. + "maxRuntime": "A String", # Optional. The maximum allowed runtime for the precheck operation. "preCheckResponse": [ # Output only. The responses from the precheck operation. { # Structured PreCheckResponse containing message, type, and required actions. "actionsRequired": [ # The actions that the user needs to take. Use repeated for multiple actions. @@ -506,6 +507,7 @@

Method Details

"operationType": "A String", # The type of the operation. Valid values are: * `CREATE` * `DELETE` * `UPDATE` * `RESTART` * `IMPORT` * `EXPORT` * `BACKUP_VOLUME` * `RESTORE_VOLUME` * `CREATE_USER` * `DELETE_USER` * `CREATE_DATABASE` * `DELETE_DATABASE` "preCheckMajorVersionUpgradeContext": { # Pre-check major version upgrade context. # This field is only populated when the operation_type is PRE_CHECK_MAJOR_VERSION_UPGRADE. The PreCheckMajorVersionUpgradeContext message itself contains the details for that pre-check, such as the target database version for the upgrade and the results of the check (including any warnings or errors found). "kind": "A String", # Optional. This is always `sql#preCheckMajorVersionUpgradeContext`. + "maxRuntime": "A String", # Optional. The maximum allowed runtime for the precheck operation. "preCheckResponse": [ # Output only. The responses from the precheck operation. { # Structured PreCheckResponse containing message, type, and required actions. "actionsRequired": [ # The actions that the user needs to take. Use repeated for multiple actions. diff --git a/docs/dyn/sqladmin_v1.blueGreenDeployments.html b/docs/dyn/sqladmin_v1.blueGreenDeployments.html index fc7545f8bc..e6d7bd00a9 100644 --- a/docs/dyn/sqladmin_v1.blueGreenDeployments.html +++ b/docs/dyn/sqladmin_v1.blueGreenDeployments.html @@ -304,6 +304,7 @@

Method Details

"operationType": "A String", # The type of the operation. Valid values are: * `CREATE` * `DELETE` * `UPDATE` * `RESTART` * `IMPORT` * `EXPORT` * `BACKUP_VOLUME` * `RESTORE_VOLUME` * `CREATE_USER` * `DELETE_USER` * `CREATE_DATABASE` * `DELETE_DATABASE` "preCheckMajorVersionUpgradeContext": { # Pre-check major version upgrade context. # This field is only populated when the operation_type is PRE_CHECK_MAJOR_VERSION_UPGRADE. The PreCheckMajorVersionUpgradeContext message itself contains the details for that pre-check, such as the target database version for the upgrade and the results of the check (including any warnings or errors found). "kind": "A String", # Optional. This is always `sql#preCheckMajorVersionUpgradeContext`. + "maxRuntime": "A String", # Optional. The maximum allowed runtime for the precheck operation. "preCheckResponse": [ # Output only. The responses from the precheck operation. { # Structured PreCheckResponse containing message, type, and required actions. "actionsRequired": [ # The actions that the user needs to take. Use repeated for multiple actions. @@ -483,6 +484,7 @@

Method Details

"operationType": "A String", # The type of the operation. Valid values are: * `CREATE` * `DELETE` * `UPDATE` * `RESTART` * `IMPORT` * `EXPORT` * `BACKUP_VOLUME` * `RESTORE_VOLUME` * `CREATE_USER` * `DELETE_USER` * `CREATE_DATABASE` * `DELETE_DATABASE` "preCheckMajorVersionUpgradeContext": { # Pre-check major version upgrade context. # This field is only populated when the operation_type is PRE_CHECK_MAJOR_VERSION_UPGRADE. The PreCheckMajorVersionUpgradeContext message itself contains the details for that pre-check, such as the target database version for the upgrade and the results of the check (including any warnings or errors found). "kind": "A String", # Optional. This is always `sql#preCheckMajorVersionUpgradeContext`. + "maxRuntime": "A String", # Optional. The maximum allowed runtime for the precheck operation. "preCheckResponse": [ # Output only. The responses from the precheck operation. { # Structured PreCheckResponse containing message, type, and required actions. "actionsRequired": [ # The actions that the user needs to take. Use repeated for multiple actions. @@ -845,6 +847,7 @@

Method Details

"operationType": "A String", # The type of the operation. Valid values are: * `CREATE` * `DELETE` * `UPDATE` * `RESTART` * `IMPORT` * `EXPORT` * `BACKUP_VOLUME` * `RESTORE_VOLUME` * `CREATE_USER` * `DELETE_USER` * `CREATE_DATABASE` * `DELETE_DATABASE` "preCheckMajorVersionUpgradeContext": { # Pre-check major version upgrade context. # This field is only populated when the operation_type is PRE_CHECK_MAJOR_VERSION_UPGRADE. The PreCheckMajorVersionUpgradeContext message itself contains the details for that pre-check, such as the target database version for the upgrade and the results of the check (including any warnings or errors found). "kind": "A String", # Optional. This is always `sql#preCheckMajorVersionUpgradeContext`. + "maxRuntime": "A String", # Optional. The maximum allowed runtime for the precheck operation. "preCheckResponse": [ # Output only. The responses from the precheck operation. { # Structured PreCheckResponse containing message, type, and required actions. "actionsRequired": [ # The actions that the user needs to take. Use repeated for multiple actions. diff --git a/docs/dyn/sqladmin_v1.databases.html b/docs/dyn/sqladmin_v1.databases.html index c0efde6d21..84e80cc5c3 100644 --- a/docs/dyn/sqladmin_v1.databases.html +++ b/docs/dyn/sqladmin_v1.databases.html @@ -243,6 +243,7 @@

Method Details

"operationType": "A String", # The type of the operation. Valid values are: * `CREATE` * `DELETE` * `UPDATE` * `RESTART` * `IMPORT` * `EXPORT` * `BACKUP_VOLUME` * `RESTORE_VOLUME` * `CREATE_USER` * `DELETE_USER` * `CREATE_DATABASE` * `DELETE_DATABASE` "preCheckMajorVersionUpgradeContext": { # Pre-check major version upgrade context. # This field is only populated when the operation_type is PRE_CHECK_MAJOR_VERSION_UPGRADE. The PreCheckMajorVersionUpgradeContext message itself contains the details for that pre-check, such as the target database version for the upgrade and the results of the check (including any warnings or errors found). "kind": "A String", # Optional. This is always `sql#preCheckMajorVersionUpgradeContext`. + "maxRuntime": "A String", # Optional. The maximum allowed runtime for the precheck operation. "preCheckResponse": [ # Output only. The responses from the precheck operation. { # Structured PreCheckResponse containing message, type, and required actions. "actionsRequired": [ # The actions that the user needs to take. Use repeated for multiple actions. @@ -474,6 +475,7 @@

Method Details

"operationType": "A String", # The type of the operation. Valid values are: * `CREATE` * `DELETE` * `UPDATE` * `RESTART` * `IMPORT` * `EXPORT` * `BACKUP_VOLUME` * `RESTORE_VOLUME` * `CREATE_USER` * `DELETE_USER` * `CREATE_DATABASE` * `DELETE_DATABASE` "preCheckMajorVersionUpgradeContext": { # Pre-check major version upgrade context. # This field is only populated when the operation_type is PRE_CHECK_MAJOR_VERSION_UPGRADE. The PreCheckMajorVersionUpgradeContext message itself contains the details for that pre-check, such as the target database version for the upgrade and the results of the check (including any warnings or errors found). "kind": "A String", # Optional. This is always `sql#preCheckMajorVersionUpgradeContext`. + "maxRuntime": "A String", # Optional. The maximum allowed runtime for the precheck operation. "preCheckResponse": [ # Output only. The responses from the precheck operation. { # Structured PreCheckResponse containing message, type, and required actions. "actionsRequired": [ # The actions that the user needs to take. Use repeated for multiple actions. @@ -710,6 +712,7 @@

Method Details

"operationType": "A String", # The type of the operation. Valid values are: * `CREATE` * `DELETE` * `UPDATE` * `RESTART` * `IMPORT` * `EXPORT` * `BACKUP_VOLUME` * `RESTORE_VOLUME` * `CREATE_USER` * `DELETE_USER` * `CREATE_DATABASE` * `DELETE_DATABASE` "preCheckMajorVersionUpgradeContext": { # Pre-check major version upgrade context. # This field is only populated when the operation_type is PRE_CHECK_MAJOR_VERSION_UPGRADE. The PreCheckMajorVersionUpgradeContext message itself contains the details for that pre-check, such as the target database version for the upgrade and the results of the check (including any warnings or errors found). "kind": "A String", # Optional. This is always `sql#preCheckMajorVersionUpgradeContext`. + "maxRuntime": "A String", # Optional. The maximum allowed runtime for the precheck operation. "preCheckResponse": [ # Output only. The responses from the precheck operation. { # Structured PreCheckResponse containing message, type, and required actions. "actionsRequired": [ # The actions that the user needs to take. Use repeated for multiple actions. @@ -909,6 +912,7 @@

Method Details

"operationType": "A String", # The type of the operation. Valid values are: * `CREATE` * `DELETE` * `UPDATE` * `RESTART` * `IMPORT` * `EXPORT` * `BACKUP_VOLUME` * `RESTORE_VOLUME` * `CREATE_USER` * `DELETE_USER` * `CREATE_DATABASE` * `DELETE_DATABASE` "preCheckMajorVersionUpgradeContext": { # Pre-check major version upgrade context. # This field is only populated when the operation_type is PRE_CHECK_MAJOR_VERSION_UPGRADE. The PreCheckMajorVersionUpgradeContext message itself contains the details for that pre-check, such as the target database version for the upgrade and the results of the check (including any warnings or errors found). "kind": "A String", # Optional. This is always `sql#preCheckMajorVersionUpgradeContext`. + "maxRuntime": "A String", # Optional. The maximum allowed runtime for the precheck operation. "preCheckResponse": [ # Output only. The responses from the precheck operation. { # Structured PreCheckResponse containing message, type, and required actions. "actionsRequired": [ # The actions that the user needs to take. Use repeated for multiple actions. diff --git a/docs/dyn/sqladmin_v1.instances.html b/docs/dyn/sqladmin_v1.instances.html index 97131f9c32..8020843cf3 100644 --- a/docs/dyn/sqladmin_v1.instances.html +++ b/docs/dyn/sqladmin_v1.instances.html @@ -420,6 +420,7 @@

Method Details

"operationType": "A String", # The type of the operation. Valid values are: * `CREATE` * `DELETE` * `UPDATE` * `RESTART` * `IMPORT` * `EXPORT` * `BACKUP_VOLUME` * `RESTORE_VOLUME` * `CREATE_USER` * `DELETE_USER` * `CREATE_DATABASE` * `DELETE_DATABASE` "preCheckMajorVersionUpgradeContext": { # Pre-check major version upgrade context. # This field is only populated when the operation_type is PRE_CHECK_MAJOR_VERSION_UPGRADE. The PreCheckMajorVersionUpgradeContext message itself contains the details for that pre-check, such as the target database version for the upgrade and the results of the check (including any warnings or errors found). "kind": "A String", # Optional. This is always `sql#preCheckMajorVersionUpgradeContext`. + "maxRuntime": "A String", # Optional. The maximum allowed runtime for the precheck operation. "preCheckResponse": [ # Output only. The responses from the precheck operation. { # Structured PreCheckResponse containing message, type, and required actions. "actionsRequired": [ # The actions that the user needs to take. Use repeated for multiple actions. @@ -610,6 +611,7 @@

Method Details

"operationType": "A String", # The type of the operation. Valid values are: * `CREATE` * `DELETE` * `UPDATE` * `RESTART` * `IMPORT` * `EXPORT` * `BACKUP_VOLUME` * `RESTORE_VOLUME` * `CREATE_USER` * `DELETE_USER` * `CREATE_DATABASE` * `DELETE_DATABASE` "preCheckMajorVersionUpgradeContext": { # Pre-check major version upgrade context. # This field is only populated when the operation_type is PRE_CHECK_MAJOR_VERSION_UPGRADE. The PreCheckMajorVersionUpgradeContext message itself contains the details for that pre-check, such as the target database version for the upgrade and the results of the check (including any warnings or errors found). "kind": "A String", # Optional. This is always `sql#preCheckMajorVersionUpgradeContext`. + "maxRuntime": "A String", # Optional. The maximum allowed runtime for the precheck operation. "preCheckResponse": [ # Output only. The responses from the precheck operation. { # Structured PreCheckResponse containing message, type, and required actions. "actionsRequired": [ # The actions that the user needs to take. Use repeated for multiple actions. @@ -823,6 +825,7 @@

Method Details

"operationType": "A String", # The type of the operation. Valid values are: * `CREATE` * `DELETE` * `UPDATE` * `RESTART` * `IMPORT` * `EXPORT` * `BACKUP_VOLUME` * `RESTORE_VOLUME` * `CREATE_USER` * `DELETE_USER` * `CREATE_DATABASE` * `DELETE_DATABASE` "preCheckMajorVersionUpgradeContext": { # Pre-check major version upgrade context. # This field is only populated when the operation_type is PRE_CHECK_MAJOR_VERSION_UPGRADE. The PreCheckMajorVersionUpgradeContext message itself contains the details for that pre-check, such as the target database version for the upgrade and the results of the check (including any warnings or errors found). "kind": "A String", # Optional. This is always `sql#preCheckMajorVersionUpgradeContext`. + "maxRuntime": "A String", # Optional. The maximum allowed runtime for the precheck operation. "preCheckResponse": [ # Output only. The responses from the precheck operation. { # Structured PreCheckResponse containing message, type, and required actions. "actionsRequired": [ # The actions that the user needs to take. Use repeated for multiple actions. @@ -1003,6 +1006,7 @@

Method Details

"operationType": "A String", # The type of the operation. Valid values are: * `CREATE` * `DELETE` * `UPDATE` * `RESTART` * `IMPORT` * `EXPORT` * `BACKUP_VOLUME` * `RESTORE_VOLUME` * `CREATE_USER` * `DELETE_USER` * `CREATE_DATABASE` * `DELETE_DATABASE` "preCheckMajorVersionUpgradeContext": { # Pre-check major version upgrade context. # This field is only populated when the operation_type is PRE_CHECK_MAJOR_VERSION_UPGRADE. The PreCheckMajorVersionUpgradeContext message itself contains the details for that pre-check, such as the target database version for the upgrade and the results of the check (including any warnings or errors found). "kind": "A String", # Optional. This is always `sql#preCheckMajorVersionUpgradeContext`. + "maxRuntime": "A String", # Optional. The maximum allowed runtime for the precheck operation. "preCheckResponse": [ # Output only. The responses from the precheck operation. { # Structured PreCheckResponse containing message, type, and required actions. "actionsRequired": [ # The actions that the user needs to take. Use repeated for multiple actions. @@ -1183,6 +1187,7 @@

Method Details

"operationType": "A String", # The type of the operation. Valid values are: * `CREATE` * `DELETE` * `UPDATE` * `RESTART` * `IMPORT` * `EXPORT` * `BACKUP_VOLUME` * `RESTORE_VOLUME` * `CREATE_USER` * `DELETE_USER` * `CREATE_DATABASE` * `DELETE_DATABASE` "preCheckMajorVersionUpgradeContext": { # Pre-check major version upgrade context. # This field is only populated when the operation_type is PRE_CHECK_MAJOR_VERSION_UPGRADE. The PreCheckMajorVersionUpgradeContext message itself contains the details for that pre-check, such as the target database version for the upgrade and the results of the check (including any warnings or errors found). "kind": "A String", # Optional. This is always `sql#preCheckMajorVersionUpgradeContext`. + "maxRuntime": "A String", # Optional. The maximum allowed runtime for the precheck operation. "preCheckResponse": [ # Output only. The responses from the precheck operation. { # Structured PreCheckResponse containing message, type, and required actions. "actionsRequired": [ # The actions that the user needs to take. Use repeated for multiple actions. @@ -1389,6 +1394,7 @@

Method Details

"operationType": "A String", # The type of the operation. Valid values are: * `CREATE` * `DELETE` * `UPDATE` * `RESTART` * `IMPORT` * `EXPORT` * `BACKUP_VOLUME` * `RESTORE_VOLUME` * `CREATE_USER` * `DELETE_USER` * `CREATE_DATABASE` * `DELETE_DATABASE` "preCheckMajorVersionUpgradeContext": { # Pre-check major version upgrade context. # This field is only populated when the operation_type is PRE_CHECK_MAJOR_VERSION_UPGRADE. The PreCheckMajorVersionUpgradeContext message itself contains the details for that pre-check, such as the target database version for the upgrade and the results of the check (including any warnings or errors found). "kind": "A String", # Optional. This is always `sql#preCheckMajorVersionUpgradeContext`. + "maxRuntime": "A String", # Optional. The maximum allowed runtime for the precheck operation. "preCheckResponse": [ # Output only. The responses from the precheck operation. { # Structured PreCheckResponse containing message, type, and required actions. "actionsRequired": [ # The actions that the user needs to take. Use repeated for multiple actions. @@ -1578,6 +1584,7 @@

Method Details

"operationType": "A String", # The type of the operation. Valid values are: * `CREATE` * `DELETE` * `UPDATE` * `RESTART` * `IMPORT` * `EXPORT` * `BACKUP_VOLUME` * `RESTORE_VOLUME` * `CREATE_USER` * `DELETE_USER` * `CREATE_DATABASE` * `DELETE_DATABASE` "preCheckMajorVersionUpgradeContext": { # Pre-check major version upgrade context. # This field is only populated when the operation_type is PRE_CHECK_MAJOR_VERSION_UPGRADE. The PreCheckMajorVersionUpgradeContext message itself contains the details for that pre-check, such as the target database version for the upgrade and the results of the check (including any warnings or errors found). "kind": "A String", # Optional. This is always `sql#preCheckMajorVersionUpgradeContext`. + "maxRuntime": "A String", # Optional. The maximum allowed runtime for the precheck operation. "preCheckResponse": [ # Output only. The responses from the precheck operation. { # Structured PreCheckResponse containing message, type, and required actions. "actionsRequired": [ # The actions that the user needs to take. Use repeated for multiple actions. @@ -1768,6 +1775,7 @@

Method Details

"operationType": "A String", # The type of the operation. Valid values are: * `CREATE` * `DELETE` * `UPDATE` * `RESTART` * `IMPORT` * `EXPORT` * `BACKUP_VOLUME` * `RESTORE_VOLUME` * `CREATE_USER` * `DELETE_USER` * `CREATE_DATABASE` * `DELETE_DATABASE` "preCheckMajorVersionUpgradeContext": { # Pre-check major version upgrade context. # This field is only populated when the operation_type is PRE_CHECK_MAJOR_VERSION_UPGRADE. The PreCheckMajorVersionUpgradeContext message itself contains the details for that pre-check, such as the target database version for the upgrade and the results of the check (including any warnings or errors found). "kind": "A String", # Optional. This is always `sql#preCheckMajorVersionUpgradeContext`. + "maxRuntime": "A String", # Optional. The maximum allowed runtime for the precheck operation. "preCheckResponse": [ # Output only. The responses from the precheck operation. { # Structured PreCheckResponse containing message, type, and required actions. "actionsRequired": [ # The actions that the user needs to take. Use repeated for multiple actions. @@ -1971,6 +1979,7 @@

Method Details

"operationType": "A String", # The type of the operation. Valid values are: * `CREATE` * `DELETE` * `UPDATE` * `RESTART` * `IMPORT` * `EXPORT` * `BACKUP_VOLUME` * `RESTORE_VOLUME` * `CREATE_USER` * `DELETE_USER` * `CREATE_DATABASE` * `DELETE_DATABASE` "preCheckMajorVersionUpgradeContext": { # Pre-check major version upgrade context. # This field is only populated when the operation_type is PRE_CHECK_MAJOR_VERSION_UPGRADE. The PreCheckMajorVersionUpgradeContext message itself contains the details for that pre-check, such as the target database version for the upgrade and the results of the check (including any warnings or errors found). "kind": "A String", # Optional. This is always `sql#preCheckMajorVersionUpgradeContext`. + "maxRuntime": "A String", # Optional. The maximum allowed runtime for the precheck operation. "preCheckResponse": [ # Output only. The responses from the precheck operation. { # Structured PreCheckResponse containing message, type, and required actions. "actionsRequired": [ # The actions that the user needs to take. Use repeated for multiple actions. @@ -2023,7 +2032,7 @@

Method Details

{ # The request payload used to execute SQL statements. "application": "A String", # Optional. Specifies the name of the application that is making the request. This field is used for telemetry. Only alphanumeric characters, dashes, and underscores are allowed. The maximum length is 32 characters. "autoIamAuthn": True or False, # Optional. When set to `true`, the API caller identity associated with the request is used for database authentication. The API caller must be an IAM user in the database. - "database": "A String", # Optional. Name of the database on which the statement will be executed. + "database": "A String", # Optional. Name of the database on which the statement will be executed. For Postgres and SQL Server it's required, for MySQL it's optional. "partialResultMode": "A String", # Optional. Controls how the API should respond when the SQL execution result is incomplete due to the size limit or another error. The default mode is to throw an error. "passwordSecretVersion": "A String", # Optional. The resource name of the Secret Manager secret holding the password for the user to log into the database. The secret should be created using the regional endpoint (for API) or from the Regional Secrets page (for UI), and stored in the same region as the Cloud SQL instance. The expected resource name format is `projects/{project}/locations/{location}/secrets/{secret}/versions/{secret_version}`. Used together with the `user` field. The secret resource name will not be stored. "rowLimit": "A String", # Optional. The maximum number of rows returned per SQL statement. @@ -2286,6 +2295,7 @@

Method Details

"operationType": "A String", # The type of the operation. Valid values are: * `CREATE` * `DELETE` * `UPDATE` * `RESTART` * `IMPORT` * `EXPORT` * `BACKUP_VOLUME` * `RESTORE_VOLUME` * `CREATE_USER` * `DELETE_USER` * `CREATE_DATABASE` * `DELETE_DATABASE` "preCheckMajorVersionUpgradeContext": { # Pre-check major version upgrade context. # This field is only populated when the operation_type is PRE_CHECK_MAJOR_VERSION_UPGRADE. The PreCheckMajorVersionUpgradeContext message itself contains the details for that pre-check, such as the target database version for the upgrade and the results of the check (including any warnings or errors found). "kind": "A String", # Optional. This is always `sql#preCheckMajorVersionUpgradeContext`. + "maxRuntime": "A String", # Optional. The maximum allowed runtime for the precheck operation. "preCheckResponse": [ # Output only. The responses from the precheck operation. { # Structured PreCheckResponse containing message, type, and required actions. "actionsRequired": [ # The actions that the user needs to take. Use repeated for multiple actions. @@ -2476,6 +2486,7 @@

Method Details

"operationType": "A String", # The type of the operation. Valid values are: * `CREATE` * `DELETE` * `UPDATE` * `RESTART` * `IMPORT` * `EXPORT` * `BACKUP_VOLUME` * `RESTORE_VOLUME` * `CREATE_USER` * `DELETE_USER` * `CREATE_DATABASE` * `DELETE_DATABASE` "preCheckMajorVersionUpgradeContext": { # Pre-check major version upgrade context. # This field is only populated when the operation_type is PRE_CHECK_MAJOR_VERSION_UPGRADE. The PreCheckMajorVersionUpgradeContext message itself contains the details for that pre-check, such as the target database version for the upgrade and the results of the check (including any warnings or errors found). "kind": "A String", # Optional. This is always `sql#preCheckMajorVersionUpgradeContext`. + "maxRuntime": "A String", # Optional. The maximum allowed runtime for the precheck operation. "preCheckResponse": [ # Output only. The responses from the precheck operation. { # Structured PreCheckResponse containing message, type, and required actions. "actionsRequired": [ # The actions that the user needs to take. Use repeated for multiple actions. @@ -2539,6 +2550,7 @@

Method Details

"connectionName": "A String", # Connection name of the Cloud SQL instance used in connection strings. "createTime": "A String", # Output only. The time when the instance was created in [RFC 3339](https://tools.ietf.org/html/rfc3339) format, for example `2012-11-15T16:19:00.094Z`. "currentDiskSize": "A String", # The current disk usage of the instance in bytes. This property has been deprecated. Use the "cloudsql.googleapis.com/database/disk/bytes_used" metric in Cloud Monitoring API instead. Please see [this announcement](https://groups.google.com/d/msg/google-cloud-sql-announce/I_7-F9EBhT0/BtvFtdFeAgAJ) for details. + "databaseCenterIntegration": "A String", # Optional. State of the Database Center integration for this instance. When unspecified, Database Center integration is enabled by default. "databaseCenterIntegrationEnabled": True or False, # Optional. If true, instance metadata is sent to the Database Center. If false, instance metadata is not sent to the Database Center. "databaseInstalledVersion": "A String", # Output only. Stores the current database version running on the instance including minor version such as `MYSQL_8_0_18`. "databaseVersion": "A String", # The database engine type and version. The `databaseVersion` field cannot be changed after instance creation. @@ -2936,6 +2948,7 @@

Method Details

"a_key": "A String", }, }, + "skipPrecheck": True or False, # Optional. Input only. Determines whether the precheck step is skipped during a major version upgrade. "sqlNetworkArchitecture": "A String", "state": "A String", # The current serving state of the Cloud SQL instance. "suspensionReason": [ # If the instance state is SUSPENDED, the reason for the suspension. @@ -3148,6 +3161,7 @@

Method Details

"operationType": "A String", # The type of the operation. Valid values are: * `CREATE` * `DELETE` * `UPDATE` * `RESTART` * `IMPORT` * `EXPORT` * `BACKUP_VOLUME` * `RESTORE_VOLUME` * `CREATE_USER` * `DELETE_USER` * `CREATE_DATABASE` * `DELETE_DATABASE` "preCheckMajorVersionUpgradeContext": { # Pre-check major version upgrade context. # This field is only populated when the operation_type is PRE_CHECK_MAJOR_VERSION_UPGRADE. The PreCheckMajorVersionUpgradeContext message itself contains the details for that pre-check, such as the target database version for the upgrade and the results of the check (including any warnings or errors found). "kind": "A String", # Optional. This is always `sql#preCheckMajorVersionUpgradeContext`. + "maxRuntime": "A String", # Optional. The maximum allowed runtime for the precheck operation. "preCheckResponse": [ # Output only. The responses from the precheck operation. { # Structured PreCheckResponse containing message, type, and required actions. "actionsRequired": [ # The actions that the user needs to take. Use repeated for multiple actions. @@ -3204,6 +3218,7 @@

Method Details

"connectionName": "A String", # Connection name of the Cloud SQL instance used in connection strings. "createTime": "A String", # Output only. The time when the instance was created in [RFC 3339](https://tools.ietf.org/html/rfc3339) format, for example `2012-11-15T16:19:00.094Z`. "currentDiskSize": "A String", # The current disk usage of the instance in bytes. This property has been deprecated. Use the "cloudsql.googleapis.com/database/disk/bytes_used" metric in Cloud Monitoring API instead. Please see [this announcement](https://groups.google.com/d/msg/google-cloud-sql-announce/I_7-F9EBhT0/BtvFtdFeAgAJ) for details. + "databaseCenterIntegration": "A String", # Optional. State of the Database Center integration for this instance. When unspecified, Database Center integration is enabled by default. "databaseCenterIntegrationEnabled": True or False, # Optional. If true, instance metadata is sent to the Database Center. If false, instance metadata is not sent to the Database Center. "databaseInstalledVersion": "A String", # Output only. Stores the current database version running on the instance including minor version such as `MYSQL_8_0_18`. "databaseVersion": "A String", # The database engine type and version. The `databaseVersion` field cannot be changed after instance creation. @@ -3601,6 +3616,7 @@

Method Details

"a_key": "A String", }, }, + "skipPrecheck": True or False, # Optional. Input only. Determines whether the precheck step is skipped during a major version upgrade. "sqlNetworkArchitecture": "A String", "state": "A String", # The current serving state of the Cloud SQL instance. "suspensionReason": [ # If the instance state is SUSPENDED, the reason for the suspension. @@ -3754,6 +3770,7 @@

Method Details

"operationType": "A String", # The type of the operation. Valid values are: * `CREATE` * `DELETE` * `UPDATE` * `RESTART` * `IMPORT` * `EXPORT` * `BACKUP_VOLUME` * `RESTORE_VOLUME` * `CREATE_USER` * `DELETE_USER` * `CREATE_DATABASE` * `DELETE_DATABASE` "preCheckMajorVersionUpgradeContext": { # Pre-check major version upgrade context. # This field is only populated when the operation_type is PRE_CHECK_MAJOR_VERSION_UPGRADE. The PreCheckMajorVersionUpgradeContext message itself contains the details for that pre-check, such as the target database version for the upgrade and the results of the check (including any warnings or errors found). "kind": "A String", # Optional. This is always `sql#preCheckMajorVersionUpgradeContext`. + "maxRuntime": "A String", # Optional. The maximum allowed runtime for the precheck operation. "preCheckResponse": [ # Output only. The responses from the precheck operation. { # Structured PreCheckResponse containing message, type, and required actions. "actionsRequired": [ # The actions that the user needs to take. Use repeated for multiple actions. @@ -3821,6 +3838,7 @@

Method Details

"connectionName": "A String", # Connection name of the Cloud SQL instance used in connection strings. "createTime": "A String", # Output only. The time when the instance was created in [RFC 3339](https://tools.ietf.org/html/rfc3339) format, for example `2012-11-15T16:19:00.094Z`. "currentDiskSize": "A String", # The current disk usage of the instance in bytes. This property has been deprecated. Use the "cloudsql.googleapis.com/database/disk/bytes_used" metric in Cloud Monitoring API instead. Please see [this announcement](https://groups.google.com/d/msg/google-cloud-sql-announce/I_7-F9EBhT0/BtvFtdFeAgAJ) for details. + "databaseCenterIntegration": "A String", # Optional. State of the Database Center integration for this instance. When unspecified, Database Center integration is enabled by default. "databaseCenterIntegrationEnabled": True or False, # Optional. If true, instance metadata is sent to the Database Center. If false, instance metadata is not sent to the Database Center. "databaseInstalledVersion": "A String", # Output only. Stores the current database version running on the instance including minor version such as `MYSQL_8_0_18`. "databaseVersion": "A String", # The database engine type and version. The `databaseVersion` field cannot be changed after instance creation. @@ -4218,6 +4236,7 @@

Method Details

"a_key": "A String", }, }, + "skipPrecheck": True or False, # Optional. Input only. Determines whether the precheck step is skipped during a major version upgrade. "sqlNetworkArchitecture": "A String", "state": "A String", # The current serving state of the Cloud SQL instance. "suspensionReason": [ # If the instance state is SUSPENDED, the reason for the suspension. @@ -4316,6 +4335,7 @@

Method Details

"connectionName": "A String", # Connection name of the Cloud SQL instance used in connection strings. "createTime": "A String", # Output only. The time when the instance was created in [RFC 3339](https://tools.ietf.org/html/rfc3339) format, for example `2012-11-15T16:19:00.094Z`. "currentDiskSize": "A String", # The current disk usage of the instance in bytes. This property has been deprecated. Use the "cloudsql.googleapis.com/database/disk/bytes_used" metric in Cloud Monitoring API instead. Please see [this announcement](https://groups.google.com/d/msg/google-cloud-sql-announce/I_7-F9EBhT0/BtvFtdFeAgAJ) for details. + "databaseCenterIntegration": "A String", # Optional. State of the Database Center integration for this instance. When unspecified, Database Center integration is enabled by default. "databaseCenterIntegrationEnabled": True or False, # Optional. If true, instance metadata is sent to the Database Center. If false, instance metadata is not sent to the Database Center. "databaseInstalledVersion": "A String", # Output only. Stores the current database version running on the instance including minor version such as `MYSQL_8_0_18`. "databaseVersion": "A String", # The database engine type and version. The `databaseVersion` field cannot be changed after instance creation. @@ -4713,6 +4733,7 @@

Method Details

"a_key": "A String", }, }, + "skipPrecheck": True or False, # Optional. Input only. Determines whether the precheck step is skipped during a major version upgrade. "sqlNetworkArchitecture": "A String", "state": "A String", # The current serving state of the Cloud SQL instance. "suspensionReason": [ # If the instance state is SUSPENDED, the reason for the suspension. @@ -4868,6 +4889,7 @@

Method Details

"operationType": "A String", # The type of the operation. Valid values are: * `CREATE` * `DELETE` * `UPDATE` * `RESTART` * `IMPORT` * `EXPORT` * `BACKUP_VOLUME` * `RESTORE_VOLUME` * `CREATE_USER` * `DELETE_USER` * `CREATE_DATABASE` * `DELETE_DATABASE` "preCheckMajorVersionUpgradeContext": { # Pre-check major version upgrade context. # This field is only populated when the operation_type is PRE_CHECK_MAJOR_VERSION_UPGRADE. The PreCheckMajorVersionUpgradeContext message itself contains the details for that pre-check, such as the target database version for the upgrade and the results of the check (including any warnings or errors found). "kind": "A String", # Optional. This is always `sql#preCheckMajorVersionUpgradeContext`. + "maxRuntime": "A String", # Optional. The maximum allowed runtime for the precheck operation. "preCheckResponse": [ # Output only. The responses from the precheck operation. { # Structured PreCheckResponse containing message, type, and required actions. "actionsRequired": [ # The actions that the user needs to take. Use repeated for multiple actions. @@ -4936,6 +4958,7 @@

Method Details

"connectionName": "A String", # Connection name of the Cloud SQL instance used in connection strings. "createTime": "A String", # Output only. The time when the instance was created in [RFC 3339](https://tools.ietf.org/html/rfc3339) format, for example `2012-11-15T16:19:00.094Z`. "currentDiskSize": "A String", # The current disk usage of the instance in bytes. This property has been deprecated. Use the "cloudsql.googleapis.com/database/disk/bytes_used" metric in Cloud Monitoring API instead. Please see [this announcement](https://groups.google.com/d/msg/google-cloud-sql-announce/I_7-F9EBhT0/BtvFtdFeAgAJ) for details. + "databaseCenterIntegration": "A String", # Optional. State of the Database Center integration for this instance. When unspecified, Database Center integration is enabled by default. "databaseCenterIntegrationEnabled": True or False, # Optional. If true, instance metadata is sent to the Database Center. If false, instance metadata is not sent to the Database Center. "databaseInstalledVersion": "A String", # Output only. Stores the current database version running on the instance including minor version such as `MYSQL_8_0_18`. "databaseVersion": "A String", # The database engine type and version. The `databaseVersion` field cannot be changed after instance creation. @@ -5333,6 +5356,7 @@

Method Details

"a_key": "A String", }, }, + "skipPrecheck": True or False, # Optional. Input only. Determines whether the precheck step is skipped during a major version upgrade. "sqlNetworkArchitecture": "A String", "state": "A String", # The current serving state of the Cloud SQL instance. "suspensionReason": [ # If the instance state is SUSPENDED, the reason for the suspension. @@ -5486,6 +5510,7 @@

Method Details

"operationType": "A String", # The type of the operation. Valid values are: * `CREATE` * `DELETE` * `UPDATE` * `RESTART` * `IMPORT` * `EXPORT` * `BACKUP_VOLUME` * `RESTORE_VOLUME` * `CREATE_USER` * `DELETE_USER` * `CREATE_DATABASE` * `DELETE_DATABASE` "preCheckMajorVersionUpgradeContext": { # Pre-check major version upgrade context. # This field is only populated when the operation_type is PRE_CHECK_MAJOR_VERSION_UPGRADE. The PreCheckMajorVersionUpgradeContext message itself contains the details for that pre-check, such as the target database version for the upgrade and the results of the check (including any warnings or errors found). "kind": "A String", # Optional. This is always `sql#preCheckMajorVersionUpgradeContext`. + "maxRuntime": "A String", # Optional. The maximum allowed runtime for the precheck operation. "preCheckResponse": [ # Output only. The responses from the precheck operation. { # Structured PreCheckResponse containing message, type, and required actions. "actionsRequired": [ # The actions that the user needs to take. Use repeated for multiple actions. @@ -5538,6 +5563,7 @@

Method Details

{ # Request for Pre-checks for MVU "preCheckMajorVersionUpgradeContext": { # Pre-check major version upgrade context. # Required. Contains details about the pre-check major version upgrade operation. "kind": "A String", # Optional. This is always `sql#preCheckMajorVersionUpgradeContext`. + "maxRuntime": "A String", # Optional. The maximum allowed runtime for the precheck operation. "preCheckResponse": [ # Output only. The responses from the precheck operation. { # Structured PreCheckResponse containing message, type, and required actions. "actionsRequired": [ # The actions that the user needs to take. Use repeated for multiple actions. @@ -5685,6 +5711,7 @@

Method Details

"operationType": "A String", # The type of the operation. Valid values are: * `CREATE` * `DELETE` * `UPDATE` * `RESTART` * `IMPORT` * `EXPORT` * `BACKUP_VOLUME` * `RESTORE_VOLUME` * `CREATE_USER` * `DELETE_USER` * `CREATE_DATABASE` * `DELETE_DATABASE` "preCheckMajorVersionUpgradeContext": { # Pre-check major version upgrade context. # This field is only populated when the operation_type is PRE_CHECK_MAJOR_VERSION_UPGRADE. The PreCheckMajorVersionUpgradeContext message itself contains the details for that pre-check, such as the target database version for the upgrade and the results of the check (including any warnings or errors found). "kind": "A String", # Optional. This is always `sql#preCheckMajorVersionUpgradeContext`. + "maxRuntime": "A String", # Optional. The maximum allowed runtime for the precheck operation. "preCheckResponse": [ # Output only. The responses from the precheck operation. { # Structured PreCheckResponse containing message, type, and required actions. "actionsRequired": [ # The actions that the user needs to take. Use repeated for multiple actions. @@ -5866,6 +5893,7 @@

Method Details

"operationType": "A String", # The type of the operation. Valid values are: * `CREATE` * `DELETE` * `UPDATE` * `RESTART` * `IMPORT` * `EXPORT` * `BACKUP_VOLUME` * `RESTORE_VOLUME` * `CREATE_USER` * `DELETE_USER` * `CREATE_DATABASE` * `DELETE_DATABASE` "preCheckMajorVersionUpgradeContext": { # Pre-check major version upgrade context. # This field is only populated when the operation_type is PRE_CHECK_MAJOR_VERSION_UPGRADE. The PreCheckMajorVersionUpgradeContext message itself contains the details for that pre-check, such as the target database version for the upgrade and the results of the check (including any warnings or errors found). "kind": "A String", # Optional. This is always `sql#preCheckMajorVersionUpgradeContext`. + "maxRuntime": "A String", # Optional. The maximum allowed runtime for the precheck operation. "preCheckResponse": [ # Output only. The responses from the precheck operation. { # Structured PreCheckResponse containing message, type, and required actions. "actionsRequired": [ # The actions that the user needs to take. Use repeated for multiple actions. @@ -6056,6 +6084,7 @@

Method Details

"operationType": "A String", # The type of the operation. Valid values are: * `CREATE` * `DELETE` * `UPDATE` * `RESTART` * `IMPORT` * `EXPORT` * `BACKUP_VOLUME` * `RESTORE_VOLUME` * `CREATE_USER` * `DELETE_USER` * `CREATE_DATABASE` * `DELETE_DATABASE` "preCheckMajorVersionUpgradeContext": { # Pre-check major version upgrade context. # This field is only populated when the operation_type is PRE_CHECK_MAJOR_VERSION_UPGRADE. The PreCheckMajorVersionUpgradeContext message itself contains the details for that pre-check, such as the target database version for the upgrade and the results of the check (including any warnings or errors found). "kind": "A String", # Optional. This is always `sql#preCheckMajorVersionUpgradeContext`. + "maxRuntime": "A String", # Optional. The maximum allowed runtime for the precheck operation. "preCheckResponse": [ # Output only. The responses from the precheck operation. { # Structured PreCheckResponse containing message, type, and required actions. "actionsRequired": [ # The actions that the user needs to take. Use repeated for multiple actions. @@ -6262,6 +6291,7 @@

Method Details

"operationType": "A String", # The type of the operation. Valid values are: * `CREATE` * `DELETE` * `UPDATE` * `RESTART` * `IMPORT` * `EXPORT` * `BACKUP_VOLUME` * `RESTORE_VOLUME` * `CREATE_USER` * `DELETE_USER` * `CREATE_DATABASE` * `DELETE_DATABASE` "preCheckMajorVersionUpgradeContext": { # Pre-check major version upgrade context. # This field is only populated when the operation_type is PRE_CHECK_MAJOR_VERSION_UPGRADE. The PreCheckMajorVersionUpgradeContext message itself contains the details for that pre-check, such as the target database version for the upgrade and the results of the check (including any warnings or errors found). "kind": "A String", # Optional. This is always `sql#preCheckMajorVersionUpgradeContext`. + "maxRuntime": "A String", # Optional. The maximum allowed runtime for the precheck operation. "preCheckResponse": [ # Output only. The responses from the precheck operation. { # Structured PreCheckResponse containing message, type, and required actions. "actionsRequired": [ # The actions that the user needs to take. Use repeated for multiple actions. @@ -6442,6 +6472,7 @@

Method Details

"operationType": "A String", # The type of the operation. Valid values are: * `CREATE` * `DELETE` * `UPDATE` * `RESTART` * `IMPORT` * `EXPORT` * `BACKUP_VOLUME` * `RESTORE_VOLUME` * `CREATE_USER` * `DELETE_USER` * `CREATE_DATABASE` * `DELETE_DATABASE` "preCheckMajorVersionUpgradeContext": { # Pre-check major version upgrade context. # This field is only populated when the operation_type is PRE_CHECK_MAJOR_VERSION_UPGRADE. The PreCheckMajorVersionUpgradeContext message itself contains the details for that pre-check, such as the target database version for the upgrade and the results of the check (including any warnings or errors found). "kind": "A String", # Optional. This is always `sql#preCheckMajorVersionUpgradeContext`. + "maxRuntime": "A String", # Optional. The maximum allowed runtime for the precheck operation. "preCheckResponse": [ # Output only. The responses from the precheck operation. { # Structured PreCheckResponse containing message, type, and required actions. "actionsRequired": [ # The actions that the user needs to take. Use repeated for multiple actions. @@ -6512,6 +6543,7 @@

Method Details

"connectionName": "A String", # Connection name of the Cloud SQL instance used in connection strings. "createTime": "A String", # Output only. The time when the instance was created in [RFC 3339](https://tools.ietf.org/html/rfc3339) format, for example `2012-11-15T16:19:00.094Z`. "currentDiskSize": "A String", # The current disk usage of the instance in bytes. This property has been deprecated. Use the "cloudsql.googleapis.com/database/disk/bytes_used" metric in Cloud Monitoring API instead. Please see [this announcement](https://groups.google.com/d/msg/google-cloud-sql-announce/I_7-F9EBhT0/BtvFtdFeAgAJ) for details. + "databaseCenterIntegration": "A String", # Optional. State of the Database Center integration for this instance. When unspecified, Database Center integration is enabled by default. "databaseCenterIntegrationEnabled": True or False, # Optional. If true, instance metadata is sent to the Database Center. If false, instance metadata is not sent to the Database Center. "databaseInstalledVersion": "A String", # Output only. Stores the current database version running on the instance including minor version such as `MYSQL_8_0_18`. "databaseVersion": "A String", # The database engine type and version. The `databaseVersion` field cannot be changed after instance creation. @@ -6909,6 +6941,7 @@

Method Details

"a_key": "A String", }, }, + "skipPrecheck": True or False, # Optional. Input only. Determines whether the precheck step is skipped during a major version upgrade. "sqlNetworkArchitecture": "A String", "state": "A String", # The current serving state of the Cloud SQL instance. "suspensionReason": [ # If the instance state is SUSPENDED, the reason for the suspension. @@ -7063,6 +7096,7 @@

Method Details

"operationType": "A String", # The type of the operation. Valid values are: * `CREATE` * `DELETE` * `UPDATE` * `RESTART` * `IMPORT` * `EXPORT` * `BACKUP_VOLUME` * `RESTORE_VOLUME` * `CREATE_USER` * `DELETE_USER` * `CREATE_DATABASE` * `DELETE_DATABASE` "preCheckMajorVersionUpgradeContext": { # Pre-check major version upgrade context. # This field is only populated when the operation_type is PRE_CHECK_MAJOR_VERSION_UPGRADE. The PreCheckMajorVersionUpgradeContext message itself contains the details for that pre-check, such as the target database version for the upgrade and the results of the check (including any warnings or errors found). "kind": "A String", # Optional. This is always `sql#preCheckMajorVersionUpgradeContext`. + "maxRuntime": "A String", # Optional. The maximum allowed runtime for the precheck operation. "preCheckResponse": [ # Output only. The responses from the precheck operation. { # Structured PreCheckResponse containing message, type, and required actions. "actionsRequired": [ # The actions that the user needs to take. Use repeated for multiple actions. @@ -7253,6 +7287,7 @@

Method Details

"operationType": "A String", # The type of the operation. Valid values are: * `CREATE` * `DELETE` * `UPDATE` * `RESTART` * `IMPORT` * `EXPORT` * `BACKUP_VOLUME` * `RESTORE_VOLUME` * `CREATE_USER` * `DELETE_USER` * `CREATE_DATABASE` * `DELETE_DATABASE` "preCheckMajorVersionUpgradeContext": { # Pre-check major version upgrade context. # This field is only populated when the operation_type is PRE_CHECK_MAJOR_VERSION_UPGRADE. The PreCheckMajorVersionUpgradeContext message itself contains the details for that pre-check, such as the target database version for the upgrade and the results of the check (including any warnings or errors found). "kind": "A String", # Optional. This is always `sql#preCheckMajorVersionUpgradeContext`. + "maxRuntime": "A String", # Optional. The maximum allowed runtime for the precheck operation. "preCheckResponse": [ # Output only. The responses from the precheck operation. { # Structured PreCheckResponse containing message, type, and required actions. "actionsRequired": [ # The actions that the user needs to take. Use repeated for multiple actions. @@ -7433,6 +7468,7 @@

Method Details

"operationType": "A String", # The type of the operation. Valid values are: * `CREATE` * `DELETE` * `UPDATE` * `RESTART` * `IMPORT` * `EXPORT` * `BACKUP_VOLUME` * `RESTORE_VOLUME` * `CREATE_USER` * `DELETE_USER` * `CREATE_DATABASE` * `DELETE_DATABASE` "preCheckMajorVersionUpgradeContext": { # Pre-check major version upgrade context. # This field is only populated when the operation_type is PRE_CHECK_MAJOR_VERSION_UPGRADE. The PreCheckMajorVersionUpgradeContext message itself contains the details for that pre-check, such as the target database version for the upgrade and the results of the check (including any warnings or errors found). "kind": "A String", # Optional. This is always `sql#preCheckMajorVersionUpgradeContext`. + "maxRuntime": "A String", # Optional. The maximum allowed runtime for the precheck operation. "preCheckResponse": [ # Output only. The responses from the precheck operation. { # Structured PreCheckResponse containing message, type, and required actions. "actionsRequired": [ # The actions that the user needs to take. Use repeated for multiple actions. @@ -7613,6 +7649,7 @@

Method Details

"operationType": "A String", # The type of the operation. Valid values are: * `CREATE` * `DELETE` * `UPDATE` * `RESTART` * `IMPORT` * `EXPORT` * `BACKUP_VOLUME` * `RESTORE_VOLUME` * `CREATE_USER` * `DELETE_USER` * `CREATE_DATABASE` * `DELETE_DATABASE` "preCheckMajorVersionUpgradeContext": { # Pre-check major version upgrade context. # This field is only populated when the operation_type is PRE_CHECK_MAJOR_VERSION_UPGRADE. The PreCheckMajorVersionUpgradeContext message itself contains the details for that pre-check, such as the target database version for the upgrade and the results of the check (including any warnings or errors found). "kind": "A String", # Optional. This is always `sql#preCheckMajorVersionUpgradeContext`. + "maxRuntime": "A String", # Optional. The maximum allowed runtime for the precheck operation. "preCheckResponse": [ # Output only. The responses from the precheck operation. { # Structured PreCheckResponse containing message, type, and required actions. "actionsRequired": [ # The actions that the user needs to take. Use repeated for multiple actions. @@ -7794,6 +7831,7 @@

Method Details

"operationType": "A String", # The type of the operation. Valid values are: * `CREATE` * `DELETE` * `UPDATE` * `RESTART` * `IMPORT` * `EXPORT` * `BACKUP_VOLUME` * `RESTORE_VOLUME` * `CREATE_USER` * `DELETE_USER` * `CREATE_DATABASE` * `DELETE_DATABASE` "preCheckMajorVersionUpgradeContext": { # Pre-check major version upgrade context. # This field is only populated when the operation_type is PRE_CHECK_MAJOR_VERSION_UPGRADE. The PreCheckMajorVersionUpgradeContext message itself contains the details for that pre-check, such as the target database version for the upgrade and the results of the check (including any warnings or errors found). "kind": "A String", # Optional. This is always `sql#preCheckMajorVersionUpgradeContext`. + "maxRuntime": "A String", # Optional. The maximum allowed runtime for the precheck operation. "preCheckResponse": [ # Output only. The responses from the precheck operation. { # Structured PreCheckResponse containing message, type, and required actions. "actionsRequired": [ # The actions that the user needs to take. Use repeated for multiple actions. @@ -7984,6 +8022,7 @@

Method Details

"operationType": "A String", # The type of the operation. Valid values are: * `CREATE` * `DELETE` * `UPDATE` * `RESTART` * `IMPORT` * `EXPORT` * `BACKUP_VOLUME` * `RESTORE_VOLUME` * `CREATE_USER` * `DELETE_USER` * `CREATE_DATABASE` * `DELETE_DATABASE` "preCheckMajorVersionUpgradeContext": { # Pre-check major version upgrade context. # This field is only populated when the operation_type is PRE_CHECK_MAJOR_VERSION_UPGRADE. The PreCheckMajorVersionUpgradeContext message itself contains the details for that pre-check, such as the target database version for the upgrade and the results of the check (including any warnings or errors found). "kind": "A String", # Optional. This is always `sql#preCheckMajorVersionUpgradeContext`. + "maxRuntime": "A String", # Optional. The maximum allowed runtime for the precheck operation. "preCheckResponse": [ # Output only. The responses from the precheck operation. { # Structured PreCheckResponse containing message, type, and required actions. "actionsRequired": [ # The actions that the user needs to take. Use repeated for multiple actions. @@ -8041,6 +8080,7 @@

Method Details

"connectionName": "A String", # Connection name of the Cloud SQL instance used in connection strings. "createTime": "A String", # Output only. The time when the instance was created in [RFC 3339](https://tools.ietf.org/html/rfc3339) format, for example `2012-11-15T16:19:00.094Z`. "currentDiskSize": "A String", # The current disk usage of the instance in bytes. This property has been deprecated. Use the "cloudsql.googleapis.com/database/disk/bytes_used" metric in Cloud Monitoring API instead. Please see [this announcement](https://groups.google.com/d/msg/google-cloud-sql-announce/I_7-F9EBhT0/BtvFtdFeAgAJ) for details. + "databaseCenterIntegration": "A String", # Optional. State of the Database Center integration for this instance. When unspecified, Database Center integration is enabled by default. "databaseCenterIntegrationEnabled": True or False, # Optional. If true, instance metadata is sent to the Database Center. If false, instance metadata is not sent to the Database Center. "databaseInstalledVersion": "A String", # Output only. Stores the current database version running on the instance including minor version such as `MYSQL_8_0_18`. "databaseVersion": "A String", # The database engine type and version. The `databaseVersion` field cannot be changed after instance creation. @@ -8438,6 +8478,7 @@

Method Details

"a_key": "A String", }, }, + "skipPrecheck": True or False, # Optional. Input only. Determines whether the precheck step is skipped during a major version upgrade. "sqlNetworkArchitecture": "A String", "state": "A String", # The current serving state of the Cloud SQL instance. "suspensionReason": [ # If the instance state is SUSPENDED, the reason for the suspension. @@ -8591,6 +8632,7 @@

Method Details

"operationType": "A String", # The type of the operation. Valid values are: * `CREATE` * `DELETE` * `UPDATE` * `RESTART` * `IMPORT` * `EXPORT` * `BACKUP_VOLUME` * `RESTORE_VOLUME` * `CREATE_USER` * `DELETE_USER` * `CREATE_DATABASE` * `DELETE_DATABASE` "preCheckMajorVersionUpgradeContext": { # Pre-check major version upgrade context. # This field is only populated when the operation_type is PRE_CHECK_MAJOR_VERSION_UPGRADE. The PreCheckMajorVersionUpgradeContext message itself contains the details for that pre-check, such as the target database version for the upgrade and the results of the check (including any warnings or errors found). "kind": "A String", # Optional. This is always `sql#preCheckMajorVersionUpgradeContext`. + "maxRuntime": "A String", # Optional. The maximum allowed runtime for the precheck operation. "preCheckResponse": [ # Output only. The responses from the precheck operation. { # Structured PreCheckResponse containing message, type, and required actions. "actionsRequired": [ # The actions that the user needs to take. Use repeated for multiple actions. diff --git a/docs/dyn/sqladmin_v1.operations.html b/docs/dyn/sqladmin_v1.operations.html index 932bfecf6a..547d730973 100644 --- a/docs/dyn/sqladmin_v1.operations.html +++ b/docs/dyn/sqladmin_v1.operations.html @@ -256,6 +256,7 @@

Method Details

"operationType": "A String", # The type of the operation. Valid values are: * `CREATE` * `DELETE` * `UPDATE` * `RESTART` * `IMPORT` * `EXPORT` * `BACKUP_VOLUME` * `RESTORE_VOLUME` * `CREATE_USER` * `DELETE_USER` * `CREATE_DATABASE` * `DELETE_DATABASE` "preCheckMajorVersionUpgradeContext": { # Pre-check major version upgrade context. # This field is only populated when the operation_type is PRE_CHECK_MAJOR_VERSION_UPGRADE. The PreCheckMajorVersionUpgradeContext message itself contains the details for that pre-check, such as the target database version for the upgrade and the results of the check (including any warnings or errors found). "kind": "A String", # Optional. This is always `sql#preCheckMajorVersionUpgradeContext`. + "maxRuntime": "A String", # Optional. The maximum allowed runtime for the precheck operation. "preCheckResponse": [ # Output only. The responses from the precheck operation. { # Structured PreCheckResponse containing message, type, and required actions. "actionsRequired": [ # The actions that the user needs to take. Use repeated for multiple actions. @@ -440,6 +441,7 @@

Method Details

"operationType": "A String", # The type of the operation. Valid values are: * `CREATE` * `DELETE` * `UPDATE` * `RESTART` * `IMPORT` * `EXPORT` * `BACKUP_VOLUME` * `RESTORE_VOLUME` * `CREATE_USER` * `DELETE_USER` * `CREATE_DATABASE` * `DELETE_DATABASE` "preCheckMajorVersionUpgradeContext": { # Pre-check major version upgrade context. # This field is only populated when the operation_type is PRE_CHECK_MAJOR_VERSION_UPGRADE. The PreCheckMajorVersionUpgradeContext message itself contains the details for that pre-check, such as the target database version for the upgrade and the results of the check (including any warnings or errors found). "kind": "A String", # Optional. This is always `sql#preCheckMajorVersionUpgradeContext`. + "maxRuntime": "A String", # Optional. The maximum allowed runtime for the precheck operation. "preCheckResponse": [ # Output only. The responses from the precheck operation. { # Structured PreCheckResponse containing message, type, and required actions. "actionsRequired": [ # The actions that the user needs to take. Use repeated for multiple actions. diff --git a/docs/dyn/sqladmin_v1.projects.instances.html b/docs/dyn/sqladmin_v1.projects.instances.html index a9c00c4120..505e26acbc 100644 --- a/docs/dyn/sqladmin_v1.projects.instances.html +++ b/docs/dyn/sqladmin_v1.projects.instances.html @@ -299,6 +299,7 @@

Method Details

"operationType": "A String", # The type of the operation. Valid values are: * `CREATE` * `DELETE` * `UPDATE` * `RESTART` * `IMPORT` * `EXPORT` * `BACKUP_VOLUME` * `RESTORE_VOLUME` * `CREATE_USER` * `DELETE_USER` * `CREATE_DATABASE` * `DELETE_DATABASE` "preCheckMajorVersionUpgradeContext": { # Pre-check major version upgrade context. # This field is only populated when the operation_type is PRE_CHECK_MAJOR_VERSION_UPGRADE. The PreCheckMajorVersionUpgradeContext message itself contains the details for that pre-check, such as the target database version for the upgrade and the results of the check (including any warnings or errors found). "kind": "A String", # Optional. This is always `sql#preCheckMajorVersionUpgradeContext`. + "maxRuntime": "A String", # Optional. The maximum allowed runtime for the precheck operation. "preCheckResponse": [ # Output only. The responses from the precheck operation. { # Structured PreCheckResponse containing message, type, and required actions. "actionsRequired": [ # The actions that the user needs to take. Use repeated for multiple actions. @@ -489,6 +490,7 @@

Method Details

"operationType": "A String", # The type of the operation. Valid values are: * `CREATE` * `DELETE` * `UPDATE` * `RESTART` * `IMPORT` * `EXPORT` * `BACKUP_VOLUME` * `RESTORE_VOLUME` * `CREATE_USER` * `DELETE_USER` * `CREATE_DATABASE` * `DELETE_DATABASE` "preCheckMajorVersionUpgradeContext": { # Pre-check major version upgrade context. # This field is only populated when the operation_type is PRE_CHECK_MAJOR_VERSION_UPGRADE. The PreCheckMajorVersionUpgradeContext message itself contains the details for that pre-check, such as the target database version for the upgrade and the results of the check (including any warnings or errors found). "kind": "A String", # Optional. This is always `sql#preCheckMajorVersionUpgradeContext`. + "maxRuntime": "A String", # Optional. The maximum allowed runtime for the precheck operation. "preCheckResponse": [ # Output only. The responses from the precheck operation. { # Structured PreCheckResponse containing message, type, and required actions. "actionsRequired": [ # The actions that the user needs to take. Use repeated for multiple actions. @@ -675,6 +677,7 @@

Method Details

"operationType": "A String", # The type of the operation. Valid values are: * `CREATE` * `DELETE` * `UPDATE` * `RESTART` * `IMPORT` * `EXPORT` * `BACKUP_VOLUME` * `RESTORE_VOLUME` * `CREATE_USER` * `DELETE_USER` * `CREATE_DATABASE` * `DELETE_DATABASE` "preCheckMajorVersionUpgradeContext": { # Pre-check major version upgrade context. # This field is only populated when the operation_type is PRE_CHECK_MAJOR_VERSION_UPGRADE. The PreCheckMajorVersionUpgradeContext message itself contains the details for that pre-check, such as the target database version for the upgrade and the results of the check (including any warnings or errors found). "kind": "A String", # Optional. This is always `sql#preCheckMajorVersionUpgradeContext`. + "maxRuntime": "A String", # Optional. The maximum allowed runtime for the precheck operation. "preCheckResponse": [ # Output only. The responses from the precheck operation. { # Structured PreCheckResponse containing message, type, and required actions. "actionsRequired": [ # The actions that the user needs to take. Use repeated for multiple actions. @@ -874,6 +877,7 @@

Method Details

"operationType": "A String", # The type of the operation. Valid values are: * `CREATE` * `DELETE` * `UPDATE` * `RESTART` * `IMPORT` * `EXPORT` * `BACKUP_VOLUME` * `RESTORE_VOLUME` * `CREATE_USER` * `DELETE_USER` * `CREATE_DATABASE` * `DELETE_DATABASE` "preCheckMajorVersionUpgradeContext": { # Pre-check major version upgrade context. # This field is only populated when the operation_type is PRE_CHECK_MAJOR_VERSION_UPGRADE. The PreCheckMajorVersionUpgradeContext message itself contains the details for that pre-check, such as the target database version for the upgrade and the results of the check (including any warnings or errors found). "kind": "A String", # Optional. This is always `sql#preCheckMajorVersionUpgradeContext`. + "maxRuntime": "A String", # Optional. The maximum allowed runtime for the precheck operation. "preCheckResponse": [ # Output only. The responses from the precheck operation. { # Structured PreCheckResponse containing message, type, and required actions. "actionsRequired": [ # The actions that the user needs to take. Use repeated for multiple actions. diff --git a/docs/dyn/sqladmin_v1.sslCerts.html b/docs/dyn/sqladmin_v1.sslCerts.html index 239ee9e76e..3372de0f21 100644 --- a/docs/dyn/sqladmin_v1.sslCerts.html +++ b/docs/dyn/sqladmin_v1.sslCerts.html @@ -276,6 +276,7 @@

Method Details

"operationType": "A String", # The type of the operation. Valid values are: * `CREATE` * `DELETE` * `UPDATE` * `RESTART` * `IMPORT` * `EXPORT` * `BACKUP_VOLUME` * `RESTORE_VOLUME` * `CREATE_USER` * `DELETE_USER` * `CREATE_DATABASE` * `DELETE_DATABASE` "preCheckMajorVersionUpgradeContext": { # Pre-check major version upgrade context. # This field is only populated when the operation_type is PRE_CHECK_MAJOR_VERSION_UPGRADE. The PreCheckMajorVersionUpgradeContext message itself contains the details for that pre-check, such as the target database version for the upgrade and the results of the check (including any warnings or errors found). "kind": "A String", # Optional. This is always `sql#preCheckMajorVersionUpgradeContext`. + "maxRuntime": "A String", # Optional. The maximum allowed runtime for the precheck operation. "preCheckResponse": [ # Output only. The responses from the precheck operation. { # Structured PreCheckResponse containing message, type, and required actions. "actionsRequired": [ # The actions that the user needs to take. Use repeated for multiple actions. @@ -507,6 +508,7 @@

Method Details

"operationType": "A String", # The type of the operation. Valid values are: * `CREATE` * `DELETE` * `UPDATE` * `RESTART` * `IMPORT` * `EXPORT` * `BACKUP_VOLUME` * `RESTORE_VOLUME` * `CREATE_USER` * `DELETE_USER` * `CREATE_DATABASE` * `DELETE_DATABASE` "preCheckMajorVersionUpgradeContext": { # Pre-check major version upgrade context. # This field is only populated when the operation_type is PRE_CHECK_MAJOR_VERSION_UPGRADE. The PreCheckMajorVersionUpgradeContext message itself contains the details for that pre-check, such as the target database version for the upgrade and the results of the check (including any warnings or errors found). "kind": "A String", # Optional. This is always `sql#preCheckMajorVersionUpgradeContext`. + "maxRuntime": "A String", # Optional. The maximum allowed runtime for the precheck operation. "preCheckResponse": [ # Output only. The responses from the precheck operation. { # Structured PreCheckResponse containing message, type, and required actions. "actionsRequired": [ # The actions that the user needs to take. Use repeated for multiple actions. diff --git a/docs/dyn/sqladmin_v1.users.html b/docs/dyn/sqladmin_v1.users.html index 1502ed6cbb..3e9eb54e5e 100644 --- a/docs/dyn/sqladmin_v1.users.html +++ b/docs/dyn/sqladmin_v1.users.html @@ -241,6 +241,7 @@

Method Details

"operationType": "A String", # The type of the operation. Valid values are: * `CREATE` * `DELETE` * `UPDATE` * `RESTART` * `IMPORT` * `EXPORT` * `BACKUP_VOLUME` * `RESTORE_VOLUME` * `CREATE_USER` * `DELETE_USER` * `CREATE_DATABASE` * `DELETE_DATABASE` "preCheckMajorVersionUpgradeContext": { # Pre-check major version upgrade context. # This field is only populated when the operation_type is PRE_CHECK_MAJOR_VERSION_UPGRADE. The PreCheckMajorVersionUpgradeContext message itself contains the details for that pre-check, such as the target database version for the upgrade and the results of the check (including any warnings or errors found). "kind": "A String", # Optional. This is always `sql#preCheckMajorVersionUpgradeContext`. + "maxRuntime": "A String", # Optional. The maximum allowed runtime for the precheck operation. "preCheckResponse": [ # Output only. The responses from the precheck operation. { # Structured PreCheckResponse containing message, type, and required actions. "actionsRequired": [ # The actions that the user needs to take. Use repeated for multiple actions. @@ -515,6 +516,7 @@

Method Details

"operationType": "A String", # The type of the operation. Valid values are: * `CREATE` * `DELETE` * `UPDATE` * `RESTART` * `IMPORT` * `EXPORT` * `BACKUP_VOLUME` * `RESTORE_VOLUME` * `CREATE_USER` * `DELETE_USER` * `CREATE_DATABASE` * `DELETE_DATABASE` "preCheckMajorVersionUpgradeContext": { # Pre-check major version upgrade context. # This field is only populated when the operation_type is PRE_CHECK_MAJOR_VERSION_UPGRADE. The PreCheckMajorVersionUpgradeContext message itself contains the details for that pre-check, such as the target database version for the upgrade and the results of the check (including any warnings or errors found). "kind": "A String", # Optional. This is always `sql#preCheckMajorVersionUpgradeContext`. + "maxRuntime": "A String", # Optional. The maximum allowed runtime for the precheck operation. "preCheckResponse": [ # Output only. The responses from the precheck operation. { # Structured PreCheckResponse containing message, type, and required actions. "actionsRequired": [ # The actions that the user needs to take. Use repeated for multiple actions. @@ -799,6 +801,7 @@

Method Details

"operationType": "A String", # The type of the operation. Valid values are: * `CREATE` * `DELETE` * `UPDATE` * `RESTART` * `IMPORT` * `EXPORT` * `BACKUP_VOLUME` * `RESTORE_VOLUME` * `CREATE_USER` * `DELETE_USER` * `CREATE_DATABASE` * `DELETE_DATABASE` "preCheckMajorVersionUpgradeContext": { # Pre-check major version upgrade context. # This field is only populated when the operation_type is PRE_CHECK_MAJOR_VERSION_UPGRADE. The PreCheckMajorVersionUpgradeContext message itself contains the details for that pre-check, such as the target database version for the upgrade and the results of the check (including any warnings or errors found). "kind": "A String", # Optional. This is always `sql#preCheckMajorVersionUpgradeContext`. + "maxRuntime": "A String", # Optional. The maximum allowed runtime for the precheck operation. "preCheckResponse": [ # Output only. The responses from the precheck operation. { # Structured PreCheckResponse containing message, type, and required actions. "actionsRequired": [ # The actions that the user needs to take. Use repeated for multiple actions. diff --git a/docs/dyn/sqladmin_v1.workloadCaptures.html b/docs/dyn/sqladmin_v1.workloadCaptures.html index 9f165d415f..2b7a913099 100644 --- a/docs/dyn/sqladmin_v1.workloadCaptures.html +++ b/docs/dyn/sqladmin_v1.workloadCaptures.html @@ -117,6 +117,7 @@

Method Details

"kind": "A String", # This is always `sql#workloadCapturesList`. "workloadCaptures": [ # List of captured workloads for the instance. { # Captured workload for an instance. + "backupId": "A String", # Output only. The base backup ID associated with the workload capture. "endTime": "A String", # Output only. The end time of the workload capture. "replayInstance": "A String", # Output only. The name of the replay instance, if live replay was enabled. "retentionDays": 42, # Output only. The retention period in days for the captured workload. @@ -279,6 +280,7 @@

Method Details

"operationType": "A String", # The type of the operation. Valid values are: * `CREATE` * `DELETE` * `UPDATE` * `RESTART` * `IMPORT` * `EXPORT` * `BACKUP_VOLUME` * `RESTORE_VOLUME` * `CREATE_USER` * `DELETE_USER` * `CREATE_DATABASE` * `DELETE_DATABASE` "preCheckMajorVersionUpgradeContext": { # Pre-check major version upgrade context. # This field is only populated when the operation_type is PRE_CHECK_MAJOR_VERSION_UPGRADE. The PreCheckMajorVersionUpgradeContext message itself contains the details for that pre-check, such as the target database version for the upgrade and the results of the check (including any warnings or errors found). "kind": "A String", # Optional. This is always `sql#preCheckMajorVersionUpgradeContext`. + "maxRuntime": "A String", # Optional. The maximum allowed runtime for the precheck operation. "preCheckResponse": [ # Output only. The responses from the precheck operation. { # Structured PreCheckResponse containing message, type, and required actions. "actionsRequired": [ # The actions that the user needs to take. Use repeated for multiple actions. @@ -469,6 +471,7 @@

Method Details

"operationType": "A String", # The type of the operation. Valid values are: * `CREATE` * `DELETE` * `UPDATE` * `RESTART` * `IMPORT` * `EXPORT` * `BACKUP_VOLUME` * `RESTORE_VOLUME` * `CREATE_USER` * `DELETE_USER` * `CREATE_DATABASE` * `DELETE_DATABASE` "preCheckMajorVersionUpgradeContext": { # Pre-check major version upgrade context. # This field is only populated when the operation_type is PRE_CHECK_MAJOR_VERSION_UPGRADE. The PreCheckMajorVersionUpgradeContext message itself contains the details for that pre-check, such as the target database version for the upgrade and the results of the check (including any warnings or errors found). "kind": "A String", # Optional. This is always `sql#preCheckMajorVersionUpgradeContext`. + "maxRuntime": "A String", # Optional. The maximum allowed runtime for the precheck operation. "preCheckResponse": [ # Output only. The responses from the precheck operation. { # Structured PreCheckResponse containing message, type, and required actions. "actionsRequired": [ # The actions that the user needs to take. Use repeated for multiple actions. @@ -657,6 +660,7 @@

Method Details

"operationType": "A String", # The type of the operation. Valid values are: * `CREATE` * `DELETE` * `UPDATE` * `RESTART` * `IMPORT` * `EXPORT` * `BACKUP_VOLUME` * `RESTORE_VOLUME` * `CREATE_USER` * `DELETE_USER` * `CREATE_DATABASE` * `DELETE_DATABASE` "preCheckMajorVersionUpgradeContext": { # Pre-check major version upgrade context. # This field is only populated when the operation_type is PRE_CHECK_MAJOR_VERSION_UPGRADE. The PreCheckMajorVersionUpgradeContext message itself contains the details for that pre-check, such as the target database version for the upgrade and the results of the check (including any warnings or errors found). "kind": "A String", # Optional. This is always `sql#preCheckMajorVersionUpgradeContext`. + "maxRuntime": "A String", # Optional. The maximum allowed runtime for the precheck operation. "preCheckResponse": [ # Output only. The responses from the precheck operation. { # Structured PreCheckResponse containing message, type, and required actions. "actionsRequired": [ # The actions that the user needs to take. Use repeated for multiple actions. @@ -847,6 +851,7 @@

Method Details

"operationType": "A String", # The type of the operation. Valid values are: * `CREATE` * `DELETE` * `UPDATE` * `RESTART` * `IMPORT` * `EXPORT` * `BACKUP_VOLUME` * `RESTORE_VOLUME` * `CREATE_USER` * `DELETE_USER` * `CREATE_DATABASE` * `DELETE_DATABASE` "preCheckMajorVersionUpgradeContext": { # Pre-check major version upgrade context. # This field is only populated when the operation_type is PRE_CHECK_MAJOR_VERSION_UPGRADE. The PreCheckMajorVersionUpgradeContext message itself contains the details for that pre-check, such as the target database version for the upgrade and the results of the check (including any warnings or errors found). "kind": "A String", # Optional. This is always `sql#preCheckMajorVersionUpgradeContext`. + "maxRuntime": "A String", # Optional. The maximum allowed runtime for the precheck operation. "preCheckResponse": [ # Output only. The responses from the precheck operation. { # Structured PreCheckResponse containing message, type, and required actions. "actionsRequired": [ # The actions that the user needs to take. Use repeated for multiple actions. diff --git a/docs/dyn/sqladmin_v1beta4.backupRuns.html b/docs/dyn/sqladmin_v1beta4.backupRuns.html index 7ec35c13d0..d0e800bdf2 100644 --- a/docs/dyn/sqladmin_v1beta4.backupRuns.html +++ b/docs/dyn/sqladmin_v1beta4.backupRuns.html @@ -239,6 +239,7 @@

Method Details

"operationType": "A String", # The type of the operation. Valid values are: * `CREATE` * `DELETE` * `UPDATE` * `RESTART` * `IMPORT` * `EXPORT` * `BACKUP_VOLUME` * `RESTORE_VOLUME` * `CREATE_USER` * `DELETE_USER` * `CREATE_DATABASE` * `DELETE_DATABASE` "preCheckMajorVersionUpgradeContext": { # Pre-check major version upgrade context. # The context for pre-check major version upgrade operation, if applicable. This field is only populated when the operation_type is PRE_CHECK_MAJOR_VERSION_UPGRADE. The PreCheckMajorVersionUpgradeContext message itself contains the details for that pre-check, such as the target database version for the upgrade and the results of the check (including any warnings or errors found). "kind": "A String", # Optional. This is always `sql#preCheckMajorVersionUpgradeContext`. + "maxRuntime": "A String", # Optional. The maximum allowed runtime for the precheck operation. "preCheckResponse": [ # Output only. The responses from the precheck operation. { # Structured PreCheckResponse containing message, type, and required actions. "actionsRequired": [ # The actions that the user needs to take. Use repeated for multiple actions. @@ -506,6 +507,7 @@

Method Details

"operationType": "A String", # The type of the operation. Valid values are: * `CREATE` * `DELETE` * `UPDATE` * `RESTART` * `IMPORT` * `EXPORT` * `BACKUP_VOLUME` * `RESTORE_VOLUME` * `CREATE_USER` * `DELETE_USER` * `CREATE_DATABASE` * `DELETE_DATABASE` "preCheckMajorVersionUpgradeContext": { # Pre-check major version upgrade context. # The context for pre-check major version upgrade operation, if applicable. This field is only populated when the operation_type is PRE_CHECK_MAJOR_VERSION_UPGRADE. The PreCheckMajorVersionUpgradeContext message itself contains the details for that pre-check, such as the target database version for the upgrade and the results of the check (including any warnings or errors found). "kind": "A String", # Optional. This is always `sql#preCheckMajorVersionUpgradeContext`. + "maxRuntime": "A String", # Optional. The maximum allowed runtime for the precheck operation. "preCheckResponse": [ # Output only. The responses from the precheck operation. { # Structured PreCheckResponse containing message, type, and required actions. "actionsRequired": [ # The actions that the user needs to take. Use repeated for multiple actions. diff --git a/docs/dyn/sqladmin_v1beta4.backups.html b/docs/dyn/sqladmin_v1beta4.backups.html index fc1e68688d..7b8ead019b 100644 --- a/docs/dyn/sqladmin_v1beta4.backups.html +++ b/docs/dyn/sqladmin_v1beta4.backups.html @@ -135,6 +135,7 @@

Method Details

"connectionName": "A String", # Connection name of the Cloud SQL instance used in connection strings. "createTime": "A String", # Output only. The time when the instance was created in [RFC 3339](https://tools.ietf.org/html/rfc3339) format, for example `2012-11-15T16:19:00.094Z`. "currentDiskSize": "A String", # The current disk usage of the instance in bytes. This property has been deprecated. Use the "cloudsql.googleapis.com/database/disk/bytes_used" metric in Cloud Monitoring API instead. Please see [this announcement](https://groups.google.com/d/msg/google-cloud-sql-announce/I_7-F9EBhT0/BtvFtdFeAgAJ) for details. + "databaseCenterIntegration": "A String", # Optional. State of the Database Center integration for this instance. When unspecified, Database Center integration is enabled by default. "databaseCenterIntegrationEnabled": True or False, # Optional. If true, instance metadata is sent to the Database Center. If false, instance metadata is not sent to the Database Center. "databaseInstalledVersion": "A String", # Output only. Stores the current database version running on the instance including minor version such as `MYSQL_8_0_18`. "databaseVersion": "A String", # The database engine type and version. The `databaseVersion` field cannot be changed after instance creation. @@ -532,6 +533,7 @@

Method Details

"a_key": "A String", }, }, + "skipPrecheck": True or False, # Optional. Input only. Determines whether the precheck step is skipped during a major version upgrade. "sqlNetworkArchitecture": "A String", # The SQL network architecture for the instance. "state": "A String", # The current serving state of the Cloud SQL instance. "suspensionReason": [ # If the instance state is SUSPENDED, the reason for the suspension. @@ -698,6 +700,7 @@

Method Details

"operationType": "A String", # The type of the operation. Valid values are: * `CREATE` * `DELETE` * `UPDATE` * `RESTART` * `IMPORT` * `EXPORT` * `BACKUP_VOLUME` * `RESTORE_VOLUME` * `CREATE_USER` * `DELETE_USER` * `CREATE_DATABASE` * `DELETE_DATABASE` "preCheckMajorVersionUpgradeContext": { # Pre-check major version upgrade context. # The context for pre-check major version upgrade operation, if applicable. This field is only populated when the operation_type is PRE_CHECK_MAJOR_VERSION_UPGRADE. The PreCheckMajorVersionUpgradeContext message itself contains the details for that pre-check, such as the target database version for the upgrade and the results of the check (including any warnings or errors found). "kind": "A String", # Optional. This is always `sql#preCheckMajorVersionUpgradeContext`. + "maxRuntime": "A String", # Optional. The maximum allowed runtime for the precheck operation. "preCheckResponse": [ # Output only. The responses from the precheck operation. { # Structured PreCheckResponse containing message, type, and required actions. "actionsRequired": [ # The actions that the user needs to take. Use repeated for multiple actions. @@ -876,6 +879,7 @@

Method Details

"operationType": "A String", # The type of the operation. Valid values are: * `CREATE` * `DELETE` * `UPDATE` * `RESTART` * `IMPORT` * `EXPORT` * `BACKUP_VOLUME` * `RESTORE_VOLUME` * `CREATE_USER` * `DELETE_USER` * `CREATE_DATABASE` * `DELETE_DATABASE` "preCheckMajorVersionUpgradeContext": { # Pre-check major version upgrade context. # The context for pre-check major version upgrade operation, if applicable. This field is only populated when the operation_type is PRE_CHECK_MAJOR_VERSION_UPGRADE. The PreCheckMajorVersionUpgradeContext message itself contains the details for that pre-check, such as the target database version for the upgrade and the results of the check (including any warnings or errors found). "kind": "A String", # Optional. This is always `sql#preCheckMajorVersionUpgradeContext`. + "maxRuntime": "A String", # Optional. The maximum allowed runtime for the precheck operation. "preCheckResponse": [ # Output only. The responses from the precheck operation. { # Structured PreCheckResponse containing message, type, and required actions. "actionsRequired": [ # The actions that the user needs to take. Use repeated for multiple actions. @@ -954,6 +958,7 @@

Method Details

"connectionName": "A String", # Connection name of the Cloud SQL instance used in connection strings. "createTime": "A String", # Output only. The time when the instance was created in [RFC 3339](https://tools.ietf.org/html/rfc3339) format, for example `2012-11-15T16:19:00.094Z`. "currentDiskSize": "A String", # The current disk usage of the instance in bytes. This property has been deprecated. Use the "cloudsql.googleapis.com/database/disk/bytes_used" metric in Cloud Monitoring API instead. Please see [this announcement](https://groups.google.com/d/msg/google-cloud-sql-announce/I_7-F9EBhT0/BtvFtdFeAgAJ) for details. + "databaseCenterIntegration": "A String", # Optional. State of the Database Center integration for this instance. When unspecified, Database Center integration is enabled by default. "databaseCenterIntegrationEnabled": True or False, # Optional. If true, instance metadata is sent to the Database Center. If false, instance metadata is not sent to the Database Center. "databaseInstalledVersion": "A String", # Output only. Stores the current database version running on the instance including minor version such as `MYSQL_8_0_18`. "databaseVersion": "A String", # The database engine type and version. The `databaseVersion` field cannot be changed after instance creation. @@ -1351,6 +1356,7 @@

Method Details

"a_key": "A String", }, }, + "skipPrecheck": True or False, # Optional. Input only. Determines whether the precheck step is skipped during a major version upgrade. "sqlNetworkArchitecture": "A String", # The SQL network architecture for the instance. "state": "A String", # The current serving state of the Cloud SQL instance. "suspensionReason": [ # If the instance state is SUSPENDED, the reason for the suspension. @@ -1429,6 +1435,7 @@

Method Details

"connectionName": "A String", # Connection name of the Cloud SQL instance used in connection strings. "createTime": "A String", # Output only. The time when the instance was created in [RFC 3339](https://tools.ietf.org/html/rfc3339) format, for example `2012-11-15T16:19:00.094Z`. "currentDiskSize": "A String", # The current disk usage of the instance in bytes. This property has been deprecated. Use the "cloudsql.googleapis.com/database/disk/bytes_used" metric in Cloud Monitoring API instead. Please see [this announcement](https://groups.google.com/d/msg/google-cloud-sql-announce/I_7-F9EBhT0/BtvFtdFeAgAJ) for details. + "databaseCenterIntegration": "A String", # Optional. State of the Database Center integration for this instance. When unspecified, Database Center integration is enabled by default. "databaseCenterIntegrationEnabled": True or False, # Optional. If true, instance metadata is sent to the Database Center. If false, instance metadata is not sent to the Database Center. "databaseInstalledVersion": "A String", # Output only. Stores the current database version running on the instance including minor version such as `MYSQL_8_0_18`. "databaseVersion": "A String", # The database engine type and version. The `databaseVersion` field cannot be changed after instance creation. @@ -1826,6 +1833,7 @@

Method Details

"a_key": "A String", }, }, + "skipPrecheck": True or False, # Optional. Input only. Determines whether the precheck step is skipped during a major version upgrade. "sqlNetworkArchitecture": "A String", # The SQL network architecture for the instance. "state": "A String", # The current serving state of the Cloud SQL instance. "suspensionReason": [ # If the instance state is SUSPENDED, the reason for the suspension. @@ -1918,6 +1926,7 @@

Method Details

"connectionName": "A String", # Connection name of the Cloud SQL instance used in connection strings. "createTime": "A String", # Output only. The time when the instance was created in [RFC 3339](https://tools.ietf.org/html/rfc3339) format, for example `2012-11-15T16:19:00.094Z`. "currentDiskSize": "A String", # The current disk usage of the instance in bytes. This property has been deprecated. Use the "cloudsql.googleapis.com/database/disk/bytes_used" metric in Cloud Monitoring API instead. Please see [this announcement](https://groups.google.com/d/msg/google-cloud-sql-announce/I_7-F9EBhT0/BtvFtdFeAgAJ) for details. + "databaseCenterIntegration": "A String", # Optional. State of the Database Center integration for this instance. When unspecified, Database Center integration is enabled by default. "databaseCenterIntegrationEnabled": True or False, # Optional. If true, instance metadata is sent to the Database Center. If false, instance metadata is not sent to the Database Center. "databaseInstalledVersion": "A String", # Output only. Stores the current database version running on the instance including minor version such as `MYSQL_8_0_18`. "databaseVersion": "A String", # The database engine type and version. The `databaseVersion` field cannot be changed after instance creation. @@ -2315,6 +2324,7 @@

Method Details

"a_key": "A String", }, }, + "skipPrecheck": True or False, # Optional. Input only. Determines whether the precheck step is skipped during a major version upgrade. "sqlNetworkArchitecture": "A String", # The SQL network architecture for the instance. "state": "A String", # The current serving state of the Cloud SQL instance. "suspensionReason": [ # If the instance state is SUSPENDED, the reason for the suspension. @@ -2482,6 +2492,7 @@

Method Details

"operationType": "A String", # The type of the operation. Valid values are: * `CREATE` * `DELETE` * `UPDATE` * `RESTART` * `IMPORT` * `EXPORT` * `BACKUP_VOLUME` * `RESTORE_VOLUME` * `CREATE_USER` * `DELETE_USER` * `CREATE_DATABASE` * `DELETE_DATABASE` "preCheckMajorVersionUpgradeContext": { # Pre-check major version upgrade context. # The context for pre-check major version upgrade operation, if applicable. This field is only populated when the operation_type is PRE_CHECK_MAJOR_VERSION_UPGRADE. The PreCheckMajorVersionUpgradeContext message itself contains the details for that pre-check, such as the target database version for the upgrade and the results of the check (including any warnings or errors found). "kind": "A String", # Optional. This is always `sql#preCheckMajorVersionUpgradeContext`. + "maxRuntime": "A String", # Optional. The maximum allowed runtime for the precheck operation. "preCheckResponse": [ # Output only. The responses from the precheck operation. { # Structured PreCheckResponse containing message, type, and required actions. "actionsRequired": [ # The actions that the user needs to take. Use repeated for multiple actions. diff --git a/docs/dyn/sqladmin_v1beta4.blueGreenDeployments.html b/docs/dyn/sqladmin_v1beta4.blueGreenDeployments.html index 1b231760ef..1fa45fc9f7 100644 --- a/docs/dyn/sqladmin_v1beta4.blueGreenDeployments.html +++ b/docs/dyn/sqladmin_v1beta4.blueGreenDeployments.html @@ -363,6 +363,7 @@

Method Details

"operationType": "A String", # The type of the operation. Valid values are: * `CREATE` * `DELETE` * `UPDATE` * `RESTART` * `IMPORT` * `EXPORT` * `BACKUP_VOLUME` * `RESTORE_VOLUME` * `CREATE_USER` * `DELETE_USER` * `CREATE_DATABASE` * `DELETE_DATABASE` "preCheckMajorVersionUpgradeContext": { # Pre-check major version upgrade context. # The context for pre-check major version upgrade operation, if applicable. This field is only populated when the operation_type is PRE_CHECK_MAJOR_VERSION_UPGRADE. The PreCheckMajorVersionUpgradeContext message itself contains the details for that pre-check, such as the target database version for the upgrade and the results of the check (including any warnings or errors found). "kind": "A String", # Optional. This is always `sql#preCheckMajorVersionUpgradeContext`. + "maxRuntime": "A String", # Optional. The maximum allowed runtime for the precheck operation. "preCheckResponse": [ # Output only. The responses from the precheck operation. { # Structured PreCheckResponse containing message, type, and required actions. "actionsRequired": [ # The actions that the user needs to take. Use repeated for multiple actions. @@ -542,6 +543,7 @@

Method Details

"operationType": "A String", # The type of the operation. Valid values are: * `CREATE` * `DELETE` * `UPDATE` * `RESTART` * `IMPORT` * `EXPORT` * `BACKUP_VOLUME` * `RESTORE_VOLUME` * `CREATE_USER` * `DELETE_USER` * `CREATE_DATABASE` * `DELETE_DATABASE` "preCheckMajorVersionUpgradeContext": { # Pre-check major version upgrade context. # The context for pre-check major version upgrade operation, if applicable. This field is only populated when the operation_type is PRE_CHECK_MAJOR_VERSION_UPGRADE. The PreCheckMajorVersionUpgradeContext message itself contains the details for that pre-check, such as the target database version for the upgrade and the results of the check (including any warnings or errors found). "kind": "A String", # Optional. This is always `sql#preCheckMajorVersionUpgradeContext`. + "maxRuntime": "A String", # Optional. The maximum allowed runtime for the precheck operation. "preCheckResponse": [ # Output only. The responses from the precheck operation. { # Structured PreCheckResponse containing message, type, and required actions. "actionsRequired": [ # The actions that the user needs to take. Use repeated for multiple actions. @@ -1022,6 +1024,7 @@

Method Details

"operationType": "A String", # The type of the operation. Valid values are: * `CREATE` * `DELETE` * `UPDATE` * `RESTART` * `IMPORT` * `EXPORT` * `BACKUP_VOLUME` * `RESTORE_VOLUME` * `CREATE_USER` * `DELETE_USER` * `CREATE_DATABASE` * `DELETE_DATABASE` "preCheckMajorVersionUpgradeContext": { # Pre-check major version upgrade context. # The context for pre-check major version upgrade operation, if applicable. This field is only populated when the operation_type is PRE_CHECK_MAJOR_VERSION_UPGRADE. The PreCheckMajorVersionUpgradeContext message itself contains the details for that pre-check, such as the target database version for the upgrade and the results of the check (including any warnings or errors found). "kind": "A String", # Optional. This is always `sql#preCheckMajorVersionUpgradeContext`. + "maxRuntime": "A String", # Optional. The maximum allowed runtime for the precheck operation. "preCheckResponse": [ # Output only. The responses from the precheck operation. { # Structured PreCheckResponse containing message, type, and required actions. "actionsRequired": [ # The actions that the user needs to take. Use repeated for multiple actions. diff --git a/docs/dyn/sqladmin_v1beta4.databases.html b/docs/dyn/sqladmin_v1beta4.databases.html index 6995dce77c..4c8a1fabd3 100644 --- a/docs/dyn/sqladmin_v1beta4.databases.html +++ b/docs/dyn/sqladmin_v1beta4.databases.html @@ -243,6 +243,7 @@

Method Details

"operationType": "A String", # The type of the operation. Valid values are: * `CREATE` * `DELETE` * `UPDATE` * `RESTART` * `IMPORT` * `EXPORT` * `BACKUP_VOLUME` * `RESTORE_VOLUME` * `CREATE_USER` * `DELETE_USER` * `CREATE_DATABASE` * `DELETE_DATABASE` "preCheckMajorVersionUpgradeContext": { # Pre-check major version upgrade context. # The context for pre-check major version upgrade operation, if applicable. This field is only populated when the operation_type is PRE_CHECK_MAJOR_VERSION_UPGRADE. The PreCheckMajorVersionUpgradeContext message itself contains the details for that pre-check, such as the target database version for the upgrade and the results of the check (including any warnings or errors found). "kind": "A String", # Optional. This is always `sql#preCheckMajorVersionUpgradeContext`. + "maxRuntime": "A String", # Optional. The maximum allowed runtime for the precheck operation. "preCheckResponse": [ # Output only. The responses from the precheck operation. { # Structured PreCheckResponse containing message, type, and required actions. "actionsRequired": [ # The actions that the user needs to take. Use repeated for multiple actions. @@ -474,6 +475,7 @@

Method Details

"operationType": "A String", # The type of the operation. Valid values are: * `CREATE` * `DELETE` * `UPDATE` * `RESTART` * `IMPORT` * `EXPORT` * `BACKUP_VOLUME` * `RESTORE_VOLUME` * `CREATE_USER` * `DELETE_USER` * `CREATE_DATABASE` * `DELETE_DATABASE` "preCheckMajorVersionUpgradeContext": { # Pre-check major version upgrade context. # The context for pre-check major version upgrade operation, if applicable. This field is only populated when the operation_type is PRE_CHECK_MAJOR_VERSION_UPGRADE. The PreCheckMajorVersionUpgradeContext message itself contains the details for that pre-check, such as the target database version for the upgrade and the results of the check (including any warnings or errors found). "kind": "A String", # Optional. This is always `sql#preCheckMajorVersionUpgradeContext`. + "maxRuntime": "A String", # Optional. The maximum allowed runtime for the precheck operation. "preCheckResponse": [ # Output only. The responses from the precheck operation. { # Structured PreCheckResponse containing message, type, and required actions. "actionsRequired": [ # The actions that the user needs to take. Use repeated for multiple actions. @@ -710,6 +712,7 @@

Method Details

"operationType": "A String", # The type of the operation. Valid values are: * `CREATE` * `DELETE` * `UPDATE` * `RESTART` * `IMPORT` * `EXPORT` * `BACKUP_VOLUME` * `RESTORE_VOLUME` * `CREATE_USER` * `DELETE_USER` * `CREATE_DATABASE` * `DELETE_DATABASE` "preCheckMajorVersionUpgradeContext": { # Pre-check major version upgrade context. # The context for pre-check major version upgrade operation, if applicable. This field is only populated when the operation_type is PRE_CHECK_MAJOR_VERSION_UPGRADE. The PreCheckMajorVersionUpgradeContext message itself contains the details for that pre-check, such as the target database version for the upgrade and the results of the check (including any warnings or errors found). "kind": "A String", # Optional. This is always `sql#preCheckMajorVersionUpgradeContext`. + "maxRuntime": "A String", # Optional. The maximum allowed runtime for the precheck operation. "preCheckResponse": [ # Output only. The responses from the precheck operation. { # Structured PreCheckResponse containing message, type, and required actions. "actionsRequired": [ # The actions that the user needs to take. Use repeated for multiple actions. @@ -909,6 +912,7 @@

Method Details

"operationType": "A String", # The type of the operation. Valid values are: * `CREATE` * `DELETE` * `UPDATE` * `RESTART` * `IMPORT` * `EXPORT` * `BACKUP_VOLUME` * `RESTORE_VOLUME` * `CREATE_USER` * `DELETE_USER` * `CREATE_DATABASE` * `DELETE_DATABASE` "preCheckMajorVersionUpgradeContext": { # Pre-check major version upgrade context. # The context for pre-check major version upgrade operation, if applicable. This field is only populated when the operation_type is PRE_CHECK_MAJOR_VERSION_UPGRADE. The PreCheckMajorVersionUpgradeContext message itself contains the details for that pre-check, such as the target database version for the upgrade and the results of the check (including any warnings or errors found). "kind": "A String", # Optional. This is always `sql#preCheckMajorVersionUpgradeContext`. + "maxRuntime": "A String", # Optional. The maximum allowed runtime for the precheck operation. "preCheckResponse": [ # Output only. The responses from the precheck operation. { # Structured PreCheckResponse containing message, type, and required actions. "actionsRequired": [ # The actions that the user needs to take. Use repeated for multiple actions. diff --git a/docs/dyn/sqladmin_v1beta4.instances.html b/docs/dyn/sqladmin_v1beta4.instances.html index 1e8f61d974..5d70a86ed2 100644 --- a/docs/dyn/sqladmin_v1beta4.instances.html +++ b/docs/dyn/sqladmin_v1beta4.instances.html @@ -420,6 +420,7 @@

Method Details

"operationType": "A String", # The type of the operation. Valid values are: * `CREATE` * `DELETE` * `UPDATE` * `RESTART` * `IMPORT` * `EXPORT` * `BACKUP_VOLUME` * `RESTORE_VOLUME` * `CREATE_USER` * `DELETE_USER` * `CREATE_DATABASE` * `DELETE_DATABASE` "preCheckMajorVersionUpgradeContext": { # Pre-check major version upgrade context. # The context for pre-check major version upgrade operation, if applicable. This field is only populated when the operation_type is PRE_CHECK_MAJOR_VERSION_UPGRADE. The PreCheckMajorVersionUpgradeContext message itself contains the details for that pre-check, such as the target database version for the upgrade and the results of the check (including any warnings or errors found). "kind": "A String", # Optional. This is always `sql#preCheckMajorVersionUpgradeContext`. + "maxRuntime": "A String", # Optional. The maximum allowed runtime for the precheck operation. "preCheckResponse": [ # Output only. The responses from the precheck operation. { # Structured PreCheckResponse containing message, type, and required actions. "actionsRequired": [ # The actions that the user needs to take. Use repeated for multiple actions. @@ -610,6 +611,7 @@

Method Details

"operationType": "A String", # The type of the operation. Valid values are: * `CREATE` * `DELETE` * `UPDATE` * `RESTART` * `IMPORT` * `EXPORT` * `BACKUP_VOLUME` * `RESTORE_VOLUME` * `CREATE_USER` * `DELETE_USER` * `CREATE_DATABASE` * `DELETE_DATABASE` "preCheckMajorVersionUpgradeContext": { # Pre-check major version upgrade context. # The context for pre-check major version upgrade operation, if applicable. This field is only populated when the operation_type is PRE_CHECK_MAJOR_VERSION_UPGRADE. The PreCheckMajorVersionUpgradeContext message itself contains the details for that pre-check, such as the target database version for the upgrade and the results of the check (including any warnings or errors found). "kind": "A String", # Optional. This is always `sql#preCheckMajorVersionUpgradeContext`. + "maxRuntime": "A String", # Optional. The maximum allowed runtime for the precheck operation. "preCheckResponse": [ # Output only. The responses from the precheck operation. { # Structured PreCheckResponse containing message, type, and required actions. "actionsRequired": [ # The actions that the user needs to take. Use repeated for multiple actions. @@ -823,6 +825,7 @@

Method Details

"operationType": "A String", # The type of the operation. Valid values are: * `CREATE` * `DELETE` * `UPDATE` * `RESTART` * `IMPORT` * `EXPORT` * `BACKUP_VOLUME` * `RESTORE_VOLUME` * `CREATE_USER` * `DELETE_USER` * `CREATE_DATABASE` * `DELETE_DATABASE` "preCheckMajorVersionUpgradeContext": { # Pre-check major version upgrade context. # The context for pre-check major version upgrade operation, if applicable. This field is only populated when the operation_type is PRE_CHECK_MAJOR_VERSION_UPGRADE. The PreCheckMajorVersionUpgradeContext message itself contains the details for that pre-check, such as the target database version for the upgrade and the results of the check (including any warnings or errors found). "kind": "A String", # Optional. This is always `sql#preCheckMajorVersionUpgradeContext`. + "maxRuntime": "A String", # Optional. The maximum allowed runtime for the precheck operation. "preCheckResponse": [ # Output only. The responses from the precheck operation. { # Structured PreCheckResponse containing message, type, and required actions. "actionsRequired": [ # The actions that the user needs to take. Use repeated for multiple actions. @@ -1003,6 +1006,7 @@

Method Details

"operationType": "A String", # The type of the operation. Valid values are: * `CREATE` * `DELETE` * `UPDATE` * `RESTART` * `IMPORT` * `EXPORT` * `BACKUP_VOLUME` * `RESTORE_VOLUME` * `CREATE_USER` * `DELETE_USER` * `CREATE_DATABASE` * `DELETE_DATABASE` "preCheckMajorVersionUpgradeContext": { # Pre-check major version upgrade context. # The context for pre-check major version upgrade operation, if applicable. This field is only populated when the operation_type is PRE_CHECK_MAJOR_VERSION_UPGRADE. The PreCheckMajorVersionUpgradeContext message itself contains the details for that pre-check, such as the target database version for the upgrade and the results of the check (including any warnings or errors found). "kind": "A String", # Optional. This is always `sql#preCheckMajorVersionUpgradeContext`. + "maxRuntime": "A String", # Optional. The maximum allowed runtime for the precheck operation. "preCheckResponse": [ # Output only. The responses from the precheck operation. { # Structured PreCheckResponse containing message, type, and required actions. "actionsRequired": [ # The actions that the user needs to take. Use repeated for multiple actions. @@ -1183,6 +1187,7 @@

Method Details

"operationType": "A String", # The type of the operation. Valid values are: * `CREATE` * `DELETE` * `UPDATE` * `RESTART` * `IMPORT` * `EXPORT` * `BACKUP_VOLUME` * `RESTORE_VOLUME` * `CREATE_USER` * `DELETE_USER` * `CREATE_DATABASE` * `DELETE_DATABASE` "preCheckMajorVersionUpgradeContext": { # Pre-check major version upgrade context. # The context for pre-check major version upgrade operation, if applicable. This field is only populated when the operation_type is PRE_CHECK_MAJOR_VERSION_UPGRADE. The PreCheckMajorVersionUpgradeContext message itself contains the details for that pre-check, such as the target database version for the upgrade and the results of the check (including any warnings or errors found). "kind": "A String", # Optional. This is always `sql#preCheckMajorVersionUpgradeContext`. + "maxRuntime": "A String", # Optional. The maximum allowed runtime for the precheck operation. "preCheckResponse": [ # Output only. The responses from the precheck operation. { # Structured PreCheckResponse containing message, type, and required actions. "actionsRequired": [ # The actions that the user needs to take. Use repeated for multiple actions. @@ -1389,6 +1394,7 @@

Method Details

"operationType": "A String", # The type of the operation. Valid values are: * `CREATE` * `DELETE` * `UPDATE` * `RESTART` * `IMPORT` * `EXPORT` * `BACKUP_VOLUME` * `RESTORE_VOLUME` * `CREATE_USER` * `DELETE_USER` * `CREATE_DATABASE` * `DELETE_DATABASE` "preCheckMajorVersionUpgradeContext": { # Pre-check major version upgrade context. # The context for pre-check major version upgrade operation, if applicable. This field is only populated when the operation_type is PRE_CHECK_MAJOR_VERSION_UPGRADE. The PreCheckMajorVersionUpgradeContext message itself contains the details for that pre-check, such as the target database version for the upgrade and the results of the check (including any warnings or errors found). "kind": "A String", # Optional. This is always `sql#preCheckMajorVersionUpgradeContext`. + "maxRuntime": "A String", # Optional. The maximum allowed runtime for the precheck operation. "preCheckResponse": [ # Output only. The responses from the precheck operation. { # Structured PreCheckResponse containing message, type, and required actions. "actionsRequired": [ # The actions that the user needs to take. Use repeated for multiple actions. @@ -1578,6 +1584,7 @@

Method Details

"operationType": "A String", # The type of the operation. Valid values are: * `CREATE` * `DELETE` * `UPDATE` * `RESTART` * `IMPORT` * `EXPORT` * `BACKUP_VOLUME` * `RESTORE_VOLUME` * `CREATE_USER` * `DELETE_USER` * `CREATE_DATABASE` * `DELETE_DATABASE` "preCheckMajorVersionUpgradeContext": { # Pre-check major version upgrade context. # The context for pre-check major version upgrade operation, if applicable. This field is only populated when the operation_type is PRE_CHECK_MAJOR_VERSION_UPGRADE. The PreCheckMajorVersionUpgradeContext message itself contains the details for that pre-check, such as the target database version for the upgrade and the results of the check (including any warnings or errors found). "kind": "A String", # Optional. This is always `sql#preCheckMajorVersionUpgradeContext`. + "maxRuntime": "A String", # Optional. The maximum allowed runtime for the precheck operation. "preCheckResponse": [ # Output only. The responses from the precheck operation. { # Structured PreCheckResponse containing message, type, and required actions. "actionsRequired": [ # The actions that the user needs to take. Use repeated for multiple actions. @@ -1768,6 +1775,7 @@

Method Details

"operationType": "A String", # The type of the operation. Valid values are: * `CREATE` * `DELETE` * `UPDATE` * `RESTART` * `IMPORT` * `EXPORT` * `BACKUP_VOLUME` * `RESTORE_VOLUME` * `CREATE_USER` * `DELETE_USER` * `CREATE_DATABASE` * `DELETE_DATABASE` "preCheckMajorVersionUpgradeContext": { # Pre-check major version upgrade context. # The context for pre-check major version upgrade operation, if applicable. This field is only populated when the operation_type is PRE_CHECK_MAJOR_VERSION_UPGRADE. The PreCheckMajorVersionUpgradeContext message itself contains the details for that pre-check, such as the target database version for the upgrade and the results of the check (including any warnings or errors found). "kind": "A String", # Optional. This is always `sql#preCheckMajorVersionUpgradeContext`. + "maxRuntime": "A String", # Optional. The maximum allowed runtime for the precheck operation. "preCheckResponse": [ # Output only. The responses from the precheck operation. { # Structured PreCheckResponse containing message, type, and required actions. "actionsRequired": [ # The actions that the user needs to take. Use repeated for multiple actions. @@ -1971,6 +1979,7 @@

Method Details

"operationType": "A String", # The type of the operation. Valid values are: * `CREATE` * `DELETE` * `UPDATE` * `RESTART` * `IMPORT` * `EXPORT` * `BACKUP_VOLUME` * `RESTORE_VOLUME` * `CREATE_USER` * `DELETE_USER` * `CREATE_DATABASE` * `DELETE_DATABASE` "preCheckMajorVersionUpgradeContext": { # Pre-check major version upgrade context. # The context for pre-check major version upgrade operation, if applicable. This field is only populated when the operation_type is PRE_CHECK_MAJOR_VERSION_UPGRADE. The PreCheckMajorVersionUpgradeContext message itself contains the details for that pre-check, such as the target database version for the upgrade and the results of the check (including any warnings or errors found). "kind": "A String", # Optional. This is always `sql#preCheckMajorVersionUpgradeContext`. + "maxRuntime": "A String", # Optional. The maximum allowed runtime for the precheck operation. "preCheckResponse": [ # Output only. The responses from the precheck operation. { # Structured PreCheckResponse containing message, type, and required actions. "actionsRequired": [ # The actions that the user needs to take. Use repeated for multiple actions. @@ -2023,7 +2032,7 @@

Method Details

{ # The request payload used to execute SQL statements. "application": "A String", # Optional. Specifies the name of the application that is making the request. This field is used for telemetry. Only alphanumeric characters, dashes, and underscores are allowed. The maximum length is 32 characters. "autoIamAuthn": True or False, # Optional. When set to true, the API caller identity associated with the request is used for database authentication. The API caller must be an IAM user in the database. - "database": "A String", # Optional. Name of the database on which the statement will be executed. + "database": "A String", # Optional. Name of the database on which the statement will be executed. For Postgres and SQL Server it's required, for MySQL it's optional. "partialResultMode": "A String", # Optional. Controls how the API should respond when the SQL execution result is incomplete due to the size limit or another error. The default mode is to throw an error. "passwordSecretVersion": "A String", # Optional. The resource name of the Secret Manager secret holding the password for the user to log into the database. The secret should be created using the regional endpoint (for API) or from the Regional Secrets page (for UI), and stored in the same region as the Cloud SQL instance. The expected resource name format is `projects/{project}/locations/{location}/secrets/{secret}/versions/{secret_version}`. This field is used together with the `user` field. The secret resource name will not be stored. "rowLimit": "A String", # Optional. The maximum number of rows returned per SQL statement. @@ -2286,6 +2295,7 @@

Method Details

"operationType": "A String", # The type of the operation. Valid values are: * `CREATE` * `DELETE` * `UPDATE` * `RESTART` * `IMPORT` * `EXPORT` * `BACKUP_VOLUME` * `RESTORE_VOLUME` * `CREATE_USER` * `DELETE_USER` * `CREATE_DATABASE` * `DELETE_DATABASE` "preCheckMajorVersionUpgradeContext": { # Pre-check major version upgrade context. # The context for pre-check major version upgrade operation, if applicable. This field is only populated when the operation_type is PRE_CHECK_MAJOR_VERSION_UPGRADE. The PreCheckMajorVersionUpgradeContext message itself contains the details for that pre-check, such as the target database version for the upgrade and the results of the check (including any warnings or errors found). "kind": "A String", # Optional. This is always `sql#preCheckMajorVersionUpgradeContext`. + "maxRuntime": "A String", # Optional. The maximum allowed runtime for the precheck operation. "preCheckResponse": [ # Output only. The responses from the precheck operation. { # Structured PreCheckResponse containing message, type, and required actions. "actionsRequired": [ # The actions that the user needs to take. Use repeated for multiple actions. @@ -2476,6 +2486,7 @@

Method Details

"operationType": "A String", # The type of the operation. Valid values are: * `CREATE` * `DELETE` * `UPDATE` * `RESTART` * `IMPORT` * `EXPORT` * `BACKUP_VOLUME` * `RESTORE_VOLUME` * `CREATE_USER` * `DELETE_USER` * `CREATE_DATABASE` * `DELETE_DATABASE` "preCheckMajorVersionUpgradeContext": { # Pre-check major version upgrade context. # The context for pre-check major version upgrade operation, if applicable. This field is only populated when the operation_type is PRE_CHECK_MAJOR_VERSION_UPGRADE. The PreCheckMajorVersionUpgradeContext message itself contains the details for that pre-check, such as the target database version for the upgrade and the results of the check (including any warnings or errors found). "kind": "A String", # Optional. This is always `sql#preCheckMajorVersionUpgradeContext`. + "maxRuntime": "A String", # Optional. The maximum allowed runtime for the precheck operation. "preCheckResponse": [ # Output only. The responses from the precheck operation. { # Structured PreCheckResponse containing message, type, and required actions. "actionsRequired": [ # The actions that the user needs to take. Use repeated for multiple actions. @@ -2539,6 +2550,7 @@

Method Details

"connectionName": "A String", # Connection name of the Cloud SQL instance used in connection strings. "createTime": "A String", # Output only. The time when the instance was created in [RFC 3339](https://tools.ietf.org/html/rfc3339) format, for example `2012-11-15T16:19:00.094Z`. "currentDiskSize": "A String", # The current disk usage of the instance in bytes. This property has been deprecated. Use the "cloudsql.googleapis.com/database/disk/bytes_used" metric in Cloud Monitoring API instead. Please see [this announcement](https://groups.google.com/d/msg/google-cloud-sql-announce/I_7-F9EBhT0/BtvFtdFeAgAJ) for details. + "databaseCenterIntegration": "A String", # Optional. State of the Database Center integration for this instance. When unspecified, Database Center integration is enabled by default. "databaseCenterIntegrationEnabled": True or False, # Optional. If true, instance metadata is sent to the Database Center. If false, instance metadata is not sent to the Database Center. "databaseInstalledVersion": "A String", # Output only. Stores the current database version running on the instance including minor version such as `MYSQL_8_0_18`. "databaseVersion": "A String", # The database engine type and version. The `databaseVersion` field cannot be changed after instance creation. @@ -2936,6 +2948,7 @@

Method Details

"a_key": "A String", }, }, + "skipPrecheck": True or False, # Optional. Input only. Determines whether the precheck step is skipped during a major version upgrade. "sqlNetworkArchitecture": "A String", # The SQL network architecture for the instance. "state": "A String", # The current serving state of the Cloud SQL instance. "suspensionReason": [ # If the instance state is SUSPENDED, the reason for the suspension. @@ -3148,6 +3161,7 @@

Method Details

"operationType": "A String", # The type of the operation. Valid values are: * `CREATE` * `DELETE` * `UPDATE` * `RESTART` * `IMPORT` * `EXPORT` * `BACKUP_VOLUME` * `RESTORE_VOLUME` * `CREATE_USER` * `DELETE_USER` * `CREATE_DATABASE` * `DELETE_DATABASE` "preCheckMajorVersionUpgradeContext": { # Pre-check major version upgrade context. # The context for pre-check major version upgrade operation, if applicable. This field is only populated when the operation_type is PRE_CHECK_MAJOR_VERSION_UPGRADE. The PreCheckMajorVersionUpgradeContext message itself contains the details for that pre-check, such as the target database version for the upgrade and the results of the check (including any warnings or errors found). "kind": "A String", # Optional. This is always `sql#preCheckMajorVersionUpgradeContext`. + "maxRuntime": "A String", # Optional. The maximum allowed runtime for the precheck operation. "preCheckResponse": [ # Output only. The responses from the precheck operation. { # Structured PreCheckResponse containing message, type, and required actions. "actionsRequired": [ # The actions that the user needs to take. Use repeated for multiple actions. @@ -3204,6 +3218,7 @@

Method Details

"connectionName": "A String", # Connection name of the Cloud SQL instance used in connection strings. "createTime": "A String", # Output only. The time when the instance was created in [RFC 3339](https://tools.ietf.org/html/rfc3339) format, for example `2012-11-15T16:19:00.094Z`. "currentDiskSize": "A String", # The current disk usage of the instance in bytes. This property has been deprecated. Use the "cloudsql.googleapis.com/database/disk/bytes_used" metric in Cloud Monitoring API instead. Please see [this announcement](https://groups.google.com/d/msg/google-cloud-sql-announce/I_7-F9EBhT0/BtvFtdFeAgAJ) for details. + "databaseCenterIntegration": "A String", # Optional. State of the Database Center integration for this instance. When unspecified, Database Center integration is enabled by default. "databaseCenterIntegrationEnabled": True or False, # Optional. If true, instance metadata is sent to the Database Center. If false, instance metadata is not sent to the Database Center. "databaseInstalledVersion": "A String", # Output only. Stores the current database version running on the instance including minor version such as `MYSQL_8_0_18`. "databaseVersion": "A String", # The database engine type and version. The `databaseVersion` field cannot be changed after instance creation. @@ -3601,6 +3616,7 @@

Method Details

"a_key": "A String", }, }, + "skipPrecheck": True or False, # Optional. Input only. Determines whether the precheck step is skipped during a major version upgrade. "sqlNetworkArchitecture": "A String", # The SQL network architecture for the instance. "state": "A String", # The current serving state of the Cloud SQL instance. "suspensionReason": [ # If the instance state is SUSPENDED, the reason for the suspension. @@ -3754,6 +3770,7 @@

Method Details

"operationType": "A String", # The type of the operation. Valid values are: * `CREATE` * `DELETE` * `UPDATE` * `RESTART` * `IMPORT` * `EXPORT` * `BACKUP_VOLUME` * `RESTORE_VOLUME` * `CREATE_USER` * `DELETE_USER` * `CREATE_DATABASE` * `DELETE_DATABASE` "preCheckMajorVersionUpgradeContext": { # Pre-check major version upgrade context. # The context for pre-check major version upgrade operation, if applicable. This field is only populated when the operation_type is PRE_CHECK_MAJOR_VERSION_UPGRADE. The PreCheckMajorVersionUpgradeContext message itself contains the details for that pre-check, such as the target database version for the upgrade and the results of the check (including any warnings or errors found). "kind": "A String", # Optional. This is always `sql#preCheckMajorVersionUpgradeContext`. + "maxRuntime": "A String", # Optional. The maximum allowed runtime for the precheck operation. "preCheckResponse": [ # Output only. The responses from the precheck operation. { # Structured PreCheckResponse containing message, type, and required actions. "actionsRequired": [ # The actions that the user needs to take. Use repeated for multiple actions. @@ -3821,6 +3838,7 @@

Method Details

"connectionName": "A String", # Connection name of the Cloud SQL instance used in connection strings. "createTime": "A String", # Output only. The time when the instance was created in [RFC 3339](https://tools.ietf.org/html/rfc3339) format, for example `2012-11-15T16:19:00.094Z`. "currentDiskSize": "A String", # The current disk usage of the instance in bytes. This property has been deprecated. Use the "cloudsql.googleapis.com/database/disk/bytes_used" metric in Cloud Monitoring API instead. Please see [this announcement](https://groups.google.com/d/msg/google-cloud-sql-announce/I_7-F9EBhT0/BtvFtdFeAgAJ) for details. + "databaseCenterIntegration": "A String", # Optional. State of the Database Center integration for this instance. When unspecified, Database Center integration is enabled by default. "databaseCenterIntegrationEnabled": True or False, # Optional. If true, instance metadata is sent to the Database Center. If false, instance metadata is not sent to the Database Center. "databaseInstalledVersion": "A String", # Output only. Stores the current database version running on the instance including minor version such as `MYSQL_8_0_18`. "databaseVersion": "A String", # The database engine type and version. The `databaseVersion` field cannot be changed after instance creation. @@ -4218,6 +4236,7 @@

Method Details

"a_key": "A String", }, }, + "skipPrecheck": True or False, # Optional. Input only. Determines whether the precheck step is skipped during a major version upgrade. "sqlNetworkArchitecture": "A String", # The SQL network architecture for the instance. "state": "A String", # The current serving state of the Cloud SQL instance. "suspensionReason": [ # If the instance state is SUSPENDED, the reason for the suspension. @@ -4316,6 +4335,7 @@

Method Details

"connectionName": "A String", # Connection name of the Cloud SQL instance used in connection strings. "createTime": "A String", # Output only. The time when the instance was created in [RFC 3339](https://tools.ietf.org/html/rfc3339) format, for example `2012-11-15T16:19:00.094Z`. "currentDiskSize": "A String", # The current disk usage of the instance in bytes. This property has been deprecated. Use the "cloudsql.googleapis.com/database/disk/bytes_used" metric in Cloud Monitoring API instead. Please see [this announcement](https://groups.google.com/d/msg/google-cloud-sql-announce/I_7-F9EBhT0/BtvFtdFeAgAJ) for details. + "databaseCenterIntegration": "A String", # Optional. State of the Database Center integration for this instance. When unspecified, Database Center integration is enabled by default. "databaseCenterIntegrationEnabled": True or False, # Optional. If true, instance metadata is sent to the Database Center. If false, instance metadata is not sent to the Database Center. "databaseInstalledVersion": "A String", # Output only. Stores the current database version running on the instance including minor version such as `MYSQL_8_0_18`. "databaseVersion": "A String", # The database engine type and version. The `databaseVersion` field cannot be changed after instance creation. @@ -4713,6 +4733,7 @@

Method Details

"a_key": "A String", }, }, + "skipPrecheck": True or False, # Optional. Input only. Determines whether the precheck step is skipped during a major version upgrade. "sqlNetworkArchitecture": "A String", # The SQL network architecture for the instance. "state": "A String", # The current serving state of the Cloud SQL instance. "suspensionReason": [ # If the instance state is SUSPENDED, the reason for the suspension. @@ -4868,6 +4889,7 @@

Method Details

"operationType": "A String", # The type of the operation. Valid values are: * `CREATE` * `DELETE` * `UPDATE` * `RESTART` * `IMPORT` * `EXPORT` * `BACKUP_VOLUME` * `RESTORE_VOLUME` * `CREATE_USER` * `DELETE_USER` * `CREATE_DATABASE` * `DELETE_DATABASE` "preCheckMajorVersionUpgradeContext": { # Pre-check major version upgrade context. # The context for pre-check major version upgrade operation, if applicable. This field is only populated when the operation_type is PRE_CHECK_MAJOR_VERSION_UPGRADE. The PreCheckMajorVersionUpgradeContext message itself contains the details for that pre-check, such as the target database version for the upgrade and the results of the check (including any warnings or errors found). "kind": "A String", # Optional. This is always `sql#preCheckMajorVersionUpgradeContext`. + "maxRuntime": "A String", # Optional. The maximum allowed runtime for the precheck operation. "preCheckResponse": [ # Output only. The responses from the precheck operation. { # Structured PreCheckResponse containing message, type, and required actions. "actionsRequired": [ # The actions that the user needs to take. Use repeated for multiple actions. @@ -4936,6 +4958,7 @@

Method Details

"connectionName": "A String", # Connection name of the Cloud SQL instance used in connection strings. "createTime": "A String", # Output only. The time when the instance was created in [RFC 3339](https://tools.ietf.org/html/rfc3339) format, for example `2012-11-15T16:19:00.094Z`. "currentDiskSize": "A String", # The current disk usage of the instance in bytes. This property has been deprecated. Use the "cloudsql.googleapis.com/database/disk/bytes_used" metric in Cloud Monitoring API instead. Please see [this announcement](https://groups.google.com/d/msg/google-cloud-sql-announce/I_7-F9EBhT0/BtvFtdFeAgAJ) for details. + "databaseCenterIntegration": "A String", # Optional. State of the Database Center integration for this instance. When unspecified, Database Center integration is enabled by default. "databaseCenterIntegrationEnabled": True or False, # Optional. If true, instance metadata is sent to the Database Center. If false, instance metadata is not sent to the Database Center. "databaseInstalledVersion": "A String", # Output only. Stores the current database version running on the instance including minor version such as `MYSQL_8_0_18`. "databaseVersion": "A String", # The database engine type and version. The `databaseVersion` field cannot be changed after instance creation. @@ -5333,6 +5356,7 @@

Method Details

"a_key": "A String", }, }, + "skipPrecheck": True or False, # Optional. Input only. Determines whether the precheck step is skipped during a major version upgrade. "sqlNetworkArchitecture": "A String", # The SQL network architecture for the instance. "state": "A String", # The current serving state of the Cloud SQL instance. "suspensionReason": [ # If the instance state is SUSPENDED, the reason for the suspension. @@ -5486,6 +5510,7 @@

Method Details

"operationType": "A String", # The type of the operation. Valid values are: * `CREATE` * `DELETE` * `UPDATE` * `RESTART` * `IMPORT` * `EXPORT` * `BACKUP_VOLUME` * `RESTORE_VOLUME` * `CREATE_USER` * `DELETE_USER` * `CREATE_DATABASE` * `DELETE_DATABASE` "preCheckMajorVersionUpgradeContext": { # Pre-check major version upgrade context. # The context for pre-check major version upgrade operation, if applicable. This field is only populated when the operation_type is PRE_CHECK_MAJOR_VERSION_UPGRADE. The PreCheckMajorVersionUpgradeContext message itself contains the details for that pre-check, such as the target database version for the upgrade and the results of the check (including any warnings or errors found). "kind": "A String", # Optional. This is always `sql#preCheckMajorVersionUpgradeContext`. + "maxRuntime": "A String", # Optional. The maximum allowed runtime for the precheck operation. "preCheckResponse": [ # Output only. The responses from the precheck operation. { # Structured PreCheckResponse containing message, type, and required actions. "actionsRequired": [ # The actions that the user needs to take. Use repeated for multiple actions. @@ -5538,6 +5563,7 @@

Method Details

{ # Request for Pre-checks for MVU "preCheckMajorVersionUpgradeContext": { # Pre-check major version upgrade context. # Required. Contains details about the pre-check major version upgrade operation. "kind": "A String", # Optional. This is always `sql#preCheckMajorVersionUpgradeContext`. + "maxRuntime": "A String", # Optional. The maximum allowed runtime for the precheck operation. "preCheckResponse": [ # Output only. The responses from the precheck operation. { # Structured PreCheckResponse containing message, type, and required actions. "actionsRequired": [ # The actions that the user needs to take. Use repeated for multiple actions. @@ -5685,6 +5711,7 @@

Method Details

"operationType": "A String", # The type of the operation. Valid values are: * `CREATE` * `DELETE` * `UPDATE` * `RESTART` * `IMPORT` * `EXPORT` * `BACKUP_VOLUME` * `RESTORE_VOLUME` * `CREATE_USER` * `DELETE_USER` * `CREATE_DATABASE` * `DELETE_DATABASE` "preCheckMajorVersionUpgradeContext": { # Pre-check major version upgrade context. # The context for pre-check major version upgrade operation, if applicable. This field is only populated when the operation_type is PRE_CHECK_MAJOR_VERSION_UPGRADE. The PreCheckMajorVersionUpgradeContext message itself contains the details for that pre-check, such as the target database version for the upgrade and the results of the check (including any warnings or errors found). "kind": "A String", # Optional. This is always `sql#preCheckMajorVersionUpgradeContext`. + "maxRuntime": "A String", # Optional. The maximum allowed runtime for the precheck operation. "preCheckResponse": [ # Output only. The responses from the precheck operation. { # Structured PreCheckResponse containing message, type, and required actions. "actionsRequired": [ # The actions that the user needs to take. Use repeated for multiple actions. @@ -5866,6 +5893,7 @@

Method Details

"operationType": "A String", # The type of the operation. Valid values are: * `CREATE` * `DELETE` * `UPDATE` * `RESTART` * `IMPORT` * `EXPORT` * `BACKUP_VOLUME` * `RESTORE_VOLUME` * `CREATE_USER` * `DELETE_USER` * `CREATE_DATABASE` * `DELETE_DATABASE` "preCheckMajorVersionUpgradeContext": { # Pre-check major version upgrade context. # The context for pre-check major version upgrade operation, if applicable. This field is only populated when the operation_type is PRE_CHECK_MAJOR_VERSION_UPGRADE. The PreCheckMajorVersionUpgradeContext message itself contains the details for that pre-check, such as the target database version for the upgrade and the results of the check (including any warnings or errors found). "kind": "A String", # Optional. This is always `sql#preCheckMajorVersionUpgradeContext`. + "maxRuntime": "A String", # Optional. The maximum allowed runtime for the precheck operation. "preCheckResponse": [ # Output only. The responses from the precheck operation. { # Structured PreCheckResponse containing message, type, and required actions. "actionsRequired": [ # The actions that the user needs to take. Use repeated for multiple actions. @@ -6056,6 +6084,7 @@

Method Details

"operationType": "A String", # The type of the operation. Valid values are: * `CREATE` * `DELETE` * `UPDATE` * `RESTART` * `IMPORT` * `EXPORT` * `BACKUP_VOLUME` * `RESTORE_VOLUME` * `CREATE_USER` * `DELETE_USER` * `CREATE_DATABASE` * `DELETE_DATABASE` "preCheckMajorVersionUpgradeContext": { # Pre-check major version upgrade context. # The context for pre-check major version upgrade operation, if applicable. This field is only populated when the operation_type is PRE_CHECK_MAJOR_VERSION_UPGRADE. The PreCheckMajorVersionUpgradeContext message itself contains the details for that pre-check, such as the target database version for the upgrade and the results of the check (including any warnings or errors found). "kind": "A String", # Optional. This is always `sql#preCheckMajorVersionUpgradeContext`. + "maxRuntime": "A String", # Optional. The maximum allowed runtime for the precheck operation. "preCheckResponse": [ # Output only. The responses from the precheck operation. { # Structured PreCheckResponse containing message, type, and required actions. "actionsRequired": [ # The actions that the user needs to take. Use repeated for multiple actions. @@ -6262,6 +6291,7 @@

Method Details

"operationType": "A String", # The type of the operation. Valid values are: * `CREATE` * `DELETE` * `UPDATE` * `RESTART` * `IMPORT` * `EXPORT` * `BACKUP_VOLUME` * `RESTORE_VOLUME` * `CREATE_USER` * `DELETE_USER` * `CREATE_DATABASE` * `DELETE_DATABASE` "preCheckMajorVersionUpgradeContext": { # Pre-check major version upgrade context. # The context for pre-check major version upgrade operation, if applicable. This field is only populated when the operation_type is PRE_CHECK_MAJOR_VERSION_UPGRADE. The PreCheckMajorVersionUpgradeContext message itself contains the details for that pre-check, such as the target database version for the upgrade and the results of the check (including any warnings or errors found). "kind": "A String", # Optional. This is always `sql#preCheckMajorVersionUpgradeContext`. + "maxRuntime": "A String", # Optional. The maximum allowed runtime for the precheck operation. "preCheckResponse": [ # Output only. The responses from the precheck operation. { # Structured PreCheckResponse containing message, type, and required actions. "actionsRequired": [ # The actions that the user needs to take. Use repeated for multiple actions. @@ -6442,6 +6472,7 @@

Method Details

"operationType": "A String", # The type of the operation. Valid values are: * `CREATE` * `DELETE` * `UPDATE` * `RESTART` * `IMPORT` * `EXPORT` * `BACKUP_VOLUME` * `RESTORE_VOLUME` * `CREATE_USER` * `DELETE_USER` * `CREATE_DATABASE` * `DELETE_DATABASE` "preCheckMajorVersionUpgradeContext": { # Pre-check major version upgrade context. # The context for pre-check major version upgrade operation, if applicable. This field is only populated when the operation_type is PRE_CHECK_MAJOR_VERSION_UPGRADE. The PreCheckMajorVersionUpgradeContext message itself contains the details for that pre-check, such as the target database version for the upgrade and the results of the check (including any warnings or errors found). "kind": "A String", # Optional. This is always `sql#preCheckMajorVersionUpgradeContext`. + "maxRuntime": "A String", # Optional. The maximum allowed runtime for the precheck operation. "preCheckResponse": [ # Output only. The responses from the precheck operation. { # Structured PreCheckResponse containing message, type, and required actions. "actionsRequired": [ # The actions that the user needs to take. Use repeated for multiple actions. @@ -6512,6 +6543,7 @@

Method Details

"connectionName": "A String", # Connection name of the Cloud SQL instance used in connection strings. "createTime": "A String", # Output only. The time when the instance was created in [RFC 3339](https://tools.ietf.org/html/rfc3339) format, for example `2012-11-15T16:19:00.094Z`. "currentDiskSize": "A String", # The current disk usage of the instance in bytes. This property has been deprecated. Use the "cloudsql.googleapis.com/database/disk/bytes_used" metric in Cloud Monitoring API instead. Please see [this announcement](https://groups.google.com/d/msg/google-cloud-sql-announce/I_7-F9EBhT0/BtvFtdFeAgAJ) for details. + "databaseCenterIntegration": "A String", # Optional. State of the Database Center integration for this instance. When unspecified, Database Center integration is enabled by default. "databaseCenterIntegrationEnabled": True or False, # Optional. If true, instance metadata is sent to the Database Center. If false, instance metadata is not sent to the Database Center. "databaseInstalledVersion": "A String", # Output only. Stores the current database version running on the instance including minor version such as `MYSQL_8_0_18`. "databaseVersion": "A String", # The database engine type and version. The `databaseVersion` field cannot be changed after instance creation. @@ -6909,6 +6941,7 @@

Method Details

"a_key": "A String", }, }, + "skipPrecheck": True or False, # Optional. Input only. Determines whether the precheck step is skipped during a major version upgrade. "sqlNetworkArchitecture": "A String", # The SQL network architecture for the instance. "state": "A String", # The current serving state of the Cloud SQL instance. "suspensionReason": [ # If the instance state is SUSPENDED, the reason for the suspension. @@ -7063,6 +7096,7 @@

Method Details

"operationType": "A String", # The type of the operation. Valid values are: * `CREATE` * `DELETE` * `UPDATE` * `RESTART` * `IMPORT` * `EXPORT` * `BACKUP_VOLUME` * `RESTORE_VOLUME` * `CREATE_USER` * `DELETE_USER` * `CREATE_DATABASE` * `DELETE_DATABASE` "preCheckMajorVersionUpgradeContext": { # Pre-check major version upgrade context. # The context for pre-check major version upgrade operation, if applicable. This field is only populated when the operation_type is PRE_CHECK_MAJOR_VERSION_UPGRADE. The PreCheckMajorVersionUpgradeContext message itself contains the details for that pre-check, such as the target database version for the upgrade and the results of the check (including any warnings or errors found). "kind": "A String", # Optional. This is always `sql#preCheckMajorVersionUpgradeContext`. + "maxRuntime": "A String", # Optional. The maximum allowed runtime for the precheck operation. "preCheckResponse": [ # Output only. The responses from the precheck operation. { # Structured PreCheckResponse containing message, type, and required actions. "actionsRequired": [ # The actions that the user needs to take. Use repeated for multiple actions. @@ -7253,6 +7287,7 @@

Method Details

"operationType": "A String", # The type of the operation. Valid values are: * `CREATE` * `DELETE` * `UPDATE` * `RESTART` * `IMPORT` * `EXPORT` * `BACKUP_VOLUME` * `RESTORE_VOLUME` * `CREATE_USER` * `DELETE_USER` * `CREATE_DATABASE` * `DELETE_DATABASE` "preCheckMajorVersionUpgradeContext": { # Pre-check major version upgrade context. # The context for pre-check major version upgrade operation, if applicable. This field is only populated when the operation_type is PRE_CHECK_MAJOR_VERSION_UPGRADE. The PreCheckMajorVersionUpgradeContext message itself contains the details for that pre-check, such as the target database version for the upgrade and the results of the check (including any warnings or errors found). "kind": "A String", # Optional. This is always `sql#preCheckMajorVersionUpgradeContext`. + "maxRuntime": "A String", # Optional. The maximum allowed runtime for the precheck operation. "preCheckResponse": [ # Output only. The responses from the precheck operation. { # Structured PreCheckResponse containing message, type, and required actions. "actionsRequired": [ # The actions that the user needs to take. Use repeated for multiple actions. @@ -7433,6 +7468,7 @@

Method Details

"operationType": "A String", # The type of the operation. Valid values are: * `CREATE` * `DELETE` * `UPDATE` * `RESTART` * `IMPORT` * `EXPORT` * `BACKUP_VOLUME` * `RESTORE_VOLUME` * `CREATE_USER` * `DELETE_USER` * `CREATE_DATABASE` * `DELETE_DATABASE` "preCheckMajorVersionUpgradeContext": { # Pre-check major version upgrade context. # The context for pre-check major version upgrade operation, if applicable. This field is only populated when the operation_type is PRE_CHECK_MAJOR_VERSION_UPGRADE. The PreCheckMajorVersionUpgradeContext message itself contains the details for that pre-check, such as the target database version for the upgrade and the results of the check (including any warnings or errors found). "kind": "A String", # Optional. This is always `sql#preCheckMajorVersionUpgradeContext`. + "maxRuntime": "A String", # Optional. The maximum allowed runtime for the precheck operation. "preCheckResponse": [ # Output only. The responses from the precheck operation. { # Structured PreCheckResponse containing message, type, and required actions. "actionsRequired": [ # The actions that the user needs to take. Use repeated for multiple actions. @@ -7613,6 +7649,7 @@

Method Details

"operationType": "A String", # The type of the operation. Valid values are: * `CREATE` * `DELETE` * `UPDATE` * `RESTART` * `IMPORT` * `EXPORT` * `BACKUP_VOLUME` * `RESTORE_VOLUME` * `CREATE_USER` * `DELETE_USER` * `CREATE_DATABASE` * `DELETE_DATABASE` "preCheckMajorVersionUpgradeContext": { # Pre-check major version upgrade context. # The context for pre-check major version upgrade operation, if applicable. This field is only populated when the operation_type is PRE_CHECK_MAJOR_VERSION_UPGRADE. The PreCheckMajorVersionUpgradeContext message itself contains the details for that pre-check, such as the target database version for the upgrade and the results of the check (including any warnings or errors found). "kind": "A String", # Optional. This is always `sql#preCheckMajorVersionUpgradeContext`. + "maxRuntime": "A String", # Optional. The maximum allowed runtime for the precheck operation. "preCheckResponse": [ # Output only. The responses from the precheck operation. { # Structured PreCheckResponse containing message, type, and required actions. "actionsRequired": [ # The actions that the user needs to take. Use repeated for multiple actions. @@ -7794,6 +7831,7 @@

Method Details

"operationType": "A String", # The type of the operation. Valid values are: * `CREATE` * `DELETE` * `UPDATE` * `RESTART` * `IMPORT` * `EXPORT` * `BACKUP_VOLUME` * `RESTORE_VOLUME` * `CREATE_USER` * `DELETE_USER` * `CREATE_DATABASE` * `DELETE_DATABASE` "preCheckMajorVersionUpgradeContext": { # Pre-check major version upgrade context. # The context for pre-check major version upgrade operation, if applicable. This field is only populated when the operation_type is PRE_CHECK_MAJOR_VERSION_UPGRADE. The PreCheckMajorVersionUpgradeContext message itself contains the details for that pre-check, such as the target database version for the upgrade and the results of the check (including any warnings or errors found). "kind": "A String", # Optional. This is always `sql#preCheckMajorVersionUpgradeContext`. + "maxRuntime": "A String", # Optional. The maximum allowed runtime for the precheck operation. "preCheckResponse": [ # Output only. The responses from the precheck operation. { # Structured PreCheckResponse containing message, type, and required actions. "actionsRequired": [ # The actions that the user needs to take. Use repeated for multiple actions. @@ -7984,6 +8022,7 @@

Method Details

"operationType": "A String", # The type of the operation. Valid values are: * `CREATE` * `DELETE` * `UPDATE` * `RESTART` * `IMPORT` * `EXPORT` * `BACKUP_VOLUME` * `RESTORE_VOLUME` * `CREATE_USER` * `DELETE_USER` * `CREATE_DATABASE` * `DELETE_DATABASE` "preCheckMajorVersionUpgradeContext": { # Pre-check major version upgrade context. # The context for pre-check major version upgrade operation, if applicable. This field is only populated when the operation_type is PRE_CHECK_MAJOR_VERSION_UPGRADE. The PreCheckMajorVersionUpgradeContext message itself contains the details for that pre-check, such as the target database version for the upgrade and the results of the check (including any warnings or errors found). "kind": "A String", # Optional. This is always `sql#preCheckMajorVersionUpgradeContext`. + "maxRuntime": "A String", # Optional. The maximum allowed runtime for the precheck operation. "preCheckResponse": [ # Output only. The responses from the precheck operation. { # Structured PreCheckResponse containing message, type, and required actions. "actionsRequired": [ # The actions that the user needs to take. Use repeated for multiple actions. @@ -8041,6 +8080,7 @@

Method Details

"connectionName": "A String", # Connection name of the Cloud SQL instance used in connection strings. "createTime": "A String", # Output only. The time when the instance was created in [RFC 3339](https://tools.ietf.org/html/rfc3339) format, for example `2012-11-15T16:19:00.094Z`. "currentDiskSize": "A String", # The current disk usage of the instance in bytes. This property has been deprecated. Use the "cloudsql.googleapis.com/database/disk/bytes_used" metric in Cloud Monitoring API instead. Please see [this announcement](https://groups.google.com/d/msg/google-cloud-sql-announce/I_7-F9EBhT0/BtvFtdFeAgAJ) for details. + "databaseCenterIntegration": "A String", # Optional. State of the Database Center integration for this instance. When unspecified, Database Center integration is enabled by default. "databaseCenterIntegrationEnabled": True or False, # Optional. If true, instance metadata is sent to the Database Center. If false, instance metadata is not sent to the Database Center. "databaseInstalledVersion": "A String", # Output only. Stores the current database version running on the instance including minor version such as `MYSQL_8_0_18`. "databaseVersion": "A String", # The database engine type and version. The `databaseVersion` field cannot be changed after instance creation. @@ -8438,6 +8478,7 @@

Method Details

"a_key": "A String", }, }, + "skipPrecheck": True or False, # Optional. Input only. Determines whether the precheck step is skipped during a major version upgrade. "sqlNetworkArchitecture": "A String", # The SQL network architecture for the instance. "state": "A String", # The current serving state of the Cloud SQL instance. "suspensionReason": [ # If the instance state is SUSPENDED, the reason for the suspension. @@ -8591,6 +8632,7 @@

Method Details

"operationType": "A String", # The type of the operation. Valid values are: * `CREATE` * `DELETE` * `UPDATE` * `RESTART` * `IMPORT` * `EXPORT` * `BACKUP_VOLUME` * `RESTORE_VOLUME` * `CREATE_USER` * `DELETE_USER` * `CREATE_DATABASE` * `DELETE_DATABASE` "preCheckMajorVersionUpgradeContext": { # Pre-check major version upgrade context. # The context for pre-check major version upgrade operation, if applicable. This field is only populated when the operation_type is PRE_CHECK_MAJOR_VERSION_UPGRADE. The PreCheckMajorVersionUpgradeContext message itself contains the details for that pre-check, such as the target database version for the upgrade and the results of the check (including any warnings or errors found). "kind": "A String", # Optional. This is always `sql#preCheckMajorVersionUpgradeContext`. + "maxRuntime": "A String", # Optional. The maximum allowed runtime for the precheck operation. "preCheckResponse": [ # Output only. The responses from the precheck operation. { # Structured PreCheckResponse containing message, type, and required actions. "actionsRequired": [ # The actions that the user needs to take. Use repeated for multiple actions. diff --git a/docs/dyn/sqladmin_v1beta4.operations.html b/docs/dyn/sqladmin_v1beta4.operations.html index 8bf6be6391..d5b1853d90 100644 --- a/docs/dyn/sqladmin_v1beta4.operations.html +++ b/docs/dyn/sqladmin_v1beta4.operations.html @@ -256,6 +256,7 @@

Method Details

"operationType": "A String", # The type of the operation. Valid values are: * `CREATE` * `DELETE` * `UPDATE` * `RESTART` * `IMPORT` * `EXPORT` * `BACKUP_VOLUME` * `RESTORE_VOLUME` * `CREATE_USER` * `DELETE_USER` * `CREATE_DATABASE` * `DELETE_DATABASE` "preCheckMajorVersionUpgradeContext": { # Pre-check major version upgrade context. # The context for pre-check major version upgrade operation, if applicable. This field is only populated when the operation_type is PRE_CHECK_MAJOR_VERSION_UPGRADE. The PreCheckMajorVersionUpgradeContext message itself contains the details for that pre-check, such as the target database version for the upgrade and the results of the check (including any warnings or errors found). "kind": "A String", # Optional. This is always `sql#preCheckMajorVersionUpgradeContext`. + "maxRuntime": "A String", # Optional. The maximum allowed runtime for the precheck operation. "preCheckResponse": [ # Output only. The responses from the precheck operation. { # Structured PreCheckResponse containing message, type, and required actions. "actionsRequired": [ # The actions that the user needs to take. Use repeated for multiple actions. @@ -440,6 +441,7 @@

Method Details

"operationType": "A String", # The type of the operation. Valid values are: * `CREATE` * `DELETE` * `UPDATE` * `RESTART` * `IMPORT` * `EXPORT` * `BACKUP_VOLUME` * `RESTORE_VOLUME` * `CREATE_USER` * `DELETE_USER` * `CREATE_DATABASE` * `DELETE_DATABASE` "preCheckMajorVersionUpgradeContext": { # Pre-check major version upgrade context. # The context for pre-check major version upgrade operation, if applicable. This field is only populated when the operation_type is PRE_CHECK_MAJOR_VERSION_UPGRADE. The PreCheckMajorVersionUpgradeContext message itself contains the details for that pre-check, such as the target database version for the upgrade and the results of the check (including any warnings or errors found). "kind": "A String", # Optional. This is always `sql#preCheckMajorVersionUpgradeContext`. + "maxRuntime": "A String", # Optional. The maximum allowed runtime for the precheck operation. "preCheckResponse": [ # Output only. The responses from the precheck operation. { # Structured PreCheckResponse containing message, type, and required actions. "actionsRequired": [ # The actions that the user needs to take. Use repeated for multiple actions. diff --git a/docs/dyn/sqladmin_v1beta4.projects.instances.html b/docs/dyn/sqladmin_v1beta4.projects.instances.html index 56b4dc7048..0bc86ced6d 100644 --- a/docs/dyn/sqladmin_v1beta4.projects.instances.html +++ b/docs/dyn/sqladmin_v1beta4.projects.instances.html @@ -299,6 +299,7 @@

Method Details

"operationType": "A String", # The type of the operation. Valid values are: * `CREATE` * `DELETE` * `UPDATE` * `RESTART` * `IMPORT` * `EXPORT` * `BACKUP_VOLUME` * `RESTORE_VOLUME` * `CREATE_USER` * `DELETE_USER` * `CREATE_DATABASE` * `DELETE_DATABASE` "preCheckMajorVersionUpgradeContext": { # Pre-check major version upgrade context. # The context for pre-check major version upgrade operation, if applicable. This field is only populated when the operation_type is PRE_CHECK_MAJOR_VERSION_UPGRADE. The PreCheckMajorVersionUpgradeContext message itself contains the details for that pre-check, such as the target database version for the upgrade and the results of the check (including any warnings or errors found). "kind": "A String", # Optional. This is always `sql#preCheckMajorVersionUpgradeContext`. + "maxRuntime": "A String", # Optional. The maximum allowed runtime for the precheck operation. "preCheckResponse": [ # Output only. The responses from the precheck operation. { # Structured PreCheckResponse containing message, type, and required actions. "actionsRequired": [ # The actions that the user needs to take. Use repeated for multiple actions. @@ -489,6 +490,7 @@

Method Details

"operationType": "A String", # The type of the operation. Valid values are: * `CREATE` * `DELETE` * `UPDATE` * `RESTART` * `IMPORT` * `EXPORT` * `BACKUP_VOLUME` * `RESTORE_VOLUME` * `CREATE_USER` * `DELETE_USER` * `CREATE_DATABASE` * `DELETE_DATABASE` "preCheckMajorVersionUpgradeContext": { # Pre-check major version upgrade context. # The context for pre-check major version upgrade operation, if applicable. This field is only populated when the operation_type is PRE_CHECK_MAJOR_VERSION_UPGRADE. The PreCheckMajorVersionUpgradeContext message itself contains the details for that pre-check, such as the target database version for the upgrade and the results of the check (including any warnings or errors found). "kind": "A String", # Optional. This is always `sql#preCheckMajorVersionUpgradeContext`. + "maxRuntime": "A String", # Optional. The maximum allowed runtime for the precheck operation. "preCheckResponse": [ # Output only. The responses from the precheck operation. { # Structured PreCheckResponse containing message, type, and required actions. "actionsRequired": [ # The actions that the user needs to take. Use repeated for multiple actions. @@ -675,6 +677,7 @@

Method Details

"operationType": "A String", # The type of the operation. Valid values are: * `CREATE` * `DELETE` * `UPDATE` * `RESTART` * `IMPORT` * `EXPORT` * `BACKUP_VOLUME` * `RESTORE_VOLUME` * `CREATE_USER` * `DELETE_USER` * `CREATE_DATABASE` * `DELETE_DATABASE` "preCheckMajorVersionUpgradeContext": { # Pre-check major version upgrade context. # The context for pre-check major version upgrade operation, if applicable. This field is only populated when the operation_type is PRE_CHECK_MAJOR_VERSION_UPGRADE. The PreCheckMajorVersionUpgradeContext message itself contains the details for that pre-check, such as the target database version for the upgrade and the results of the check (including any warnings or errors found). "kind": "A String", # Optional. This is always `sql#preCheckMajorVersionUpgradeContext`. + "maxRuntime": "A String", # Optional. The maximum allowed runtime for the precheck operation. "preCheckResponse": [ # Output only. The responses from the precheck operation. { # Structured PreCheckResponse containing message, type, and required actions. "actionsRequired": [ # The actions that the user needs to take. Use repeated for multiple actions. @@ -874,6 +877,7 @@

Method Details

"operationType": "A String", # The type of the operation. Valid values are: * `CREATE` * `DELETE` * `UPDATE` * `RESTART` * `IMPORT` * `EXPORT` * `BACKUP_VOLUME` * `RESTORE_VOLUME` * `CREATE_USER` * `DELETE_USER` * `CREATE_DATABASE` * `DELETE_DATABASE` "preCheckMajorVersionUpgradeContext": { # Pre-check major version upgrade context. # The context for pre-check major version upgrade operation, if applicable. This field is only populated when the operation_type is PRE_CHECK_MAJOR_VERSION_UPGRADE. The PreCheckMajorVersionUpgradeContext message itself contains the details for that pre-check, such as the target database version for the upgrade and the results of the check (including any warnings or errors found). "kind": "A String", # Optional. This is always `sql#preCheckMajorVersionUpgradeContext`. + "maxRuntime": "A String", # Optional. The maximum allowed runtime for the precheck operation. "preCheckResponse": [ # Output only. The responses from the precheck operation. { # Structured PreCheckResponse containing message, type, and required actions. "actionsRequired": [ # The actions that the user needs to take. Use repeated for multiple actions. diff --git a/docs/dyn/sqladmin_v1beta4.sslCerts.html b/docs/dyn/sqladmin_v1beta4.sslCerts.html index c45a0b06f1..c78ed67188 100644 --- a/docs/dyn/sqladmin_v1beta4.sslCerts.html +++ b/docs/dyn/sqladmin_v1beta4.sslCerts.html @@ -276,6 +276,7 @@

Method Details

"operationType": "A String", # The type of the operation. Valid values are: * `CREATE` * `DELETE` * `UPDATE` * `RESTART` * `IMPORT` * `EXPORT` * `BACKUP_VOLUME` * `RESTORE_VOLUME` * `CREATE_USER` * `DELETE_USER` * `CREATE_DATABASE` * `DELETE_DATABASE` "preCheckMajorVersionUpgradeContext": { # Pre-check major version upgrade context. # The context for pre-check major version upgrade operation, if applicable. This field is only populated when the operation_type is PRE_CHECK_MAJOR_VERSION_UPGRADE. The PreCheckMajorVersionUpgradeContext message itself contains the details for that pre-check, such as the target database version for the upgrade and the results of the check (including any warnings or errors found). "kind": "A String", # Optional. This is always `sql#preCheckMajorVersionUpgradeContext`. + "maxRuntime": "A String", # Optional. The maximum allowed runtime for the precheck operation. "preCheckResponse": [ # Output only. The responses from the precheck operation. { # Structured PreCheckResponse containing message, type, and required actions. "actionsRequired": [ # The actions that the user needs to take. Use repeated for multiple actions. @@ -507,6 +508,7 @@

Method Details

"operationType": "A String", # The type of the operation. Valid values are: * `CREATE` * `DELETE` * `UPDATE` * `RESTART` * `IMPORT` * `EXPORT` * `BACKUP_VOLUME` * `RESTORE_VOLUME` * `CREATE_USER` * `DELETE_USER` * `CREATE_DATABASE` * `DELETE_DATABASE` "preCheckMajorVersionUpgradeContext": { # Pre-check major version upgrade context. # The context for pre-check major version upgrade operation, if applicable. This field is only populated when the operation_type is PRE_CHECK_MAJOR_VERSION_UPGRADE. The PreCheckMajorVersionUpgradeContext message itself contains the details for that pre-check, such as the target database version for the upgrade and the results of the check (including any warnings or errors found). "kind": "A String", # Optional. This is always `sql#preCheckMajorVersionUpgradeContext`. + "maxRuntime": "A String", # Optional. The maximum allowed runtime for the precheck operation. "preCheckResponse": [ # Output only. The responses from the precheck operation. { # Structured PreCheckResponse containing message, type, and required actions. "actionsRequired": [ # The actions that the user needs to take. Use repeated for multiple actions. diff --git a/docs/dyn/sqladmin_v1beta4.users.html b/docs/dyn/sqladmin_v1beta4.users.html index 7b2a87ff28..b6f7ee9cc6 100644 --- a/docs/dyn/sqladmin_v1beta4.users.html +++ b/docs/dyn/sqladmin_v1beta4.users.html @@ -241,6 +241,7 @@

Method Details

"operationType": "A String", # The type of the operation. Valid values are: * `CREATE` * `DELETE` * `UPDATE` * `RESTART` * `IMPORT` * `EXPORT` * `BACKUP_VOLUME` * `RESTORE_VOLUME` * `CREATE_USER` * `DELETE_USER` * `CREATE_DATABASE` * `DELETE_DATABASE` "preCheckMajorVersionUpgradeContext": { # Pre-check major version upgrade context. # The context for pre-check major version upgrade operation, if applicable. This field is only populated when the operation_type is PRE_CHECK_MAJOR_VERSION_UPGRADE. The PreCheckMajorVersionUpgradeContext message itself contains the details for that pre-check, such as the target database version for the upgrade and the results of the check (including any warnings or errors found). "kind": "A String", # Optional. This is always `sql#preCheckMajorVersionUpgradeContext`. + "maxRuntime": "A String", # Optional. The maximum allowed runtime for the precheck operation. "preCheckResponse": [ # Output only. The responses from the precheck operation. { # Structured PreCheckResponse containing message, type, and required actions. "actionsRequired": [ # The actions that the user needs to take. Use repeated for multiple actions. @@ -515,6 +516,7 @@

Method Details

"operationType": "A String", # The type of the operation. Valid values are: * `CREATE` * `DELETE` * `UPDATE` * `RESTART` * `IMPORT` * `EXPORT` * `BACKUP_VOLUME` * `RESTORE_VOLUME` * `CREATE_USER` * `DELETE_USER` * `CREATE_DATABASE` * `DELETE_DATABASE` "preCheckMajorVersionUpgradeContext": { # Pre-check major version upgrade context. # The context for pre-check major version upgrade operation, if applicable. This field is only populated when the operation_type is PRE_CHECK_MAJOR_VERSION_UPGRADE. The PreCheckMajorVersionUpgradeContext message itself contains the details for that pre-check, such as the target database version for the upgrade and the results of the check (including any warnings or errors found). "kind": "A String", # Optional. This is always `sql#preCheckMajorVersionUpgradeContext`. + "maxRuntime": "A String", # Optional. The maximum allowed runtime for the precheck operation. "preCheckResponse": [ # Output only. The responses from the precheck operation. { # Structured PreCheckResponse containing message, type, and required actions. "actionsRequired": [ # The actions that the user needs to take. Use repeated for multiple actions. @@ -799,6 +801,7 @@

Method Details

"operationType": "A String", # The type of the operation. Valid values are: * `CREATE` * `DELETE` * `UPDATE` * `RESTART` * `IMPORT` * `EXPORT` * `BACKUP_VOLUME` * `RESTORE_VOLUME` * `CREATE_USER` * `DELETE_USER` * `CREATE_DATABASE` * `DELETE_DATABASE` "preCheckMajorVersionUpgradeContext": { # Pre-check major version upgrade context. # The context for pre-check major version upgrade operation, if applicable. This field is only populated when the operation_type is PRE_CHECK_MAJOR_VERSION_UPGRADE. The PreCheckMajorVersionUpgradeContext message itself contains the details for that pre-check, such as the target database version for the upgrade and the results of the check (including any warnings or errors found). "kind": "A String", # Optional. This is always `sql#preCheckMajorVersionUpgradeContext`. + "maxRuntime": "A String", # Optional. The maximum allowed runtime for the precheck operation. "preCheckResponse": [ # Output only. The responses from the precheck operation. { # Structured PreCheckResponse containing message, type, and required actions. "actionsRequired": [ # The actions that the user needs to take. Use repeated for multiple actions. diff --git a/docs/dyn/sqladmin_v1beta4.workloadCaptures.html b/docs/dyn/sqladmin_v1beta4.workloadCaptures.html index 6fb1b59762..2b4373755b 100644 --- a/docs/dyn/sqladmin_v1beta4.workloadCaptures.html +++ b/docs/dyn/sqladmin_v1beta4.workloadCaptures.html @@ -117,6 +117,7 @@

Method Details

"kind": "A String", # This is always `sql#workloadCapturesList`. "workloadCaptures": [ # List of captured workloads for the instance. { # Captured workload for an instance. + "backupId": "A String", # Output only. The base backup ID associated with the workload capture. "endTime": "A String", # Output only. The end time of the workload capture. "replayInstance": "A String", # Output only. The name of the replay instance, if live replay was enabled. "retentionDays": 42, # Output only. The retention period in days for the captured workload. @@ -279,6 +280,7 @@

Method Details

"operationType": "A String", # The type of the operation. Valid values are: * `CREATE` * `DELETE` * `UPDATE` * `RESTART` * `IMPORT` * `EXPORT` * `BACKUP_VOLUME` * `RESTORE_VOLUME` * `CREATE_USER` * `DELETE_USER` * `CREATE_DATABASE` * `DELETE_DATABASE` "preCheckMajorVersionUpgradeContext": { # Pre-check major version upgrade context. # The context for pre-check major version upgrade operation, if applicable. This field is only populated when the operation_type is PRE_CHECK_MAJOR_VERSION_UPGRADE. The PreCheckMajorVersionUpgradeContext message itself contains the details for that pre-check, such as the target database version for the upgrade and the results of the check (including any warnings or errors found). "kind": "A String", # Optional. This is always `sql#preCheckMajorVersionUpgradeContext`. + "maxRuntime": "A String", # Optional. The maximum allowed runtime for the precheck operation. "preCheckResponse": [ # Output only. The responses from the precheck operation. { # Structured PreCheckResponse containing message, type, and required actions. "actionsRequired": [ # The actions that the user needs to take. Use repeated for multiple actions. @@ -469,6 +471,7 @@

Method Details

"operationType": "A String", # The type of the operation. Valid values are: * `CREATE` * `DELETE` * `UPDATE` * `RESTART` * `IMPORT` * `EXPORT` * `BACKUP_VOLUME` * `RESTORE_VOLUME` * `CREATE_USER` * `DELETE_USER` * `CREATE_DATABASE` * `DELETE_DATABASE` "preCheckMajorVersionUpgradeContext": { # Pre-check major version upgrade context. # The context for pre-check major version upgrade operation, if applicable. This field is only populated when the operation_type is PRE_CHECK_MAJOR_VERSION_UPGRADE. The PreCheckMajorVersionUpgradeContext message itself contains the details for that pre-check, such as the target database version for the upgrade and the results of the check (including any warnings or errors found). "kind": "A String", # Optional. This is always `sql#preCheckMajorVersionUpgradeContext`. + "maxRuntime": "A String", # Optional. The maximum allowed runtime for the precheck operation. "preCheckResponse": [ # Output only. The responses from the precheck operation. { # Structured PreCheckResponse containing message, type, and required actions. "actionsRequired": [ # The actions that the user needs to take. Use repeated for multiple actions. @@ -657,6 +660,7 @@

Method Details

"operationType": "A String", # The type of the operation. Valid values are: * `CREATE` * `DELETE` * `UPDATE` * `RESTART` * `IMPORT` * `EXPORT` * `BACKUP_VOLUME` * `RESTORE_VOLUME` * `CREATE_USER` * `DELETE_USER` * `CREATE_DATABASE` * `DELETE_DATABASE` "preCheckMajorVersionUpgradeContext": { # Pre-check major version upgrade context. # The context for pre-check major version upgrade operation, if applicable. This field is only populated when the operation_type is PRE_CHECK_MAJOR_VERSION_UPGRADE. The PreCheckMajorVersionUpgradeContext message itself contains the details for that pre-check, such as the target database version for the upgrade and the results of the check (including any warnings or errors found). "kind": "A String", # Optional. This is always `sql#preCheckMajorVersionUpgradeContext`. + "maxRuntime": "A String", # Optional. The maximum allowed runtime for the precheck operation. "preCheckResponse": [ # Output only. The responses from the precheck operation. { # Structured PreCheckResponse containing message, type, and required actions. "actionsRequired": [ # The actions that the user needs to take. Use repeated for multiple actions. @@ -847,6 +851,7 @@

Method Details

"operationType": "A String", # The type of the operation. Valid values are: * `CREATE` * `DELETE` * `UPDATE` * `RESTART` * `IMPORT` * `EXPORT` * `BACKUP_VOLUME` * `RESTORE_VOLUME` * `CREATE_USER` * `DELETE_USER` * `CREATE_DATABASE` * `DELETE_DATABASE` "preCheckMajorVersionUpgradeContext": { # Pre-check major version upgrade context. # The context for pre-check major version upgrade operation, if applicable. This field is only populated when the operation_type is PRE_CHECK_MAJOR_VERSION_UPGRADE. The PreCheckMajorVersionUpgradeContext message itself contains the details for that pre-check, such as the target database version for the upgrade and the results of the check (including any warnings or errors found). "kind": "A String", # Optional. This is always `sql#preCheckMajorVersionUpgradeContext`. + "maxRuntime": "A String", # Optional. The maximum allowed runtime for the precheck operation. "preCheckResponse": [ # Output only. The responses from the precheck operation. { # Structured PreCheckResponse containing message, type, and required actions. "actionsRequired": [ # The actions that the user needs to take. Use repeated for multiple actions. diff --git a/googleapiclient/discovery_cache/documents/sqladmin.v1.json b/googleapiclient/discovery_cache/documents/sqladmin.v1.json index 9e20f44705..6b0a27101e 100644 --- a/googleapiclient/discovery_cache/documents/sqladmin.v1.json +++ b/googleapiclient/discovery_cache/documents/sqladmin.v1.json @@ -3721,7 +3721,7 @@ } } }, -"revision": "20260920", +"revision": "20260929", "rootUrl": "https://sqladmin.googleapis.com/", "schemas": { "AclEntry": { @@ -5379,6 +5379,20 @@ false "format": "int64", "type": "string" }, +"databaseCenterIntegration": { +"description": "Optional. State of the Database Center integration for this instance. When unspecified, Database Center integration is enabled by default.", +"enum": [ +"DATABASE_CENTER_INTEGRATION_UNSPECIFIED", +"ENABLED", +"DISABLED" +], +"enumDescriptions": [ +"Default value. The integration state is unspecified. When unspecified, Database Center integration is enabled by default.", +"Database Center integration is enabled.", +"Database Center integration is disabled." +], +"type": "string" +}, "databaseCenterIntegrationEnabled": { "description": "Optional. If true, instance metadata is sent to the Database Center. If false, instance metadata is not sent to the Database Center.", "type": "boolean" @@ -5768,6 +5782,10 @@ false "$ref": "Settings", "description": "The user settings." }, +"skipPrecheck": { +"description": "Optional. Input only. Determines whether the precheck step is skipped during a major version upgrade.", +"type": "boolean" +}, "sqlNetworkArchitecture": { "enum": [ "SQL_NETWORK_ARCHITECTURE_UNSPECIFIED", @@ -6188,7 +6206,7 @@ false "type": "boolean" }, "database": { -"description": "Optional. Name of the database on which the statement will be executed.", +"description": "Optional. Name of the database on which the statement will be executed. For Postgres and SQL Server it's required, for MySQL it's optional.", "type": "string" }, "partialResultMode": { @@ -8499,6 +8517,11 @@ false "description": "Optional. This is always `sql#preCheckMajorVersionUpgradeContext`.", "type": "string" }, +"maxRuntime": { +"description": "Optional. The maximum allowed runtime for the precheck operation.", +"format": "google-duration", +"type": "string" +}, "preCheckResponse": { "description": "Output only. The responses from the precheck operation.", "items": { @@ -10651,6 +10674,11 @@ false "description": "Captured workload for an instance.", "id": "WorkloadCapture", "properties": { +"backupId": { +"description": "Output only. The base backup ID associated with the workload capture.", +"readOnly": true, +"type": "string" +}, "endTime": { "description": "Output only. The end time of the workload capture.", "format": "google-datetime", @@ -10685,13 +10713,15 @@ false "STATE_UNSPECIFIED", "RUNNING", "COMPLETED", -"FAILED" +"FAILED", +"TERMINATED" ], "enumDescriptions": [ "Default value. This value is unused.", "Workload capture is currently running.", -"Workload capture completed successfully.", -"Workload capture failed." +"Workload capture completed successfully. This state is set when the user explicitly stops the capture.", +"Workload capture failed.", +"Workload capture was terminated automatically. This state is set when Cloud SQL automatically stops the capture due to a conflicting operation or when the maximum duration is reached." ], "readOnly": true, "type": "string" diff --git a/googleapiclient/discovery_cache/documents/sqladmin.v1beta4.json b/googleapiclient/discovery_cache/documents/sqladmin.v1beta4.json index 61882c25b9..abcc7c4d6c 100644 --- a/googleapiclient/discovery_cache/documents/sqladmin.v1beta4.json +++ b/googleapiclient/discovery_cache/documents/sqladmin.v1beta4.json @@ -3721,7 +3721,7 @@ } } }, -"revision": "20260920", +"revision": "20260929", "rootUrl": "https://sqladmin.googleapis.com/", "schemas": { "AclEntry": { @@ -5393,6 +5393,20 @@ false "format": "int64", "type": "string" }, +"databaseCenterIntegration": { +"description": "Optional. State of the Database Center integration for this instance. When unspecified, Database Center integration is enabled by default.", +"enum": [ +"DATABASE_CENTER_INTEGRATION_UNSPECIFIED", +"ENABLED", +"DISABLED" +], +"enumDescriptions": [ +"Default value. The integration state is unspecified. When unspecified, Database Center integration is enabled by default.", +"Database Center integration is enabled.", +"Database Center integration is disabled." +], +"type": "string" +}, "databaseCenterIntegrationEnabled": { "description": "Optional. If true, instance metadata is sent to the Database Center. If false, instance metadata is not sent to the Database Center.", "type": "boolean" @@ -5782,6 +5796,10 @@ false "$ref": "Settings", "description": "The user settings." }, +"skipPrecheck": { +"description": "Optional. Input only. Determines whether the precheck step is skipped during a major version upgrade.", +"type": "boolean" +}, "sqlNetworkArchitecture": { "description": "The SQL network architecture for the instance.", "enum": [ @@ -6203,7 +6221,7 @@ false "type": "boolean" }, "database": { -"description": "Optional. Name of the database on which the statement will be executed.", +"description": "Optional. Name of the database on which the statement will be executed. For Postgres and SQL Server it's required, for MySQL it's optional.", "type": "string" }, "partialResultMode": { @@ -8517,6 +8535,11 @@ false "description": "Optional. This is always `sql#preCheckMajorVersionUpgradeContext`.", "type": "string" }, +"maxRuntime": { +"description": "Optional. The maximum allowed runtime for the precheck operation.", +"format": "google-duration", +"type": "string" +}, "preCheckResponse": { "description": "Output only. The responses from the precheck operation.", "items": { @@ -10703,6 +10726,11 @@ false "description": "Captured workload for an instance.", "id": "WorkloadCapture", "properties": { +"backupId": { +"description": "Output only. The base backup ID associated with the workload capture.", +"readOnly": true, +"type": "string" +}, "endTime": { "description": "Output only. The end time of the workload capture.", "format": "google-datetime", @@ -10737,13 +10765,15 @@ false "STATE_UNSPECIFIED", "RUNNING", "COMPLETED", -"FAILED" +"FAILED", +"TERMINATED" ], "enumDescriptions": [ "Default value. This value is unused.", "Workload capture is currently running.", -"Workload capture completed successfully.", -"Workload capture failed." +"Workload capture completed successfully. This state is set when the user explicitly stops the capture.", +"Workload capture failed.", +"Workload capture was terminated automatically. This state is set when Cloud SQL automatically stops the capture due to a conflicting operation or when the maximum duration is reached." ], "readOnly": true, "type": "string" From 647a44cbf3fbad4117a0b419f886e71e6ab011a7 Mon Sep 17 00:00:00 2001 From: Yoshi Automation Date: Tue, 20 Oct 2026 07:24:02 +0000 Subject: [PATCH 32/34] feat(storage): update the api #### storage:v1 The following keys were deleted: - resources.channels.methods.stop (Total Keys: 6) - schemas.Channel (Total Keys: 15) --- docs/dyn/storage_v1.html | 5 -- .../discovery_cache/documents/storage.v1.json | 78 +------------------ 2 files changed, 2 insertions(+), 81 deletions(-) diff --git a/docs/dyn/storage_v1.html b/docs/dyn/storage_v1.html index f7064893e0..f8ad0a76f4 100644 --- a/docs/dyn/storage_v1.html +++ b/docs/dyn/storage_v1.html @@ -89,11 +89,6 @@

Instance Methods

Returns the buckets Resource.

-

- channels() -

-

Returns the channels Resource.

-

defaultObjectAccessControls()

diff --git a/googleapiclient/discovery_cache/documents/storage.v1.json b/googleapiclient/discovery_cache/documents/storage.v1.json index 1ddf5eefbe..d5869bb1b3 100644 --- a/googleapiclient/discovery_cache/documents/storage.v1.json +++ b/googleapiclient/discovery_cache/documents/storage.v1.json @@ -253,7 +253,7 @@ "location": "northamerica-south1" } ], -"etag": "\"33373434373338383138373230333838393632\"", +"etag": "\"3130373737383931373330383137363536363734\"", "icons": { "x16": "https://www.google.com/images/icons/product/cloud_storage-16.png", "x32": "https://www.google.com/images/icons/product/cloud_storage-32.png" @@ -1496,27 +1496,6 @@ } } }, -"channels": { -"methods": { -"stop": { -"description": "Stop watching resources through this channel", -"httpMethod": "POST", -"id": "storage.channels.stop", -"path": "channels/stop", -"request": { -"$ref": "Channel", -"parameterName": "resource" -}, -"scopes": [ -"https://www.googleapis.com/auth/cloud-platform", -"https://www.googleapis.com/auth/cloud-platform.read-only", -"https://www.googleapis.com/auth/devstorage.full_control", -"https://www.googleapis.com/auth/devstorage.read_only", -"https://www.googleapis.com/auth/devstorage.read_write" -] -} -} -}, "defaultObjectAccessControls": { "methods": { "delete": { @@ -4782,7 +4761,7 @@ } } }, -"revision": "20260930", +"revision": "20261009", "rootUrl": "https://storage.googleapis.com/", "schemas": { "AdvanceRelocateBucketOperationRequest": { @@ -5705,59 +5684,6 @@ }, "type": "object" }, -"Channel": { -"description": "An notification channel used to watch for resource changes.", -"id": "Channel", -"properties": { -"address": { -"description": "The address where notifications are delivered for this channel.", -"type": "string" -}, -"expiration": { -"description": "Date and time of notification channel expiration, expressed as a Unix timestamp, in milliseconds. Optional.", -"format": "int64", -"type": "string" -}, -"id": { -"description": "A UUID or similar unique string that identifies this channel.", -"type": "string" -}, -"kind": { -"default": "api#channel", -"description": "Identifies this as a notification channel used to watch for changes to a resource, which is \"api#channel\".", -"type": "string" -}, -"params": { -"additionalProperties": { -"description": "Declares a new parameter by name.", -"type": "string" -}, -"description": "Additional parameters controlling delivery channel behavior. Optional.", -"type": "object" -}, -"payload": { -"description": "A Boolean value to indicate whether payload is wanted. Optional.", -"type": "boolean" -}, -"resourceId": { -"description": "An opaque ID that identifies the resource being watched on this channel. Stable across different API versions.", -"type": "string" -}, -"resourceUri": { -"description": "A version-specific identifier for the watched resource.", -"type": "string" -}, -"token": { -"description": "An arbitrary string delivered to the target address with each notification delivered over this channel. Optional.", -"type": "string" -}, -"type": { -"description": "The type of delivery mechanism used for this channel.", -"type": "string" -} -}, -"type": "object" -}, "ComposeRequest": { "description": "A Compose request.", "id": "ComposeRequest", From 63a5cfaa0c635e96ef5c29d6f491ce7af48a5be6 Mon Sep 17 00:00:00 2001 From: Yoshi Automation Date: Tue, 20 Oct 2026 07:24:03 +0000 Subject: [PATCH 33/34] feat(webcontentpublisher): update the api #### webcontentpublisher:v1 The following keys were added: - resources.organizations.resources.publications.methods.getSurveyQuestionCatalog (Total Keys: 13) - schemas.AnswerChoiceTemplate (Total Keys: 11) - schemas.Cta.properties.surveyConfig.$ref (Total Keys: 1) - schemas.CustomAnswerChoice (Total Keys: 3) - schemas.CustomQuestion (Total Keys: 8) - schemas.PresetQuestion (Total Keys: 7) - schemas.QuestionTemplate (Total Keys: 16) - schemas.SurveyConfig (Total Keys: 5) - schemas.SurveyQuestion (Total Keys: 10) --- ...er_v1.organizations.publications.ctas.html | 138 ++ ...blisher_v1.organizations.publications.html | 40 + .../documents/webcontentpublisher.v1.json | 1269 ++++++++++++++++- 3 files changed, 1444 insertions(+), 3 deletions(-) diff --git a/docs/dyn/webcontentpublisher_v1.organizations.publications.ctas.html b/docs/dyn/webcontentpublisher_v1.organizations.publications.ctas.html index 422e7a2dfa..a51b1483c5 100644 --- a/docs/dyn/webcontentpublisher_v1.organizations.publications.ctas.html +++ b/docs/dyn/webcontentpublisher_v1.organizations.publications.ctas.html @@ -118,6 +118,29 @@

Method Details

"title": "A String", # Required. The title of the newsletter signup prompt. }, "state": "A String", # Output only. The current state of this CTA. + "surveyConfig": { # Configuration for survey calls-to-action (CTAs). # Optional. Configuration specific to survey CTAs. Only populated if type is `SURVEY`. + "customMessage": "A String", # Optional. Header prompt shown to readers. If omitted, the server populates the default prompt localized to the parent publication's configured primary language. + "questions": [ # Optional. Ordered list of questions presented in the survey (1-3 items when `ACTIVE`; 0-3 when `DRAFT`). + { # A single question within a survey, which can be either a preset question from the catalog or a custom publisher-defined question. + "customQuestion": { # A custom question defined by the publisher. # Optional. A custom question defined by the publisher. + "answerChoices": [ # Required. Ordered list of answer choices for the custom question (2-5 items). + { # An answer choice for a custom survey question. + "displayText": "A String", # Required. The display text of the answer choice shown to readers. + }, + ], + "categoryLabel": "A String", # Optional. Reporting category label sent to Google Analytics (up to 100 characters). + "displayText": "A String", # Required. The question prompt displayed to readers. + "id": "A String", # Output only. Server-assigned unique identifier for the custom question. + }, + "presetQuestion": { # A preset question referencing a template in the survey question catalog. # Optional. A question selected from the preset question catalog. + "answerIds": [ # Optional. Selected answer choice IDs from the question template. Required (2-5 unique IDs) when the catalog question is `CONFIGURABLE_CHOICES`, and must be omitted for `FIXED_CHOICES`. + 42, + ], + "questionId": 42, # Required. ID of the question template from `SurveyQuestionCatalog`. + }, + }, + ], + }, "type": "A String", # Required. The type of this CTA. } @@ -141,6 +164,29 @@

Method Details

"title": "A String", # Required. The title of the newsletter signup prompt. }, "state": "A String", # Output only. The current state of this CTA. + "surveyConfig": { # Configuration for survey calls-to-action (CTAs). # Optional. Configuration specific to survey CTAs. Only populated if type is `SURVEY`. + "customMessage": "A String", # Optional. Header prompt shown to readers. If omitted, the server populates the default prompt localized to the parent publication's configured primary language. + "questions": [ # Optional. Ordered list of questions presented in the survey (1-3 items when `ACTIVE`; 0-3 when `DRAFT`). + { # A single question within a survey, which can be either a preset question from the catalog or a custom publisher-defined question. + "customQuestion": { # A custom question defined by the publisher. # Optional. A custom question defined by the publisher. + "answerChoices": [ # Required. Ordered list of answer choices for the custom question (2-5 items). + { # An answer choice for a custom survey question. + "displayText": "A String", # Required. The display text of the answer choice shown to readers. + }, + ], + "categoryLabel": "A String", # Optional. Reporting category label sent to Google Analytics (up to 100 characters). + "displayText": "A String", # Required. The question prompt displayed to readers. + "id": "A String", # Output only. Server-assigned unique identifier for the custom question. + }, + "presetQuestion": { # A preset question referencing a template in the survey question catalog. # Optional. A question selected from the preset question catalog. + "answerIds": [ # Optional. Selected answer choice IDs from the question template. Required (2-5 unique IDs) when the catalog question is `CONFIGURABLE_CHOICES`, and must be omitted for `FIXED_CHOICES`. + 42, + ], + "questionId": 42, # Required. ID of the question template from `SurveyQuestionCatalog`. + }, + }, + ], + }, "type": "A String", # Required. The type of this CTA. } @@ -170,6 +216,29 @@

Method Details

"title": "A String", # Required. The title of the newsletter signup prompt. }, "state": "A String", # Output only. The current state of this CTA. + "surveyConfig": { # Configuration for survey calls-to-action (CTAs). # Optional. Configuration specific to survey CTAs. Only populated if type is `SURVEY`. + "customMessage": "A String", # Optional. Header prompt shown to readers. If omitted, the server populates the default prompt localized to the parent publication's configured primary language. + "questions": [ # Optional. Ordered list of questions presented in the survey (1-3 items when `ACTIVE`; 0-3 when `DRAFT`). + { # A single question within a survey, which can be either a preset question from the catalog or a custom publisher-defined question. + "customQuestion": { # A custom question defined by the publisher. # Optional. A custom question defined by the publisher. + "answerChoices": [ # Required. Ordered list of answer choices for the custom question (2-5 items). + { # An answer choice for a custom survey question. + "displayText": "A String", # Required. The display text of the answer choice shown to readers. + }, + ], + "categoryLabel": "A String", # Optional. Reporting category label sent to Google Analytics (up to 100 characters). + "displayText": "A String", # Required. The question prompt displayed to readers. + "id": "A String", # Output only. Server-assigned unique identifier for the custom question. + }, + "presetQuestion": { # A preset question referencing a template in the survey question catalog. # Optional. A question selected from the preset question catalog. + "answerIds": [ # Optional. Selected answer choice IDs from the question template. Required (2-5 unique IDs) when the catalog question is `CONFIGURABLE_CHOICES`, and must be omitted for `FIXED_CHOICES`. + 42, + ], + "questionId": 42, # Required. ID of the question template from `SurveyQuestionCatalog`. + }, + }, + ], + }, "type": "A String", # Required. The type of this CTA. } @@ -203,6 +272,29 @@

Method Details

"title": "A String", # Required. The title of the newsletter signup prompt. }, "state": "A String", # Output only. The current state of this CTA. + "surveyConfig": { # Configuration for survey calls-to-action (CTAs). # Optional. Configuration specific to survey CTAs. Only populated if type is `SURVEY`. + "customMessage": "A String", # Optional. Header prompt shown to readers. If omitted, the server populates the default prompt localized to the parent publication's configured primary language. + "questions": [ # Optional. Ordered list of questions presented in the survey (1-3 items when `ACTIVE`; 0-3 when `DRAFT`). + { # A single question within a survey, which can be either a preset question from the catalog or a custom publisher-defined question. + "customQuestion": { # A custom question defined by the publisher. # Optional. A custom question defined by the publisher. + "answerChoices": [ # Required. Ordered list of answer choices for the custom question (2-5 items). + { # An answer choice for a custom survey question. + "displayText": "A String", # Required. The display text of the answer choice shown to readers. + }, + ], + "categoryLabel": "A String", # Optional. Reporting category label sent to Google Analytics (up to 100 characters). + "displayText": "A String", # Required. The question prompt displayed to readers. + "id": "A String", # Output only. Server-assigned unique identifier for the custom question. + }, + "presetQuestion": { # A preset question referencing a template in the survey question catalog. # Optional. A question selected from the preset question catalog. + "answerIds": [ # Optional. Selected answer choice IDs from the question template. Required (2-5 unique IDs) when the catalog question is `CONFIGURABLE_CHOICES`, and must be omitted for `FIXED_CHOICES`. + 42, + ], + "questionId": 42, # Required. ID of the question template from `SurveyQuestionCatalog`. + }, + }, + ], + }, "type": "A String", # Required. The type of this CTA. }, ], @@ -244,6 +336,29 @@

Method Details

"title": "A String", # Required. The title of the newsletter signup prompt. }, "state": "A String", # Output only. The current state of this CTA. + "surveyConfig": { # Configuration for survey calls-to-action (CTAs). # Optional. Configuration specific to survey CTAs. Only populated if type is `SURVEY`. + "customMessage": "A String", # Optional. Header prompt shown to readers. If omitted, the server populates the default prompt localized to the parent publication's configured primary language. + "questions": [ # Optional. Ordered list of questions presented in the survey (1-3 items when `ACTIVE`; 0-3 when `DRAFT`). + { # A single question within a survey, which can be either a preset question from the catalog or a custom publisher-defined question. + "customQuestion": { # A custom question defined by the publisher. # Optional. A custom question defined by the publisher. + "answerChoices": [ # Required. Ordered list of answer choices for the custom question (2-5 items). + { # An answer choice for a custom survey question. + "displayText": "A String", # Required. The display text of the answer choice shown to readers. + }, + ], + "categoryLabel": "A String", # Optional. Reporting category label sent to Google Analytics (up to 100 characters). + "displayText": "A String", # Required. The question prompt displayed to readers. + "id": "A String", # Output only. Server-assigned unique identifier for the custom question. + }, + "presetQuestion": { # A preset question referencing a template in the survey question catalog. # Optional. A question selected from the preset question catalog. + "answerIds": [ # Optional. Selected answer choice IDs from the question template. Required (2-5 unique IDs) when the catalog question is `CONFIGURABLE_CHOICES`, and must be omitted for `FIXED_CHOICES`. + 42, + ], + "questionId": 42, # Required. ID of the question template from `SurveyQuestionCatalog`. + }, + }, + ], + }, "type": "A String", # Required. The type of this CTA. } @@ -267,6 +382,29 @@

Method Details

"title": "A String", # Required. The title of the newsletter signup prompt. }, "state": "A String", # Output only. The current state of this CTA. + "surveyConfig": { # Configuration for survey calls-to-action (CTAs). # Optional. Configuration specific to survey CTAs. Only populated if type is `SURVEY`. + "customMessage": "A String", # Optional. Header prompt shown to readers. If omitted, the server populates the default prompt localized to the parent publication's configured primary language. + "questions": [ # Optional. Ordered list of questions presented in the survey (1-3 items when `ACTIVE`; 0-3 when `DRAFT`). + { # A single question within a survey, which can be either a preset question from the catalog or a custom publisher-defined question. + "customQuestion": { # A custom question defined by the publisher. # Optional. A custom question defined by the publisher. + "answerChoices": [ # Required. Ordered list of answer choices for the custom question (2-5 items). + { # An answer choice for a custom survey question. + "displayText": "A String", # Required. The display text of the answer choice shown to readers. + }, + ], + "categoryLabel": "A String", # Optional. Reporting category label sent to Google Analytics (up to 100 characters). + "displayText": "A String", # Required. The question prompt displayed to readers. + "id": "A String", # Output only. Server-assigned unique identifier for the custom question. + }, + "presetQuestion": { # A preset question referencing a template in the survey question catalog. # Optional. A question selected from the preset question catalog. + "answerIds": [ # Optional. Selected answer choice IDs from the question template. Required (2-5 unique IDs) when the catalog question is `CONFIGURABLE_CHOICES`, and must be omitted for `FIXED_CHOICES`. + 42, + ], + "questionId": 42, # Required. ID of the question template from `SurveyQuestionCatalog`. + }, + }, + ], + }, "type": "A String", # Required. The type of this CTA. } diff --git a/docs/dyn/webcontentpublisher_v1.organizations.publications.html b/docs/dyn/webcontentpublisher_v1.organizations.publications.html index 923df2bb93..dda7467c85 100644 --- a/docs/dyn/webcontentpublisher_v1.organizations.publications.html +++ b/docs/dyn/webcontentpublisher_v1.organizations.publications.html @@ -88,6 +88,9 @@

Instance Methods

get(name, x__xgafv=None)

Gets a publication.

+

+ getSurveyQuestionCatalog(name, languageCode=None, x__xgafv=None)

+

Retrieves the catalog of predefined survey questions and answer choices available for a publication.

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

Lists publications.

@@ -266,6 +269,43 @@

Method Details

} +
+ getSurveyQuestionCatalog(name, languageCode=None, x__xgafv=None) + 
Retrieves the catalog of predefined survey questions and answer choices available for a publication.
+
+Args:
+  name: string, Required. The resource name of the survey question catalog to retrieve. Format: `organizations/{organization}/publications/{publication}/surveyQuestionCatalog`. (required)
+  languageCode: string, Optional. The BCP-47 language code (e.g., "en-US", "es-419") to override the publication's configured primary language.
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # Represents the catalog of predefined survey questions and localized answer choices available for a publication.
+  "name": "A String", # Identifier. The resource name of the survey question catalog. Format: `organizations/{organization}/publications/{publication}/surveyQuestionCatalog`.
+  "questions": [ # Output only. The list of available predefined question templates.
+    { # A predefined question template in the survey question catalog.
+      "answerChoices": [ # Output only. Possible answer choices for this question.
+        { # A predefined answer choice template for a catalog question.
+          "category": "A String", # Output only. Category of the answer based on the IAB Audience Taxonomy.
+          "categoryLabel": "A String", # Output only. Text label used for aggregating responses by category in analytics.
+          "displayText": "A String", # Output only. Localized answer choice text displayed to readers.
+          "id": 42, # Output only. Unique identifier of the answer choice within the question.
+        },
+      ],
+      "category": "A String", # Output only. Category of the question based on the IAB Audience Taxonomy.
+      "categoryLabel": "A String", # Output only. Text label used for aggregating responses by category in analytics.
+      "configurationType": "A String", # Output only. The type of answer choice configuration for this question.
+      "displayText": "A String", # Output only. Localized question text displayed to readers.
+      "id": 42, # Output only. Unique identifier of the question template.
+    },
+  ],
+}
+
+
list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None) 
Lists publications.
diff --git a/googleapiclient/discovery_cache/documents/webcontentpublisher.v1.json b/googleapiclient/discovery_cache/documents/webcontentpublisher.v1.json
index 574a5bb7e1..a4deeab512 100644
--- a/googleapiclient/discovery_cache/documents/webcontentpublisher.v1.json
+++ b/googleapiclient/discovery_cache/documents/webcontentpublisher.v1.json
@@ -167,6 +167,36 @@
 "https://www.googleapis.com/auth/webcontentpublisher.publications.manage.system"
 ]
 },
+"getSurveyQuestionCatalog": {
+"description": "Retrieves the catalog of predefined survey questions and answer choices available for a publication.",
+"flatPath": "v1/organizations/{organizationsId}/publications/{publicationsId}/surveyQuestionCatalog",
+"httpMethod": "GET",
+"id": "webcontentpublisher.organizations.publications.getSurveyQuestionCatalog",
+"parameterOrder": [
+"name"
+],
+"parameters": {
+"languageCode": {
+"description": "Optional. The BCP-47 language code (e.g., \"en-US\", \"es-419\") to override the publication's configured primary language.",
+"location": "query",
+"type": "string"
+},
+"name": {
+"description": "Required. The resource name of the survey question catalog to retrieve. Format: `organizations/{organization}/publications/{publication}/surveyQuestionCatalog`.",
+"location": "path",
+"pattern": "^organizations/[^/]+/publications/[^/]+/surveyQuestionCatalog$",
+"required": true,
+"type": "string"
+}
+},
+"path": "v1/{+name}",
+"response": {
+"$ref": "SurveyQuestionCatalog"
+},
+"scopes": [
+"https://www.googleapis.com/auth/webcontentpublisher.publications.manage.system"
+]
+},
 "list": {
 "description": "Lists publications.",
 "flatPath": "v1/organizations/{organizationsId}/publications",
@@ -446,9 +476,1051 @@
 }
 }
 },
-"revision": "20260924",
+"revision": "20261012",
 "rootUrl": "https://webcontentpublisher.googleapis.com/",
 "schemas": {
+"AnswerChoiceTemplate": {
+"description": "A predefined answer choice template for a catalog question.",
+"id": "AnswerChoiceTemplate",
+"properties": {
+"category": {
+"description": "Output only. Category of the answer based on the IAB Audience Taxonomy.",
+"enum": [
+"ANSWER_CATEGORY_UNSPECIFIED",
+"INTEREST__ACADEMIC_INTERESTS",
+"INTEREST__AUTOMOTIVE",
+"INTEREST__BOOKS_AND_LITERATURE",
+"INTEREST__BUSINESS_AND_FINANCE",
+"INTEREST__CAREERS",
+"INTEREST__FAMILY_AND_RELATIONSHIPS",
+"INTEREST__FINE_ART",
+"INTEREST__FOOD_AND_DRINK",
+"INTEREST__HEALTH_AND_MEDICAL_SERVICES",
+"INTEREST__HEALTHY_LIVING",
+"INTEREST__HOBBIES_AND_INTERESTS",
+"INTEREST__HOME_AND_GARDEN",
+"INTEREST__MEDICAL_HEALTH",
+"INTEREST__MOVIES",
+"INTEREST__MUSIC_AND_AUDIO",
+"INTEREST__NEWS_AND_POLITICS",
+"INTEREST__PERSONAL_FINANCE",
+"INTEREST__PETS",
+"INTEREST__PHARMACEUTICALS_CONDITIONS_AND_SYMPTOMS",
+"INTEREST__POP_CULTURE",
+"INTEREST__REAL_ESTATE",
+"INTEREST__SHOPPING",
+"INTEREST__SPORTS",
+"INTEREST__STYLE_AND_FASHION",
+"INTEREST__TECHNOLOGY_AND_COMPUTING",
+"INTEREST__TELEVISION",
+"INTEREST__TRAVEL",
+"INTEREST__VIDEO_GAMING",
+"INTEREST__ACADEMIC_INTERESTS__ARTS_AND_HUMANITIES",
+"INTEREST__ACADEMIC_INTERESTS__LANGUAGE_LEARNING",
+"INTEREST__ACADEMIC_INTERESTS__LIFE_SCIENCES",
+"INTEREST__ACADEMIC_INTERESTS__PHYSICAL_SCIENCE_AND_ENGINEERING",
+"INTEREST__ACADEMIC_INTERESTS__SOCIAL_SCIENCES",
+"INTEREST__AUTOMOTIVE__AUTO_BUYING_AND_SELLING",
+"INTEREST__AUTOMOTIVE__AUTO_SHOWS",
+"INTEREST__AUTOMOTIVE__AUTO_TECHNOLOGY",
+"INTEREST__AUTOMOTIVE__BUDGET_CARS",
+"INTEREST__AUTOMOTIVE__CAR_CULTURE",
+"INTEREST__AUTOMOTIVE__CLASSIC_CARS",
+"INTEREST__AUTOMOTIVE__CONCEPT_CARS",
+"INTEREST__AUTOMOTIVE__DASH_CAM_VIDEOS",
+"INTEREST__AUTOMOTIVE__DRIVERLESS_CARS",
+"INTEREST__AUTOMOTIVE__GREEN_VEHICLES",
+"INTEREST__AUTOMOTIVE__LUXURY_CARS",
+"INTEREST__AUTOMOTIVE__MOTORCYCLES",
+"INTEREST__AUTOMOTIVE__PERFORMANCE_CARS",
+"INTEREST__AUTOMOTIVE__SCOOTERS",
+"INTEREST__BOOKS_AND_LITERATURE__ART_AND_PHOTOGRAPHY_BOOKS",
+"INTEREST__BOOKS_AND_LITERATURE__BIOGRAPHIES",
+"INTEREST__BOOKS_AND_LITERATURE__CHILDRENS_LITERATURE",
+"INTEREST__BOOKS_AND_LITERATURE__COMICS_AND_GRAPHIC_NOVELS",
+"INTEREST__BOOKS_AND_LITERATURE__COOKBOOKS",
+"INTEREST__BOOKS_AND_LITERATURE__FICTION",
+"INTEREST__BOOKS_AND_LITERATURE__POETRY",
+"INTEREST__BOOKS_AND_LITERATURE__TRAVEL_BOOKS",
+"INTEREST__BOOKS_AND_LITERATURE__YOUNG_ADULT_LITERATURE",
+"INTEREST__BUSINESS_AND_FINANCE__BUSINESS",
+"INTEREST__BUSINESS_AND_FINANCE__ECONOMY",
+"INTEREST__BUSINESS_AND_FINANCE__INDUSTRIES",
+"INTEREST__CAREERS__APPRENTICESHIPS",
+"INTEREST__CAREERS__CAREER_ADVICE",
+"INTEREST__CAREERS__CAREER_PLANNING",
+"INTEREST__CAREERS__REMOTE_WORKING",
+"INTEREST__CAREERS__VOCATIONAL_TRAINING",
+"INTEREST__EDUCATION__ADULT_EDUCATION",
+"INTEREST__EDUCATION__ONLINE_EDUCATION",
+"INTEREST__FAMILY_AND_RELATIONSHIPS__PARENTING",
+"INTEREST__FINE_ART__COSTUME",
+"INTEREST__FINE_ART__DANCE",
+"INTEREST__FINE_ART__DESIGN",
+"INTEREST__FINE_ART__DIGITAL_ARTS",
+"INTEREST__FINE_ART__FINE_ART_PHOTOGRAPHY",
+"INTEREST__FINE_ART__MODERN_ART",
+"INTEREST__FINE_ART__OPERA",
+"INTEREST__FINE_ART__THEATER",
+"INTEREST__FOOD_AND_DRINK__ALCOHOLIC_BEVERAGES",
+"INTEREST__FOOD_AND_DRINK__BARBECUES_AND_GRILLING",
+"INTEREST__FOOD_AND_DRINK__COOKING",
+"INTEREST__FOOD_AND_DRINK__DESSERTS_AND_BAKING",
+"INTEREST__FOOD_AND_DRINK__DINING_OUT",
+"INTEREST__FOOD_AND_DRINK__FOOD_ALLERGIES",
+"INTEREST__FOOD_AND_DRINK__FOOD_MOVEMENTS",
+"INTEREST__FOOD_AND_DRINK__HEALTHY_COOKING_AND_EATING",
+"INTEREST__FOOD_AND_DRINK__NON_ALCOHOLIC_BEVERAGES",
+"INTEREST__FOOD_AND_DRINK__VEGAN_DIETS",
+"INTEREST__FOOD_AND_DRINK__VEGETARIAN_DIETS",
+"INTEREST__FOOD_AND_DRINK__WORLD_CUISINES",
+"INTEREST__HEALTH_AND_MEDICAL_SERVICES__HEALTH_AND_PHARMA",
+"INTEREST__HEALTHY_LIVING__CHILDRENS_HEALTH",
+"INTEREST__HEALTHY_LIVING__FITNESS_AND_EXERCISE",
+"INTEREST__HEALTHY_LIVING__MENS_HEALTH",
+"INTEREST__HEALTHY_LIVING__NUTRITION",
+"INTEREST__HEALTHY_LIVING__SENIOR_HEALTH",
+"INTEREST__HEALTHY_LIVING__WEIGHT_LOSS",
+"INTEREST__HEALTHY_LIVING__WELLNESS",
+"INTEREST__HEALTHY_LIVING__WOMENS_HEALTH",
+"INTEREST__HOBBIES_AND_INTERESTS__ANTIQUING_AND_ANTIQUES",
+"INTEREST__HOBBIES_AND_INTERESTS__ARTS_AND_CRAFTS",
+"INTEREST__HOBBIES_AND_INTERESTS__BEEKEEPING",
+"INTEREST__HOBBIES_AND_INTERESTS__BIRDWATCHING",
+"INTEREST__HOBBIES_AND_INTERESTS__CIGARS",
+"INTEREST__HOBBIES_AND_INTERESTS__COLLECTING",
+"INTEREST__HOBBIES_AND_INTERESTS__CONTENT_PRODUCTION",
+"INTEREST__HOBBIES_AND_INTERESTS__GAMES_AND_PUZZLES",
+"INTEREST__HOBBIES_AND_INTERESTS__GENEALOGY_AND_ANCESTRY",
+"INTEREST__HOBBIES_AND_INTERESTS__MAGIC_AND_ILLUSION",
+"INTEREST__HOBBIES_AND_INTERESTS__MODEL_TOYS",
+"INTEREST__HOBBIES_AND_INTERESTS__MUSICAL_INSTRUMENTS",
+"INTEREST__HOBBIES_AND_INTERESTS__PARANORMAL_PHENOMENA",
+"INTEREST__HOBBIES_AND_INTERESTS__RADIO_CONTROL",
+"INTEREST__HOBBIES_AND_INTERESTS__SCI_FI_AND_FANTASY",
+"INTEREST__HOBBIES_AND_INTERESTS__WORKSHOPS_AND_CLASSES",
+"INTEREST__HOME_AND_GARDEN__GARDENING",
+"INTEREST__HOME_AND_GARDEN__HOME_ENTERTAINING",
+"INTEREST__HOME_AND_GARDEN__HOME_IMPROVEMENT",
+"INTEREST__HOME_AND_GARDEN__INTERIOR_DECORATING",
+"INTEREST__HOME_AND_GARDEN__LANDSCAPING",
+"INTEREST__HOME_AND_GARDEN__OUTDOOR_DECORATING",
+"INTEREST__HOME_AND_GARDEN__REMODELING_AND_CONSTRUCTION",
+"INTEREST__HOME_AND_GARDEN__SMART_HOME",
+"INTEREST__MOVIES__ACTION_AND_ADVENTURE_MOVIES",
+"INTEREST__MOVIES__ANIMATION_MOVIES",
+"INTEREST__MOVIES__COMEDY_MOVIES",
+"INTEREST__MOVIES__CRIME_AND_MYSTERY_MOVIES",
+"INTEREST__MOVIES__DOCUMENTARY_MOVIES",
+"INTEREST__MOVIES__DRAMA_MOVIES",
+"INTEREST__MOVIES__FAMILY_AND_CHILDREN_MOVIES",
+"INTEREST__MOVIES__FANTASY_MOVIES",
+"INTEREST__MOVIES__HORROR_MOVIES",
+"INTEREST__MOVIES__INDIE_AND_ARTHOUSE_MOVIES",
+"INTEREST__MOVIES__ROMANCE_MOVIES",
+"INTEREST__MOVIES__SCIENCE_FICTION_MOVIES",
+"INTEREST__MOVIES__WORLD_MOVIES",
+"INTEREST__MUSIC_AND_AUDIO__ADULT_ALBUM_ALTERNATIVE",
+"INTEREST__MUSIC_AND_AUDIO__ADULT_CONTEMPORARY_MUSIC",
+"INTEREST__MUSIC_AND_AUDIO__ALTERNATIVE_MUSIC",
+"INTEREST__MUSIC_AND_AUDIO__BLUES",
+"INTEREST__MUSIC_AND_AUDIO__CHILDRENS_MUSIC",
+"INTEREST__MUSIC_AND_AUDIO__CLASSIC_HITS",
+"INTEREST__MUSIC_AND_AUDIO__CLASSICAL_MUSIC",
+"INTEREST__MUSIC_AND_AUDIO__COLLEGE_RADIO",
+"INTEREST__MUSIC_AND_AUDIO__COMEDY_MUSIC_AND_AUDIO",
+"INTEREST__MUSIC_AND_AUDIO__CONTEMPORARY_HITS_POP_TOP_40",
+"INTEREST__MUSIC_AND_AUDIO__COUNTRY_MUSIC",
+"INTEREST__MUSIC_AND_AUDIO__DANCE_AND_ELECTRONIC_MUSIC",
+"INTEREST__MUSIC_AND_AUDIO__GOSPEL_MUSIC",
+"INTEREST__MUSIC_AND_AUDIO__HIP_HOP_MUSIC",
+"INTEREST__MUSIC_AND_AUDIO__INSPIRATIONAL_NEW_AGE_MUSIC",
+"INTEREST__MUSIC_AND_AUDIO__JAZZ",
+"INTEREST__MUSIC_AND_AUDIO__OLDIES_ADULT_STANDARDS",
+"INTEREST__MUSIC_AND_AUDIO__RNB_SOUL_FUNK",
+"INTEREST__MUSIC_AND_AUDIO__REGGAE",
+"INTEREST__MUSIC_AND_AUDIO__RELIGIOUS__MUSIC_AND_AUDIO",
+"INTEREST__MUSIC_AND_AUDIO__ROCK_MUSIC",
+"INTEREST__MUSIC_AND_AUDIO__SONGWRITERS_FOLK",
+"INTEREST__MUSIC_AND_AUDIO__SOUNDTRACKS_TV_AND_SHOWTUNES",
+"INTEREST__MUSIC_AND_AUDIO__SPORTS_RADIO",
+"INTEREST__MUSIC_AND_AUDIO__TALK_RADIO",
+"INTEREST__MUSIC_AND_AUDIO__URBAN_CONTEMPORARY_MUSIC",
+"INTEREST__MUSIC_AND_AUDIO__VARIETY__MUSIC_AND_AUDIO",
+"INTEREST__MUSIC_AND_AUDIO__WORLD_INTERNATIONAL_MUSIC",
+"INTEREST__NEWS_AND_POLITICS__CRIME",
+"INTEREST__NEWS_AND_POLITICS__DISASTERS",
+"INTEREST__NEWS_AND_POLITICS__INTERNATIONAL_NEWS",
+"INTEREST__NEWS_AND_POLITICS__LAW",
+"INTEREST__NEWS_AND_POLITICS__LOCAL_NEWS",
+"INTEREST__NEWS_AND_POLITICS__NATIONAL_NEWS",
+"INTEREST__NEWS_AND_POLITICS__POLITICS",
+"INTEREST__NEWS_AND_POLITICS__WEATHER",
+"INTEREST__PERSONAL_FINANCE__FRUGAL_LIVING",
+"INTEREST__PERSONAL_FINANCE__INSURANCE",
+"INTEREST__PERSONAL_FINANCE__PERSONAL_DEBT",
+"INTEREST__PERSONAL_FINANCE__PERSONAL_INVESTING",
+"INTEREST__PERSONAL_FINANCE__PERSONAL_TAXES",
+"INTEREST__PERSONAL_FINANCE__RETIREMENT_PLANNING",
+"INTEREST__PETS__BIRDS",
+"INTEREST__PETS__CATS",
+"INTEREST__PETS__DOGS",
+"INTEREST__PETS__FISH_AND_AQUARIUMS",
+"INTEREST__PETS__HORSES_AND_EQUINE",
+"INTEREST__PETS__LARGE_ANIMALS",
+"INTEREST__PETS__PET_ADOPTIONS",
+"INTEREST__PETS__REPTILES",
+"INTEREST__POP_CULTURE__HUMOR_AND_SATIRE",
+"INTEREST__REAL_ESTATE__APARTMENTS",
+"INTEREST__REAL_ESTATE__DEVELOPMENTAL_SITES",
+"INTEREST__REAL_ESTATE__HOTEL_PROPERTIES",
+"INTEREST__REAL_ESTATE__HOUSES",
+"INTEREST__REAL_ESTATE__INDUSTRIAL_PROPERTY",
+"INTEREST__REAL_ESTATE__LAND_AND_FARMS",
+"INTEREST__REAL_ESTATE__OFFICE_PROPERTY",
+"INTEREST__REAL_ESTATE__REAL_ESTATE_BUYING_AND_SELLING",
+"INTEREST__REAL_ESTATE__REAL_ESTATE_RENTING_AND_LEASING",
+"INTEREST__REAL_ESTATE__RETAIL_PROPERTY",
+"INTEREST__REAL_ESTATE__VACATION_PROPERTIES",
+"INTEREST__SPORTS__AMERICAN_FOOTBALL",
+"INTEREST__SPORTS__AUSTRALIAN_RULES_FOOTBALL",
+"INTEREST__SPORTS__AUTO_RACING",
+"INTEREST__SPORTS__BADMINTON",
+"INTEREST__SPORTS__BASEBALL",
+"INTEREST__SPORTS__BASKETBALL",
+"INTEREST__SPORTS__BEACH_VOLLEYBALL",
+"INTEREST__SPORTS__BODYBUILDING",
+"INTEREST__SPORTS__BOWLING",
+"INTEREST__SPORTS__BOXING",
+"INTEREST__SPORTS__CHEERLEADING",
+"INTEREST__SPORTS__COLLEGE_SPORTS",
+"INTEREST__SPORTS__CRICKET",
+"INTEREST__SPORTS__CYCLING",
+"INTEREST__SPORTS__DARTS",
+"INTEREST__SPORTS__DISABLED_SPORTS",
+"INTEREST__SPORTS__DIVING",
+"INTEREST__SPORTS__EQUINE_SPORTS",
+"INTEREST__SPORTS__EXTREME_SPORTS",
+"INTEREST__SPORTS__FANTASY_SPORTS",
+"INTEREST__SPORTS__FIELD_HOCKEY",
+"INTEREST__SPORTS__FIGURE_SKATING",
+"INTEREST__SPORTS__FISHING_SPORTS",
+"INTEREST__SPORTS__GOLF",
+"INTEREST__SPORTS__GYMNASTICS",
+"INTEREST__SPORTS__HUNTING_AND_SHOOTING",
+"INTEREST__SPORTS__ICE_HOCKEY",
+"INTEREST__SPORTS__INLINE_SKATING",
+"INTEREST__SPORTS__LACROSSE",
+"INTEREST__SPORTS__MARTIAL_ARTS",
+"INTEREST__SPORTS__OLYMPIC_SPORTS",
+"INTEREST__SPORTS__POKER_AND_PROFESSIONAL_GAMBLING",
+"INTEREST__SPORTS__RODEO",
+"INTEREST__SPORTS__ROWING",
+"INTEREST__SPORTS__RUGBY",
+"INTEREST__SPORTS__SAILING",
+"INTEREST__SPORTS__SKIING",
+"INTEREST__SPORTS__SNOOKER_POOL_BILLIARDS",
+"INTEREST__SPORTS__SOCCER",
+"INTEREST__SPORTS__SOFTBALL",
+"INTEREST__SPORTS__SPORTS_EQUIPMENT",
+"INTEREST__SPORTS__SQUASH",
+"INTEREST__SPORTS__SWIMMING",
+"INTEREST__SPORTS__TABLE_TENNIS",
+"INTEREST__SPORTS__TENNIS",
+"INTEREST__SPORTS__TRACK_AND_FIELD",
+"INTEREST__SPORTS__VOLLEYBALL",
+"INTEREST__SPORTS__WALKING",
+"INTEREST__SPORTS__WATER_POLO",
+"INTEREST__SPORTS__WEIGHTLIFTING",
+"INTEREST__SPORTS__WRESTLING",
+"INTEREST__STYLE_AND_FASHION__BEAUTY",
+"INTEREST__STYLE_AND_FASHION__BODY_ART",
+"INTEREST__STYLE_AND_FASHION__CHILDRENS_CLOTHING",
+"INTEREST__STYLE_AND_FASHION__DESIGNER_CLOTHING",
+"INTEREST__STYLE_AND_FASHION__FASHION_TRENDS",
+"INTEREST__STYLE_AND_FASHION__HIGH_FASHION",
+"INTEREST__STYLE_AND_FASHION__MENS_FASHION",
+"INTEREST__STYLE_AND_FASHION__PERSONAL_CARE",
+"INTEREST__STYLE_AND_FASHION__STREET_STYLE",
+"INTEREST__STYLE_AND_FASHION__WOMENS_FASHION",
+"INTEREST__TECHNOLOGY_AND_COMPUTING__ARTIFICIAL_INTELLIGENCE",
+"INTEREST__TECHNOLOGY_AND_COMPUTING__AUGMENTED_REALITY",
+"INTEREST__TECHNOLOGY_AND_COMPUTING__COMPUTING",
+"INTEREST__TECHNOLOGY_AND_COMPUTING__CONSUMER_ELECTRONICS",
+"INTEREST__TECHNOLOGY_AND_COMPUTING__ROBOTICS",
+"INTEREST__TECHNOLOGY_AND_COMPUTING__VIRTUAL_REALITY",
+"INTEREST__TELEVISION__ANIMATION_TV",
+"INTEREST__TELEVISION__CHILDRENS_TV",
+"INTEREST__TELEVISION__COMEDY_TV",
+"INTEREST__TELEVISION__DRAMA_TV",
+"INTEREST__TELEVISION__FACTUAL_TV",
+"INTEREST__TELEVISION__HOLIDAY_TV",
+"INTEREST__TELEVISION__MUSIC_TV",
+"INTEREST__TELEVISION__REALITY_TV",
+"INTEREST__TELEVISION__SCIENCE_FICTION_TV",
+"INTEREST__TELEVISION__SOAP_OPERA_TV",
+"INTEREST__TELEVISION__SPECIAL_INTEREST_TV",
+"INTEREST__TELEVISION__SPORTS_TV",
+"INTEREST__TRAVEL__ADVENTURE_TRAVEL",
+"INTEREST__TRAVEL__AFRICA_TRAVEL",
+"INTEREST__TRAVEL__ASIA_TRAVEL",
+"INTEREST__TRAVEL__AUSTRALIA_AND_OCEANIA_TRAVEL",
+"INTEREST__TRAVEL__BEACH_TRAVEL",
+"INTEREST__TRAVEL__CAMPING",
+"INTEREST__TRAVEL__DAY_TRIPS",
+"INTEREST__TRAVEL__EUROPE_TRAVEL",
+"INTEREST__TRAVEL__FAMILY_TRAVEL",
+"INTEREST__TRAVEL__NORTH_AMERICA_TRAVEL",
+"INTEREST__TRAVEL__POLAR_TRAVEL",
+"INTEREST__TRAVEL__ROAD_TRIPS",
+"INTEREST__TRAVEL__SOUTH_AMERICA_TRAVEL",
+"INTEREST__VIDEO_GAMING__CONSOLE_GAMES",
+"INTEREST__VIDEO_GAMING__ESPORTS",
+"INTEREST__VIDEO_GAMING__MOBILE_GAMES",
+"INTEREST__VIDEO_GAMING__PC_GAMES",
+"INTEREST__VIDEO_GAMING__VIDEO_GAME_GENRES",
+"DEMOGRAPHIC__EDUCATION_AND_OCCUPATION__HIGH_SCHOOL_GRADUATE",
+"DEMOGRAPHIC__EDUCATION_AND_OCCUPATION__ASSOCIATES_DEGREE",
+"DEMOGRAPHIC__EDUCATION_AND_OCCUPATION__BACHELORS_DEGREE",
+"DEMOGRAPHIC__EDUCATION_AND_OCCUPATION__GRADUATE_DEGREE_AND_ABOVE",
+"DEMOGRAPHIC__EDUCATION_AND_OCCUPATION__EDUCATION_OTHER",
+"DEMOGRAPHIC__AGE_RANGE__18_TO_24",
+"DEMOGRAPHIC__AGE_RANGE__25_TO_34",
+"DEMOGRAPHIC__AGE_RANGE__35_TO_44",
+"DEMOGRAPHIC__AGE_RANGE__45_TO_54",
+"DEMOGRAPHIC__AGE_RANGE__55_AND_ABOVE",
+"DEMOGRAPHIC__HOUSEHOLD_DATA__LESS_THAN_10000",
+"DEMOGRAPHIC__HOUSEHOLD_DATA__10000_TO_49999",
+"DEMOGRAPHIC__HOUSEHOLD_DATA__50000_TO_149999",
+"DEMOGRAPHIC__HOUSEHOLD_DATA__150000_TO_249999",
+"DEMOGRAPHIC__HOUSEHOLD_DATA__250000_AND_ABOVE",
+"DEMOGRAPHIC__HOUSEHOLD_DATA__LESS_THAN_50000",
+"DEMOGRAPHIC__HOUSEHOLD_DATA__1_ADULT",
+"DEMOGRAPHIC__HOUSEHOLD_DATA__2_ADULTS",
+"DEMOGRAPHIC__HOUSEHOLD_DATA__3_AND_ABOVE_ADULTS",
+"DEMOGRAPHIC__HOUSEHOLD_DATA__0_CHILD",
+"DEMOGRAPHIC__HOUSEHOLD_DATA__1_CHILD",
+"DEMOGRAPHIC__HOUSEHOLD_DATA__2_CHILDREN",
+"DEMOGRAPHIC__HOUSEHOLD_DATA__3_AND_ABOVE_CHILDREN",
+"DEMOGRAPHIC__EDUCATION_AND_OCCUPATION__RETIRED",
+"DEMOGRAPHIC__EDUCATION_AND_OCCUPATION__STUDENT",
+"DEMOGRAPHIC__EDUCATION_AND_OCCUPATION__PART_TIME",
+"DEMOGRAPHIC__EDUCATION_AND_OCCUPATION__FULL_TIME",
+"DEMOGRAPHIC__EDUCATION_AND_OCCUPATION__SELF_EMPLOYED",
+"DEMOGRAPHIC__EDUCATION_AND_OCCUPATION__UNEMPLOYED_JOB_SEEKER",
+"PURCHASE_INTENT__BEAUTY",
+"PURCHASE_INTENT__CLOTHING",
+"PURCHASE_INTENT__CREDIT_CARDS",
+"PURCHASE_INTENT__ELECTRONICS",
+"PURCHASE_INTENT__HOME_AND_GARDEN_PRODUCTS",
+"PURCHASE_INTENT__HOUSEHOLD_APPLIANCES",
+"PURCHASE_INTENT__INSURANCE",
+"PURCHASE_INTENT__NEW_OR_PRE_OWNED_VEHICLES",
+"PURCHASE_INTENT__NONE_OF_THE_ABOVE",
+"DIGITAL_SUBSCRIPTION_BENEFITS__ACCESS_TO_EXCLUSIVE_CONTENT",
+"DIGITAL_SUBSCRIPTION_BENEFITS__ANYTIME_CANCELLATION",
+"DIGITAL_SUBSCRIPTION_BENEFITS__DISCOUNTED_SUBSCRIPTION_PLANS",
+"DIGITAL_SUBSCRIPTION_BENEFITS__EARLY_ACCESS",
+"DIGITAL_SUBSCRIPTION_BENEFITS__SHARED_ACCESS"
+],
+"enumDeprecated": [
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+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,
+false,
+false,
+false,
+false,
+false
+],
+"enumDescriptions": [
+"Unspecified answer category.",
+"Interest | Academic Interests.",
+"Interest | Automotive.",
+"Interest | Books and Literature.",
+"Interest | Business and Finance.",
+"Interest | Careers.",
+"Interest | Family and Relationships.",
+"Interest | Fine Art.",
+"Interest | Food & Drink.",
+"Interest | Health and Medical Services.",
+"Interest | Healthy Living.",
+"Interest | Hobbies & Interests.",
+"Interest | Home & Garden.",
+"Interest | Medical Health.",
+"Interest | Movies.",
+"Interest | Music and Audio.",
+"Interest | News and Politics.",
+"Interest | Personal Finance.",
+"Interest | Pets.",
+"Interest | Pharmaceuticals, Conditions, and Symptoms.",
+"Interest | Pop Culture.",
+"Interest | Real Estate.",
+"Interest | Shopping.",
+"Interest | Sports.",
+"Interest | Style & Fashion.",
+"Interest | Technology & Computing.",
+"Interest | Television.",
+"Interest | Travel.",
+"Interest | Video Gaming.",
+"Interest | Academic Interests | Arts and Humanities.",
+"Interest | Academic Interests | Language Learning.",
+"Interest | Academic Interests | Life Sciences.",
+"Interest | Academic Interests | Physical Science and Engineering.",
+"Interest | Academic Interests | Social Sciences.",
+"Interest | Automotive | Auto Buying and Selling.",
+"Interest | Automotive | Auto Shows.",
+"Interest | Automotive | Auto Technology.",
+"Interest | Automotive | Budget Cars.",
+"Interest | Automotive | Car Culture.",
+"Interest | Automotive | Classic Cars.",
+"Interest | Automotive | Concept Cars.",
+"Interest | Automotive | Dash Cam Videos.",
+"Interest | Automotive | Driverless Cars.",
+"Interest | Automotive | Green Vehicles.",
+"Interest | Automotive | Luxury Cars.",
+"Interest | Automotive | Motorcycles.",
+"Interest | Automotive | Performance Cars.",
+"Interest | Automotive | Scooters.",
+"Interest | Books and Literature | Art and Photography Books.",
+"Interest | Books and Literature | Biographies.",
+"Interest | Books and Literature | Children's Literature.",
+"Interest | Books and Literature | Comics and Graphic Novels.",
+"Interest | Books and Literature | Cookbooks.",
+"Interest | Books and Literature | Fiction.",
+"Interest | Books and Literature | Poetry.",
+"Interest | Books and Literature | Travel Books.",
+"Interest | Books and Literature | Young Adult Literature.",
+"Interest | Business and Finance | Business.",
+"Interest | Business and Finance | Economy.",
+"Interest | Business and Finance | Industries.",
+"Interest | Careers | Apprenticeships.",
+"Interest | Careers | Career Advice.",
+"Interest | Careers | Career Planning.",
+"Interest | Careers | Remote Working.",
+"Interest | Careers | Vocational Training.",
+"Interest | Education | Adult Education.",
+"Interest | Education | Online Education.",
+"Interest | Family and Relationships | Parenting.",
+"Interest | Fine Art | Costume.",
+"Interest | Fine Art | Dance.",
+"Interest | Fine Art | Design.",
+"Interest | Fine Art | Digital Arts.",
+"Interest | Fine Art | Fine Art Photography.",
+"Interest | Fine Art | Modern Art.",
+"Interest | Fine Art | Opera.",
+"Interest | Fine Art | Theater.",
+"Interest | Food & Drink | Alcoholic Beverages.",
+"Interest | Food & Drink | Barbecues and Grilling.",
+"Interest | Food & Drink | Cooking.",
+"Interest | Food & Drink | Desserts and Baking.",
+"Interest | Food & Drink | Dining Out.",
+"Interest | Food & Drink | Food Allergies.",
+"Interest | Food & Drink | Food Movements.",
+"Interest | Food & Drink | Healthy Cooking and Eating.",
+"Interest | Food & Drink | Non-Alcoholic Beverages.",
+"Interest | Food & Drink | Vegan Diets.",
+"Interest | Food & Drink | Vegetarian Diets.",
+"Interest | Food & Drink | World Cuisines.",
+"Interest | Health and Medical Services | Health & Pharma.",
+"Interest | Healthy Living | Children's Health.",
+"Interest | Healthy Living | Fitness and Exercise.",
+"Interest | Healthy Living | Men's Health.",
+"Interest | Healthy Living | Nutrition.",
+"Interest | Healthy Living | Senior Health.",
+"Interest | Healthy Living | Weight Loss.",
+"Interest | Healthy Living | Wellness.",
+"Interest | Healthy Living | Women's Health.",
+"Interest | Hobbies & Interests | Antiquing and Antiques.",
+"Interest | Hobbies & Interests | Arts and Crafts.",
+"Interest | Hobbies & Interests | Beekeeping.",
+"Interest | Hobbies & Interests | Birdwatching.",
+"Interest | Hobbies & Interests | Cigars.",
+"Interest | Hobbies & Interests | Collecting.",
+"Interest | Hobbies & Interests | Content Production.",
+"Interest | Hobbies & Interests | Games and Puzzles.",
+"Interest | Hobbies & Interests | Genealogy and Ancestry.",
+"Interest | Hobbies & Interests | Magic and Illusion.",
+"Interest | Hobbies & Interests | Model Toys.",
+"Interest | Hobbies & Interests | Musical Instruments.",
+"Interest | Hobbies & Interests | Paranormal Phenomena.",
+"Interest | Hobbies & Interests | Radio Control.",
+"Interest | Hobbies & Interests | Sci-fi and Fantasy.",
+"Interest | Hobbies & Interests | Workshops and Classes.",
+"Interest | Home & Garden | Gardening.",
+"Interest | Home & Garden | Home Entertaining.",
+"Interest | Home & Garden | Home Improvement.",
+"Interest | Home & Garden | Interior Decorating.",
+"Interest | Home & Garden | Landscaping.",
+"Interest | Home & Garden | Outdoor Decorating.",
+"Interest | Home & Garden | Remodeling & Construction.",
+"Interest | Home & Garden | Smart Home.",
+"Interest | Movies | Action and Adventure Movies.",
+"Interest | Movies | Animation Movies.",
+"Interest | Movies | Comedy Movies.",
+"Interest | Movies | Crime and Mystery Movies.",
+"Interest | Movies | Documentary Movies.",
+"Interest | Movies | Drama Movies.",
+"Interest | Movies | Family and Children Movies.",
+"Interest | Movies | Fantasy Movies.",
+"Interest | Movies | Horror Movies.",
+"Interest | Movies | Indie and Arthouse Movies.",
+"Interest | Movies | Romance Movies.",
+"Interest | Movies | Science Fiction Movies.",
+"Interest | Movies | World Movies.",
+"Interest | Music and Audio | Adult Album Alternative.",
+"Interest | Music and Audio | Adult Contemporary Music.",
+"Interest | Music and Audio | Alternative Music.",
+"Interest | Music and Audio | Blues.",
+"Interest | Music and Audio | Children's Music.",
+"Interest | Music and Audio | Classic Hits.",
+"Interest | Music and Audio | Classical Music.",
+"Interest | Music and Audio | College Radio.",
+"Interest | Music and Audio | Comedy (Music and Audio).",
+"Interest | Music and Audio | Contemporary Hits/Pop/Top 40.",
+"Interest | Music and Audio | Country Music.",
+"Interest | Music and Audio | Dance and Electronic Music.",
+"Interest | Music and Audio | Gospel Music.",
+"Interest | Music and Audio | Hip Hop Music.",
+"Interest | Music and Audio | Inspirational/New Age Music.",
+"Interest | Music and Audio | Jazz.",
+"Interest | Music and Audio | Oldies/Adult Standards.",
+"Interest | Music and Audio | R&B/Soul/Funk.",
+"Interest | Music and Audio | Reggae.",
+"Interest | Music and Audio | Religious (Music and Audio).",
+"Interest | Music and Audio | Rock Music.",
+"Interest | Music and Audio | Songwriters/Folk.",
+"Interest | Music and Audio | Soundtracks, TV and Showtunes.",
+"Interest | Music and Audio | Sports Radio.",
+"Interest | Music and Audio | Talk Radio.",
+"Interest | Music and Audio | Urban Contemporary Music.",
+"Interest | Music and Audio | Variety (Music and Audio).",
+"Interest | Music and Audio | World/International Music.",
+"Interest | News and Politics | Crime.",
+"Interest | News and Politics | Disasters.",
+"Interest | News and Politics | International News.",
+"Interest | News and Politics | Law.",
+"Interest | News and Politics | Local News.",
+"Interest | News and Politics | National News.",
+"Interest | News and Politics | Politics.",
+"Interest | News and Politics | Weather.",
+"Interest | Personal Finance | Frugal Living.",
+"Interest | Personal Finance | Insurance.",
+"Interest | Personal Finance | Personal Debt.",
+"Interest | Personal Finance | Personal Investing.",
+"Interest | Personal Finance | Personal Taxes.",
+"Interest | Personal Finance | Retirement Planning.",
+"Interest | Pets | Birds.",
+"Interest | Pets | Cats.",
+"Interest | Pets | Dogs.",
+"Interest | Pets | Fish and Aquariums.",
+"Interest | Pets | Horses and Equine.",
+"Interest | Pets | Large Animals.",
+"Interest | Pets | Pet Adoptions.",
+"Interest | Pets | Reptiles.",
+"Interest | Pop Culture | Humor and Satire.",
+"Interest | Real Estate | Apartments.",
+"Interest | Real Estate | Developmental Sites.",
+"Interest | Real Estate | Hotel Properties.",
+"Interest | Real Estate | Houses.",
+"Interest | Real Estate | Industrial Property.",
+"Interest | Real Estate | Land and Farms.",
+"Interest | Real Estate | Office Property.",
+"Interest | Real Estate | Real Estate Buying and Selling.",
+"Interest | Real Estate | Real Estate Renting and Leasing.",
+"Interest | Real Estate | Retail Property.",
+"Interest | Real Estate | Vacation Properties.",
+"Interest | Sports | American Football.",
+"Interest | Sports | Australian Rules Football.",
+"Interest | Sports | Auto Racing.",
+"Interest | Sports | Badminton.",
+"Interest | Sports | Baseball.",
+"Interest | Sports | Basketball.",
+"Interest | Sports | Beach Volleyball.",
+"Interest | Sports | Bodybuilding.",
+"Interest | Sports | Bowling.",
+"Interest | Sports | Boxing.",
+"Interest | Sports | Cheerleading.",
+"Interest | Sports | College Sports.",
+"Interest | Sports | Cricket.",
+"Interest | Sports | Cycling.",
+"Interest | Sports | Darts.",
+"Interest | Sports | Disabled Sports.",
+"Interest | Sports | Diving.",
+"Interest | Sports | Equine Sports.",
+"Interest | Sports | Extreme Sports.",
+"Interest | Sports | Fantasy Sports.",
+"Interest | Sports | Field Hockey.",
+"Interest | Sports | Figure Skating.",
+"Interest | Sports | Fishing Sports.",
+"Interest | Sports | Golf.",
+"Interest | Sports | Gymnastics.",
+"Interest | Sports | Hunting and Shooting.",
+"Interest | Sports | Ice Hockey.",
+"Interest | Sports | Inline Skating.",
+"Interest | Sports | Lacrosse.",
+"Interest | Sports | Martial Arts.",
+"Interest | Sports | Olympic Sports.",
+"Interest | Sports | Poker and Professional Gambling.",
+"Interest | Sports | Rodeo.",
+"Interest | Sports | Rowing.",
+"Interest | Sports | Rugby.",
+"Interest | Sports | Sailing.",
+"Interest | Sports | Skiing.",
+"Interest | Sports | Snooker/Pool/Billiards.",
+"Interest | Sports | Soccer.",
+"Interest | Sports | Softball.",
+"Interest | Sports | Sports Equipment.",
+"Interest | Sports | Squash.",
+"Interest | Sports | Swimming.",
+"Interest | Sports | Table Tennis.",
+"Interest | Sports | Tennis.",
+"Interest | Sports | Track and Field.",
+"Interest | Sports | Volleyball.",
+"Interest | Sports | Walking.",
+"Interest | Sports | Water Polo.",
+"Interest | Sports | Weightlifting.",
+"Interest | Sports | Wrestling.",
+"Interest | Style & Fashion | Beauty.",
+"Interest | Style & Fashion | Body Art.",
+"Interest | Style & Fashion | Children's Clothing.",
+"Interest | Style & Fashion | Designer Clothing.",
+"Interest | Style & Fashion | Fashion Trends.",
+"Interest | Style & Fashion | High Fashion.",
+"Interest | Style & Fashion | Men's Fashion.",
+"Interest | Style & Fashion | Personal Care.",
+"Interest | Style & Fashion | Street Style.",
+"Interest | Style & Fashion | Women's Fashion.",
+"Interest | Technology & Computing | Artificial Intelligence.",
+"Interest | Technology & Computing | Augmented Reality.",
+"Interest | Technology & Computing | Computing.",
+"Interest | Technology & Computing | Consumer Electronics.",
+"Interest | Technology & Computing | Robotics.",
+"Interest | Technology & Computing | Virtual Reality.",
+"Interest | Television | Animation TV.",
+"Interest | Television | Children's TV.",
+"Interest | Television | Comedy TV.",
+"Interest | Television | Drama TV.",
+"Interest | Television | Factual TV.",
+"Interest | Television | Holiday TV.",
+"Interest | Television | Music TV.",
+"Interest | Television | Reality TV.",
+"Interest | Television | Science Fiction TV.",
+"Interest | Television | Soap Opera TV.",
+"Interest | Television | Special Interest TV.",
+"Interest | Television | Sports TV.",
+"Interest | Travel | Adventure Travel.",
+"Interest | Travel | Africa Travel.",
+"Interest | Travel | Asia Travel.",
+"Interest | Travel | Australia and Oceania Travel.",
+"Interest | Travel | Beach Travel.",
+"Interest | Travel | Camping.",
+"Interest | Travel | Day Trips.",
+"Interest | Travel | Europe Travel.",
+"Interest | Travel | Family Travel.",
+"Interest | Travel | North America Travel.",
+"Interest | Travel | Polar Travel.",
+"Interest | Travel | Road Trips.",
+"Interest | Travel | South America Travel.",
+"Interest | Video Gaming | Console Games.",
+"Interest | Video Gaming | eSports.",
+"Interest | Video Gaming | Mobile Games.",
+"Interest | Video Gaming | PC Games.",
+"Interest | Video Gaming | Video Game Genres.",
+"Demographic | Education & Occupation | High school graduate.",
+"Demographic | Education & Occupation | Associate's degree.",
+"Demographic | Education & Occupation | Bachelor's degree.",
+"Demographic | Education & Occupation | Graduate degree and above.",
+"Demographic | Education & Occupation | Other.",
+"Demographic | Age Range | 18-24.",
+"Demographic | Age Range | 25-34.",
+"Demographic | Age Range | 35-44.",
+"Demographic | Age Range | 45-54.",
+"Demographic | Age Range | 55+.",
+"Demographic | Household Data | Less than $10,000.",
+"Demographic | Household Data | $10,000-$49,999.",
+"Demographic | Household Data | $50,000-$149,999.",
+"Demographic | Household Data | $150,000-$249,999.",
+"Demographic | Household Data | $250,000+.",
+"Deprecated: Demographic | Household Data | Less than $50,000.",
+"Demographic | Household Data | 1 Adult.",
+"Demographic | Household Data | 2 Adults.",
+"Demographic | Household Data | 3+ Adults.",
+"Demographic | Household Data | 0 Child.",
+"Demographic | Household Data | 1 Child.",
+"Demographic | Household Data | 2 Children.",
+"Demographic | Household Data | 3+ Children.",
+"Demographic | Education & Occupation | Retired.",
+"Demographic | Education & Occupation | Student.",
+"Demographic | Education & Occupation | Part-Time.",
+"Demographic | Education & Occupation | Full-Time.",
+"Demographic | Education & Occupation | Self-Employed.",
+"Demographic | Education & Occupation | Unemployed / Job Seeker.",
+"Purchase Intent | Beauty.",
+"Purchase Intent | Clothing.",
+"Purchase Intent | Credit Cards.",
+"Purchase Intent | Electronics.",
+"Purchase Intent | Home and Garden Products.",
+"Purchase Intent | Household Appliances.",
+"Purchase Intent | Insurance.",
+"Purchase Intent | New / Pre-owned vehicles.",
+"Purchase Intent | None of the above.",
+"Digital Subscription Benefits | Access to Exclusive Content.",
+"Digital Subscription Benefits | Anytime Cancellation.",
+"Digital Subscription Benefits | Discounted Subscription Plans.",
+"Digital Subscription Benefits | Early Access.",
+"Digital Subscription Benefits | Shared Access."
+],
+"readOnly": true,
+"type": "string"
+},
+"categoryLabel": {
+"description": "Output only. Text label used for aggregating responses by category in analytics.",
+"readOnly": true,
+"type": "string"
+},
+"displayText": {
+"description": "Output only. Localized answer choice text displayed to readers.",
+"readOnly": true,
+"type": "string"
+},
+"id": {
+"description": "Output only. Unique identifier of the answer choice within the question.",
+"format": "int32",
+"readOnly": true,
+"type": "integer"
+}
+},
+"type": "object"
+},
 "CheckFreeAccessResponse": {
 "description": "Response message for CheckFreeAccess",
 "id": "CheckFreeAccessResponse",
@@ -527,21 +1599,65 @@
 "readOnly": true,
 "type": "string"
 },
+"surveyConfig": {
+"$ref": "SurveyConfig",
+"description": "Optional. Configuration specific to survey CTAs. Only populated if type is `SURVEY`."
+},
 "type": {
 "description": "Required. The type of this CTA.",
 "enum": [
 "TYPE_UNSPECIFIED",
-"NEWSLETTER_SIGNUP"
+"NEWSLETTER_SIGNUP",
+"SURVEY"
 ],
 "enumDescriptions": [
 "Unspecified CTA type.",
-"CTA for newsletter subscription signup."
+"CTA for newsletter subscription signup.",
+"CTA for reader surveys."
 ],
 "type": "string"
 }
 },
 "type": "object"
 },
+"CustomAnswerChoice": {
+"description": "An answer choice for a custom survey question.",
+"id": "CustomAnswerChoice",
+"properties": {
+"displayText": {
+"description": "Required. The display text of the answer choice shown to readers.",
+"type": "string"
+}
+},
+"type": "object"
+},
+"CustomQuestion": {
+"description": "A custom question defined by the publisher.",
+"id": "CustomQuestion",
+"properties": {
+"answerChoices": {
+"description": "Required. Ordered list of answer choices for the custom question (2-5 items).",
+"items": {
+"$ref": "CustomAnswerChoice"
+},
+"type": "array"
+},
+"categoryLabel": {
+"description": "Optional. Reporting category label sent to Google Analytics (up to 100 characters).",
+"type": "string"
+},
+"displayText": {
+"description": "Required. The question prompt displayed to readers.",
+"type": "string"
+},
+"id": {
+"description": "Output only. Server-assigned unique identifier for the custom question.",
+"readOnly": true,
+"type": "string"
+}
+},
+"type": "object"
+},
 "DomainProperty": {
 "description": "Represents a domain property associated with a publication, typically used to verify ownership and scope access.",
 "id": "DomainProperty",
@@ -645,6 +1761,26 @@
 },
 "type": "object"
 },
+"PresetQuestion": {
+"description": "A preset question referencing a template in the survey question catalog.",
+"id": "PresetQuestion",
+"properties": {
+"answerIds": {
+"description": "Optional. Selected answer choice IDs from the question template. Required (2-5 unique IDs) when the catalog question is `CONFIGURABLE_CHOICES`, and must be omitted for `FIXED_CHOICES`.",
+"items": {
+"format": "int32",
+"type": "integer"
+},
+"type": "array"
+},
+"questionId": {
+"description": "Required. ID of the question template from `SurveyQuestionCatalog`.",
+"format": "int32",
+"type": "integer"
+}
+},
+"type": "object"
+},
 "Publication": {
 "description": "Represents a publisher's publication in Reader Revenue Manager.",
 "id": "Publication",
@@ -766,6 +1902,81 @@
 },
 "type": "object"
 },
+"QuestionTemplate": {
+"description": "A predefined question template in the survey question catalog.",
+"id": "QuestionTemplate",
+"properties": {
+"answerChoices": {
+"description": "Output only. Possible answer choices for this question.",
+"items": {
+"$ref": "AnswerChoiceTemplate"
+},
+"readOnly": true,
+"type": "array"
+},
+"category": {
+"description": "Output only. Category of the question based on the IAB Audience Taxonomy.",
+"enum": [
+"QUESTION_CATEGORY_UNSPECIFIED",
+"INTEREST",
+"DEMOGRAPHIC__EDUCATION_AND_OCCUPATION__EDUCATION",
+"DEMOGRAPHIC__AGE_RANGE",
+"PURCHASE_INTENT",
+"DEMOGRAPHIC__HOUSEHOLD_DATA__HOUSEHOLD_INCOME_USD",
+"DEMOGRAPHIC__HOUSEHOLD_DATA__NUMBER_OF_ADULTS",
+"DEMOGRAPHIC__HOUSEHOLD_DATA__NUMBER_OF_CHILDREN",
+"DEMOGRAPHIC__EDUCATION_AND_OCCUPATION__EMPLOYMENT_STATUS",
+"DIGITAL_SUBSCRIPTION_BENEFITS"
+],
+"enumDescriptions": [
+"Unspecified question category.",
+"Interest.",
+"Demographic | Education & Occupation | Education.",
+"Demographic | Age Range.",
+"Purchase Intent.",
+"Demographic | Household Data | Household Income (USD).",
+"Demographic | Household Data | Number of Adults.",
+"Demographic | Household Data | Number of Children.",
+"Demographic | Education & Occupation | Employment Status.",
+"Digital Subscription Benefits."
+],
+"readOnly": true,
+"type": "string"
+},
+"categoryLabel": {
+"description": "Output only. Text label used for aggregating responses by category in analytics.",
+"readOnly": true,
+"type": "string"
+},
+"configurationType": {
+"description": "Output only. The type of answer choice configuration for this question.",
+"enum": [
+"QUESTION_CONFIGURATION_TYPE_UNSPECIFIED",
+"FIXED_CHOICES",
+"CONFIGURABLE_CHOICES"
+],
+"enumDescriptions": [
+"Unspecified question configuration type.",
+"Fixed set of answer choices for this question. Publishers are not able to select their own.",
+"Publishers are able to select answer choices from `AnswerChoiceTemplate` for the question."
+],
+"readOnly": true,
+"type": "string"
+},
+"displayText": {
+"description": "Output only. Localized question text displayed to readers.",
+"readOnly": true,
+"type": "string"
+},
+"id": {
+"description": "Output only. Unique identifier of the question template.",
+"format": "int32",
+"readOnly": true,
+"type": "integer"
+}
+},
+"type": "object"
+},
 "RrmProduct": {
 "description": "Configuration and status of the Reader Revenue Manager (RRM) product for a publication.",
 "id": "RrmProduct",
@@ -817,6 +2028,58 @@
 },
 "type": "object"
 },
+"SurveyConfig": {
+"description": "Configuration for survey calls-to-action (CTAs).",
+"id": "SurveyConfig",
+"properties": {
+"customMessage": {
+"description": "Optional. Header prompt shown to readers. If omitted, the server populates the default prompt localized to the parent publication's configured primary language.",
+"type": "string"
+},
+"questions": {
+"description": "Optional. Ordered list of questions presented in the survey (1-3 items when `ACTIVE`; 0-3 when `DRAFT`).",
+"items": {
+"$ref": "SurveyQuestion"
+},
+"type": "array"
+}
+},
+"type": "object"
+},
+"SurveyQuestion": {
+"description": "A single question within a survey, which can be either a preset question from the catalog or a custom publisher-defined question.",
+"id": "SurveyQuestion",
+"properties": {
+"customQuestion": {
+"$ref": "CustomQuestion",
+"description": "Optional. A custom question defined by the publisher."
+},
+"presetQuestion": {
+"$ref": "PresetQuestion",
+"description": "Optional. A question selected from the preset question catalog."
+}
+},
+"type": "object"
+},
+"SurveyQuestionCatalog": {
+"description": "Represents the catalog of predefined survey questions and localized answer choices available for a publication.",
+"id": "SurveyQuestionCatalog",
+"properties": {
+"name": {
+"description": "Identifier. The resource name of the survey question catalog. Format: `organizations/{organization}/publications/{publication}/surveyQuestionCatalog`.",
+"type": "string"
+},
+"questions": {
+"description": "Output only. The list of available predefined question templates.",
+"items": {
+"$ref": "QuestionTemplate"
+},
+"readOnly": true,
+"type": "array"
+}
+},
+"type": "object"
+},
 "TosAcceptance": {
 "description": "Details about the acceptance of the Terms of Service (TOS).",
 "id": "TosAcceptance",

From 41b2f8033f4b786939cc5cc980c2ce792d232977 Mon Sep 17 00:00:00 2001
From: Yoshi Automation 
Date: Tue, 20 Oct 2026 07:24:03 +0000
Subject: [PATCH 34/34] chore(docs): Add new discovery artifacts and artifacts
 with minor updates

---
 ...r_v1.accessPolicies.servicePerimeters.html | 100 +++++-----
 ...ects.locations.dataExchanges.listings.html |   2 +-
 ...ingbudgets_v1.billingAccounts.budgets.html |  24 +--
 ...sinessprofileperformance_v1.locations.html |   2 +
 ...anagement_v1.customers.chromeBrowsers.html |   2 +-
 docs/dyn/cloudasset_v1.assets.html            |  20 +-
 docs/dyn/cloudasset_v1.v1.html                |  40 ++--
 .../dyn/cloudasset_v1beta1.organizations.html |  20 +-
 docs/dyn/cloudasset_v1beta1.projects.html     |  20 +-
 docs/dyn/cloudasset_v1p5beta1.assets.html     |  20 +-
 .../dyn/cloudtasks_v2.projects.locations.html |  14 +-
 ...oudtasks_v2.projects.locations.queues.html |  18 +-
 ...ks_v2.projects.locations.queues.tasks.html |   2 +-
 docs/dyn/dataflow_v1b3.projects.jobs.html     |  14 +-
 ...v1b3.projects.locations.flexTemplates.html |   2 +-
 ...dataflow_v1b3.projects.locations.jobs.html |  12 +-
 ...low_v1b3.projects.locations.templates.html |   4 +-
 .../dyn/dataflow_v1b3.projects.templates.html |   4 +-
 ...rgetingTypes.assignedTargetingOptions.html |   4 -
 ...rgetingTypes.assignedTargetingOptions.html |   4 -
 ...ideo_v2.advertisers.youtubeAdGroupAds.html |  48 ++---
 ...rgetingTypes.assignedTargetingOptions.html |   2 -
 ...rgetingTypes.assignedTargetingOptions.html |   4 -
 ...eo_v2.targetingTypes.targetingOptions.html |   3 -
 ...isplayvideo_v3.advertisers.adGroupAds.html | 182 +++++++++---------
 .../displayvideo_v3.advertisers.adGroups.html |  12 +-
 ...rgetingTypes.assignedTargetingOptions.html |   4 -
 ...rgetingTypes.assignedTargetingOptions.html |   4 -
 ...rgetingTypes.assignedTargetingOptions.html |   4 -
 ...rgetingTypes.assignedTargetingOptions.html |   4 -
 ...eo_v3.targetingTypes.targetingOptions.html |   3 -
 ...isplayvideo_v4.advertisers.adGroupAds.html | 182 +++++++++---------
 .../displayvideo_v4.advertisers.adGroups.html |  12 +-
 docs/dyn/dns_v1.outboundEndpoints.html        |   8 +-
 docs/dyn/dns_v1beta2.outboundEndpoints.html   |   8 +-
 ....projects.locations.publishers.models.html |  16 +-
 ...gkehub_v1.projects.locations.features.html | 120 ++++++------
 ...b_v1alpha.projects.locations.features.html | 120 ++++++------
 ...ub_v1beta.projects.locations.features.html | 120 ++++++------
 ...ojects.locations.memberships.features.html |  80 ++++----
 ...ojects.locations.memberships.features.html |  80 ++++----
 ...ojects.locations.memberships.features.html |  80 ++++----
 ...s.integrations.executions.suspensions.html |   4 +-
 ...s.integrations.executions.suspensions.html |   4 +-
 ...pi_products_v1.accounts.productInputs.html |   8 +-
 ...hantapi_products_v1.accounts.products.html |   4 +-
 ...s.locations.global_.connectivityTests.html |   8 -
 ...s.locations.global_.connectivityTests.html |   8 -
 docs/dyn/policytroubleshooter_v3beta.iam.html |   4 +-
 .../dyn/pubsub_v1.projects.subscriptions.html |  12 +-
 ....locations.catalogs.branches.products.html |  16 +-
 ...rojects.locations.catalogs.placements.html |   6 +-
 ...cts.locations.catalogs.servingConfigs.html |   6 +-
 ...rojects.locations.catalogs.userEvents.html |  12 +-
 ....projects.locations.catalogs.branches.html |   4 +-
 ....locations.catalogs.branches.products.html |  16 +-
 ...rojects.locations.catalogs.placements.html |   6 +-
 ...cts.locations.catalogs.servingConfigs.html |   6 +-
 ...rojects.locations.catalogs.userEvents.html |  12 +-
 ....locations.catalogs.branches.products.html |  16 +-
 ...rojects.locations.catalogs.placements.html |   6 +-
 ...cts.locations.catalogs.servingConfigs.html |   6 +-
 ...rojects.locations.catalogs.userEvents.html |  12 +-
 docs/dyn/youtube_v3.liveChatMessages.html     | 172 ++++++++---------
 docs/dyn/youtube_v3.videos.html               |  30 +--
 ...utube_v3.youtube.v3.liveChat.messages.html |  72 +++----
 .../documents/accesscontextmanager.v1.json    |  14 +-
 .../documents/analyticshub.v1.json            |   4 +-
 .../documents/androidmanagement.v1.json       |   4 +-
 .../documents/billingbudgets.v1.json          |   6 +-
 .../businessprofileperformance.v1.json        |  11 +-
 .../documents/chromemanagement.v1.json        |   4 +-
 .../documents/cloudasset.v1.json              |  14 +-
 .../documents/cloudasset.v1beta1.json         |  14 +-
 .../documents/cloudasset.v1p1beta1.json       |  14 +-
 .../documents/cloudasset.v1p5beta1.json       |  14 +-
 .../documents/cloudasset.v1p7beta1.json       |  14 +-
 .../documents/cloudtasks.v2.json              |  14 +-
 .../discovery_cache/documents/compute.v1.json |   4 +-
 .../documents/dataflow.v1b3.json              |   4 +-
 .../documents/displayvideo.v2.json            |  60 +-----
 .../documents/displayvideo.v3.json            |  78 ++------
 .../documents/displayvideo.v4.json            |  32 +--
 .../discovery_cache/documents/dns.v1.json     |   4 +-
 .../documents/dns.v1beta2.json                |   4 +-
 .../documents/firebaseml.v2beta.json          |   6 +-
 .../discovery_cache/documents/gkehub.v1.json  |  12 +-
 .../documents/gkehub.v1alpha.json             |  12 +-
 .../documents/gkehub.v1beta.json              |  12 +-
 .../discovery_cache/documents/gkehub.v2.json  |  12 +-
 .../documents/gkehub.v2alpha.json             |  12 +-
 .../documents/gkehub.v2beta.json              |  12 +-
 .../documents/integrations.v1.json            |   4 +-
 .../documents/integrations.v2.json            |   4 +-
 .../documents/merchantapi.products_v1.json    |   6 +-
 .../documents/networkconnectivity.v1.json     |   8 +-
 .../documents/networkmanagement.v1.json       |   7 +-
 .../documents/networkmanagement.v1beta1.json  |   7 +-
 .../policytroubleshooter.v3beta.json          |   4 +-
 .../discovery_cache/documents/pubsub.v1.json  |   4 +-
 .../readerrevenuesubscriptionlinking.v1.json  |  65 +------
 .../discovery_cache/documents/retail.v2.json  |   4 +-
 .../documents/retail.v2alpha.json             |   4 +-
 .../documents/retail.v2beta.json              |   4 +-
 .../discovery_cache/documents/youtube.v3.json |  72 +++----
 105 files changed, 1137 insertions(+), 1321 deletions(-)

diff --git a/docs/dyn/accesscontextmanager_v1.accessPolicies.servicePerimeters.html b/docs/dyn/accesscontextmanager_v1.accessPolicies.servicePerimeters.html
index c9d7691b5c..3e98a99eff 100644
--- a/docs/dyn/accesscontextmanager_v1.accessPolicies.servicePerimeters.html
+++ b/docs/dyn/accesscontextmanager_v1.accessPolicies.servicePerimeters.html
@@ -184,7 +184,7 @@ 
Method Details

               "pscEndpoint": { # Specifies the Private Service Connect endpoint that an API call refers to. # A PrivateServiceConnectEndpoint that is allowed to access data outside the perimeter. The Private Service Connect endpoint may be in any organization, not just the organization that the perimeter is defined in.
                 "forwardingRule": "A String", # The full resource name of the global forwarding rule that identifies a Private Service Connect endpoint. Forwarding rule format: `//compute.googleapis.com/projects/{PROJECT_ID}/global/forwardingRules/{FORWARDING_RULE_ID}`.
               },
-              "resource": "A String", # A Google Cloud resource from the service perimeter that you want to allow to access data outside the perimeter. This field supports only projects. The project format is `projects/{project_number}`. You can't use `*` in this field to allow all Google Cloud resources.
+              "resource": "A String", # A Google Cloud resource from the service perimeter that you want to allow to access data outside the perimeter. This field supports projects, folders, and organizations in the form `projects/`, `folders/`, and `organizations/`. You can't use `*` in this field to allow all Google Cloud resources.
             },
           ],
         },
@@ -203,7 +203,7 @@ 
Method Details

               "serviceName": "A String", # The name of the API whose methods or permissions the IngressPolicy or EgressPolicy want to allow. A single ApiOperation with `service_name` field set to `*` will allow all methods AND permissions for all services.
             },
           ],
-          "resources": [ # A list of resources, currently only projects in the form `projects/`, that are allowed to be accessed by sources defined in the corresponding EgressFrom. A request matches if it contains a resource in this list. If `*` is specified for `resources`, then this EgressTo rule will authorize access to all resources outside the perimeter.
+          "resources": [ # A list of resources, currently projects, folders, and organizations in the form `projects/`, `folders/`, and `organizations/`, that are allowed to be accessed by sources defined in the corresponding EgressFrom. A request matches if it contains a resource in this list. If `*` is specified for `resources`, then this EgressTo rule will authorize access to all resources outside the perimeter.
             "A String",
           ],
           "roles": [ # IAM roles that represent the set of operations that the sources specified in the corresponding EgressFrom. are allowed to perform in this ServicePerimeter.
@@ -226,7 +226,7 @@ 
Method Details

               "pscEndpoint": { # Specifies the Private Service Connect endpoint that an API call refers to. # A PrivateServiceConnectEndpoint that is allowed to access the perimeter. The Private Service Connect endpoint may be in any organization, not just the organization that the perimeter is defined in.
                 "forwardingRule": "A String", # The full resource name of the global forwarding rule that identifies a Private Service Connect endpoint. Forwarding rule format: `//compute.googleapis.com/projects/{PROJECT_ID}/global/forwardingRules/{FORWARDING_RULE_ID}`.
               },
-              "resource": "A String", # A Google Cloud resource that is allowed to ingress the perimeter. Requests from these resources will be allowed to access perimeter data. Currently only projects and VPCs are allowed. Project format: `projects/{project_number}` VPC network format: `//compute.googleapis.com/projects/{PROJECT_ID}/global/networks/{NAME}`. The project may be in any Google Cloud organization, not just the organization that the perimeter is defined in. `*` is not allowed, the case of allowing all Google Cloud resources only is not supported.
+              "resource": "A String", # A Google Cloud resource that is allowed to ingress the perimeter. Requests from these resources will be allowed to access perimeter data. Currently projects, folders, organizations, and VPCs are allowed. Project format: `projects/{project_number}` Folder format: `folders/{folder_id}` Organization format: `organizations/{organization_id}` VPC network format: `//compute.googleapis.com/projects/{PROJECT_ID}/global/networks/{NAME}`. The project may be in any Google Cloud organization, not just the organization that the perimeter is defined in. `*` is not allowed, the case of allowing all Google Cloud resources only is not supported.
             },
           ],
         },
@@ -242,7 +242,7 @@ 
Method Details

               "serviceName": "A String", # The name of the API whose methods or permissions the IngressPolicy or EgressPolicy want to allow. A single ApiOperation with `service_name` field set to `*` will allow all methods AND permissions for all services.
             },
           ],
-          "resources": [ # A list of resources, currently only projects in the form `projects/`, protected by this ServicePerimeter that are allowed to be accessed by sources defined in the corresponding IngressFrom. If a single `*` is specified, then access to all resources inside the perimeter are allowed.
+          "resources": [ # A list of resources, currently projects, folders, and organizations in the form `projects/{project_number}`, `folders/{folder_id}`, and `organizations/{organization_id}`, protected by this ServicePerimeter that are allowed to be accessed by sources defined in the corresponding IngressFrom. If a single `*` is specified, then access to all resources inside the perimeter are allowed.
             "A String",
           ],
           "roles": [ # IAM roles that represent the set of operations that the sources specified in the corresponding IngressFrom are allowed to perform in this ServicePerimeter.
@@ -252,7 +252,7 @@ 
Method Details

         "title": "A String", # Optional. Human-readable title for the ingress rule. The title must be unique within the perimeter and can not exceed 100 characters. Within the access policy, the combined length of all rule titles must not exceed 240,000 characters.
       },
     ],
-    "resources": [ # A list of Google Cloud resources that are inside of the service perimeter. Currently only projects and VPCs are allowed. Project format: `projects/{project_number}` VPC network format: `//compute.googleapis.com/projects/{PROJECT_ID}/global/networks/{NAME}`.
+    "resources": [ # A list of Google Cloud resources that are inside of the service perimeter. Currently projects, folders, and VPCs are allowed. Project format: `projects/{project_number}` Folder format: `folders/{folder_id}` VPC network format: `//compute.googleapis.com/projects/{PROJECT_ID}/global/networks/{NAME}`.
       "A String",
     ],
     "restrictedServices": [ # Google Cloud services that are subject to the Service Perimeter restrictions. For example, if `storage.googleapis.com` is specified, access to the storage buckets inside the perimeter must meet the perimeter's access restrictions.
@@ -300,7 +300,7 @@ 
Method Details

               "pscEndpoint": { # Specifies the Private Service Connect endpoint that an API call refers to. # A PrivateServiceConnectEndpoint that is allowed to access data outside the perimeter. The Private Service Connect endpoint may be in any organization, not just the organization that the perimeter is defined in.
                 "forwardingRule": "A String", # The full resource name of the global forwarding rule that identifies a Private Service Connect endpoint. Forwarding rule format: `//compute.googleapis.com/projects/{PROJECT_ID}/global/forwardingRules/{FORWARDING_RULE_ID}`.
               },
-              "resource": "A String", # A Google Cloud resource from the service perimeter that you want to allow to access data outside the perimeter. This field supports only projects. The project format is `projects/{project_number}`. You can't use `*` in this field to allow all Google Cloud resources.
+              "resource": "A String", # A Google Cloud resource from the service perimeter that you want to allow to access data outside the perimeter. This field supports projects, folders, and organizations in the form `projects/`, `folders/`, and `organizations/`. You can't use `*` in this field to allow all Google Cloud resources.
             },
           ],
         },
@@ -319,7 +319,7 @@ 
Method Details

               "serviceName": "A String", # The name of the API whose methods or permissions the IngressPolicy or EgressPolicy want to allow. A single ApiOperation with `service_name` field set to `*` will allow all methods AND permissions for all services.
             },
           ],
-          "resources": [ # A list of resources, currently only projects in the form `projects/`, that are allowed to be accessed by sources defined in the corresponding EgressFrom. A request matches if it contains a resource in this list. If `*` is specified for `resources`, then this EgressTo rule will authorize access to all resources outside the perimeter.
+          "resources": [ # A list of resources, currently projects, folders, and organizations in the form `projects/`, `folders/`, and `organizations/`, that are allowed to be accessed by sources defined in the corresponding EgressFrom. A request matches if it contains a resource in this list. If `*` is specified for `resources`, then this EgressTo rule will authorize access to all resources outside the perimeter.
             "A String",
           ],
           "roles": [ # IAM roles that represent the set of operations that the sources specified in the corresponding EgressFrom. are allowed to perform in this ServicePerimeter.
@@ -342,7 +342,7 @@ 
Method Details

               "pscEndpoint": { # Specifies the Private Service Connect endpoint that an API call refers to. # A PrivateServiceConnectEndpoint that is allowed to access the perimeter. The Private Service Connect endpoint may be in any organization, not just the organization that the perimeter is defined in.
                 "forwardingRule": "A String", # The full resource name of the global forwarding rule that identifies a Private Service Connect endpoint. Forwarding rule format: `//compute.googleapis.com/projects/{PROJECT_ID}/global/forwardingRules/{FORWARDING_RULE_ID}`.
               },
-              "resource": "A String", # A Google Cloud resource that is allowed to ingress the perimeter. Requests from these resources will be allowed to access perimeter data. Currently only projects and VPCs are allowed. Project format: `projects/{project_number}` VPC network format: `//compute.googleapis.com/projects/{PROJECT_ID}/global/networks/{NAME}`. The project may be in any Google Cloud organization, not just the organization that the perimeter is defined in. `*` is not allowed, the case of allowing all Google Cloud resources only is not supported.
+              "resource": "A String", # A Google Cloud resource that is allowed to ingress the perimeter. Requests from these resources will be allowed to access perimeter data. Currently projects, folders, organizations, and VPCs are allowed. Project format: `projects/{project_number}` Folder format: `folders/{folder_id}` Organization format: `organizations/{organization_id}` VPC network format: `//compute.googleapis.com/projects/{PROJECT_ID}/global/networks/{NAME}`. The project may be in any Google Cloud organization, not just the organization that the perimeter is defined in. `*` is not allowed, the case of allowing all Google Cloud resources only is not supported.
             },
           ],
         },
@@ -358,7 +358,7 @@ 
Method Details

               "serviceName": "A String", # The name of the API whose methods or permissions the IngressPolicy or EgressPolicy want to allow. A single ApiOperation with `service_name` field set to `*` will allow all methods AND permissions for all services.
             },
           ],
-          "resources": [ # A list of resources, currently only projects in the form `projects/`, protected by this ServicePerimeter that are allowed to be accessed by sources defined in the corresponding IngressFrom. If a single `*` is specified, then access to all resources inside the perimeter are allowed.
+          "resources": [ # A list of resources, currently projects, folders, and organizations in the form `projects/{project_number}`, `folders/{folder_id}`, and `organizations/{organization_id}`, protected by this ServicePerimeter that are allowed to be accessed by sources defined in the corresponding IngressFrom. If a single `*` is specified, then access to all resources inside the perimeter are allowed.
             "A String",
           ],
           "roles": [ # IAM roles that represent the set of operations that the sources specified in the corresponding IngressFrom are allowed to perform in this ServicePerimeter.
@@ -368,7 +368,7 @@ 
Method Details

         "title": "A String", # Optional. Human-readable title for the ingress rule. The title must be unique within the perimeter and can not exceed 100 characters. Within the access policy, the combined length of all rule titles must not exceed 240,000 characters.
       },
     ],
-    "resources": [ # A list of Google Cloud resources that are inside of the service perimeter. Currently only projects and VPCs are allowed. Project format: `projects/{project_number}` VPC network format: `//compute.googleapis.com/projects/{PROJECT_ID}/global/networks/{NAME}`.
+    "resources": [ # A list of Google Cloud resources that are inside of the service perimeter. Currently projects, folders, and VPCs are allowed. Project format: `projects/{project_number}` Folder format: `folders/{folder_id}` VPC network format: `//compute.googleapis.com/projects/{PROJECT_ID}/global/networks/{NAME}`.
       "A String",
     ],
     "restrictedServices": [ # Google Cloud services that are subject to the Service Perimeter restrictions. For example, if `storage.googleapis.com` is specified, access to the storage buckets inside the perimeter must meet the perimeter's access restrictions.
@@ -508,7 +508,7 @@ 
Method Details

               "pscEndpoint": { # Specifies the Private Service Connect endpoint that an API call refers to. # A PrivateServiceConnectEndpoint that is allowed to access data outside the perimeter. The Private Service Connect endpoint may be in any organization, not just the organization that the perimeter is defined in.
                 "forwardingRule": "A String", # The full resource name of the global forwarding rule that identifies a Private Service Connect endpoint. Forwarding rule format: `//compute.googleapis.com/projects/{PROJECT_ID}/global/forwardingRules/{FORWARDING_RULE_ID}`.
               },
-              "resource": "A String", # A Google Cloud resource from the service perimeter that you want to allow to access data outside the perimeter. This field supports only projects. The project format is `projects/{project_number}`. You can't use `*` in this field to allow all Google Cloud resources.
+              "resource": "A String", # A Google Cloud resource from the service perimeter that you want to allow to access data outside the perimeter. This field supports projects, folders, and organizations in the form `projects/`, `folders/`, and `organizations/`. You can't use `*` in this field to allow all Google Cloud resources.
             },
           ],
         },
@@ -527,7 +527,7 @@ 
Method Details

               "serviceName": "A String", # The name of the API whose methods or permissions the IngressPolicy or EgressPolicy want to allow. A single ApiOperation with `service_name` field set to `*` will allow all methods AND permissions for all services.
             },
           ],
-          "resources": [ # A list of resources, currently only projects in the form `projects/`, that are allowed to be accessed by sources defined in the corresponding EgressFrom. A request matches if it contains a resource in this list. If `*` is specified for `resources`, then this EgressTo rule will authorize access to all resources outside the perimeter.
+          "resources": [ # A list of resources, currently projects, folders, and organizations in the form `projects/`, `folders/`, and `organizations/`, that are allowed to be accessed by sources defined in the corresponding EgressFrom. A request matches if it contains a resource in this list. If `*` is specified for `resources`, then this EgressTo rule will authorize access to all resources outside the perimeter.
             "A String",
           ],
           "roles": [ # IAM roles that represent the set of operations that the sources specified in the corresponding EgressFrom. are allowed to perform in this ServicePerimeter.
@@ -550,7 +550,7 @@ 
Method Details

               "pscEndpoint": { # Specifies the Private Service Connect endpoint that an API call refers to. # A PrivateServiceConnectEndpoint that is allowed to access the perimeter. The Private Service Connect endpoint may be in any organization, not just the organization that the perimeter is defined in.
                 "forwardingRule": "A String", # The full resource name of the global forwarding rule that identifies a Private Service Connect endpoint. Forwarding rule format: `//compute.googleapis.com/projects/{PROJECT_ID}/global/forwardingRules/{FORWARDING_RULE_ID}`.
               },
-              "resource": "A String", # A Google Cloud resource that is allowed to ingress the perimeter. Requests from these resources will be allowed to access perimeter data. Currently only projects and VPCs are allowed. Project format: `projects/{project_number}` VPC network format: `//compute.googleapis.com/projects/{PROJECT_ID}/global/networks/{NAME}`. The project may be in any Google Cloud organization, not just the organization that the perimeter is defined in. `*` is not allowed, the case of allowing all Google Cloud resources only is not supported.
+              "resource": "A String", # A Google Cloud resource that is allowed to ingress the perimeter. Requests from these resources will be allowed to access perimeter data. Currently projects, folders, organizations, and VPCs are allowed. Project format: `projects/{project_number}` Folder format: `folders/{folder_id}` Organization format: `organizations/{organization_id}` VPC network format: `//compute.googleapis.com/projects/{PROJECT_ID}/global/networks/{NAME}`. The project may be in any Google Cloud organization, not just the organization that the perimeter is defined in. `*` is not allowed, the case of allowing all Google Cloud resources only is not supported.
             },
           ],
         },
@@ -566,7 +566,7 @@ 
Method Details

               "serviceName": "A String", # The name of the API whose methods or permissions the IngressPolicy or EgressPolicy want to allow. A single ApiOperation with `service_name` field set to `*` will allow all methods AND permissions for all services.
             },
           ],
-          "resources": [ # A list of resources, currently only projects in the form `projects/`, protected by this ServicePerimeter that are allowed to be accessed by sources defined in the corresponding IngressFrom. If a single `*` is specified, then access to all resources inside the perimeter are allowed.
+          "resources": [ # A list of resources, currently projects, folders, and organizations in the form `projects/{project_number}`, `folders/{folder_id}`, and `organizations/{organization_id}`, protected by this ServicePerimeter that are allowed to be accessed by sources defined in the corresponding IngressFrom. If a single `*` is specified, then access to all resources inside the perimeter are allowed.
             "A String",
           ],
           "roles": [ # IAM roles that represent the set of operations that the sources specified in the corresponding IngressFrom are allowed to perform in this ServicePerimeter.
@@ -576,7 +576,7 @@ 
Method Details

         "title": "A String", # Optional. Human-readable title for the ingress rule. The title must be unique within the perimeter and can not exceed 100 characters. Within the access policy, the combined length of all rule titles must not exceed 240,000 characters.
       },
     ],
-    "resources": [ # A list of Google Cloud resources that are inside of the service perimeter. Currently only projects and VPCs are allowed. Project format: `projects/{project_number}` VPC network format: `//compute.googleapis.com/projects/{PROJECT_ID}/global/networks/{NAME}`.
+    "resources": [ # A list of Google Cloud resources that are inside of the service perimeter. Currently projects, folders, and VPCs are allowed. Project format: `projects/{project_number}` Folder format: `folders/{folder_id}` VPC network format: `//compute.googleapis.com/projects/{PROJECT_ID}/global/networks/{NAME}`.
       "A String",
     ],
     "restrictedServices": [ # Google Cloud services that are subject to the Service Perimeter restrictions. For example, if `storage.googleapis.com` is specified, access to the storage buckets inside the perimeter must meet the perimeter's access restrictions.
@@ -624,7 +624,7 @@ 
Method Details

               "pscEndpoint": { # Specifies the Private Service Connect endpoint that an API call refers to. # A PrivateServiceConnectEndpoint that is allowed to access data outside the perimeter. The Private Service Connect endpoint may be in any organization, not just the organization that the perimeter is defined in.
                 "forwardingRule": "A String", # The full resource name of the global forwarding rule that identifies a Private Service Connect endpoint. Forwarding rule format: `//compute.googleapis.com/projects/{PROJECT_ID}/global/forwardingRules/{FORWARDING_RULE_ID}`.
               },
-              "resource": "A String", # A Google Cloud resource from the service perimeter that you want to allow to access data outside the perimeter. This field supports only projects. The project format is `projects/{project_number}`. You can't use `*` in this field to allow all Google Cloud resources.
+              "resource": "A String", # A Google Cloud resource from the service perimeter that you want to allow to access data outside the perimeter. This field supports projects, folders, and organizations in the form `projects/`, `folders/`, and `organizations/`. You can't use `*` in this field to allow all Google Cloud resources.
             },
           ],
         },
@@ -643,7 +643,7 @@ 
Method Details

               "serviceName": "A String", # The name of the API whose methods or permissions the IngressPolicy or EgressPolicy want to allow. A single ApiOperation with `service_name` field set to `*` will allow all methods AND permissions for all services.
             },
           ],
-          "resources": [ # A list of resources, currently only projects in the form `projects/`, that are allowed to be accessed by sources defined in the corresponding EgressFrom. A request matches if it contains a resource in this list. If `*` is specified for `resources`, then this EgressTo rule will authorize access to all resources outside the perimeter.
+          "resources": [ # A list of resources, currently projects, folders, and organizations in the form `projects/`, `folders/`, and `organizations/`, that are allowed to be accessed by sources defined in the corresponding EgressFrom. A request matches if it contains a resource in this list. If `*` is specified for `resources`, then this EgressTo rule will authorize access to all resources outside the perimeter.
             "A String",
           ],
           "roles": [ # IAM roles that represent the set of operations that the sources specified in the corresponding EgressFrom. are allowed to perform in this ServicePerimeter.
@@ -666,7 +666,7 @@ 
Method Details

               "pscEndpoint": { # Specifies the Private Service Connect endpoint that an API call refers to. # A PrivateServiceConnectEndpoint that is allowed to access the perimeter. The Private Service Connect endpoint may be in any organization, not just the organization that the perimeter is defined in.
                 "forwardingRule": "A String", # The full resource name of the global forwarding rule that identifies a Private Service Connect endpoint. Forwarding rule format: `//compute.googleapis.com/projects/{PROJECT_ID}/global/forwardingRules/{FORWARDING_RULE_ID}`.
               },
-              "resource": "A String", # A Google Cloud resource that is allowed to ingress the perimeter. Requests from these resources will be allowed to access perimeter data. Currently only projects and VPCs are allowed. Project format: `projects/{project_number}` VPC network format: `//compute.googleapis.com/projects/{PROJECT_ID}/global/networks/{NAME}`. The project may be in any Google Cloud organization, not just the organization that the perimeter is defined in. `*` is not allowed, the case of allowing all Google Cloud resources only is not supported.
+              "resource": "A String", # A Google Cloud resource that is allowed to ingress the perimeter. Requests from these resources will be allowed to access perimeter data. Currently projects, folders, organizations, and VPCs are allowed. Project format: `projects/{project_number}` Folder format: `folders/{folder_id}` Organization format: `organizations/{organization_id}` VPC network format: `//compute.googleapis.com/projects/{PROJECT_ID}/global/networks/{NAME}`. The project may be in any Google Cloud organization, not just the organization that the perimeter is defined in. `*` is not allowed, the case of allowing all Google Cloud resources only is not supported.
             },
           ],
         },
@@ -682,7 +682,7 @@ 
Method Details

               "serviceName": "A String", # The name of the API whose methods or permissions the IngressPolicy or EgressPolicy want to allow. A single ApiOperation with `service_name` field set to `*` will allow all methods AND permissions for all services.
             },
           ],
-          "resources": [ # A list of resources, currently only projects in the form `projects/`, protected by this ServicePerimeter that are allowed to be accessed by sources defined in the corresponding IngressFrom. If a single `*` is specified, then access to all resources inside the perimeter are allowed.
+          "resources": [ # A list of resources, currently projects, folders, and organizations in the form `projects/{project_number}`, `folders/{folder_id}`, and `organizations/{organization_id}`, protected by this ServicePerimeter that are allowed to be accessed by sources defined in the corresponding IngressFrom. If a single `*` is specified, then access to all resources inside the perimeter are allowed.
             "A String",
           ],
           "roles": [ # IAM roles that represent the set of operations that the sources specified in the corresponding IngressFrom are allowed to perform in this ServicePerimeter.
@@ -692,7 +692,7 @@ 
Method Details

         "title": "A String", # Optional. Human-readable title for the ingress rule. The title must be unique within the perimeter and can not exceed 100 characters. Within the access policy, the combined length of all rule titles must not exceed 240,000 characters.
       },
     ],
-    "resources": [ # A list of Google Cloud resources that are inside of the service perimeter. Currently only projects and VPCs are allowed. Project format: `projects/{project_number}` VPC network format: `//compute.googleapis.com/projects/{PROJECT_ID}/global/networks/{NAME}`.
+    "resources": [ # A list of Google Cloud resources that are inside of the service perimeter. Currently projects, folders, and VPCs are allowed. Project format: `projects/{project_number}` Folder format: `folders/{folder_id}` VPC network format: `//compute.googleapis.com/projects/{PROJECT_ID}/global/networks/{NAME}`.
       "A String",
     ],
     "restrictedServices": [ # Google Cloud services that are subject to the Service Perimeter restrictions. For example, if `storage.googleapis.com` is specified, access to the storage buckets inside the perimeter must meet the perimeter's access restrictions.
@@ -774,7 +774,7 @@ 
Method Details

                   "pscEndpoint": { # Specifies the Private Service Connect endpoint that an API call refers to. # A PrivateServiceConnectEndpoint that is allowed to access data outside the perimeter. The Private Service Connect endpoint may be in any organization, not just the organization that the perimeter is defined in.
                     "forwardingRule": "A String", # The full resource name of the global forwarding rule that identifies a Private Service Connect endpoint. Forwarding rule format: `//compute.googleapis.com/projects/{PROJECT_ID}/global/forwardingRules/{FORWARDING_RULE_ID}`.
                   },
-                  "resource": "A String", # A Google Cloud resource from the service perimeter that you want to allow to access data outside the perimeter. This field supports only projects. The project format is `projects/{project_number}`. You can't use `*` in this field to allow all Google Cloud resources.
+                  "resource": "A String", # A Google Cloud resource from the service perimeter that you want to allow to access data outside the perimeter. This field supports projects, folders, and organizations in the form `projects/`, `folders/`, and `organizations/`. You can't use `*` in this field to allow all Google Cloud resources.
                 },
               ],
             },
@@ -793,7 +793,7 @@ 
Method Details

                   "serviceName": "A String", # The name of the API whose methods or permissions the IngressPolicy or EgressPolicy want to allow. A single ApiOperation with `service_name` field set to `*` will allow all methods AND permissions for all services.
                 },
               ],
-              "resources": [ # A list of resources, currently only projects in the form `projects/`, that are allowed to be accessed by sources defined in the corresponding EgressFrom. A request matches if it contains a resource in this list. If `*` is specified for `resources`, then this EgressTo rule will authorize access to all resources outside the perimeter.
+              "resources": [ # A list of resources, currently projects, folders, and organizations in the form `projects/`, `folders/`, and `organizations/`, that are allowed to be accessed by sources defined in the corresponding EgressFrom. A request matches if it contains a resource in this list. If `*` is specified for `resources`, then this EgressTo rule will authorize access to all resources outside the perimeter.
                 "A String",
               ],
               "roles": [ # IAM roles that represent the set of operations that the sources specified in the corresponding EgressFrom. are allowed to perform in this ServicePerimeter.
@@ -816,7 +816,7 @@ 
Method Details

                   "pscEndpoint": { # Specifies the Private Service Connect endpoint that an API call refers to. # A PrivateServiceConnectEndpoint that is allowed to access the perimeter. The Private Service Connect endpoint may be in any organization, not just the organization that the perimeter is defined in.
                     "forwardingRule": "A String", # The full resource name of the global forwarding rule that identifies a Private Service Connect endpoint. Forwarding rule format: `//compute.googleapis.com/projects/{PROJECT_ID}/global/forwardingRules/{FORWARDING_RULE_ID}`.
                   },
-                  "resource": "A String", # A Google Cloud resource that is allowed to ingress the perimeter. Requests from these resources will be allowed to access perimeter data. Currently only projects and VPCs are allowed. Project format: `projects/{project_number}` VPC network format: `//compute.googleapis.com/projects/{PROJECT_ID}/global/networks/{NAME}`. The project may be in any Google Cloud organization, not just the organization that the perimeter is defined in. `*` is not allowed, the case of allowing all Google Cloud resources only is not supported.
+                  "resource": "A String", # A Google Cloud resource that is allowed to ingress the perimeter. Requests from these resources will be allowed to access perimeter data. Currently projects, folders, organizations, and VPCs are allowed. Project format: `projects/{project_number}` Folder format: `folders/{folder_id}` Organization format: `organizations/{organization_id}` VPC network format: `//compute.googleapis.com/projects/{PROJECT_ID}/global/networks/{NAME}`. The project may be in any Google Cloud organization, not just the organization that the perimeter is defined in. `*` is not allowed, the case of allowing all Google Cloud resources only is not supported.
                 },
               ],
             },
@@ -832,7 +832,7 @@ 
Method Details

                   "serviceName": "A String", # The name of the API whose methods or permissions the IngressPolicy or EgressPolicy want to allow. A single ApiOperation with `service_name` field set to `*` will allow all methods AND permissions for all services.
                 },
               ],
-              "resources": [ # A list of resources, currently only projects in the form `projects/`, protected by this ServicePerimeter that are allowed to be accessed by sources defined in the corresponding IngressFrom. If a single `*` is specified, then access to all resources inside the perimeter are allowed.
+              "resources": [ # A list of resources, currently projects, folders, and organizations in the form `projects/{project_number}`, `folders/{folder_id}`, and `organizations/{organization_id}`, protected by this ServicePerimeter that are allowed to be accessed by sources defined in the corresponding IngressFrom. If a single `*` is specified, then access to all resources inside the perimeter are allowed.
                 "A String",
               ],
               "roles": [ # IAM roles that represent the set of operations that the sources specified in the corresponding IngressFrom are allowed to perform in this ServicePerimeter.
@@ -842,7 +842,7 @@ 
Method Details

             "title": "A String", # Optional. Human-readable title for the ingress rule. The title must be unique within the perimeter and can not exceed 100 characters. Within the access policy, the combined length of all rule titles must not exceed 240,000 characters.
           },
         ],
-        "resources": [ # A list of Google Cloud resources that are inside of the service perimeter. Currently only projects and VPCs are allowed. Project format: `projects/{project_number}` VPC network format: `//compute.googleapis.com/projects/{PROJECT_ID}/global/networks/{NAME}`.
+        "resources": [ # A list of Google Cloud resources that are inside of the service perimeter. Currently projects, folders, and VPCs are allowed. Project format: `projects/{project_number}` Folder format: `folders/{folder_id}` VPC network format: `//compute.googleapis.com/projects/{PROJECT_ID}/global/networks/{NAME}`.
           "A String",
         ],
         "restrictedServices": [ # Google Cloud services that are subject to the Service Perimeter restrictions. For example, if `storage.googleapis.com` is specified, access to the storage buckets inside the perimeter must meet the perimeter's access restrictions.
@@ -890,7 +890,7 @@ 
Method Details

                   "pscEndpoint": { # Specifies the Private Service Connect endpoint that an API call refers to. # A PrivateServiceConnectEndpoint that is allowed to access data outside the perimeter. The Private Service Connect endpoint may be in any organization, not just the organization that the perimeter is defined in.
                     "forwardingRule": "A String", # The full resource name of the global forwarding rule that identifies a Private Service Connect endpoint. Forwarding rule format: `//compute.googleapis.com/projects/{PROJECT_ID}/global/forwardingRules/{FORWARDING_RULE_ID}`.
                   },
-                  "resource": "A String", # A Google Cloud resource from the service perimeter that you want to allow to access data outside the perimeter. This field supports only projects. The project format is `projects/{project_number}`. You can't use `*` in this field to allow all Google Cloud resources.
+                  "resource": "A String", # A Google Cloud resource from the service perimeter that you want to allow to access data outside the perimeter. This field supports projects, folders, and organizations in the form `projects/`, `folders/`, and `organizations/`. You can't use `*` in this field to allow all Google Cloud resources.
                 },
               ],
             },
@@ -909,7 +909,7 @@ 
Method Details

                   "serviceName": "A String", # The name of the API whose methods or permissions the IngressPolicy or EgressPolicy want to allow. A single ApiOperation with `service_name` field set to `*` will allow all methods AND permissions for all services.
                 },
               ],
-              "resources": [ # A list of resources, currently only projects in the form `projects/`, that are allowed to be accessed by sources defined in the corresponding EgressFrom. A request matches if it contains a resource in this list. If `*` is specified for `resources`, then this EgressTo rule will authorize access to all resources outside the perimeter.
+              "resources": [ # A list of resources, currently projects, folders, and organizations in the form `projects/`, `folders/`, and `organizations/`, that are allowed to be accessed by sources defined in the corresponding EgressFrom. A request matches if it contains a resource in this list. If `*` is specified for `resources`, then this EgressTo rule will authorize access to all resources outside the perimeter.
                 "A String",
               ],
               "roles": [ # IAM roles that represent the set of operations that the sources specified in the corresponding EgressFrom. are allowed to perform in this ServicePerimeter.
@@ -932,7 +932,7 @@ 
Method Details

                   "pscEndpoint": { # Specifies the Private Service Connect endpoint that an API call refers to. # A PrivateServiceConnectEndpoint that is allowed to access the perimeter. The Private Service Connect endpoint may be in any organization, not just the organization that the perimeter is defined in.
                     "forwardingRule": "A String", # The full resource name of the global forwarding rule that identifies a Private Service Connect endpoint. Forwarding rule format: `//compute.googleapis.com/projects/{PROJECT_ID}/global/forwardingRules/{FORWARDING_RULE_ID}`.
                   },
-                  "resource": "A String", # A Google Cloud resource that is allowed to ingress the perimeter. Requests from these resources will be allowed to access perimeter data. Currently only projects and VPCs are allowed. Project format: `projects/{project_number}` VPC network format: `//compute.googleapis.com/projects/{PROJECT_ID}/global/networks/{NAME}`. The project may be in any Google Cloud organization, not just the organization that the perimeter is defined in. `*` is not allowed, the case of allowing all Google Cloud resources only is not supported.
+                  "resource": "A String", # A Google Cloud resource that is allowed to ingress the perimeter. Requests from these resources will be allowed to access perimeter data. Currently projects, folders, organizations, and VPCs are allowed. Project format: `projects/{project_number}` Folder format: `folders/{folder_id}` Organization format: `organizations/{organization_id}` VPC network format: `//compute.googleapis.com/projects/{PROJECT_ID}/global/networks/{NAME}`. The project may be in any Google Cloud organization, not just the organization that the perimeter is defined in. `*` is not allowed, the case of allowing all Google Cloud resources only is not supported.
                 },
               ],
             },
@@ -948,7 +948,7 @@ 
Method Details

                   "serviceName": "A String", # The name of the API whose methods or permissions the IngressPolicy or EgressPolicy want to allow. A single ApiOperation with `service_name` field set to `*` will allow all methods AND permissions for all services.
                 },
               ],
-              "resources": [ # A list of resources, currently only projects in the form `projects/`, protected by this ServicePerimeter that are allowed to be accessed by sources defined in the corresponding IngressFrom. If a single `*` is specified, then access to all resources inside the perimeter are allowed.
+              "resources": [ # A list of resources, currently projects, folders, and organizations in the form `projects/{project_number}`, `folders/{folder_id}`, and `organizations/{organization_id}`, protected by this ServicePerimeter that are allowed to be accessed by sources defined in the corresponding IngressFrom. If a single `*` is specified, then access to all resources inside the perimeter are allowed.
                 "A String",
               ],
               "roles": [ # IAM roles that represent the set of operations that the sources specified in the corresponding IngressFrom are allowed to perform in this ServicePerimeter.
@@ -958,7 +958,7 @@ 
Method Details

             "title": "A String", # Optional. Human-readable title for the ingress rule. The title must be unique within the perimeter and can not exceed 100 characters. Within the access policy, the combined length of all rule titles must not exceed 240,000 characters.
           },
         ],
-        "resources": [ # A list of Google Cloud resources that are inside of the service perimeter. Currently only projects and VPCs are allowed. Project format: `projects/{project_number}` VPC network format: `//compute.googleapis.com/projects/{PROJECT_ID}/global/networks/{NAME}`.
+        "resources": [ # A list of Google Cloud resources that are inside of the service perimeter. Currently projects, folders, and VPCs are allowed. Project format: `projects/{project_number}` Folder format: `folders/{folder_id}` VPC network format: `//compute.googleapis.com/projects/{PROJECT_ID}/global/networks/{NAME}`.
           "A String",
         ],
         "restrictedServices": [ # Google Cloud services that are subject to the Service Perimeter restrictions. For example, if `storage.googleapis.com` is specified, access to the storage buckets inside the perimeter must meet the perimeter's access restrictions.
@@ -1041,7 +1041,7 @@ 
Method Details

               "pscEndpoint": { # Specifies the Private Service Connect endpoint that an API call refers to. # A PrivateServiceConnectEndpoint that is allowed to access data outside the perimeter. The Private Service Connect endpoint may be in any organization, not just the organization that the perimeter is defined in.
                 "forwardingRule": "A String", # The full resource name of the global forwarding rule that identifies a Private Service Connect endpoint. Forwarding rule format: `//compute.googleapis.com/projects/{PROJECT_ID}/global/forwardingRules/{FORWARDING_RULE_ID}`.
               },
-              "resource": "A String", # A Google Cloud resource from the service perimeter that you want to allow to access data outside the perimeter. This field supports only projects. The project format is `projects/{project_number}`. You can't use `*` in this field to allow all Google Cloud resources.
+              "resource": "A String", # A Google Cloud resource from the service perimeter that you want to allow to access data outside the perimeter. This field supports projects, folders, and organizations in the form `projects/`, `folders/`, and `organizations/`. You can't use `*` in this field to allow all Google Cloud resources.
             },
           ],
         },
@@ -1060,7 +1060,7 @@ 
Method Details

               "serviceName": "A String", # The name of the API whose methods or permissions the IngressPolicy or EgressPolicy want to allow. A single ApiOperation with `service_name` field set to `*` will allow all methods AND permissions for all services.
             },
           ],
-          "resources": [ # A list of resources, currently only projects in the form `projects/`, that are allowed to be accessed by sources defined in the corresponding EgressFrom. A request matches if it contains a resource in this list. If `*` is specified for `resources`, then this EgressTo rule will authorize access to all resources outside the perimeter.
+          "resources": [ # A list of resources, currently projects, folders, and organizations in the form `projects/`, `folders/`, and `organizations/`, that are allowed to be accessed by sources defined in the corresponding EgressFrom. A request matches if it contains a resource in this list. If `*` is specified for `resources`, then this EgressTo rule will authorize access to all resources outside the perimeter.
             "A String",
           ],
           "roles": [ # IAM roles that represent the set of operations that the sources specified in the corresponding EgressFrom. are allowed to perform in this ServicePerimeter.
@@ -1083,7 +1083,7 @@ 
Method Details

               "pscEndpoint": { # Specifies the Private Service Connect endpoint that an API call refers to. # A PrivateServiceConnectEndpoint that is allowed to access the perimeter. The Private Service Connect endpoint may be in any organization, not just the organization that the perimeter is defined in.
                 "forwardingRule": "A String", # The full resource name of the global forwarding rule that identifies a Private Service Connect endpoint. Forwarding rule format: `//compute.googleapis.com/projects/{PROJECT_ID}/global/forwardingRules/{FORWARDING_RULE_ID}`.
               },
-              "resource": "A String", # A Google Cloud resource that is allowed to ingress the perimeter. Requests from these resources will be allowed to access perimeter data. Currently only projects and VPCs are allowed. Project format: `projects/{project_number}` VPC network format: `//compute.googleapis.com/projects/{PROJECT_ID}/global/networks/{NAME}`. The project may be in any Google Cloud organization, not just the organization that the perimeter is defined in. `*` is not allowed, the case of allowing all Google Cloud resources only is not supported.
+              "resource": "A String", # A Google Cloud resource that is allowed to ingress the perimeter. Requests from these resources will be allowed to access perimeter data. Currently projects, folders, organizations, and VPCs are allowed. Project format: `projects/{project_number}` Folder format: `folders/{folder_id}` Organization format: `organizations/{organization_id}` VPC network format: `//compute.googleapis.com/projects/{PROJECT_ID}/global/networks/{NAME}`. The project may be in any Google Cloud organization, not just the organization that the perimeter is defined in. `*` is not allowed, the case of allowing all Google Cloud resources only is not supported.
             },
           ],
         },
@@ -1099,7 +1099,7 @@ 
Method Details

               "serviceName": "A String", # The name of the API whose methods or permissions the IngressPolicy or EgressPolicy want to allow. A single ApiOperation with `service_name` field set to `*` will allow all methods AND permissions for all services.
             },
           ],
-          "resources": [ # A list of resources, currently only projects in the form `projects/`, protected by this ServicePerimeter that are allowed to be accessed by sources defined in the corresponding IngressFrom. If a single `*` is specified, then access to all resources inside the perimeter are allowed.
+          "resources": [ # A list of resources, currently projects, folders, and organizations in the form `projects/{project_number}`, `folders/{folder_id}`, and `organizations/{organization_id}`, protected by this ServicePerimeter that are allowed to be accessed by sources defined in the corresponding IngressFrom. If a single `*` is specified, then access to all resources inside the perimeter are allowed.
             "A String",
           ],
           "roles": [ # IAM roles that represent the set of operations that the sources specified in the corresponding IngressFrom are allowed to perform in this ServicePerimeter.
@@ -1109,7 +1109,7 @@ 
Method Details

         "title": "A String", # Optional. Human-readable title for the ingress rule. The title must be unique within the perimeter and can not exceed 100 characters. Within the access policy, the combined length of all rule titles must not exceed 240,000 characters.
       },
     ],
-    "resources": [ # A list of Google Cloud resources that are inside of the service perimeter. Currently only projects and VPCs are allowed. Project format: `projects/{project_number}` VPC network format: `//compute.googleapis.com/projects/{PROJECT_ID}/global/networks/{NAME}`.
+    "resources": [ # A list of Google Cloud resources that are inside of the service perimeter. Currently projects, folders, and VPCs are allowed. Project format: `projects/{project_number}` Folder format: `folders/{folder_id}` VPC network format: `//compute.googleapis.com/projects/{PROJECT_ID}/global/networks/{NAME}`.
       "A String",
     ],
     "restrictedServices": [ # Google Cloud services that are subject to the Service Perimeter restrictions. For example, if `storage.googleapis.com` is specified, access to the storage buckets inside the perimeter must meet the perimeter's access restrictions.
@@ -1157,7 +1157,7 @@ 
Method Details

               "pscEndpoint": { # Specifies the Private Service Connect endpoint that an API call refers to. # A PrivateServiceConnectEndpoint that is allowed to access data outside the perimeter. The Private Service Connect endpoint may be in any organization, not just the organization that the perimeter is defined in.
                 "forwardingRule": "A String", # The full resource name of the global forwarding rule that identifies a Private Service Connect endpoint. Forwarding rule format: `//compute.googleapis.com/projects/{PROJECT_ID}/global/forwardingRules/{FORWARDING_RULE_ID}`.
               },
-              "resource": "A String", # A Google Cloud resource from the service perimeter that you want to allow to access data outside the perimeter. This field supports only projects. The project format is `projects/{project_number}`. You can't use `*` in this field to allow all Google Cloud resources.
+              "resource": "A String", # A Google Cloud resource from the service perimeter that you want to allow to access data outside the perimeter. This field supports projects, folders, and organizations in the form `projects/`, `folders/`, and `organizations/`. You can't use `*` in this field to allow all Google Cloud resources.
             },
           ],
         },
@@ -1176,7 +1176,7 @@ 
Method Details

               "serviceName": "A String", # The name of the API whose methods or permissions the IngressPolicy or EgressPolicy want to allow. A single ApiOperation with `service_name` field set to `*` will allow all methods AND permissions for all services.
             },
           ],
-          "resources": [ # A list of resources, currently only projects in the form `projects/`, that are allowed to be accessed by sources defined in the corresponding EgressFrom. A request matches if it contains a resource in this list. If `*` is specified for `resources`, then this EgressTo rule will authorize access to all resources outside the perimeter.
+          "resources": [ # A list of resources, currently projects, folders, and organizations in the form `projects/`, `folders/`, and `organizations/`, that are allowed to be accessed by sources defined in the corresponding EgressFrom. A request matches if it contains a resource in this list. If `*` is specified for `resources`, then this EgressTo rule will authorize access to all resources outside the perimeter.
             "A String",
           ],
           "roles": [ # IAM roles that represent the set of operations that the sources specified in the corresponding EgressFrom. are allowed to perform in this ServicePerimeter.
@@ -1199,7 +1199,7 @@ 
Method Details

               "pscEndpoint": { # Specifies the Private Service Connect endpoint that an API call refers to. # A PrivateServiceConnectEndpoint that is allowed to access the perimeter. The Private Service Connect endpoint may be in any organization, not just the organization that the perimeter is defined in.
                 "forwardingRule": "A String", # The full resource name of the global forwarding rule that identifies a Private Service Connect endpoint. Forwarding rule format: `//compute.googleapis.com/projects/{PROJECT_ID}/global/forwardingRules/{FORWARDING_RULE_ID}`.
               },
-              "resource": "A String", # A Google Cloud resource that is allowed to ingress the perimeter. Requests from these resources will be allowed to access perimeter data. Currently only projects and VPCs are allowed. Project format: `projects/{project_number}` VPC network format: `//compute.googleapis.com/projects/{PROJECT_ID}/global/networks/{NAME}`. The project may be in any Google Cloud organization, not just the organization that the perimeter is defined in. `*` is not allowed, the case of allowing all Google Cloud resources only is not supported.
+              "resource": "A String", # A Google Cloud resource that is allowed to ingress the perimeter. Requests from these resources will be allowed to access perimeter data. Currently projects, folders, organizations, and VPCs are allowed. Project format: `projects/{project_number}` Folder format: `folders/{folder_id}` Organization format: `organizations/{organization_id}` VPC network format: `//compute.googleapis.com/projects/{PROJECT_ID}/global/networks/{NAME}`. The project may be in any Google Cloud organization, not just the organization that the perimeter is defined in. `*` is not allowed, the case of allowing all Google Cloud resources only is not supported.
             },
           ],
         },
@@ -1215,7 +1215,7 @@ 
Method Details

               "serviceName": "A String", # The name of the API whose methods or permissions the IngressPolicy or EgressPolicy want to allow. A single ApiOperation with `service_name` field set to `*` will allow all methods AND permissions for all services.
             },
           ],
-          "resources": [ # A list of resources, currently only projects in the form `projects/`, protected by this ServicePerimeter that are allowed to be accessed by sources defined in the corresponding IngressFrom. If a single `*` is specified, then access to all resources inside the perimeter are allowed.
+          "resources": [ # A list of resources, currently projects, folders, and organizations in the form `projects/{project_number}`, `folders/{folder_id}`, and `organizations/{organization_id}`, protected by this ServicePerimeter that are allowed to be accessed by sources defined in the corresponding IngressFrom. If a single `*` is specified, then access to all resources inside the perimeter are allowed.
             "A String",
           ],
           "roles": [ # IAM roles that represent the set of operations that the sources specified in the corresponding IngressFrom are allowed to perform in this ServicePerimeter.
@@ -1225,7 +1225,7 @@ 
Method Details

         "title": "A String", # Optional. Human-readable title for the ingress rule. The title must be unique within the perimeter and can not exceed 100 characters. Within the access policy, the combined length of all rule titles must not exceed 240,000 characters.
       },
     ],
-    "resources": [ # A list of Google Cloud resources that are inside of the service perimeter. Currently only projects and VPCs are allowed. Project format: `projects/{project_number}` VPC network format: `//compute.googleapis.com/projects/{PROJECT_ID}/global/networks/{NAME}`.
+    "resources": [ # A list of Google Cloud resources that are inside of the service perimeter. Currently projects, folders, and VPCs are allowed. Project format: `projects/{project_number}` Folder format: `folders/{folder_id}` VPC network format: `//compute.googleapis.com/projects/{PROJECT_ID}/global/networks/{NAME}`.
       "A String",
     ],
     "restrictedServices": [ # Google Cloud services that are subject to the Service Perimeter restrictions. For example, if `storage.googleapis.com` is specified, access to the storage buckets inside the perimeter must meet the perimeter's access restrictions.
@@ -1329,7 +1329,7 @@ 
Method Details

                   "pscEndpoint": { # Specifies the Private Service Connect endpoint that an API call refers to. # A PrivateServiceConnectEndpoint that is allowed to access data outside the perimeter. The Private Service Connect endpoint may be in any organization, not just the organization that the perimeter is defined in.
                     "forwardingRule": "A String", # The full resource name of the global forwarding rule that identifies a Private Service Connect endpoint. Forwarding rule format: `//compute.googleapis.com/projects/{PROJECT_ID}/global/forwardingRules/{FORWARDING_RULE_ID}`.
                   },
-                  "resource": "A String", # A Google Cloud resource from the service perimeter that you want to allow to access data outside the perimeter. This field supports only projects. The project format is `projects/{project_number}`. You can't use `*` in this field to allow all Google Cloud resources.
+                  "resource": "A String", # A Google Cloud resource from the service perimeter that you want to allow to access data outside the perimeter. This field supports projects, folders, and organizations in the form `projects/`, `folders/`, and `organizations/`. You can't use `*` in this field to allow all Google Cloud resources.
                 },
               ],
             },
@@ -1348,7 +1348,7 @@ 
Method Details

                   "serviceName": "A String", # The name of the API whose methods or permissions the IngressPolicy or EgressPolicy want to allow. A single ApiOperation with `service_name` field set to `*` will allow all methods AND permissions for all services.
                 },
               ],
-              "resources": [ # A list of resources, currently only projects in the form `projects/`, that are allowed to be accessed by sources defined in the corresponding EgressFrom. A request matches if it contains a resource in this list. If `*` is specified for `resources`, then this EgressTo rule will authorize access to all resources outside the perimeter.
+              "resources": [ # A list of resources, currently projects, folders, and organizations in the form `projects/`, `folders/`, and `organizations/`, that are allowed to be accessed by sources defined in the corresponding EgressFrom. A request matches if it contains a resource in this list. If `*` is specified for `resources`, then this EgressTo rule will authorize access to all resources outside the perimeter.
                 "A String",
               ],
               "roles": [ # IAM roles that represent the set of operations that the sources specified in the corresponding EgressFrom. are allowed to perform in this ServicePerimeter.
@@ -1371,7 +1371,7 @@ 
Method Details

                   "pscEndpoint": { # Specifies the Private Service Connect endpoint that an API call refers to. # A PrivateServiceConnectEndpoint that is allowed to access the perimeter. The Private Service Connect endpoint may be in any organization, not just the organization that the perimeter is defined in.
                     "forwardingRule": "A String", # The full resource name of the global forwarding rule that identifies a Private Service Connect endpoint. Forwarding rule format: `//compute.googleapis.com/projects/{PROJECT_ID}/global/forwardingRules/{FORWARDING_RULE_ID}`.
                   },
-                  "resource": "A String", # A Google Cloud resource that is allowed to ingress the perimeter. Requests from these resources will be allowed to access perimeter data. Currently only projects and VPCs are allowed. Project format: `projects/{project_number}` VPC network format: `//compute.googleapis.com/projects/{PROJECT_ID}/global/networks/{NAME}`. The project may be in any Google Cloud organization, not just the organization that the perimeter is defined in. `*` is not allowed, the case of allowing all Google Cloud resources only is not supported.
+                  "resource": "A String", # A Google Cloud resource that is allowed to ingress the perimeter. Requests from these resources will be allowed to access perimeter data. Currently projects, folders, organizations, and VPCs are allowed. Project format: `projects/{project_number}` Folder format: `folders/{folder_id}` Organization format: `organizations/{organization_id}` VPC network format: `//compute.googleapis.com/projects/{PROJECT_ID}/global/networks/{NAME}`. The project may be in any Google Cloud organization, not just the organization that the perimeter is defined in. `*` is not allowed, the case of allowing all Google Cloud resources only is not supported.
                 },
               ],
             },
@@ -1387,7 +1387,7 @@ 
Method Details

                   "serviceName": "A String", # The name of the API whose methods or permissions the IngressPolicy or EgressPolicy want to allow. A single ApiOperation with `service_name` field set to `*` will allow all methods AND permissions for all services.
                 },
               ],
-              "resources": [ # A list of resources, currently only projects in the form `projects/`, protected by this ServicePerimeter that are allowed to be accessed by sources defined in the corresponding IngressFrom. If a single `*` is specified, then access to all resources inside the perimeter are allowed.
+              "resources": [ # A list of resources, currently projects, folders, and organizations in the form `projects/{project_number}`, `folders/{folder_id}`, and `organizations/{organization_id}`, protected by this ServicePerimeter that are allowed to be accessed by sources defined in the corresponding IngressFrom. If a single `*` is specified, then access to all resources inside the perimeter are allowed.
                 "A String",
               ],
               "roles": [ # IAM roles that represent the set of operations that the sources specified in the corresponding IngressFrom are allowed to perform in this ServicePerimeter.
@@ -1397,7 +1397,7 @@ 
Method Details

             "title": "A String", # Optional. Human-readable title for the ingress rule. The title must be unique within the perimeter and can not exceed 100 characters. Within the access policy, the combined length of all rule titles must not exceed 240,000 characters.
           },
         ],
-        "resources": [ # A list of Google Cloud resources that are inside of the service perimeter. Currently only projects and VPCs are allowed. Project format: `projects/{project_number}` VPC network format: `//compute.googleapis.com/projects/{PROJECT_ID}/global/networks/{NAME}`.
+        "resources": [ # A list of Google Cloud resources that are inside of the service perimeter. Currently projects, folders, and VPCs are allowed. Project format: `projects/{project_number}` Folder format: `folders/{folder_id}` VPC network format: `//compute.googleapis.com/projects/{PROJECT_ID}/global/networks/{NAME}`.
           "A String",
         ],
         "restrictedServices": [ # Google Cloud services that are subject to the Service Perimeter restrictions. For example, if `storage.googleapis.com` is specified, access to the storage buckets inside the perimeter must meet the perimeter's access restrictions.
@@ -1445,7 +1445,7 @@ 
Method Details

                   "pscEndpoint": { # Specifies the Private Service Connect endpoint that an API call refers to. # A PrivateServiceConnectEndpoint that is allowed to access data outside the perimeter. The Private Service Connect endpoint may be in any organization, not just the organization that the perimeter is defined in.
                     "forwardingRule": "A String", # The full resource name of the global forwarding rule that identifies a Private Service Connect endpoint. Forwarding rule format: `//compute.googleapis.com/projects/{PROJECT_ID}/global/forwardingRules/{FORWARDING_RULE_ID}`.
                   },
-                  "resource": "A String", # A Google Cloud resource from the service perimeter that you want to allow to access data outside the perimeter. This field supports only projects. The project format is `projects/{project_number}`. You can't use `*` in this field to allow all Google Cloud resources.
+                  "resource": "A String", # A Google Cloud resource from the service perimeter that you want to allow to access data outside the perimeter. This field supports projects, folders, and organizations in the form `projects/`, `folders/`, and `organizations/`. You can't use `*` in this field to allow all Google Cloud resources.
                 },
               ],
             },
@@ -1464,7 +1464,7 @@ 
Method Details

                   "serviceName": "A String", # The name of the API whose methods or permissions the IngressPolicy or EgressPolicy want to allow. A single ApiOperation with `service_name` field set to `*` will allow all methods AND permissions for all services.
                 },
               ],
-              "resources": [ # A list of resources, currently only projects in the form `projects/`, that are allowed to be accessed by sources defined in the corresponding EgressFrom. A request matches if it contains a resource in this list. If `*` is specified for `resources`, then this EgressTo rule will authorize access to all resources outside the perimeter.
+              "resources": [ # A list of resources, currently projects, folders, and organizations in the form `projects/`, `folders/`, and `organizations/`, that are allowed to be accessed by sources defined in the corresponding EgressFrom. A request matches if it contains a resource in this list. If `*` is specified for `resources`, then this EgressTo rule will authorize access to all resources outside the perimeter.
                 "A String",
               ],
               "roles": [ # IAM roles that represent the set of operations that the sources specified in the corresponding EgressFrom. are allowed to perform in this ServicePerimeter.
@@ -1487,7 +1487,7 @@ 
Method Details

                   "pscEndpoint": { # Specifies the Private Service Connect endpoint that an API call refers to. # A PrivateServiceConnectEndpoint that is allowed to access the perimeter. The Private Service Connect endpoint may be in any organization, not just the organization that the perimeter is defined in.
                     "forwardingRule": "A String", # The full resource name of the global forwarding rule that identifies a Private Service Connect endpoint. Forwarding rule format: `//compute.googleapis.com/projects/{PROJECT_ID}/global/forwardingRules/{FORWARDING_RULE_ID}`.
                   },
-                  "resource": "A String", # A Google Cloud resource that is allowed to ingress the perimeter. Requests from these resources will be allowed to access perimeter data. Currently only projects and VPCs are allowed. Project format: `projects/{project_number}` VPC network format: `//compute.googleapis.com/projects/{PROJECT_ID}/global/networks/{NAME}`. The project may be in any Google Cloud organization, not just the organization that the perimeter is defined in. `*` is not allowed, the case of allowing all Google Cloud resources only is not supported.
+                  "resource": "A String", # A Google Cloud resource that is allowed to ingress the perimeter. Requests from these resources will be allowed to access perimeter data. Currently projects, folders, organizations, and VPCs are allowed. Project format: `projects/{project_number}` Folder format: `folders/{folder_id}` Organization format: `organizations/{organization_id}` VPC network format: `//compute.googleapis.com/projects/{PROJECT_ID}/global/networks/{NAME}`. The project may be in any Google Cloud organization, not just the organization that the perimeter is defined in. `*` is not allowed, the case of allowing all Google Cloud resources only is not supported.
                 },
               ],
             },
@@ -1503,7 +1503,7 @@ 
Method Details

                   "serviceName": "A String", # The name of the API whose methods or permissions the IngressPolicy or EgressPolicy want to allow. A single ApiOperation with `service_name` field set to `*` will allow all methods AND permissions for all services.
                 },
               ],
-              "resources": [ # A list of resources, currently only projects in the form `projects/`, protected by this ServicePerimeter that are allowed to be accessed by sources defined in the corresponding IngressFrom. If a single `*` is specified, then access to all resources inside the perimeter are allowed.
+              "resources": [ # A list of resources, currently projects, folders, and organizations in the form `projects/{project_number}`, `folders/{folder_id}`, and `organizations/{organization_id}`, protected by this ServicePerimeter that are allowed to be accessed by sources defined in the corresponding IngressFrom. If a single `*` is specified, then access to all resources inside the perimeter are allowed.
                 "A String",
               ],
               "roles": [ # IAM roles that represent the set of operations that the sources specified in the corresponding IngressFrom are allowed to perform in this ServicePerimeter.
@@ -1513,7 +1513,7 @@ 
Method Details

             "title": "A String", # Optional. Human-readable title for the ingress rule. The title must be unique within the perimeter and can not exceed 100 characters. Within the access policy, the combined length of all rule titles must not exceed 240,000 characters.
           },
         ],
-        "resources": [ # A list of Google Cloud resources that are inside of the service perimeter. Currently only projects and VPCs are allowed. Project format: `projects/{project_number}` VPC network format: `//compute.googleapis.com/projects/{PROJECT_ID}/global/networks/{NAME}`.
+        "resources": [ # A list of Google Cloud resources that are inside of the service perimeter. Currently projects, folders, and VPCs are allowed. Project format: `projects/{project_number}` Folder format: `folders/{folder_id}` VPC network format: `//compute.googleapis.com/projects/{PROJECT_ID}/global/networks/{NAME}`.
           "A String",
         ],
         "restrictedServices": [ # Google Cloud services that are subject to the Service Perimeter restrictions. For example, if `storage.googleapis.com` is specified, access to the storage buckets inside the perimeter must meet the perimeter's access restrictions.
diff --git a/docs/dyn/analyticshub_v1.projects.locations.dataExchanges.listings.html b/docs/dyn/analyticshub_v1.projects.locations.dataExchanges.listings.html
index 3134cc019c..875b726311 100644
--- a/docs/dyn/analyticshub_v1.projects.locations.dataExchanges.listings.html
+++ b/docs/dyn/analyticshub_v1.projects.locations.dataExchanges.listings.html
@@ -932,7 +932,7 @@ 
Method Details

         "columnFamilyMapping": { # Configuration for writing a Pub/Sub message to a Bigtable row with a user-defined key and writing to column families. If this field is set: - The subscription messages must be formatted as JSON. - The row key mapping is configured in the `key_definition` section. - The top-level fields will be written either: - By default, they will be written to the `data` column family with the field name as the column qualifier. - But if the field name matches an existing column family (except for the default `data` column), then that field will be written to that column family, either as a scalar or its next level nested fields if it's a JSON object. - The cell timestamp will be the message publish timestamp. If the field is not set, the default behavior is to write: - row key: subscription name, message ID hash, and message ID delimited by `#`. - columns: message bytes written to a single column family `data` with an empty-string column qualifier. - cell timestamp: the message publish timestamp. # Optional. Configuration that allows writing row keys and/or columns based on fields in the input message. The input message format must be JSON if this field is set.
           "delimitedKey": { # Row key definition based on fields from the message. # Optional. If set, the row key is constructed from the given key fields and delimiter. All key fields must be present in the message; otherwise, the message remains in the subscription backlog.
             "delimiter": "A String", # Optional. Byte sequence used to delimit concatenated fields. Must be specified if multiple key fields are used. The delimiter must contain at least 1 character and at most 50 characters.
-            "keyFields": [ # Optional. The key fields to construct from the row key. The fields must be present in the message as a top-level field, i.e. JSON path expressions will not traverse into nested objects.
+            "keyFields": [ # Required. The key fields to construct from the row key. The fields must be present in the message as a top-level field, i.e. JSON path expressions will not traverse into nested objects.
               "A String",
             ],
           },
diff --git a/docs/dyn/billingbudgets_v1.billingAccounts.budgets.html b/docs/dyn/billingbudgets_v1.billingAccounts.budgets.html
index 17ea6ea653..0dd5d97244 100644
--- a/docs/dyn/billingbudgets_v1.billingAccounts.budgets.html
+++ b/docs/dyn/billingbudgets_v1.billingAccounts.budgets.html
@@ -169,8 +169,8 @@ 
Method Details

     "schemaVersion": "A String", # Optional. Required when NotificationsRule.pubsub_topic is set. The schema version of the notification sent to NotificationsRule.pubsub_topic. Only "1.0" is accepted. It represents the JSON schema as defined in https://docs.cloud.google.com/billing/docs/how-to/budgets-programmatic-notifications#notification-format.
   },
   "ownershipScope": "A String", # Optional. When `spend_cap` is set, must be `OWNERSHIP_SCOPE_UNSPECIFIED` or `ALL_USERS`. `BILLING_ACCOUNT` is not supported for spend caps.
-  "spendCap": { # SpendCap defines the spend cap configuration and state. # Optional. The spend cap configured for this budget. When `spend_cap` is set, strict field restrictions apply to the budget (see field-level comments on `ownership_scope`, `budget_filter`, `amount`, `threshold_rules`, and `notifications_rule`). When `spend_cap.output_state` is `ENFORCED`, only `spend_cap.input_state` can be modified in an `UpdateBudget` request (e.g., setting `input_state` to `AWAITING_NEXT_PERIOD` to lift the cap); modifying any other budget field while enforced will fail with `FAILED_PRECONDITION`.
-    "inputState": "A String", # Required. The desired state specified by the user. Valid values for mutation: - `CONFIGURED`: Must be set when creating a spend cap (`CreateBudget`). Also valid when updating (`UpdateBudget`) to activate the spend cap. - `AWAITING_NEXT_PERIOD`: Valid only when updating (`UpdateBudget`) to explicitly lift an enforced cap. Supplying any other value will result in an INVALID_ARGUMENT error.
+  "spendCap": { # SpendCap defines the spend cap configuration and state. # Optional. The spend cap configured for this budget. When `spend_cap` is set, strict field restrictions apply to the budget (see field-level comments on `ownership_scope`, `budget_filter`, `amount`, `threshold_rules`, and `notifications_rule`). When `spend_cap.output_state` is `ENFORCED`, only `spend_cap.input_state` can be modified in an `UpdateBudget` request (e.g., setting `input_state` to `AWAITING_NEXT_PERIOD` to lift the cap); modifying any other budget field while enforced will fail with `FAILED_PRECONDITION`. If the existing resource is a spend cap and an `update_mask` is supplied in an `UpdateBudget` request, `spend_cap` or `spend_cap.input_state` must be specified in the update mask. To convert a spend cap budget to a regular budget, specify `spend_cap` in the `update_mask` and omit `spend_cap` from the budget in the request.
+    "inputState": "A String", # Required. The desired state specified by the user. Valid values for mutation: - `CONFIGURED`: Must be set when creating a spend cap (`CreateBudget`). Also valid when updating (`UpdateBudget`) to activate the spend cap. If the spend cap is in state `AWAITING_NEXT_PERIOD`, `input_state` must be set to `CONFIGURED`. - `AWAITING_NEXT_PERIOD`: Valid only when updating (`UpdateBudget`) to explicitly lift an enforced cap. Not allowed if the spend cap is in state `AWAITING_NEXT_PERIOD`. Supplying any other value will result in an INVALID_ARGUMENT error.
     "outputState": "A String", # Output only. The actual resting state of the spend cap.
     "reconciling": True or False, # Output only. Indicates whether the server is actively processing a state transition or async workflow.
   },
@@ -249,8 +249,8 @@ 
Method Details

     "schemaVersion": "A String", # Optional. Required when NotificationsRule.pubsub_topic is set. The schema version of the notification sent to NotificationsRule.pubsub_topic. Only "1.0" is accepted. It represents the JSON schema as defined in https://docs.cloud.google.com/billing/docs/how-to/budgets-programmatic-notifications#notification-format.
   },
   "ownershipScope": "A String", # Optional. When `spend_cap` is set, must be `OWNERSHIP_SCOPE_UNSPECIFIED` or `ALL_USERS`. `BILLING_ACCOUNT` is not supported for spend caps.
-  "spendCap": { # SpendCap defines the spend cap configuration and state. # Optional. The spend cap configured for this budget. When `spend_cap` is set, strict field restrictions apply to the budget (see field-level comments on `ownership_scope`, `budget_filter`, `amount`, `threshold_rules`, and `notifications_rule`). When `spend_cap.output_state` is `ENFORCED`, only `spend_cap.input_state` can be modified in an `UpdateBudget` request (e.g., setting `input_state` to `AWAITING_NEXT_PERIOD` to lift the cap); modifying any other budget field while enforced will fail with `FAILED_PRECONDITION`.
-    "inputState": "A String", # Required. The desired state specified by the user. Valid values for mutation: - `CONFIGURED`: Must be set when creating a spend cap (`CreateBudget`). Also valid when updating (`UpdateBudget`) to activate the spend cap. - `AWAITING_NEXT_PERIOD`: Valid only when updating (`UpdateBudget`) to explicitly lift an enforced cap. Supplying any other value will result in an INVALID_ARGUMENT error.
+  "spendCap": { # SpendCap defines the spend cap configuration and state. # Optional. The spend cap configured for this budget. When `spend_cap` is set, strict field restrictions apply to the budget (see field-level comments on `ownership_scope`, `budget_filter`, `amount`, `threshold_rules`, and `notifications_rule`). When `spend_cap.output_state` is `ENFORCED`, only `spend_cap.input_state` can be modified in an `UpdateBudget` request (e.g., setting `input_state` to `AWAITING_NEXT_PERIOD` to lift the cap); modifying any other budget field while enforced will fail with `FAILED_PRECONDITION`. If the existing resource is a spend cap and an `update_mask` is supplied in an `UpdateBudget` request, `spend_cap` or `spend_cap.input_state` must be specified in the update mask. To convert a spend cap budget to a regular budget, specify `spend_cap` in the `update_mask` and omit `spend_cap` from the budget in the request.
+    "inputState": "A String", # Required. The desired state specified by the user. Valid values for mutation: - `CONFIGURED`: Must be set when creating a spend cap (`CreateBudget`). Also valid when updating (`UpdateBudget`) to activate the spend cap. If the spend cap is in state `AWAITING_NEXT_PERIOD`, `input_state` must be set to `CONFIGURED`. - `AWAITING_NEXT_PERIOD`: Valid only when updating (`UpdateBudget`) to explicitly lift an enforced cap. Not allowed if the spend cap is in state `AWAITING_NEXT_PERIOD`. Supplying any other value will result in an INVALID_ARGUMENT error.
     "outputState": "A String", # Output only. The actual resting state of the spend cap.
     "reconciling": True or False, # Output only. Indicates whether the server is actively processing a state transition or async workflow.
   },
@@ -354,8 +354,8 @@ 
Method Details

     "schemaVersion": "A String", # Optional. Required when NotificationsRule.pubsub_topic is set. The schema version of the notification sent to NotificationsRule.pubsub_topic. Only "1.0" is accepted. It represents the JSON schema as defined in https://docs.cloud.google.com/billing/docs/how-to/budgets-programmatic-notifications#notification-format.
   },
   "ownershipScope": "A String", # Optional. When `spend_cap` is set, must be `OWNERSHIP_SCOPE_UNSPECIFIED` or `ALL_USERS`. `BILLING_ACCOUNT` is not supported for spend caps.
-  "spendCap": { # SpendCap defines the spend cap configuration and state. # Optional. The spend cap configured for this budget. When `spend_cap` is set, strict field restrictions apply to the budget (see field-level comments on `ownership_scope`, `budget_filter`, `amount`, `threshold_rules`, and `notifications_rule`). When `spend_cap.output_state` is `ENFORCED`, only `spend_cap.input_state` can be modified in an `UpdateBudget` request (e.g., setting `input_state` to `AWAITING_NEXT_PERIOD` to lift the cap); modifying any other budget field while enforced will fail with `FAILED_PRECONDITION`.
-    "inputState": "A String", # Required. The desired state specified by the user. Valid values for mutation: - `CONFIGURED`: Must be set when creating a spend cap (`CreateBudget`). Also valid when updating (`UpdateBudget`) to activate the spend cap. - `AWAITING_NEXT_PERIOD`: Valid only when updating (`UpdateBudget`) to explicitly lift an enforced cap. Supplying any other value will result in an INVALID_ARGUMENT error.
+  "spendCap": { # SpendCap defines the spend cap configuration and state. # Optional. The spend cap configured for this budget. When `spend_cap` is set, strict field restrictions apply to the budget (see field-level comments on `ownership_scope`, `budget_filter`, `amount`, `threshold_rules`, and `notifications_rule`). When `spend_cap.output_state` is `ENFORCED`, only `spend_cap.input_state` can be modified in an `UpdateBudget` request (e.g., setting `input_state` to `AWAITING_NEXT_PERIOD` to lift the cap); modifying any other budget field while enforced will fail with `FAILED_PRECONDITION`. If the existing resource is a spend cap and an `update_mask` is supplied in an `UpdateBudget` request, `spend_cap` or `spend_cap.input_state` must be specified in the update mask. To convert a spend cap budget to a regular budget, specify `spend_cap` in the `update_mask` and omit `spend_cap` from the budget in the request.
+    "inputState": "A String", # Required. The desired state specified by the user. Valid values for mutation: - `CONFIGURED`: Must be set when creating a spend cap (`CreateBudget`). Also valid when updating (`UpdateBudget`) to activate the spend cap. If the spend cap is in state `AWAITING_NEXT_PERIOD`, `input_state` must be set to `CONFIGURED`. - `AWAITING_NEXT_PERIOD`: Valid only when updating (`UpdateBudget`) to explicitly lift an enforced cap. Not allowed if the spend cap is in state `AWAITING_NEXT_PERIOD`. Supplying any other value will result in an INVALID_ARGUMENT error.
     "outputState": "A String", # Output only. The actual resting state of the spend cap.
     "reconciling": True or False, # Output only. Indicates whether the server is actively processing a state transition or async workflow.
   },
@@ -446,8 +446,8 @@ 
Method Details

         "schemaVersion": "A String", # Optional. Required when NotificationsRule.pubsub_topic is set. The schema version of the notification sent to NotificationsRule.pubsub_topic. Only "1.0" is accepted. It represents the JSON schema as defined in https://docs.cloud.google.com/billing/docs/how-to/budgets-programmatic-notifications#notification-format.
       },
       "ownershipScope": "A String", # Optional. When `spend_cap` is set, must be `OWNERSHIP_SCOPE_UNSPECIFIED` or `ALL_USERS`. `BILLING_ACCOUNT` is not supported for spend caps.
-      "spendCap": { # SpendCap defines the spend cap configuration and state. # Optional. The spend cap configured for this budget. When `spend_cap` is set, strict field restrictions apply to the budget (see field-level comments on `ownership_scope`, `budget_filter`, `amount`, `threshold_rules`, and `notifications_rule`). When `spend_cap.output_state` is `ENFORCED`, only `spend_cap.input_state` can be modified in an `UpdateBudget` request (e.g., setting `input_state` to `AWAITING_NEXT_PERIOD` to lift the cap); modifying any other budget field while enforced will fail with `FAILED_PRECONDITION`.
-        "inputState": "A String", # Required. The desired state specified by the user. Valid values for mutation: - `CONFIGURED`: Must be set when creating a spend cap (`CreateBudget`). Also valid when updating (`UpdateBudget`) to activate the spend cap. - `AWAITING_NEXT_PERIOD`: Valid only when updating (`UpdateBudget`) to explicitly lift an enforced cap. Supplying any other value will result in an INVALID_ARGUMENT error.
+      "spendCap": { # SpendCap defines the spend cap configuration and state. # Optional. The spend cap configured for this budget. When `spend_cap` is set, strict field restrictions apply to the budget (see field-level comments on `ownership_scope`, `budget_filter`, `amount`, `threshold_rules`, and `notifications_rule`). When `spend_cap.output_state` is `ENFORCED`, only `spend_cap.input_state` can be modified in an `UpdateBudget` request (e.g., setting `input_state` to `AWAITING_NEXT_PERIOD` to lift the cap); modifying any other budget field while enforced will fail with `FAILED_PRECONDITION`. If the existing resource is a spend cap and an `update_mask` is supplied in an `UpdateBudget` request, `spend_cap` or `spend_cap.input_state` must be specified in the update mask. To convert a spend cap budget to a regular budget, specify `spend_cap` in the `update_mask` and omit `spend_cap` from the budget in the request.
+        "inputState": "A String", # Required. The desired state specified by the user. Valid values for mutation: - `CONFIGURED`: Must be set when creating a spend cap (`CreateBudget`). Also valid when updating (`UpdateBudget`) to activate the spend cap. If the spend cap is in state `AWAITING_NEXT_PERIOD`, `input_state` must be set to `CONFIGURED`. - `AWAITING_NEXT_PERIOD`: Valid only when updating (`UpdateBudget`) to explicitly lift an enforced cap. Not allowed if the spend cap is in state `AWAITING_NEXT_PERIOD`. Supplying any other value will result in an INVALID_ARGUMENT error.
         "outputState": "A String", # Output only. The actual resting state of the spend cap.
         "reconciling": True or False, # Output only. Indicates whether the server is actively processing a state transition or async workflow.
       },
@@ -545,8 +545,8 @@ 
Method Details

     "schemaVersion": "A String", # Optional. Required when NotificationsRule.pubsub_topic is set. The schema version of the notification sent to NotificationsRule.pubsub_topic. Only "1.0" is accepted. It represents the JSON schema as defined in https://docs.cloud.google.com/billing/docs/how-to/budgets-programmatic-notifications#notification-format.
   },
   "ownershipScope": "A String", # Optional. When `spend_cap` is set, must be `OWNERSHIP_SCOPE_UNSPECIFIED` or `ALL_USERS`. `BILLING_ACCOUNT` is not supported for spend caps.
-  "spendCap": { # SpendCap defines the spend cap configuration and state. # Optional. The spend cap configured for this budget. When `spend_cap` is set, strict field restrictions apply to the budget (see field-level comments on `ownership_scope`, `budget_filter`, `amount`, `threshold_rules`, and `notifications_rule`). When `spend_cap.output_state` is `ENFORCED`, only `spend_cap.input_state` can be modified in an `UpdateBudget` request (e.g., setting `input_state` to `AWAITING_NEXT_PERIOD` to lift the cap); modifying any other budget field while enforced will fail with `FAILED_PRECONDITION`.
-    "inputState": "A String", # Required. The desired state specified by the user. Valid values for mutation: - `CONFIGURED`: Must be set when creating a spend cap (`CreateBudget`). Also valid when updating (`UpdateBudget`) to activate the spend cap. - `AWAITING_NEXT_PERIOD`: Valid only when updating (`UpdateBudget`) to explicitly lift an enforced cap. Supplying any other value will result in an INVALID_ARGUMENT error.
+  "spendCap": { # SpendCap defines the spend cap configuration and state. # Optional. The spend cap configured for this budget. When `spend_cap` is set, strict field restrictions apply to the budget (see field-level comments on `ownership_scope`, `budget_filter`, `amount`, `threshold_rules`, and `notifications_rule`). When `spend_cap.output_state` is `ENFORCED`, only `spend_cap.input_state` can be modified in an `UpdateBudget` request (e.g., setting `input_state` to `AWAITING_NEXT_PERIOD` to lift the cap); modifying any other budget field while enforced will fail with `FAILED_PRECONDITION`. If the existing resource is a spend cap and an `update_mask` is supplied in an `UpdateBudget` request, `spend_cap` or `spend_cap.input_state` must be specified in the update mask. To convert a spend cap budget to a regular budget, specify `spend_cap` in the `update_mask` and omit `spend_cap` from the budget in the request.
+    "inputState": "A String", # Required. The desired state specified by the user. Valid values for mutation: - `CONFIGURED`: Must be set when creating a spend cap (`CreateBudget`). Also valid when updating (`UpdateBudget`) to activate the spend cap. If the spend cap is in state `AWAITING_NEXT_PERIOD`, `input_state` must be set to `CONFIGURED`. - `AWAITING_NEXT_PERIOD`: Valid only when updating (`UpdateBudget`) to explicitly lift an enforced cap. Not allowed if the spend cap is in state `AWAITING_NEXT_PERIOD`. Supplying any other value will result in an INVALID_ARGUMENT error.
     "outputState": "A String", # Output only. The actual resting state of the spend cap.
     "reconciling": True or False, # Output only. Indicates whether the server is actively processing a state transition or async workflow.
   },
@@ -626,8 +626,8 @@ 
Method Details

     "schemaVersion": "A String", # Optional. Required when NotificationsRule.pubsub_topic is set. The schema version of the notification sent to NotificationsRule.pubsub_topic. Only "1.0" is accepted. It represents the JSON schema as defined in https://docs.cloud.google.com/billing/docs/how-to/budgets-programmatic-notifications#notification-format.
   },
   "ownershipScope": "A String", # Optional. When `spend_cap` is set, must be `OWNERSHIP_SCOPE_UNSPECIFIED` or `ALL_USERS`. `BILLING_ACCOUNT` is not supported for spend caps.
-  "spendCap": { # SpendCap defines the spend cap configuration and state. # Optional. The spend cap configured for this budget. When `spend_cap` is set, strict field restrictions apply to the budget (see field-level comments on `ownership_scope`, `budget_filter`, `amount`, `threshold_rules`, and `notifications_rule`). When `spend_cap.output_state` is `ENFORCED`, only `spend_cap.input_state` can be modified in an `UpdateBudget` request (e.g., setting `input_state` to `AWAITING_NEXT_PERIOD` to lift the cap); modifying any other budget field while enforced will fail with `FAILED_PRECONDITION`.
-    "inputState": "A String", # Required. The desired state specified by the user. Valid values for mutation: - `CONFIGURED`: Must be set when creating a spend cap (`CreateBudget`). Also valid when updating (`UpdateBudget`) to activate the spend cap. - `AWAITING_NEXT_PERIOD`: Valid only when updating (`UpdateBudget`) to explicitly lift an enforced cap. Supplying any other value will result in an INVALID_ARGUMENT error.
+  "spendCap": { # SpendCap defines the spend cap configuration and state. # Optional. The spend cap configured for this budget. When `spend_cap` is set, strict field restrictions apply to the budget (see field-level comments on `ownership_scope`, `budget_filter`, `amount`, `threshold_rules`, and `notifications_rule`). When `spend_cap.output_state` is `ENFORCED`, only `spend_cap.input_state` can be modified in an `UpdateBudget` request (e.g., setting `input_state` to `AWAITING_NEXT_PERIOD` to lift the cap); modifying any other budget field while enforced will fail with `FAILED_PRECONDITION`. If the existing resource is a spend cap and an `update_mask` is supplied in an `UpdateBudget` request, `spend_cap` or `spend_cap.input_state` must be specified in the update mask. To convert a spend cap budget to a regular budget, specify `spend_cap` in the `update_mask` and omit `spend_cap` from the budget in the request.
+    "inputState": "A String", # Required. The desired state specified by the user. Valid values for mutation: - `CONFIGURED`: Must be set when creating a spend cap (`CreateBudget`). Also valid when updating (`UpdateBudget`) to activate the spend cap. If the spend cap is in state `AWAITING_NEXT_PERIOD`, `input_state` must be set to `CONFIGURED`. - `AWAITING_NEXT_PERIOD`: Valid only when updating (`UpdateBudget`) to explicitly lift an enforced cap. Not allowed if the spend cap is in state `AWAITING_NEXT_PERIOD`. Supplying any other value will result in an INVALID_ARGUMENT error.
     "outputState": "A String", # Output only. The actual resting state of the spend cap.
     "reconciling": True or False, # Output only. Indicates whether the server is actively processing a state transition or async workflow.
   },
diff --git a/docs/dyn/businessprofileperformance_v1.locations.html b/docs/dyn/businessprofileperformance_v1.locations.html
index 006bb31008..9aa31e739a 100644
--- a/docs/dyn/businessprofileperformance_v1.locations.html
+++ b/docs/dyn/businessprofileperformance_v1.locations.html
@@ -111,6 +111,7 @@ 
Method Details

       BUSINESS_DIRECTION_REQUESTS - The number of times a direction request was requested to the business location.
       CALL_CLICKS - The number of times the business profile call button was clicked.
       WEBSITE_CLICKS - The number of times the business profile website was clicked.
+      MESSAGING_CLICKS - The number of times the business profile messaging (e.g. Whatsapp) button was clicked.
       BUSINESS_BOOKINGS - The number of bookings made from the business profile via Reserve with Google.
       BUSINESS_FOOD_ORDERS - The number of food orders received from the business profile.
       BUSINESS_FOOD_MENU_CLICKS - The number of clicks to view or interact with the menu content on the business profile. Multiple clicks by a unique user within a single day are counted as 1.
@@ -179,6 +180,7 @@ 
Method Details

       BUSINESS_DIRECTION_REQUESTS - The number of times a direction request was requested to the business location.
       CALL_CLICKS - The number of times the business profile call button was clicked.
       WEBSITE_CLICKS - The number of times the business profile website was clicked.
+      MESSAGING_CLICKS - The number of times the business profile messaging (e.g. Whatsapp) button was clicked.
       BUSINESS_BOOKINGS - The number of bookings made from the business profile via Reserve with Google.
       BUSINESS_FOOD_ORDERS - The number of food orders received from the business profile.
       BUSINESS_FOOD_MENU_CLICKS - The number of clicks to view or interact with the menu content on the business profile. Multiple clicks by a unique user within a single day are counted as 1.
diff --git a/docs/dyn/chromemanagement_v1.customers.chromeBrowsers.html b/docs/dyn/chromemanagement_v1.customers.chromeBrowsers.html
index 3ba1559b4f..632a3e31fd 100644
--- a/docs/dyn/chromemanagement_v1.customers.chromeBrowsers.html
+++ b/docs/dyn/chromemanagement_v1.customers.chromeBrowsers.html
@@ -291,7 +291,7 @@ 
Method Details

 
 Args:
   parent: string, Required. Format: customers/{customer_id} (required)
-  filter: string, Optional. The filter used to filter browsers. The following fields can be used in the filter: * `browser_permanent_id` * `last_policy_fetch_time` * `os_platform` * `os_architecture` * `os_version` * `machine_name` * `annotated_location` * `annotated_user` * `annotated_asset_id` * `annotated_note` * `org_unit_path` * `org_unit_id` * `last_registration_time` * `os_platform_version` * `browser_version` * `last_status_report_time` * `extension_count` * `policy_count` * `last_device_user` * `last_activity_time` * `device_id_collision` The following functions can be used in the filter: * `in_group(string)`: Filters browsers that belong to the specified Cloud Identity group resource name (e.g. `in_group("groups/{group_id}")`). Any of the above fields or functions can be used to specify a filter, and filtering by multiple fields or functions is supported with AND operator. String type, Integer type fields and enum type fields support `=` and `:` operators. The timestamp type fields support `=`, `<=` and `>=` operators. Timestamps expect an RFC-3339 formatted string (e.g. 2012-04-21T11:30:00-04:00). Wildcard `*` is only supported for `machine_name`, `annotated_asset_id`, and `browser_version`. In addition, global string literal filtering without a field name is supported: a single term (e.g., `ABC`) matches if any indexed string field contains `ABC`, and multiple terms joined by `AND` or whitespace (e.g., `machine AND 73` or `machine 73`) match browsers where every term appears in at least one indexed string field (whereas a single quoted phrase like `"machine 73"` matches the contiguous phrase within a single field).
+  filter: string, Optional. The filter used to filter browsers. The following fields can be used in the filter: * `browser_permanent_id` * `last_policy_fetch_time` * `os_platform` * `os_architecture` * `os_version` * `machine_name` * `annotated_location` * `annotated_user` * `annotated_asset_id` * `annotated_note` * `org_unit_path` * `org_unit_id` * `last_registration_time` * `os_platform_version` * `browser_version` * `last_status_report_time` * `extension_count` * `policy_count` * `last_device_user` * `last_activity_time` * `device_id_collision` The following functions can be used in the filter: * `in_group(string)`: Filters browsers that belong to the specified Cloud Identity group resource name (e.g. `in_group("groups/{group_id}")`). Any of the above fields or functions can be used to specify a filter, and filtering by multiple fields or functions is supported with AND operator. String type, Integer type fields and enum type fields support `=` and `:` operators. The timestamp type fields support `=`, `<=` and `>=` operators. Timestamps expect an RFC-3339 formatted string enclosed in double quotes (e.g., `"2012-04-21T11:30:00-04:00"`). Wildcard `*` is only supported for `machine_name`, `annotated_asset_id`, and `browser_version`. In addition, global string literal filtering without a field name is supported: a single term (e.g., `ABC`) matches if any indexed string field contains `ABC`, and multiple terms joined by `AND` or whitespace (e.g., `machine AND 73` or `machine 73`) match browsers where every term appears in at least one indexed string field (whereas a single quoted phrase like `"machine 73"` matches the contiguous phrase within a single field).
   orderBy: string, Optional. The fields used to specify the ordering of the results. The supported fields are: * `browser_permanent_id` * `last_sync` * `annotated_user` * `annotated_location` * `annotated_asset_id` * `annotated_notes` * `org_unit_path` * `os_version` * `enrollment_date` * `extension_count` * `policy_count` * `last_signed_in_user` * `machine_name` * `browser_version_channel` * `os_platform_version` * `last_activity_time` * `browser_version` By default, sorting is in ascending order, to specify descending order for a field, a suffix ` desc` should be added to the field name. The default ordering is the descending order of `last_status_report_time`.
   pageSize: integer, Optional. Maximum number of results to return. Maximum and default are 100.
   pageToken: string, Optional. Token to specify next page in the list.
diff --git a/docs/dyn/cloudasset_v1.assets.html b/docs/dyn/cloudasset_v1.assets.html
index 48aca8aa1f..e6ff5372af 100644
--- a/docs/dyn/cloudasset_v1.assets.html
+++ b/docs/dyn/cloudasset_v1.assets.html
@@ -479,7 +479,7 @@ 
Method Details

                     "pscEndpoint": { # Specifies the Private Service Connect endpoint that an API call refers to. # A PrivateServiceConnectEndpoint that is allowed to access data outside the perimeter. The Private Service Connect endpoint may be in any organization, not just the organization that the perimeter is defined in.
                       "forwardingRule": "A String", # The full resource name of the global forwarding rule that identifies a Private Service Connect endpoint. Forwarding rule format: `//compute.googleapis.com/projects/{PROJECT_ID}/global/forwardingRules/{FORWARDING_RULE_ID}`.
                     },
-                    "resource": "A String", # A Google Cloud resource from the service perimeter that you want to allow to access data outside the perimeter. This field supports only projects. The project format is `projects/{project_number}`. You can't use `*` in this field to allow all Google Cloud resources.
+                    "resource": "A String", # A Google Cloud resource from the service perimeter that you want to allow to access data outside the perimeter. This field supports projects, folders, and organizations in the form `projects/`, `folders/`, and `organizations/`. You can't use `*` in this field to allow all Google Cloud resources.
                   },
                 ],
               },
@@ -498,7 +498,7 @@ 
Method Details

                     "serviceName": "A String", # The name of the API whose methods or permissions the IngressPolicy or EgressPolicy want to allow. A single ApiOperation with `service_name` field set to `*` will allow all methods AND permissions for all services.
                   },
                 ],
-                "resources": [ # A list of resources, currently only projects in the form `projects/`, that are allowed to be accessed by sources defined in the corresponding EgressFrom. A request matches if it contains a resource in this list. If `*` is specified for `resources`, then this EgressTo rule will authorize access to all resources outside the perimeter.
+                "resources": [ # A list of resources, currently projects, folders, and organizations in the form `projects/`, `folders/`, and `organizations/`, that are allowed to be accessed by sources defined in the corresponding EgressFrom. A request matches if it contains a resource in this list. If `*` is specified for `resources`, then this EgressTo rule will authorize access to all resources outside the perimeter.
                   "A String",
                 ],
                 "roles": [ # IAM roles that represent the set of operations that the sources specified in the corresponding EgressFrom. are allowed to perform in this ServicePerimeter.
@@ -521,7 +521,7 @@ 
Method Details

                     "pscEndpoint": { # Specifies the Private Service Connect endpoint that an API call refers to. # A PrivateServiceConnectEndpoint that is allowed to access the perimeter. The Private Service Connect endpoint may be in any organization, not just the organization that the perimeter is defined in.
                       "forwardingRule": "A String", # The full resource name of the global forwarding rule that identifies a Private Service Connect endpoint. Forwarding rule format: `//compute.googleapis.com/projects/{PROJECT_ID}/global/forwardingRules/{FORWARDING_RULE_ID}`.
                     },
-                    "resource": "A String", # A Google Cloud resource that is allowed to ingress the perimeter. Requests from these resources will be allowed to access perimeter data. Currently only projects and VPCs are allowed. Project format: `projects/{project_number}` VPC network format: `//compute.googleapis.com/projects/{PROJECT_ID}/global/networks/{NAME}`. The project may be in any Google Cloud organization, not just the organization that the perimeter is defined in. `*` is not allowed, the case of allowing all Google Cloud resources only is not supported.
+                    "resource": "A String", # A Google Cloud resource that is allowed to ingress the perimeter. Requests from these resources will be allowed to access perimeter data. Currently projects, folders, organizations, and VPCs are allowed. Project format: `projects/{project_number}` Folder format: `folders/{folder_id}` Organization format: `organizations/{organization_id}` VPC network format: `//compute.googleapis.com/projects/{PROJECT_ID}/global/networks/{NAME}`. The project may be in any Google Cloud organization, not just the organization that the perimeter is defined in. `*` is not allowed, the case of allowing all Google Cloud resources only is not supported.
                   },
                 ],
               },
@@ -537,7 +537,7 @@ 
Method Details

                     "serviceName": "A String", # The name of the API whose methods or permissions the IngressPolicy or EgressPolicy want to allow. A single ApiOperation with `service_name` field set to `*` will allow all methods AND permissions for all services.
                   },
                 ],
-                "resources": [ # A list of resources, currently only projects in the form `projects/`, protected by this ServicePerimeter that are allowed to be accessed by sources defined in the corresponding IngressFrom. If a single `*` is specified, then access to all resources inside the perimeter are allowed.
+                "resources": [ # A list of resources, currently projects, folders, and organizations in the form `projects/{project_number}`, `folders/{folder_id}`, and `organizations/{organization_id}`, protected by this ServicePerimeter that are allowed to be accessed by sources defined in the corresponding IngressFrom. If a single `*` is specified, then access to all resources inside the perimeter are allowed.
                   "A String",
                 ],
                 "roles": [ # IAM roles that represent the set of operations that the sources specified in the corresponding IngressFrom are allowed to perform in this ServicePerimeter.
@@ -547,7 +547,7 @@ 
Method Details

               "title": "A String", # Optional. Human-readable title for the ingress rule. The title must be unique within the perimeter and can not exceed 100 characters. Within the access policy, the combined length of all rule titles must not exceed 240,000 characters.
             },
           ],
-          "resources": [ # A list of Google Cloud resources that are inside of the service perimeter. Currently only projects and VPCs are allowed. Project format: `projects/{project_number}` VPC network format: `//compute.googleapis.com/projects/{PROJECT_ID}/global/networks/{NAME}`.
+          "resources": [ # A list of Google Cloud resources that are inside of the service perimeter. Currently projects, folders, and VPCs are allowed. Project format: `projects/{project_number}` Folder format: `folders/{folder_id}` VPC network format: `//compute.googleapis.com/projects/{PROJECT_ID}/global/networks/{NAME}`.
             "A String",
           ],
           "restrictedServices": [ # Google Cloud services that are subject to the Service Perimeter restrictions. For example, if `storage.googleapis.com` is specified, access to the storage buckets inside the perimeter must meet the perimeter's access restrictions.
@@ -595,7 +595,7 @@ 
Method Details

                     "pscEndpoint": { # Specifies the Private Service Connect endpoint that an API call refers to. # A PrivateServiceConnectEndpoint that is allowed to access data outside the perimeter. The Private Service Connect endpoint may be in any organization, not just the organization that the perimeter is defined in.
                       "forwardingRule": "A String", # The full resource name of the global forwarding rule that identifies a Private Service Connect endpoint. Forwarding rule format: `//compute.googleapis.com/projects/{PROJECT_ID}/global/forwardingRules/{FORWARDING_RULE_ID}`.
                     },
-                    "resource": "A String", # A Google Cloud resource from the service perimeter that you want to allow to access data outside the perimeter. This field supports only projects. The project format is `projects/{project_number}`. You can't use `*` in this field to allow all Google Cloud resources.
+                    "resource": "A String", # A Google Cloud resource from the service perimeter that you want to allow to access data outside the perimeter. This field supports projects, folders, and organizations in the form `projects/`, `folders/`, and `organizations/`. You can't use `*` in this field to allow all Google Cloud resources.
                   },
                 ],
               },
@@ -614,7 +614,7 @@ 
Method Details

                     "serviceName": "A String", # The name of the API whose methods or permissions the IngressPolicy or EgressPolicy want to allow. A single ApiOperation with `service_name` field set to `*` will allow all methods AND permissions for all services.
                   },
                 ],
-                "resources": [ # A list of resources, currently only projects in the form `projects/`, that are allowed to be accessed by sources defined in the corresponding EgressFrom. A request matches if it contains a resource in this list. If `*` is specified for `resources`, then this EgressTo rule will authorize access to all resources outside the perimeter.
+                "resources": [ # A list of resources, currently projects, folders, and organizations in the form `projects/`, `folders/`, and `organizations/`, that are allowed to be accessed by sources defined in the corresponding EgressFrom. A request matches if it contains a resource in this list. If `*` is specified for `resources`, then this EgressTo rule will authorize access to all resources outside the perimeter.
                   "A String",
                 ],
                 "roles": [ # IAM roles that represent the set of operations that the sources specified in the corresponding EgressFrom. are allowed to perform in this ServicePerimeter.
@@ -637,7 +637,7 @@ 
Method Details

                     "pscEndpoint": { # Specifies the Private Service Connect endpoint that an API call refers to. # A PrivateServiceConnectEndpoint that is allowed to access the perimeter. The Private Service Connect endpoint may be in any organization, not just the organization that the perimeter is defined in.
                       "forwardingRule": "A String", # The full resource name of the global forwarding rule that identifies a Private Service Connect endpoint. Forwarding rule format: `//compute.googleapis.com/projects/{PROJECT_ID}/global/forwardingRules/{FORWARDING_RULE_ID}`.
                     },
-                    "resource": "A String", # A Google Cloud resource that is allowed to ingress the perimeter. Requests from these resources will be allowed to access perimeter data. Currently only projects and VPCs are allowed. Project format: `projects/{project_number}` VPC network format: `//compute.googleapis.com/projects/{PROJECT_ID}/global/networks/{NAME}`. The project may be in any Google Cloud organization, not just the organization that the perimeter is defined in. `*` is not allowed, the case of allowing all Google Cloud resources only is not supported.
+                    "resource": "A String", # A Google Cloud resource that is allowed to ingress the perimeter. Requests from these resources will be allowed to access perimeter data. Currently projects, folders, organizations, and VPCs are allowed. Project format: `projects/{project_number}` Folder format: `folders/{folder_id}` Organization format: `organizations/{organization_id}` VPC network format: `//compute.googleapis.com/projects/{PROJECT_ID}/global/networks/{NAME}`. The project may be in any Google Cloud organization, not just the organization that the perimeter is defined in. `*` is not allowed, the case of allowing all Google Cloud resources only is not supported.
                   },
                 ],
               },
@@ -653,7 +653,7 @@ 
Method Details

                     "serviceName": "A String", # The name of the API whose methods or permissions the IngressPolicy or EgressPolicy want to allow. A single ApiOperation with `service_name` field set to `*` will allow all methods AND permissions for all services.
                   },
                 ],
-                "resources": [ # A list of resources, currently only projects in the form `projects/`, protected by this ServicePerimeter that are allowed to be accessed by sources defined in the corresponding IngressFrom. If a single `*` is specified, then access to all resources inside the perimeter are allowed.
+                "resources": [ # A list of resources, currently projects, folders, and organizations in the form `projects/{project_number}`, `folders/{folder_id}`, and `organizations/{organization_id}`, protected by this ServicePerimeter that are allowed to be accessed by sources defined in the corresponding IngressFrom. If a single `*` is specified, then access to all resources inside the perimeter are allowed.
                   "A String",
                 ],
                 "roles": [ # IAM roles that represent the set of operations that the sources specified in the corresponding IngressFrom are allowed to perform in this ServicePerimeter.
@@ -663,7 +663,7 @@ 
Method Details

               "title": "A String", # Optional. Human-readable title for the ingress rule. The title must be unique within the perimeter and can not exceed 100 characters. Within the access policy, the combined length of all rule titles must not exceed 240,000 characters.
             },
           ],
-          "resources": [ # A list of Google Cloud resources that are inside of the service perimeter. Currently only projects and VPCs are allowed. Project format: `projects/{project_number}` VPC network format: `//compute.googleapis.com/projects/{PROJECT_ID}/global/networks/{NAME}`.
+          "resources": [ # A list of Google Cloud resources that are inside of the service perimeter. Currently projects, folders, and VPCs are allowed. Project format: `projects/{project_number}` Folder format: `folders/{folder_id}` VPC network format: `//compute.googleapis.com/projects/{PROJECT_ID}/global/networks/{NAME}`.
             "A String",
           ],
           "restrictedServices": [ # Google Cloud services that are subject to the Service Perimeter restrictions. For example, if `storage.googleapis.com` is specified, access to the storage buckets inside the perimeter must meet the perimeter's access restrictions.
diff --git a/docs/dyn/cloudasset_v1.v1.html b/docs/dyn/cloudasset_v1.v1.html
index 58fa21616c..d9c046b3bf 100644
--- a/docs/dyn/cloudasset_v1.v1.html
+++ b/docs/dyn/cloudasset_v1.v1.html
@@ -1367,7 +1367,7 @@ 
Method Details

                       "pscEndpoint": { # Specifies the Private Service Connect endpoint that an API call refers to. # A PrivateServiceConnectEndpoint that is allowed to access data outside the perimeter. The Private Service Connect endpoint may be in any organization, not just the organization that the perimeter is defined in.
                         "forwardingRule": "A String", # The full resource name of the global forwarding rule that identifies a Private Service Connect endpoint. Forwarding rule format: `//compute.googleapis.com/projects/{PROJECT_ID}/global/forwardingRules/{FORWARDING_RULE_ID}`.
                       },
-                      "resource": "A String", # A Google Cloud resource from the service perimeter that you want to allow to access data outside the perimeter. This field supports only projects. The project format is `projects/{project_number}`. You can't use `*` in this field to allow all Google Cloud resources.
+                      "resource": "A String", # A Google Cloud resource from the service perimeter that you want to allow to access data outside the perimeter. This field supports projects, folders, and organizations in the form `projects/`, `folders/`, and `organizations/`. You can't use `*` in this field to allow all Google Cloud resources.
                     },
                   ],
                 },
@@ -1386,7 +1386,7 @@ 
Method Details

                       "serviceName": "A String", # The name of the API whose methods or permissions the IngressPolicy or EgressPolicy want to allow. A single ApiOperation with `service_name` field set to `*` will allow all methods AND permissions for all services.
                     },
                   ],
-                  "resources": [ # A list of resources, currently only projects in the form `projects/`, that are allowed to be accessed by sources defined in the corresponding EgressFrom. A request matches if it contains a resource in this list. If `*` is specified for `resources`, then this EgressTo rule will authorize access to all resources outside the perimeter.
+                  "resources": [ # A list of resources, currently projects, folders, and organizations in the form `projects/`, `folders/`, and `organizations/`, that are allowed to be accessed by sources defined in the corresponding EgressFrom. A request matches if it contains a resource in this list. If `*` is specified for `resources`, then this EgressTo rule will authorize access to all resources outside the perimeter.
                     "A String",
                   ],
                   "roles": [ # IAM roles that represent the set of operations that the sources specified in the corresponding EgressFrom. are allowed to perform in this ServicePerimeter.
@@ -1409,7 +1409,7 @@ 
Method Details

                       "pscEndpoint": { # Specifies the Private Service Connect endpoint that an API call refers to. # A PrivateServiceConnectEndpoint that is allowed to access the perimeter. The Private Service Connect endpoint may be in any organization, not just the organization that the perimeter is defined in.
                         "forwardingRule": "A String", # The full resource name of the global forwarding rule that identifies a Private Service Connect endpoint. Forwarding rule format: `//compute.googleapis.com/projects/{PROJECT_ID}/global/forwardingRules/{FORWARDING_RULE_ID}`.
                       },
-                      "resource": "A String", # A Google Cloud resource that is allowed to ingress the perimeter. Requests from these resources will be allowed to access perimeter data. Currently only projects and VPCs are allowed. Project format: `projects/{project_number}` VPC network format: `//compute.googleapis.com/projects/{PROJECT_ID}/global/networks/{NAME}`. The project may be in any Google Cloud organization, not just the organization that the perimeter is defined in. `*` is not allowed, the case of allowing all Google Cloud resources only is not supported.
+                      "resource": "A String", # A Google Cloud resource that is allowed to ingress the perimeter. Requests from these resources will be allowed to access perimeter data. Currently projects, folders, organizations, and VPCs are allowed. Project format: `projects/{project_number}` Folder format: `folders/{folder_id}` Organization format: `organizations/{organization_id}` VPC network format: `//compute.googleapis.com/projects/{PROJECT_ID}/global/networks/{NAME}`. The project may be in any Google Cloud organization, not just the organization that the perimeter is defined in. `*` is not allowed, the case of allowing all Google Cloud resources only is not supported.
                     },
                   ],
                 },
@@ -1425,7 +1425,7 @@ 
Method Details

                       "serviceName": "A String", # The name of the API whose methods or permissions the IngressPolicy or EgressPolicy want to allow. A single ApiOperation with `service_name` field set to `*` will allow all methods AND permissions for all services.
                     },
                   ],
-                  "resources": [ # A list of resources, currently only projects in the form `projects/`, protected by this ServicePerimeter that are allowed to be accessed by sources defined in the corresponding IngressFrom. If a single `*` is specified, then access to all resources inside the perimeter are allowed.
+                  "resources": [ # A list of resources, currently projects, folders, and organizations in the form `projects/{project_number}`, `folders/{folder_id}`, and `organizations/{organization_id}`, protected by this ServicePerimeter that are allowed to be accessed by sources defined in the corresponding IngressFrom. If a single `*` is specified, then access to all resources inside the perimeter are allowed.
                     "A String",
                   ],
                   "roles": [ # IAM roles that represent the set of operations that the sources specified in the corresponding IngressFrom are allowed to perform in this ServicePerimeter.
@@ -1435,7 +1435,7 @@ 
Method Details

                 "title": "A String", # Optional. Human-readable title for the ingress rule. The title must be unique within the perimeter and can not exceed 100 characters. Within the access policy, the combined length of all rule titles must not exceed 240,000 characters.
               },
             ],
-            "resources": [ # A list of Google Cloud resources that are inside of the service perimeter. Currently only projects and VPCs are allowed. Project format: `projects/{project_number}` VPC network format: `//compute.googleapis.com/projects/{PROJECT_ID}/global/networks/{NAME}`.
+            "resources": [ # A list of Google Cloud resources that are inside of the service perimeter. Currently projects, folders, and VPCs are allowed. Project format: `projects/{project_number}` Folder format: `folders/{folder_id}` VPC network format: `//compute.googleapis.com/projects/{PROJECT_ID}/global/networks/{NAME}`.
               "A String",
             ],
             "restrictedServices": [ # Google Cloud services that are subject to the Service Perimeter restrictions. For example, if `storage.googleapis.com` is specified, access to the storage buckets inside the perimeter must meet the perimeter's access restrictions.
@@ -1483,7 +1483,7 @@ 
Method Details

                       "pscEndpoint": { # Specifies the Private Service Connect endpoint that an API call refers to. # A PrivateServiceConnectEndpoint that is allowed to access data outside the perimeter. The Private Service Connect endpoint may be in any organization, not just the organization that the perimeter is defined in.
                         "forwardingRule": "A String", # The full resource name of the global forwarding rule that identifies a Private Service Connect endpoint. Forwarding rule format: `//compute.googleapis.com/projects/{PROJECT_ID}/global/forwardingRules/{FORWARDING_RULE_ID}`.
                       },
-                      "resource": "A String", # A Google Cloud resource from the service perimeter that you want to allow to access data outside the perimeter. This field supports only projects. The project format is `projects/{project_number}`. You can't use `*` in this field to allow all Google Cloud resources.
+                      "resource": "A String", # A Google Cloud resource from the service perimeter that you want to allow to access data outside the perimeter. This field supports projects, folders, and organizations in the form `projects/`, `folders/`, and `organizations/`. You can't use `*` in this field to allow all Google Cloud resources.
                     },
                   ],
                 },
@@ -1502,7 +1502,7 @@ 
Method Details

                       "serviceName": "A String", # The name of the API whose methods or permissions the IngressPolicy or EgressPolicy want to allow. A single ApiOperation with `service_name` field set to `*` will allow all methods AND permissions for all services.
                     },
                   ],
-                  "resources": [ # A list of resources, currently only projects in the form `projects/`, that are allowed to be accessed by sources defined in the corresponding EgressFrom. A request matches if it contains a resource in this list. If `*` is specified for `resources`, then this EgressTo rule will authorize access to all resources outside the perimeter.
+                  "resources": [ # A list of resources, currently projects, folders, and organizations in the form `projects/`, `folders/`, and `organizations/`, that are allowed to be accessed by sources defined in the corresponding EgressFrom. A request matches if it contains a resource in this list. If `*` is specified for `resources`, then this EgressTo rule will authorize access to all resources outside the perimeter.
                     "A String",
                   ],
                   "roles": [ # IAM roles that represent the set of operations that the sources specified in the corresponding EgressFrom. are allowed to perform in this ServicePerimeter.
@@ -1525,7 +1525,7 @@ 
Method Details

                       "pscEndpoint": { # Specifies the Private Service Connect endpoint that an API call refers to. # A PrivateServiceConnectEndpoint that is allowed to access the perimeter. The Private Service Connect endpoint may be in any organization, not just the organization that the perimeter is defined in.
                         "forwardingRule": "A String", # The full resource name of the global forwarding rule that identifies a Private Service Connect endpoint. Forwarding rule format: `//compute.googleapis.com/projects/{PROJECT_ID}/global/forwardingRules/{FORWARDING_RULE_ID}`.
                       },
-                      "resource": "A String", # A Google Cloud resource that is allowed to ingress the perimeter. Requests from these resources will be allowed to access perimeter data. Currently only projects and VPCs are allowed. Project format: `projects/{project_number}` VPC network format: `//compute.googleapis.com/projects/{PROJECT_ID}/global/networks/{NAME}`. The project may be in any Google Cloud organization, not just the organization that the perimeter is defined in. `*` is not allowed, the case of allowing all Google Cloud resources only is not supported.
+                      "resource": "A String", # A Google Cloud resource that is allowed to ingress the perimeter. Requests from these resources will be allowed to access perimeter data. Currently projects, folders, organizations, and VPCs are allowed. Project format: `projects/{project_number}` Folder format: `folders/{folder_id}` Organization format: `organizations/{organization_id}` VPC network format: `//compute.googleapis.com/projects/{PROJECT_ID}/global/networks/{NAME}`. The project may be in any Google Cloud organization, not just the organization that the perimeter is defined in. `*` is not allowed, the case of allowing all Google Cloud resources only is not supported.
                     },
                   ],
                 },
@@ -1541,7 +1541,7 @@ 
Method Details

                       "serviceName": "A String", # The name of the API whose methods or permissions the IngressPolicy or EgressPolicy want to allow. A single ApiOperation with `service_name` field set to `*` will allow all methods AND permissions for all services.
                     },
                   ],
-                  "resources": [ # A list of resources, currently only projects in the form `projects/`, protected by this ServicePerimeter that are allowed to be accessed by sources defined in the corresponding IngressFrom. If a single `*` is specified, then access to all resources inside the perimeter are allowed.
+                  "resources": [ # A list of resources, currently projects, folders, and organizations in the form `projects/{project_number}`, `folders/{folder_id}`, and `organizations/{organization_id}`, protected by this ServicePerimeter that are allowed to be accessed by sources defined in the corresponding IngressFrom. If a single `*` is specified, then access to all resources inside the perimeter are allowed.
                     "A String",
                   ],
                   "roles": [ # IAM roles that represent the set of operations that the sources specified in the corresponding IngressFrom are allowed to perform in this ServicePerimeter.
@@ -1551,7 +1551,7 @@ 
Method Details

                 "title": "A String", # Optional. Human-readable title for the ingress rule. The title must be unique within the perimeter and can not exceed 100 characters. Within the access policy, the combined length of all rule titles must not exceed 240,000 characters.
               },
             ],
-            "resources": [ # A list of Google Cloud resources that are inside of the service perimeter. Currently only projects and VPCs are allowed. Project format: `projects/{project_number}` VPC network format: `//compute.googleapis.com/projects/{PROJECT_ID}/global/networks/{NAME}`.
+            "resources": [ # A list of Google Cloud resources that are inside of the service perimeter. Currently projects, folders, and VPCs are allowed. Project format: `projects/{project_number}` Folder format: `folders/{folder_id}` VPC network format: `//compute.googleapis.com/projects/{PROJECT_ID}/global/networks/{NAME}`.
               "A String",
             ],
             "restrictedServices": [ # Google Cloud services that are subject to the Service Perimeter restrictions. For example, if `storage.googleapis.com` is specified, access to the storage buckets inside the perimeter must meet the perimeter's access restrictions.
@@ -1947,7 +1947,7 @@ 
Method Details

                       "pscEndpoint": { # Specifies the Private Service Connect endpoint that an API call refers to. # A PrivateServiceConnectEndpoint that is allowed to access data outside the perimeter. The Private Service Connect endpoint may be in any organization, not just the organization that the perimeter is defined in.
                         "forwardingRule": "A String", # The full resource name of the global forwarding rule that identifies a Private Service Connect endpoint. Forwarding rule format: `//compute.googleapis.com/projects/{PROJECT_ID}/global/forwardingRules/{FORWARDING_RULE_ID}`.
                       },
-                      "resource": "A String", # A Google Cloud resource from the service perimeter that you want to allow to access data outside the perimeter. This field supports only projects. The project format is `projects/{project_number}`. You can't use `*` in this field to allow all Google Cloud resources.
+                      "resource": "A String", # A Google Cloud resource from the service perimeter that you want to allow to access data outside the perimeter. This field supports projects, folders, and organizations in the form `projects/`, `folders/`, and `organizations/`. You can't use `*` in this field to allow all Google Cloud resources.
                     },
                   ],
                 },
@@ -1966,7 +1966,7 @@ 
Method Details

                       "serviceName": "A String", # The name of the API whose methods or permissions the IngressPolicy or EgressPolicy want to allow. A single ApiOperation with `service_name` field set to `*` will allow all methods AND permissions for all services.
                     },
                   ],
-                  "resources": [ # A list of resources, currently only projects in the form `projects/`, that are allowed to be accessed by sources defined in the corresponding EgressFrom. A request matches if it contains a resource in this list. If `*` is specified for `resources`, then this EgressTo rule will authorize access to all resources outside the perimeter.
+                  "resources": [ # A list of resources, currently projects, folders, and organizations in the form `projects/`, `folders/`, and `organizations/`, that are allowed to be accessed by sources defined in the corresponding EgressFrom. A request matches if it contains a resource in this list. If `*` is specified for `resources`, then this EgressTo rule will authorize access to all resources outside the perimeter.
                     "A String",
                   ],
                   "roles": [ # IAM roles that represent the set of operations that the sources specified in the corresponding EgressFrom. are allowed to perform in this ServicePerimeter.
@@ -1989,7 +1989,7 @@ 
Method Details

                       "pscEndpoint": { # Specifies the Private Service Connect endpoint that an API call refers to. # A PrivateServiceConnectEndpoint that is allowed to access the perimeter. The Private Service Connect endpoint may be in any organization, not just the organization that the perimeter is defined in.
                         "forwardingRule": "A String", # The full resource name of the global forwarding rule that identifies a Private Service Connect endpoint. Forwarding rule format: `//compute.googleapis.com/projects/{PROJECT_ID}/global/forwardingRules/{FORWARDING_RULE_ID}`.
                       },
-                      "resource": "A String", # A Google Cloud resource that is allowed to ingress the perimeter. Requests from these resources will be allowed to access perimeter data. Currently only projects and VPCs are allowed. Project format: `projects/{project_number}` VPC network format: `//compute.googleapis.com/projects/{PROJECT_ID}/global/networks/{NAME}`. The project may be in any Google Cloud organization, not just the organization that the perimeter is defined in. `*` is not allowed, the case of allowing all Google Cloud resources only is not supported.
+                      "resource": "A String", # A Google Cloud resource that is allowed to ingress the perimeter. Requests from these resources will be allowed to access perimeter data. Currently projects, folders, organizations, and VPCs are allowed. Project format: `projects/{project_number}` Folder format: `folders/{folder_id}` Organization format: `organizations/{organization_id}` VPC network format: `//compute.googleapis.com/projects/{PROJECT_ID}/global/networks/{NAME}`. The project may be in any Google Cloud organization, not just the organization that the perimeter is defined in. `*` is not allowed, the case of allowing all Google Cloud resources only is not supported.
                     },
                   ],
                 },
@@ -2005,7 +2005,7 @@ 
Method Details

                       "serviceName": "A String", # The name of the API whose methods or permissions the IngressPolicy or EgressPolicy want to allow. A single ApiOperation with `service_name` field set to `*` will allow all methods AND permissions for all services.
                     },
                   ],
-                  "resources": [ # A list of resources, currently only projects in the form `projects/`, protected by this ServicePerimeter that are allowed to be accessed by sources defined in the corresponding IngressFrom. If a single `*` is specified, then access to all resources inside the perimeter are allowed.
+                  "resources": [ # A list of resources, currently projects, folders, and organizations in the form `projects/{project_number}`, `folders/{folder_id}`, and `organizations/{organization_id}`, protected by this ServicePerimeter that are allowed to be accessed by sources defined in the corresponding IngressFrom. If a single `*` is specified, then access to all resources inside the perimeter are allowed.
                     "A String",
                   ],
                   "roles": [ # IAM roles that represent the set of operations that the sources specified in the corresponding IngressFrom are allowed to perform in this ServicePerimeter.
@@ -2015,7 +2015,7 @@ 
Method Details

                 "title": "A String", # Optional. Human-readable title for the ingress rule. The title must be unique within the perimeter and can not exceed 100 characters. Within the access policy, the combined length of all rule titles must not exceed 240,000 characters.
               },
             ],
-            "resources": [ # A list of Google Cloud resources that are inside of the service perimeter. Currently only projects and VPCs are allowed. Project format: `projects/{project_number}` VPC network format: `//compute.googleapis.com/projects/{PROJECT_ID}/global/networks/{NAME}`.
+            "resources": [ # A list of Google Cloud resources that are inside of the service perimeter. Currently projects, folders, and VPCs are allowed. Project format: `projects/{project_number}` Folder format: `folders/{folder_id}` VPC network format: `//compute.googleapis.com/projects/{PROJECT_ID}/global/networks/{NAME}`.
               "A String",
             ],
             "restrictedServices": [ # Google Cloud services that are subject to the Service Perimeter restrictions. For example, if `storage.googleapis.com` is specified, access to the storage buckets inside the perimeter must meet the perimeter's access restrictions.
@@ -2063,7 +2063,7 @@ 
Method Details

                       "pscEndpoint": { # Specifies the Private Service Connect endpoint that an API call refers to. # A PrivateServiceConnectEndpoint that is allowed to access data outside the perimeter. The Private Service Connect endpoint may be in any organization, not just the organization that the perimeter is defined in.
                         "forwardingRule": "A String", # The full resource name of the global forwarding rule that identifies a Private Service Connect endpoint. Forwarding rule format: `//compute.googleapis.com/projects/{PROJECT_ID}/global/forwardingRules/{FORWARDING_RULE_ID}`.
                       },
-                      "resource": "A String", # A Google Cloud resource from the service perimeter that you want to allow to access data outside the perimeter. This field supports only projects. The project format is `projects/{project_number}`. You can't use `*` in this field to allow all Google Cloud resources.
+                      "resource": "A String", # A Google Cloud resource from the service perimeter that you want to allow to access data outside the perimeter. This field supports projects, folders, and organizations in the form `projects/`, `folders/`, and `organizations/`. You can't use `*` in this field to allow all Google Cloud resources.
                     },
                   ],
                 },
@@ -2082,7 +2082,7 @@ 
Method Details

                       "serviceName": "A String", # The name of the API whose methods or permissions the IngressPolicy or EgressPolicy want to allow. A single ApiOperation with `service_name` field set to `*` will allow all methods AND permissions for all services.
                     },
                   ],
-                  "resources": [ # A list of resources, currently only projects in the form `projects/`, that are allowed to be accessed by sources defined in the corresponding EgressFrom. A request matches if it contains a resource in this list. If `*` is specified for `resources`, then this EgressTo rule will authorize access to all resources outside the perimeter.
+                  "resources": [ # A list of resources, currently projects, folders, and organizations in the form `projects/`, `folders/`, and `organizations/`, that are allowed to be accessed by sources defined in the corresponding EgressFrom. A request matches if it contains a resource in this list. If `*` is specified for `resources`, then this EgressTo rule will authorize access to all resources outside the perimeter.
                     "A String",
                   ],
                   "roles": [ # IAM roles that represent the set of operations that the sources specified in the corresponding EgressFrom. are allowed to perform in this ServicePerimeter.
@@ -2105,7 +2105,7 @@ 
Method Details

                       "pscEndpoint": { # Specifies the Private Service Connect endpoint that an API call refers to. # A PrivateServiceConnectEndpoint that is allowed to access the perimeter. The Private Service Connect endpoint may be in any organization, not just the organization that the perimeter is defined in.
                         "forwardingRule": "A String", # The full resource name of the global forwarding rule that identifies a Private Service Connect endpoint. Forwarding rule format: `//compute.googleapis.com/projects/{PROJECT_ID}/global/forwardingRules/{FORWARDING_RULE_ID}`.
                       },
-                      "resource": "A String", # A Google Cloud resource that is allowed to ingress the perimeter. Requests from these resources will be allowed to access perimeter data. Currently only projects and VPCs are allowed. Project format: `projects/{project_number}` VPC network format: `//compute.googleapis.com/projects/{PROJECT_ID}/global/networks/{NAME}`. The project may be in any Google Cloud organization, not just the organization that the perimeter is defined in. `*` is not allowed, the case of allowing all Google Cloud resources only is not supported.
+                      "resource": "A String", # A Google Cloud resource that is allowed to ingress the perimeter. Requests from these resources will be allowed to access perimeter data. Currently projects, folders, organizations, and VPCs are allowed. Project format: `projects/{project_number}` Folder format: `folders/{folder_id}` Organization format: `organizations/{organization_id}` VPC network format: `//compute.googleapis.com/projects/{PROJECT_ID}/global/networks/{NAME}`. The project may be in any Google Cloud organization, not just the organization that the perimeter is defined in. `*` is not allowed, the case of allowing all Google Cloud resources only is not supported.
                     },
                   ],
                 },
@@ -2121,7 +2121,7 @@ 
Method Details

                       "serviceName": "A String", # The name of the API whose methods or permissions the IngressPolicy or EgressPolicy want to allow. A single ApiOperation with `service_name` field set to `*` will allow all methods AND permissions for all services.
                     },
                   ],
-                  "resources": [ # A list of resources, currently only projects in the form `projects/`, protected by this ServicePerimeter that are allowed to be accessed by sources defined in the corresponding IngressFrom. If a single `*` is specified, then access to all resources inside the perimeter are allowed.
+                  "resources": [ # A list of resources, currently projects, folders, and organizations in the form `projects/{project_number}`, `folders/{folder_id}`, and `organizations/{organization_id}`, protected by this ServicePerimeter that are allowed to be accessed by sources defined in the corresponding IngressFrom. If a single `*` is specified, then access to all resources inside the perimeter are allowed.
                     "A String",
                   ],
                   "roles": [ # IAM roles that represent the set of operations that the sources specified in the corresponding IngressFrom are allowed to perform in this ServicePerimeter.
@@ -2131,7 +2131,7 @@ 
Method Details

                 "title": "A String", # Optional. Human-readable title for the ingress rule. The title must be unique within the perimeter and can not exceed 100 characters. Within the access policy, the combined length of all rule titles must not exceed 240,000 characters.
               },
             ],
-            "resources": [ # A list of Google Cloud resources that are inside of the service perimeter. Currently only projects and VPCs are allowed. Project format: `projects/{project_number}` VPC network format: `//compute.googleapis.com/projects/{PROJECT_ID}/global/networks/{NAME}`.
+            "resources": [ # A list of Google Cloud resources that are inside of the service perimeter. Currently projects, folders, and VPCs are allowed. Project format: `projects/{project_number}` Folder format: `folders/{folder_id}` VPC network format: `//compute.googleapis.com/projects/{PROJECT_ID}/global/networks/{NAME}`.
               "A String",
             ],
             "restrictedServices": [ # Google Cloud services that are subject to the Service Perimeter restrictions. For example, if `storage.googleapis.com` is specified, access to the storage buckets inside the perimeter must meet the perimeter's access restrictions.
diff --git a/docs/dyn/cloudasset_v1beta1.organizations.html b/docs/dyn/cloudasset_v1beta1.organizations.html
index 2d04b8401c..a915174934 100644
--- a/docs/dyn/cloudasset_v1beta1.organizations.html
+++ b/docs/dyn/cloudasset_v1beta1.organizations.html
@@ -275,7 +275,7 @@ 
Method Details

                       "pscEndpoint": { # Specifies the Private Service Connect endpoint that an API call refers to. # A PrivateServiceConnectEndpoint that is allowed to access data outside the perimeter. The Private Service Connect endpoint may be in any organization, not just the organization that the perimeter is defined in.
                         "forwardingRule": "A String", # The full resource name of the global forwarding rule that identifies a Private Service Connect endpoint. Forwarding rule format: `//compute.googleapis.com/projects/{PROJECT_ID}/global/forwardingRules/{FORWARDING_RULE_ID}`.
                       },
-                      "resource": "A String", # A Google Cloud resource from the service perimeter that you want to allow to access data outside the perimeter. This field supports only projects. The project format is `projects/{project_number}`. You can't use `*` in this field to allow all Google Cloud resources.
+                      "resource": "A String", # A Google Cloud resource from the service perimeter that you want to allow to access data outside the perimeter. This field supports projects, folders, and organizations in the form `projects/`, `folders/`, and `organizations/`. You can't use `*` in this field to allow all Google Cloud resources.
                     },
                   ],
                 },
@@ -294,7 +294,7 @@ 
Method Details

                       "serviceName": "A String", # The name of the API whose methods or permissions the IngressPolicy or EgressPolicy want to allow. A single ApiOperation with `service_name` field set to `*` will allow all methods AND permissions for all services.
                     },
                   ],
-                  "resources": [ # A list of resources, currently only projects in the form `projects/`, that are allowed to be accessed by sources defined in the corresponding EgressFrom. A request matches if it contains a resource in this list. If `*` is specified for `resources`, then this EgressTo rule will authorize access to all resources outside the perimeter.
+                  "resources": [ # A list of resources, currently projects, folders, and organizations in the form `projects/`, `folders/`, and `organizations/`, that are allowed to be accessed by sources defined in the corresponding EgressFrom. A request matches if it contains a resource in this list. If `*` is specified for `resources`, then this EgressTo rule will authorize access to all resources outside the perimeter.
                     "A String",
                   ],
                   "roles": [ # IAM roles that represent the set of operations that the sources specified in the corresponding EgressFrom. are allowed to perform in this ServicePerimeter.
@@ -317,7 +317,7 @@ 
Method Details

                       "pscEndpoint": { # Specifies the Private Service Connect endpoint that an API call refers to. # A PrivateServiceConnectEndpoint that is allowed to access the perimeter. The Private Service Connect endpoint may be in any organization, not just the organization that the perimeter is defined in.
                         "forwardingRule": "A String", # The full resource name of the global forwarding rule that identifies a Private Service Connect endpoint. Forwarding rule format: `//compute.googleapis.com/projects/{PROJECT_ID}/global/forwardingRules/{FORWARDING_RULE_ID}`.
                       },
-                      "resource": "A String", # A Google Cloud resource that is allowed to ingress the perimeter. Requests from these resources will be allowed to access perimeter data. Currently only projects and VPCs are allowed. Project format: `projects/{project_number}` VPC network format: `//compute.googleapis.com/projects/{PROJECT_ID}/global/networks/{NAME}`. The project may be in any Google Cloud organization, not just the organization that the perimeter is defined in. `*` is not allowed, the case of allowing all Google Cloud resources only is not supported.
+                      "resource": "A String", # A Google Cloud resource that is allowed to ingress the perimeter. Requests from these resources will be allowed to access perimeter data. Currently projects, folders, organizations, and VPCs are allowed. Project format: `projects/{project_number}` Folder format: `folders/{folder_id}` Organization format: `organizations/{organization_id}` VPC network format: `//compute.googleapis.com/projects/{PROJECT_ID}/global/networks/{NAME}`. The project may be in any Google Cloud organization, not just the organization that the perimeter is defined in. `*` is not allowed, the case of allowing all Google Cloud resources only is not supported.
                     },
                   ],
                 },
@@ -333,7 +333,7 @@ 
Method Details

                       "serviceName": "A String", # The name of the API whose methods or permissions the IngressPolicy or EgressPolicy want to allow. A single ApiOperation with `service_name` field set to `*` will allow all methods AND permissions for all services.
                     },
                   ],
-                  "resources": [ # A list of resources, currently only projects in the form `projects/`, protected by this ServicePerimeter that are allowed to be accessed by sources defined in the corresponding IngressFrom. If a single `*` is specified, then access to all resources inside the perimeter are allowed.
+                  "resources": [ # A list of resources, currently projects, folders, and organizations in the form `projects/{project_number}`, `folders/{folder_id}`, and `organizations/{organization_id}`, protected by this ServicePerimeter that are allowed to be accessed by sources defined in the corresponding IngressFrom. If a single `*` is specified, then access to all resources inside the perimeter are allowed.
                     "A String",
                   ],
                   "roles": [ # IAM roles that represent the set of operations that the sources specified in the corresponding IngressFrom are allowed to perform in this ServicePerimeter.
@@ -343,7 +343,7 @@ 
Method Details

                 "title": "A String", # Optional. Human-readable title for the ingress rule. The title must be unique within the perimeter and can not exceed 100 characters. Within the access policy, the combined length of all rule titles must not exceed 240,000 characters.
               },
             ],
-            "resources": [ # A list of Google Cloud resources that are inside of the service perimeter. Currently only projects and VPCs are allowed. Project format: `projects/{project_number}` VPC network format: `//compute.googleapis.com/projects/{PROJECT_ID}/global/networks/{NAME}`.
+            "resources": [ # A list of Google Cloud resources that are inside of the service perimeter. Currently projects, folders, and VPCs are allowed. Project format: `projects/{project_number}` Folder format: `folders/{folder_id}` VPC network format: `//compute.googleapis.com/projects/{PROJECT_ID}/global/networks/{NAME}`.
               "A String",
             ],
             "restrictedServices": [ # Google Cloud services that are subject to the Service Perimeter restrictions. For example, if `storage.googleapis.com` is specified, access to the storage buckets inside the perimeter must meet the perimeter's access restrictions.
@@ -391,7 +391,7 @@ 
Method Details

                       "pscEndpoint": { # Specifies the Private Service Connect endpoint that an API call refers to. # A PrivateServiceConnectEndpoint that is allowed to access data outside the perimeter. The Private Service Connect endpoint may be in any organization, not just the organization that the perimeter is defined in.
                         "forwardingRule": "A String", # The full resource name of the global forwarding rule that identifies a Private Service Connect endpoint. Forwarding rule format: `//compute.googleapis.com/projects/{PROJECT_ID}/global/forwardingRules/{FORWARDING_RULE_ID}`.
                       },
-                      "resource": "A String", # A Google Cloud resource from the service perimeter that you want to allow to access data outside the perimeter. This field supports only projects. The project format is `projects/{project_number}`. You can't use `*` in this field to allow all Google Cloud resources.
+                      "resource": "A String", # A Google Cloud resource from the service perimeter that you want to allow to access data outside the perimeter. This field supports projects, folders, and organizations in the form `projects/`, `folders/`, and `organizations/`. You can't use `*` in this field to allow all Google Cloud resources.
                     },
                   ],
                 },
@@ -410,7 +410,7 @@ 
Method Details

                       "serviceName": "A String", # The name of the API whose methods or permissions the IngressPolicy or EgressPolicy want to allow. A single ApiOperation with `service_name` field set to `*` will allow all methods AND permissions for all services.
                     },
                   ],
-                  "resources": [ # A list of resources, currently only projects in the form `projects/`, that are allowed to be accessed by sources defined in the corresponding EgressFrom. A request matches if it contains a resource in this list. If `*` is specified for `resources`, then this EgressTo rule will authorize access to all resources outside the perimeter.
+                  "resources": [ # A list of resources, currently projects, folders, and organizations in the form `projects/`, `folders/`, and `organizations/`, that are allowed to be accessed by sources defined in the corresponding EgressFrom. A request matches if it contains a resource in this list. If `*` is specified for `resources`, then this EgressTo rule will authorize access to all resources outside the perimeter.
                     "A String",
                   ],
                   "roles": [ # IAM roles that represent the set of operations that the sources specified in the corresponding EgressFrom. are allowed to perform in this ServicePerimeter.
@@ -433,7 +433,7 @@ 
Method Details

                       "pscEndpoint": { # Specifies the Private Service Connect endpoint that an API call refers to. # A PrivateServiceConnectEndpoint that is allowed to access the perimeter. The Private Service Connect endpoint may be in any organization, not just the organization that the perimeter is defined in.
                         "forwardingRule": "A String", # The full resource name of the global forwarding rule that identifies a Private Service Connect endpoint. Forwarding rule format: `//compute.googleapis.com/projects/{PROJECT_ID}/global/forwardingRules/{FORWARDING_RULE_ID}`.
                       },
-                      "resource": "A String", # A Google Cloud resource that is allowed to ingress the perimeter. Requests from these resources will be allowed to access perimeter data. Currently only projects and VPCs are allowed. Project format: `projects/{project_number}` VPC network format: `//compute.googleapis.com/projects/{PROJECT_ID}/global/networks/{NAME}`. The project may be in any Google Cloud organization, not just the organization that the perimeter is defined in. `*` is not allowed, the case of allowing all Google Cloud resources only is not supported.
+                      "resource": "A String", # A Google Cloud resource that is allowed to ingress the perimeter. Requests from these resources will be allowed to access perimeter data. Currently projects, folders, organizations, and VPCs are allowed. Project format: `projects/{project_number}` Folder format: `folders/{folder_id}` Organization format: `organizations/{organization_id}` VPC network format: `//compute.googleapis.com/projects/{PROJECT_ID}/global/networks/{NAME}`. The project may be in any Google Cloud organization, not just the organization that the perimeter is defined in. `*` is not allowed, the case of allowing all Google Cloud resources only is not supported.
                     },
                   ],
                 },
@@ -449,7 +449,7 @@ 
Method Details

                       "serviceName": "A String", # The name of the API whose methods or permissions the IngressPolicy or EgressPolicy want to allow. A single ApiOperation with `service_name` field set to `*` will allow all methods AND permissions for all services.
                     },
                   ],
-                  "resources": [ # A list of resources, currently only projects in the form `projects/`, protected by this ServicePerimeter that are allowed to be accessed by sources defined in the corresponding IngressFrom. If a single `*` is specified, then access to all resources inside the perimeter are allowed.
+                  "resources": [ # A list of resources, currently projects, folders, and organizations in the form `projects/{project_number}`, `folders/{folder_id}`, and `organizations/{organization_id}`, protected by this ServicePerimeter that are allowed to be accessed by sources defined in the corresponding IngressFrom. If a single `*` is specified, then access to all resources inside the perimeter are allowed.
                     "A String",
                   ],
                   "roles": [ # IAM roles that represent the set of operations that the sources specified in the corresponding IngressFrom are allowed to perform in this ServicePerimeter.
@@ -459,7 +459,7 @@ 
Method Details

                 "title": "A String", # Optional. Human-readable title for the ingress rule. The title must be unique within the perimeter and can not exceed 100 characters. Within the access policy, the combined length of all rule titles must not exceed 240,000 characters.
               },
             ],
-            "resources": [ # A list of Google Cloud resources that are inside of the service perimeter. Currently only projects and VPCs are allowed. Project format: `projects/{project_number}` VPC network format: `//compute.googleapis.com/projects/{PROJECT_ID}/global/networks/{NAME}`.
+            "resources": [ # A list of Google Cloud resources that are inside of the service perimeter. Currently projects, folders, and VPCs are allowed. Project format: `projects/{project_number}` Folder format: `folders/{folder_id}` VPC network format: `//compute.googleapis.com/projects/{PROJECT_ID}/global/networks/{NAME}`.
               "A String",
             ],
             "restrictedServices": [ # Google Cloud services that are subject to the Service Perimeter restrictions. For example, if `storage.googleapis.com` is specified, access to the storage buckets inside the perimeter must meet the perimeter's access restrictions.
diff --git a/docs/dyn/cloudasset_v1beta1.projects.html b/docs/dyn/cloudasset_v1beta1.projects.html
index 01be7acf2b..15674ac902 100644
--- a/docs/dyn/cloudasset_v1beta1.projects.html
+++ b/docs/dyn/cloudasset_v1beta1.projects.html
@@ -275,7 +275,7 @@ 
Method Details

                       "pscEndpoint": { # Specifies the Private Service Connect endpoint that an API call refers to. # A PrivateServiceConnectEndpoint that is allowed to access data outside the perimeter. The Private Service Connect endpoint may be in any organization, not just the organization that the perimeter is defined in.
                         "forwardingRule": "A String", # The full resource name of the global forwarding rule that identifies a Private Service Connect endpoint. Forwarding rule format: `//compute.googleapis.com/projects/{PROJECT_ID}/global/forwardingRules/{FORWARDING_RULE_ID}`.
                       },
-                      "resource": "A String", # A Google Cloud resource from the service perimeter that you want to allow to access data outside the perimeter. This field supports only projects. The project format is `projects/{project_number}`. You can't use `*` in this field to allow all Google Cloud resources.
+                      "resource": "A String", # A Google Cloud resource from the service perimeter that you want to allow to access data outside the perimeter. This field supports projects, folders, and organizations in the form `projects/`, `folders/`, and `organizations/`. You can't use `*` in this field to allow all Google Cloud resources.
                     },
                   ],
                 },
@@ -294,7 +294,7 @@ 
Method Details

                       "serviceName": "A String", # The name of the API whose methods or permissions the IngressPolicy or EgressPolicy want to allow. A single ApiOperation with `service_name` field set to `*` will allow all methods AND permissions for all services.
                     },
                   ],
-                  "resources": [ # A list of resources, currently only projects in the form `projects/`, that are allowed to be accessed by sources defined in the corresponding EgressFrom. A request matches if it contains a resource in this list. If `*` is specified for `resources`, then this EgressTo rule will authorize access to all resources outside the perimeter.
+                  "resources": [ # A list of resources, currently projects, folders, and organizations in the form `projects/`, `folders/`, and `organizations/`, that are allowed to be accessed by sources defined in the corresponding EgressFrom. A request matches if it contains a resource in this list. If `*` is specified for `resources`, then this EgressTo rule will authorize access to all resources outside the perimeter.
                     "A String",
                   ],
                   "roles": [ # IAM roles that represent the set of operations that the sources specified in the corresponding EgressFrom. are allowed to perform in this ServicePerimeter.
@@ -317,7 +317,7 @@ 
Method Details

                       "pscEndpoint": { # Specifies the Private Service Connect endpoint that an API call refers to. # A PrivateServiceConnectEndpoint that is allowed to access the perimeter. The Private Service Connect endpoint may be in any organization, not just the organization that the perimeter is defined in.
                         "forwardingRule": "A String", # The full resource name of the global forwarding rule that identifies a Private Service Connect endpoint. Forwarding rule format: `//compute.googleapis.com/projects/{PROJECT_ID}/global/forwardingRules/{FORWARDING_RULE_ID}`.
                       },
-                      "resource": "A String", # A Google Cloud resource that is allowed to ingress the perimeter. Requests from these resources will be allowed to access perimeter data. Currently only projects and VPCs are allowed. Project format: `projects/{project_number}` VPC network format: `//compute.googleapis.com/projects/{PROJECT_ID}/global/networks/{NAME}`. The project may be in any Google Cloud organization, not just the organization that the perimeter is defined in. `*` is not allowed, the case of allowing all Google Cloud resources only is not supported.
+                      "resource": "A String", # A Google Cloud resource that is allowed to ingress the perimeter. Requests from these resources will be allowed to access perimeter data. Currently projects, folders, organizations, and VPCs are allowed. Project format: `projects/{project_number}` Folder format: `folders/{folder_id}` Organization format: `organizations/{organization_id}` VPC network format: `//compute.googleapis.com/projects/{PROJECT_ID}/global/networks/{NAME}`. The project may be in any Google Cloud organization, not just the organization that the perimeter is defined in. `*` is not allowed, the case of allowing all Google Cloud resources only is not supported.
                     },
                   ],
                 },
@@ -333,7 +333,7 @@ 
Method Details

                       "serviceName": "A String", # The name of the API whose methods or permissions the IngressPolicy or EgressPolicy want to allow. A single ApiOperation with `service_name` field set to `*` will allow all methods AND permissions for all services.
                     },
                   ],
-                  "resources": [ # A list of resources, currently only projects in the form `projects/`, protected by this ServicePerimeter that are allowed to be accessed by sources defined in the corresponding IngressFrom. If a single `*` is specified, then access to all resources inside the perimeter are allowed.
+                  "resources": [ # A list of resources, currently projects, folders, and organizations in the form `projects/{project_number}`, `folders/{folder_id}`, and `organizations/{organization_id}`, protected by this ServicePerimeter that are allowed to be accessed by sources defined in the corresponding IngressFrom. If a single `*` is specified, then access to all resources inside the perimeter are allowed.
                     "A String",
                   ],
                   "roles": [ # IAM roles that represent the set of operations that the sources specified in the corresponding IngressFrom are allowed to perform in this ServicePerimeter.
@@ -343,7 +343,7 @@ 
Method Details

                 "title": "A String", # Optional. Human-readable title for the ingress rule. The title must be unique within the perimeter and can not exceed 100 characters. Within the access policy, the combined length of all rule titles must not exceed 240,000 characters.
               },
             ],
-            "resources": [ # A list of Google Cloud resources that are inside of the service perimeter. Currently only projects and VPCs are allowed. Project format: `projects/{project_number}` VPC network format: `//compute.googleapis.com/projects/{PROJECT_ID}/global/networks/{NAME}`.
+            "resources": [ # A list of Google Cloud resources that are inside of the service perimeter. Currently projects, folders, and VPCs are allowed. Project format: `projects/{project_number}` Folder format: `folders/{folder_id}` VPC network format: `//compute.googleapis.com/projects/{PROJECT_ID}/global/networks/{NAME}`.
               "A String",
             ],
             "restrictedServices": [ # Google Cloud services that are subject to the Service Perimeter restrictions. For example, if `storage.googleapis.com` is specified, access to the storage buckets inside the perimeter must meet the perimeter's access restrictions.
@@ -391,7 +391,7 @@ 
Method Details

                       "pscEndpoint": { # Specifies the Private Service Connect endpoint that an API call refers to. # A PrivateServiceConnectEndpoint that is allowed to access data outside the perimeter. The Private Service Connect endpoint may be in any organization, not just the organization that the perimeter is defined in.
                         "forwardingRule": "A String", # The full resource name of the global forwarding rule that identifies a Private Service Connect endpoint. Forwarding rule format: `//compute.googleapis.com/projects/{PROJECT_ID}/global/forwardingRules/{FORWARDING_RULE_ID}`.
                       },
-                      "resource": "A String", # A Google Cloud resource from the service perimeter that you want to allow to access data outside the perimeter. This field supports only projects. The project format is `projects/{project_number}`. You can't use `*` in this field to allow all Google Cloud resources.
+                      "resource": "A String", # A Google Cloud resource from the service perimeter that you want to allow to access data outside the perimeter. This field supports projects, folders, and organizations in the form `projects/`, `folders/`, and `organizations/`. You can't use `*` in this field to allow all Google Cloud resources.
                     },
                   ],
                 },
@@ -410,7 +410,7 @@ 
Method Details

                       "serviceName": "A String", # The name of the API whose methods or permissions the IngressPolicy or EgressPolicy want to allow. A single ApiOperation with `service_name` field set to `*` will allow all methods AND permissions for all services.
                     },
                   ],
-                  "resources": [ # A list of resources, currently only projects in the form `projects/`, that are allowed to be accessed by sources defined in the corresponding EgressFrom. A request matches if it contains a resource in this list. If `*` is specified for `resources`, then this EgressTo rule will authorize access to all resources outside the perimeter.
+                  "resources": [ # A list of resources, currently projects, folders, and organizations in the form `projects/`, `folders/`, and `organizations/`, that are allowed to be accessed by sources defined in the corresponding EgressFrom. A request matches if it contains a resource in this list. If `*` is specified for `resources`, then this EgressTo rule will authorize access to all resources outside the perimeter.
                     "A String",
                   ],
                   "roles": [ # IAM roles that represent the set of operations that the sources specified in the corresponding EgressFrom. are allowed to perform in this ServicePerimeter.
@@ -433,7 +433,7 @@ 
Method Details

                       "pscEndpoint": { # Specifies the Private Service Connect endpoint that an API call refers to. # A PrivateServiceConnectEndpoint that is allowed to access the perimeter. The Private Service Connect endpoint may be in any organization, not just the organization that the perimeter is defined in.
                         "forwardingRule": "A String", # The full resource name of the global forwarding rule that identifies a Private Service Connect endpoint. Forwarding rule format: `//compute.googleapis.com/projects/{PROJECT_ID}/global/forwardingRules/{FORWARDING_RULE_ID}`.
                       },
-                      "resource": "A String", # A Google Cloud resource that is allowed to ingress the perimeter. Requests from these resources will be allowed to access perimeter data. Currently only projects and VPCs are allowed. Project format: `projects/{project_number}` VPC network format: `//compute.googleapis.com/projects/{PROJECT_ID}/global/networks/{NAME}`. The project may be in any Google Cloud organization, not just the organization that the perimeter is defined in. `*` is not allowed, the case of allowing all Google Cloud resources only is not supported.
+                      "resource": "A String", # A Google Cloud resource that is allowed to ingress the perimeter. Requests from these resources will be allowed to access perimeter data. Currently projects, folders, organizations, and VPCs are allowed. Project format: `projects/{project_number}` Folder format: `folders/{folder_id}` Organization format: `organizations/{organization_id}` VPC network format: `//compute.googleapis.com/projects/{PROJECT_ID}/global/networks/{NAME}`. The project may be in any Google Cloud organization, not just the organization that the perimeter is defined in. `*` is not allowed, the case of allowing all Google Cloud resources only is not supported.
                     },
                   ],
                 },
@@ -449,7 +449,7 @@ 
Method Details

                       "serviceName": "A String", # The name of the API whose methods or permissions the IngressPolicy or EgressPolicy want to allow. A single ApiOperation with `service_name` field set to `*` will allow all methods AND permissions for all services.
                     },
                   ],
-                  "resources": [ # A list of resources, currently only projects in the form `projects/`, protected by this ServicePerimeter that are allowed to be accessed by sources defined in the corresponding IngressFrom. If a single `*` is specified, then access to all resources inside the perimeter are allowed.
+                  "resources": [ # A list of resources, currently projects, folders, and organizations in the form `projects/{project_number}`, `folders/{folder_id}`, and `organizations/{organization_id}`, protected by this ServicePerimeter that are allowed to be accessed by sources defined in the corresponding IngressFrom. If a single `*` is specified, then access to all resources inside the perimeter are allowed.
                     "A String",
                   ],
                   "roles": [ # IAM roles that represent the set of operations that the sources specified in the corresponding IngressFrom are allowed to perform in this ServicePerimeter.
@@ -459,7 +459,7 @@ 
Method Details

                 "title": "A String", # Optional. Human-readable title for the ingress rule. The title must be unique within the perimeter and can not exceed 100 characters. Within the access policy, the combined length of all rule titles must not exceed 240,000 characters.
               },
             ],
-            "resources": [ # A list of Google Cloud resources that are inside of the service perimeter. Currently only projects and VPCs are allowed. Project format: `projects/{project_number}` VPC network format: `//compute.googleapis.com/projects/{PROJECT_ID}/global/networks/{NAME}`.
+            "resources": [ # A list of Google Cloud resources that are inside of the service perimeter. Currently projects, folders, and VPCs are allowed. Project format: `projects/{project_number}` Folder format: `folders/{folder_id}` VPC network format: `//compute.googleapis.com/projects/{PROJECT_ID}/global/networks/{NAME}`.
               "A String",
             ],
             "restrictedServices": [ # Google Cloud services that are subject to the Service Perimeter restrictions. For example, if `storage.googleapis.com` is specified, access to the storage buckets inside the perimeter must meet the perimeter's access restrictions.
diff --git a/docs/dyn/cloudasset_v1p5beta1.assets.html b/docs/dyn/cloudasset_v1p5beta1.assets.html
index d74ac7e108..36e21d3bbe 100644
--- a/docs/dyn/cloudasset_v1p5beta1.assets.html
+++ b/docs/dyn/cloudasset_v1p5beta1.assets.html
@@ -280,7 +280,7 @@ 
Method Details

                     "pscEndpoint": { # Specifies the Private Service Connect endpoint that an API call refers to. # A PrivateServiceConnectEndpoint that is allowed to access data outside the perimeter. The Private Service Connect endpoint may be in any organization, not just the organization that the perimeter is defined in.
                       "forwardingRule": "A String", # The full resource name of the global forwarding rule that identifies a Private Service Connect endpoint. Forwarding rule format: `//compute.googleapis.com/projects/{PROJECT_ID}/global/forwardingRules/{FORWARDING_RULE_ID}`.
                     },
-                    "resource": "A String", # A Google Cloud resource from the service perimeter that you want to allow to access data outside the perimeter. This field supports only projects. The project format is `projects/{project_number}`. You can't use `*` in this field to allow all Google Cloud resources.
+                    "resource": "A String", # A Google Cloud resource from the service perimeter that you want to allow to access data outside the perimeter. This field supports projects, folders, and organizations in the form `projects/`, `folders/`, and `organizations/`. You can't use `*` in this field to allow all Google Cloud resources.
                   },
                 ],
               },
@@ -299,7 +299,7 @@ 
Method Details

                     "serviceName": "A String", # The name of the API whose methods or permissions the IngressPolicy or EgressPolicy want to allow. A single ApiOperation with `service_name` field set to `*` will allow all methods AND permissions for all services.
                   },
                 ],
-                "resources": [ # A list of resources, currently only projects in the form `projects/`, that are allowed to be accessed by sources defined in the corresponding EgressFrom. A request matches if it contains a resource in this list. If `*` is specified for `resources`, then this EgressTo rule will authorize access to all resources outside the perimeter.
+                "resources": [ # A list of resources, currently projects, folders, and organizations in the form `projects/`, `folders/`, and `organizations/`, that are allowed to be accessed by sources defined in the corresponding EgressFrom. A request matches if it contains a resource in this list. If `*` is specified for `resources`, then this EgressTo rule will authorize access to all resources outside the perimeter.
                   "A String",
                 ],
                 "roles": [ # IAM roles that represent the set of operations that the sources specified in the corresponding EgressFrom. are allowed to perform in this ServicePerimeter.
@@ -322,7 +322,7 @@ 
Method Details

                     "pscEndpoint": { # Specifies the Private Service Connect endpoint that an API call refers to. # A PrivateServiceConnectEndpoint that is allowed to access the perimeter. The Private Service Connect endpoint may be in any organization, not just the organization that the perimeter is defined in.
                       "forwardingRule": "A String", # The full resource name of the global forwarding rule that identifies a Private Service Connect endpoint. Forwarding rule format: `//compute.googleapis.com/projects/{PROJECT_ID}/global/forwardingRules/{FORWARDING_RULE_ID}`.
                     },
-                    "resource": "A String", # A Google Cloud resource that is allowed to ingress the perimeter. Requests from these resources will be allowed to access perimeter data. Currently only projects and VPCs are allowed. Project format: `projects/{project_number}` VPC network format: `//compute.googleapis.com/projects/{PROJECT_ID}/global/networks/{NAME}`. The project may be in any Google Cloud organization, not just the organization that the perimeter is defined in. `*` is not allowed, the case of allowing all Google Cloud resources only is not supported.
+                    "resource": "A String", # A Google Cloud resource that is allowed to ingress the perimeter. Requests from these resources will be allowed to access perimeter data. Currently projects, folders, organizations, and VPCs are allowed. Project format: `projects/{project_number}` Folder format: `folders/{folder_id}` Organization format: `organizations/{organization_id}` VPC network format: `//compute.googleapis.com/projects/{PROJECT_ID}/global/networks/{NAME}`. The project may be in any Google Cloud organization, not just the organization that the perimeter is defined in. `*` is not allowed, the case of allowing all Google Cloud resources only is not supported.
                   },
                 ],
               },
@@ -338,7 +338,7 @@ 
Method Details

                     "serviceName": "A String", # The name of the API whose methods or permissions the IngressPolicy or EgressPolicy want to allow. A single ApiOperation with `service_name` field set to `*` will allow all methods AND permissions for all services.
                   },
                 ],
-                "resources": [ # A list of resources, currently only projects in the form `projects/`, protected by this ServicePerimeter that are allowed to be accessed by sources defined in the corresponding IngressFrom. If a single `*` is specified, then access to all resources inside the perimeter are allowed.
+                "resources": [ # A list of resources, currently projects, folders, and organizations in the form `projects/{project_number}`, `folders/{folder_id}`, and `organizations/{organization_id}`, protected by this ServicePerimeter that are allowed to be accessed by sources defined in the corresponding IngressFrom. If a single `*` is specified, then access to all resources inside the perimeter are allowed.
                   "A String",
                 ],
                 "roles": [ # IAM roles that represent the set of operations that the sources specified in the corresponding IngressFrom are allowed to perform in this ServicePerimeter.
@@ -348,7 +348,7 @@ 
Method Details

               "title": "A String", # Optional. Human-readable title for the ingress rule. The title must be unique within the perimeter and can not exceed 100 characters. Within the access policy, the combined length of all rule titles must not exceed 240,000 characters.
             },
           ],
-          "resources": [ # A list of Google Cloud resources that are inside of the service perimeter. Currently only projects and VPCs are allowed. Project format: `projects/{project_number}` VPC network format: `//compute.googleapis.com/projects/{PROJECT_ID}/global/networks/{NAME}`.
+          "resources": [ # A list of Google Cloud resources that are inside of the service perimeter. Currently projects, folders, and VPCs are allowed. Project format: `projects/{project_number}` Folder format: `folders/{folder_id}` VPC network format: `//compute.googleapis.com/projects/{PROJECT_ID}/global/networks/{NAME}`.
             "A String",
           ],
           "restrictedServices": [ # Google Cloud services that are subject to the Service Perimeter restrictions. For example, if `storage.googleapis.com` is specified, access to the storage buckets inside the perimeter must meet the perimeter's access restrictions.
@@ -396,7 +396,7 @@ 
Method Details

                     "pscEndpoint": { # Specifies the Private Service Connect endpoint that an API call refers to. # A PrivateServiceConnectEndpoint that is allowed to access data outside the perimeter. The Private Service Connect endpoint may be in any organization, not just the organization that the perimeter is defined in.
                       "forwardingRule": "A String", # The full resource name of the global forwarding rule that identifies a Private Service Connect endpoint. Forwarding rule format: `//compute.googleapis.com/projects/{PROJECT_ID}/global/forwardingRules/{FORWARDING_RULE_ID}`.
                     },
-                    "resource": "A String", # A Google Cloud resource from the service perimeter that you want to allow to access data outside the perimeter. This field supports only projects. The project format is `projects/{project_number}`. You can't use `*` in this field to allow all Google Cloud resources.
+                    "resource": "A String", # A Google Cloud resource from the service perimeter that you want to allow to access data outside the perimeter. This field supports projects, folders, and organizations in the form `projects/`, `folders/`, and `organizations/`. You can't use `*` in this field to allow all Google Cloud resources.
                   },
                 ],
               },
@@ -415,7 +415,7 @@ 
Method Details

                     "serviceName": "A String", # The name of the API whose methods or permissions the IngressPolicy or EgressPolicy want to allow. A single ApiOperation with `service_name` field set to `*` will allow all methods AND permissions for all services.
                   },
                 ],
-                "resources": [ # A list of resources, currently only projects in the form `projects/`, that are allowed to be accessed by sources defined in the corresponding EgressFrom. A request matches if it contains a resource in this list. If `*` is specified for `resources`, then this EgressTo rule will authorize access to all resources outside the perimeter.
+                "resources": [ # A list of resources, currently projects, folders, and organizations in the form `projects/`, `folders/`, and `organizations/`, that are allowed to be accessed by sources defined in the corresponding EgressFrom. A request matches if it contains a resource in this list. If `*` is specified for `resources`, then this EgressTo rule will authorize access to all resources outside the perimeter.
                   "A String",
                 ],
                 "roles": [ # IAM roles that represent the set of operations that the sources specified in the corresponding EgressFrom. are allowed to perform in this ServicePerimeter.
@@ -438,7 +438,7 @@ 
Method Details

                     "pscEndpoint": { # Specifies the Private Service Connect endpoint that an API call refers to. # A PrivateServiceConnectEndpoint that is allowed to access the perimeter. The Private Service Connect endpoint may be in any organization, not just the organization that the perimeter is defined in.
                       "forwardingRule": "A String", # The full resource name of the global forwarding rule that identifies a Private Service Connect endpoint. Forwarding rule format: `//compute.googleapis.com/projects/{PROJECT_ID}/global/forwardingRules/{FORWARDING_RULE_ID}`.
                     },
-                    "resource": "A String", # A Google Cloud resource that is allowed to ingress the perimeter. Requests from these resources will be allowed to access perimeter data. Currently only projects and VPCs are allowed. Project format: `projects/{project_number}` VPC network format: `//compute.googleapis.com/projects/{PROJECT_ID}/global/networks/{NAME}`. The project may be in any Google Cloud organization, not just the organization that the perimeter is defined in. `*` is not allowed, the case of allowing all Google Cloud resources only is not supported.
+                    "resource": "A String", # A Google Cloud resource that is allowed to ingress the perimeter. Requests from these resources will be allowed to access perimeter data. Currently projects, folders, organizations, and VPCs are allowed. Project format: `projects/{project_number}` Folder format: `folders/{folder_id}` Organization format: `organizations/{organization_id}` VPC network format: `//compute.googleapis.com/projects/{PROJECT_ID}/global/networks/{NAME}`. The project may be in any Google Cloud organization, not just the organization that the perimeter is defined in. `*` is not allowed, the case of allowing all Google Cloud resources only is not supported.
                   },
                 ],
               },
@@ -454,7 +454,7 @@ 
Method Details

                     "serviceName": "A String", # The name of the API whose methods or permissions the IngressPolicy or EgressPolicy want to allow. A single ApiOperation with `service_name` field set to `*` will allow all methods AND permissions for all services.
                   },
                 ],
-                "resources": [ # A list of resources, currently only projects in the form `projects/`, protected by this ServicePerimeter that are allowed to be accessed by sources defined in the corresponding IngressFrom. If a single `*` is specified, then access to all resources inside the perimeter are allowed.
+                "resources": [ # A list of resources, currently projects, folders, and organizations in the form `projects/{project_number}`, `folders/{folder_id}`, and `organizations/{organization_id}`, protected by this ServicePerimeter that are allowed to be accessed by sources defined in the corresponding IngressFrom. If a single `*` is specified, then access to all resources inside the perimeter are allowed.
                   "A String",
                 ],
                 "roles": [ # IAM roles that represent the set of operations that the sources specified in the corresponding IngressFrom are allowed to perform in this ServicePerimeter.
@@ -464,7 +464,7 @@ 
Method Details

               "title": "A String", # Optional. Human-readable title for the ingress rule. The title must be unique within the perimeter and can not exceed 100 characters. Within the access policy, the combined length of all rule titles must not exceed 240,000 characters.
             },
           ],
-          "resources": [ # A list of Google Cloud resources that are inside of the service perimeter. Currently only projects and VPCs are allowed. Project format: `projects/{project_number}` VPC network format: `//compute.googleapis.com/projects/{PROJECT_ID}/global/networks/{NAME}`.
+          "resources": [ # A list of Google Cloud resources that are inside of the service perimeter. Currently projects, folders, and VPCs are allowed. Project format: `projects/{project_number}` Folder format: `folders/{folder_id}` VPC network format: `//compute.googleapis.com/projects/{PROJECT_ID}/global/networks/{NAME}`.
             "A String",
           ],
           "restrictedServices": [ # Google Cloud services that are subject to the Service Perimeter restrictions. For example, if `storage.googleapis.com` is specified, access to the storage buckets inside the perimeter must meet the perimeter's access restrictions.
diff --git a/docs/dyn/cloudtasks_v2.projects.locations.html b/docs/dyn/cloudtasks_v2.projects.locations.html
index d4d2fc1603..e487a394eb 100644
--- a/docs/dyn/cloudtasks_v2.projects.locations.html
+++ b/docs/dyn/cloudtasks_v2.projects.locations.html
@@ -92,7 +92,7 @@ 
Instance Methods

 
Gets information about a location.

 

   getCmekConfig(name, x__xgafv=None)

-
Gets the CMEK config. Gets the Customer Managed Encryption Key configured with the Cloud Tasks lcoation. By default there is no kms_key configured.

+
Gets the CMEK config. Gets the Customer Managed Encryption Key configured with the Cloud Tasks location. By default there is no `kms_key` configured.

 

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

 
Lists information about the supported locations for this service. This method lists locations based on the resource scope provided in the ListLocationsRequest.name field: * **Global locations**: If `name` is empty, the method lists the public locations available to all projects. * **Project-specific locations**: If `name` follows the format `projects/{project}`, the method lists locations visible to that specific project. This includes public, private, or other project-specific locations enabled for the project. For gRPC and client library implementations, the resource name is passed as the `name` field. For direct service calls, the resource name is incorporated into the request path based on the specific service implementation and version.

@@ -137,10 +137,10 @@ 
Method Details

 
 

     getCmekConfig(name, x__xgafv=None)
-  
Gets the CMEK config. Gets the Customer Managed Encryption Key configured with the Cloud Tasks lcoation. By default there is no kms_key configured.
+  
Gets the CMEK config. Gets the Customer Managed Encryption Key configured with the Cloud Tasks location. By default there is no `kms_key` configured.
 
 Args:
-  name: string, Required. The config. For example: projects/PROJECT_ID/locations/LOCATION_ID/CmekConfig` (required)
+  name: string, Required. The config. For example: `projects/PROJECT_ID/locations/LOCATION_ID/cmekConfig` (required)
   x__xgafv: string, V1 error format.
     Allowed values
       1 - v1 error format
@@ -151,7 +151,7 @@ 
Method Details

 
     { # Describes the customer-managed encryption key (CMEK) configuration associated with a project and location.
   "kmsKey": "A String", # Resource name of the Cloud KMS key, of the form `projects/PROJECT_ID/locations/LOCATION_ID/keyRings/KEY_RING_ID/cryptoKeys/KEY_ID`, that will be used to encrypt the Queues & Tasks in the region. Setting this as blank will turn off CMEK encryption.
-  "name": "A String", # Output only. The config resource name which includes the project and location and must end in 'cmekConfig', in the format projects/PROJECT_ID/locations/LOCATION_ID/cmekConfig`
+  "name": "A String", # Output only. The config resource name which includes the project and location and must end in 'cmekConfig', in the format `projects/PROJECT_ID/locations/LOCATION_ID/cmekConfig`
 }

 

 
@@ -210,13 +210,13 @@ 
Method Details

   
Creates or Updates a CMEK config. Updates the Customer Managed Encryption Key associated with the Cloud Tasks location (Creates if the key does not already exist). All new tasks created in the location will be encrypted at-rest with the KMS-key provided in the config.
 
 Args:
-  name: string, Output only. The config resource name which includes the project and location and must end in 'cmekConfig', in the format projects/PROJECT_ID/locations/LOCATION_ID/cmekConfig` (required)
+  name: string, Output only. The config resource name which includes the project and location and must end in 'cmekConfig', in the format `projects/PROJECT_ID/locations/LOCATION_ID/cmekConfig` (required)
   body: object, The request body.
     The object takes the form of:
 
 { # Describes the customer-managed encryption key (CMEK) configuration associated with a project and location.
   "kmsKey": "A String", # Resource name of the Cloud KMS key, of the form `projects/PROJECT_ID/locations/LOCATION_ID/keyRings/KEY_RING_ID/cryptoKeys/KEY_ID`, that will be used to encrypt the Queues & Tasks in the region. Setting this as blank will turn off CMEK encryption.
-  "name": "A String", # Output only. The config resource name which includes the project and location and must end in 'cmekConfig', in the format projects/PROJECT_ID/locations/LOCATION_ID/cmekConfig`
+  "name": "A String", # Output only. The config resource name which includes the project and location and must end in 'cmekConfig', in the format `projects/PROJECT_ID/locations/LOCATION_ID/cmekConfig`
 }
 
   updateMask: string, List of fields to be updated in this request.
@@ -230,7 +230,7 @@ 
Method Details

 
     { # Describes the customer-managed encryption key (CMEK) configuration associated with a project and location.
   "kmsKey": "A String", # Resource name of the Cloud KMS key, of the form `projects/PROJECT_ID/locations/LOCATION_ID/keyRings/KEY_RING_ID/cryptoKeys/KEY_ID`, that will be used to encrypt the Queues & Tasks in the region. Setting this as blank will turn off CMEK encryption.
-  "name": "A String", # Output only. The config resource name which includes the project and location and must end in 'cmekConfig', in the format projects/PROJECT_ID/locations/LOCATION_ID/cmekConfig`
+  "name": "A String", # Output only. The config resource name which includes the project and location and must end in 'cmekConfig', in the format `projects/PROJECT_ID/locations/LOCATION_ID/cmekConfig`
 }
diff --git a/docs/dyn/cloudtasks_v2.projects.locations.queues.html b/docs/dyn/cloudtasks_v2.projects.locations.queues.html index b57ad9a140..20157e3c83 100644 --- a/docs/dyn/cloudtasks_v2.projects.locations.queues.html +++ b/docs/dyn/cloudtasks_v2.projects.locations.queues.html @@ -141,7 +141,7 @@

Method Details

"version": "A String", # App version. By default, the task is sent to the version which is the default version when the task is attempted. For some queues or tasks which were created using the App Engine Task Queue API, host is not parsable into service, version, and instance. For example, some tasks which were created using the App Engine SDK use a custom domain name; custom domains are not parsed by Cloud Tasks. If host is not parsable, then service, version, and instance are the empty string. }, "httpTarget": { # HTTP target. When specified at the Queue level, all tasks with HttpRequest are overridden according to the target. # Modifies HTTP target for HTTP tasks. - "headerOverrides": [ # HTTP target headers. This map contains the header field names and values. Headers will be set when running the CreateTask and/or BufferTask. These headers represent a subset of the headers that will be configured for the task's HTTP request. Some HTTP request headers will be ignored or replaced. A partial list of headers that will be ignored or replaced is: * Several predefined headers, prefixed with "X-CloudTasks-", can be used to define properties of the task. * Host: This will be computed by Cloud Tasks and derived from HttpRequest.url. * Content-Length: This will be computed by Cloud Tasks. `Content-Type` won't be set by Cloud Tasks. You can explicitly set `Content-Type` to a media type when the task is created. For example,`Content-Type` can be set to `"application/octet-stream"` or `"application/json"`. The default value is set to "application/json"`. * User-Agent: This will be set to `"Google-Cloud-Tasks"`. Headers which can have multiple values (according to RFC2616) can be specified using comma-separated values. The size of the headers must be less than 80KB. Queue-level headers to override headers of all the tasks in the queue. Do not put business sensitive or personally identifying data in the HTTP Header Override Configuration or other similar fields in accordance with Section 12 (Resource Fields) of the [Service Specific Terms](https://cloud.google.com/terms/service-terms). + "headerOverrides": [ # HTTP target headers. This map contains the header field names and values. Headers will be set when running the CreateTask and/or BufferTask. These headers represent a subset of the headers that will be configured for the task's HTTP request. Some HTTP request headers will be ignored or replaced. A partial list of headers that will be ignored or replaced is: * Several predefined headers, prefixed with "X-CloudTasks-", can be used to define properties of the task. * Host: This will be computed by Cloud Tasks and derived from HttpRequest.url. * Content-Length: This will be computed by Cloud Tasks. `Content-Type` won't be set by Cloud Tasks. You can explicitly set `Content-Type` to a media type when the task is created. For example, `Content-Type` can be set to `"application/octet-stream"` or `"application/json"`. The default value is set to `"application/json"`. * User-Agent: This will be set to `"Google-Cloud-Tasks"`. Headers which can have multiple values (according to RFC2616) can be specified using comma-separated values. The size of the headers must be less than 80KB. Queue-level headers to override headers of all the tasks in the queue. Do not put business sensitive or personally identifying data in the HTTP Header Override Configuration or other similar fields in accordance with Section 12 (Resource Fields) of the [Service Specific Terms](https://cloud.google.com/terms/service-terms). { # Wraps the Header object. "header": { # Defines a header message. A header can have a key and a value. # Header embodying a key and a value. Do not put business sensitive or personally identifying data in the HTTP Header Override Configuration or other similar fields in accordance with Section 12 (Resource Fields) of the [Service Specific Terms](https://cloud.google.com/terms/service-terms). "key": "A String", # The Key of the header. @@ -207,7 +207,7 @@

Method Details

"version": "A String", # App version. By default, the task is sent to the version which is the default version when the task is attempted. For some queues or tasks which were created using the App Engine Task Queue API, host is not parsable into service, version, and instance. For example, some tasks which were created using the App Engine SDK use a custom domain name; custom domains are not parsed by Cloud Tasks. If host is not parsable, then service, version, and instance are the empty string. }, "httpTarget": { # HTTP target. When specified at the Queue level, all tasks with HttpRequest are overridden according to the target. # Modifies HTTP target for HTTP tasks. - "headerOverrides": [ # HTTP target headers. This map contains the header field names and values. Headers will be set when running the CreateTask and/or BufferTask. These headers represent a subset of the headers that will be configured for the task's HTTP request. Some HTTP request headers will be ignored or replaced. A partial list of headers that will be ignored or replaced is: * Several predefined headers, prefixed with "X-CloudTasks-", can be used to define properties of the task. * Host: This will be computed by Cloud Tasks and derived from HttpRequest.url. * Content-Length: This will be computed by Cloud Tasks. `Content-Type` won't be set by Cloud Tasks. You can explicitly set `Content-Type` to a media type when the task is created. For example,`Content-Type` can be set to `"application/octet-stream"` or `"application/json"`. The default value is set to "application/json"`. * User-Agent: This will be set to `"Google-Cloud-Tasks"`. Headers which can have multiple values (according to RFC2616) can be specified using comma-separated values. The size of the headers must be less than 80KB. Queue-level headers to override headers of all the tasks in the queue. Do not put business sensitive or personally identifying data in the HTTP Header Override Configuration or other similar fields in accordance with Section 12 (Resource Fields) of the [Service Specific Terms](https://cloud.google.com/terms/service-terms). + "headerOverrides": [ # HTTP target headers. This map contains the header field names and values. Headers will be set when running the CreateTask and/or BufferTask. These headers represent a subset of the headers that will be configured for the task's HTTP request. Some HTTP request headers will be ignored or replaced. A partial list of headers that will be ignored or replaced is: * Several predefined headers, prefixed with "X-CloudTasks-", can be used to define properties of the task. * Host: This will be computed by Cloud Tasks and derived from HttpRequest.url. * Content-Length: This will be computed by Cloud Tasks. `Content-Type` won't be set by Cloud Tasks. You can explicitly set `Content-Type` to a media type when the task is created. For example, `Content-Type` can be set to `"application/octet-stream"` or `"application/json"`. The default value is set to `"application/json"`. * User-Agent: This will be set to `"Google-Cloud-Tasks"`. Headers which can have multiple values (according to RFC2616) can be specified using comma-separated values. The size of the headers must be less than 80KB. Queue-level headers to override headers of all the tasks in the queue. Do not put business sensitive or personally identifying data in the HTTP Header Override Configuration or other similar fields in accordance with Section 12 (Resource Fields) of the [Service Specific Terms](https://cloud.google.com/terms/service-terms). { # Wraps the Header object. "header": { # Defines a header message. A header can have a key and a value. # Header embodying a key and a value. Do not put business sensitive or personally identifying data in the HTTP Header Override Configuration or other similar fields in accordance with Section 12 (Resource Fields) of the [Service Specific Terms](https://cloud.google.com/terms/service-terms). "key": "A String", # The Key of the header. @@ -298,7 +298,7 @@

Method Details

"version": "A String", # App version. By default, the task is sent to the version which is the default version when the task is attempted. For some queues or tasks which were created using the App Engine Task Queue API, host is not parsable into service, version, and instance. For example, some tasks which were created using the App Engine SDK use a custom domain name; custom domains are not parsed by Cloud Tasks. If host is not parsable, then service, version, and instance are the empty string. }, "httpTarget": { # HTTP target. When specified at the Queue level, all tasks with HttpRequest are overridden according to the target. # Modifies HTTP target for HTTP tasks. - "headerOverrides": [ # HTTP target headers. This map contains the header field names and values. Headers will be set when running the CreateTask and/or BufferTask. These headers represent a subset of the headers that will be configured for the task's HTTP request. Some HTTP request headers will be ignored or replaced. A partial list of headers that will be ignored or replaced is: * Several predefined headers, prefixed with "X-CloudTasks-", can be used to define properties of the task. * Host: This will be computed by Cloud Tasks and derived from HttpRequest.url. * Content-Length: This will be computed by Cloud Tasks. `Content-Type` won't be set by Cloud Tasks. You can explicitly set `Content-Type` to a media type when the task is created. For example,`Content-Type` can be set to `"application/octet-stream"` or `"application/json"`. The default value is set to "application/json"`. * User-Agent: This will be set to `"Google-Cloud-Tasks"`. Headers which can have multiple values (according to RFC2616) can be specified using comma-separated values. The size of the headers must be less than 80KB. Queue-level headers to override headers of all the tasks in the queue. Do not put business sensitive or personally identifying data in the HTTP Header Override Configuration or other similar fields in accordance with Section 12 (Resource Fields) of the [Service Specific Terms](https://cloud.google.com/terms/service-terms). + "headerOverrides": [ # HTTP target headers. This map contains the header field names and values. Headers will be set when running the CreateTask and/or BufferTask. These headers represent a subset of the headers that will be configured for the task's HTTP request. Some HTTP request headers will be ignored or replaced. A partial list of headers that will be ignored or replaced is: * Several predefined headers, prefixed with "X-CloudTasks-", can be used to define properties of the task. * Host: This will be computed by Cloud Tasks and derived from HttpRequest.url. * Content-Length: This will be computed by Cloud Tasks. `Content-Type` won't be set by Cloud Tasks. You can explicitly set `Content-Type` to a media type when the task is created. For example, `Content-Type` can be set to `"application/octet-stream"` or `"application/json"`. The default value is set to `"application/json"`. * User-Agent: This will be set to `"Google-Cloud-Tasks"`. Headers which can have multiple values (according to RFC2616) can be specified using comma-separated values. The size of the headers must be less than 80KB. Queue-level headers to override headers of all the tasks in the queue. Do not put business sensitive or personally identifying data in the HTTP Header Override Configuration or other similar fields in accordance with Section 12 (Resource Fields) of the [Service Specific Terms](https://cloud.google.com/terms/service-terms). { # Wraps the Header object. "header": { # Defines a header message. A header can have a key and a value. # Header embodying a key and a value. Do not put business sensitive or personally identifying data in the HTTP Header Override Configuration or other similar fields in accordance with Section 12 (Resource Fields) of the [Service Specific Terms](https://cloud.google.com/terms/service-terms). "key": "A String", # The Key of the header. @@ -420,7 +420,7 @@

Method Details

"version": "A String", # App version. By default, the task is sent to the version which is the default version when the task is attempted. For some queues or tasks which were created using the App Engine Task Queue API, host is not parsable into service, version, and instance. For example, some tasks which were created using the App Engine SDK use a custom domain name; custom domains are not parsed by Cloud Tasks. If host is not parsable, then service, version, and instance are the empty string. }, "httpTarget": { # HTTP target. When specified at the Queue level, all tasks with HttpRequest are overridden according to the target. # Modifies HTTP target for HTTP tasks. - "headerOverrides": [ # HTTP target headers. This map contains the header field names and values. Headers will be set when running the CreateTask and/or BufferTask. These headers represent a subset of the headers that will be configured for the task's HTTP request. Some HTTP request headers will be ignored or replaced. A partial list of headers that will be ignored or replaced is: * Several predefined headers, prefixed with "X-CloudTasks-", can be used to define properties of the task. * Host: This will be computed by Cloud Tasks and derived from HttpRequest.url. * Content-Length: This will be computed by Cloud Tasks. `Content-Type` won't be set by Cloud Tasks. You can explicitly set `Content-Type` to a media type when the task is created. For example,`Content-Type` can be set to `"application/octet-stream"` or `"application/json"`. The default value is set to "application/json"`. * User-Agent: This will be set to `"Google-Cloud-Tasks"`. Headers which can have multiple values (according to RFC2616) can be specified using comma-separated values. The size of the headers must be less than 80KB. Queue-level headers to override headers of all the tasks in the queue. Do not put business sensitive or personally identifying data in the HTTP Header Override Configuration or other similar fields in accordance with Section 12 (Resource Fields) of the [Service Specific Terms](https://cloud.google.com/terms/service-terms). + "headerOverrides": [ # HTTP target headers. This map contains the header field names and values. Headers will be set when running the CreateTask and/or BufferTask. These headers represent a subset of the headers that will be configured for the task's HTTP request. Some HTTP request headers will be ignored or replaced. A partial list of headers that will be ignored or replaced is: * Several predefined headers, prefixed with "X-CloudTasks-", can be used to define properties of the task. * Host: This will be computed by Cloud Tasks and derived from HttpRequest.url. * Content-Length: This will be computed by Cloud Tasks. `Content-Type` won't be set by Cloud Tasks. You can explicitly set `Content-Type` to a media type when the task is created. For example, `Content-Type` can be set to `"application/octet-stream"` or `"application/json"`. The default value is set to `"application/json"`. * User-Agent: This will be set to `"Google-Cloud-Tasks"`. Headers which can have multiple values (according to RFC2616) can be specified using comma-separated values. The size of the headers must be less than 80KB. Queue-level headers to override headers of all the tasks in the queue. Do not put business sensitive or personally identifying data in the HTTP Header Override Configuration or other similar fields in accordance with Section 12 (Resource Fields) of the [Service Specific Terms](https://cloud.google.com/terms/service-terms). { # Wraps the Header object. "header": { # Defines a header message. A header can have a key and a value. # Header embodying a key and a value. Do not put business sensitive or personally identifying data in the HTTP Header Override Configuration or other similar fields in accordance with Section 12 (Resource Fields) of the [Service Specific Terms](https://cloud.google.com/terms/service-terms). "key": "A String", # The Key of the header. @@ -504,7 +504,7 @@

Method Details

"version": "A String", # App version. By default, the task is sent to the version which is the default version when the task is attempted. For some queues or tasks which were created using the App Engine Task Queue API, host is not parsable into service, version, and instance. For example, some tasks which were created using the App Engine SDK use a custom domain name; custom domains are not parsed by Cloud Tasks. If host is not parsable, then service, version, and instance are the empty string. }, "httpTarget": { # HTTP target. When specified at the Queue level, all tasks with HttpRequest are overridden according to the target. # Modifies HTTP target for HTTP tasks. - "headerOverrides": [ # HTTP target headers. This map contains the header field names and values. Headers will be set when running the CreateTask and/or BufferTask. These headers represent a subset of the headers that will be configured for the task's HTTP request. Some HTTP request headers will be ignored or replaced. A partial list of headers that will be ignored or replaced is: * Several predefined headers, prefixed with "X-CloudTasks-", can be used to define properties of the task. * Host: This will be computed by Cloud Tasks and derived from HttpRequest.url. * Content-Length: This will be computed by Cloud Tasks. `Content-Type` won't be set by Cloud Tasks. You can explicitly set `Content-Type` to a media type when the task is created. For example,`Content-Type` can be set to `"application/octet-stream"` or `"application/json"`. The default value is set to "application/json"`. * User-Agent: This will be set to `"Google-Cloud-Tasks"`. Headers which can have multiple values (according to RFC2616) can be specified using comma-separated values. The size of the headers must be less than 80KB. Queue-level headers to override headers of all the tasks in the queue. Do not put business sensitive or personally identifying data in the HTTP Header Override Configuration or other similar fields in accordance with Section 12 (Resource Fields) of the [Service Specific Terms](https://cloud.google.com/terms/service-terms). + "headerOverrides": [ # HTTP target headers. This map contains the header field names and values. Headers will be set when running the CreateTask and/or BufferTask. These headers represent a subset of the headers that will be configured for the task's HTTP request. Some HTTP request headers will be ignored or replaced. A partial list of headers that will be ignored or replaced is: * Several predefined headers, prefixed with "X-CloudTasks-", can be used to define properties of the task. * Host: This will be computed by Cloud Tasks and derived from HttpRequest.url. * Content-Length: This will be computed by Cloud Tasks. `Content-Type` won't be set by Cloud Tasks. You can explicitly set `Content-Type` to a media type when the task is created. For example, `Content-Type` can be set to `"application/octet-stream"` or `"application/json"`. The default value is set to `"application/json"`. * User-Agent: This will be set to `"Google-Cloud-Tasks"`. Headers which can have multiple values (according to RFC2616) can be specified using comma-separated values. The size of the headers must be less than 80KB. Queue-level headers to override headers of all the tasks in the queue. Do not put business sensitive or personally identifying data in the HTTP Header Override Configuration or other similar fields in accordance with Section 12 (Resource Fields) of the [Service Specific Terms](https://cloud.google.com/terms/service-terms). { # Wraps the Header object. "header": { # Defines a header message. A header can have a key and a value. # Header embodying a key and a value. Do not put business sensitive or personally identifying data in the HTTP Header Override Configuration or other similar fields in accordance with Section 12 (Resource Fields) of the [Service Specific Terms](https://cloud.google.com/terms/service-terms). "key": "A String", # The Key of the header. @@ -571,7 +571,7 @@

Method Details

"version": "A String", # App version. By default, the task is sent to the version which is the default version when the task is attempted. For some queues or tasks which were created using the App Engine Task Queue API, host is not parsable into service, version, and instance. For example, some tasks which were created using the App Engine SDK use a custom domain name; custom domains are not parsed by Cloud Tasks. If host is not parsable, then service, version, and instance are the empty string. }, "httpTarget": { # HTTP target. When specified at the Queue level, all tasks with HttpRequest are overridden according to the target. # Modifies HTTP target for HTTP tasks. - "headerOverrides": [ # HTTP target headers. This map contains the header field names and values. Headers will be set when running the CreateTask and/or BufferTask. These headers represent a subset of the headers that will be configured for the task's HTTP request. Some HTTP request headers will be ignored or replaced. A partial list of headers that will be ignored or replaced is: * Several predefined headers, prefixed with "X-CloudTasks-", can be used to define properties of the task. * Host: This will be computed by Cloud Tasks and derived from HttpRequest.url. * Content-Length: This will be computed by Cloud Tasks. `Content-Type` won't be set by Cloud Tasks. You can explicitly set `Content-Type` to a media type when the task is created. For example,`Content-Type` can be set to `"application/octet-stream"` or `"application/json"`. The default value is set to "application/json"`. * User-Agent: This will be set to `"Google-Cloud-Tasks"`. Headers which can have multiple values (according to RFC2616) can be specified using comma-separated values. The size of the headers must be less than 80KB. Queue-level headers to override headers of all the tasks in the queue. Do not put business sensitive or personally identifying data in the HTTP Header Override Configuration or other similar fields in accordance with Section 12 (Resource Fields) of the [Service Specific Terms](https://cloud.google.com/terms/service-terms). + "headerOverrides": [ # HTTP target headers. This map contains the header field names and values. Headers will be set when running the CreateTask and/or BufferTask. These headers represent a subset of the headers that will be configured for the task's HTTP request. Some HTTP request headers will be ignored or replaced. A partial list of headers that will be ignored or replaced is: * Several predefined headers, prefixed with "X-CloudTasks-", can be used to define properties of the task. * Host: This will be computed by Cloud Tasks and derived from HttpRequest.url. * Content-Length: This will be computed by Cloud Tasks. `Content-Type` won't be set by Cloud Tasks. You can explicitly set `Content-Type` to a media type when the task is created. For example, `Content-Type` can be set to `"application/octet-stream"` or `"application/json"`. The default value is set to `"application/json"`. * User-Agent: This will be set to `"Google-Cloud-Tasks"`. Headers which can have multiple values (according to RFC2616) can be specified using comma-separated values. The size of the headers must be less than 80KB. Queue-level headers to override headers of all the tasks in the queue. Do not put business sensitive or personally identifying data in the HTTP Header Override Configuration or other similar fields in accordance with Section 12 (Resource Fields) of the [Service Specific Terms](https://cloud.google.com/terms/service-terms). { # Wraps the Header object. "header": { # Defines a header message. A header can have a key and a value. # Header embodying a key and a value. Do not put business sensitive or personally identifying data in the HTTP Header Override Configuration or other similar fields in accordance with Section 12 (Resource Fields) of the [Service Specific Terms](https://cloud.google.com/terms/service-terms). "key": "A String", # The Key of the header. @@ -650,7 +650,7 @@

Method Details

"version": "A String", # App version. By default, the task is sent to the version which is the default version when the task is attempted. For some queues or tasks which were created using the App Engine Task Queue API, host is not parsable into service, version, and instance. For example, some tasks which were created using the App Engine SDK use a custom domain name; custom domains are not parsed by Cloud Tasks. If host is not parsable, then service, version, and instance are the empty string. }, "httpTarget": { # HTTP target. When specified at the Queue level, all tasks with HttpRequest are overridden according to the target. # Modifies HTTP target for HTTP tasks. - "headerOverrides": [ # HTTP target headers. This map contains the header field names and values. Headers will be set when running the CreateTask and/or BufferTask. These headers represent a subset of the headers that will be configured for the task's HTTP request. Some HTTP request headers will be ignored or replaced. A partial list of headers that will be ignored or replaced is: * Several predefined headers, prefixed with "X-CloudTasks-", can be used to define properties of the task. * Host: This will be computed by Cloud Tasks and derived from HttpRequest.url. * Content-Length: This will be computed by Cloud Tasks. `Content-Type` won't be set by Cloud Tasks. You can explicitly set `Content-Type` to a media type when the task is created. For example,`Content-Type` can be set to `"application/octet-stream"` or `"application/json"`. The default value is set to "application/json"`. * User-Agent: This will be set to `"Google-Cloud-Tasks"`. Headers which can have multiple values (according to RFC2616) can be specified using comma-separated values. The size of the headers must be less than 80KB. Queue-level headers to override headers of all the tasks in the queue. Do not put business sensitive or personally identifying data in the HTTP Header Override Configuration or other similar fields in accordance with Section 12 (Resource Fields) of the [Service Specific Terms](https://cloud.google.com/terms/service-terms). + "headerOverrides": [ # HTTP target headers. This map contains the header field names and values. Headers will be set when running the CreateTask and/or BufferTask. These headers represent a subset of the headers that will be configured for the task's HTTP request. Some HTTP request headers will be ignored or replaced. A partial list of headers that will be ignored or replaced is: * Several predefined headers, prefixed with "X-CloudTasks-", can be used to define properties of the task. * Host: This will be computed by Cloud Tasks and derived from HttpRequest.url. * Content-Length: This will be computed by Cloud Tasks. `Content-Type` won't be set by Cloud Tasks. You can explicitly set `Content-Type` to a media type when the task is created. For example, `Content-Type` can be set to `"application/octet-stream"` or `"application/json"`. The default value is set to `"application/json"`. * User-Agent: This will be set to `"Google-Cloud-Tasks"`. Headers which can have multiple values (according to RFC2616) can be specified using comma-separated values. The size of the headers must be less than 80KB. Queue-level headers to override headers of all the tasks in the queue. Do not put business sensitive or personally identifying data in the HTTP Header Override Configuration or other similar fields in accordance with Section 12 (Resource Fields) of the [Service Specific Terms](https://cloud.google.com/terms/service-terms). { # Wraps the Header object. "header": { # Defines a header message. A header can have a key and a value. # Header embodying a key and a value. Do not put business sensitive or personally identifying data in the HTTP Header Override Configuration or other similar fields in accordance with Section 12 (Resource Fields) of the [Service Specific Terms](https://cloud.google.com/terms/service-terms). "key": "A String", # The Key of the header. @@ -729,7 +729,7 @@

Method Details

"version": "A String", # App version. By default, the task is sent to the version which is the default version when the task is attempted. For some queues or tasks which were created using the App Engine Task Queue API, host is not parsable into service, version, and instance. For example, some tasks which were created using the App Engine SDK use a custom domain name; custom domains are not parsed by Cloud Tasks. If host is not parsable, then service, version, and instance are the empty string. }, "httpTarget": { # HTTP target. When specified at the Queue level, all tasks with HttpRequest are overridden according to the target. # Modifies HTTP target for HTTP tasks. - "headerOverrides": [ # HTTP target headers. This map contains the header field names and values. Headers will be set when running the CreateTask and/or BufferTask. These headers represent a subset of the headers that will be configured for the task's HTTP request. Some HTTP request headers will be ignored or replaced. A partial list of headers that will be ignored or replaced is: * Several predefined headers, prefixed with "X-CloudTasks-", can be used to define properties of the task. * Host: This will be computed by Cloud Tasks and derived from HttpRequest.url. * Content-Length: This will be computed by Cloud Tasks. `Content-Type` won't be set by Cloud Tasks. You can explicitly set `Content-Type` to a media type when the task is created. For example,`Content-Type` can be set to `"application/octet-stream"` or `"application/json"`. The default value is set to "application/json"`. * User-Agent: This will be set to `"Google-Cloud-Tasks"`. Headers which can have multiple values (according to RFC2616) can be specified using comma-separated values. The size of the headers must be less than 80KB. Queue-level headers to override headers of all the tasks in the queue. Do not put business sensitive or personally identifying data in the HTTP Header Override Configuration or other similar fields in accordance with Section 12 (Resource Fields) of the [Service Specific Terms](https://cloud.google.com/terms/service-terms). + "headerOverrides": [ # HTTP target headers. This map contains the header field names and values. Headers will be set when running the CreateTask and/or BufferTask. These headers represent a subset of the headers that will be configured for the task's HTTP request. Some HTTP request headers will be ignored or replaced. A partial list of headers that will be ignored or replaced is: * Several predefined headers, prefixed with "X-CloudTasks-", can be used to define properties of the task. * Host: This will be computed by Cloud Tasks and derived from HttpRequest.url. * Content-Length: This will be computed by Cloud Tasks. `Content-Type` won't be set by Cloud Tasks. You can explicitly set `Content-Type` to a media type when the task is created. For example, `Content-Type` can be set to `"application/octet-stream"` or `"application/json"`. The default value is set to `"application/json"`. * User-Agent: This will be set to `"Google-Cloud-Tasks"`. Headers which can have multiple values (according to RFC2616) can be specified using comma-separated values. The size of the headers must be less than 80KB. Queue-level headers to override headers of all the tasks in the queue. Do not put business sensitive or personally identifying data in the HTTP Header Override Configuration or other similar fields in accordance with Section 12 (Resource Fields) of the [Service Specific Terms](https://cloud.google.com/terms/service-terms). { # Wraps the Header object. "header": { # Defines a header message. A header can have a key and a value. # Header embodying a key and a value. Do not put business sensitive or personally identifying data in the HTTP Header Override Configuration or other similar fields in accordance with Section 12 (Resource Fields) of the [Service Specific Terms](https://cloud.google.com/terms/service-terms). "key": "A String", # The Key of the header. @@ -808,7 +808,7 @@

Method Details

"version": "A String", # App version. By default, the task is sent to the version which is the default version when the task is attempted. For some queues or tasks which were created using the App Engine Task Queue API, host is not parsable into service, version, and instance. For example, some tasks which were created using the App Engine SDK use a custom domain name; custom domains are not parsed by Cloud Tasks. If host is not parsable, then service, version, and instance are the empty string. }, "httpTarget": { # HTTP target. When specified at the Queue level, all tasks with HttpRequest are overridden according to the target. # Modifies HTTP target for HTTP tasks. - "headerOverrides": [ # HTTP target headers. This map contains the header field names and values. Headers will be set when running the CreateTask and/or BufferTask. These headers represent a subset of the headers that will be configured for the task's HTTP request. Some HTTP request headers will be ignored or replaced. A partial list of headers that will be ignored or replaced is: * Several predefined headers, prefixed with "X-CloudTasks-", can be used to define properties of the task. * Host: This will be computed by Cloud Tasks and derived from HttpRequest.url. * Content-Length: This will be computed by Cloud Tasks. `Content-Type` won't be set by Cloud Tasks. You can explicitly set `Content-Type` to a media type when the task is created. For example,`Content-Type` can be set to `"application/octet-stream"` or `"application/json"`. The default value is set to "application/json"`. * User-Agent: This will be set to `"Google-Cloud-Tasks"`. Headers which can have multiple values (according to RFC2616) can be specified using comma-separated values. The size of the headers must be less than 80KB. Queue-level headers to override headers of all the tasks in the queue. Do not put business sensitive or personally identifying data in the HTTP Header Override Configuration or other similar fields in accordance with Section 12 (Resource Fields) of the [Service Specific Terms](https://cloud.google.com/terms/service-terms). + "headerOverrides": [ # HTTP target headers. This map contains the header field names and values. Headers will be set when running the CreateTask and/or BufferTask. These headers represent a subset of the headers that will be configured for the task's HTTP request. Some HTTP request headers will be ignored or replaced. A partial list of headers that will be ignored or replaced is: * Several predefined headers, prefixed with "X-CloudTasks-", can be used to define properties of the task. * Host: This will be computed by Cloud Tasks and derived from HttpRequest.url. * Content-Length: This will be computed by Cloud Tasks. `Content-Type` won't be set by Cloud Tasks. You can explicitly set `Content-Type` to a media type when the task is created. For example, `Content-Type` can be set to `"application/octet-stream"` or `"application/json"`. The default value is set to `"application/json"`. * User-Agent: This will be set to `"Google-Cloud-Tasks"`. Headers which can have multiple values (according to RFC2616) can be specified using comma-separated values. The size of the headers must be less than 80KB. Queue-level headers to override headers of all the tasks in the queue. Do not put business sensitive or personally identifying data in the HTTP Header Override Configuration or other similar fields in accordance with Section 12 (Resource Fields) of the [Service Specific Terms](https://cloud.google.com/terms/service-terms). { # Wraps the Header object. "header": { # Defines a header message. A header can have a key and a value. # Header embodying a key and a value. Do not put business sensitive or personally identifying data in the HTTP Header Override Configuration or other similar fields in accordance with Section 12 (Resource Fields) of the [Service Specific Terms](https://cloud.google.com/terms/service-terms). "key": "A String", # The Key of the header. diff --git a/docs/dyn/cloudtasks_v2.projects.locations.queues.tasks.html b/docs/dyn/cloudtasks_v2.projects.locations.queues.tasks.html index e511131e2e..0da1c4adc9 100644 --- a/docs/dyn/cloudtasks_v2.projects.locations.queues.tasks.html +++ b/docs/dyn/cloudtasks_v2.projects.locations.queues.tasks.html @@ -116,7 +116,7 @@

Method Details

{ # Request message for [BatchCreateTasks]. "requestId": "A String", # Optional. This field will be used to identify the long running operation, avoiding duplication when user retries. If not provided, then a UUID will be generated at server side. - "requests": [ # Required. The list of requests to create tasks. The queue specified in parent field of each CreateTaskRequest will be the same. This validation happens on the client side as well as in the handler. BatchCreateTasksRequest.parent will also be the same value as the individual CreateTaskRequest.parent . The maximum number of requests is 100. + "requests": [ # Required. The list of requests to create tasks. The queue specified in parent field of each CreateTaskRequest will be the same. This validation happens on the client side as well as in the handler. BatchCreateTasksRequest.parent will also be the same value as the individual `CreateTaskRequest.parent`. The maximum number of requests is 100. { # Request message for CreateTask. "parent": "A String", # Required. The queue name. For example: `projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID` The queue must already exist. "responseView": "A String", # The response_view specifies which subset of the Task will be returned. By default response_view is BASIC; not all information is retrieved by default because some data, such as payloads, might be desirable to return only when needed because of its large size or because of the sensitivity of data that it contains. Authorization for FULL requires `cloudtasks.tasks.fullView` [Google IAM](https://cloud.google.com/iam/) permission on the Task resource. diff --git a/docs/dyn/dataflow_v1b3.projects.jobs.html b/docs/dyn/dataflow_v1b3.projects.jobs.html index 69deae4215..f581dfcec1 100644 --- a/docs/dyn/dataflow_v1b3.projects.jobs.html +++ b/docs/dyn/dataflow_v1b3.projects.jobs.html @@ -470,7 +470,7 @@

Method Details

"maxWorkerCount": 42, # Optional. The maximum number of workers for this schedule. "minWorkerCount": 42, # Optional. The minimum number of workers for this schedule. }, - "priority": "A String", # Optional. Specifies the priority of the schedule. If two schedules overlap, the one with the higher priority will be used. The higher the value, the higher the priority of the schedule. + "priority": "A String", # Optional. Specifies the priority of the schedule. If two schedules overlap, the one with the higher priority will be used. The higher the value, the higher the priority of the schedule. The value must be non-negative; the lowest priority is `0`, which is the default. "timeZone": "A String", # Optional. The time zone for the schedule. The value of this field must be a time zone name from the [tz database](http://en.wikipedia.org/wiki/Tz_database). The default value is UTC. "updateTime": "A String", # Output only. When the customer last updated the schedule. }, @@ -855,7 +855,7 @@

Method Details

"maxWorkerCount": 42, # Optional. The maximum number of workers for this schedule. "minWorkerCount": 42, # Optional. The minimum number of workers for this schedule. }, - "priority": "A String", # Optional. Specifies the priority of the schedule. If two schedules overlap, the one with the higher priority will be used. The higher the value, the higher the priority of the schedule. + "priority": "A String", # Optional. Specifies the priority of the schedule. If two schedules overlap, the one with the higher priority will be used. The higher the value, the higher the priority of the schedule. The value must be non-negative; the lowest priority is `0`, which is the default. "timeZone": "A String", # Optional. The time zone for the schedule. The value of this field must be a time zone name from the [tz database](http://en.wikipedia.org/wiki/Tz_database). The default value is UTC. "updateTime": "A String", # Output only. When the customer last updated the schedule. }, @@ -1224,7 +1224,7 @@

Method Details

"maxWorkerCount": 42, # Optional. The maximum number of workers for this schedule. "minWorkerCount": 42, # Optional. The minimum number of workers for this schedule. }, - "priority": "A String", # Optional. Specifies the priority of the schedule. If two schedules overlap, the one with the higher priority will be used. The higher the value, the higher the priority of the schedule. + "priority": "A String", # Optional. Specifies the priority of the schedule. If two schedules overlap, the one with the higher priority will be used. The higher the value, the higher the priority of the schedule. The value must be non-negative; the lowest priority is `0`, which is the default. "timeZone": "A String", # Optional. The time zone for the schedule. The value of this field must be a time zone name from the [tz database](http://en.wikipedia.org/wiki/Tz_database). The default value is UTC. "updateTime": "A String", # Output only. When the customer last updated the schedule. }, @@ -1600,7 +1600,7 @@

Method Details

"maxWorkerCount": 42, # Optional. The maximum number of workers for this schedule. "minWorkerCount": 42, # Optional. The minimum number of workers for this schedule. }, - "priority": "A String", # Optional. Specifies the priority of the schedule. If two schedules overlap, the one with the higher priority will be used. The higher the value, the higher the priority of the schedule. + "priority": "A String", # Optional. Specifies the priority of the schedule. If two schedules overlap, the one with the higher priority will be used. The higher the value, the higher the priority of the schedule. The value must be non-negative; the lowest priority is `0`, which is the default. "timeZone": "A String", # Optional. The time zone for the schedule. The value of this field must be a time zone name from the [tz database](http://en.wikipedia.org/wiki/Tz_database). The default value is UTC. "updateTime": "A String", # Output only. When the customer last updated the schedule. }, @@ -2037,7 +2037,7 @@

Method Details

"maxWorkerCount": 42, # Optional. The maximum number of workers for this schedule. "minWorkerCount": 42, # Optional. The minimum number of workers for this schedule. }, - "priority": "A String", # Optional. Specifies the priority of the schedule. If two schedules overlap, the one with the higher priority will be used. The higher the value, the higher the priority of the schedule. + "priority": "A String", # Optional. Specifies the priority of the schedule. If two schedules overlap, the one with the higher priority will be used. The higher the value, the higher the priority of the schedule. The value must be non-negative; the lowest priority is `0`, which is the default. "timeZone": "A String", # Optional. The time zone for the schedule. The value of this field must be a time zone name from the [tz database](http://en.wikipedia.org/wiki/Tz_database). The default value is UTC. "updateTime": "A String", # Output only. When the customer last updated the schedule. }, @@ -2463,7 +2463,7 @@

Method Details

"maxWorkerCount": 42, # Optional. The maximum number of workers for this schedule. "minWorkerCount": 42, # Optional. The minimum number of workers for this schedule. }, - "priority": "A String", # Optional. Specifies the priority of the schedule. If two schedules overlap, the one with the higher priority will be used. The higher the value, the higher the priority of the schedule. + "priority": "A String", # Optional. Specifies the priority of the schedule. If two schedules overlap, the one with the higher priority will be used. The higher the value, the higher the priority of the schedule. The value must be non-negative; the lowest priority is `0`, which is the default. "timeZone": "A String", # Optional. The time zone for the schedule. The value of this field must be a time zone name from the [tz database](http://en.wikipedia.org/wiki/Tz_database). The default value is UTC. "updateTime": "A String", # Output only. When the customer last updated the schedule. }, @@ -2826,7 +2826,7 @@

Method Details

"maxWorkerCount": 42, # Optional. The maximum number of workers for this schedule. "minWorkerCount": 42, # Optional. The minimum number of workers for this schedule. }, - "priority": "A String", # Optional. Specifies the priority of the schedule. If two schedules overlap, the one with the higher priority will be used. The higher the value, the higher the priority of the schedule. + "priority": "A String", # Optional. Specifies the priority of the schedule. If two schedules overlap, the one with the higher priority will be used. The higher the value, the higher the priority of the schedule. The value must be non-negative; the lowest priority is `0`, which is the default. "timeZone": "A String", # Optional. The time zone for the schedule. The value of this field must be a time zone name from the [tz database](http://en.wikipedia.org/wiki/Tz_database). The default value is UTC. "updateTime": "A String", # Output only. When the customer last updated the schedule. }, diff --git a/docs/dyn/dataflow_v1b3.projects.locations.flexTemplates.html b/docs/dyn/dataflow_v1b3.projects.locations.flexTemplates.html index 6fd4dcf312..686c81f977 100644 --- a/docs/dyn/dataflow_v1b3.projects.locations.flexTemplates.html +++ b/docs/dyn/dataflow_v1b3.projects.locations.flexTemplates.html @@ -551,7 +551,7 @@

Method Details

"maxWorkerCount": 42, # Optional. The maximum number of workers for this schedule. "minWorkerCount": 42, # Optional. The minimum number of workers for this schedule. }, - "priority": "A String", # Optional. Specifies the priority of the schedule. If two schedules overlap, the one with the higher priority will be used. The higher the value, the higher the priority of the schedule. + "priority": "A String", # Optional. Specifies the priority of the schedule. If two schedules overlap, the one with the higher priority will be used. The higher the value, the higher the priority of the schedule. The value must be non-negative; the lowest priority is `0`, which is the default. "timeZone": "A String", # Optional. The time zone for the schedule. The value of this field must be a time zone name from the [tz database](http://en.wikipedia.org/wiki/Tz_database). The default value is UTC. "updateTime": "A String", # Output only. When the customer last updated the schedule. }, diff --git a/docs/dyn/dataflow_v1b3.projects.locations.jobs.html b/docs/dyn/dataflow_v1b3.projects.locations.jobs.html index a6d7fa0b5f..e387f18f57 100644 --- a/docs/dyn/dataflow_v1b3.projects.locations.jobs.html +++ b/docs/dyn/dataflow_v1b3.projects.locations.jobs.html @@ -457,7 +457,7 @@

Method Details

"maxWorkerCount": 42, # Optional. The maximum number of workers for this schedule. "minWorkerCount": 42, # Optional. The minimum number of workers for this schedule. }, - "priority": "A String", # Optional. Specifies the priority of the schedule. If two schedules overlap, the one with the higher priority will be used. The higher the value, the higher the priority of the schedule. + "priority": "A String", # Optional. Specifies the priority of the schedule. If two schedules overlap, the one with the higher priority will be used. The higher the value, the higher the priority of the schedule. The value must be non-negative; the lowest priority is `0`, which is the default. "timeZone": "A String", # Optional. The time zone for the schedule. The value of this field must be a time zone name from the [tz database](http://en.wikipedia.org/wiki/Tz_database). The default value is UTC. "updateTime": "A String", # Output only. When the customer last updated the schedule. }, @@ -825,7 +825,7 @@

Method Details

"maxWorkerCount": 42, # Optional. The maximum number of workers for this schedule. "minWorkerCount": 42, # Optional. The minimum number of workers for this schedule. }, - "priority": "A String", # Optional. Specifies the priority of the schedule. If two schedules overlap, the one with the higher priority will be used. The higher the value, the higher the priority of the schedule. + "priority": "A String", # Optional. Specifies the priority of the schedule. If two schedules overlap, the one with the higher priority will be used. The higher the value, the higher the priority of the schedule. The value must be non-negative; the lowest priority is `0`, which is the default. "timeZone": "A String", # Optional. The time zone for the schedule. The value of this field must be a time zone name from the [tz database](http://en.wikipedia.org/wiki/Tz_database). The default value is UTC. "updateTime": "A String", # Output only. When the customer last updated the schedule. }, @@ -1201,7 +1201,7 @@

Method Details

"maxWorkerCount": 42, # Optional. The maximum number of workers for this schedule. "minWorkerCount": 42, # Optional. The minimum number of workers for this schedule. }, - "priority": "A String", # Optional. Specifies the priority of the schedule. If two schedules overlap, the one with the higher priority will be used. The higher the value, the higher the priority of the schedule. + "priority": "A String", # Optional. Specifies the priority of the schedule. If two schedules overlap, the one with the higher priority will be used. The higher the value, the higher the priority of the schedule. The value must be non-negative; the lowest priority is `0`, which is the default. "timeZone": "A String", # Optional. The time zone for the schedule. The value of this field must be a time zone name from the [tz database](http://en.wikipedia.org/wiki/Tz_database). The default value is UTC. "updateTime": "A String", # Output only. When the customer last updated the schedule. }, @@ -1748,7 +1748,7 @@

Method Details

"maxWorkerCount": 42, # Optional. The maximum number of workers for this schedule. "minWorkerCount": 42, # Optional. The minimum number of workers for this schedule. }, - "priority": "A String", # Optional. Specifies the priority of the schedule. If two schedules overlap, the one with the higher priority will be used. The higher the value, the higher the priority of the schedule. + "priority": "A String", # Optional. Specifies the priority of the schedule. If two schedules overlap, the one with the higher priority will be used. The higher the value, the higher the priority of the schedule. The value must be non-negative; the lowest priority is `0`, which is the default. "timeZone": "A String", # Optional. The time zone for the schedule. The value of this field must be a time zone name from the [tz database](http://en.wikipedia.org/wiki/Tz_database). The default value is UTC. "updateTime": "A String", # Output only. When the customer last updated the schedule. }, @@ -2176,7 +2176,7 @@

Method Details

"maxWorkerCount": 42, # Optional. The maximum number of workers for this schedule. "minWorkerCount": 42, # Optional. The minimum number of workers for this schedule. }, - "priority": "A String", # Optional. Specifies the priority of the schedule. If two schedules overlap, the one with the higher priority will be used. The higher the value, the higher the priority of the schedule. + "priority": "A String", # Optional. Specifies the priority of the schedule. If two schedules overlap, the one with the higher priority will be used. The higher the value, the higher the priority of the schedule. The value must be non-negative; the lowest priority is `0`, which is the default. "timeZone": "A String", # Optional. The time zone for the schedule. The value of this field must be a time zone name from the [tz database](http://en.wikipedia.org/wiki/Tz_database). The default value is UTC. "updateTime": "A String", # Output only. When the customer last updated the schedule. }, @@ -2538,7 +2538,7 @@

Method Details

"maxWorkerCount": 42, # Optional. The maximum number of workers for this schedule. "minWorkerCount": 42, # Optional. The minimum number of workers for this schedule. }, - "priority": "A String", # Optional. Specifies the priority of the schedule. If two schedules overlap, the one with the higher priority will be used. The higher the value, the higher the priority of the schedule. + "priority": "A String", # Optional. Specifies the priority of the schedule. If two schedules overlap, the one with the higher priority will be used. The higher the value, the higher the priority of the schedule. The value must be non-negative; the lowest priority is `0`, which is the default. "timeZone": "A String", # Optional. The time zone for the schedule. The value of this field must be a time zone name from the [tz database](http://en.wikipedia.org/wiki/Tz_database). The default value is UTC. "updateTime": "A String", # Output only. When the customer last updated the schedule. }, diff --git a/docs/dyn/dataflow_v1b3.projects.locations.templates.html b/docs/dyn/dataflow_v1b3.projects.locations.templates.html index 1a1f19d80e..8e1ef0d6d7 100644 --- a/docs/dyn/dataflow_v1b3.projects.locations.templates.html +++ b/docs/dyn/dataflow_v1b3.projects.locations.templates.html @@ -458,7 +458,7 @@

Method Details

"maxWorkerCount": 42, # Optional. The maximum number of workers for this schedule. "minWorkerCount": 42, # Optional. The minimum number of workers for this schedule. }, - "priority": "A String", # Optional. Specifies the priority of the schedule. If two schedules overlap, the one with the higher priority will be used. The higher the value, the higher the priority of the schedule. + "priority": "A String", # Optional. Specifies the priority of the schedule. If two schedules overlap, the one with the higher priority will be used. The higher the value, the higher the priority of the schedule. The value must be non-negative; the lowest priority is `0`, which is the default. "timeZone": "A String", # Optional. The time zone for the schedule. The value of this field must be a time zone name from the [tz database](http://en.wikipedia.org/wiki/Tz_database). The default value is UTC. "updateTime": "A String", # Output only. When the customer last updated the schedule. }, @@ -979,7 +979,7 @@

Method Details

"maxWorkerCount": 42, # Optional. The maximum number of workers for this schedule. "minWorkerCount": 42, # Optional. The minimum number of workers for this schedule. }, - "priority": "A String", # Optional. Specifies the priority of the schedule. If two schedules overlap, the one with the higher priority will be used. The higher the value, the higher the priority of the schedule. + "priority": "A String", # Optional. Specifies the priority of the schedule. If two schedules overlap, the one with the higher priority will be used. The higher the value, the higher the priority of the schedule. The value must be non-negative; the lowest priority is `0`, which is the default. "timeZone": "A String", # Optional. The time zone for the schedule. The value of this field must be a time zone name from the [tz database](http://en.wikipedia.org/wiki/Tz_database). The default value is UTC. "updateTime": "A String", # Output only. When the customer last updated the schedule. }, diff --git a/docs/dyn/dataflow_v1b3.projects.templates.html b/docs/dyn/dataflow_v1b3.projects.templates.html index 511cb28783..4942b83273 100644 --- a/docs/dyn/dataflow_v1b3.projects.templates.html +++ b/docs/dyn/dataflow_v1b3.projects.templates.html @@ -457,7 +457,7 @@

Method Details

"maxWorkerCount": 42, # Optional. The maximum number of workers for this schedule. "minWorkerCount": 42, # Optional. The minimum number of workers for this schedule. }, - "priority": "A String", # Optional. Specifies the priority of the schedule. If two schedules overlap, the one with the higher priority will be used. The higher the value, the higher the priority of the schedule. + "priority": "A String", # Optional. Specifies the priority of the schedule. If two schedules overlap, the one with the higher priority will be used. The higher the value, the higher the priority of the schedule. The value must be non-negative; the lowest priority is `0`, which is the default. "timeZone": "A String", # Optional. The time zone for the schedule. The value of this field must be a time zone name from the [tz database](http://en.wikipedia.org/wiki/Tz_database). The default value is UTC. "updateTime": "A String", # Output only. When the customer last updated the schedule. }, @@ -978,7 +978,7 @@

Method Details

"maxWorkerCount": 42, # Optional. The maximum number of workers for this schedule. "minWorkerCount": 42, # Optional. The minimum number of workers for this schedule. }, - "priority": "A String", # Optional. Specifies the priority of the schedule. If two schedules overlap, the one with the higher priority will be used. The higher the value, the higher the priority of the schedule. + "priority": "A String", # Optional. Specifies the priority of the schedule. If two schedules overlap, the one with the higher priority will be used. The higher the value, the higher the priority of the schedule. The value must be non-negative; the lowest priority is `0`, which is the default. "timeZone": "A String", # Optional. The time zone for the schedule. The value of this field must be a time zone name from the [tz database](http://en.wikipedia.org/wiki/Tz_database). The default value is UTC. "updateTime": "A String", # Output only. When the customer last updated the schedule. }, diff --git a/docs/dyn/displayvideo_v2.advertisers.lineItems.targetingTypes.assignedTargetingOptions.html b/docs/dyn/displayvideo_v2.advertisers.lineItems.targetingTypes.assignedTargetingOptions.html index 83b4d36a35..32a1932ccd 100644 --- a/docs/dyn/displayvideo_v2.advertisers.lineItems.targetingTypes.assignedTargetingOptions.html +++ b/docs/dyn/displayvideo_v2.advertisers.lineItems.targetingTypes.assignedTargetingOptions.html @@ -129,7 +129,6 @@

Method Details

TARGETING_TYPE_ON_SCREEN_POSITION - Target ads in a specific on screen position. TARGETING_TYPE_THIRD_PARTY_VERIFIER - Filter web sites through third party verification (for example, IAS or DoubleVerify). TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION - Filter web sites by specific digital content label ratings (for example, DL-MA: suitable only for mature audiences). - TARGETING_TYPE_SENSITIVE_CATEGORY_EXCLUSION - Filter website content by sensitive categories (for example, adult). TARGETING_TYPE_ENVIRONMENT - Target ads to a specific environment (for example, web or app). TARGETING_TYPE_CARRIER_AND_ISP - Target ads to a specific network carrier or internet service provider (ISP) (for example, Comcast or Orange). TARGETING_TYPE_OPERATING_SYSTEM - Target ads to a specific operating system (for example, macOS). @@ -779,7 +778,6 @@

Method Details

TARGETING_TYPE_ON_SCREEN_POSITION - Target ads in a specific on screen position. TARGETING_TYPE_THIRD_PARTY_VERIFIER - Filter web sites through third party verification (for example, IAS or DoubleVerify). TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION - Filter web sites by specific digital content label ratings (for example, DL-MA: suitable only for mature audiences). - TARGETING_TYPE_SENSITIVE_CATEGORY_EXCLUSION - Filter website content by sensitive categories (for example, adult). TARGETING_TYPE_ENVIRONMENT - Target ads to a specific environment (for example, web or app). TARGETING_TYPE_CARRIER_AND_ISP - Target ads to a specific network carrier or internet service provider (ISP) (for example, Comcast or Orange). TARGETING_TYPE_OPERATING_SYSTEM - Target ads to a specific operating system (for example, macOS). @@ -850,7 +848,6 @@

Method Details

TARGETING_TYPE_ON_SCREEN_POSITION - Target ads in a specific on screen position. TARGETING_TYPE_THIRD_PARTY_VERIFIER - Filter web sites through third party verification (for example, IAS or DoubleVerify). TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION - Filter web sites by specific digital content label ratings (for example, DL-MA: suitable only for mature audiences). - TARGETING_TYPE_SENSITIVE_CATEGORY_EXCLUSION - Filter website content by sensitive categories (for example, adult). TARGETING_TYPE_ENVIRONMENT - Target ads to a specific environment (for example, web or app). TARGETING_TYPE_CARRIER_AND_ISP - Target ads to a specific network carrier or internet service provider (ISP) (for example, Comcast or Orange). TARGETING_TYPE_OPERATING_SYSTEM - Target ads to a specific operating system (for example, macOS). @@ -1208,7 +1205,6 @@

Method Details

TARGETING_TYPE_ON_SCREEN_POSITION - Target ads in a specific on screen position. TARGETING_TYPE_THIRD_PARTY_VERIFIER - Filter web sites through third party verification (for example, IAS or DoubleVerify). TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION - Filter web sites by specific digital content label ratings (for example, DL-MA: suitable only for mature audiences). - TARGETING_TYPE_SENSITIVE_CATEGORY_EXCLUSION - Filter website content by sensitive categories (for example, adult). TARGETING_TYPE_ENVIRONMENT - Target ads to a specific environment (for example, web or app). TARGETING_TYPE_CARRIER_AND_ISP - Target ads to a specific network carrier or internet service provider (ISP) (for example, Comcast or Orange). TARGETING_TYPE_OPERATING_SYSTEM - Target ads to a specific operating system (for example, macOS). diff --git a/docs/dyn/displayvideo_v2.advertisers.targetingTypes.assignedTargetingOptions.html b/docs/dyn/displayvideo_v2.advertisers.targetingTypes.assignedTargetingOptions.html index 7674b681f6..89b9fca25f 100644 --- a/docs/dyn/displayvideo_v2.advertisers.targetingTypes.assignedTargetingOptions.html +++ b/docs/dyn/displayvideo_v2.advertisers.targetingTypes.assignedTargetingOptions.html @@ -128,7 +128,6 @@

Method Details

TARGETING_TYPE_ON_SCREEN_POSITION - Target ads in a specific on screen position. TARGETING_TYPE_THIRD_PARTY_VERIFIER - Filter web sites through third party verification (for example, IAS or DoubleVerify). TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION - Filter web sites by specific digital content label ratings (for example, DL-MA: suitable only for mature audiences). - TARGETING_TYPE_SENSITIVE_CATEGORY_EXCLUSION - Filter website content by sensitive categories (for example, adult). TARGETING_TYPE_ENVIRONMENT - Target ads to a specific environment (for example, web or app). TARGETING_TYPE_CARRIER_AND_ISP - Target ads to a specific network carrier or internet service provider (ISP) (for example, Comcast or Orange). TARGETING_TYPE_OPERATING_SYSTEM - Target ads to a specific operating system (for example, macOS). @@ -777,7 +776,6 @@

Method Details

TARGETING_TYPE_ON_SCREEN_POSITION - Target ads in a specific on screen position. TARGETING_TYPE_THIRD_PARTY_VERIFIER - Filter web sites through third party verification (for example, IAS or DoubleVerify). TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION - Filter web sites by specific digital content label ratings (for example, DL-MA: suitable only for mature audiences). - TARGETING_TYPE_SENSITIVE_CATEGORY_EXCLUSION - Filter website content by sensitive categories (for example, adult). TARGETING_TYPE_ENVIRONMENT - Target ads to a specific environment (for example, web or app). TARGETING_TYPE_CARRIER_AND_ISP - Target ads to a specific network carrier or internet service provider (ISP) (for example, Comcast or Orange). TARGETING_TYPE_OPERATING_SYSTEM - Target ads to a specific operating system (for example, macOS). @@ -847,7 +845,6 @@

Method Details

TARGETING_TYPE_ON_SCREEN_POSITION - Target ads in a specific on screen position. TARGETING_TYPE_THIRD_PARTY_VERIFIER - Filter web sites through third party verification (for example, IAS or DoubleVerify). TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION - Filter web sites by specific digital content label ratings (for example, DL-MA: suitable only for mature audiences). - TARGETING_TYPE_SENSITIVE_CATEGORY_EXCLUSION - Filter website content by sensitive categories (for example, adult). TARGETING_TYPE_ENVIRONMENT - Target ads to a specific environment (for example, web or app). TARGETING_TYPE_CARRIER_AND_ISP - Target ads to a specific network carrier or internet service provider (ISP) (for example, Comcast or Orange). TARGETING_TYPE_OPERATING_SYSTEM - Target ads to a specific operating system (for example, macOS). @@ -1204,7 +1201,6 @@

Method Details

TARGETING_TYPE_ON_SCREEN_POSITION - Target ads in a specific on screen position. TARGETING_TYPE_THIRD_PARTY_VERIFIER - Filter web sites through third party verification (for example, IAS or DoubleVerify). TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION - Filter web sites by specific digital content label ratings (for example, DL-MA: suitable only for mature audiences). - TARGETING_TYPE_SENSITIVE_CATEGORY_EXCLUSION - Filter website content by sensitive categories (for example, adult). TARGETING_TYPE_ENVIRONMENT - Target ads to a specific environment (for example, web or app). TARGETING_TYPE_CARRIER_AND_ISP - Target ads to a specific network carrier or internet service provider (ISP) (for example, Comcast or Orange). TARGETING_TYPE_OPERATING_SYSTEM - Target ads to a specific operating system (for example, macOS). diff --git a/docs/dyn/displayvideo_v2.advertisers.youtubeAdGroupAds.html b/docs/dyn/displayvideo_v2.advertisers.youtubeAdGroupAds.html index d1528f6935..de066ee480 100644 --- a/docs/dyn/displayvideo_v2.advertisers.youtubeAdGroupAds.html +++ b/docs/dyn/displayvideo_v2.advertisers.youtubeAdGroupAds.html @@ -120,7 +120,7 @@

Method Details

"audioAd": { # Details for an audio ad. # Details of an [audio ad](//support.google.com/displayvideo/answer/6274216) used for reach marketing objectives. "displayUrl": "A String", # The webpage address that appears with the ad. "finalUrl": "A String", # The URL address of the webpage that people reach after they click the ad. - "trackingUrl": "A String", # The URL address loaded in the background for tracking purposes. + "trackingUrl": "A String", # The URL address loaded in the background for tracking purposes. In v4 and earlier, this field represents the tracking URL specified by the user manually. This can be found at userSpecifiedTrackingUrl in v5. "video": { # Details of a YouTube video. # The YouTube video of the ad. "id": "A String", # Output only. The YouTube video ID which can be searched on YouTube webpage. "unavailableReason": "A String", # Output only. The reason why the video data is not available. @@ -129,7 +129,7 @@

Method Details

}, "bumperAd": { # Details for a bumper ad. # Details of a [non-skippable short video ad](//support.google.com/displayvideo/answer/6274216), equal to or less than 6 seconds, used for reach. "commonInStreamAttribute": { # Common attributes for in-stream, non-skippable and bumper ads. # Required. Common ad attributes. - "actionButtonLabel": "A String", # Optional. The text on the call-to-action button. + "actionButtonLabel": "A String", # Optional. The text on the call-to-action button. Must be set if actionHeadline is set. "actionHeadline": "A String", # Optional. The headline of the call-to-action banner. "companionBanner": { # Meta data of an image asset. # Optional. The image which shows next to the video ad. "assetId": "A String", # Required. The unique ID of the asset. @@ -142,7 +142,7 @@

Method Details

}, "displayUrl": "A String", # Required. The webpage address that appears with the ad. "finalUrl": "A String", # Required. The URL address of the webpage that people reach after they click the ad. - "trackingUrl": "A String", # Output only. The URL address loaded in the background for tracking purposes. + "trackingUrl": "A String", # Output only. The URL address loaded in the background for tracking purposes. In v4 and earlier, this field represents the tracking URL specified by the user manually. This can be found at userSpecifiedTrackingUrl in v5. "video": { # Details of a YouTube video. # Required. Immutable. The YouTube video of the ad. "id": "A String", # Output only. The YouTube video ID which can be searched on YouTube webpage. "unavailableReason": "A String", # Output only. The reason why the video data is not available. @@ -157,7 +157,7 @@

Method Details

"entityStatus": "A String", # The entity status of the ad. "inStreamAd": { # Details for an in-stream ad. # Details of an [in-stream ad skippable after 5 seconds](//support.google.com/displayvideo/answer/6274216), used for brand awareness or reach marketing objectives. "commonInStreamAttribute": { # Common attributes for in-stream, non-skippable and bumper ads. # Required. Common ad attributes. - "actionButtonLabel": "A String", # Optional. The text on the call-to-action button. + "actionButtonLabel": "A String", # Optional. The text on the call-to-action button. Must be set if actionHeadline is set. "actionHeadline": "A String", # Optional. The headline of the call-to-action banner. "companionBanner": { # Meta data of an image asset. # Optional. The image which shows next to the video ad. "assetId": "A String", # Required. The unique ID of the asset. @@ -170,7 +170,7 @@

Method Details

}, "displayUrl": "A String", # Required. The webpage address that appears with the ad. "finalUrl": "A String", # Required. The URL address of the webpage that people reach after they click the ad. - "trackingUrl": "A String", # Output only. The URL address loaded in the background for tracking purposes. + "trackingUrl": "A String", # Output only. The URL address loaded in the background for tracking purposes. In v4 and earlier, this field represents the tracking URL specified by the user manually. This can be found at userSpecifiedTrackingUrl in v5. "video": { # Details of a YouTube video. # Required. Immutable. The YouTube video of the ad. "id": "A String", # Output only. The YouTube video ID which can be searched on YouTube webpage. "unavailableReason": "A String", # Output only. The reason why the video data is not available. @@ -207,7 +207,7 @@

Method Details

"name": "A String", # The resource name of the ad. "nonSkippableAd": { # Details for a non-skippable ad. # Details of a [non-skippable short in-stream video ad](//support.google.com/displayvideo/answer/6274216), between 6 and 15 seconds, used for reach marketing objectives. "commonInStreamAttribute": { # Common attributes for in-stream, non-skippable and bumper ads. # Required. Common ad attributes. - "actionButtonLabel": "A String", # Optional. The text on the call-to-action button. + "actionButtonLabel": "A String", # Optional. The text on the call-to-action button. Must be set if actionHeadline is set. "actionHeadline": "A String", # Optional. The headline of the call-to-action banner. "companionBanner": { # Meta data of an image asset. # Optional. The image which shows next to the video ad. "assetId": "A String", # Required. The unique ID of the asset. @@ -220,7 +220,7 @@

Method Details

}, "displayUrl": "A String", # Required. The webpage address that appears with the ad. "finalUrl": "A String", # Required. The URL address of the webpage that people reach after they click the ad. - "trackingUrl": "A String", # Output only. The URL address loaded in the background for tracking purposes. + "trackingUrl": "A String", # Output only. The URL address loaded in the background for tracking purposes. In v4 and earlier, this field represents the tracking URL specified by the user manually. This can be found at userSpecifiedTrackingUrl in v5. "video": { # Details of a YouTube video. # Required. Immutable. The YouTube video of the ad. "id": "A String", # Output only. The YouTube video ID which can be searched on YouTube webpage. "unavailableReason": "A String", # Output only. The reason why the video data is not available. @@ -243,7 +243,7 @@

Method Details

}, }, "videoPerformanceAd": { # Details for a video performance ad. # Details of an [ad used in a video action campaign](//support.google.com/google-ads/answer/10147229) to drive actions to the business, service or product. - "actionButtonLabels": [ # Optional. The list of text assets shown on the call-to-action button. + "actionButtonLabels": [ # Optional. The list of text assets shown on the call-to-action button. Must be set if headlines is set. "A String", ], "companionBanners": [ # Optional. The list of companion banners used by this ad. @@ -260,20 +260,20 @@

Method Details

"customParameters": { # Optional. The custom parameters and accompanying values to add to the tracking URL. "a_key": "A String", }, - "descriptions": [ # Optional. The list of descriptions shown on the call-to-action banner. + "descriptions": [ # Optional. The list of descriptions shown on the call-to-action banner. Must be set unless the parent line item's lineItemType is `LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_NON_SKIPPABLE`, in which case this field cannot be set. "A String", ], "displayUrlBreadcrumb1": "A String", # Optional. The first piece after the domain in the display URL. - "displayUrlBreadcrumb2": "A String", # Optional. The second piece after the domain in the display URL. + "displayUrlBreadcrumb2": "A String", # Optional. The second piece after the domain in the display URL. Can only be set if displayUrlBreadcrumb1 is also set. "domain": "A String", # Output only. The domain of the display URL. "finalUrl": "A String", # Required. The URL address of the webpage that people reach after they click the ad. "headlines": [ # Optional. The list of headlines shown on the call-to-action banner. "A String", ], - "longHeadlines": [ # Optional. The list of long headlines shown on the call-to-action banner. + "longHeadlines": [ # Optional. The list of long headlines shown on the call-to-action banner. Must be set unless the parent line item's lineItemType is `LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_NON_SKIPPABLE`, in which case this field cannot be set. "A String", ], - "trackingUrl": "A String", # Output only. The URL address loaded in the background for tracking purposes. + "trackingUrl": "A String", # Output only. The URL address loaded in the background for tracking purposes. In v4 and earlier, this field represents the tracking URL specified by the user manually. This can be found at userSpecifiedTrackingUrl in v5. "videos": [ # Required. The list of YouTube video assets used by this ad. { # Details of a YouTube video. "id": "A String", # Output only. The YouTube video ID which can be searched on YouTube webpage. @@ -319,7 +319,7 @@

Method Details

"audioAd": { # Details for an audio ad. # Details of an [audio ad](//support.google.com/displayvideo/answer/6274216) used for reach marketing objectives. "displayUrl": "A String", # The webpage address that appears with the ad. "finalUrl": "A String", # The URL address of the webpage that people reach after they click the ad. - "trackingUrl": "A String", # The URL address loaded in the background for tracking purposes. + "trackingUrl": "A String", # The URL address loaded in the background for tracking purposes. In v4 and earlier, this field represents the tracking URL specified by the user manually. This can be found at userSpecifiedTrackingUrl in v5. "video": { # Details of a YouTube video. # The YouTube video of the ad. "id": "A String", # Output only. The YouTube video ID which can be searched on YouTube webpage. "unavailableReason": "A String", # Output only. The reason why the video data is not available. @@ -328,7 +328,7 @@

Method Details

}, "bumperAd": { # Details for a bumper ad. # Details of a [non-skippable short video ad](//support.google.com/displayvideo/answer/6274216), equal to or less than 6 seconds, used for reach. "commonInStreamAttribute": { # Common attributes for in-stream, non-skippable and bumper ads. # Required. Common ad attributes. - "actionButtonLabel": "A String", # Optional. The text on the call-to-action button. + "actionButtonLabel": "A String", # Optional. The text on the call-to-action button. Must be set if actionHeadline is set. "actionHeadline": "A String", # Optional. The headline of the call-to-action banner. "companionBanner": { # Meta data of an image asset. # Optional. The image which shows next to the video ad. "assetId": "A String", # Required. The unique ID of the asset. @@ -341,7 +341,7 @@

Method Details

}, "displayUrl": "A String", # Required. The webpage address that appears with the ad. "finalUrl": "A String", # Required. The URL address of the webpage that people reach after they click the ad. - "trackingUrl": "A String", # Output only. The URL address loaded in the background for tracking purposes. + "trackingUrl": "A String", # Output only. The URL address loaded in the background for tracking purposes. In v4 and earlier, this field represents the tracking URL specified by the user manually. This can be found at userSpecifiedTrackingUrl in v5. "video": { # Details of a YouTube video. # Required. Immutable. The YouTube video of the ad. "id": "A String", # Output only. The YouTube video ID which can be searched on YouTube webpage. "unavailableReason": "A String", # Output only. The reason why the video data is not available. @@ -356,7 +356,7 @@

Method Details

"entityStatus": "A String", # The entity status of the ad. "inStreamAd": { # Details for an in-stream ad. # Details of an [in-stream ad skippable after 5 seconds](//support.google.com/displayvideo/answer/6274216), used for brand awareness or reach marketing objectives. "commonInStreamAttribute": { # Common attributes for in-stream, non-skippable and bumper ads. # Required. Common ad attributes. - "actionButtonLabel": "A String", # Optional. The text on the call-to-action button. + "actionButtonLabel": "A String", # Optional. The text on the call-to-action button. Must be set if actionHeadline is set. "actionHeadline": "A String", # Optional. The headline of the call-to-action banner. "companionBanner": { # Meta data of an image asset. # Optional. The image which shows next to the video ad. "assetId": "A String", # Required. The unique ID of the asset. @@ -369,7 +369,7 @@

Method Details

}, "displayUrl": "A String", # Required. The webpage address that appears with the ad. "finalUrl": "A String", # Required. The URL address of the webpage that people reach after they click the ad. - "trackingUrl": "A String", # Output only. The URL address loaded in the background for tracking purposes. + "trackingUrl": "A String", # Output only. The URL address loaded in the background for tracking purposes. In v4 and earlier, this field represents the tracking URL specified by the user manually. This can be found at userSpecifiedTrackingUrl in v5. "video": { # Details of a YouTube video. # Required. Immutable. The YouTube video of the ad. "id": "A String", # Output only. The YouTube video ID which can be searched on YouTube webpage. "unavailableReason": "A String", # Output only. The reason why the video data is not available. @@ -406,7 +406,7 @@

Method Details

"name": "A String", # The resource name of the ad. "nonSkippableAd": { # Details for a non-skippable ad. # Details of a [non-skippable short in-stream video ad](//support.google.com/displayvideo/answer/6274216), between 6 and 15 seconds, used for reach marketing objectives. "commonInStreamAttribute": { # Common attributes for in-stream, non-skippable and bumper ads. # Required. Common ad attributes. - "actionButtonLabel": "A String", # Optional. The text on the call-to-action button. + "actionButtonLabel": "A String", # Optional. The text on the call-to-action button. Must be set if actionHeadline is set. "actionHeadline": "A String", # Optional. The headline of the call-to-action banner. "companionBanner": { # Meta data of an image asset. # Optional. The image which shows next to the video ad. "assetId": "A String", # Required. The unique ID of the asset. @@ -419,7 +419,7 @@

Method Details

}, "displayUrl": "A String", # Required. The webpage address that appears with the ad. "finalUrl": "A String", # Required. The URL address of the webpage that people reach after they click the ad. - "trackingUrl": "A String", # Output only. The URL address loaded in the background for tracking purposes. + "trackingUrl": "A String", # Output only. The URL address loaded in the background for tracking purposes. In v4 and earlier, this field represents the tracking URL specified by the user manually. This can be found at userSpecifiedTrackingUrl in v5. "video": { # Details of a YouTube video. # Required. Immutable. The YouTube video of the ad. "id": "A String", # Output only. The YouTube video ID which can be searched on YouTube webpage. "unavailableReason": "A String", # Output only. The reason why the video data is not available. @@ -442,7 +442,7 @@

Method Details

}, }, "videoPerformanceAd": { # Details for a video performance ad. # Details of an [ad used in a video action campaign](//support.google.com/google-ads/answer/10147229) to drive actions to the business, service or product. - "actionButtonLabels": [ # Optional. The list of text assets shown on the call-to-action button. + "actionButtonLabels": [ # Optional. The list of text assets shown on the call-to-action button. Must be set if headlines is set. "A String", ], "companionBanners": [ # Optional. The list of companion banners used by this ad. @@ -459,20 +459,20 @@

Method Details

"customParameters": { # Optional. The custom parameters and accompanying values to add to the tracking URL. "a_key": "A String", }, - "descriptions": [ # Optional. The list of descriptions shown on the call-to-action banner. + "descriptions": [ # Optional. The list of descriptions shown on the call-to-action banner. Must be set unless the parent line item's lineItemType is `LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_NON_SKIPPABLE`, in which case this field cannot be set. "A String", ], "displayUrlBreadcrumb1": "A String", # Optional. The first piece after the domain in the display URL. - "displayUrlBreadcrumb2": "A String", # Optional. The second piece after the domain in the display URL. + "displayUrlBreadcrumb2": "A String", # Optional. The second piece after the domain in the display URL. Can only be set if displayUrlBreadcrumb1 is also set. "domain": "A String", # Output only. The domain of the display URL. "finalUrl": "A String", # Required. The URL address of the webpage that people reach after they click the ad. "headlines": [ # Optional. The list of headlines shown on the call-to-action banner. "A String", ], - "longHeadlines": [ # Optional. The list of long headlines shown on the call-to-action banner. + "longHeadlines": [ # Optional. The list of long headlines shown on the call-to-action banner. Must be set unless the parent line item's lineItemType is `LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_NON_SKIPPABLE`, in which case this field cannot be set. "A String", ], - "trackingUrl": "A String", # Output only. The URL address loaded in the background for tracking purposes. + "trackingUrl": "A String", # Output only. The URL address loaded in the background for tracking purposes. In v4 and earlier, this field represents the tracking URL specified by the user manually. This can be found at userSpecifiedTrackingUrl in v5. "videos": [ # Required. The list of YouTube video assets used by this ad. { # Details of a YouTube video. "id": "A String", # Output only. The YouTube video ID which can be searched on YouTube webpage. diff --git a/docs/dyn/displayvideo_v2.advertisers.youtubeAdGroups.targetingTypes.assignedTargetingOptions.html b/docs/dyn/displayvideo_v2.advertisers.youtubeAdGroups.targetingTypes.assignedTargetingOptions.html index 383468d329..94a76e54bb 100644 --- a/docs/dyn/displayvideo_v2.advertisers.youtubeAdGroups.targetingTypes.assignedTargetingOptions.html +++ b/docs/dyn/displayvideo_v2.advertisers.youtubeAdGroups.targetingTypes.assignedTargetingOptions.html @@ -123,7 +123,6 @@

Method Details

TARGETING_TYPE_ON_SCREEN_POSITION - Target ads in a specific on screen position. TARGETING_TYPE_THIRD_PARTY_VERIFIER - Filter web sites through third party verification (for example, IAS or DoubleVerify). TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION - Filter web sites by specific digital content label ratings (for example, DL-MA: suitable only for mature audiences). - TARGETING_TYPE_SENSITIVE_CATEGORY_EXCLUSION - Filter website content by sensitive categories (for example, adult). TARGETING_TYPE_ENVIRONMENT - Target ads to a specific environment (for example, web or app). TARGETING_TYPE_CARRIER_AND_ISP - Target ads to a specific network carrier or internet service provider (ISP) (for example, Comcast or Orange). TARGETING_TYPE_OPERATING_SYSTEM - Target ads to a specific operating system (for example, macOS). @@ -481,7 +480,6 @@

Method Details

TARGETING_TYPE_ON_SCREEN_POSITION - Target ads in a specific on screen position. TARGETING_TYPE_THIRD_PARTY_VERIFIER - Filter web sites through third party verification (for example, IAS or DoubleVerify). TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION - Filter web sites by specific digital content label ratings (for example, DL-MA: suitable only for mature audiences). - TARGETING_TYPE_SENSITIVE_CATEGORY_EXCLUSION - Filter website content by sensitive categories (for example, adult). TARGETING_TYPE_ENVIRONMENT - Target ads to a specific environment (for example, web or app). TARGETING_TYPE_CARRIER_AND_ISP - Target ads to a specific network carrier or internet service provider (ISP) (for example, Comcast or Orange). TARGETING_TYPE_OPERATING_SYSTEM - Target ads to a specific operating system (for example, macOS). diff --git a/docs/dyn/displayvideo_v2.partners.targetingTypes.assignedTargetingOptions.html b/docs/dyn/displayvideo_v2.partners.targetingTypes.assignedTargetingOptions.html index 6e6a199e0a..f50888afdc 100644 --- a/docs/dyn/displayvideo_v2.partners.targetingTypes.assignedTargetingOptions.html +++ b/docs/dyn/displayvideo_v2.partners.targetingTypes.assignedTargetingOptions.html @@ -128,7 +128,6 @@

Method Details

TARGETING_TYPE_ON_SCREEN_POSITION - Target ads in a specific on screen position. TARGETING_TYPE_THIRD_PARTY_VERIFIER - Filter web sites through third party verification (for example, IAS or DoubleVerify). TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION - Filter web sites by specific digital content label ratings (for example, DL-MA: suitable only for mature audiences). - TARGETING_TYPE_SENSITIVE_CATEGORY_EXCLUSION - Filter website content by sensitive categories (for example, adult). TARGETING_TYPE_ENVIRONMENT - Target ads to a specific environment (for example, web or app). TARGETING_TYPE_CARRIER_AND_ISP - Target ads to a specific network carrier or internet service provider (ISP) (for example, Comcast or Orange). TARGETING_TYPE_OPERATING_SYSTEM - Target ads to a specific operating system (for example, macOS). @@ -777,7 +776,6 @@

Method Details

TARGETING_TYPE_ON_SCREEN_POSITION - Target ads in a specific on screen position. TARGETING_TYPE_THIRD_PARTY_VERIFIER - Filter web sites through third party verification (for example, IAS or DoubleVerify). TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION - Filter web sites by specific digital content label ratings (for example, DL-MA: suitable only for mature audiences). - TARGETING_TYPE_SENSITIVE_CATEGORY_EXCLUSION - Filter website content by sensitive categories (for example, adult). TARGETING_TYPE_ENVIRONMENT - Target ads to a specific environment (for example, web or app). TARGETING_TYPE_CARRIER_AND_ISP - Target ads to a specific network carrier or internet service provider (ISP) (for example, Comcast or Orange). TARGETING_TYPE_OPERATING_SYSTEM - Target ads to a specific operating system (for example, macOS). @@ -847,7 +845,6 @@

Method Details

TARGETING_TYPE_ON_SCREEN_POSITION - Target ads in a specific on screen position. TARGETING_TYPE_THIRD_PARTY_VERIFIER - Filter web sites through third party verification (for example, IAS or DoubleVerify). TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION - Filter web sites by specific digital content label ratings (for example, DL-MA: suitable only for mature audiences). - TARGETING_TYPE_SENSITIVE_CATEGORY_EXCLUSION - Filter website content by sensitive categories (for example, adult). TARGETING_TYPE_ENVIRONMENT - Target ads to a specific environment (for example, web or app). TARGETING_TYPE_CARRIER_AND_ISP - Target ads to a specific network carrier or internet service provider (ISP) (for example, Comcast or Orange). TARGETING_TYPE_OPERATING_SYSTEM - Target ads to a specific operating system (for example, macOS). @@ -1204,7 +1201,6 @@

Method Details

TARGETING_TYPE_ON_SCREEN_POSITION - Target ads in a specific on screen position. TARGETING_TYPE_THIRD_PARTY_VERIFIER - Filter web sites through third party verification (for example, IAS or DoubleVerify). TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION - Filter web sites by specific digital content label ratings (for example, DL-MA: suitable only for mature audiences). - TARGETING_TYPE_SENSITIVE_CATEGORY_EXCLUSION - Filter website content by sensitive categories (for example, adult). TARGETING_TYPE_ENVIRONMENT - Target ads to a specific environment (for example, web or app). TARGETING_TYPE_CARRIER_AND_ISP - Target ads to a specific network carrier or internet service provider (ISP) (for example, Comcast or Orange). TARGETING_TYPE_OPERATING_SYSTEM - Target ads to a specific operating system (for example, macOS). diff --git a/docs/dyn/displayvideo_v2.targetingTypes.targetingOptions.html b/docs/dyn/displayvideo_v2.targetingTypes.targetingOptions.html index 9203dc557d..2a2be0b5e7 100644 --- a/docs/dyn/displayvideo_v2.targetingTypes.targetingOptions.html +++ b/docs/dyn/displayvideo_v2.targetingTypes.targetingOptions.html @@ -127,7 +127,6 @@

Method Details

TARGETING_TYPE_ON_SCREEN_POSITION - Target ads in a specific on screen position. TARGETING_TYPE_THIRD_PARTY_VERIFIER - Filter web sites through third party verification (for example, IAS or DoubleVerify). TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION - Filter web sites by specific digital content label ratings (for example, DL-MA: suitable only for mature audiences). - TARGETING_TYPE_SENSITIVE_CATEGORY_EXCLUSION - Filter website content by sensitive categories (for example, adult). TARGETING_TYPE_ENVIRONMENT - Target ads to a specific environment (for example, web or app). TARGETING_TYPE_CARRIER_AND_ISP - Target ads to a specific network carrier or internet service provider (ISP) (for example, Comcast or Orange). TARGETING_TYPE_OPERATING_SYSTEM - Target ads to a specific operating system (for example, macOS). @@ -305,7 +304,6 @@

Method Details

TARGETING_TYPE_ON_SCREEN_POSITION - Target ads in a specific on screen position. TARGETING_TYPE_THIRD_PARTY_VERIFIER - Filter web sites through third party verification (for example, IAS or DoubleVerify). TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION - Filter web sites by specific digital content label ratings (for example, DL-MA: suitable only for mature audiences). - TARGETING_TYPE_SENSITIVE_CATEGORY_EXCLUSION - Filter website content by sensitive categories (for example, adult). TARGETING_TYPE_ENVIRONMENT - Target ads to a specific environment (for example, web or app). TARGETING_TYPE_CARRIER_AND_ISP - Target ads to a specific network carrier or internet service provider (ISP) (for example, Comcast or Orange). TARGETING_TYPE_OPERATING_SYSTEM - Target ads to a specific operating system (for example, macOS). @@ -505,7 +503,6 @@

Method Details

TARGETING_TYPE_ON_SCREEN_POSITION - Target ads in a specific on screen position. TARGETING_TYPE_THIRD_PARTY_VERIFIER - Filter web sites through third party verification (for example, IAS or DoubleVerify). TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION - Filter web sites by specific digital content label ratings (for example, DL-MA: suitable only for mature audiences). - TARGETING_TYPE_SENSITIVE_CATEGORY_EXCLUSION - Filter website content by sensitive categories (for example, adult). TARGETING_TYPE_ENVIRONMENT - Target ads to a specific environment (for example, web or app). TARGETING_TYPE_CARRIER_AND_ISP - Target ads to a specific network carrier or internet service provider (ISP) (for example, Comcast or Orange). TARGETING_TYPE_OPERATING_SYSTEM - Target ads to a specific operating system (for example, macOS). diff --git a/docs/dyn/displayvideo_v3.advertisers.adGroupAds.html b/docs/dyn/displayvideo_v3.advertisers.adGroupAds.html index 67947b9c22..6713547521 100644 --- a/docs/dyn/displayvideo_v3.advertisers.adGroupAds.html +++ b/docs/dyn/displayvideo_v3.advertisers.adGroupAds.html @@ -79,10 +79,10 @@

Instance Methods

Close httplib2 connections.

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

-

Creates an ad group ad. This method is only supported for Demand Gen ads.

+

Creates an ad group ad.

delete(advertiserId, adGroupAdId, x__xgafv=None)

-

Deletes an ad group ad. This method is only supported for Demand Gen ads.

+

Deletes an ad group ad.

get(advertiserId, adGroupAdId, x__xgafv=None)

Gets an ad group ad.

@@ -94,7 +94,7 @@

Instance Methods

Retrieves the next page of results.

patch(advertiserId, adGroupAdId, body=None, updateMask=None, x__xgafv=None)

-

Updates an ad group ad. This method is only supported for Demand Gen ads.

+

Updates an ad group ad.

Method Details

close() @@ -103,14 +103,14 @@

Method Details

create(advertiserId, body=None, x__xgafv=None) - 
Creates an ad group ad. This method is only supported for Demand Gen ads.
+  
Creates an ad group ad.
 
 Args:
   advertiserId: string, Output only. The unique ID of the advertiser the ad belongs to. (required)
   body: object, The request body.
     The object takes the form of:
 
-{ # LINT: LEGACY_NAMES A single ad associated with an ad group.
+{ # A single ad associated with an ad group.
   "adGroupAdId": "A String", # Output only. The unique ID of the ad. Assigned by the system.
   "adGroupId": "A String", # Required. Immutable. The unique ID of the ad group that the ad belongs to.
   "adPolicy": { # A single ad policy associated with an ad group ad. # Output only. The policy approval status of the ad.
@@ -256,7 +256,7 @@ 
Method Details

   "audioAd": { # Details for an audio ad. # Output only. Details of an [audio ad](//support.google.com/displayvideo/answer/6274216) used for reach marketing objectives.
     "displayUrl": "A String", # The webpage address that appears with the ad.
     "finalUrl": "A String", # The URL address of the webpage that people reach after they click the ad.
-    "trackingUrl": "A String", # The URL address loaded in the background for tracking purposes.
+    "trackingUrl": "A String", # The URL address loaded in the background for tracking purposes. In v4 and earlier, this field represents the tracking URL specified by the user manually. This can be found at userSpecifiedTrackingUrl in v5.
     "video": { # Details of a YouTube video. # The YouTube video of the ad.
       "id": "A String", # Output only. The YouTube video ID which can be searched on YouTube webpage.
       "unavailableReason": "A String", # Output only. The reason why the video data is not available.
@@ -265,7 +265,7 @@ 
Method Details

   },
   "bumperAd": { # Details for a bumper ad. # Optional. Details of a [non-skippable short video ad](//support.google.com/displayvideo/answer/6274216), equal to or less than 6 seconds, used for reach.
     "commonInStreamAttribute": { # Common attributes for in-stream, non-skippable and bumper ads. # Required. Common ad attributes.
-      "actionButtonLabel": "A String", # Optional. The text on the call-to-action button.
+      "actionButtonLabel": "A String", # Optional. The text on the call-to-action button. Must be set if actionHeadline is set.
       "actionHeadline": "A String", # Optional. The headline of the call-to-action banner.
       "companionBanner": { # Meta data of an image asset. # Optional. The image which shows next to the video ad.
         "assetId": "A String", # Required. The unique ID of the asset.
@@ -278,7 +278,7 @@ 
Method Details

       },
       "displayUrl": "A String", # Required. The webpage address that appears with the ad.
       "finalUrl": "A String", # Required. The URL address of the webpage that people reach after they click the ad.
-      "trackingUrl": "A String", # Output only. The URL address loaded in the background for tracking purposes.
+      "trackingUrl": "A String", # Output only. The URL address loaded in the background for tracking purposes. In v4 and earlier, this field represents the tracking URL specified by the user manually. This can be found at userSpecifiedTrackingUrl in v5.
       "video": { # Details of a YouTube video. # Required. Immutable. The YouTube video of the ad.
         "id": "A String", # Output only. The YouTube video ID which can be searched on YouTube webpage.
         "unavailableReason": "A String", # Output only. The reason why the video data is not available.
@@ -286,7 +286,7 @@ 
Method Details

       },
     },
   },
-  "dcmTrackingInfo": { # Details on the DCM tracking. # Optional. The DCM tracking ad info. Only valid for Demand Gen ads. To remove the DCM tracking ad info, please leave this field empty.
+  "dcmTrackingInfo": { # Details on the DCM tracking. # Optional. The DCM tracking ad info. To remove the DCM tracking ad info, please leave this field empty.
     "creativeId": "A String", # Required. The DCM creative id.
     "placementId": "A String", # Required. The DCM placement id.
     "trackingAdId": "A String", # Required. The DCM tracking ad id.
@@ -488,7 +488,7 @@ 
Method Details

   "entityStatus": "A String", # Required. The entity status of the ad.
   "inStreamAd": { # Details for an in-stream ad. # Optional. Details of an [in-stream ad skippable after 5 seconds](//support.google.com/displayvideo/answer/6274216), used for brand awareness or reach marketing objectives.
     "commonInStreamAttribute": { # Common attributes for in-stream, non-skippable and bumper ads. # Required. Common ad attributes.
-      "actionButtonLabel": "A String", # Optional. The text on the call-to-action button.
+      "actionButtonLabel": "A String", # Optional. The text on the call-to-action button. Must be set if actionHeadline is set.
       "actionHeadline": "A String", # Optional. The headline of the call-to-action banner.
       "companionBanner": { # Meta data of an image asset. # Optional. The image which shows next to the video ad.
         "assetId": "A String", # Required. The unique ID of the asset.
@@ -501,7 +501,7 @@ 
Method Details

       },
       "displayUrl": "A String", # Required. The webpage address that appears with the ad.
       "finalUrl": "A String", # Required. The URL address of the webpage that people reach after they click the ad.
-      "trackingUrl": "A String", # Output only. The URL address loaded in the background for tracking purposes.
+      "trackingUrl": "A String", # Output only. The URL address loaded in the background for tracking purposes. In v4 and earlier, this field represents the tracking URL specified by the user manually. This can be found at userSpecifiedTrackingUrl in v5.
       "video": { # Details of a YouTube video. # Required. Immutable. The YouTube video of the ad.
         "id": "A String", # Output only. The YouTube video ID which can be searched on YouTube webpage.
         "unavailableReason": "A String", # Output only. The reason why the video data is not available.
@@ -538,7 +538,7 @@ 
Method Details

   "name": "A String", # Output only. The resource name of the ad.
   "nonSkippableAd": { # Details for a non-skippable ad. # Optional. Details of a [non-skippable short in-stream video ad](//support.google.com/displayvideo/answer/6274216), between 6 and 15 seconds, used for reach marketing objectives.
     "commonInStreamAttribute": { # Common attributes for in-stream, non-skippable and bumper ads. # Required. Common ad attributes.
-      "actionButtonLabel": "A String", # Optional. The text on the call-to-action button.
+      "actionButtonLabel": "A String", # Optional. The text on the call-to-action button. Must be set if actionHeadline is set.
       "actionHeadline": "A String", # Optional. The headline of the call-to-action banner.
       "companionBanner": { # Meta data of an image asset. # Optional. The image which shows next to the video ad.
         "assetId": "A String", # Required. The unique ID of the asset.
@@ -551,7 +551,7 @@ 
Method Details

       },
       "displayUrl": "A String", # Required. The webpage address that appears with the ad.
       "finalUrl": "A String", # Required. The URL address of the webpage that people reach after they click the ad.
-      "trackingUrl": "A String", # Output only. The URL address loaded in the background for tracking purposes.
+      "trackingUrl": "A String", # Output only. The URL address loaded in the background for tracking purposes. In v4 and earlier, this field represents the tracking URL specified by the user manually. This can be found at userSpecifiedTrackingUrl in v5.
       "video": { # Details of a YouTube video. # Required. Immutable. The YouTube video of the ad.
         "id": "A String", # Output only. The YouTube video ID which can be searched on YouTube webpage.
         "unavailableReason": "A String", # Output only. The reason why the video data is not available.
@@ -574,7 +574,7 @@ 
Method Details

     },
   },
   "videoPerformanceAd": { # Details for a video performance ad. # Optional. Details of an [ad used in a video action campaign](//support.google.com/google-ads/answer/10147229) to drive actions to the business, service or product.
-    "actionButtonLabels": [ # Optional. The list of text assets shown on the call-to-action button.
+    "actionButtonLabels": [ # Optional. The list of text assets shown on the call-to-action button. Must be set if headlines is set.
       "A String",
     ],
     "companionBanners": [ # Optional. The list of companion banners used by this ad.
@@ -591,20 +591,20 @@ 
Method Details

     "customParameters": { # Optional. The custom parameters and accompanying values to add to the tracking URL.
       "a_key": "A String",
     },
-    "descriptions": [ # Optional. The list of descriptions shown on the call-to-action banner.
+    "descriptions": [ # Optional. The list of descriptions shown on the call-to-action banner. Must be set unless the parent line item's lineItemType is `LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_NON_SKIPPABLE`, in which case this field cannot be set.
       "A String",
     ],
     "displayUrlBreadcrumb1": "A String", # Optional. The first piece after the domain in the display URL.
-    "displayUrlBreadcrumb2": "A String", # Optional. The second piece after the domain in the display URL.
+    "displayUrlBreadcrumb2": "A String", # Optional. The second piece after the domain in the display URL. Can only be set if displayUrlBreadcrumb1 is also set.
     "domain": "A String", # Output only. The domain of the display URL.
     "finalUrl": "A String", # Required. The URL address of the webpage that people reach after they click the ad.
     "headlines": [ # Optional. The list of headlines shown on the call-to-action banner.
       "A String",
     ],
-    "longHeadlines": [ # Optional. The list of long headlines shown on the call-to-action banner.
+    "longHeadlines": [ # Optional. The list of long headlines shown on the call-to-action banner. Must be set unless the parent line item's lineItemType is `LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_NON_SKIPPABLE`, in which case this field cannot be set.
       "A String",
     ],
-    "trackingUrl": "A String", # Output only. The URL address loaded in the background for tracking purposes.
+    "trackingUrl": "A String", # Output only. The URL address loaded in the background for tracking purposes. In v4 and earlier, this field represents the tracking URL specified by the user manually. This can be found at userSpecifiedTrackingUrl in v5.
     "videos": [ # Required. The list of YouTube video assets used by this ad.
       { # Details of a YouTube video.
         "id": "A String", # Output only. The YouTube video ID which can be searched on YouTube webpage.
@@ -623,7 +623,7 @@ 
Method Details

 Returns:
   An object of the form:
 
-    { # LINT: LEGACY_NAMES A single ad associated with an ad group.
+    { # A single ad associated with an ad group.
   "adGroupAdId": "A String", # Output only. The unique ID of the ad. Assigned by the system.
   "adGroupId": "A String", # Required. Immutable. The unique ID of the ad group that the ad belongs to.
   "adPolicy": { # A single ad policy associated with an ad group ad. # Output only. The policy approval status of the ad.
@@ -769,7 +769,7 @@ 
Method Details

   "audioAd": { # Details for an audio ad. # Output only. Details of an [audio ad](//support.google.com/displayvideo/answer/6274216) used for reach marketing objectives.
     "displayUrl": "A String", # The webpage address that appears with the ad.
     "finalUrl": "A String", # The URL address of the webpage that people reach after they click the ad.
-    "trackingUrl": "A String", # The URL address loaded in the background for tracking purposes.
+    "trackingUrl": "A String", # The URL address loaded in the background for tracking purposes. In v4 and earlier, this field represents the tracking URL specified by the user manually. This can be found at userSpecifiedTrackingUrl in v5.
     "video": { # Details of a YouTube video. # The YouTube video of the ad.
       "id": "A String", # Output only. The YouTube video ID which can be searched on YouTube webpage.
       "unavailableReason": "A String", # Output only. The reason why the video data is not available.
@@ -778,7 +778,7 @@ 
Method Details

   },
   "bumperAd": { # Details for a bumper ad. # Optional. Details of a [non-skippable short video ad](//support.google.com/displayvideo/answer/6274216), equal to or less than 6 seconds, used for reach.
     "commonInStreamAttribute": { # Common attributes for in-stream, non-skippable and bumper ads. # Required. Common ad attributes.
-      "actionButtonLabel": "A String", # Optional. The text on the call-to-action button.
+      "actionButtonLabel": "A String", # Optional. The text on the call-to-action button. Must be set if actionHeadline is set.
       "actionHeadline": "A String", # Optional. The headline of the call-to-action banner.
       "companionBanner": { # Meta data of an image asset. # Optional. The image which shows next to the video ad.
         "assetId": "A String", # Required. The unique ID of the asset.
@@ -791,7 +791,7 @@ 
Method Details

       },
       "displayUrl": "A String", # Required. The webpage address that appears with the ad.
       "finalUrl": "A String", # Required. The URL address of the webpage that people reach after they click the ad.
-      "trackingUrl": "A String", # Output only. The URL address loaded in the background for tracking purposes.
+      "trackingUrl": "A String", # Output only. The URL address loaded in the background for tracking purposes. In v4 and earlier, this field represents the tracking URL specified by the user manually. This can be found at userSpecifiedTrackingUrl in v5.
       "video": { # Details of a YouTube video. # Required. Immutable. The YouTube video of the ad.
         "id": "A String", # Output only. The YouTube video ID which can be searched on YouTube webpage.
         "unavailableReason": "A String", # Output only. The reason why the video data is not available.
@@ -799,7 +799,7 @@ 
Method Details

       },
     },
   },
-  "dcmTrackingInfo": { # Details on the DCM tracking. # Optional. The DCM tracking ad info. Only valid for Demand Gen ads. To remove the DCM tracking ad info, please leave this field empty.
+  "dcmTrackingInfo": { # Details on the DCM tracking. # Optional. The DCM tracking ad info. To remove the DCM tracking ad info, please leave this field empty.
     "creativeId": "A String", # Required. The DCM creative id.
     "placementId": "A String", # Required. The DCM placement id.
     "trackingAdId": "A String", # Required. The DCM tracking ad id.
@@ -1001,7 +1001,7 @@ 
Method Details

   "entityStatus": "A String", # Required. The entity status of the ad.
   "inStreamAd": { # Details for an in-stream ad. # Optional. Details of an [in-stream ad skippable after 5 seconds](//support.google.com/displayvideo/answer/6274216), used for brand awareness or reach marketing objectives.
     "commonInStreamAttribute": { # Common attributes for in-stream, non-skippable and bumper ads. # Required. Common ad attributes.
-      "actionButtonLabel": "A String", # Optional. The text on the call-to-action button.
+      "actionButtonLabel": "A String", # Optional. The text on the call-to-action button. Must be set if actionHeadline is set.
       "actionHeadline": "A String", # Optional. The headline of the call-to-action banner.
       "companionBanner": { # Meta data of an image asset. # Optional. The image which shows next to the video ad.
         "assetId": "A String", # Required. The unique ID of the asset.
@@ -1014,7 +1014,7 @@ 
Method Details

       },
       "displayUrl": "A String", # Required. The webpage address that appears with the ad.
       "finalUrl": "A String", # Required. The URL address of the webpage that people reach after they click the ad.
-      "trackingUrl": "A String", # Output only. The URL address loaded in the background for tracking purposes.
+      "trackingUrl": "A String", # Output only. The URL address loaded in the background for tracking purposes. In v4 and earlier, this field represents the tracking URL specified by the user manually. This can be found at userSpecifiedTrackingUrl in v5.
       "video": { # Details of a YouTube video. # Required. Immutable. The YouTube video of the ad.
         "id": "A String", # Output only. The YouTube video ID which can be searched on YouTube webpage.
         "unavailableReason": "A String", # Output only. The reason why the video data is not available.
@@ -1051,7 +1051,7 @@ 
Method Details

   "name": "A String", # Output only. The resource name of the ad.
   "nonSkippableAd": { # Details for a non-skippable ad. # Optional. Details of a [non-skippable short in-stream video ad](//support.google.com/displayvideo/answer/6274216), between 6 and 15 seconds, used for reach marketing objectives.
     "commonInStreamAttribute": { # Common attributes for in-stream, non-skippable and bumper ads. # Required. Common ad attributes.
-      "actionButtonLabel": "A String", # Optional. The text on the call-to-action button.
+      "actionButtonLabel": "A String", # Optional. The text on the call-to-action button. Must be set if actionHeadline is set.
       "actionHeadline": "A String", # Optional. The headline of the call-to-action banner.
       "companionBanner": { # Meta data of an image asset. # Optional. The image which shows next to the video ad.
         "assetId": "A String", # Required. The unique ID of the asset.
@@ -1064,7 +1064,7 @@ 
Method Details

       },
       "displayUrl": "A String", # Required. The webpage address that appears with the ad.
       "finalUrl": "A String", # Required. The URL address of the webpage that people reach after they click the ad.
-      "trackingUrl": "A String", # Output only. The URL address loaded in the background for tracking purposes.
+      "trackingUrl": "A String", # Output only. The URL address loaded in the background for tracking purposes. In v4 and earlier, this field represents the tracking URL specified by the user manually. This can be found at userSpecifiedTrackingUrl in v5.
       "video": { # Details of a YouTube video. # Required. Immutable. The YouTube video of the ad.
         "id": "A String", # Output only. The YouTube video ID which can be searched on YouTube webpage.
         "unavailableReason": "A String", # Output only. The reason why the video data is not available.
@@ -1087,7 +1087,7 @@ 
Method Details

     },
   },
   "videoPerformanceAd": { # Details for a video performance ad. # Optional. Details of an [ad used in a video action campaign](//support.google.com/google-ads/answer/10147229) to drive actions to the business, service or product.
-    "actionButtonLabels": [ # Optional. The list of text assets shown on the call-to-action button.
+    "actionButtonLabels": [ # Optional. The list of text assets shown on the call-to-action button. Must be set if headlines is set.
       "A String",
     ],
     "companionBanners": [ # Optional. The list of companion banners used by this ad.
@@ -1104,20 +1104,20 @@ 
Method Details

     "customParameters": { # Optional. The custom parameters and accompanying values to add to the tracking URL.
       "a_key": "A String",
     },
-    "descriptions": [ # Optional. The list of descriptions shown on the call-to-action banner.
+    "descriptions": [ # Optional. The list of descriptions shown on the call-to-action banner. Must be set unless the parent line item's lineItemType is `LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_NON_SKIPPABLE`, in which case this field cannot be set.
       "A String",
     ],
     "displayUrlBreadcrumb1": "A String", # Optional. The first piece after the domain in the display URL.
-    "displayUrlBreadcrumb2": "A String", # Optional. The second piece after the domain in the display URL.
+    "displayUrlBreadcrumb2": "A String", # Optional. The second piece after the domain in the display URL. Can only be set if displayUrlBreadcrumb1 is also set.
     "domain": "A String", # Output only. The domain of the display URL.
     "finalUrl": "A String", # Required. The URL address of the webpage that people reach after they click the ad.
     "headlines": [ # Optional. The list of headlines shown on the call-to-action banner.
       "A String",
     ],
-    "longHeadlines": [ # Optional. The list of long headlines shown on the call-to-action banner.
+    "longHeadlines": [ # Optional. The list of long headlines shown on the call-to-action banner. Must be set unless the parent line item's lineItemType is `LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_NON_SKIPPABLE`, in which case this field cannot be set.
       "A String",
     ],
-    "trackingUrl": "A String", # Output only. The URL address loaded in the background for tracking purposes.
+    "trackingUrl": "A String", # Output only. The URL address loaded in the background for tracking purposes. In v4 and earlier, this field represents the tracking URL specified by the user manually. This can be found at userSpecifiedTrackingUrl in v5.
     "videos": [ # Required. The list of YouTube video assets used by this ad.
       { # Details of a YouTube video.
         "id": "A String", # Output only. The YouTube video ID which can be searched on YouTube webpage.
@@ -1131,11 +1131,11 @@ 
Method Details

 
 

     delete(advertiserId, adGroupAdId, x__xgafv=None)
-  
Deletes an ad group ad. This method is only supported for Demand Gen ads.
+  
Deletes an ad group ad.
 
 Args:
   advertiserId: string, Required. The ID of the advertiser the ad belongs to. (required)
-  adGroupAdId: string, Required. The ID of the ad to delete. Only Demand Gen ads are supported. (required)
+  adGroupAdId: string, Required. The ID of the ad to delete. (required)
   x__xgafv: string, V1 error format.
     Allowed values
       1 - v1 error format
@@ -1163,7 +1163,7 @@ 
Method Details

 Returns:
   An object of the form:
 
-    { # LINT: LEGACY_NAMES A single ad associated with an ad group.
+    { # A single ad associated with an ad group.
   "adGroupAdId": "A String", # Output only. The unique ID of the ad. Assigned by the system.
   "adGroupId": "A String", # Required. Immutable. The unique ID of the ad group that the ad belongs to.
   "adPolicy": { # A single ad policy associated with an ad group ad. # Output only. The policy approval status of the ad.
@@ -1309,7 +1309,7 @@ 
Method Details

   "audioAd": { # Details for an audio ad. # Output only. Details of an [audio ad](//support.google.com/displayvideo/answer/6274216) used for reach marketing objectives.
     "displayUrl": "A String", # The webpage address that appears with the ad.
     "finalUrl": "A String", # The URL address of the webpage that people reach after they click the ad.
-    "trackingUrl": "A String", # The URL address loaded in the background for tracking purposes.
+    "trackingUrl": "A String", # The URL address loaded in the background for tracking purposes. In v4 and earlier, this field represents the tracking URL specified by the user manually. This can be found at userSpecifiedTrackingUrl in v5.
     "video": { # Details of a YouTube video. # The YouTube video of the ad.
       "id": "A String", # Output only. The YouTube video ID which can be searched on YouTube webpage.
       "unavailableReason": "A String", # Output only. The reason why the video data is not available.
@@ -1318,7 +1318,7 @@ 
Method Details

   },
   "bumperAd": { # Details for a bumper ad. # Optional. Details of a [non-skippable short video ad](//support.google.com/displayvideo/answer/6274216), equal to or less than 6 seconds, used for reach.
     "commonInStreamAttribute": { # Common attributes for in-stream, non-skippable and bumper ads. # Required. Common ad attributes.
-      "actionButtonLabel": "A String", # Optional. The text on the call-to-action button.
+      "actionButtonLabel": "A String", # Optional. The text on the call-to-action button. Must be set if actionHeadline is set.
       "actionHeadline": "A String", # Optional. The headline of the call-to-action banner.
       "companionBanner": { # Meta data of an image asset. # Optional. The image which shows next to the video ad.
         "assetId": "A String", # Required. The unique ID of the asset.
@@ -1331,7 +1331,7 @@ 
Method Details

       },
       "displayUrl": "A String", # Required. The webpage address that appears with the ad.
       "finalUrl": "A String", # Required. The URL address of the webpage that people reach after they click the ad.
-      "trackingUrl": "A String", # Output only. The URL address loaded in the background for tracking purposes.
+      "trackingUrl": "A String", # Output only. The URL address loaded in the background for tracking purposes. In v4 and earlier, this field represents the tracking URL specified by the user manually. This can be found at userSpecifiedTrackingUrl in v5.
       "video": { # Details of a YouTube video. # Required. Immutable. The YouTube video of the ad.
         "id": "A String", # Output only. The YouTube video ID which can be searched on YouTube webpage.
         "unavailableReason": "A String", # Output only. The reason why the video data is not available.
@@ -1339,7 +1339,7 @@ 
Method Details

       },
     },
   },
-  "dcmTrackingInfo": { # Details on the DCM tracking. # Optional. The DCM tracking ad info. Only valid for Demand Gen ads. To remove the DCM tracking ad info, please leave this field empty.
+  "dcmTrackingInfo": { # Details on the DCM tracking. # Optional. The DCM tracking ad info. To remove the DCM tracking ad info, please leave this field empty.
     "creativeId": "A String", # Required. The DCM creative id.
     "placementId": "A String", # Required. The DCM placement id.
     "trackingAdId": "A String", # Required. The DCM tracking ad id.
@@ -1541,7 +1541,7 @@ 
Method Details

   "entityStatus": "A String", # Required. The entity status of the ad.
   "inStreamAd": { # Details for an in-stream ad. # Optional. Details of an [in-stream ad skippable after 5 seconds](//support.google.com/displayvideo/answer/6274216), used for brand awareness or reach marketing objectives.
     "commonInStreamAttribute": { # Common attributes for in-stream, non-skippable and bumper ads. # Required. Common ad attributes.
-      "actionButtonLabel": "A String", # Optional. The text on the call-to-action button.
+      "actionButtonLabel": "A String", # Optional. The text on the call-to-action button. Must be set if actionHeadline is set.
       "actionHeadline": "A String", # Optional. The headline of the call-to-action banner.
       "companionBanner": { # Meta data of an image asset. # Optional. The image which shows next to the video ad.
         "assetId": "A String", # Required. The unique ID of the asset.
@@ -1554,7 +1554,7 @@ 
Method Details

       },
       "displayUrl": "A String", # Required. The webpage address that appears with the ad.
       "finalUrl": "A String", # Required. The URL address of the webpage that people reach after they click the ad.
-      "trackingUrl": "A String", # Output only. The URL address loaded in the background for tracking purposes.
+      "trackingUrl": "A String", # Output only. The URL address loaded in the background for tracking purposes. In v4 and earlier, this field represents the tracking URL specified by the user manually. This can be found at userSpecifiedTrackingUrl in v5.
       "video": { # Details of a YouTube video. # Required. Immutable. The YouTube video of the ad.
         "id": "A String", # Output only. The YouTube video ID which can be searched on YouTube webpage.
         "unavailableReason": "A String", # Output only. The reason why the video data is not available.
@@ -1591,7 +1591,7 @@ 
Method Details

   "name": "A String", # Output only. The resource name of the ad.
   "nonSkippableAd": { # Details for a non-skippable ad. # Optional. Details of a [non-skippable short in-stream video ad](//support.google.com/displayvideo/answer/6274216), between 6 and 15 seconds, used for reach marketing objectives.
     "commonInStreamAttribute": { # Common attributes for in-stream, non-skippable and bumper ads. # Required. Common ad attributes.
-      "actionButtonLabel": "A String", # Optional. The text on the call-to-action button.
+      "actionButtonLabel": "A String", # Optional. The text on the call-to-action button. Must be set if actionHeadline is set.
       "actionHeadline": "A String", # Optional. The headline of the call-to-action banner.
       "companionBanner": { # Meta data of an image asset. # Optional. The image which shows next to the video ad.
         "assetId": "A String", # Required. The unique ID of the asset.
@@ -1604,7 +1604,7 @@ 
Method Details

       },
       "displayUrl": "A String", # Required. The webpage address that appears with the ad.
       "finalUrl": "A String", # Required. The URL address of the webpage that people reach after they click the ad.
-      "trackingUrl": "A String", # Output only. The URL address loaded in the background for tracking purposes.
+      "trackingUrl": "A String", # Output only. The URL address loaded in the background for tracking purposes. In v4 and earlier, this field represents the tracking URL specified by the user manually. This can be found at userSpecifiedTrackingUrl in v5.
       "video": { # Details of a YouTube video. # Required. Immutable. The YouTube video of the ad.
         "id": "A String", # Output only. The YouTube video ID which can be searched on YouTube webpage.
         "unavailableReason": "A String", # Output only. The reason why the video data is not available.
@@ -1627,7 +1627,7 @@ 
Method Details

     },
   },
   "videoPerformanceAd": { # Details for a video performance ad. # Optional. Details of an [ad used in a video action campaign](//support.google.com/google-ads/answer/10147229) to drive actions to the business, service or product.
-    "actionButtonLabels": [ # Optional. The list of text assets shown on the call-to-action button.
+    "actionButtonLabels": [ # Optional. The list of text assets shown on the call-to-action button. Must be set if headlines is set.
       "A String",
     ],
     "companionBanners": [ # Optional. The list of companion banners used by this ad.
@@ -1644,20 +1644,20 @@ 
Method Details

     "customParameters": { # Optional. The custom parameters and accompanying values to add to the tracking URL.
       "a_key": "A String",
     },
-    "descriptions": [ # Optional. The list of descriptions shown on the call-to-action banner.
+    "descriptions": [ # Optional. The list of descriptions shown on the call-to-action banner. Must be set unless the parent line item's lineItemType is `LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_NON_SKIPPABLE`, in which case this field cannot be set.
       "A String",
     ],
     "displayUrlBreadcrumb1": "A String", # Optional. The first piece after the domain in the display URL.
-    "displayUrlBreadcrumb2": "A String", # Optional. The second piece after the domain in the display URL.
+    "displayUrlBreadcrumb2": "A String", # Optional. The second piece after the domain in the display URL. Can only be set if displayUrlBreadcrumb1 is also set.
     "domain": "A String", # Output only. The domain of the display URL.
     "finalUrl": "A String", # Required. The URL address of the webpage that people reach after they click the ad.
     "headlines": [ # Optional. The list of headlines shown on the call-to-action banner.
       "A String",
     ],
-    "longHeadlines": [ # Optional. The list of long headlines shown on the call-to-action banner.
+    "longHeadlines": [ # Optional. The list of long headlines shown on the call-to-action banner. Must be set unless the parent line item's lineItemType is `LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_NON_SKIPPABLE`, in which case this field cannot be set.
       "A String",
     ],
-    "trackingUrl": "A String", # Output only. The URL address loaded in the background for tracking purposes.
+    "trackingUrl": "A String", # Output only. The URL address loaded in the background for tracking purposes. In v4 and earlier, this field represents the tracking URL specified by the user manually. This can be found at userSpecifiedTrackingUrl in v5.
     "videos": [ # Required. The list of YouTube video assets used by this ad.
       { # Details of a YouTube video.
         "id": "A String", # Output only. The YouTube video ID which can be searched on YouTube webpage.
@@ -1689,7 +1689,7 @@ 
Method Details

 
     {
   "adGroupAds": [ # The list of ads. This list will be absent if empty.
-    { # LINT: LEGACY_NAMES A single ad associated with an ad group.
+    { # A single ad associated with an ad group.
       "adGroupAdId": "A String", # Output only. The unique ID of the ad. Assigned by the system.
       "adGroupId": "A String", # Required. Immutable. The unique ID of the ad group that the ad belongs to.
       "adPolicy": { # A single ad policy associated with an ad group ad. # Output only. The policy approval status of the ad.
@@ -1835,7 +1835,7 @@ 
Method Details

       "audioAd": { # Details for an audio ad. # Output only. Details of an [audio ad](//support.google.com/displayvideo/answer/6274216) used for reach marketing objectives.
         "displayUrl": "A String", # The webpage address that appears with the ad.
         "finalUrl": "A String", # The URL address of the webpage that people reach after they click the ad.
-        "trackingUrl": "A String", # The URL address loaded in the background for tracking purposes.
+        "trackingUrl": "A String", # The URL address loaded in the background for tracking purposes. In v4 and earlier, this field represents the tracking URL specified by the user manually. This can be found at userSpecifiedTrackingUrl in v5.
         "video": { # Details of a YouTube video. # The YouTube video of the ad.
           "id": "A String", # Output only. The YouTube video ID which can be searched on YouTube webpage.
           "unavailableReason": "A String", # Output only. The reason why the video data is not available.
@@ -1844,7 +1844,7 @@ 
Method Details

       },
       "bumperAd": { # Details for a bumper ad. # Optional. Details of a [non-skippable short video ad](//support.google.com/displayvideo/answer/6274216), equal to or less than 6 seconds, used for reach.
         "commonInStreamAttribute": { # Common attributes for in-stream, non-skippable and bumper ads. # Required. Common ad attributes.
-          "actionButtonLabel": "A String", # Optional. The text on the call-to-action button.
+          "actionButtonLabel": "A String", # Optional. The text on the call-to-action button. Must be set if actionHeadline is set.
           "actionHeadline": "A String", # Optional. The headline of the call-to-action banner.
           "companionBanner": { # Meta data of an image asset. # Optional. The image which shows next to the video ad.
             "assetId": "A String", # Required. The unique ID of the asset.
@@ -1857,7 +1857,7 @@ 
Method Details

           },
           "displayUrl": "A String", # Required. The webpage address that appears with the ad.
           "finalUrl": "A String", # Required. The URL address of the webpage that people reach after they click the ad.
-          "trackingUrl": "A String", # Output only. The URL address loaded in the background for tracking purposes.
+          "trackingUrl": "A String", # Output only. The URL address loaded in the background for tracking purposes. In v4 and earlier, this field represents the tracking URL specified by the user manually. This can be found at userSpecifiedTrackingUrl in v5.
           "video": { # Details of a YouTube video. # Required. Immutable. The YouTube video of the ad.
             "id": "A String", # Output only. The YouTube video ID which can be searched on YouTube webpage.
             "unavailableReason": "A String", # Output only. The reason why the video data is not available.
@@ -1865,7 +1865,7 @@ 
Method Details

           },
         },
       },
-      "dcmTrackingInfo": { # Details on the DCM tracking. # Optional. The DCM tracking ad info. Only valid for Demand Gen ads. To remove the DCM tracking ad info, please leave this field empty.
+      "dcmTrackingInfo": { # Details on the DCM tracking. # Optional. The DCM tracking ad info. To remove the DCM tracking ad info, please leave this field empty.
         "creativeId": "A String", # Required. The DCM creative id.
         "placementId": "A String", # Required. The DCM placement id.
         "trackingAdId": "A String", # Required. The DCM tracking ad id.
@@ -2067,7 +2067,7 @@ 
Method Details

       "entityStatus": "A String", # Required. The entity status of the ad.
       "inStreamAd": { # Details for an in-stream ad. # Optional. Details of an [in-stream ad skippable after 5 seconds](//support.google.com/displayvideo/answer/6274216), used for brand awareness or reach marketing objectives.
         "commonInStreamAttribute": { # Common attributes for in-stream, non-skippable and bumper ads. # Required. Common ad attributes.
-          "actionButtonLabel": "A String", # Optional. The text on the call-to-action button.
+          "actionButtonLabel": "A String", # Optional. The text on the call-to-action button. Must be set if actionHeadline is set.
           "actionHeadline": "A String", # Optional. The headline of the call-to-action banner.
           "companionBanner": { # Meta data of an image asset. # Optional. The image which shows next to the video ad.
             "assetId": "A String", # Required. The unique ID of the asset.
@@ -2080,7 +2080,7 @@ 
Method Details

           },
           "displayUrl": "A String", # Required. The webpage address that appears with the ad.
           "finalUrl": "A String", # Required. The URL address of the webpage that people reach after they click the ad.
-          "trackingUrl": "A String", # Output only. The URL address loaded in the background for tracking purposes.
+          "trackingUrl": "A String", # Output only. The URL address loaded in the background for tracking purposes. In v4 and earlier, this field represents the tracking URL specified by the user manually. This can be found at userSpecifiedTrackingUrl in v5.
           "video": { # Details of a YouTube video. # Required. Immutable. The YouTube video of the ad.
             "id": "A String", # Output only. The YouTube video ID which can be searched on YouTube webpage.
             "unavailableReason": "A String", # Output only. The reason why the video data is not available.
@@ -2117,7 +2117,7 @@ 
Method Details

       "name": "A String", # Output only. The resource name of the ad.
       "nonSkippableAd": { # Details for a non-skippable ad. # Optional. Details of a [non-skippable short in-stream video ad](//support.google.com/displayvideo/answer/6274216), between 6 and 15 seconds, used for reach marketing objectives.
         "commonInStreamAttribute": { # Common attributes for in-stream, non-skippable and bumper ads. # Required. Common ad attributes.
-          "actionButtonLabel": "A String", # Optional. The text on the call-to-action button.
+          "actionButtonLabel": "A String", # Optional. The text on the call-to-action button. Must be set if actionHeadline is set.
           "actionHeadline": "A String", # Optional. The headline of the call-to-action banner.
           "companionBanner": { # Meta data of an image asset. # Optional. The image which shows next to the video ad.
             "assetId": "A String", # Required. The unique ID of the asset.
@@ -2130,7 +2130,7 @@ 
Method Details

           },
           "displayUrl": "A String", # Required. The webpage address that appears with the ad.
           "finalUrl": "A String", # Required. The URL address of the webpage that people reach after they click the ad.
-          "trackingUrl": "A String", # Output only. The URL address loaded in the background for tracking purposes.
+          "trackingUrl": "A String", # Output only. The URL address loaded in the background for tracking purposes. In v4 and earlier, this field represents the tracking URL specified by the user manually. This can be found at userSpecifiedTrackingUrl in v5.
           "video": { # Details of a YouTube video. # Required. Immutable. The YouTube video of the ad.
             "id": "A String", # Output only. The YouTube video ID which can be searched on YouTube webpage.
             "unavailableReason": "A String", # Output only. The reason why the video data is not available.
@@ -2153,7 +2153,7 @@ 
Method Details

         },
       },
       "videoPerformanceAd": { # Details for a video performance ad. # Optional. Details of an [ad used in a video action campaign](//support.google.com/google-ads/answer/10147229) to drive actions to the business, service or product.
-        "actionButtonLabels": [ # Optional. The list of text assets shown on the call-to-action button.
+        "actionButtonLabels": [ # Optional. The list of text assets shown on the call-to-action button. Must be set if headlines is set.
           "A String",
         ],
         "companionBanners": [ # Optional. The list of companion banners used by this ad.
@@ -2170,20 +2170,20 @@ 
Method Details

         "customParameters": { # Optional. The custom parameters and accompanying values to add to the tracking URL.
           "a_key": "A String",
         },
-        "descriptions": [ # Optional. The list of descriptions shown on the call-to-action banner.
+        "descriptions": [ # Optional. The list of descriptions shown on the call-to-action banner. Must be set unless the parent line item's lineItemType is `LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_NON_SKIPPABLE`, in which case this field cannot be set.
           "A String",
         ],
         "displayUrlBreadcrumb1": "A String", # Optional. The first piece after the domain in the display URL.
-        "displayUrlBreadcrumb2": "A String", # Optional. The second piece after the domain in the display URL.
+        "displayUrlBreadcrumb2": "A String", # Optional. The second piece after the domain in the display URL. Can only be set if displayUrlBreadcrumb1 is also set.
         "domain": "A String", # Output only. The domain of the display URL.
         "finalUrl": "A String", # Required. The URL address of the webpage that people reach after they click the ad.
         "headlines": [ # Optional. The list of headlines shown on the call-to-action banner.
           "A String",
         ],
-        "longHeadlines": [ # Optional. The list of long headlines shown on the call-to-action banner.
+        "longHeadlines": [ # Optional. The list of long headlines shown on the call-to-action banner. Must be set unless the parent line item's lineItemType is `LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_NON_SKIPPABLE`, in which case this field cannot be set.
           "A String",
         ],
-        "trackingUrl": "A String", # Output only. The URL address loaded in the background for tracking purposes.
+        "trackingUrl": "A String", # Output only. The URL address loaded in the background for tracking purposes. In v4 and earlier, this field represents the tracking URL specified by the user manually. This can be found at userSpecifiedTrackingUrl in v5.
         "videos": [ # Required. The list of YouTube video assets used by this ad.
           { # Details of a YouTube video.
             "id": "A String", # Output only. The YouTube video ID which can be searched on YouTube webpage.
@@ -2214,7 +2214,7 @@ 
Method Details

 
 

     patch(advertiserId, adGroupAdId, body=None, updateMask=None, x__xgafv=None)
-  
Updates an ad group ad. This method is only supported for Demand Gen ads.
+  
Updates an ad group ad.
 
 Args:
   advertiserId: string, Output only. The unique ID of the advertiser the ad belongs to. (required)
@@ -2222,7 +2222,7 @@ 
Method Details

   body: object, The request body.
     The object takes the form of:
 
-{ # LINT: LEGACY_NAMES A single ad associated with an ad group.
+{ # A single ad associated with an ad group.
   "adGroupAdId": "A String", # Output only. The unique ID of the ad. Assigned by the system.
   "adGroupId": "A String", # Required. Immutable. The unique ID of the ad group that the ad belongs to.
   "adPolicy": { # A single ad policy associated with an ad group ad. # Output only. The policy approval status of the ad.
@@ -2368,7 +2368,7 @@ 
Method Details

   "audioAd": { # Details for an audio ad. # Output only. Details of an [audio ad](//support.google.com/displayvideo/answer/6274216) used for reach marketing objectives.
     "displayUrl": "A String", # The webpage address that appears with the ad.
     "finalUrl": "A String", # The URL address of the webpage that people reach after they click the ad.
-    "trackingUrl": "A String", # The URL address loaded in the background for tracking purposes.
+    "trackingUrl": "A String", # The URL address loaded in the background for tracking purposes. In v4 and earlier, this field represents the tracking URL specified by the user manually. This can be found at userSpecifiedTrackingUrl in v5.
     "video": { # Details of a YouTube video. # The YouTube video of the ad.
       "id": "A String", # Output only. The YouTube video ID which can be searched on YouTube webpage.
       "unavailableReason": "A String", # Output only. The reason why the video data is not available.
@@ -2377,7 +2377,7 @@ 
Method Details

   },
   "bumperAd": { # Details for a bumper ad. # Optional. Details of a [non-skippable short video ad](//support.google.com/displayvideo/answer/6274216), equal to or less than 6 seconds, used for reach.
     "commonInStreamAttribute": { # Common attributes for in-stream, non-skippable and bumper ads. # Required. Common ad attributes.
-      "actionButtonLabel": "A String", # Optional. The text on the call-to-action button.
+      "actionButtonLabel": "A String", # Optional. The text on the call-to-action button. Must be set if actionHeadline is set.
       "actionHeadline": "A String", # Optional. The headline of the call-to-action banner.
       "companionBanner": { # Meta data of an image asset. # Optional. The image which shows next to the video ad.
         "assetId": "A String", # Required. The unique ID of the asset.
@@ -2390,7 +2390,7 @@ 
Method Details

       },
       "displayUrl": "A String", # Required. The webpage address that appears with the ad.
       "finalUrl": "A String", # Required. The URL address of the webpage that people reach after they click the ad.
-      "trackingUrl": "A String", # Output only. The URL address loaded in the background for tracking purposes.
+      "trackingUrl": "A String", # Output only. The URL address loaded in the background for tracking purposes. In v4 and earlier, this field represents the tracking URL specified by the user manually. This can be found at userSpecifiedTrackingUrl in v5.
       "video": { # Details of a YouTube video. # Required. Immutable. The YouTube video of the ad.
         "id": "A String", # Output only. The YouTube video ID which can be searched on YouTube webpage.
         "unavailableReason": "A String", # Output only. The reason why the video data is not available.
@@ -2398,7 +2398,7 @@ 
Method Details

       },
     },
   },
-  "dcmTrackingInfo": { # Details on the DCM tracking. # Optional. The DCM tracking ad info. Only valid for Demand Gen ads. To remove the DCM tracking ad info, please leave this field empty.
+  "dcmTrackingInfo": { # Details on the DCM tracking. # Optional. The DCM tracking ad info. To remove the DCM tracking ad info, please leave this field empty.
     "creativeId": "A String", # Required. The DCM creative id.
     "placementId": "A String", # Required. The DCM placement id.
     "trackingAdId": "A String", # Required. The DCM tracking ad id.
@@ -2600,7 +2600,7 @@ 
Method Details

   "entityStatus": "A String", # Required. The entity status of the ad.
   "inStreamAd": { # Details for an in-stream ad. # Optional. Details of an [in-stream ad skippable after 5 seconds](//support.google.com/displayvideo/answer/6274216), used for brand awareness or reach marketing objectives.
     "commonInStreamAttribute": { # Common attributes for in-stream, non-skippable and bumper ads. # Required. Common ad attributes.
-      "actionButtonLabel": "A String", # Optional. The text on the call-to-action button.
+      "actionButtonLabel": "A String", # Optional. The text on the call-to-action button. Must be set if actionHeadline is set.
       "actionHeadline": "A String", # Optional. The headline of the call-to-action banner.
       "companionBanner": { # Meta data of an image asset. # Optional. The image which shows next to the video ad.
         "assetId": "A String", # Required. The unique ID of the asset.
@@ -2613,7 +2613,7 @@ 
Method Details

       },
       "displayUrl": "A String", # Required. The webpage address that appears with the ad.
       "finalUrl": "A String", # Required. The URL address of the webpage that people reach after they click the ad.
-      "trackingUrl": "A String", # Output only. The URL address loaded in the background for tracking purposes.
+      "trackingUrl": "A String", # Output only. The URL address loaded in the background for tracking purposes. In v4 and earlier, this field represents the tracking URL specified by the user manually. This can be found at userSpecifiedTrackingUrl in v5.
       "video": { # Details of a YouTube video. # Required. Immutable. The YouTube video of the ad.
         "id": "A String", # Output only. The YouTube video ID which can be searched on YouTube webpage.
         "unavailableReason": "A String", # Output only. The reason why the video data is not available.
@@ -2650,7 +2650,7 @@ 
Method Details

   "name": "A String", # Output only. The resource name of the ad.
   "nonSkippableAd": { # Details for a non-skippable ad. # Optional. Details of a [non-skippable short in-stream video ad](//support.google.com/displayvideo/answer/6274216), between 6 and 15 seconds, used for reach marketing objectives.
     "commonInStreamAttribute": { # Common attributes for in-stream, non-skippable and bumper ads. # Required. Common ad attributes.
-      "actionButtonLabel": "A String", # Optional. The text on the call-to-action button.
+      "actionButtonLabel": "A String", # Optional. The text on the call-to-action button. Must be set if actionHeadline is set.
       "actionHeadline": "A String", # Optional. The headline of the call-to-action banner.
       "companionBanner": { # Meta data of an image asset. # Optional. The image which shows next to the video ad.
         "assetId": "A String", # Required. The unique ID of the asset.
@@ -2663,7 +2663,7 @@ 
Method Details

       },
       "displayUrl": "A String", # Required. The webpage address that appears with the ad.
       "finalUrl": "A String", # Required. The URL address of the webpage that people reach after they click the ad.
-      "trackingUrl": "A String", # Output only. The URL address loaded in the background for tracking purposes.
+      "trackingUrl": "A String", # Output only. The URL address loaded in the background for tracking purposes. In v4 and earlier, this field represents the tracking URL specified by the user manually. This can be found at userSpecifiedTrackingUrl in v5.
       "video": { # Details of a YouTube video. # Required. Immutable. The YouTube video of the ad.
         "id": "A String", # Output only. The YouTube video ID which can be searched on YouTube webpage.
         "unavailableReason": "A String", # Output only. The reason why the video data is not available.
@@ -2686,7 +2686,7 @@ 
Method Details

     },
   },
   "videoPerformanceAd": { # Details for a video performance ad. # Optional. Details of an [ad used in a video action campaign](//support.google.com/google-ads/answer/10147229) to drive actions to the business, service or product.
-    "actionButtonLabels": [ # Optional. The list of text assets shown on the call-to-action button.
+    "actionButtonLabels": [ # Optional. The list of text assets shown on the call-to-action button. Must be set if headlines is set.
       "A String",
     ],
     "companionBanners": [ # Optional. The list of companion banners used by this ad.
@@ -2703,20 +2703,20 @@ 
Method Details

     "customParameters": { # Optional. The custom parameters and accompanying values to add to the tracking URL.
       "a_key": "A String",
     },
-    "descriptions": [ # Optional. The list of descriptions shown on the call-to-action banner.
+    "descriptions": [ # Optional. The list of descriptions shown on the call-to-action banner. Must be set unless the parent line item's lineItemType is `LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_NON_SKIPPABLE`, in which case this field cannot be set.
       "A String",
     ],
     "displayUrlBreadcrumb1": "A String", # Optional. The first piece after the domain in the display URL.
-    "displayUrlBreadcrumb2": "A String", # Optional. The second piece after the domain in the display URL.
+    "displayUrlBreadcrumb2": "A String", # Optional. The second piece after the domain in the display URL. Can only be set if displayUrlBreadcrumb1 is also set.
     "domain": "A String", # Output only. The domain of the display URL.
     "finalUrl": "A String", # Required. The URL address of the webpage that people reach after they click the ad.
     "headlines": [ # Optional. The list of headlines shown on the call-to-action banner.
       "A String",
     ],
-    "longHeadlines": [ # Optional. The list of long headlines shown on the call-to-action banner.
+    "longHeadlines": [ # Optional. The list of long headlines shown on the call-to-action banner. Must be set unless the parent line item's lineItemType is `LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_NON_SKIPPABLE`, in which case this field cannot be set.
       "A String",
     ],
-    "trackingUrl": "A String", # Output only. The URL address loaded in the background for tracking purposes.
+    "trackingUrl": "A String", # Output only. The URL address loaded in the background for tracking purposes. In v4 and earlier, this field represents the tracking URL specified by the user manually. This can be found at userSpecifiedTrackingUrl in v5.
     "videos": [ # Required. The list of YouTube video assets used by this ad.
       { # Details of a YouTube video.
         "id": "A String", # Output only. The YouTube video ID which can be searched on YouTube webpage.
@@ -2736,7 +2736,7 @@ 
Method Details

 Returns:
   An object of the form:
 
-    { # LINT: LEGACY_NAMES A single ad associated with an ad group.
+    { # A single ad associated with an ad group.
   "adGroupAdId": "A String", # Output only. The unique ID of the ad. Assigned by the system.
   "adGroupId": "A String", # Required. Immutable. The unique ID of the ad group that the ad belongs to.
   "adPolicy": { # A single ad policy associated with an ad group ad. # Output only. The policy approval status of the ad.
@@ -2882,7 +2882,7 @@ 
Method Details

   "audioAd": { # Details for an audio ad. # Output only. Details of an [audio ad](//support.google.com/displayvideo/answer/6274216) used for reach marketing objectives.
     "displayUrl": "A String", # The webpage address that appears with the ad.
     "finalUrl": "A String", # The URL address of the webpage that people reach after they click the ad.
-    "trackingUrl": "A String", # The URL address loaded in the background for tracking purposes.
+    "trackingUrl": "A String", # The URL address loaded in the background for tracking purposes. In v4 and earlier, this field represents the tracking URL specified by the user manually. This can be found at userSpecifiedTrackingUrl in v5.
     "video": { # Details of a YouTube video. # The YouTube video of the ad.
       "id": "A String", # Output only. The YouTube video ID which can be searched on YouTube webpage.
       "unavailableReason": "A String", # Output only. The reason why the video data is not available.
@@ -2891,7 +2891,7 @@ 
Method Details

   },
   "bumperAd": { # Details for a bumper ad. # Optional. Details of a [non-skippable short video ad](//support.google.com/displayvideo/answer/6274216), equal to or less than 6 seconds, used for reach.
     "commonInStreamAttribute": { # Common attributes for in-stream, non-skippable and bumper ads. # Required. Common ad attributes.
-      "actionButtonLabel": "A String", # Optional. The text on the call-to-action button.
+      "actionButtonLabel": "A String", # Optional. The text on the call-to-action button. Must be set if actionHeadline is set.
       "actionHeadline": "A String", # Optional. The headline of the call-to-action banner.
       "companionBanner": { # Meta data of an image asset. # Optional. The image which shows next to the video ad.
         "assetId": "A String", # Required. The unique ID of the asset.
@@ -2904,7 +2904,7 @@ 
Method Details

       },
       "displayUrl": "A String", # Required. The webpage address that appears with the ad.
       "finalUrl": "A String", # Required. The URL address of the webpage that people reach after they click the ad.
-      "trackingUrl": "A String", # Output only. The URL address loaded in the background for tracking purposes.
+      "trackingUrl": "A String", # Output only. The URL address loaded in the background for tracking purposes. In v4 and earlier, this field represents the tracking URL specified by the user manually. This can be found at userSpecifiedTrackingUrl in v5.
       "video": { # Details of a YouTube video. # Required. Immutable. The YouTube video of the ad.
         "id": "A String", # Output only. The YouTube video ID which can be searched on YouTube webpage.
         "unavailableReason": "A String", # Output only. The reason why the video data is not available.
@@ -2912,7 +2912,7 @@ 
Method Details

       },
     },
   },
-  "dcmTrackingInfo": { # Details on the DCM tracking. # Optional. The DCM tracking ad info. Only valid for Demand Gen ads. To remove the DCM tracking ad info, please leave this field empty.
+  "dcmTrackingInfo": { # Details on the DCM tracking. # Optional. The DCM tracking ad info. To remove the DCM tracking ad info, please leave this field empty.
     "creativeId": "A String", # Required. The DCM creative id.
     "placementId": "A String", # Required. The DCM placement id.
     "trackingAdId": "A String", # Required. The DCM tracking ad id.
@@ -3114,7 +3114,7 @@ 
Method Details

   "entityStatus": "A String", # Required. The entity status of the ad.
   "inStreamAd": { # Details for an in-stream ad. # Optional. Details of an [in-stream ad skippable after 5 seconds](//support.google.com/displayvideo/answer/6274216), used for brand awareness or reach marketing objectives.
     "commonInStreamAttribute": { # Common attributes for in-stream, non-skippable and bumper ads. # Required. Common ad attributes.
-      "actionButtonLabel": "A String", # Optional. The text on the call-to-action button.
+      "actionButtonLabel": "A String", # Optional. The text on the call-to-action button. Must be set if actionHeadline is set.
       "actionHeadline": "A String", # Optional. The headline of the call-to-action banner.
       "companionBanner": { # Meta data of an image asset. # Optional. The image which shows next to the video ad.
         "assetId": "A String", # Required. The unique ID of the asset.
@@ -3127,7 +3127,7 @@ 
Method Details

       },
       "displayUrl": "A String", # Required. The webpage address that appears with the ad.
       "finalUrl": "A String", # Required. The URL address of the webpage that people reach after they click the ad.
-      "trackingUrl": "A String", # Output only. The URL address loaded in the background for tracking purposes.
+      "trackingUrl": "A String", # Output only. The URL address loaded in the background for tracking purposes. In v4 and earlier, this field represents the tracking URL specified by the user manually. This can be found at userSpecifiedTrackingUrl in v5.
       "video": { # Details of a YouTube video. # Required. Immutable. The YouTube video of the ad.
         "id": "A String", # Output only. The YouTube video ID which can be searched on YouTube webpage.
         "unavailableReason": "A String", # Output only. The reason why the video data is not available.
@@ -3164,7 +3164,7 @@ 
Method Details

   "name": "A String", # Output only. The resource name of the ad.
   "nonSkippableAd": { # Details for a non-skippable ad. # Optional. Details of a [non-skippable short in-stream video ad](//support.google.com/displayvideo/answer/6274216), between 6 and 15 seconds, used for reach marketing objectives.
     "commonInStreamAttribute": { # Common attributes for in-stream, non-skippable and bumper ads. # Required. Common ad attributes.
-      "actionButtonLabel": "A String", # Optional. The text on the call-to-action button.
+      "actionButtonLabel": "A String", # Optional. The text on the call-to-action button. Must be set if actionHeadline is set.
       "actionHeadline": "A String", # Optional. The headline of the call-to-action banner.
       "companionBanner": { # Meta data of an image asset. # Optional. The image which shows next to the video ad.
         "assetId": "A String", # Required. The unique ID of the asset.
@@ -3177,7 +3177,7 @@ 
Method Details

       },
       "displayUrl": "A String", # Required. The webpage address that appears with the ad.
       "finalUrl": "A String", # Required. The URL address of the webpage that people reach after they click the ad.
-      "trackingUrl": "A String", # Output only. The URL address loaded in the background for tracking purposes.
+      "trackingUrl": "A String", # Output only. The URL address loaded in the background for tracking purposes. In v4 and earlier, this field represents the tracking URL specified by the user manually. This can be found at userSpecifiedTrackingUrl in v5.
       "video": { # Details of a YouTube video. # Required. Immutable. The YouTube video of the ad.
         "id": "A String", # Output only. The YouTube video ID which can be searched on YouTube webpage.
         "unavailableReason": "A String", # Output only. The reason why the video data is not available.
@@ -3200,7 +3200,7 @@ 
Method Details

     },
   },
   "videoPerformanceAd": { # Details for a video performance ad. # Optional. Details of an [ad used in a video action campaign](//support.google.com/google-ads/answer/10147229) to drive actions to the business, service or product.
-    "actionButtonLabels": [ # Optional. The list of text assets shown on the call-to-action button.
+    "actionButtonLabels": [ # Optional. The list of text assets shown on the call-to-action button. Must be set if headlines is set.
       "A String",
     ],
     "companionBanners": [ # Optional. The list of companion banners used by this ad.
@@ -3217,20 +3217,20 @@ 
Method Details

     "customParameters": { # Optional. The custom parameters and accompanying values to add to the tracking URL.
       "a_key": "A String",
     },
-    "descriptions": [ # Optional. The list of descriptions shown on the call-to-action banner.
+    "descriptions": [ # Optional. The list of descriptions shown on the call-to-action banner. Must be set unless the parent line item's lineItemType is `LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_NON_SKIPPABLE`, in which case this field cannot be set.
       "A String",
     ],
     "displayUrlBreadcrumb1": "A String", # Optional. The first piece after the domain in the display URL.
-    "displayUrlBreadcrumb2": "A String", # Optional. The second piece after the domain in the display URL.
+    "displayUrlBreadcrumb2": "A String", # Optional. The second piece after the domain in the display URL. Can only be set if displayUrlBreadcrumb1 is also set.
     "domain": "A String", # Output only. The domain of the display URL.
     "finalUrl": "A String", # Required. The URL address of the webpage that people reach after they click the ad.
     "headlines": [ # Optional. The list of headlines shown on the call-to-action banner.
       "A String",
     ],
-    "longHeadlines": [ # Optional. The list of long headlines shown on the call-to-action banner.
+    "longHeadlines": [ # Optional. The list of long headlines shown on the call-to-action banner. Must be set unless the parent line item's lineItemType is `LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_NON_SKIPPABLE`, in which case this field cannot be set.
       "A String",
     ],
-    "trackingUrl": "A String", # Output only. The URL address loaded in the background for tracking purposes.
+    "trackingUrl": "A String", # Output only. The URL address loaded in the background for tracking purposes. In v4 and earlier, this field represents the tracking URL specified by the user manually. This can be found at userSpecifiedTrackingUrl in v5.
     "videos": [ # Required. The list of YouTube video assets used by this ad.
       { # Details of a YouTube video.
         "id": "A String", # Output only. The YouTube video ID which can be searched on YouTube webpage.
diff --git a/docs/dyn/displayvideo_v3.advertisers.adGroups.html b/docs/dyn/displayvideo_v3.advertisers.adGroups.html
index 43d6b86c8d..befc99e766 100644
--- a/docs/dyn/displayvideo_v3.advertisers.adGroups.html
+++ b/docs/dyn/displayvideo_v3.advertisers.adGroups.html
@@ -890,7 +890,7 @@ 
Method Details

   body: object, The request body.
     The object takes the form of:
 
-{ # A single ad group associated with a line item.
+{ # LINT: LEGACY_NAMES A single ad group associated with a line item.
   "adGroupFormat": "A String", # Required. Immutable. The format of the ads in the ad group.
   "adGroupId": "A String", # Output only. The unique ID of the ad group. Assigned by the system.
   "adGroupInventoryControl": { # The inventory control of the ad group. # Optional. Required for Demand Gen ad groups. Specifies the inventory control of the ad group.
@@ -965,7 +965,7 @@ 
Method Details

 Returns:
   An object of the form:
 
-    { # A single ad group associated with a line item.
+    { # LINT: LEGACY_NAMES A single ad group associated with a line item.
   "adGroupFormat": "A String", # Required. Immutable. The format of the ads in the ad group.
   "adGroupId": "A String", # Output only. The unique ID of the ad group. Assigned by the system.
   "adGroupInventoryControl": { # The inventory control of the ad group. # Optional. Required for Demand Gen ad groups. Specifies the inventory control of the ad group.
@@ -1067,7 +1067,7 @@ 
Method Details

 Returns:
   An object of the form:
 
-    { # A single ad group associated with a line item.
+    { # LINT: LEGACY_NAMES A single ad group associated with a line item.
   "adGroupFormat": "A String", # Required. Immutable. The format of the ads in the ad group.
   "adGroupId": "A String", # Output only. The unique ID of the ad group. Assigned by the system.
   "adGroupInventoryControl": { # The inventory control of the ad group. # Optional. Required for Demand Gen ad groups. Specifies the inventory control of the ad group.
@@ -1155,7 +1155,7 @@ 
Method Details

 
     {
   "adGroups": [ # The list of ad groups. This list will be absent if empty.
-    { # A single ad group associated with a line item.
+    { # LINT: LEGACY_NAMES A single ad group associated with a line item.
       "adGroupFormat": "A String", # Required. Immutable. The format of the ads in the ad group.
       "adGroupId": "A String", # Output only. The unique ID of the ad group. Assigned by the system.
       "adGroupInventoryControl": { # The inventory control of the ad group. # Optional. Required for Demand Gen ad groups. Specifies the inventory control of the ad group.
@@ -1250,7 +1250,7 @@ 
Method Details

   body: object, The request body.
     The object takes the form of:
 
-{ # A single ad group associated with a line item.
+{ # LINT: LEGACY_NAMES A single ad group associated with a line item.
   "adGroupFormat": "A String", # Required. Immutable. The format of the ads in the ad group.
   "adGroupId": "A String", # Output only. The unique ID of the ad group. Assigned by the system.
   "adGroupInventoryControl": { # The inventory control of the ad group. # Optional. Required for Demand Gen ad groups. Specifies the inventory control of the ad group.
@@ -1326,7 +1326,7 @@ 
Method Details

 Returns:
   An object of the form:
 
-    { # A single ad group associated with a line item.
+    { # LINT: LEGACY_NAMES A single ad group associated with a line item.
   "adGroupFormat": "A String", # Required. Immutable. The format of the ads in the ad group.
   "adGroupId": "A String", # Output only. The unique ID of the ad group. Assigned by the system.
   "adGroupInventoryControl": { # The inventory control of the ad group. # Optional. Required for Demand Gen ad groups. Specifies the inventory control of the ad group.
diff --git a/docs/dyn/displayvideo_v3.advertisers.adGroups.targetingTypes.assignedTargetingOptions.html b/docs/dyn/displayvideo_v3.advertisers.adGroups.targetingTypes.assignedTargetingOptions.html
index 844e289c24..d0646df6a0 100644
--- a/docs/dyn/displayvideo_v3.advertisers.adGroups.targetingTypes.assignedTargetingOptions.html
+++ b/docs/dyn/displayvideo_v3.advertisers.adGroups.targetingTypes.assignedTargetingOptions.html
@@ -129,7 +129,6 @@ 
Method Details

       TARGETING_TYPE_ON_SCREEN_POSITION - Target ads in a specific on screen position.
       TARGETING_TYPE_THIRD_PARTY_VERIFIER - Filter web sites through third party verification (for example, IAS or DoubleVerify).
       TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION - Filter web sites by specific digital content label ratings (for example, DL-MA: suitable only for mature audiences).
-      TARGETING_TYPE_SENSITIVE_CATEGORY_EXCLUSION - Filter website content by sensitive categories (for example, adult).
       TARGETING_TYPE_ENVIRONMENT - Target ads to a specific environment (for example, web or app).
       TARGETING_TYPE_CARRIER_AND_ISP - Target ads to a specific network carrier or internet service provider (ISP) (for example, Comcast or Orange).
       TARGETING_TYPE_OPERATING_SYSTEM - Target ads to a specific operating system (for example, macOS).
@@ -866,7 +865,6 @@ 
Method Details

       TARGETING_TYPE_ON_SCREEN_POSITION - Target ads in a specific on screen position.
       TARGETING_TYPE_THIRD_PARTY_VERIFIER - Filter web sites through third party verification (for example, IAS or DoubleVerify).
       TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION - Filter web sites by specific digital content label ratings (for example, DL-MA: suitable only for mature audiences).
-      TARGETING_TYPE_SENSITIVE_CATEGORY_EXCLUSION - Filter website content by sensitive categories (for example, adult).
       TARGETING_TYPE_ENVIRONMENT - Target ads to a specific environment (for example, web or app).
       TARGETING_TYPE_CARRIER_AND_ISP - Target ads to a specific network carrier or internet service provider (ISP) (for example, Comcast or Orange).
       TARGETING_TYPE_OPERATING_SYSTEM - Target ads to a specific operating system (for example, macOS).
@@ -938,7 +936,6 @@ 
Method Details

       TARGETING_TYPE_ON_SCREEN_POSITION - Target ads in a specific on screen position.
       TARGETING_TYPE_THIRD_PARTY_VERIFIER - Filter web sites through third party verification (for example, IAS or DoubleVerify).
       TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION - Filter web sites by specific digital content label ratings (for example, DL-MA: suitable only for mature audiences).
-      TARGETING_TYPE_SENSITIVE_CATEGORY_EXCLUSION - Filter website content by sensitive categories (for example, adult).
       TARGETING_TYPE_ENVIRONMENT - Target ads to a specific environment (for example, web or app).
       TARGETING_TYPE_CARRIER_AND_ISP - Target ads to a specific network carrier or internet service provider (ISP) (for example, Comcast or Orange).
       TARGETING_TYPE_OPERATING_SYSTEM - Target ads to a specific operating system (for example, macOS).
@@ -1340,7 +1337,6 @@ 
Method Details

       TARGETING_TYPE_ON_SCREEN_POSITION - Target ads in a specific on screen position.
       TARGETING_TYPE_THIRD_PARTY_VERIFIER - Filter web sites through third party verification (for example, IAS or DoubleVerify).
       TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION - Filter web sites by specific digital content label ratings (for example, DL-MA: suitable only for mature audiences).
-      TARGETING_TYPE_SENSITIVE_CATEGORY_EXCLUSION - Filter website content by sensitive categories (for example, adult).
       TARGETING_TYPE_ENVIRONMENT - Target ads to a specific environment (for example, web or app).
       TARGETING_TYPE_CARRIER_AND_ISP - Target ads to a specific network carrier or internet service provider (ISP) (for example, Comcast or Orange).
       TARGETING_TYPE_OPERATING_SYSTEM - Target ads to a specific operating system (for example, macOS).
diff --git a/docs/dyn/displayvideo_v3.advertisers.lineItems.targetingTypes.assignedTargetingOptions.html b/docs/dyn/displayvideo_v3.advertisers.lineItems.targetingTypes.assignedTargetingOptions.html
index 4bf2df7563..1d61db6264 100644
--- a/docs/dyn/displayvideo_v3.advertisers.lineItems.targetingTypes.assignedTargetingOptions.html
+++ b/docs/dyn/displayvideo_v3.advertisers.lineItems.targetingTypes.assignedTargetingOptions.html
@@ -129,7 +129,6 @@ 
Method Details

       TARGETING_TYPE_ON_SCREEN_POSITION - Target ads in a specific on screen position.
       TARGETING_TYPE_THIRD_PARTY_VERIFIER - Filter web sites through third party verification (for example, IAS or DoubleVerify).
       TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION - Filter web sites by specific digital content label ratings (for example, DL-MA: suitable only for mature audiences).
-      TARGETING_TYPE_SENSITIVE_CATEGORY_EXCLUSION - Filter website content by sensitive categories (for example, adult).
       TARGETING_TYPE_ENVIRONMENT - Target ads to a specific environment (for example, web or app).
       TARGETING_TYPE_CARRIER_AND_ISP - Target ads to a specific network carrier or internet service provider (ISP) (for example, Comcast or Orange).
       TARGETING_TYPE_OPERATING_SYSTEM - Target ads to a specific operating system (for example, macOS).
@@ -866,7 +865,6 @@ 
Method Details

       TARGETING_TYPE_ON_SCREEN_POSITION - Target ads in a specific on screen position.
       TARGETING_TYPE_THIRD_PARTY_VERIFIER - Filter web sites through third party verification (for example, IAS or DoubleVerify).
       TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION - Filter web sites by specific digital content label ratings (for example, DL-MA: suitable only for mature audiences).
-      TARGETING_TYPE_SENSITIVE_CATEGORY_EXCLUSION - Filter website content by sensitive categories (for example, adult).
       TARGETING_TYPE_ENVIRONMENT - Target ads to a specific environment (for example, web or app).
       TARGETING_TYPE_CARRIER_AND_ISP - Target ads to a specific network carrier or internet service provider (ISP) (for example, Comcast or Orange).
       TARGETING_TYPE_OPERATING_SYSTEM - Target ads to a specific operating system (for example, macOS).
@@ -938,7 +936,6 @@ 
Method Details

       TARGETING_TYPE_ON_SCREEN_POSITION - Target ads in a specific on screen position.
       TARGETING_TYPE_THIRD_PARTY_VERIFIER - Filter web sites through third party verification (for example, IAS or DoubleVerify).
       TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION - Filter web sites by specific digital content label ratings (for example, DL-MA: suitable only for mature audiences).
-      TARGETING_TYPE_SENSITIVE_CATEGORY_EXCLUSION - Filter website content by sensitive categories (for example, adult).
       TARGETING_TYPE_ENVIRONMENT - Target ads to a specific environment (for example, web or app).
       TARGETING_TYPE_CARRIER_AND_ISP - Target ads to a specific network carrier or internet service provider (ISP) (for example, Comcast or Orange).
       TARGETING_TYPE_OPERATING_SYSTEM - Target ads to a specific operating system (for example, macOS).
@@ -1340,7 +1337,6 @@ 
Method Details

       TARGETING_TYPE_ON_SCREEN_POSITION - Target ads in a specific on screen position.
       TARGETING_TYPE_THIRD_PARTY_VERIFIER - Filter web sites through third party verification (for example, IAS or DoubleVerify).
       TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION - Filter web sites by specific digital content label ratings (for example, DL-MA: suitable only for mature audiences).
-      TARGETING_TYPE_SENSITIVE_CATEGORY_EXCLUSION - Filter website content by sensitive categories (for example, adult).
       TARGETING_TYPE_ENVIRONMENT - Target ads to a specific environment (for example, web or app).
       TARGETING_TYPE_CARRIER_AND_ISP - Target ads to a specific network carrier or internet service provider (ISP) (for example, Comcast or Orange).
       TARGETING_TYPE_OPERATING_SYSTEM - Target ads to a specific operating system (for example, macOS).
diff --git a/docs/dyn/displayvideo_v3.advertisers.targetingTypes.assignedTargetingOptions.html b/docs/dyn/displayvideo_v3.advertisers.targetingTypes.assignedTargetingOptions.html
index 74360bbe1f..c07f14d030 100644
--- a/docs/dyn/displayvideo_v3.advertisers.targetingTypes.assignedTargetingOptions.html
+++ b/docs/dyn/displayvideo_v3.advertisers.targetingTypes.assignedTargetingOptions.html
@@ -128,7 +128,6 @@ 
Method Details

       TARGETING_TYPE_ON_SCREEN_POSITION - Target ads in a specific on screen position.
       TARGETING_TYPE_THIRD_PARTY_VERIFIER - Filter web sites through third party verification (for example, IAS or DoubleVerify).
       TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION - Filter web sites by specific digital content label ratings (for example, DL-MA: suitable only for mature audiences).
-      TARGETING_TYPE_SENSITIVE_CATEGORY_EXCLUSION - Filter website content by sensitive categories (for example, adult).
       TARGETING_TYPE_ENVIRONMENT - Target ads to a specific environment (for example, web or app).
       TARGETING_TYPE_CARRIER_AND_ISP - Target ads to a specific network carrier or internet service provider (ISP) (for example, Comcast or Orange).
       TARGETING_TYPE_OPERATING_SYSTEM - Target ads to a specific operating system (for example, macOS).
@@ -864,7 +863,6 @@ 
Method Details

       TARGETING_TYPE_ON_SCREEN_POSITION - Target ads in a specific on screen position.
       TARGETING_TYPE_THIRD_PARTY_VERIFIER - Filter web sites through third party verification (for example, IAS or DoubleVerify).
       TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION - Filter web sites by specific digital content label ratings (for example, DL-MA: suitable only for mature audiences).
-      TARGETING_TYPE_SENSITIVE_CATEGORY_EXCLUSION - Filter website content by sensitive categories (for example, adult).
       TARGETING_TYPE_ENVIRONMENT - Target ads to a specific environment (for example, web or app).
       TARGETING_TYPE_CARRIER_AND_ISP - Target ads to a specific network carrier or internet service provider (ISP) (for example, Comcast or Orange).
       TARGETING_TYPE_OPERATING_SYSTEM - Target ads to a specific operating system (for example, macOS).
@@ -935,7 +933,6 @@ 
Method Details

       TARGETING_TYPE_ON_SCREEN_POSITION - Target ads in a specific on screen position.
       TARGETING_TYPE_THIRD_PARTY_VERIFIER - Filter web sites through third party verification (for example, IAS or DoubleVerify).
       TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION - Filter web sites by specific digital content label ratings (for example, DL-MA: suitable only for mature audiences).
-      TARGETING_TYPE_SENSITIVE_CATEGORY_EXCLUSION - Filter website content by sensitive categories (for example, adult).
       TARGETING_TYPE_ENVIRONMENT - Target ads to a specific environment (for example, web or app).
       TARGETING_TYPE_CARRIER_AND_ISP - Target ads to a specific network carrier or internet service provider (ISP) (for example, Comcast or Orange).
       TARGETING_TYPE_OPERATING_SYSTEM - Target ads to a specific operating system (for example, macOS).
@@ -1336,7 +1333,6 @@ 
Method Details

       TARGETING_TYPE_ON_SCREEN_POSITION - Target ads in a specific on screen position.
       TARGETING_TYPE_THIRD_PARTY_VERIFIER - Filter web sites through third party verification (for example, IAS or DoubleVerify).
       TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION - Filter web sites by specific digital content label ratings (for example, DL-MA: suitable only for mature audiences).
-      TARGETING_TYPE_SENSITIVE_CATEGORY_EXCLUSION - Filter website content by sensitive categories (for example, adult).
       TARGETING_TYPE_ENVIRONMENT - Target ads to a specific environment (for example, web or app).
       TARGETING_TYPE_CARRIER_AND_ISP - Target ads to a specific network carrier or internet service provider (ISP) (for example, Comcast or Orange).
       TARGETING_TYPE_OPERATING_SYSTEM - Target ads to a specific operating system (for example, macOS).
diff --git a/docs/dyn/displayvideo_v3.partners.targetingTypes.assignedTargetingOptions.html b/docs/dyn/displayvideo_v3.partners.targetingTypes.assignedTargetingOptions.html
index a4546bfa30..61b62e2852 100644
--- a/docs/dyn/displayvideo_v3.partners.targetingTypes.assignedTargetingOptions.html
+++ b/docs/dyn/displayvideo_v3.partners.targetingTypes.assignedTargetingOptions.html
@@ -128,7 +128,6 @@ 
Method Details

       TARGETING_TYPE_ON_SCREEN_POSITION - Target ads in a specific on screen position.
       TARGETING_TYPE_THIRD_PARTY_VERIFIER - Filter web sites through third party verification (for example, IAS or DoubleVerify).
       TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION - Filter web sites by specific digital content label ratings (for example, DL-MA: suitable only for mature audiences).
-      TARGETING_TYPE_SENSITIVE_CATEGORY_EXCLUSION - Filter website content by sensitive categories (for example, adult).
       TARGETING_TYPE_ENVIRONMENT - Target ads to a specific environment (for example, web or app).
       TARGETING_TYPE_CARRIER_AND_ISP - Target ads to a specific network carrier or internet service provider (ISP) (for example, Comcast or Orange).
       TARGETING_TYPE_OPERATING_SYSTEM - Target ads to a specific operating system (for example, macOS).
@@ -864,7 +863,6 @@ 
Method Details

       TARGETING_TYPE_ON_SCREEN_POSITION - Target ads in a specific on screen position.
       TARGETING_TYPE_THIRD_PARTY_VERIFIER - Filter web sites through third party verification (for example, IAS or DoubleVerify).
       TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION - Filter web sites by specific digital content label ratings (for example, DL-MA: suitable only for mature audiences).
-      TARGETING_TYPE_SENSITIVE_CATEGORY_EXCLUSION - Filter website content by sensitive categories (for example, adult).
       TARGETING_TYPE_ENVIRONMENT - Target ads to a specific environment (for example, web or app).
       TARGETING_TYPE_CARRIER_AND_ISP - Target ads to a specific network carrier or internet service provider (ISP) (for example, Comcast or Orange).
       TARGETING_TYPE_OPERATING_SYSTEM - Target ads to a specific operating system (for example, macOS).
@@ -935,7 +933,6 @@ 
Method Details

       TARGETING_TYPE_ON_SCREEN_POSITION - Target ads in a specific on screen position.
       TARGETING_TYPE_THIRD_PARTY_VERIFIER - Filter web sites through third party verification (for example, IAS or DoubleVerify).
       TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION - Filter web sites by specific digital content label ratings (for example, DL-MA: suitable only for mature audiences).
-      TARGETING_TYPE_SENSITIVE_CATEGORY_EXCLUSION - Filter website content by sensitive categories (for example, adult).
       TARGETING_TYPE_ENVIRONMENT - Target ads to a specific environment (for example, web or app).
       TARGETING_TYPE_CARRIER_AND_ISP - Target ads to a specific network carrier or internet service provider (ISP) (for example, Comcast or Orange).
       TARGETING_TYPE_OPERATING_SYSTEM - Target ads to a specific operating system (for example, macOS).
@@ -1336,7 +1333,6 @@ 
Method Details

       TARGETING_TYPE_ON_SCREEN_POSITION - Target ads in a specific on screen position.
       TARGETING_TYPE_THIRD_PARTY_VERIFIER - Filter web sites through third party verification (for example, IAS or DoubleVerify).
       TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION - Filter web sites by specific digital content label ratings (for example, DL-MA: suitable only for mature audiences).
-      TARGETING_TYPE_SENSITIVE_CATEGORY_EXCLUSION - Filter website content by sensitive categories (for example, adult).
       TARGETING_TYPE_ENVIRONMENT - Target ads to a specific environment (for example, web or app).
       TARGETING_TYPE_CARRIER_AND_ISP - Target ads to a specific network carrier or internet service provider (ISP) (for example, Comcast or Orange).
       TARGETING_TYPE_OPERATING_SYSTEM - Target ads to a specific operating system (for example, macOS).
diff --git a/docs/dyn/displayvideo_v3.targetingTypes.targetingOptions.html b/docs/dyn/displayvideo_v3.targetingTypes.targetingOptions.html
index eb40225754..c1210bd41c 100644
--- a/docs/dyn/displayvideo_v3.targetingTypes.targetingOptions.html
+++ b/docs/dyn/displayvideo_v3.targetingTypes.targetingOptions.html
@@ -127,7 +127,6 @@ 
Method Details

       TARGETING_TYPE_ON_SCREEN_POSITION - Target ads in a specific on screen position.
       TARGETING_TYPE_THIRD_PARTY_VERIFIER - Filter web sites through third party verification (for example, IAS or DoubleVerify).
       TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION - Filter web sites by specific digital content label ratings (for example, DL-MA: suitable only for mature audiences).
-      TARGETING_TYPE_SENSITIVE_CATEGORY_EXCLUSION - Filter website content by sensitive categories (for example, adult).
       TARGETING_TYPE_ENVIRONMENT - Target ads to a specific environment (for example, web or app).
       TARGETING_TYPE_CARRIER_AND_ISP - Target ads to a specific network carrier or internet service provider (ISP) (for example, Comcast or Orange).
       TARGETING_TYPE_OPERATING_SYSTEM - Target ads to a specific operating system (for example, macOS).
@@ -309,7 +308,6 @@ 
Method Details

       TARGETING_TYPE_ON_SCREEN_POSITION - Target ads in a specific on screen position.
       TARGETING_TYPE_THIRD_PARTY_VERIFIER - Filter web sites through third party verification (for example, IAS or DoubleVerify).
       TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION - Filter web sites by specific digital content label ratings (for example, DL-MA: suitable only for mature audiences).
-      TARGETING_TYPE_SENSITIVE_CATEGORY_EXCLUSION - Filter website content by sensitive categories (for example, adult).
       TARGETING_TYPE_ENVIRONMENT - Target ads to a specific environment (for example, web or app).
       TARGETING_TYPE_CARRIER_AND_ISP - Target ads to a specific network carrier or internet service provider (ISP) (for example, Comcast or Orange).
       TARGETING_TYPE_OPERATING_SYSTEM - Target ads to a specific operating system (for example, macOS).
@@ -513,7 +511,6 @@ 
Method Details

       TARGETING_TYPE_ON_SCREEN_POSITION - Target ads in a specific on screen position.
       TARGETING_TYPE_THIRD_PARTY_VERIFIER - Filter web sites through third party verification (for example, IAS or DoubleVerify).
       TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION - Filter web sites by specific digital content label ratings (for example, DL-MA: suitable only for mature audiences).
-      TARGETING_TYPE_SENSITIVE_CATEGORY_EXCLUSION - Filter website content by sensitive categories (for example, adult).
       TARGETING_TYPE_ENVIRONMENT - Target ads to a specific environment (for example, web or app).
       TARGETING_TYPE_CARRIER_AND_ISP - Target ads to a specific network carrier or internet service provider (ISP) (for example, Comcast or Orange).
       TARGETING_TYPE_OPERATING_SYSTEM - Target ads to a specific operating system (for example, macOS).
diff --git a/docs/dyn/displayvideo_v4.advertisers.adGroupAds.html b/docs/dyn/displayvideo_v4.advertisers.adGroupAds.html
index 71562d4cd9..245001d788 100644
--- a/docs/dyn/displayvideo_v4.advertisers.adGroupAds.html
+++ b/docs/dyn/displayvideo_v4.advertisers.adGroupAds.html
@@ -79,10 +79,10 @@ 
Instance Methods

 
Close httplib2 connections.

 

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

-
Creates an ad group ad. This method is only supported for Demand Gen ads.

+
Creates an ad group ad.

 

   delete(advertiserId, adGroupAdId, x__xgafv=None)

-
Deletes an ad group ad. This method is only supported for Demand Gen ads.

+
Deletes an ad group ad.

 

   get(advertiserId, adGroupAdId, x__xgafv=None)

 
Gets an ad group ad.

@@ -94,7 +94,7 @@ 
Instance Methods

 
Retrieves the next page of results.

 

   patch(advertiserId, adGroupAdId, body=None, updateMask=None, x__xgafv=None)

-
Updates an ad group ad. This method is only supported for Demand Gen ads.

+
Updates an ad group ad.

 
Method Details

 

     close()
@@ -103,14 +103,14 @@ 
Method Details

 
 

     create(advertiserId, body=None, x__xgafv=None)
-  
Creates an ad group ad. This method is only supported for Demand Gen ads.
+  
Creates an ad group ad.
 
 Args:
   advertiserId: string, Output only. The unique ID of the advertiser the ad belongs to. (required)
   body: object, The request body.
     The object takes the form of:
 
-{ # LINT: LEGACY_NAMES A single ad associated with an ad group.
+{ # A single ad associated with an ad group.
   "adGroupAdId": "A String", # Output only. The unique ID of the ad. Assigned by the system.
   "adGroupId": "A String", # Required. Immutable. The unique ID of the ad group that the ad belongs to.
   "adPolicy": { # A single ad policy associated with an ad group ad. # Output only. The policy approval status of the ad.
@@ -256,7 +256,7 @@ 
Method Details

   "audioAd": { # Details for an audio ad. # Output only. Details of an [audio ad](//support.google.com/displayvideo/answer/6274216) used for reach marketing objectives.
     "displayUrl": "A String", # The webpage address that appears with the ad.
     "finalUrl": "A String", # The URL address of the webpage that people reach after they click the ad.
-    "trackingUrl": "A String", # The URL address loaded in the background for tracking purposes.
+    "trackingUrl": "A String", # The URL address loaded in the background for tracking purposes. In v4 and earlier, this field represents the tracking URL specified by the user manually. This can be found at userSpecifiedTrackingUrl in v5.
     "video": { # Details of a YouTube video. # The YouTube video of the ad.
       "id": "A String", # Output only. The YouTube video ID which can be searched on YouTube webpage.
       "unavailableReason": "A String", # Output only. The reason why the video data is not available.
@@ -265,7 +265,7 @@ 
Method Details

   },
   "bumperAd": { # Details for a bumper ad. # Optional. Details of a [non-skippable short video ad](//support.google.com/displayvideo/answer/6274216), equal to or less than 6 seconds, used for reach.
     "commonInStreamAttribute": { # Common attributes for in-stream, non-skippable and bumper ads. # Required. Common ad attributes.
-      "actionButtonLabel": "A String", # Optional. The text on the call-to-action button.
+      "actionButtonLabel": "A String", # Optional. The text on the call-to-action button. Must be set if actionHeadline is set.
       "actionHeadline": "A String", # Optional. The headline of the call-to-action banner.
       "companionBanner": { # Meta data of an image asset. # Optional. The image which shows next to the video ad.
         "assetId": "A String", # Required. The unique ID of the asset.
@@ -278,7 +278,7 @@ 
Method Details

       },
       "displayUrl": "A String", # Required. The webpage address that appears with the ad.
       "finalUrl": "A String", # Required. The URL address of the webpage that people reach after they click the ad.
-      "trackingUrl": "A String", # Output only. The URL address loaded in the background for tracking purposes.
+      "trackingUrl": "A String", # Output only. The URL address loaded in the background for tracking purposes. In v4 and earlier, this field represents the tracking URL specified by the user manually. This can be found at userSpecifiedTrackingUrl in v5.
       "video": { # Details of a YouTube video. # Required. Immutable. The YouTube video of the ad.
         "id": "A String", # Output only. The YouTube video ID which can be searched on YouTube webpage.
         "unavailableReason": "A String", # Output only. The reason why the video data is not available.
@@ -286,7 +286,7 @@ 
Method Details

       },
     },
   },
-  "dcmTrackingInfo": { # Details on the DCM tracking. # Optional. The DCM tracking ad info. Only valid for Demand Gen ads. To remove the DCM tracking ad info, please leave this field empty.
+  "dcmTrackingInfo": { # Details on the DCM tracking. # Optional. The DCM tracking ad info. To remove the DCM tracking ad info, please leave this field empty.
     "creativeId": "A String", # Required. The DCM creative id.
     "placementId": "A String", # Required. The DCM placement id.
     "trackingAdId": "A String", # Required. The DCM tracking ad id.
@@ -488,7 +488,7 @@ 
Method Details

   "entityStatus": "A String", # Required. The entity status of the ad.
   "inStreamAd": { # Details for an in-stream ad. # Optional. Details of an [in-stream ad skippable after 5 seconds](//support.google.com/displayvideo/answer/6274216), used for brand awareness or reach marketing objectives.
     "commonInStreamAttribute": { # Common attributes for in-stream, non-skippable and bumper ads. # Required. Common ad attributes.
-      "actionButtonLabel": "A String", # Optional. The text on the call-to-action button.
+      "actionButtonLabel": "A String", # Optional. The text on the call-to-action button. Must be set if actionHeadline is set.
       "actionHeadline": "A String", # Optional. The headline of the call-to-action banner.
       "companionBanner": { # Meta data of an image asset. # Optional. The image which shows next to the video ad.
         "assetId": "A String", # Required. The unique ID of the asset.
@@ -501,7 +501,7 @@ 
Method Details

       },
       "displayUrl": "A String", # Required. The webpage address that appears with the ad.
       "finalUrl": "A String", # Required. The URL address of the webpage that people reach after they click the ad.
-      "trackingUrl": "A String", # Output only. The URL address loaded in the background for tracking purposes.
+      "trackingUrl": "A String", # Output only. The URL address loaded in the background for tracking purposes. In v4 and earlier, this field represents the tracking URL specified by the user manually. This can be found at userSpecifiedTrackingUrl in v5.
       "video": { # Details of a YouTube video. # Required. Immutable. The YouTube video of the ad.
         "id": "A String", # Output only. The YouTube video ID which can be searched on YouTube webpage.
         "unavailableReason": "A String", # Output only. The reason why the video data is not available.
@@ -538,7 +538,7 @@ 
Method Details

   "name": "A String", # Output only. The resource name of the ad.
   "nonSkippableAd": { # Details for a non-skippable ad. # Optional. Details of a [non-skippable short in-stream video ad](//support.google.com/displayvideo/answer/6274216), between 6 and 15 seconds, used for reach marketing objectives.
     "commonInStreamAttribute": { # Common attributes for in-stream, non-skippable and bumper ads. # Required. Common ad attributes.
-      "actionButtonLabel": "A String", # Optional. The text on the call-to-action button.
+      "actionButtonLabel": "A String", # Optional. The text on the call-to-action button. Must be set if actionHeadline is set.
       "actionHeadline": "A String", # Optional. The headline of the call-to-action banner.
       "companionBanner": { # Meta data of an image asset. # Optional. The image which shows next to the video ad.
         "assetId": "A String", # Required. The unique ID of the asset.
@@ -551,7 +551,7 @@ 
Method Details

       },
       "displayUrl": "A String", # Required. The webpage address that appears with the ad.
       "finalUrl": "A String", # Required. The URL address of the webpage that people reach after they click the ad.
-      "trackingUrl": "A String", # Output only. The URL address loaded in the background for tracking purposes.
+      "trackingUrl": "A String", # Output only. The URL address loaded in the background for tracking purposes. In v4 and earlier, this field represents the tracking URL specified by the user manually. This can be found at userSpecifiedTrackingUrl in v5.
       "video": { # Details of a YouTube video. # Required. Immutable. The YouTube video of the ad.
         "id": "A String", # Output only. The YouTube video ID which can be searched on YouTube webpage.
         "unavailableReason": "A String", # Output only. The reason why the video data is not available.
@@ -574,7 +574,7 @@ 
Method Details

     },
   },
   "videoPerformanceAd": { # Details for a video performance ad. # Optional. Details of an [ad used in a video action campaign](//support.google.com/google-ads/answer/10147229) to drive actions to the business, service or product.
-    "actionButtonLabels": [ # Optional. The list of text assets shown on the call-to-action button.
+    "actionButtonLabels": [ # Optional. The list of text assets shown on the call-to-action button. Must be set if headlines is set.
       "A String",
     ],
     "companionBanners": [ # Optional. The list of companion banners used by this ad.
@@ -591,20 +591,20 @@ 
Method Details

     "customParameters": { # Optional. The custom parameters and accompanying values to add to the tracking URL.
       "a_key": "A String",
     },
-    "descriptions": [ # Optional. The list of descriptions shown on the call-to-action banner.
+    "descriptions": [ # Optional. The list of descriptions shown on the call-to-action banner. Must be set unless the parent line item's lineItemType is `LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_NON_SKIPPABLE`, in which case this field cannot be set.
       "A String",
     ],
     "displayUrlBreadcrumb1": "A String", # Optional. The first piece after the domain in the display URL.
-    "displayUrlBreadcrumb2": "A String", # Optional. The second piece after the domain in the display URL.
+    "displayUrlBreadcrumb2": "A String", # Optional. The second piece after the domain in the display URL. Can only be set if displayUrlBreadcrumb1 is also set.
     "domain": "A String", # Output only. The domain of the display URL.
     "finalUrl": "A String", # Required. The URL address of the webpage that people reach after they click the ad.
     "headlines": [ # Optional. The list of headlines shown on the call-to-action banner.
       "A String",
     ],
-    "longHeadlines": [ # Optional. The list of long headlines shown on the call-to-action banner.
+    "longHeadlines": [ # Optional. The list of long headlines shown on the call-to-action banner. Must be set unless the parent line item's lineItemType is `LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_NON_SKIPPABLE`, in which case this field cannot be set.
       "A String",
     ],
-    "trackingUrl": "A String", # Output only. The URL address loaded in the background for tracking purposes.
+    "trackingUrl": "A String", # Output only. The URL address loaded in the background for tracking purposes. In v4 and earlier, this field represents the tracking URL specified by the user manually. This can be found at userSpecifiedTrackingUrl in v5.
     "videos": [ # Required. The list of YouTube video assets used by this ad.
       { # Details of a YouTube video.
         "id": "A String", # Output only. The YouTube video ID which can be searched on YouTube webpage.
@@ -623,7 +623,7 @@ 
Method Details

 Returns:
   An object of the form:
 
-    { # LINT: LEGACY_NAMES A single ad associated with an ad group.
+    { # A single ad associated with an ad group.
   "adGroupAdId": "A String", # Output only. The unique ID of the ad. Assigned by the system.
   "adGroupId": "A String", # Required. Immutable. The unique ID of the ad group that the ad belongs to.
   "adPolicy": { # A single ad policy associated with an ad group ad. # Output only. The policy approval status of the ad.
@@ -769,7 +769,7 @@ 
Method Details

   "audioAd": { # Details for an audio ad. # Output only. Details of an [audio ad](//support.google.com/displayvideo/answer/6274216) used for reach marketing objectives.
     "displayUrl": "A String", # The webpage address that appears with the ad.
     "finalUrl": "A String", # The URL address of the webpage that people reach after they click the ad.
-    "trackingUrl": "A String", # The URL address loaded in the background for tracking purposes.
+    "trackingUrl": "A String", # The URL address loaded in the background for tracking purposes. In v4 and earlier, this field represents the tracking URL specified by the user manually. This can be found at userSpecifiedTrackingUrl in v5.
     "video": { # Details of a YouTube video. # The YouTube video of the ad.
       "id": "A String", # Output only. The YouTube video ID which can be searched on YouTube webpage.
       "unavailableReason": "A String", # Output only. The reason why the video data is not available.
@@ -778,7 +778,7 @@ 
Method Details

   },
   "bumperAd": { # Details for a bumper ad. # Optional. Details of a [non-skippable short video ad](//support.google.com/displayvideo/answer/6274216), equal to or less than 6 seconds, used for reach.
     "commonInStreamAttribute": { # Common attributes for in-stream, non-skippable and bumper ads. # Required. Common ad attributes.
-      "actionButtonLabel": "A String", # Optional. The text on the call-to-action button.
+      "actionButtonLabel": "A String", # Optional. The text on the call-to-action button. Must be set if actionHeadline is set.
       "actionHeadline": "A String", # Optional. The headline of the call-to-action banner.
       "companionBanner": { # Meta data of an image asset. # Optional. The image which shows next to the video ad.
         "assetId": "A String", # Required. The unique ID of the asset.
@@ -791,7 +791,7 @@ 
Method Details

       },
       "displayUrl": "A String", # Required. The webpage address that appears with the ad.
       "finalUrl": "A String", # Required. The URL address of the webpage that people reach after they click the ad.
-      "trackingUrl": "A String", # Output only. The URL address loaded in the background for tracking purposes.
+      "trackingUrl": "A String", # Output only. The URL address loaded in the background for tracking purposes. In v4 and earlier, this field represents the tracking URL specified by the user manually. This can be found at userSpecifiedTrackingUrl in v5.
       "video": { # Details of a YouTube video. # Required. Immutable. The YouTube video of the ad.
         "id": "A String", # Output only. The YouTube video ID which can be searched on YouTube webpage.
         "unavailableReason": "A String", # Output only. The reason why the video data is not available.
@@ -799,7 +799,7 @@ 
Method Details

       },
     },
   },
-  "dcmTrackingInfo": { # Details on the DCM tracking. # Optional. The DCM tracking ad info. Only valid for Demand Gen ads. To remove the DCM tracking ad info, please leave this field empty.
+  "dcmTrackingInfo": { # Details on the DCM tracking. # Optional. The DCM tracking ad info. To remove the DCM tracking ad info, please leave this field empty.
     "creativeId": "A String", # Required. The DCM creative id.
     "placementId": "A String", # Required. The DCM placement id.
     "trackingAdId": "A String", # Required. The DCM tracking ad id.
@@ -1001,7 +1001,7 @@ 
Method Details

   "entityStatus": "A String", # Required. The entity status of the ad.
   "inStreamAd": { # Details for an in-stream ad. # Optional. Details of an [in-stream ad skippable after 5 seconds](//support.google.com/displayvideo/answer/6274216), used for brand awareness or reach marketing objectives.
     "commonInStreamAttribute": { # Common attributes for in-stream, non-skippable and bumper ads. # Required. Common ad attributes.
-      "actionButtonLabel": "A String", # Optional. The text on the call-to-action button.
+      "actionButtonLabel": "A String", # Optional. The text on the call-to-action button. Must be set if actionHeadline is set.
       "actionHeadline": "A String", # Optional. The headline of the call-to-action banner.
       "companionBanner": { # Meta data of an image asset. # Optional. The image which shows next to the video ad.
         "assetId": "A String", # Required. The unique ID of the asset.
@@ -1014,7 +1014,7 @@ 
Method Details

       },
       "displayUrl": "A String", # Required. The webpage address that appears with the ad.
       "finalUrl": "A String", # Required. The URL address of the webpage that people reach after they click the ad.
-      "trackingUrl": "A String", # Output only. The URL address loaded in the background for tracking purposes.
+      "trackingUrl": "A String", # Output only. The URL address loaded in the background for tracking purposes. In v4 and earlier, this field represents the tracking URL specified by the user manually. This can be found at userSpecifiedTrackingUrl in v5.
       "video": { # Details of a YouTube video. # Required. Immutable. The YouTube video of the ad.
         "id": "A String", # Output only. The YouTube video ID which can be searched on YouTube webpage.
         "unavailableReason": "A String", # Output only. The reason why the video data is not available.
@@ -1051,7 +1051,7 @@ 
Method Details

   "name": "A String", # Output only. The resource name of the ad.
   "nonSkippableAd": { # Details for a non-skippable ad. # Optional. Details of a [non-skippable short in-stream video ad](//support.google.com/displayvideo/answer/6274216), between 6 and 15 seconds, used for reach marketing objectives.
     "commonInStreamAttribute": { # Common attributes for in-stream, non-skippable and bumper ads. # Required. Common ad attributes.
-      "actionButtonLabel": "A String", # Optional. The text on the call-to-action button.
+      "actionButtonLabel": "A String", # Optional. The text on the call-to-action button. Must be set if actionHeadline is set.
       "actionHeadline": "A String", # Optional. The headline of the call-to-action banner.
       "companionBanner": { # Meta data of an image asset. # Optional. The image which shows next to the video ad.
         "assetId": "A String", # Required. The unique ID of the asset.
@@ -1064,7 +1064,7 @@ 
Method Details

       },
       "displayUrl": "A String", # Required. The webpage address that appears with the ad.
       "finalUrl": "A String", # Required. The URL address of the webpage that people reach after they click the ad.
-      "trackingUrl": "A String", # Output only. The URL address loaded in the background for tracking purposes.
+      "trackingUrl": "A String", # Output only. The URL address loaded in the background for tracking purposes. In v4 and earlier, this field represents the tracking URL specified by the user manually. This can be found at userSpecifiedTrackingUrl in v5.
       "video": { # Details of a YouTube video. # Required. Immutable. The YouTube video of the ad.
         "id": "A String", # Output only. The YouTube video ID which can be searched on YouTube webpage.
         "unavailableReason": "A String", # Output only. The reason why the video data is not available.
@@ -1087,7 +1087,7 @@ 
Method Details

     },
   },
   "videoPerformanceAd": { # Details for a video performance ad. # Optional. Details of an [ad used in a video action campaign](//support.google.com/google-ads/answer/10147229) to drive actions to the business, service or product.
-    "actionButtonLabels": [ # Optional. The list of text assets shown on the call-to-action button.
+    "actionButtonLabels": [ # Optional. The list of text assets shown on the call-to-action button. Must be set if headlines is set.
       "A String",
     ],
     "companionBanners": [ # Optional. The list of companion banners used by this ad.
@@ -1104,20 +1104,20 @@ 
Method Details

     "customParameters": { # Optional. The custom parameters and accompanying values to add to the tracking URL.
       "a_key": "A String",
     },
-    "descriptions": [ # Optional. The list of descriptions shown on the call-to-action banner.
+    "descriptions": [ # Optional. The list of descriptions shown on the call-to-action banner. Must be set unless the parent line item's lineItemType is `LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_NON_SKIPPABLE`, in which case this field cannot be set.
       "A String",
     ],
     "displayUrlBreadcrumb1": "A String", # Optional. The first piece after the domain in the display URL.
-    "displayUrlBreadcrumb2": "A String", # Optional. The second piece after the domain in the display URL.
+    "displayUrlBreadcrumb2": "A String", # Optional. The second piece after the domain in the display URL. Can only be set if displayUrlBreadcrumb1 is also set.
     "domain": "A String", # Output only. The domain of the display URL.
     "finalUrl": "A String", # Required. The URL address of the webpage that people reach after they click the ad.
     "headlines": [ # Optional. The list of headlines shown on the call-to-action banner.
       "A String",
     ],
-    "longHeadlines": [ # Optional. The list of long headlines shown on the call-to-action banner.
+    "longHeadlines": [ # Optional. The list of long headlines shown on the call-to-action banner. Must be set unless the parent line item's lineItemType is `LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_NON_SKIPPABLE`, in which case this field cannot be set.
       "A String",
     ],
-    "trackingUrl": "A String", # Output only. The URL address loaded in the background for tracking purposes.
+    "trackingUrl": "A String", # Output only. The URL address loaded in the background for tracking purposes. In v4 and earlier, this field represents the tracking URL specified by the user manually. This can be found at userSpecifiedTrackingUrl in v5.
     "videos": [ # Required. The list of YouTube video assets used by this ad.
       { # Details of a YouTube video.
         "id": "A String", # Output only. The YouTube video ID which can be searched on YouTube webpage.
@@ -1131,11 +1131,11 @@ 
Method Details

 
 

     delete(advertiserId, adGroupAdId, x__xgafv=None)
-  
Deletes an ad group ad. This method is only supported for Demand Gen ads.
+  
Deletes an ad group ad.
 
 Args:
   advertiserId: string, Required. The ID of the advertiser the ad belongs to. (required)
-  adGroupAdId: string, Required. The ID of the ad to delete. Only Demand Gen ads are supported. (required)
+  adGroupAdId: string, Required. The ID of the ad to delete. (required)
   x__xgafv: string, V1 error format.
     Allowed values
       1 - v1 error format
@@ -1163,7 +1163,7 @@ 
Method Details

 Returns:
   An object of the form:
 
-    { # LINT: LEGACY_NAMES A single ad associated with an ad group.
+    { # A single ad associated with an ad group.
   "adGroupAdId": "A String", # Output only. The unique ID of the ad. Assigned by the system.
   "adGroupId": "A String", # Required. Immutable. The unique ID of the ad group that the ad belongs to.
   "adPolicy": { # A single ad policy associated with an ad group ad. # Output only. The policy approval status of the ad.
@@ -1309,7 +1309,7 @@ 
Method Details

   "audioAd": { # Details for an audio ad. # Output only. Details of an [audio ad](//support.google.com/displayvideo/answer/6274216) used for reach marketing objectives.
     "displayUrl": "A String", # The webpage address that appears with the ad.
     "finalUrl": "A String", # The URL address of the webpage that people reach after they click the ad.
-    "trackingUrl": "A String", # The URL address loaded in the background for tracking purposes.
+    "trackingUrl": "A String", # The URL address loaded in the background for tracking purposes. In v4 and earlier, this field represents the tracking URL specified by the user manually. This can be found at userSpecifiedTrackingUrl in v5.
     "video": { # Details of a YouTube video. # The YouTube video of the ad.
       "id": "A String", # Output only. The YouTube video ID which can be searched on YouTube webpage.
       "unavailableReason": "A String", # Output only. The reason why the video data is not available.
@@ -1318,7 +1318,7 @@ 
Method Details

   },
   "bumperAd": { # Details for a bumper ad. # Optional. Details of a [non-skippable short video ad](//support.google.com/displayvideo/answer/6274216), equal to or less than 6 seconds, used for reach.
     "commonInStreamAttribute": { # Common attributes for in-stream, non-skippable and bumper ads. # Required. Common ad attributes.
-      "actionButtonLabel": "A String", # Optional. The text on the call-to-action button.
+      "actionButtonLabel": "A String", # Optional. The text on the call-to-action button. Must be set if actionHeadline is set.
       "actionHeadline": "A String", # Optional. The headline of the call-to-action banner.
       "companionBanner": { # Meta data of an image asset. # Optional. The image which shows next to the video ad.
         "assetId": "A String", # Required. The unique ID of the asset.
@@ -1331,7 +1331,7 @@ 
Method Details

       },
       "displayUrl": "A String", # Required. The webpage address that appears with the ad.
       "finalUrl": "A String", # Required. The URL address of the webpage that people reach after they click the ad.
-      "trackingUrl": "A String", # Output only. The URL address loaded in the background for tracking purposes.
+      "trackingUrl": "A String", # Output only. The URL address loaded in the background for tracking purposes. In v4 and earlier, this field represents the tracking URL specified by the user manually. This can be found at userSpecifiedTrackingUrl in v5.
       "video": { # Details of a YouTube video. # Required. Immutable. The YouTube video of the ad.
         "id": "A String", # Output only. The YouTube video ID which can be searched on YouTube webpage.
         "unavailableReason": "A String", # Output only. The reason why the video data is not available.
@@ -1339,7 +1339,7 @@ 
Method Details

       },
     },
   },
-  "dcmTrackingInfo": { # Details on the DCM tracking. # Optional. The DCM tracking ad info. Only valid for Demand Gen ads. To remove the DCM tracking ad info, please leave this field empty.
+  "dcmTrackingInfo": { # Details on the DCM tracking. # Optional. The DCM tracking ad info. To remove the DCM tracking ad info, please leave this field empty.
     "creativeId": "A String", # Required. The DCM creative id.
     "placementId": "A String", # Required. The DCM placement id.
     "trackingAdId": "A String", # Required. The DCM tracking ad id.
@@ -1541,7 +1541,7 @@ 
Method Details

   "entityStatus": "A String", # Required. The entity status of the ad.
   "inStreamAd": { # Details for an in-stream ad. # Optional. Details of an [in-stream ad skippable after 5 seconds](//support.google.com/displayvideo/answer/6274216), used for brand awareness or reach marketing objectives.
     "commonInStreamAttribute": { # Common attributes for in-stream, non-skippable and bumper ads. # Required. Common ad attributes.
-      "actionButtonLabel": "A String", # Optional. The text on the call-to-action button.
+      "actionButtonLabel": "A String", # Optional. The text on the call-to-action button. Must be set if actionHeadline is set.
       "actionHeadline": "A String", # Optional. The headline of the call-to-action banner.
       "companionBanner": { # Meta data of an image asset. # Optional. The image which shows next to the video ad.
         "assetId": "A String", # Required. The unique ID of the asset.
@@ -1554,7 +1554,7 @@ 
Method Details

       },
       "displayUrl": "A String", # Required. The webpage address that appears with the ad.
       "finalUrl": "A String", # Required. The URL address of the webpage that people reach after they click the ad.
-      "trackingUrl": "A String", # Output only. The URL address loaded in the background for tracking purposes.
+      "trackingUrl": "A String", # Output only. The URL address loaded in the background for tracking purposes. In v4 and earlier, this field represents the tracking URL specified by the user manually. This can be found at userSpecifiedTrackingUrl in v5.
       "video": { # Details of a YouTube video. # Required. Immutable. The YouTube video of the ad.
         "id": "A String", # Output only. The YouTube video ID which can be searched on YouTube webpage.
         "unavailableReason": "A String", # Output only. The reason why the video data is not available.
@@ -1591,7 +1591,7 @@ 
Method Details

   "name": "A String", # Output only. The resource name of the ad.
   "nonSkippableAd": { # Details for a non-skippable ad. # Optional. Details of a [non-skippable short in-stream video ad](//support.google.com/displayvideo/answer/6274216), between 6 and 15 seconds, used for reach marketing objectives.
     "commonInStreamAttribute": { # Common attributes for in-stream, non-skippable and bumper ads. # Required. Common ad attributes.
-      "actionButtonLabel": "A String", # Optional. The text on the call-to-action button.
+      "actionButtonLabel": "A String", # Optional. The text on the call-to-action button. Must be set if actionHeadline is set.
       "actionHeadline": "A String", # Optional. The headline of the call-to-action banner.
       "companionBanner": { # Meta data of an image asset. # Optional. The image which shows next to the video ad.
         "assetId": "A String", # Required. The unique ID of the asset.
@@ -1604,7 +1604,7 @@ 
Method Details

       },
       "displayUrl": "A String", # Required. The webpage address that appears with the ad.
       "finalUrl": "A String", # Required. The URL address of the webpage that people reach after they click the ad.
-      "trackingUrl": "A String", # Output only. The URL address loaded in the background for tracking purposes.
+      "trackingUrl": "A String", # Output only. The URL address loaded in the background for tracking purposes. In v4 and earlier, this field represents the tracking URL specified by the user manually. This can be found at userSpecifiedTrackingUrl in v5.
       "video": { # Details of a YouTube video. # Required. Immutable. The YouTube video of the ad.
         "id": "A String", # Output only. The YouTube video ID which can be searched on YouTube webpage.
         "unavailableReason": "A String", # Output only. The reason why the video data is not available.
@@ -1627,7 +1627,7 @@ 
Method Details

     },
   },
   "videoPerformanceAd": { # Details for a video performance ad. # Optional. Details of an [ad used in a video action campaign](//support.google.com/google-ads/answer/10147229) to drive actions to the business, service or product.
-    "actionButtonLabels": [ # Optional. The list of text assets shown on the call-to-action button.
+    "actionButtonLabels": [ # Optional. The list of text assets shown on the call-to-action button. Must be set if headlines is set.
       "A String",
     ],
     "companionBanners": [ # Optional. The list of companion banners used by this ad.
@@ -1644,20 +1644,20 @@ 
Method Details

     "customParameters": { # Optional. The custom parameters and accompanying values to add to the tracking URL.
       "a_key": "A String",
     },
-    "descriptions": [ # Optional. The list of descriptions shown on the call-to-action banner.
+    "descriptions": [ # Optional. The list of descriptions shown on the call-to-action banner. Must be set unless the parent line item's lineItemType is `LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_NON_SKIPPABLE`, in which case this field cannot be set.
       "A String",
     ],
     "displayUrlBreadcrumb1": "A String", # Optional. The first piece after the domain in the display URL.
-    "displayUrlBreadcrumb2": "A String", # Optional. The second piece after the domain in the display URL.
+    "displayUrlBreadcrumb2": "A String", # Optional. The second piece after the domain in the display URL. Can only be set if displayUrlBreadcrumb1 is also set.
     "domain": "A String", # Output only. The domain of the display URL.
     "finalUrl": "A String", # Required. The URL address of the webpage that people reach after they click the ad.
     "headlines": [ # Optional. The list of headlines shown on the call-to-action banner.
       "A String",
     ],
-    "longHeadlines": [ # Optional. The list of long headlines shown on the call-to-action banner.
+    "longHeadlines": [ # Optional. The list of long headlines shown on the call-to-action banner. Must be set unless the parent line item's lineItemType is `LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_NON_SKIPPABLE`, in which case this field cannot be set.
       "A String",
     ],
-    "trackingUrl": "A String", # Output only. The URL address loaded in the background for tracking purposes.
+    "trackingUrl": "A String", # Output only. The URL address loaded in the background for tracking purposes. In v4 and earlier, this field represents the tracking URL specified by the user manually. This can be found at userSpecifiedTrackingUrl in v5.
     "videos": [ # Required. The list of YouTube video assets used by this ad.
       { # Details of a YouTube video.
         "id": "A String", # Output only. The YouTube video ID which can be searched on YouTube webpage.
@@ -1689,7 +1689,7 @@ 
Method Details

 
     {
   "adGroupAds": [ # The list of ads. This list will be absent if empty.
-    { # LINT: LEGACY_NAMES A single ad associated with an ad group.
+    { # A single ad associated with an ad group.
       "adGroupAdId": "A String", # Output only. The unique ID of the ad. Assigned by the system.
       "adGroupId": "A String", # Required. Immutable. The unique ID of the ad group that the ad belongs to.
       "adPolicy": { # A single ad policy associated with an ad group ad. # Output only. The policy approval status of the ad.
@@ -1835,7 +1835,7 @@ 
Method Details

       "audioAd": { # Details for an audio ad. # Output only. Details of an [audio ad](//support.google.com/displayvideo/answer/6274216) used for reach marketing objectives.
         "displayUrl": "A String", # The webpage address that appears with the ad.
         "finalUrl": "A String", # The URL address of the webpage that people reach after they click the ad.
-        "trackingUrl": "A String", # The URL address loaded in the background for tracking purposes.
+        "trackingUrl": "A String", # The URL address loaded in the background for tracking purposes. In v4 and earlier, this field represents the tracking URL specified by the user manually. This can be found at userSpecifiedTrackingUrl in v5.
         "video": { # Details of a YouTube video. # The YouTube video of the ad.
           "id": "A String", # Output only. The YouTube video ID which can be searched on YouTube webpage.
           "unavailableReason": "A String", # Output only. The reason why the video data is not available.
@@ -1844,7 +1844,7 @@ 
Method Details

       },
       "bumperAd": { # Details for a bumper ad. # Optional. Details of a [non-skippable short video ad](//support.google.com/displayvideo/answer/6274216), equal to or less than 6 seconds, used for reach.
         "commonInStreamAttribute": { # Common attributes for in-stream, non-skippable and bumper ads. # Required. Common ad attributes.
-          "actionButtonLabel": "A String", # Optional. The text on the call-to-action button.
+          "actionButtonLabel": "A String", # Optional. The text on the call-to-action button. Must be set if actionHeadline is set.
           "actionHeadline": "A String", # Optional. The headline of the call-to-action banner.
           "companionBanner": { # Meta data of an image asset. # Optional. The image which shows next to the video ad.
             "assetId": "A String", # Required. The unique ID of the asset.
@@ -1857,7 +1857,7 @@ 
Method Details

           },
           "displayUrl": "A String", # Required. The webpage address that appears with the ad.
           "finalUrl": "A String", # Required. The URL address of the webpage that people reach after they click the ad.
-          "trackingUrl": "A String", # Output only. The URL address loaded in the background for tracking purposes.
+          "trackingUrl": "A String", # Output only. The URL address loaded in the background for tracking purposes. In v4 and earlier, this field represents the tracking URL specified by the user manually. This can be found at userSpecifiedTrackingUrl in v5.
           "video": { # Details of a YouTube video. # Required. Immutable. The YouTube video of the ad.
             "id": "A String", # Output only. The YouTube video ID which can be searched on YouTube webpage.
             "unavailableReason": "A String", # Output only. The reason why the video data is not available.
@@ -1865,7 +1865,7 @@ 
Method Details

           },
         },
       },
-      "dcmTrackingInfo": { # Details on the DCM tracking. # Optional. The DCM tracking ad info. Only valid for Demand Gen ads. To remove the DCM tracking ad info, please leave this field empty.
+      "dcmTrackingInfo": { # Details on the DCM tracking. # Optional. The DCM tracking ad info. To remove the DCM tracking ad info, please leave this field empty.
         "creativeId": "A String", # Required. The DCM creative id.
         "placementId": "A String", # Required. The DCM placement id.
         "trackingAdId": "A String", # Required. The DCM tracking ad id.
@@ -2067,7 +2067,7 @@ 
Method Details

       "entityStatus": "A String", # Required. The entity status of the ad.
       "inStreamAd": { # Details for an in-stream ad. # Optional. Details of an [in-stream ad skippable after 5 seconds](//support.google.com/displayvideo/answer/6274216), used for brand awareness or reach marketing objectives.
         "commonInStreamAttribute": { # Common attributes for in-stream, non-skippable and bumper ads. # Required. Common ad attributes.
-          "actionButtonLabel": "A String", # Optional. The text on the call-to-action button.
+          "actionButtonLabel": "A String", # Optional. The text on the call-to-action button. Must be set if actionHeadline is set.
           "actionHeadline": "A String", # Optional. The headline of the call-to-action banner.
           "companionBanner": { # Meta data of an image asset. # Optional. The image which shows next to the video ad.
             "assetId": "A String", # Required. The unique ID of the asset.
@@ -2080,7 +2080,7 @@ 
Method Details

           },
           "displayUrl": "A String", # Required. The webpage address that appears with the ad.
           "finalUrl": "A String", # Required. The URL address of the webpage that people reach after they click the ad.
-          "trackingUrl": "A String", # Output only. The URL address loaded in the background for tracking purposes.
+          "trackingUrl": "A String", # Output only. The URL address loaded in the background for tracking purposes. In v4 and earlier, this field represents the tracking URL specified by the user manually. This can be found at userSpecifiedTrackingUrl in v5.
           "video": { # Details of a YouTube video. # Required. Immutable. The YouTube video of the ad.
             "id": "A String", # Output only. The YouTube video ID which can be searched on YouTube webpage.
             "unavailableReason": "A String", # Output only. The reason why the video data is not available.
@@ -2117,7 +2117,7 @@ 
Method Details

       "name": "A String", # Output only. The resource name of the ad.
       "nonSkippableAd": { # Details for a non-skippable ad. # Optional. Details of a [non-skippable short in-stream video ad](//support.google.com/displayvideo/answer/6274216), between 6 and 15 seconds, used for reach marketing objectives.
         "commonInStreamAttribute": { # Common attributes for in-stream, non-skippable and bumper ads. # Required. Common ad attributes.
-          "actionButtonLabel": "A String", # Optional. The text on the call-to-action button.
+          "actionButtonLabel": "A String", # Optional. The text on the call-to-action button. Must be set if actionHeadline is set.
           "actionHeadline": "A String", # Optional. The headline of the call-to-action banner.
           "companionBanner": { # Meta data of an image asset. # Optional. The image which shows next to the video ad.
             "assetId": "A String", # Required. The unique ID of the asset.
@@ -2130,7 +2130,7 @@ 
Method Details

           },
           "displayUrl": "A String", # Required. The webpage address that appears with the ad.
           "finalUrl": "A String", # Required. The URL address of the webpage that people reach after they click the ad.
-          "trackingUrl": "A String", # Output only. The URL address loaded in the background for tracking purposes.
+          "trackingUrl": "A String", # Output only. The URL address loaded in the background for tracking purposes. In v4 and earlier, this field represents the tracking URL specified by the user manually. This can be found at userSpecifiedTrackingUrl in v5.
           "video": { # Details of a YouTube video. # Required. Immutable. The YouTube video of the ad.
             "id": "A String", # Output only. The YouTube video ID which can be searched on YouTube webpage.
             "unavailableReason": "A String", # Output only. The reason why the video data is not available.
@@ -2153,7 +2153,7 @@ 
Method Details

         },
       },
       "videoPerformanceAd": { # Details for a video performance ad. # Optional. Details of an [ad used in a video action campaign](//support.google.com/google-ads/answer/10147229) to drive actions to the business, service or product.
-        "actionButtonLabels": [ # Optional. The list of text assets shown on the call-to-action button.
+        "actionButtonLabels": [ # Optional. The list of text assets shown on the call-to-action button. Must be set if headlines is set.
           "A String",
         ],
         "companionBanners": [ # Optional. The list of companion banners used by this ad.
@@ -2170,20 +2170,20 @@ 
Method Details

         "customParameters": { # Optional. The custom parameters and accompanying values to add to the tracking URL.
           "a_key": "A String",
         },
-        "descriptions": [ # Optional. The list of descriptions shown on the call-to-action banner.
+        "descriptions": [ # Optional. The list of descriptions shown on the call-to-action banner. Must be set unless the parent line item's lineItemType is `LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_NON_SKIPPABLE`, in which case this field cannot be set.
           "A String",
         ],
         "displayUrlBreadcrumb1": "A String", # Optional. The first piece after the domain in the display URL.
-        "displayUrlBreadcrumb2": "A String", # Optional. The second piece after the domain in the display URL.
+        "displayUrlBreadcrumb2": "A String", # Optional. The second piece after the domain in the display URL. Can only be set if displayUrlBreadcrumb1 is also set.
         "domain": "A String", # Output only. The domain of the display URL.
         "finalUrl": "A String", # Required. The URL address of the webpage that people reach after they click the ad.
         "headlines": [ # Optional. The list of headlines shown on the call-to-action banner.
           "A String",
         ],
-        "longHeadlines": [ # Optional. The list of long headlines shown on the call-to-action banner.
+        "longHeadlines": [ # Optional. The list of long headlines shown on the call-to-action banner. Must be set unless the parent line item's lineItemType is `LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_NON_SKIPPABLE`, in which case this field cannot be set.
           "A String",
         ],
-        "trackingUrl": "A String", # Output only. The URL address loaded in the background for tracking purposes.
+        "trackingUrl": "A String", # Output only. The URL address loaded in the background for tracking purposes. In v4 and earlier, this field represents the tracking URL specified by the user manually. This can be found at userSpecifiedTrackingUrl in v5.
         "videos": [ # Required. The list of YouTube video assets used by this ad.
           { # Details of a YouTube video.
             "id": "A String", # Output only. The YouTube video ID which can be searched on YouTube webpage.
@@ -2214,7 +2214,7 @@ 
Method Details

 
 

     patch(advertiserId, adGroupAdId, body=None, updateMask=None, x__xgafv=None)
-  
Updates an ad group ad. This method is only supported for Demand Gen ads.
+  
Updates an ad group ad.
 
 Args:
   advertiserId: string, Output only. The unique ID of the advertiser the ad belongs to. (required)
@@ -2222,7 +2222,7 @@ 
Method Details

   body: object, The request body.
     The object takes the form of:
 
-{ # LINT: LEGACY_NAMES A single ad associated with an ad group.
+{ # A single ad associated with an ad group.
   "adGroupAdId": "A String", # Output only. The unique ID of the ad. Assigned by the system.
   "adGroupId": "A String", # Required. Immutable. The unique ID of the ad group that the ad belongs to.
   "adPolicy": { # A single ad policy associated with an ad group ad. # Output only. The policy approval status of the ad.
@@ -2368,7 +2368,7 @@ 
Method Details

   "audioAd": { # Details for an audio ad. # Output only. Details of an [audio ad](//support.google.com/displayvideo/answer/6274216) used for reach marketing objectives.
     "displayUrl": "A String", # The webpage address that appears with the ad.
     "finalUrl": "A String", # The URL address of the webpage that people reach after they click the ad.
-    "trackingUrl": "A String", # The URL address loaded in the background for tracking purposes.
+    "trackingUrl": "A String", # The URL address loaded in the background for tracking purposes. In v4 and earlier, this field represents the tracking URL specified by the user manually. This can be found at userSpecifiedTrackingUrl in v5.
     "video": { # Details of a YouTube video. # The YouTube video of the ad.
       "id": "A String", # Output only. The YouTube video ID which can be searched on YouTube webpage.
       "unavailableReason": "A String", # Output only. The reason why the video data is not available.
@@ -2377,7 +2377,7 @@ 
Method Details

   },
   "bumperAd": { # Details for a bumper ad. # Optional. Details of a [non-skippable short video ad](//support.google.com/displayvideo/answer/6274216), equal to or less than 6 seconds, used for reach.
     "commonInStreamAttribute": { # Common attributes for in-stream, non-skippable and bumper ads. # Required. Common ad attributes.
-      "actionButtonLabel": "A String", # Optional. The text on the call-to-action button.
+      "actionButtonLabel": "A String", # Optional. The text on the call-to-action button. Must be set if actionHeadline is set.
       "actionHeadline": "A String", # Optional. The headline of the call-to-action banner.
       "companionBanner": { # Meta data of an image asset. # Optional. The image which shows next to the video ad.
         "assetId": "A String", # Required. The unique ID of the asset.
@@ -2390,7 +2390,7 @@ 
Method Details

       },
       "displayUrl": "A String", # Required. The webpage address that appears with the ad.
       "finalUrl": "A String", # Required. The URL address of the webpage that people reach after they click the ad.
-      "trackingUrl": "A String", # Output only. The URL address loaded in the background for tracking purposes.
+      "trackingUrl": "A String", # Output only. The URL address loaded in the background for tracking purposes. In v4 and earlier, this field represents the tracking URL specified by the user manually. This can be found at userSpecifiedTrackingUrl in v5.
       "video": { # Details of a YouTube video. # Required. Immutable. The YouTube video of the ad.
         "id": "A String", # Output only. The YouTube video ID which can be searched on YouTube webpage.
         "unavailableReason": "A String", # Output only. The reason why the video data is not available.
@@ -2398,7 +2398,7 @@ 
Method Details

       },
     },
   },
-  "dcmTrackingInfo": { # Details on the DCM tracking. # Optional. The DCM tracking ad info. Only valid for Demand Gen ads. To remove the DCM tracking ad info, please leave this field empty.
+  "dcmTrackingInfo": { # Details on the DCM tracking. # Optional. The DCM tracking ad info. To remove the DCM tracking ad info, please leave this field empty.
     "creativeId": "A String", # Required. The DCM creative id.
     "placementId": "A String", # Required. The DCM placement id.
     "trackingAdId": "A String", # Required. The DCM tracking ad id.
@@ -2600,7 +2600,7 @@ 
Method Details

   "entityStatus": "A String", # Required. The entity status of the ad.
   "inStreamAd": { # Details for an in-stream ad. # Optional. Details of an [in-stream ad skippable after 5 seconds](//support.google.com/displayvideo/answer/6274216), used for brand awareness or reach marketing objectives.
     "commonInStreamAttribute": { # Common attributes for in-stream, non-skippable and bumper ads. # Required. Common ad attributes.
-      "actionButtonLabel": "A String", # Optional. The text on the call-to-action button.
+      "actionButtonLabel": "A String", # Optional. The text on the call-to-action button. Must be set if actionHeadline is set.
       "actionHeadline": "A String", # Optional. The headline of the call-to-action banner.
       "companionBanner": { # Meta data of an image asset. # Optional. The image which shows next to the video ad.
         "assetId": "A String", # Required. The unique ID of the asset.
@@ -2613,7 +2613,7 @@ 
Method Details

       },
       "displayUrl": "A String", # Required. The webpage address that appears with the ad.
       "finalUrl": "A String", # Required. The URL address of the webpage that people reach after they click the ad.
-      "trackingUrl": "A String", # Output only. The URL address loaded in the background for tracking purposes.
+      "trackingUrl": "A String", # Output only. The URL address loaded in the background for tracking purposes. In v4 and earlier, this field represents the tracking URL specified by the user manually. This can be found at userSpecifiedTrackingUrl in v5.
       "video": { # Details of a YouTube video. # Required. Immutable. The YouTube video of the ad.
         "id": "A String", # Output only. The YouTube video ID which can be searched on YouTube webpage.
         "unavailableReason": "A String", # Output only. The reason why the video data is not available.
@@ -2650,7 +2650,7 @@ 
Method Details

   "name": "A String", # Output only. The resource name of the ad.
   "nonSkippableAd": { # Details for a non-skippable ad. # Optional. Details of a [non-skippable short in-stream video ad](//support.google.com/displayvideo/answer/6274216), between 6 and 15 seconds, used for reach marketing objectives.
     "commonInStreamAttribute": { # Common attributes for in-stream, non-skippable and bumper ads. # Required. Common ad attributes.
-      "actionButtonLabel": "A String", # Optional. The text on the call-to-action button.
+      "actionButtonLabel": "A String", # Optional. The text on the call-to-action button. Must be set if actionHeadline is set.
       "actionHeadline": "A String", # Optional. The headline of the call-to-action banner.
       "companionBanner": { # Meta data of an image asset. # Optional. The image which shows next to the video ad.
         "assetId": "A String", # Required. The unique ID of the asset.
@@ -2663,7 +2663,7 @@ 
Method Details

       },
       "displayUrl": "A String", # Required. The webpage address that appears with the ad.
       "finalUrl": "A String", # Required. The URL address of the webpage that people reach after they click the ad.
-      "trackingUrl": "A String", # Output only. The URL address loaded in the background for tracking purposes.
+      "trackingUrl": "A String", # Output only. The URL address loaded in the background for tracking purposes. In v4 and earlier, this field represents the tracking URL specified by the user manually. This can be found at userSpecifiedTrackingUrl in v5.
       "video": { # Details of a YouTube video. # Required. Immutable. The YouTube video of the ad.
         "id": "A String", # Output only. The YouTube video ID which can be searched on YouTube webpage.
         "unavailableReason": "A String", # Output only. The reason why the video data is not available.
@@ -2686,7 +2686,7 @@ 
Method Details

     },
   },
   "videoPerformanceAd": { # Details for a video performance ad. # Optional. Details of an [ad used in a video action campaign](//support.google.com/google-ads/answer/10147229) to drive actions to the business, service or product.
-    "actionButtonLabels": [ # Optional. The list of text assets shown on the call-to-action button.
+    "actionButtonLabels": [ # Optional. The list of text assets shown on the call-to-action button. Must be set if headlines is set.
       "A String",
     ],
     "companionBanners": [ # Optional. The list of companion banners used by this ad.
@@ -2703,20 +2703,20 @@ 
Method Details

     "customParameters": { # Optional. The custom parameters and accompanying values to add to the tracking URL.
       "a_key": "A String",
     },
-    "descriptions": [ # Optional. The list of descriptions shown on the call-to-action banner.
+    "descriptions": [ # Optional. The list of descriptions shown on the call-to-action banner. Must be set unless the parent line item's lineItemType is `LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_NON_SKIPPABLE`, in which case this field cannot be set.
       "A String",
     ],
     "displayUrlBreadcrumb1": "A String", # Optional. The first piece after the domain in the display URL.
-    "displayUrlBreadcrumb2": "A String", # Optional. The second piece after the domain in the display URL.
+    "displayUrlBreadcrumb2": "A String", # Optional. The second piece after the domain in the display URL. Can only be set if displayUrlBreadcrumb1 is also set.
     "domain": "A String", # Output only. The domain of the display URL.
     "finalUrl": "A String", # Required. The URL address of the webpage that people reach after they click the ad.
     "headlines": [ # Optional. The list of headlines shown on the call-to-action banner.
       "A String",
     ],
-    "longHeadlines": [ # Optional. The list of long headlines shown on the call-to-action banner.
+    "longHeadlines": [ # Optional. The list of long headlines shown on the call-to-action banner. Must be set unless the parent line item's lineItemType is `LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_NON_SKIPPABLE`, in which case this field cannot be set.
       "A String",
     ],
-    "trackingUrl": "A String", # Output only. The URL address loaded in the background for tracking purposes.
+    "trackingUrl": "A String", # Output only. The URL address loaded in the background for tracking purposes. In v4 and earlier, this field represents the tracking URL specified by the user manually. This can be found at userSpecifiedTrackingUrl in v5.
     "videos": [ # Required. The list of YouTube video assets used by this ad.
       { # Details of a YouTube video.
         "id": "A String", # Output only. The YouTube video ID which can be searched on YouTube webpage.
@@ -2736,7 +2736,7 @@ 
Method Details

 Returns:
   An object of the form:
 
-    { # LINT: LEGACY_NAMES A single ad associated with an ad group.
+    { # A single ad associated with an ad group.
   "adGroupAdId": "A String", # Output only. The unique ID of the ad. Assigned by the system.
   "adGroupId": "A String", # Required. Immutable. The unique ID of the ad group that the ad belongs to.
   "adPolicy": { # A single ad policy associated with an ad group ad. # Output only. The policy approval status of the ad.
@@ -2882,7 +2882,7 @@ 
Method Details

   "audioAd": { # Details for an audio ad. # Output only. Details of an [audio ad](//support.google.com/displayvideo/answer/6274216) used for reach marketing objectives.
     "displayUrl": "A String", # The webpage address that appears with the ad.
     "finalUrl": "A String", # The URL address of the webpage that people reach after they click the ad.
-    "trackingUrl": "A String", # The URL address loaded in the background for tracking purposes.
+    "trackingUrl": "A String", # The URL address loaded in the background for tracking purposes. In v4 and earlier, this field represents the tracking URL specified by the user manually. This can be found at userSpecifiedTrackingUrl in v5.
     "video": { # Details of a YouTube video. # The YouTube video of the ad.
       "id": "A String", # Output only. The YouTube video ID which can be searched on YouTube webpage.
       "unavailableReason": "A String", # Output only. The reason why the video data is not available.
@@ -2891,7 +2891,7 @@ 
Method Details

   },
   "bumperAd": { # Details for a bumper ad. # Optional. Details of a [non-skippable short video ad](//support.google.com/displayvideo/answer/6274216), equal to or less than 6 seconds, used for reach.
     "commonInStreamAttribute": { # Common attributes for in-stream, non-skippable and bumper ads. # Required. Common ad attributes.
-      "actionButtonLabel": "A String", # Optional. The text on the call-to-action button.
+      "actionButtonLabel": "A String", # Optional. The text on the call-to-action button. Must be set if actionHeadline is set.
       "actionHeadline": "A String", # Optional. The headline of the call-to-action banner.
       "companionBanner": { # Meta data of an image asset. # Optional. The image which shows next to the video ad.
         "assetId": "A String", # Required. The unique ID of the asset.
@@ -2904,7 +2904,7 @@ 
Method Details

       },
       "displayUrl": "A String", # Required. The webpage address that appears with the ad.
       "finalUrl": "A String", # Required. The URL address of the webpage that people reach after they click the ad.
-      "trackingUrl": "A String", # Output only. The URL address loaded in the background for tracking purposes.
+      "trackingUrl": "A String", # Output only. The URL address loaded in the background for tracking purposes. In v4 and earlier, this field represents the tracking URL specified by the user manually. This can be found at userSpecifiedTrackingUrl in v5.
       "video": { # Details of a YouTube video. # Required. Immutable. The YouTube video of the ad.
         "id": "A String", # Output only. The YouTube video ID which can be searched on YouTube webpage.
         "unavailableReason": "A String", # Output only. The reason why the video data is not available.
@@ -2912,7 +2912,7 @@ 
Method Details

       },
     },
   },
-  "dcmTrackingInfo": { # Details on the DCM tracking. # Optional. The DCM tracking ad info. Only valid for Demand Gen ads. To remove the DCM tracking ad info, please leave this field empty.
+  "dcmTrackingInfo": { # Details on the DCM tracking. # Optional. The DCM tracking ad info. To remove the DCM tracking ad info, please leave this field empty.
     "creativeId": "A String", # Required. The DCM creative id.
     "placementId": "A String", # Required. The DCM placement id.
     "trackingAdId": "A String", # Required. The DCM tracking ad id.
@@ -3114,7 +3114,7 @@ 
Method Details

   "entityStatus": "A String", # Required. The entity status of the ad.
   "inStreamAd": { # Details for an in-stream ad. # Optional. Details of an [in-stream ad skippable after 5 seconds](//support.google.com/displayvideo/answer/6274216), used for brand awareness or reach marketing objectives.
     "commonInStreamAttribute": { # Common attributes for in-stream, non-skippable and bumper ads. # Required. Common ad attributes.
-      "actionButtonLabel": "A String", # Optional. The text on the call-to-action button.
+      "actionButtonLabel": "A String", # Optional. The text on the call-to-action button. Must be set if actionHeadline is set.
       "actionHeadline": "A String", # Optional. The headline of the call-to-action banner.
       "companionBanner": { # Meta data of an image asset. # Optional. The image which shows next to the video ad.
         "assetId": "A String", # Required. The unique ID of the asset.
@@ -3127,7 +3127,7 @@ 
Method Details

       },
       "displayUrl": "A String", # Required. The webpage address that appears with the ad.
       "finalUrl": "A String", # Required. The URL address of the webpage that people reach after they click the ad.
-      "trackingUrl": "A String", # Output only. The URL address loaded in the background for tracking purposes.
+      "trackingUrl": "A String", # Output only. The URL address loaded in the background for tracking purposes. In v4 and earlier, this field represents the tracking URL specified by the user manually. This can be found at userSpecifiedTrackingUrl in v5.
       "video": { # Details of a YouTube video. # Required. Immutable. The YouTube video of the ad.
         "id": "A String", # Output only. The YouTube video ID which can be searched on YouTube webpage.
         "unavailableReason": "A String", # Output only. The reason why the video data is not available.
@@ -3164,7 +3164,7 @@ 
Method Details

   "name": "A String", # Output only. The resource name of the ad.
   "nonSkippableAd": { # Details for a non-skippable ad. # Optional. Details of a [non-skippable short in-stream video ad](//support.google.com/displayvideo/answer/6274216), between 6 and 15 seconds, used for reach marketing objectives.
     "commonInStreamAttribute": { # Common attributes for in-stream, non-skippable and bumper ads. # Required. Common ad attributes.
-      "actionButtonLabel": "A String", # Optional. The text on the call-to-action button.
+      "actionButtonLabel": "A String", # Optional. The text on the call-to-action button. Must be set if actionHeadline is set.
       "actionHeadline": "A String", # Optional. The headline of the call-to-action banner.
       "companionBanner": { # Meta data of an image asset. # Optional. The image which shows next to the video ad.
         "assetId": "A String", # Required. The unique ID of the asset.
@@ -3177,7 +3177,7 @@ 
Method Details

       },
       "displayUrl": "A String", # Required. The webpage address that appears with the ad.
       "finalUrl": "A String", # Required. The URL address of the webpage that people reach after they click the ad.
-      "trackingUrl": "A String", # Output only. The URL address loaded in the background for tracking purposes.
+      "trackingUrl": "A String", # Output only. The URL address loaded in the background for tracking purposes. In v4 and earlier, this field represents the tracking URL specified by the user manually. This can be found at userSpecifiedTrackingUrl in v5.
       "video": { # Details of a YouTube video. # Required. Immutable. The YouTube video of the ad.
         "id": "A String", # Output only. The YouTube video ID which can be searched on YouTube webpage.
         "unavailableReason": "A String", # Output only. The reason why the video data is not available.
@@ -3200,7 +3200,7 @@ 
Method Details

     },
   },
   "videoPerformanceAd": { # Details for a video performance ad. # Optional. Details of an [ad used in a video action campaign](//support.google.com/google-ads/answer/10147229) to drive actions to the business, service or product.
-    "actionButtonLabels": [ # Optional. The list of text assets shown on the call-to-action button.
+    "actionButtonLabels": [ # Optional. The list of text assets shown on the call-to-action button. Must be set if headlines is set.
       "A String",
     ],
     "companionBanners": [ # Optional. The list of companion banners used by this ad.
@@ -3217,20 +3217,20 @@ 
Method Details

     "customParameters": { # Optional. The custom parameters and accompanying values to add to the tracking URL.
       "a_key": "A String",
     },
-    "descriptions": [ # Optional. The list of descriptions shown on the call-to-action banner.
+    "descriptions": [ # Optional. The list of descriptions shown on the call-to-action banner. Must be set unless the parent line item's lineItemType is `LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_NON_SKIPPABLE`, in which case this field cannot be set.
       "A String",
     ],
     "displayUrlBreadcrumb1": "A String", # Optional. The first piece after the domain in the display URL.
-    "displayUrlBreadcrumb2": "A String", # Optional. The second piece after the domain in the display URL.
+    "displayUrlBreadcrumb2": "A String", # Optional. The second piece after the domain in the display URL. Can only be set if displayUrlBreadcrumb1 is also set.
     "domain": "A String", # Output only. The domain of the display URL.
     "finalUrl": "A String", # Required. The URL address of the webpage that people reach after they click the ad.
     "headlines": [ # Optional. The list of headlines shown on the call-to-action banner.
       "A String",
     ],
-    "longHeadlines": [ # Optional. The list of long headlines shown on the call-to-action banner.
+    "longHeadlines": [ # Optional. The list of long headlines shown on the call-to-action banner. Must be set unless the parent line item's lineItemType is `LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_NON_SKIPPABLE`, in which case this field cannot be set.
       "A String",
     ],
-    "trackingUrl": "A String", # Output only. The URL address loaded in the background for tracking purposes.
+    "trackingUrl": "A String", # Output only. The URL address loaded in the background for tracking purposes. In v4 and earlier, this field represents the tracking URL specified by the user manually. This can be found at userSpecifiedTrackingUrl in v5.
     "videos": [ # Required. The list of YouTube video assets used by this ad.
       { # Details of a YouTube video.
         "id": "A String", # Output only. The YouTube video ID which can be searched on YouTube webpage.
diff --git a/docs/dyn/displayvideo_v4.advertisers.adGroups.html b/docs/dyn/displayvideo_v4.advertisers.adGroups.html
index c228c02877..6601e66582 100644
--- a/docs/dyn/displayvideo_v4.advertisers.adGroups.html
+++ b/docs/dyn/displayvideo_v4.advertisers.adGroups.html
@@ -895,7 +895,7 @@ 
Method Details

   body: object, The request body.
     The object takes the form of:
 
-{ # A single ad group associated with a line item.
+{ # LINT: LEGACY_NAMES A single ad group associated with a line item.
   "adGroupFormat": "A String", # Required. Immutable. The format of the ads in the ad group.
   "adGroupId": "A String", # Output only. The unique ID of the ad group. Assigned by the system.
   "adGroupInventoryControl": { # The inventory control of the ad group. # Optional. Required for Demand Gen ad groups. Specifies the inventory control of the ad group.
@@ -972,7 +972,7 @@ 
Method Details

 Returns:
   An object of the form:
 
-    { # A single ad group associated with a line item.
+    { # LINT: LEGACY_NAMES A single ad group associated with a line item.
   "adGroupFormat": "A String", # Required. Immutable. The format of the ads in the ad group.
   "adGroupId": "A String", # Output only. The unique ID of the ad group. Assigned by the system.
   "adGroupInventoryControl": { # The inventory control of the ad group. # Optional. Required for Demand Gen ad groups. Specifies the inventory control of the ad group.
@@ -1076,7 +1076,7 @@ 
Method Details

 Returns:
   An object of the form:
 
-    { # A single ad group associated with a line item.
+    { # LINT: LEGACY_NAMES A single ad group associated with a line item.
   "adGroupFormat": "A String", # Required. Immutable. The format of the ads in the ad group.
   "adGroupId": "A String", # Output only. The unique ID of the ad group. Assigned by the system.
   "adGroupInventoryControl": { # The inventory control of the ad group. # Optional. Required for Demand Gen ad groups. Specifies the inventory control of the ad group.
@@ -1166,7 +1166,7 @@ 
Method Details

 
     {
   "adGroups": [ # The list of ad groups. This list will be absent if empty.
-    { # A single ad group associated with a line item.
+    { # LINT: LEGACY_NAMES A single ad group associated with a line item.
       "adGroupFormat": "A String", # Required. Immutable. The format of the ads in the ad group.
       "adGroupId": "A String", # Output only. The unique ID of the ad group. Assigned by the system.
       "adGroupInventoryControl": { # The inventory control of the ad group. # Optional. Required for Demand Gen ad groups. Specifies the inventory control of the ad group.
@@ -1263,7 +1263,7 @@ 
Method Details

   body: object, The request body.
     The object takes the form of:
 
-{ # A single ad group associated with a line item.
+{ # LINT: LEGACY_NAMES A single ad group associated with a line item.
   "adGroupFormat": "A String", # Required. Immutable. The format of the ads in the ad group.
   "adGroupId": "A String", # Output only. The unique ID of the ad group. Assigned by the system.
   "adGroupInventoryControl": { # The inventory control of the ad group. # Optional. Required for Demand Gen ad groups. Specifies the inventory control of the ad group.
@@ -1341,7 +1341,7 @@ 
Method Details

 Returns:
   An object of the form:
 
-    { # A single ad group associated with a line item.
+    { # LINT: LEGACY_NAMES A single ad group associated with a line item.
   "adGroupFormat": "A String", # Required. Immutable. The format of the ads in the ad group.
   "adGroupId": "A String", # Output only. The unique ID of the ad group. Assigned by the system.
   "adGroupInventoryControl": { # The inventory control of the ad group. # Optional. Required for Demand Gen ad groups. Specifies the inventory control of the ad group.
diff --git a/docs/dyn/dns_v1.outboundEndpoints.html b/docs/dyn/dns_v1.outboundEndpoints.html
index 1c92da74cd..b4ded49817 100644
--- a/docs/dyn/dns_v1.outboundEndpoints.html
+++ b/docs/dyn/dns_v1.outboundEndpoints.html
@@ -116,7 +116,7 @@ 
Method Details

   },
   "createTime": "A String", # Output only. [Output only] Create time stamp
   "description": "A String", # Optional. User provided description.
-  "endpointIp": "A String", # Required. Immutable. User provided IP address to use for outbound DNS forwarding. This address must be a free address on the subnetwork.
+  "endpointIp": "A String", # Optional. Immutable. User provided IP address to use for outbound DNS forwarding. This address must be a free address on the subnetwork. If omitted, a free IP address from the subnetwork is automatically allocated.
   "labels": { # Optional. Labels as key value pairs
     "a_key": "A String",
   },
@@ -219,7 +219,7 @@ 
Method Details

   },
   "createTime": "A String", # Output only. [Output only] Create time stamp
   "description": "A String", # Optional. User provided description.
-  "endpointIp": "A String", # Required. Immutable. User provided IP address to use for outbound DNS forwarding. This address must be a free address on the subnetwork.
+  "endpointIp": "A String", # Optional. Immutable. User provided IP address to use for outbound DNS forwarding. This address must be a free address on the subnetwork. If omitted, a free IP address from the subnetwork is automatically allocated.
   "labels": { # Optional. Labels as key value pairs
     "a_key": "A String",
   },
@@ -259,7 +259,7 @@ 
Method Details

       },
       "createTime": "A String", # Output only. [Output only] Create time stamp
       "description": "A String", # Optional. User provided description.
-      "endpointIp": "A String", # Required. Immutable. User provided IP address to use for outbound DNS forwarding. This address must be a free address on the subnetwork.
+      "endpointIp": "A String", # Optional. Immutable. User provided IP address to use for outbound DNS forwarding. This address must be a free address on the subnetwork. If omitted, a free IP address from the subnetwork is automatically allocated.
       "labels": { # Optional. Labels as key value pairs
         "a_key": "A String",
       },
@@ -307,7 +307,7 @@ 
Method Details

   },
   "createTime": "A String", # Output only. [Output only] Create time stamp
   "description": "A String", # Optional. User provided description.
-  "endpointIp": "A String", # Required. Immutable. User provided IP address to use for outbound DNS forwarding. This address must be a free address on the subnetwork.
+  "endpointIp": "A String", # Optional. Immutable. User provided IP address to use for outbound DNS forwarding. This address must be a free address on the subnetwork. If omitted, a free IP address from the subnetwork is automatically allocated.
   "labels": { # Optional. Labels as key value pairs
     "a_key": "A String",
   },
diff --git a/docs/dyn/dns_v1beta2.outboundEndpoints.html b/docs/dyn/dns_v1beta2.outboundEndpoints.html
index 4324275bbc..5e68beb11b 100644
--- a/docs/dyn/dns_v1beta2.outboundEndpoints.html
+++ b/docs/dyn/dns_v1beta2.outboundEndpoints.html
@@ -116,7 +116,7 @@ 
Method Details

   },
   "createTime": "A String", # Output only. [Output only] Create time stamp
   "description": "A String", # Optional. User provided description.
-  "endpointIp": "A String", # Required. Immutable. User provided IP address to use for outbound DNS forwarding. This address must be a free address on the subnetwork.
+  "endpointIp": "A String", # Optional. Immutable. User provided IP address to use for outbound DNS forwarding. This address must be a free address on the subnetwork. If omitted, a free IP address from the subnetwork is automatically allocated.
   "labels": { # Optional. Labels as key value pairs
     "a_key": "A String",
   },
@@ -219,7 +219,7 @@ 
Method Details

   },
   "createTime": "A String", # Output only. [Output only] Create time stamp
   "description": "A String", # Optional. User provided description.
-  "endpointIp": "A String", # Required. Immutable. User provided IP address to use for outbound DNS forwarding. This address must be a free address on the subnetwork.
+  "endpointIp": "A String", # Optional. Immutable. User provided IP address to use for outbound DNS forwarding. This address must be a free address on the subnetwork. If omitted, a free IP address from the subnetwork is automatically allocated.
   "labels": { # Optional. Labels as key value pairs
     "a_key": "A String",
   },
@@ -259,7 +259,7 @@ 
Method Details

       },
       "createTime": "A String", # Output only. [Output only] Create time stamp
       "description": "A String", # Optional. User provided description.
-      "endpointIp": "A String", # Required. Immutable. User provided IP address to use for outbound DNS forwarding. This address must be a free address on the subnetwork.
+      "endpointIp": "A String", # Optional. Immutable. User provided IP address to use for outbound DNS forwarding. This address must be a free address on the subnetwork. If omitted, a free IP address from the subnetwork is automatically allocated.
       "labels": { # Optional. Labels as key value pairs
         "a_key": "A String",
       },
@@ -307,7 +307,7 @@ 
Method Details

   },
   "createTime": "A String", # Output only. [Output only] Create time stamp
   "description": "A String", # Optional. User provided description.
-  "endpointIp": "A String", # Required. Immutable. User provided IP address to use for outbound DNS forwarding. This address must be a free address on the subnetwork.
+  "endpointIp": "A String", # Optional. Immutable. User provided IP address to use for outbound DNS forwarding. This address must be a free address on the subnetwork. If omitted, a free IP address from the subnetwork is automatically allocated.
   "labels": { # Optional. Labels as key value pairs
     "a_key": "A String",
   },
diff --git a/docs/dyn/firebaseml_v2beta.projects.locations.publishers.models.html b/docs/dyn/firebaseml_v2beta.projects.locations.publishers.models.html
index f1064f4d3d..4a6d1bea1b 100644
--- a/docs/dyn/firebaseml_v2beta.projects.locations.publishers.models.html
+++ b/docs/dyn/firebaseml_v2beta.projects.locations.publishers.models.html
@@ -105,7 +105,7 @@ 
Method Details

   "contents": [ # Optional. Input content.
     { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message.
       "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part.
-        { # 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`. For media types that are not text, `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.
+        { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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.
           "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data.
             "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set.
             "text": "A String", # Required. The transcription text of this audio segment.
@@ -374,7 +374,7 @@ 
Method Details

   "model": "A String", # Optional. The name of the publisher model requested to serve the prediction. Format: `projects/{project}/locations/{location}/publishers/*/models/*`
   "systemInstruction": { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. # Optional. The user provided system instructions for the model. Note: only text should be used in parts and content in each part will be in a separate paragraph.
     "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part.
-      { # 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`. For media types that are not text, `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.
+      { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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.
         "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data.
           "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set.
           "text": "A String", # Required. The transcription text of this audio segment.
@@ -744,7 +744,7 @@ 
Method Details

   "contents": [ # Required. The content of the current conversation with the model. For single-turn queries, this is a single instance. For multi-turn queries, this is a repeated field that contains conversation history + latest request.
     { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message.
       "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part.
-        { # 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`. For media types that are not text, `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.
+        { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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.
           "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data.
             "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set.
             "text": "A String", # Required. The transcription text of this audio segment.
@@ -1024,7 +1024,7 @@ 
Method Details

   ],
   "systemInstruction": { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. # Optional. The user provided system instructions for the model. Note: only text should be used in parts and content in each part will be in a separate paragraph.
     "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part.
-      { # 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`. For media types that are not text, `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.
+      { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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.
         "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data.
           "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set.
           "text": "A String", # Required. The transcription text of this audio segment.
@@ -1406,7 +1406,7 @@ 
Method Details

       },
       "content": { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. # Output only. The content of the candidate.
         "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part.
-          { # 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`. For media types that are not text, `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.
+          { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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.
             "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data.
               "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set.
               "text": "A String", # Required. The transcription text of this audio segment.
@@ -1705,7 +1705,7 @@ 
Method Details

   "contents": [ # Required. The content of the current conversation with the model. For single-turn queries, this is a single instance. For multi-turn queries, this is a repeated field that contains conversation history + latest request.
     { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message.
       "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part.
-        { # 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`. For media types that are not text, `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.
+        { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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.
           "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data.
             "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set.
             "text": "A String", # Required. The transcription text of this audio segment.
@@ -1985,7 +1985,7 @@ 
Method Details

   ],
   "systemInstruction": { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. # Optional. The user provided system instructions for the model. Note: only text should be used in parts and content in each part will be in a separate paragraph.
     "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part.
-      { # 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`. For media types that are not text, `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.
+      { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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.
         "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data.
           "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set.
           "text": "A String", # Required. The transcription text of this audio segment.
@@ -2367,7 +2367,7 @@ 
Method Details

       },
       "content": { # The structured data content of a message. A Content message contains a `role` field, which indicates the producer of the content, and a `parts` field, which contains the multi-part data of the message. # Output only. The content of the candidate.
         "parts": [ # Required. A list of Part objects that make up a single message. Parts of a message can have different MIME types. A Content message must have at least one Part.
-          { # 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`. For media types that are not text, `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.
+          { # 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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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.
             "audioTranscription": { # The transcription of an audio part. For multi-speaker audio, each speaker segment is a separate `Part` with its own `AudioTranscription` carrying the `speaker_label`. # Optional. Audio (input or output) transcription. This is only set when this `Part` contains audio data.
               "speakerLabel": "A String", # Optional. A label identifying the speaker of this audio segment (e.g. `spk_1`, `spk_2`). Present when `diarization` is set.
               "text": "A String", # Required. The transcription text of this audio segment.
diff --git a/docs/dyn/gkehub_v1.projects.locations.features.html b/docs/dyn/gkehub_v1.projects.locations.features.html
index 0318e9ea1e..3305cfc09a 100644
--- a/docs/dyn/gkehub_v1.projects.locations.features.html
+++ b/docs/dyn/gkehub_v1.projects.locations.features.html
@@ -143,25 +143,25 @@ 
Method Details

         ],
         "enabled": True or False, # Optional. Enables the installation of Config Sync. If set to true, the Feature will manage Config Sync resources, and apply the other ConfigSync fields if they exist. If set to false, the Feature will ignore all other ConfigSync fields and delete the Config Sync resources. If omitted, ConfigSync is considered enabled if the git or oci field is present.
         "git": { # Git repo configuration for a single cluster. # Optional. Git repo configuration for the cluster.
-          "gcpServiceAccountEmail": "A String", # Optional. The Google Cloud Service Account Email used for auth when secret_type is `gcpserviceaccount`.
-          "httpsProxy": "A String", # Optional. URL for the HTTPS proxy to be used when communicating with the Git repo. Only specify when secret_type is `cookiefile`, `token`, or `none`.
+          "gcpServiceAccountEmail": "A String", # Optional. The Google Cloud Service Account Email used for auth when secret_type is `gcpserviceaccount`. Annotates the `RootSync` or `RepoSync` controller's Kubernetes Service Account.
+          "httpsProxy": "A String", # Optional. URL for the HTTPS proxy to be used when communicating with the Git repo. Defines an HTTPS_PROXY environment variable and only accepts `https` or unadorned URLs. For example, `https://proxy.internal.business.co:443` or `proxy.internal.business.co:443`. If using an unadorned URL, make sure the communication between your proxy server and Git host is secure. Rejects `http://` URLs. Only specify when secret_type is `cookiefile`, `token`, or `none`.
           "policyDir": "A String", # Optional. The path within the Git repository that represents the top level of the repo to sync. Default: the root directory of the repository.
           "secretType": "A String", # Required. Type of secret configured for access to the Git repo. Must be one of `ssh`, `cookiefile`, `gcenode`, `token`, `gcpserviceaccount`, `githubapp` or `none`. The validation of this is case-sensitive.
           "syncBranch": "A String", # Optional. The branch of the repository to sync from. Default: master.
           "syncRepo": "A String", # Required. The URL of the Git repository to use as the source of truth.
-          "syncRev": "A String", # Optional. Git revision (tag or hash) to check out. Default HEAD.
+          "syncRev": "A String", # Optional. Git revision (tag or hash) or branch to sync from. Default `HEAD`. If not `HEAD`, takes precedence over `sync_branch` field. When using a hash, must be a full hash, and not an abbreviated form.
           "syncWaitSecs": "A String", # Optional. Period in seconds between consecutive syncs. Default: 15.
         },
         "metricsGcpServiceAccountEmail": "A String", # Optional. The Email of the Google Cloud Service Account (GSA) used for exporting Config Sync metrics to Cloud Monitoring and Cloud Monarch when Workload Identity is enabled. The GSA should have the Monitoring Metric Writer (roles/monitoring.metricWriter) IAM role. The Kubernetes ServiceAccount `default` in the namespace `config-management-monitoring` should be bound to the GSA. Deprecated: If Workload Identity Federation for GKE is enabled, Google Cloud Service Account is no longer needed for exporting Config Sync metrics: https://cloud.google.com/kubernetes-engine/enterprise/config-sync/docs/how-to/monitor-config-sync-cloud-monitoring#custom-monitoring.
         "oci": { # OCI repo configuration for a single cluster # Optional. OCI repo configuration for the cluster
-          "gcpServiceAccountEmail": "A String", # Optional. The Google Cloud Service Account Email used for auth when secret_type is `gcpserviceaccount`.
+          "gcpServiceAccountEmail": "A String", # Optional. The Google Cloud Service Account Email used for auth when secret_type is `gcpserviceaccount`. Annotates the `RootSync` or `RepoSync` controller's Kubernetes Service Account.
           "policyDir": "A String", # Optional. The absolute path of the directory that contains the local resources. Default: the root directory of the image.
           "secretType": "A String", # Required. Type of secret configured for access to the OCI repo. Must be one of `gcenode`, `gcpserviceaccount`, `k8sserviceaccount` or `none`. The validation of this is case-sensitive.
           "syncRepo": "A String", # Required. The OCI image repository URL for the package to sync from. e.g. `LOCATION-docker.pkg.dev/PROJECT_ID/REPOSITORY_NAME/PACKAGE_NAME`.
           "syncWaitSecs": "A String", # Optional. Period in seconds between consecutive syncs. Default: 15.
         },
         "preventDrift": True or False, # Optional. Set to true to enable the Config Sync admission webhook to prevent drifts. If set to false, disables the Config Sync admission webhook and does not prevent drifts. Defaults to false. See https://docs.cloud.google.com/kubernetes-engine/config-sync/docs/how-to/prevent-config-drift for details.
-        "sourceFormat": "A String", # Optional. Specifies whether the Config Sync repo is in `hierarchical` or `unstructured` mode. Defaults to `hierarchical`. See https://docs.cloud.google.com/kubernetes-engine/config-sync/docs/concepts/configs#organize-configs for an explanation.
+        "sourceFormat": "A String", # Optional. Specifies whether the Config Sync repo is in `hierarchy` or `unstructured` mode. Defaults to `hierarchy`. See https://docs.cloud.google.com/kubernetes-engine/config-sync/docs/concepts/configs#organize-configs for an explanation.
         "stopSyncing": True or False, # Optional. Set to true to stop syncing configs for a single cluster. Default to false.
       },
       "hierarchyController": { # Configuration for Hierarchy Controller # Optional. Hierarchy Controller configuration for the cluster. Deprecated: Configuring Hierarchy Controller through the configmanagement feature is no longer recommended. Use https://github.com/kubernetes-sigs/hierarchical-namespaces instead.
@@ -358,25 +358,25 @@ 
Method Details

           ],
           "enabled": True or False, # Optional. Enables the installation of Config Sync. If set to true, the Feature will manage Config Sync resources, and apply the other ConfigSync fields if they exist. If set to false, the Feature will ignore all other ConfigSync fields and delete the Config Sync resources. If omitted, ConfigSync is considered enabled if the git or oci field is present.
           "git": { # Git repo configuration for a single cluster. # Optional. Git repo configuration for the cluster.
-            "gcpServiceAccountEmail": "A String", # Optional. The Google Cloud Service Account Email used for auth when secret_type is `gcpserviceaccount`.
-            "httpsProxy": "A String", # Optional. URL for the HTTPS proxy to be used when communicating with the Git repo. Only specify when secret_type is `cookiefile`, `token`, or `none`.
+            "gcpServiceAccountEmail": "A String", # Optional. The Google Cloud Service Account Email used for auth when secret_type is `gcpserviceaccount`. Annotates the `RootSync` or `RepoSync` controller's Kubernetes Service Account.
+            "httpsProxy": "A String", # Optional. URL for the HTTPS proxy to be used when communicating with the Git repo. Defines an HTTPS_PROXY environment variable and only accepts `https` or unadorned URLs. For example, `https://proxy.internal.business.co:443` or `proxy.internal.business.co:443`. If using an unadorned URL, make sure the communication between your proxy server and Git host is secure. Rejects `http://` URLs. Only specify when secret_type is `cookiefile`, `token`, or `none`.
             "policyDir": "A String", # Optional. The path within the Git repository that represents the top level of the repo to sync. Default: the root directory of the repository.
             "secretType": "A String", # Required. Type of secret configured for access to the Git repo. Must be one of `ssh`, `cookiefile`, `gcenode`, `token`, `gcpserviceaccount`, `githubapp` or `none`. The validation of this is case-sensitive.
             "syncBranch": "A String", # Optional. The branch of the repository to sync from. Default: master.
             "syncRepo": "A String", # Required. The URL of the Git repository to use as the source of truth.
-            "syncRev": "A String", # Optional. Git revision (tag or hash) to check out. Default HEAD.
+            "syncRev": "A String", # Optional. Git revision (tag or hash) or branch to sync from. Default `HEAD`. If not `HEAD`, takes precedence over `sync_branch` field. When using a hash, must be a full hash, and not an abbreviated form.
             "syncWaitSecs": "A String", # Optional. Period in seconds between consecutive syncs. Default: 15.
           },
           "metricsGcpServiceAccountEmail": "A String", # Optional. The Email of the Google Cloud Service Account (GSA) used for exporting Config Sync metrics to Cloud Monitoring and Cloud Monarch when Workload Identity is enabled. The GSA should have the Monitoring Metric Writer (roles/monitoring.metricWriter) IAM role. The Kubernetes ServiceAccount `default` in the namespace `config-management-monitoring` should be bound to the GSA. Deprecated: If Workload Identity Federation for GKE is enabled, Google Cloud Service Account is no longer needed for exporting Config Sync metrics: https://cloud.google.com/kubernetes-engine/enterprise/config-sync/docs/how-to/monitor-config-sync-cloud-monitoring#custom-monitoring.
           "oci": { # OCI repo configuration for a single cluster # Optional. OCI repo configuration for the cluster
-            "gcpServiceAccountEmail": "A String", # Optional. The Google Cloud Service Account Email used for auth when secret_type is `gcpserviceaccount`.
+            "gcpServiceAccountEmail": "A String", # Optional. The Google Cloud Service Account Email used for auth when secret_type is `gcpserviceaccount`. Annotates the `RootSync` or `RepoSync` controller's Kubernetes Service Account.
             "policyDir": "A String", # Optional. The absolute path of the directory that contains the local resources. Default: the root directory of the image.
             "secretType": "A String", # Required. Type of secret configured for access to the OCI repo. Must be one of `gcenode`, `gcpserviceaccount`, `k8sserviceaccount` or `none`. The validation of this is case-sensitive.
             "syncRepo": "A String", # Required. The OCI image repository URL for the package to sync from. e.g. `LOCATION-docker.pkg.dev/PROJECT_ID/REPOSITORY_NAME/PACKAGE_NAME`.
             "syncWaitSecs": "A String", # Optional. Period in seconds between consecutive syncs. Default: 15.
           },
           "preventDrift": True or False, # Optional. Set to true to enable the Config Sync admission webhook to prevent drifts. If set to false, disables the Config Sync admission webhook and does not prevent drifts. Defaults to false. See https://docs.cloud.google.com/kubernetes-engine/config-sync/docs/how-to/prevent-config-drift for details.
-          "sourceFormat": "A String", # Optional. Specifies whether the Config Sync repo is in `hierarchical` or `unstructured` mode. Defaults to `hierarchical`. See https://docs.cloud.google.com/kubernetes-engine/config-sync/docs/concepts/configs#organize-configs for an explanation.
+          "sourceFormat": "A String", # Optional. Specifies whether the Config Sync repo is in `hierarchy` or `unstructured` mode. Defaults to `hierarchy`. See https://docs.cloud.google.com/kubernetes-engine/config-sync/docs/concepts/configs#organize-configs for an explanation.
           "stopSyncing": True or False, # Optional. Set to true to stop syncing configs for a single cluster. Default to false.
         },
         "hierarchyController": { # Configuration for Hierarchy Controller # Optional. Hierarchy Controller configuration for the cluster. Deprecated: Configuring Hierarchy Controller through the configmanagement feature is no longer recommended. Use https://github.com/kubernetes-sigs/hierarchical-namespaces instead.
@@ -674,25 +674,25 @@ 
Method Details

             ],
             "enabled": True or False, # Optional. Enables the installation of Config Sync. If set to true, the Feature will manage Config Sync resources, and apply the other ConfigSync fields if they exist. If set to false, the Feature will ignore all other ConfigSync fields and delete the Config Sync resources. If omitted, ConfigSync is considered enabled if the git or oci field is present.
             "git": { # Git repo configuration for a single cluster. # Optional. Git repo configuration for the cluster.
-              "gcpServiceAccountEmail": "A String", # Optional. The Google Cloud Service Account Email used for auth when secret_type is `gcpserviceaccount`.
-              "httpsProxy": "A String", # Optional. URL for the HTTPS proxy to be used when communicating with the Git repo. Only specify when secret_type is `cookiefile`, `token`, or `none`.
+              "gcpServiceAccountEmail": "A String", # Optional. The Google Cloud Service Account Email used for auth when secret_type is `gcpserviceaccount`. Annotates the `RootSync` or `RepoSync` controller's Kubernetes Service Account.
+              "httpsProxy": "A String", # Optional. URL for the HTTPS proxy to be used when communicating with the Git repo. Defines an HTTPS_PROXY environment variable and only accepts `https` or unadorned URLs. For example, `https://proxy.internal.business.co:443` or `proxy.internal.business.co:443`. If using an unadorned URL, make sure the communication between your proxy server and Git host is secure. Rejects `http://` URLs. Only specify when secret_type is `cookiefile`, `token`, or `none`.
               "policyDir": "A String", # Optional. The path within the Git repository that represents the top level of the repo to sync. Default: the root directory of the repository.
               "secretType": "A String", # Required. Type of secret configured for access to the Git repo. Must be one of `ssh`, `cookiefile`, `gcenode`, `token`, `gcpserviceaccount`, `githubapp` or `none`. The validation of this is case-sensitive.
               "syncBranch": "A String", # Optional. The branch of the repository to sync from. Default: master.
               "syncRepo": "A String", # Required. The URL of the Git repository to use as the source of truth.
-              "syncRev": "A String", # Optional. Git revision (tag or hash) to check out. Default HEAD.
+              "syncRev": "A String", # Optional. Git revision (tag or hash) or branch to sync from. Default `HEAD`. If not `HEAD`, takes precedence over `sync_branch` field. When using a hash, must be a full hash, and not an abbreviated form.
               "syncWaitSecs": "A String", # Optional. Period in seconds between consecutive syncs. Default: 15.
             },
             "metricsGcpServiceAccountEmail": "A String", # Optional. The Email of the Google Cloud Service Account (GSA) used for exporting Config Sync metrics to Cloud Monitoring and Cloud Monarch when Workload Identity is enabled. The GSA should have the Monitoring Metric Writer (roles/monitoring.metricWriter) IAM role. The Kubernetes ServiceAccount `default` in the namespace `config-management-monitoring` should be bound to the GSA. Deprecated: If Workload Identity Federation for GKE is enabled, Google Cloud Service Account is no longer needed for exporting Config Sync metrics: https://cloud.google.com/kubernetes-engine/enterprise/config-sync/docs/how-to/monitor-config-sync-cloud-monitoring#custom-monitoring.
             "oci": { # OCI repo configuration for a single cluster # Optional. OCI repo configuration for the cluster
-              "gcpServiceAccountEmail": "A String", # Optional. The Google Cloud Service Account Email used for auth when secret_type is `gcpserviceaccount`.
+              "gcpServiceAccountEmail": "A String", # Optional. The Google Cloud Service Account Email used for auth when secret_type is `gcpserviceaccount`. Annotates the `RootSync` or `RepoSync` controller's Kubernetes Service Account.
               "policyDir": "A String", # Optional. The absolute path of the directory that contains the local resources. Default: the root directory of the image.
               "secretType": "A String", # Required. Type of secret configured for access to the OCI repo. Must be one of `gcenode`, `gcpserviceaccount`, `k8sserviceaccount` or `none`. The validation of this is case-sensitive.
               "syncRepo": "A String", # Required. The OCI image repository URL for the package to sync from. e.g. `LOCATION-docker.pkg.dev/PROJECT_ID/REPOSITORY_NAME/PACKAGE_NAME`.
               "syncWaitSecs": "A String", # Optional. Period in seconds between consecutive syncs. Default: 15.
             },
             "preventDrift": True or False, # Optional. Set to true to enable the Config Sync admission webhook to prevent drifts. If set to false, disables the Config Sync admission webhook and does not prevent drifts. Defaults to false. See https://docs.cloud.google.com/kubernetes-engine/config-sync/docs/how-to/prevent-config-drift for details.
-            "sourceFormat": "A String", # Optional. Specifies whether the Config Sync repo is in `hierarchical` or `unstructured` mode. Defaults to `hierarchical`. See https://docs.cloud.google.com/kubernetes-engine/config-sync/docs/concepts/configs#organize-configs for an explanation.
+            "sourceFormat": "A String", # Optional. Specifies whether the Config Sync repo is in `hierarchy` or `unstructured` mode. Defaults to `hierarchy`. See https://docs.cloud.google.com/kubernetes-engine/config-sync/docs/concepts/configs#organize-configs for an explanation.
             "stopSyncing": True or False, # Optional. Set to true to stop syncing configs for a single cluster. Default to false.
           },
           "hierarchyController": { # Configuration for Hierarchy Controller # Optional. Hierarchy Controller configuration for the cluster. Deprecated: Configuring Hierarchy Controller through the configmanagement feature is no longer recommended. Use https://github.com/kubernetes-sigs/hierarchical-namespaces instead.
@@ -1198,25 +1198,25 @@ 
Method Details

         ],
         "enabled": True or False, # Optional. Enables the installation of Config Sync. If set to true, the Feature will manage Config Sync resources, and apply the other ConfigSync fields if they exist. If set to false, the Feature will ignore all other ConfigSync fields and delete the Config Sync resources. If omitted, ConfigSync is considered enabled if the git or oci field is present.
         "git": { # Git repo configuration for a single cluster. # Optional. Git repo configuration for the cluster.
-          "gcpServiceAccountEmail": "A String", # Optional. The Google Cloud Service Account Email used for auth when secret_type is `gcpserviceaccount`.
-          "httpsProxy": "A String", # Optional. URL for the HTTPS proxy to be used when communicating with the Git repo. Only specify when secret_type is `cookiefile`, `token`, or `none`.
+          "gcpServiceAccountEmail": "A String", # Optional. The Google Cloud Service Account Email used for auth when secret_type is `gcpserviceaccount`. Annotates the `RootSync` or `RepoSync` controller's Kubernetes Service Account.
+          "httpsProxy": "A String", # Optional. URL for the HTTPS proxy to be used when communicating with the Git repo. Defines an HTTPS_PROXY environment variable and only accepts `https` or unadorned URLs. For example, `https://proxy.internal.business.co:443` or `proxy.internal.business.co:443`. If using an unadorned URL, make sure the communication between your proxy server and Git host is secure. Rejects `http://` URLs. Only specify when secret_type is `cookiefile`, `token`, or `none`.
           "policyDir": "A String", # Optional. The path within the Git repository that represents the top level of the repo to sync. Default: the root directory of the repository.
           "secretType": "A String", # Required. Type of secret configured for access to the Git repo. Must be one of `ssh`, `cookiefile`, `gcenode`, `token`, `gcpserviceaccount`, `githubapp` or `none`. The validation of this is case-sensitive.
           "syncBranch": "A String", # Optional. The branch of the repository to sync from. Default: master.
           "syncRepo": "A String", # Required. The URL of the Git repository to use as the source of truth.
-          "syncRev": "A String", # Optional. Git revision (tag or hash) to check out. Default HEAD.
+          "syncRev": "A String", # Optional. Git revision (tag or hash) or branch to sync from. Default `HEAD`. If not `HEAD`, takes precedence over `sync_branch` field. When using a hash, must be a full hash, and not an abbreviated form.
           "syncWaitSecs": "A String", # Optional. Period in seconds between consecutive syncs. Default: 15.
         },
         "metricsGcpServiceAccountEmail": "A String", # Optional. The Email of the Google Cloud Service Account (GSA) used for exporting Config Sync metrics to Cloud Monitoring and Cloud Monarch when Workload Identity is enabled. The GSA should have the Monitoring Metric Writer (roles/monitoring.metricWriter) IAM role. The Kubernetes ServiceAccount `default` in the namespace `config-management-monitoring` should be bound to the GSA. Deprecated: If Workload Identity Federation for GKE is enabled, Google Cloud Service Account is no longer needed for exporting Config Sync metrics: https://cloud.google.com/kubernetes-engine/enterprise/config-sync/docs/how-to/monitor-config-sync-cloud-monitoring#custom-monitoring.
         "oci": { # OCI repo configuration for a single cluster # Optional. OCI repo configuration for the cluster
-          "gcpServiceAccountEmail": "A String", # Optional. The Google Cloud Service Account Email used for auth when secret_type is `gcpserviceaccount`.
+          "gcpServiceAccountEmail": "A String", # Optional. The Google Cloud Service Account Email used for auth when secret_type is `gcpserviceaccount`. Annotates the `RootSync` or `RepoSync` controller's Kubernetes Service Account.
           "policyDir": "A String", # Optional. The absolute path of the directory that contains the local resources. Default: the root directory of the image.
           "secretType": "A String", # Required. Type of secret configured for access to the OCI repo. Must be one of `gcenode`, `gcpserviceaccount`, `k8sserviceaccount` or `none`. The validation of this is case-sensitive.
           "syncRepo": "A String", # Required. The OCI image repository URL for the package to sync from. e.g. `LOCATION-docker.pkg.dev/PROJECT_ID/REPOSITORY_NAME/PACKAGE_NAME`.
           "syncWaitSecs": "A String", # Optional. Period in seconds between consecutive syncs. Default: 15.
         },
         "preventDrift": True or False, # Optional. Set to true to enable the Config Sync admission webhook to prevent drifts. If set to false, disables the Config Sync admission webhook and does not prevent drifts. Defaults to false. See https://docs.cloud.google.com/kubernetes-engine/config-sync/docs/how-to/prevent-config-drift for details.
-        "sourceFormat": "A String", # Optional. Specifies whether the Config Sync repo is in `hierarchical` or `unstructured` mode. Defaults to `hierarchical`. See https://docs.cloud.google.com/kubernetes-engine/config-sync/docs/concepts/configs#organize-configs for an explanation.
+        "sourceFormat": "A String", # Optional. Specifies whether the Config Sync repo is in `hierarchy` or `unstructured` mode. Defaults to `hierarchy`. See https://docs.cloud.google.com/kubernetes-engine/config-sync/docs/concepts/configs#organize-configs for an explanation.
         "stopSyncing": True or False, # Optional. Set to true to stop syncing configs for a single cluster. Default to false.
       },
       "hierarchyController": { # Configuration for Hierarchy Controller # Optional. Hierarchy Controller configuration for the cluster. Deprecated: Configuring Hierarchy Controller through the configmanagement feature is no longer recommended. Use https://github.com/kubernetes-sigs/hierarchical-namespaces instead.
@@ -1413,25 +1413,25 @@ 
Method Details

           ],
           "enabled": True or False, # Optional. Enables the installation of Config Sync. If set to true, the Feature will manage Config Sync resources, and apply the other ConfigSync fields if they exist. If set to false, the Feature will ignore all other ConfigSync fields and delete the Config Sync resources. If omitted, ConfigSync is considered enabled if the git or oci field is present.
           "git": { # Git repo configuration for a single cluster. # Optional. Git repo configuration for the cluster.
-            "gcpServiceAccountEmail": "A String", # Optional. The Google Cloud Service Account Email used for auth when secret_type is `gcpserviceaccount`.
-            "httpsProxy": "A String", # Optional. URL for the HTTPS proxy to be used when communicating with the Git repo. Only specify when secret_type is `cookiefile`, `token`, or `none`.
+            "gcpServiceAccountEmail": "A String", # Optional. The Google Cloud Service Account Email used for auth when secret_type is `gcpserviceaccount`. Annotates the `RootSync` or `RepoSync` controller's Kubernetes Service Account.
+            "httpsProxy": "A String", # Optional. URL for the HTTPS proxy to be used when communicating with the Git repo. Defines an HTTPS_PROXY environment variable and only accepts `https` or unadorned URLs. For example, `https://proxy.internal.business.co:443` or `proxy.internal.business.co:443`. If using an unadorned URL, make sure the communication between your proxy server and Git host is secure. Rejects `http://` URLs. Only specify when secret_type is `cookiefile`, `token`, or `none`.
             "policyDir": "A String", # Optional. The path within the Git repository that represents the top level of the repo to sync. Default: the root directory of the repository.
             "secretType": "A String", # Required. Type of secret configured for access to the Git repo. Must be one of `ssh`, `cookiefile`, `gcenode`, `token`, `gcpserviceaccount`, `githubapp` or `none`. The validation of this is case-sensitive.
             "syncBranch": "A String", # Optional. The branch of the repository to sync from. Default: master.
             "syncRepo": "A String", # Required. The URL of the Git repository to use as the source of truth.
-            "syncRev": "A String", # Optional. Git revision (tag or hash) to check out. Default HEAD.
+            "syncRev": "A String", # Optional. Git revision (tag or hash) or branch to sync from. Default `HEAD`. If not `HEAD`, takes precedence over `sync_branch` field. When using a hash, must be a full hash, and not an abbreviated form.
             "syncWaitSecs": "A String", # Optional. Period in seconds between consecutive syncs. Default: 15.
           },
           "metricsGcpServiceAccountEmail": "A String", # Optional. The Email of the Google Cloud Service Account (GSA) used for exporting Config Sync metrics to Cloud Monitoring and Cloud Monarch when Workload Identity is enabled. The GSA should have the Monitoring Metric Writer (roles/monitoring.metricWriter) IAM role. The Kubernetes ServiceAccount `default` in the namespace `config-management-monitoring` should be bound to the GSA. Deprecated: If Workload Identity Federation for GKE is enabled, Google Cloud Service Account is no longer needed for exporting Config Sync metrics: https://cloud.google.com/kubernetes-engine/enterprise/config-sync/docs/how-to/monitor-config-sync-cloud-monitoring#custom-monitoring.
           "oci": { # OCI repo configuration for a single cluster # Optional. OCI repo configuration for the cluster
-            "gcpServiceAccountEmail": "A String", # Optional. The Google Cloud Service Account Email used for auth when secret_type is `gcpserviceaccount`.
+            "gcpServiceAccountEmail": "A String", # Optional. The Google Cloud Service Account Email used for auth when secret_type is `gcpserviceaccount`. Annotates the `RootSync` or `RepoSync` controller's Kubernetes Service Account.
             "policyDir": "A String", # Optional. The absolute path of the directory that contains the local resources. Default: the root directory of the image.
             "secretType": "A String", # Required. Type of secret configured for access to the OCI repo. Must be one of `gcenode`, `gcpserviceaccount`, `k8sserviceaccount` or `none`. The validation of this is case-sensitive.
             "syncRepo": "A String", # Required. The OCI image repository URL for the package to sync from. e.g. `LOCATION-docker.pkg.dev/PROJECT_ID/REPOSITORY_NAME/PACKAGE_NAME`.
             "syncWaitSecs": "A String", # Optional. Period in seconds between consecutive syncs. Default: 15.
           },
           "preventDrift": True or False, # Optional. Set to true to enable the Config Sync admission webhook to prevent drifts. If set to false, disables the Config Sync admission webhook and does not prevent drifts. Defaults to false. See https://docs.cloud.google.com/kubernetes-engine/config-sync/docs/how-to/prevent-config-drift for details.
-          "sourceFormat": "A String", # Optional. Specifies whether the Config Sync repo is in `hierarchical` or `unstructured` mode. Defaults to `hierarchical`. See https://docs.cloud.google.com/kubernetes-engine/config-sync/docs/concepts/configs#organize-configs for an explanation.
+          "sourceFormat": "A String", # Optional. Specifies whether the Config Sync repo is in `hierarchy` or `unstructured` mode. Defaults to `hierarchy`. See https://docs.cloud.google.com/kubernetes-engine/config-sync/docs/concepts/configs#organize-configs for an explanation.
           "stopSyncing": True or False, # Optional. Set to true to stop syncing configs for a single cluster. Default to false.
         },
         "hierarchyController": { # Configuration for Hierarchy Controller # Optional. Hierarchy Controller configuration for the cluster. Deprecated: Configuring Hierarchy Controller through the configmanagement feature is no longer recommended. Use https://github.com/kubernetes-sigs/hierarchical-namespaces instead.
@@ -1729,25 +1729,25 @@ 
Method Details

             ],
             "enabled": True or False, # Optional. Enables the installation of Config Sync. If set to true, the Feature will manage Config Sync resources, and apply the other ConfigSync fields if they exist. If set to false, the Feature will ignore all other ConfigSync fields and delete the Config Sync resources. If omitted, ConfigSync is considered enabled if the git or oci field is present.
             "git": { # Git repo configuration for a single cluster. # Optional. Git repo configuration for the cluster.
-              "gcpServiceAccountEmail": "A String", # Optional. The Google Cloud Service Account Email used for auth when secret_type is `gcpserviceaccount`.
-              "httpsProxy": "A String", # Optional. URL for the HTTPS proxy to be used when communicating with the Git repo. Only specify when secret_type is `cookiefile`, `token`, or `none`.
+              "gcpServiceAccountEmail": "A String", # Optional. The Google Cloud Service Account Email used for auth when secret_type is `gcpserviceaccount`. Annotates the `RootSync` or `RepoSync` controller's Kubernetes Service Account.
+              "httpsProxy": "A String", # Optional. URL for the HTTPS proxy to be used when communicating with the Git repo. Defines an HTTPS_PROXY environment variable and only accepts `https` or unadorned URLs. For example, `https://proxy.internal.business.co:443` or `proxy.internal.business.co:443`. If using an unadorned URL, make sure the communication between your proxy server and Git host is secure. Rejects `http://` URLs. Only specify when secret_type is `cookiefile`, `token`, or `none`.
               "policyDir": "A String", # Optional. The path within the Git repository that represents the top level of the repo to sync. Default: the root directory of the repository.
               "secretType": "A String", # Required. Type of secret configured for access to the Git repo. Must be one of `ssh`, `cookiefile`, `gcenode`, `token`, `gcpserviceaccount`, `githubapp` or `none`. The validation of this is case-sensitive.
               "syncBranch": "A String", # Optional. The branch of the repository to sync from. Default: master.
               "syncRepo": "A String", # Required. The URL of the Git repository to use as the source of truth.
-              "syncRev": "A String", # Optional. Git revision (tag or hash) to check out. Default HEAD.
+              "syncRev": "A String", # Optional. Git revision (tag or hash) or branch to sync from. Default `HEAD`. If not `HEAD`, takes precedence over `sync_branch` field. When using a hash, must be a full hash, and not an abbreviated form.
               "syncWaitSecs": "A String", # Optional. Period in seconds between consecutive syncs. Default: 15.
             },
             "metricsGcpServiceAccountEmail": "A String", # Optional. The Email of the Google Cloud Service Account (GSA) used for exporting Config Sync metrics to Cloud Monitoring and Cloud Monarch when Workload Identity is enabled. The GSA should have the Monitoring Metric Writer (roles/monitoring.metricWriter) IAM role. The Kubernetes ServiceAccount `default` in the namespace `config-management-monitoring` should be bound to the GSA. Deprecated: If Workload Identity Federation for GKE is enabled, Google Cloud Service Account is no longer needed for exporting Config Sync metrics: https://cloud.google.com/kubernetes-engine/enterprise/config-sync/docs/how-to/monitor-config-sync-cloud-monitoring#custom-monitoring.
             "oci": { # OCI repo configuration for a single cluster # Optional. OCI repo configuration for the cluster
-              "gcpServiceAccountEmail": "A String", # Optional. The Google Cloud Service Account Email used for auth when secret_type is `gcpserviceaccount`.
+              "gcpServiceAccountEmail": "A String", # Optional. The Google Cloud Service Account Email used for auth when secret_type is `gcpserviceaccount`. Annotates the `RootSync` or `RepoSync` controller's Kubernetes Service Account.
               "policyDir": "A String", # Optional. The absolute path of the directory that contains the local resources. Default: the root directory of the image.
               "secretType": "A String", # Required. Type of secret configured for access to the OCI repo. Must be one of `gcenode`, `gcpserviceaccount`, `k8sserviceaccount` or `none`. The validation of this is case-sensitive.
               "syncRepo": "A String", # Required. The OCI image repository URL for the package to sync from. e.g. `LOCATION-docker.pkg.dev/PROJECT_ID/REPOSITORY_NAME/PACKAGE_NAME`.
               "syncWaitSecs": "A String", # Optional. Period in seconds between consecutive syncs. Default: 15.
             },
             "preventDrift": True or False, # Optional. Set to true to enable the Config Sync admission webhook to prevent drifts. If set to false, disables the Config Sync admission webhook and does not prevent drifts. Defaults to false. See https://docs.cloud.google.com/kubernetes-engine/config-sync/docs/how-to/prevent-config-drift for details.
-            "sourceFormat": "A String", # Optional. Specifies whether the Config Sync repo is in `hierarchical` or `unstructured` mode. Defaults to `hierarchical`. See https://docs.cloud.google.com/kubernetes-engine/config-sync/docs/concepts/configs#organize-configs for an explanation.
+            "sourceFormat": "A String", # Optional. Specifies whether the Config Sync repo is in `hierarchy` or `unstructured` mode. Defaults to `hierarchy`. See https://docs.cloud.google.com/kubernetes-engine/config-sync/docs/concepts/configs#organize-configs for an explanation.
             "stopSyncing": True or False, # Optional. Set to true to stop syncing configs for a single cluster. Default to false.
           },
           "hierarchyController": { # Configuration for Hierarchy Controller # Optional. Hierarchy Controller configuration for the cluster. Deprecated: Configuring Hierarchy Controller through the configmanagement feature is no longer recommended. Use https://github.com/kubernetes-sigs/hierarchical-namespaces instead.
@@ -2241,25 +2241,25 @@ 
Method Details

             ],
             "enabled": True or False, # Optional. Enables the installation of Config Sync. If set to true, the Feature will manage Config Sync resources, and apply the other ConfigSync fields if they exist. If set to false, the Feature will ignore all other ConfigSync fields and delete the Config Sync resources. If omitted, ConfigSync is considered enabled if the git or oci field is present.
             "git": { # Git repo configuration for a single cluster. # Optional. Git repo configuration for the cluster.
-              "gcpServiceAccountEmail": "A String", # Optional. The Google Cloud Service Account Email used for auth when secret_type is `gcpserviceaccount`.
-              "httpsProxy": "A String", # Optional. URL for the HTTPS proxy to be used when communicating with the Git repo. Only specify when secret_type is `cookiefile`, `token`, or `none`.
+              "gcpServiceAccountEmail": "A String", # Optional. The Google Cloud Service Account Email used for auth when secret_type is `gcpserviceaccount`. Annotates the `RootSync` or `RepoSync` controller's Kubernetes Service Account.
+              "httpsProxy": "A String", # Optional. URL for the HTTPS proxy to be used when communicating with the Git repo. Defines an HTTPS_PROXY environment variable and only accepts `https` or unadorned URLs. For example, `https://proxy.internal.business.co:443` or `proxy.internal.business.co:443`. If using an unadorned URL, make sure the communication between your proxy server and Git host is secure. Rejects `http://` URLs. Only specify when secret_type is `cookiefile`, `token`, or `none`.
               "policyDir": "A String", # Optional. The path within the Git repository that represents the top level of the repo to sync. Default: the root directory of the repository.
               "secretType": "A String", # Required. Type of secret configured for access to the Git repo. Must be one of `ssh`, `cookiefile`, `gcenode`, `token`, `gcpserviceaccount`, `githubapp` or `none`. The validation of this is case-sensitive.
               "syncBranch": "A String", # Optional. The branch of the repository to sync from. Default: master.
               "syncRepo": "A String", # Required. The URL of the Git repository to use as the source of truth.
-              "syncRev": "A String", # Optional. Git revision (tag or hash) to check out. Default HEAD.
+              "syncRev": "A String", # Optional. Git revision (tag or hash) or branch to sync from. Default `HEAD`. If not `HEAD`, takes precedence over `sync_branch` field. When using a hash, must be a full hash, and not an abbreviated form.
               "syncWaitSecs": "A String", # Optional. Period in seconds between consecutive syncs. Default: 15.
             },
             "metricsGcpServiceAccountEmail": "A String", # Optional. The Email of the Google Cloud Service Account (GSA) used for exporting Config Sync metrics to Cloud Monitoring and Cloud Monarch when Workload Identity is enabled. The GSA should have the Monitoring Metric Writer (roles/monitoring.metricWriter) IAM role. The Kubernetes ServiceAccount `default` in the namespace `config-management-monitoring` should be bound to the GSA. Deprecated: If Workload Identity Federation for GKE is enabled, Google Cloud Service Account is no longer needed for exporting Config Sync metrics: https://cloud.google.com/kubernetes-engine/enterprise/config-sync/docs/how-to/monitor-config-sync-cloud-monitoring#custom-monitoring.
             "oci": { # OCI repo configuration for a single cluster # Optional. OCI repo configuration for the cluster
-              "gcpServiceAccountEmail": "A String", # Optional. The Google Cloud Service Account Email used for auth when secret_type is `gcpserviceaccount`.
+              "gcpServiceAccountEmail": "A String", # Optional. The Google Cloud Service Account Email used for auth when secret_type is `gcpserviceaccount`. Annotates the `RootSync` or `RepoSync` controller's Kubernetes Service Account.
               "policyDir": "A String", # Optional. The absolute path of the directory that contains the local resources. Default: the root directory of the image.
               "secretType": "A String", # Required. Type of secret configured for access to the OCI repo. Must be one of `gcenode`, `gcpserviceaccount`, `k8sserviceaccount` or `none`. The validation of this is case-sensitive.
               "syncRepo": "A String", # Required. The OCI image repository URL for the package to sync from. e.g. `LOCATION-docker.pkg.dev/PROJECT_ID/REPOSITORY_NAME/PACKAGE_NAME`.
               "syncWaitSecs": "A String", # Optional. Period in seconds between consecutive syncs. Default: 15.
             },
             "preventDrift": True or False, # Optional. Set to true to enable the Config Sync admission webhook to prevent drifts. If set to false, disables the Config Sync admission webhook and does not prevent drifts. Defaults to false. See https://docs.cloud.google.com/kubernetes-engine/config-sync/docs/how-to/prevent-config-drift for details.
-            "sourceFormat": "A String", # Optional. Specifies whether the Config Sync repo is in `hierarchical` or `unstructured` mode. Defaults to `hierarchical`. See https://docs.cloud.google.com/kubernetes-engine/config-sync/docs/concepts/configs#organize-configs for an explanation.
+            "sourceFormat": "A String", # Optional. Specifies whether the Config Sync repo is in `hierarchy` or `unstructured` mode. Defaults to `hierarchy`. See https://docs.cloud.google.com/kubernetes-engine/config-sync/docs/concepts/configs#organize-configs for an explanation.
             "stopSyncing": True or False, # Optional. Set to true to stop syncing configs for a single cluster. Default to false.
           },
           "hierarchyController": { # Configuration for Hierarchy Controller # Optional. Hierarchy Controller configuration for the cluster. Deprecated: Configuring Hierarchy Controller through the configmanagement feature is no longer recommended. Use https://github.com/kubernetes-sigs/hierarchical-namespaces instead.
@@ -2456,25 +2456,25 @@ 
Method Details

               ],
               "enabled": True or False, # Optional. Enables the installation of Config Sync. If set to true, the Feature will manage Config Sync resources, and apply the other ConfigSync fields if they exist. If set to false, the Feature will ignore all other ConfigSync fields and delete the Config Sync resources. If omitted, ConfigSync is considered enabled if the git or oci field is present.
               "git": { # Git repo configuration for a single cluster. # Optional. Git repo configuration for the cluster.
-                "gcpServiceAccountEmail": "A String", # Optional. The Google Cloud Service Account Email used for auth when secret_type is `gcpserviceaccount`.
-                "httpsProxy": "A String", # Optional. URL for the HTTPS proxy to be used when communicating with the Git repo. Only specify when secret_type is `cookiefile`, `token`, or `none`.
+                "gcpServiceAccountEmail": "A String", # Optional. The Google Cloud Service Account Email used for auth when secret_type is `gcpserviceaccount`. Annotates the `RootSync` or `RepoSync` controller's Kubernetes Service Account.
+                "httpsProxy": "A String", # Optional. URL for the HTTPS proxy to be used when communicating with the Git repo. Defines an HTTPS_PROXY environment variable and only accepts `https` or unadorned URLs. For example, `https://proxy.internal.business.co:443` or `proxy.internal.business.co:443`. If using an unadorned URL, make sure the communication between your proxy server and Git host is secure. Rejects `http://` URLs. Only specify when secret_type is `cookiefile`, `token`, or `none`.
                 "policyDir": "A String", # Optional. The path within the Git repository that represents the top level of the repo to sync. Default: the root directory of the repository.
                 "secretType": "A String", # Required. Type of secret configured for access to the Git repo. Must be one of `ssh`, `cookiefile`, `gcenode`, `token`, `gcpserviceaccount`, `githubapp` or `none`. The validation of this is case-sensitive.
                 "syncBranch": "A String", # Optional. The branch of the repository to sync from. Default: master.
                 "syncRepo": "A String", # Required. The URL of the Git repository to use as the source of truth.
-                "syncRev": "A String", # Optional. Git revision (tag or hash) to check out. Default HEAD.
+                "syncRev": "A String", # Optional. Git revision (tag or hash) or branch to sync from. Default `HEAD`. If not `HEAD`, takes precedence over `sync_branch` field. When using a hash, must be a full hash, and not an abbreviated form.
                 "syncWaitSecs": "A String", # Optional. Period in seconds between consecutive syncs. Default: 15.
               },
               "metricsGcpServiceAccountEmail": "A String", # Optional. The Email of the Google Cloud Service Account (GSA) used for exporting Config Sync metrics to Cloud Monitoring and Cloud Monarch when Workload Identity is enabled. The GSA should have the Monitoring Metric Writer (roles/monitoring.metricWriter) IAM role. The Kubernetes ServiceAccount `default` in the namespace `config-management-monitoring` should be bound to the GSA. Deprecated: If Workload Identity Federation for GKE is enabled, Google Cloud Service Account is no longer needed for exporting Config Sync metrics: https://cloud.google.com/kubernetes-engine/enterprise/config-sync/docs/how-to/monitor-config-sync-cloud-monitoring#custom-monitoring.
               "oci": { # OCI repo configuration for a single cluster # Optional. OCI repo configuration for the cluster
-                "gcpServiceAccountEmail": "A String", # Optional. The Google Cloud Service Account Email used for auth when secret_type is `gcpserviceaccount`.
+                "gcpServiceAccountEmail": "A String", # Optional. The Google Cloud Service Account Email used for auth when secret_type is `gcpserviceaccount`. Annotates the `RootSync` or `RepoSync` controller's Kubernetes Service Account.
                 "policyDir": "A String", # Optional. The absolute path of the directory that contains the local resources. Default: the root directory of the image.
                 "secretType": "A String", # Required. Type of secret configured for access to the OCI repo. Must be one of `gcenode`, `gcpserviceaccount`, `k8sserviceaccount` or `none`. The validation of this is case-sensitive.
                 "syncRepo": "A String", # Required. The OCI image repository URL for the package to sync from. e.g. `LOCATION-docker.pkg.dev/PROJECT_ID/REPOSITORY_NAME/PACKAGE_NAME`.
                 "syncWaitSecs": "A String", # Optional. Period in seconds between consecutive syncs. Default: 15.
               },
               "preventDrift": True or False, # Optional. Set to true to enable the Config Sync admission webhook to prevent drifts. If set to false, disables the Config Sync admission webhook and does not prevent drifts. Defaults to false. See https://docs.cloud.google.com/kubernetes-engine/config-sync/docs/how-to/prevent-config-drift for details.
-              "sourceFormat": "A String", # Optional. Specifies whether the Config Sync repo is in `hierarchical` or `unstructured` mode. Defaults to `hierarchical`. See https://docs.cloud.google.com/kubernetes-engine/config-sync/docs/concepts/configs#organize-configs for an explanation.
+              "sourceFormat": "A String", # Optional. Specifies whether the Config Sync repo is in `hierarchy` or `unstructured` mode. Defaults to `hierarchy`. See https://docs.cloud.google.com/kubernetes-engine/config-sync/docs/concepts/configs#organize-configs for an explanation.
               "stopSyncing": True or False, # Optional. Set to true to stop syncing configs for a single cluster. Default to false.
             },
             "hierarchyController": { # Configuration for Hierarchy Controller # Optional. Hierarchy Controller configuration for the cluster. Deprecated: Configuring Hierarchy Controller through the configmanagement feature is no longer recommended. Use https://github.com/kubernetes-sigs/hierarchical-namespaces instead.
@@ -2772,25 +2772,25 @@ 
Method Details

                 ],
                 "enabled": True or False, # Optional. Enables the installation of Config Sync. If set to true, the Feature will manage Config Sync resources, and apply the other ConfigSync fields if they exist. If set to false, the Feature will ignore all other ConfigSync fields and delete the Config Sync resources. If omitted, ConfigSync is considered enabled if the git or oci field is present.
                 "git": { # Git repo configuration for a single cluster. # Optional. Git repo configuration for the cluster.
-                  "gcpServiceAccountEmail": "A String", # Optional. The Google Cloud Service Account Email used for auth when secret_type is `gcpserviceaccount`.
-                  "httpsProxy": "A String", # Optional. URL for the HTTPS proxy to be used when communicating with the Git repo. Only specify when secret_type is `cookiefile`, `token`, or `none`.
+                  "gcpServiceAccountEmail": "A String", # Optional. The Google Cloud Service Account Email used for auth when secret_type is `gcpserviceaccount`. Annotates the `RootSync` or `RepoSync` controller's Kubernetes Service Account.
+                  "httpsProxy": "A String", # Optional. URL for the HTTPS proxy to be used when communicating with the Git repo. Defines an HTTPS_PROXY environment variable and only accepts `https` or unadorned URLs. For example, `https://proxy.internal.business.co:443` or `proxy.internal.business.co:443`. If using an unadorned URL, make sure the communication between your proxy server and Git host is secure. Rejects `http://` URLs. Only specify when secret_type is `cookiefile`, `token`, or `none`.
                   "policyDir": "A String", # Optional. The path within the Git repository that represents the top level of the repo to sync. Default: the root directory of the repository.
                   "secretType": "A String", # Required. Type of secret configured for access to the Git repo. Must be one of `ssh`, `cookiefile`, `gcenode`, `token`, `gcpserviceaccount`, `githubapp` or `none`. The validation of this is case-sensitive.
                   "syncBranch": "A String", # Optional. The branch of the repository to sync from. Default: master.
                   "syncRepo": "A String", # Required. The URL of the Git repository to use as the source of truth.
-                  "syncRev": "A String", # Optional. Git revision (tag or hash) to check out. Default HEAD.
+                  "syncRev": "A String", # Optional. Git revision (tag or hash) or branch to sync from. Default `HEAD`. If not `HEAD`, takes precedence over `sync_branch` field. When using a hash, must be a full hash, and not an abbreviated form.
                   "syncWaitSecs": "A String", # Optional. Period in seconds between consecutive syncs. Default: 15.
                 },
                 "metricsGcpServiceAccountEmail": "A String", # Optional. The Email of the Google Cloud Service Account (GSA) used for exporting Config Sync metrics to Cloud Monitoring and Cloud Monarch when Workload Identity is enabled. The GSA should have the Monitoring Metric Writer (roles/monitoring.metricWriter) IAM role. The Kubernetes ServiceAccount `default` in the namespace `config-management-monitoring` should be bound to the GSA. Deprecated: If Workload Identity Federation for GKE is enabled, Google Cloud Service Account is no longer needed for exporting Config Sync metrics: https://cloud.google.com/kubernetes-engine/enterprise/config-sync/docs/how-to/monitor-config-sync-cloud-monitoring#custom-monitoring.
                 "oci": { # OCI repo configuration for a single cluster # Optional. OCI repo configuration for the cluster
-                  "gcpServiceAccountEmail": "A String", # Optional. The Google Cloud Service Account Email used for auth when secret_type is `gcpserviceaccount`.
+                  "gcpServiceAccountEmail": "A String", # Optional. The Google Cloud Service Account Email used for auth when secret_type is `gcpserviceaccount`. Annotates the `RootSync` or `RepoSync` controller's Kubernetes Service Account.
                   "policyDir": "A String", # Optional. The absolute path of the directory that contains the local resources. Default: the root directory of the image.
                   "secretType": "A String", # Required. Type of secret configured for access to the OCI repo. Must be one of `gcenode`, `gcpserviceaccount`, `k8sserviceaccount` or `none`. The validation of this is case-sensitive.
                   "syncRepo": "A String", # Required. The OCI image repository URL for the package to sync from. e.g. `LOCATION-docker.pkg.dev/PROJECT_ID/REPOSITORY_NAME/PACKAGE_NAME`.
                   "syncWaitSecs": "A String", # Optional. Period in seconds between consecutive syncs. Default: 15.
                 },
                 "preventDrift": True or False, # Optional. Set to true to enable the Config Sync admission webhook to prevent drifts. If set to false, disables the Config Sync admission webhook and does not prevent drifts. Defaults to false. See https://docs.cloud.google.com/kubernetes-engine/config-sync/docs/how-to/prevent-config-drift for details.
-                "sourceFormat": "A String", # Optional. Specifies whether the Config Sync repo is in `hierarchical` or `unstructured` mode. Defaults to `hierarchical`. See https://docs.cloud.google.com/kubernetes-engine/config-sync/docs/concepts/configs#organize-configs for an explanation.
+                "sourceFormat": "A String", # Optional. Specifies whether the Config Sync repo is in `hierarchy` or `unstructured` mode. Defaults to `hierarchy`. See https://docs.cloud.google.com/kubernetes-engine/config-sync/docs/concepts/configs#organize-configs for an explanation.
                 "stopSyncing": True or False, # Optional. Set to true to stop syncing configs for a single cluster. Default to false.
               },
               "hierarchyController": { # Configuration for Hierarchy Controller # Optional. Hierarchy Controller configuration for the cluster. Deprecated: Configuring Hierarchy Controller through the configmanagement feature is no longer recommended. Use https://github.com/kubernetes-sigs/hierarchical-namespaces instead.
@@ -3239,25 +3239,25 @@ 
Method Details

         ],
         "enabled": True or False, # Optional. Enables the installation of Config Sync. If set to true, the Feature will manage Config Sync resources, and apply the other ConfigSync fields if they exist. If set to false, the Feature will ignore all other ConfigSync fields and delete the Config Sync resources. If omitted, ConfigSync is considered enabled if the git or oci field is present.
         "git": { # Git repo configuration for a single cluster. # Optional. Git repo configuration for the cluster.
-          "gcpServiceAccountEmail": "A String", # Optional. The Google Cloud Service Account Email used for auth when secret_type is `gcpserviceaccount`.
-          "httpsProxy": "A String", # Optional. URL for the HTTPS proxy to be used when communicating with the Git repo. Only specify when secret_type is `cookiefile`, `token`, or `none`.
+          "gcpServiceAccountEmail": "A String", # Optional. The Google Cloud Service Account Email used for auth when secret_type is `gcpserviceaccount`. Annotates the `RootSync` or `RepoSync` controller's Kubernetes Service Account.
+          "httpsProxy": "A String", # Optional. URL for the HTTPS proxy to be used when communicating with the Git repo. Defines an HTTPS_PROXY environment variable and only accepts `https` or unadorned URLs. For example, `https://proxy.internal.business.co:443` or `proxy.internal.business.co:443`. If using an unadorned URL, make sure the communication between your proxy server and Git host is secure. Rejects `http://` URLs. Only specify when secret_type is `cookiefile`, `token`, or `none`.
           "policyDir": "A String", # Optional. The path within the Git repository that represents the top level of the repo to sync. Default: the root directory of the repository.
           "secretType": "A String", # Required. Type of secret configured for access to the Git repo. Must be one of `ssh`, `cookiefile`, `gcenode`, `token`, `gcpserviceaccount`, `githubapp` or `none`. The validation of this is case-sensitive.
           "syncBranch": "A String", # Optional. The branch of the repository to sync from. Default: master.
           "syncRepo": "A String", # Required. The URL of the Git repository to use as the source of truth.
-          "syncRev": "A String", # Optional. Git revision (tag or hash) to check out. Default HEAD.
+          "syncRev": "A String", # Optional. Git revision (tag or hash) or branch to sync from. Default `HEAD`. If not `HEAD`, takes precedence over `sync_branch` field. When using a hash, must be a full hash, and not an abbreviated form.
           "syncWaitSecs": "A String", # Optional. Period in seconds between consecutive syncs. Default: 15.
         },
         "metricsGcpServiceAccountEmail": "A String", # Optional. The Email of the Google Cloud Service Account (GSA) used for exporting Config Sync metrics to Cloud Monitoring and Cloud Monarch when Workload Identity is enabled. The GSA should have the Monitoring Metric Writer (roles/monitoring.metricWriter) IAM role. The Kubernetes ServiceAccount `default` in the namespace `config-management-monitoring` should be bound to the GSA. Deprecated: If Workload Identity Federation for GKE is enabled, Google Cloud Service Account is no longer needed for exporting Config Sync metrics: https://cloud.google.com/kubernetes-engine/enterprise/config-sync/docs/how-to/monitor-config-sync-cloud-monitoring#custom-monitoring.
         "oci": { # OCI repo configuration for a single cluster # Optional. OCI repo configuration for the cluster
-          "gcpServiceAccountEmail": "A String", # Optional. The Google Cloud Service Account Email used for auth when secret_type is `gcpserviceaccount`.
+          "gcpServiceAccountEmail": "A String", # Optional. The Google Cloud Service Account Email used for auth when secret_type is `gcpserviceaccount`. Annotates the `RootSync` or `RepoSync` controller's Kubernetes Service Account.
           "policyDir": "A String", # Optional. The absolute path of the directory that contains the local resources. Default: the root directory of the image.
           "secretType": "A String", # Required. Type of secret configured for access to the OCI repo. Must be one of `gcenode`, `gcpserviceaccount`, `k8sserviceaccount` or `none`. The validation of this is case-sensitive.
           "syncRepo": "A String", # Required. The OCI image repository URL for the package to sync from. e.g. `LOCATION-docker.pkg.dev/PROJECT_ID/REPOSITORY_NAME/PACKAGE_NAME`.
           "syncWaitSecs": "A String", # Optional. Period in seconds between consecutive syncs. Default: 15.
         },
         "preventDrift": True or False, # Optional. Set to true to enable the Config Sync admission webhook to prevent drifts. If set to false, disables the Config Sync admission webhook and does not prevent drifts. Defaults to false. See https://docs.cloud.google.com/kubernetes-engine/config-sync/docs/how-to/prevent-config-drift for details.
-        "sourceFormat": "A String", # Optional. Specifies whether the Config Sync repo is in `hierarchical` or `unstructured` mode. Defaults to `hierarchical`. See https://docs.cloud.google.com/kubernetes-engine/config-sync/docs/concepts/configs#organize-configs for an explanation.
+        "sourceFormat": "A String", # Optional. Specifies whether the Config Sync repo is in `hierarchy` or `unstructured` mode. Defaults to `hierarchy`. See https://docs.cloud.google.com/kubernetes-engine/config-sync/docs/concepts/configs#organize-configs for an explanation.
         "stopSyncing": True or False, # Optional. Set to true to stop syncing configs for a single cluster. Default to false.
       },
       "hierarchyController": { # Configuration for Hierarchy Controller # Optional. Hierarchy Controller configuration for the cluster. Deprecated: Configuring Hierarchy Controller through the configmanagement feature is no longer recommended. Use https://github.com/kubernetes-sigs/hierarchical-namespaces instead.
@@ -3454,25 +3454,25 @@ 
Method Details

           ],
           "enabled": True or False, # Optional. Enables the installation of Config Sync. If set to true, the Feature will manage Config Sync resources, and apply the other ConfigSync fields if they exist. If set to false, the Feature will ignore all other ConfigSync fields and delete the Config Sync resources. If omitted, ConfigSync is considered enabled if the git or oci field is present.
           "git": { # Git repo configuration for a single cluster. # Optional. Git repo configuration for the cluster.
-            "gcpServiceAccountEmail": "A String", # Optional. The Google Cloud Service Account Email used for auth when secret_type is `gcpserviceaccount`.
-            "httpsProxy": "A String", # Optional. URL for the HTTPS proxy to be used when communicating with the Git repo. Only specify when secret_type is `cookiefile`, `token`, or `none`.
+            "gcpServiceAccountEmail": "A String", # Optional. The Google Cloud Service Account Email used for auth when secret_type is `gcpserviceaccount`. Annotates the `RootSync` or `RepoSync` controller's Kubernetes Service Account.
+            "httpsProxy": "A String", # Optional. URL for the HTTPS proxy to be used when communicating with the Git repo. Defines an HTTPS_PROXY environment variable and only accepts `https` or unadorned URLs. For example, `https://proxy.internal.business.co:443` or `proxy.internal.business.co:443`. If using an unadorned URL, make sure the communication between your proxy server and Git host is secure. Rejects `http://` URLs. Only specify when secret_type is `cookiefile`, `token`, or `none`.
             "policyDir": "A String", # Optional. The path within the Git repository that represents the top level of the repo to sync. Default: the root directory of the repository.
             "secretType": "A String", # Required. Type of secret configured for access to the Git repo. Must be one of `ssh`, `cookiefile`, `gcenode`, `token`, `gcpserviceaccount`, `githubapp` or `none`. The validation of this is case-sensitive.
             "syncBranch": "A String", # Optional. The branch of the repository to sync from. Default: master.
             "syncRepo": "A String", # Required. The URL of the Git repository to use as the source of truth.
-            "syncRev": "A String", # Optional. Git revision (tag or hash) to check out. Default HEAD.
+            "syncRev": "A String", # Optional. Git revision (tag or hash) or branch to sync from. Default `HEAD`. If not `HEAD`, takes precedence over `sync_branch` field. When using a hash, must be a full hash, and not an abbreviated form.
             "syncWaitSecs": "A String", # Optional. Period in seconds between consecutive syncs. Default: 15.
           },
           "metricsGcpServiceAccountEmail": "A String", # Optional. The Email of the Google Cloud Service Account (GSA) used for exporting Config Sync metrics to Cloud Monitoring and Cloud Monarch when Workload Identity is enabled. The GSA should have the Monitoring Metric Writer (roles/monitoring.metricWriter) IAM role. The Kubernetes ServiceAccount `default` in the namespace `config-management-monitoring` should be bound to the GSA. Deprecated: If Workload Identity Federation for GKE is enabled, Google Cloud Service Account is no longer needed for exporting Config Sync metrics: https://cloud.google.com/kubernetes-engine/enterprise/config-sync/docs/how-to/monitor-config-sync-cloud-monitoring#custom-monitoring.
           "oci": { # OCI repo configuration for a single cluster # Optional. OCI repo configuration for the cluster
-            "gcpServiceAccountEmail": "A String", # Optional. The Google Cloud Service Account Email used for auth when secret_type is `gcpserviceaccount`.
+            "gcpServiceAccountEmail": "A String", # Optional. The Google Cloud Service Account Email used for auth when secret_type is `gcpserviceaccount`. Annotates the `RootSync` or `RepoSync` controller's Kubernetes Service Account.
             "policyDir": "A String", # Optional. The absolute path of the directory that contains the local resources. Default: the root directory of the image.
             "secretType": "A String", # Required. Type of secret configured for access to the OCI repo. Must be one of `gcenode`, `gcpserviceaccount`, `k8sserviceaccount` or `none`. The validation of this is case-sensitive.
             "syncRepo": "A String", # Required. The OCI image repository URL for the package to sync from. e.g. `LOCATION-docker.pkg.dev/PROJECT_ID/REPOSITORY_NAME/PACKAGE_NAME`.
             "syncWaitSecs": "A String", # Optional. Period in seconds between consecutive syncs. Default: 15.
           },
           "preventDrift": True or False, # Optional. Set to true to enable the Config Sync admission webhook to prevent drifts. If set to false, disables the Config Sync admission webhook and does not prevent drifts. Defaults to false. See https://docs.cloud.google.com/kubernetes-engine/config-sync/docs/how-to/prevent-config-drift for details.
-          "sourceFormat": "A String", # Optional. Specifies whether the Config Sync repo is in `hierarchical` or `unstructured` mode. Defaults to `hierarchical`. See https://docs.cloud.google.com/kubernetes-engine/config-sync/docs/concepts/configs#organize-configs for an explanation.
+          "sourceFormat": "A String", # Optional. Specifies whether the Config Sync repo is in `hierarchy` or `unstructured` mode. Defaults to `hierarchy`. See https://docs.cloud.google.com/kubernetes-engine/config-sync/docs/concepts/configs#organize-configs for an explanation.
           "stopSyncing": True or False, # Optional. Set to true to stop syncing configs for a single cluster. Default to false.
         },
         "hierarchyController": { # Configuration for Hierarchy Controller # Optional. Hierarchy Controller configuration for the cluster. Deprecated: Configuring Hierarchy Controller through the configmanagement feature is no longer recommended. Use https://github.com/kubernetes-sigs/hierarchical-namespaces instead.
@@ -3770,25 +3770,25 @@ 
Method Details

             ],
             "enabled": True or False, # Optional. Enables the installation of Config Sync. If set to true, the Feature will manage Config Sync resources, and apply the other ConfigSync fields if they exist. If set to false, the Feature will ignore all other ConfigSync fields and delete the Config Sync resources. If omitted, ConfigSync is considered enabled if the git or oci field is present.
             "git": { # Git repo configuration for a single cluster. # Optional. Git repo configuration for the cluster.
-              "gcpServiceAccountEmail": "A String", # Optional. The Google Cloud Service Account Email used for auth when secret_type is `gcpserviceaccount`.
-              "httpsProxy": "A String", # Optional. URL for the HTTPS proxy to be used when communicating with the Git repo. Only specify when secret_type is `cookiefile`, `token`, or `none`.
+              "gcpServiceAccountEmail": "A String", # Optional. The Google Cloud Service Account Email used for auth when secret_type is `gcpserviceaccount`. Annotates the `RootSync` or `RepoSync` controller's Kubernetes Service Account.
+              "httpsProxy": "A String", # Optional. URL for the HTTPS proxy to be used when communicating with the Git repo. Defines an HTTPS_PROXY environment variable and only accepts `https` or unadorned URLs. For example, `https://proxy.internal.business.co:443` or `proxy.internal.business.co:443`. If using an unadorned URL, make sure the communication between your proxy server and Git host is secure. Rejects `http://` URLs. Only specify when secret_type is `cookiefile`, `token`, or `none`.
               "policyDir": "A String", # Optional. The path within the Git repository that represents the top level of the repo to sync. Default: the root directory of the repository.
               "secretType": "A String", # Required. Type of secret configured for access to the Git repo. Must be one of `ssh`, `cookiefile`, `gcenode`, `token`, `gcpserviceaccount`, `githubapp` or `none`. The validation of this is case-sensitive.
               "syncBranch": "A String", # Optional. The branch of the repository to sync from. Default: master.
               "syncRepo": "A String", # Required. The URL of the Git repository to use as the source of truth.
-              "syncRev": "A String", # Optional. Git revision (tag or hash) to check out. Default HEAD.
+              "syncRev": "A String", # Optional. Git revision (tag or hash) or branch to sync from. Default `HEAD`. If not `HEAD`, takes precedence over `sync_branch` field. When using a hash, must be a full hash, and not an abbreviated form.
               "syncWaitSecs": "A String", # Optional. Period in seconds between consecutive syncs. Default: 15.
             },
             "metricsGcpServiceAccountEmail": "A String", # Optional. The Email of the Google Cloud Service Account (GSA) used for exporting Config Sync metrics to Cloud Monitoring and Cloud Monarch when Workload Identity is enabled. The GSA should have the Monitoring Metric Writer (roles/monitoring.metricWriter) IAM role. The Kubernetes ServiceAccount `default` in the namespace `config-management-monitoring` should be bound to the GSA. Deprecated: If Workload Identity Federation for GKE is enabled, Google Cloud Service Account is no longer needed for exporting Config Sync metrics: https://cloud.google.com/kubernetes-engine/enterprise/config-sync/docs/how-to/monitor-config-sync-cloud-monitoring#custom-monitoring.
             "oci": { # OCI repo configuration for a single cluster # Optional. OCI repo configuration for the cluster
-              "gcpServiceAccountEmail": "A String", # Optional. The Google Cloud Service Account Email used for auth when secret_type is `gcpserviceaccount`.
+              "gcpServiceAccountEmail": "A String", # Optional. The Google Cloud Service Account Email used for auth when secret_type is `gcpserviceaccount`. Annotates the `RootSync` or `RepoSync` controller's Kubernetes Service Account.
               "policyDir": "A String", # Optional. The absolute path of the directory that contains the local resources. Default: the root directory of the image.
               "secretType": "A String", # Required. Type of secret configured for access to the OCI repo. Must be one of `gcenode`, `gcpserviceaccount`, `k8sserviceaccount` or `none`. The validation of this is case-sensitive.
               "syncRepo": "A String", # Required. The OCI image repository URL for the package to sync from. e.g. `LOCATION-docker.pkg.dev/PROJECT_ID/REPOSITORY_NAME/PACKAGE_NAME`.
               "syncWaitSecs": "A String", # Optional. Period in seconds between consecutive syncs. Default: 15.
             },
             "preventDrift": True or False, # Optional. Set to true to enable the Config Sync admission webhook to prevent drifts. If set to false, disables the Config Sync admission webhook and does not prevent drifts. Defaults to false. See https://docs.cloud.google.com/kubernetes-engine/config-sync/docs/how-to/prevent-config-drift for details.
-            "sourceFormat": "A String", # Optional. Specifies whether the Config Sync repo is in `hierarchical` or `unstructured` mode. Defaults to `hierarchical`. See https://docs.cloud.google.com/kubernetes-engine/config-sync/docs/concepts/configs#organize-configs for an explanation.
+            "sourceFormat": "A String", # Optional. Specifies whether the Config Sync repo is in `hierarchy` or `unstructured` mode. Defaults to `hierarchy`. See https://docs.cloud.google.com/kubernetes-engine/config-sync/docs/concepts/configs#organize-configs for an explanation.
             "stopSyncing": True or False, # Optional. Set to true to stop syncing configs for a single cluster. Default to false.
           },
           "hierarchyController": { # Configuration for Hierarchy Controller # Optional. Hierarchy Controller configuration for the cluster. Deprecated: Configuring Hierarchy Controller through the configmanagement feature is no longer recommended. Use https://github.com/kubernetes-sigs/hierarchical-namespaces instead.
diff --git a/docs/dyn/gkehub_v1alpha.projects.locations.features.html b/docs/dyn/gkehub_v1alpha.projects.locations.features.html
index 360432fe3c..42077752bf 100644
--- a/docs/dyn/gkehub_v1alpha.projects.locations.features.html
+++ b/docs/dyn/gkehub_v1alpha.projects.locations.features.html
@@ -146,25 +146,25 @@ 
Method Details

         ],
         "enabled": True or False, # Optional. Enables the installation of Config Sync. If set to true, the Feature will manage Config Sync resources, and apply the other ConfigSync fields if they exist. If set to false, the Feature will ignore all other ConfigSync fields and delete the Config Sync resources. If omitted, ConfigSync is considered enabled if the git or oci field is present.
         "git": { # Git repo configuration for a single cluster. # Optional. Git repo configuration for the cluster.
-          "gcpServiceAccountEmail": "A String", # Optional. The Google Cloud Service Account Email used for auth when secret_type is `gcpserviceaccount`.
-          "httpsProxy": "A String", # Optional. URL for the HTTPS proxy to be used when communicating with the Git repo. Only specify when secret_type is `cookiefile`, `token`, or `none`.
+          "gcpServiceAccountEmail": "A String", # Optional. The Google Cloud Service Account Email used for auth when secret_type is `gcpserviceaccount`. Annotates the `RootSync` or `RepoSync` controller's Kubernetes Service Account.
+          "httpsProxy": "A String", # Optional. URL for the HTTPS proxy to be used when communicating with the Git repo. Defines an HTTPS_PROXY environment variable and only accepts `https` or unadorned URLs. For example, `https://proxy.internal.business.co:443` or `proxy.internal.business.co:443`. If using an unadorned URL, make sure the communication between your proxy server and Git host is secure. Rejects `http://` URLs. Only specify when secret_type is `cookiefile`, `token`, or `none`.
           "policyDir": "A String", # Optional. The path within the Git repository that represents the top level of the repo to sync. Default: the root directory of the repository.
           "secretType": "A String", # Required. Type of secret configured for access to the Git repo. Must be one of `ssh`, `cookiefile`, `gcenode`, `token`, `gcpserviceaccount`, `githubapp` or `none`. The validation of this is case-sensitive.
           "syncBranch": "A String", # Optional. The branch of the repository to sync from. Default: master.
           "syncRepo": "A String", # Required. The URL of the Git repository to use as the source of truth.
-          "syncRev": "A String", # Optional. Git revision (tag or hash) to check out. Default HEAD.
+          "syncRev": "A String", # Optional. Git revision (tag or hash) or branch to sync from. Default `HEAD`. If not `HEAD`, takes precedence over `sync_branch` field. When using a hash, must be a full hash, and not an abbreviated form.
           "syncWaitSecs": "A String", # Optional. Period in seconds between consecutive syncs. Default: 15.
         },
         "metricsGcpServiceAccountEmail": "A String", # Optional. The Email of the Google Cloud Service Account (GSA) used for exporting Config Sync metrics to Cloud Monitoring and Cloud Monarch when Workload Identity is enabled. The GSA should have the Monitoring Metric Writer (roles/monitoring.metricWriter) IAM role. The Kubernetes ServiceAccount `default` in the namespace `config-management-monitoring` should be bound to the GSA. Deprecated: If Workload Identity Federation for GKE is enabled, Google Cloud Service Account is no longer needed for exporting Config Sync metrics: https://cloud.google.com/kubernetes-engine/enterprise/config-sync/docs/how-to/monitor-config-sync-cloud-monitoring#custom-monitoring.
         "oci": { # OCI repo configuration for a single cluster # Optional. OCI repo configuration for the cluster
-          "gcpServiceAccountEmail": "A String", # Optional. The Google Cloud Service Account Email used for auth when secret_type is `gcpserviceaccount`.
+          "gcpServiceAccountEmail": "A String", # Optional. The Google Cloud Service Account Email used for auth when secret_type is `gcpserviceaccount`. Annotates the `RootSync` or `RepoSync` controller's Kubernetes Service Account.
           "policyDir": "A String", # Optional. The absolute path of the directory that contains the local resources. Default: the root directory of the image.
           "secretType": "A String", # Required. Type of secret configured for access to the OCI repo. Must be one of `gcenode`, `gcpserviceaccount`, `k8sserviceaccount` or `none`. The validation of this is case-sensitive.
           "syncRepo": "A String", # Required. The OCI image repository URL for the package to sync from. e.g. `LOCATION-docker.pkg.dev/PROJECT_ID/REPOSITORY_NAME/PACKAGE_NAME`.
           "syncWaitSecs": "A String", # Optional. Period in seconds between consecutive syncs. Default: 15.
         },
         "preventDrift": True or False, # Optional. Set to true to enable the Config Sync admission webhook to prevent drifts. If set to false, disables the Config Sync admission webhook and does not prevent drifts. Defaults to false. See https://docs.cloud.google.com/kubernetes-engine/config-sync/docs/how-to/prevent-config-drift for details.
-        "sourceFormat": "A String", # Optional. Specifies whether the Config Sync repo is in `hierarchical` or `unstructured` mode. Defaults to `hierarchical`. See https://docs.cloud.google.com/kubernetes-engine/config-sync/docs/concepts/configs#organize-configs for an explanation.
+        "sourceFormat": "A String", # Optional. Specifies whether the Config Sync repo is in `hierarchy` or `unstructured` mode. Defaults to `hierarchy`. See https://docs.cloud.google.com/kubernetes-engine/config-sync/docs/concepts/configs#organize-configs for an explanation.
         "stopSyncing": True or False, # Optional. Set to true to stop syncing configs for a single cluster. Default to false.
       },
       "hierarchyController": { # Configuration for Hierarchy Controller # Optional. Hierarchy Controller configuration for the cluster. Deprecated: Configuring Hierarchy Controller through the configmanagement feature is no longer recommended. Use https://github.com/kubernetes-sigs/hierarchical-namespaces instead.
@@ -369,25 +369,25 @@ 
Method Details

           ],
           "enabled": True or False, # Optional. Enables the installation of Config Sync. If set to true, the Feature will manage Config Sync resources, and apply the other ConfigSync fields if they exist. If set to false, the Feature will ignore all other ConfigSync fields and delete the Config Sync resources. If omitted, ConfigSync is considered enabled if the git or oci field is present.
           "git": { # Git repo configuration for a single cluster. # Optional. Git repo configuration for the cluster.
-            "gcpServiceAccountEmail": "A String", # Optional. The Google Cloud Service Account Email used for auth when secret_type is `gcpserviceaccount`.
-            "httpsProxy": "A String", # Optional. URL for the HTTPS proxy to be used when communicating with the Git repo. Only specify when secret_type is `cookiefile`, `token`, or `none`.
+            "gcpServiceAccountEmail": "A String", # Optional. The Google Cloud Service Account Email used for auth when secret_type is `gcpserviceaccount`. Annotates the `RootSync` or `RepoSync` controller's Kubernetes Service Account.
+            "httpsProxy": "A String", # Optional. URL for the HTTPS proxy to be used when communicating with the Git repo. Defines an HTTPS_PROXY environment variable and only accepts `https` or unadorned URLs. For example, `https://proxy.internal.business.co:443` or `proxy.internal.business.co:443`. If using an unadorned URL, make sure the communication between your proxy server and Git host is secure. Rejects `http://` URLs. Only specify when secret_type is `cookiefile`, `token`, or `none`.
             "policyDir": "A String", # Optional. The path within the Git repository that represents the top level of the repo to sync. Default: the root directory of the repository.
             "secretType": "A String", # Required. Type of secret configured for access to the Git repo. Must be one of `ssh`, `cookiefile`, `gcenode`, `token`, `gcpserviceaccount`, `githubapp` or `none`. The validation of this is case-sensitive.
             "syncBranch": "A String", # Optional. The branch of the repository to sync from. Default: master.
             "syncRepo": "A String", # Required. The URL of the Git repository to use as the source of truth.
-            "syncRev": "A String", # Optional. Git revision (tag or hash) to check out. Default HEAD.
+            "syncRev": "A String", # Optional. Git revision (tag or hash) or branch to sync from. Default `HEAD`. If not `HEAD`, takes precedence over `sync_branch` field. When using a hash, must be a full hash, and not an abbreviated form.
             "syncWaitSecs": "A String", # Optional. Period in seconds between consecutive syncs. Default: 15.
           },
           "metricsGcpServiceAccountEmail": "A String", # Optional. The Email of the Google Cloud Service Account (GSA) used for exporting Config Sync metrics to Cloud Monitoring and Cloud Monarch when Workload Identity is enabled. The GSA should have the Monitoring Metric Writer (roles/monitoring.metricWriter) IAM role. The Kubernetes ServiceAccount `default` in the namespace `config-management-monitoring` should be bound to the GSA. Deprecated: If Workload Identity Federation for GKE is enabled, Google Cloud Service Account is no longer needed for exporting Config Sync metrics: https://cloud.google.com/kubernetes-engine/enterprise/config-sync/docs/how-to/monitor-config-sync-cloud-monitoring#custom-monitoring.
           "oci": { # OCI repo configuration for a single cluster # Optional. OCI repo configuration for the cluster
-            "gcpServiceAccountEmail": "A String", # Optional. The Google Cloud Service Account Email used for auth when secret_type is `gcpserviceaccount`.
+            "gcpServiceAccountEmail": "A String", # Optional. The Google Cloud Service Account Email used for auth when secret_type is `gcpserviceaccount`. Annotates the `RootSync` or `RepoSync` controller's Kubernetes Service Account.
             "policyDir": "A String", # Optional. The absolute path of the directory that contains the local resources. Default: the root directory of the image.
             "secretType": "A String", # Required. Type of secret configured for access to the OCI repo. Must be one of `gcenode`, `gcpserviceaccount`, `k8sserviceaccount` or `none`. The validation of this is case-sensitive.
             "syncRepo": "A String", # Required. The OCI image repository URL for the package to sync from. e.g. `LOCATION-docker.pkg.dev/PROJECT_ID/REPOSITORY_NAME/PACKAGE_NAME`.
             "syncWaitSecs": "A String", # Optional. Period in seconds between consecutive syncs. Default: 15.
           },
           "preventDrift": True or False, # Optional. Set to true to enable the Config Sync admission webhook to prevent drifts. If set to false, disables the Config Sync admission webhook and does not prevent drifts. Defaults to false. See https://docs.cloud.google.com/kubernetes-engine/config-sync/docs/how-to/prevent-config-drift for details.
-          "sourceFormat": "A String", # Optional. Specifies whether the Config Sync repo is in `hierarchical` or `unstructured` mode. Defaults to `hierarchical`. See https://docs.cloud.google.com/kubernetes-engine/config-sync/docs/concepts/configs#organize-configs for an explanation.
+          "sourceFormat": "A String", # Optional. Specifies whether the Config Sync repo is in `hierarchy` or `unstructured` mode. Defaults to `hierarchy`. See https://docs.cloud.google.com/kubernetes-engine/config-sync/docs/concepts/configs#organize-configs for an explanation.
           "stopSyncing": True or False, # Optional. Set to true to stop syncing configs for a single cluster. Default to false.
         },
         "hierarchyController": { # Configuration for Hierarchy Controller # Optional. Hierarchy Controller configuration for the cluster. Deprecated: Configuring Hierarchy Controller through the configmanagement feature is no longer recommended. Use https://github.com/kubernetes-sigs/hierarchical-namespaces instead.
@@ -703,25 +703,25 @@ 
Method Details

             ],
             "enabled": True or False, # Optional. Enables the installation of Config Sync. If set to true, the Feature will manage Config Sync resources, and apply the other ConfigSync fields if they exist. If set to false, the Feature will ignore all other ConfigSync fields and delete the Config Sync resources. If omitted, ConfigSync is considered enabled if the git or oci field is present.
             "git": { # Git repo configuration for a single cluster. # Optional. Git repo configuration for the cluster.
-              "gcpServiceAccountEmail": "A String", # Optional. The Google Cloud Service Account Email used for auth when secret_type is `gcpserviceaccount`.
-              "httpsProxy": "A String", # Optional. URL for the HTTPS proxy to be used when communicating with the Git repo. Only specify when secret_type is `cookiefile`, `token`, or `none`.
+              "gcpServiceAccountEmail": "A String", # Optional. The Google Cloud Service Account Email used for auth when secret_type is `gcpserviceaccount`. Annotates the `RootSync` or `RepoSync` controller's Kubernetes Service Account.
+              "httpsProxy": "A String", # Optional. URL for the HTTPS proxy to be used when communicating with the Git repo. Defines an HTTPS_PROXY environment variable and only accepts `https` or unadorned URLs. For example, `https://proxy.internal.business.co:443` or `proxy.internal.business.co:443`. If using an unadorned URL, make sure the communication between your proxy server and Git host is secure. Rejects `http://` URLs. Only specify when secret_type is `cookiefile`, `token`, or `none`.
               "policyDir": "A String", # Optional. The path within the Git repository that represents the top level of the repo to sync. Default: the root directory of the repository.
               "secretType": "A String", # Required. Type of secret configured for access to the Git repo. Must be one of `ssh`, `cookiefile`, `gcenode`, `token`, `gcpserviceaccount`, `githubapp` or `none`. The validation of this is case-sensitive.
               "syncBranch": "A String", # Optional. The branch of the repository to sync from. Default: master.
               "syncRepo": "A String", # Required. The URL of the Git repository to use as the source of truth.
-              "syncRev": "A String", # Optional. Git revision (tag or hash) to check out. Default HEAD.
+              "syncRev": "A String", # Optional. Git revision (tag or hash) or branch to sync from. Default `HEAD`. If not `HEAD`, takes precedence over `sync_branch` field. When using a hash, must be a full hash, and not an abbreviated form.
               "syncWaitSecs": "A String", # Optional. Period in seconds between consecutive syncs. Default: 15.
             },
             "metricsGcpServiceAccountEmail": "A String", # Optional. The Email of the Google Cloud Service Account (GSA) used for exporting Config Sync metrics to Cloud Monitoring and Cloud Monarch when Workload Identity is enabled. The GSA should have the Monitoring Metric Writer (roles/monitoring.metricWriter) IAM role. The Kubernetes ServiceAccount `default` in the namespace `config-management-monitoring` should be bound to the GSA. Deprecated: If Workload Identity Federation for GKE is enabled, Google Cloud Service Account is no longer needed for exporting Config Sync metrics: https://cloud.google.com/kubernetes-engine/enterprise/config-sync/docs/how-to/monitor-config-sync-cloud-monitoring#custom-monitoring.
             "oci": { # OCI repo configuration for a single cluster # Optional. OCI repo configuration for the cluster
-              "gcpServiceAccountEmail": "A String", # Optional. The Google Cloud Service Account Email used for auth when secret_type is `gcpserviceaccount`.
+              "gcpServiceAccountEmail": "A String", # Optional. The Google Cloud Service Account Email used for auth when secret_type is `gcpserviceaccount`. Annotates the `RootSync` or `RepoSync` controller's Kubernetes Service Account.
               "policyDir": "A String", # Optional. The absolute path of the directory that contains the local resources. Default: the root directory of the image.
               "secretType": "A String", # Required. Type of secret configured for access to the OCI repo. Must be one of `gcenode`, `gcpserviceaccount`, `k8sserviceaccount` or `none`. The validation of this is case-sensitive.
               "syncRepo": "A String", # Required. The OCI image repository URL for the package to sync from. e.g. `LOCATION-docker.pkg.dev/PROJECT_ID/REPOSITORY_NAME/PACKAGE_NAME`.
               "syncWaitSecs": "A String", # Optional. Period in seconds between consecutive syncs. Default: 15.
             },
             "preventDrift": True or False, # Optional. Set to true to enable the Config Sync admission webhook to prevent drifts. If set to false, disables the Config Sync admission webhook and does not prevent drifts. Defaults to false. See https://docs.cloud.google.com/kubernetes-engine/config-sync/docs/how-to/prevent-config-drift for details.
-            "sourceFormat": "A String", # Optional. Specifies whether the Config Sync repo is in `hierarchical` or `unstructured` mode. Defaults to `hierarchical`. See https://docs.cloud.google.com/kubernetes-engine/config-sync/docs/concepts/configs#organize-configs for an explanation.
+            "sourceFormat": "A String", # Optional. Specifies whether the Config Sync repo is in `hierarchy` or `unstructured` mode. Defaults to `hierarchy`. See https://docs.cloud.google.com/kubernetes-engine/config-sync/docs/concepts/configs#organize-configs for an explanation.
             "stopSyncing": True or False, # Optional. Set to true to stop syncing configs for a single cluster. Default to false.
           },
           "hierarchyController": { # Configuration for Hierarchy Controller # Optional. Hierarchy Controller configuration for the cluster. Deprecated: Configuring Hierarchy Controller through the configmanagement feature is no longer recommended. Use https://github.com/kubernetes-sigs/hierarchical-namespaces instead.
@@ -1349,25 +1349,25 @@ 
Method Details

         ],
         "enabled": True or False, # Optional. Enables the installation of Config Sync. If set to true, the Feature will manage Config Sync resources, and apply the other ConfigSync fields if they exist. If set to false, the Feature will ignore all other ConfigSync fields and delete the Config Sync resources. If omitted, ConfigSync is considered enabled if the git or oci field is present.
         "git": { # Git repo configuration for a single cluster. # Optional. Git repo configuration for the cluster.
-          "gcpServiceAccountEmail": "A String", # Optional. The Google Cloud Service Account Email used for auth when secret_type is `gcpserviceaccount`.
-          "httpsProxy": "A String", # Optional. URL for the HTTPS proxy to be used when communicating with the Git repo. Only specify when secret_type is `cookiefile`, `token`, or `none`.
+          "gcpServiceAccountEmail": "A String", # Optional. The Google Cloud Service Account Email used for auth when secret_type is `gcpserviceaccount`. Annotates the `RootSync` or `RepoSync` controller's Kubernetes Service Account.
+          "httpsProxy": "A String", # Optional. URL for the HTTPS proxy to be used when communicating with the Git repo. Defines an HTTPS_PROXY environment variable and only accepts `https` or unadorned URLs. For example, `https://proxy.internal.business.co:443` or `proxy.internal.business.co:443`. If using an unadorned URL, make sure the communication between your proxy server and Git host is secure. Rejects `http://` URLs. Only specify when secret_type is `cookiefile`, `token`, or `none`.
           "policyDir": "A String", # Optional. The path within the Git repository that represents the top level of the repo to sync. Default: the root directory of the repository.
           "secretType": "A String", # Required. Type of secret configured for access to the Git repo. Must be one of `ssh`, `cookiefile`, `gcenode`, `token`, `gcpserviceaccount`, `githubapp` or `none`. The validation of this is case-sensitive.
           "syncBranch": "A String", # Optional. The branch of the repository to sync from. Default: master.
           "syncRepo": "A String", # Required. The URL of the Git repository to use as the source of truth.
-          "syncRev": "A String", # Optional. Git revision (tag or hash) to check out. Default HEAD.
+          "syncRev": "A String", # Optional. Git revision (tag or hash) or branch to sync from. Default `HEAD`. If not `HEAD`, takes precedence over `sync_branch` field. When using a hash, must be a full hash, and not an abbreviated form.
           "syncWaitSecs": "A String", # Optional. Period in seconds between consecutive syncs. Default: 15.
         },
         "metricsGcpServiceAccountEmail": "A String", # Optional. The Email of the Google Cloud Service Account (GSA) used for exporting Config Sync metrics to Cloud Monitoring and Cloud Monarch when Workload Identity is enabled. The GSA should have the Monitoring Metric Writer (roles/monitoring.metricWriter) IAM role. The Kubernetes ServiceAccount `default` in the namespace `config-management-monitoring` should be bound to the GSA. Deprecated: If Workload Identity Federation for GKE is enabled, Google Cloud Service Account is no longer needed for exporting Config Sync metrics: https://cloud.google.com/kubernetes-engine/enterprise/config-sync/docs/how-to/monitor-config-sync-cloud-monitoring#custom-monitoring.
         "oci": { # OCI repo configuration for a single cluster # Optional. OCI repo configuration for the cluster
-          "gcpServiceAccountEmail": "A String", # Optional. The Google Cloud Service Account Email used for auth when secret_type is `gcpserviceaccount`.
+          "gcpServiceAccountEmail": "A String", # Optional. The Google Cloud Service Account Email used for auth when secret_type is `gcpserviceaccount`. Annotates the `RootSync` or `RepoSync` controller's Kubernetes Service Account.
           "policyDir": "A String", # Optional. The absolute path of the directory that contains the local resources. Default: the root directory of the image.
           "secretType": "A String", # Required. Type of secret configured for access to the OCI repo. Must be one of `gcenode`, `gcpserviceaccount`, `k8sserviceaccount` or `none`. The validation of this is case-sensitive.
           "syncRepo": "A String", # Required. The OCI image repository URL for the package to sync from. e.g. `LOCATION-docker.pkg.dev/PROJECT_ID/REPOSITORY_NAME/PACKAGE_NAME`.
           "syncWaitSecs": "A String", # Optional. Period in seconds between consecutive syncs. Default: 15.
         },
         "preventDrift": True or False, # Optional. Set to true to enable the Config Sync admission webhook to prevent drifts. If set to false, disables the Config Sync admission webhook and does not prevent drifts. Defaults to false. See https://docs.cloud.google.com/kubernetes-engine/config-sync/docs/how-to/prevent-config-drift for details.
-        "sourceFormat": "A String", # Optional. Specifies whether the Config Sync repo is in `hierarchical` or `unstructured` mode. Defaults to `hierarchical`. See https://docs.cloud.google.com/kubernetes-engine/config-sync/docs/concepts/configs#organize-configs for an explanation.
+        "sourceFormat": "A String", # Optional. Specifies whether the Config Sync repo is in `hierarchy` or `unstructured` mode. Defaults to `hierarchy`. See https://docs.cloud.google.com/kubernetes-engine/config-sync/docs/concepts/configs#organize-configs for an explanation.
         "stopSyncing": True or False, # Optional. Set to true to stop syncing configs for a single cluster. Default to false.
       },
       "hierarchyController": { # Configuration for Hierarchy Controller # Optional. Hierarchy Controller configuration for the cluster. Deprecated: Configuring Hierarchy Controller through the configmanagement feature is no longer recommended. Use https://github.com/kubernetes-sigs/hierarchical-namespaces instead.
@@ -1572,25 +1572,25 @@ 
Method Details

           ],
           "enabled": True or False, # Optional. Enables the installation of Config Sync. If set to true, the Feature will manage Config Sync resources, and apply the other ConfigSync fields if they exist. If set to false, the Feature will ignore all other ConfigSync fields and delete the Config Sync resources. If omitted, ConfigSync is considered enabled if the git or oci field is present.
           "git": { # Git repo configuration for a single cluster. # Optional. Git repo configuration for the cluster.
-            "gcpServiceAccountEmail": "A String", # Optional. The Google Cloud Service Account Email used for auth when secret_type is `gcpserviceaccount`.
-            "httpsProxy": "A String", # Optional. URL for the HTTPS proxy to be used when communicating with the Git repo. Only specify when secret_type is `cookiefile`, `token`, or `none`.
+            "gcpServiceAccountEmail": "A String", # Optional. The Google Cloud Service Account Email used for auth when secret_type is `gcpserviceaccount`. Annotates the `RootSync` or `RepoSync` controller's Kubernetes Service Account.
+            "httpsProxy": "A String", # Optional. URL for the HTTPS proxy to be used when communicating with the Git repo. Defines an HTTPS_PROXY environment variable and only accepts `https` or unadorned URLs. For example, `https://proxy.internal.business.co:443` or `proxy.internal.business.co:443`. If using an unadorned URL, make sure the communication between your proxy server and Git host is secure. Rejects `http://` URLs. Only specify when secret_type is `cookiefile`, `token`, or `none`.
             "policyDir": "A String", # Optional. The path within the Git repository that represents the top level of the repo to sync. Default: the root directory of the repository.
             "secretType": "A String", # Required. Type of secret configured for access to the Git repo. Must be one of `ssh`, `cookiefile`, `gcenode`, `token`, `gcpserviceaccount`, `githubapp` or `none`. The validation of this is case-sensitive.
             "syncBranch": "A String", # Optional. The branch of the repository to sync from. Default: master.
             "syncRepo": "A String", # Required. The URL of the Git repository to use as the source of truth.
-            "syncRev": "A String", # Optional. Git revision (tag or hash) to check out. Default HEAD.
+            "syncRev": "A String", # Optional. Git revision (tag or hash) or branch to sync from. Default `HEAD`. If not `HEAD`, takes precedence over `sync_branch` field. When using a hash, must be a full hash, and not an abbreviated form.
             "syncWaitSecs": "A String", # Optional. Period in seconds between consecutive syncs. Default: 15.
           },
           "metricsGcpServiceAccountEmail": "A String", # Optional. The Email of the Google Cloud Service Account (GSA) used for exporting Config Sync metrics to Cloud Monitoring and Cloud Monarch when Workload Identity is enabled. The GSA should have the Monitoring Metric Writer (roles/monitoring.metricWriter) IAM role. The Kubernetes ServiceAccount `default` in the namespace `config-management-monitoring` should be bound to the GSA. Deprecated: If Workload Identity Federation for GKE is enabled, Google Cloud Service Account is no longer needed for exporting Config Sync metrics: https://cloud.google.com/kubernetes-engine/enterprise/config-sync/docs/how-to/monitor-config-sync-cloud-monitoring#custom-monitoring.
           "oci": { # OCI repo configuration for a single cluster # Optional. OCI repo configuration for the cluster
-            "gcpServiceAccountEmail": "A String", # Optional. The Google Cloud Service Account Email used for auth when secret_type is `gcpserviceaccount`.
+            "gcpServiceAccountEmail": "A String", # Optional. The Google Cloud Service Account Email used for auth when secret_type is `gcpserviceaccount`. Annotates the `RootSync` or `RepoSync` controller's Kubernetes Service Account.
             "policyDir": "A String", # Optional. The absolute path of the directory that contains the local resources. Default: the root directory of the image.
             "secretType": "A String", # Required. Type of secret configured for access to the OCI repo. Must be one of `gcenode`, `gcpserviceaccount`, `k8sserviceaccount` or `none`. The validation of this is case-sensitive.
             "syncRepo": "A String", # Required. The OCI image repository URL for the package to sync from. e.g. `LOCATION-docker.pkg.dev/PROJECT_ID/REPOSITORY_NAME/PACKAGE_NAME`.
             "syncWaitSecs": "A String", # Optional. Period in seconds between consecutive syncs. Default: 15.
           },
           "preventDrift": True or False, # Optional. Set to true to enable the Config Sync admission webhook to prevent drifts. If set to false, disables the Config Sync admission webhook and does not prevent drifts. Defaults to false. See https://docs.cloud.google.com/kubernetes-engine/config-sync/docs/how-to/prevent-config-drift for details.
-          "sourceFormat": "A String", # Optional. Specifies whether the Config Sync repo is in `hierarchical` or `unstructured` mode. Defaults to `hierarchical`. See https://docs.cloud.google.com/kubernetes-engine/config-sync/docs/concepts/configs#organize-configs for an explanation.
+          "sourceFormat": "A String", # Optional. Specifies whether the Config Sync repo is in `hierarchy` or `unstructured` mode. Defaults to `hierarchy`. See https://docs.cloud.google.com/kubernetes-engine/config-sync/docs/concepts/configs#organize-configs for an explanation.
           "stopSyncing": True or False, # Optional. Set to true to stop syncing configs for a single cluster. Default to false.
         },
         "hierarchyController": { # Configuration for Hierarchy Controller # Optional. Hierarchy Controller configuration for the cluster. Deprecated: Configuring Hierarchy Controller through the configmanagement feature is no longer recommended. Use https://github.com/kubernetes-sigs/hierarchical-namespaces instead.
@@ -1906,25 +1906,25 @@ 
Method Details

             ],
             "enabled": True or False, # Optional. Enables the installation of Config Sync. If set to true, the Feature will manage Config Sync resources, and apply the other ConfigSync fields if they exist. If set to false, the Feature will ignore all other ConfigSync fields and delete the Config Sync resources. If omitted, ConfigSync is considered enabled if the git or oci field is present.
             "git": { # Git repo configuration for a single cluster. # Optional. Git repo configuration for the cluster.
-              "gcpServiceAccountEmail": "A String", # Optional. The Google Cloud Service Account Email used for auth when secret_type is `gcpserviceaccount`.
-              "httpsProxy": "A String", # Optional. URL for the HTTPS proxy to be used when communicating with the Git repo. Only specify when secret_type is `cookiefile`, `token`, or `none`.
+              "gcpServiceAccountEmail": "A String", # Optional. The Google Cloud Service Account Email used for auth when secret_type is `gcpserviceaccount`. Annotates the `RootSync` or `RepoSync` controller's Kubernetes Service Account.
+              "httpsProxy": "A String", # Optional. URL for the HTTPS proxy to be used when communicating with the Git repo. Defines an HTTPS_PROXY environment variable and only accepts `https` or unadorned URLs. For example, `https://proxy.internal.business.co:443` or `proxy.internal.business.co:443`. If using an unadorned URL, make sure the communication between your proxy server and Git host is secure. Rejects `http://` URLs. Only specify when secret_type is `cookiefile`, `token`, or `none`.
               "policyDir": "A String", # Optional. The path within the Git repository that represents the top level of the repo to sync. Default: the root directory of the repository.
               "secretType": "A String", # Required. Type of secret configured for access to the Git repo. Must be one of `ssh`, `cookiefile`, `gcenode`, `token`, `gcpserviceaccount`, `githubapp` or `none`. The validation of this is case-sensitive.
               "syncBranch": "A String", # Optional. The branch of the repository to sync from. Default: master.
               "syncRepo": "A String", # Required. The URL of the Git repository to use as the source of truth.
-              "syncRev": "A String", # Optional. Git revision (tag or hash) to check out. Default HEAD.
+              "syncRev": "A String", # Optional. Git revision (tag or hash) or branch to sync from. Default `HEAD`. If not `HEAD`, takes precedence over `sync_branch` field. When using a hash, must be a full hash, and not an abbreviated form.
               "syncWaitSecs": "A String", # Optional. Period in seconds between consecutive syncs. Default: 15.
             },
             "metricsGcpServiceAccountEmail": "A String", # Optional. The Email of the Google Cloud Service Account (GSA) used for exporting Config Sync metrics to Cloud Monitoring and Cloud Monarch when Workload Identity is enabled. The GSA should have the Monitoring Metric Writer (roles/monitoring.metricWriter) IAM role. The Kubernetes ServiceAccount `default` in the namespace `config-management-monitoring` should be bound to the GSA. Deprecated: If Workload Identity Federation for GKE is enabled, Google Cloud Service Account is no longer needed for exporting Config Sync metrics: https://cloud.google.com/kubernetes-engine/enterprise/config-sync/docs/how-to/monitor-config-sync-cloud-monitoring#custom-monitoring.
             "oci": { # OCI repo configuration for a single cluster # Optional. OCI repo configuration for the cluster
-              "gcpServiceAccountEmail": "A String", # Optional. The Google Cloud Service Account Email used for auth when secret_type is `gcpserviceaccount`.
+              "gcpServiceAccountEmail": "A String", # Optional. The Google Cloud Service Account Email used for auth when secret_type is `gcpserviceaccount`. Annotates the `RootSync` or `RepoSync` controller's Kubernetes Service Account.
               "policyDir": "A String", # Optional. The absolute path of the directory that contains the local resources. Default: the root directory of the image.
               "secretType": "A String", # Required. Type of secret configured for access to the OCI repo. Must be one of `gcenode`, `gcpserviceaccount`, `k8sserviceaccount` or `none`. The validation of this is case-sensitive.
               "syncRepo": "A String", # Required. The OCI image repository URL for the package to sync from. e.g. `LOCATION-docker.pkg.dev/PROJECT_ID/REPOSITORY_NAME/PACKAGE_NAME`.
               "syncWaitSecs": "A String", # Optional. Period in seconds between consecutive syncs. Default: 15.
             },
             "preventDrift": True or False, # Optional. Set to true to enable the Config Sync admission webhook to prevent drifts. If set to false, disables the Config Sync admission webhook and does not prevent drifts. Defaults to false. See https://docs.cloud.google.com/kubernetes-engine/config-sync/docs/how-to/prevent-config-drift for details.
-            "sourceFormat": "A String", # Optional. Specifies whether the Config Sync repo is in `hierarchical` or `unstructured` mode. Defaults to `hierarchical`. See https://docs.cloud.google.com/kubernetes-engine/config-sync/docs/concepts/configs#organize-configs for an explanation.
+            "sourceFormat": "A String", # Optional. Specifies whether the Config Sync repo is in `hierarchy` or `unstructured` mode. Defaults to `hierarchy`. See https://docs.cloud.google.com/kubernetes-engine/config-sync/docs/concepts/configs#organize-configs for an explanation.
             "stopSyncing": True or False, # Optional. Set to true to stop syncing configs for a single cluster. Default to false.
           },
           "hierarchyController": { # Configuration for Hierarchy Controller # Optional. Hierarchy Controller configuration for the cluster. Deprecated: Configuring Hierarchy Controller through the configmanagement feature is no longer recommended. Use https://github.com/kubernetes-sigs/hierarchical-namespaces instead.
@@ -2540,25 +2540,25 @@ 
Method Details

             ],
             "enabled": True or False, # Optional. Enables the installation of Config Sync. If set to true, the Feature will manage Config Sync resources, and apply the other ConfigSync fields if they exist. If set to false, the Feature will ignore all other ConfigSync fields and delete the Config Sync resources. If omitted, ConfigSync is considered enabled if the git or oci field is present.
             "git": { # Git repo configuration for a single cluster. # Optional. Git repo configuration for the cluster.
-              "gcpServiceAccountEmail": "A String", # Optional. The Google Cloud Service Account Email used for auth when secret_type is `gcpserviceaccount`.
-              "httpsProxy": "A String", # Optional. URL for the HTTPS proxy to be used when communicating with the Git repo. Only specify when secret_type is `cookiefile`, `token`, or `none`.
+              "gcpServiceAccountEmail": "A String", # Optional. The Google Cloud Service Account Email used for auth when secret_type is `gcpserviceaccount`. Annotates the `RootSync` or `RepoSync` controller's Kubernetes Service Account.
+              "httpsProxy": "A String", # Optional. URL for the HTTPS proxy to be used when communicating with the Git repo. Defines an HTTPS_PROXY environment variable and only accepts `https` or unadorned URLs. For example, `https://proxy.internal.business.co:443` or `proxy.internal.business.co:443`. If using an unadorned URL, make sure the communication between your proxy server and Git host is secure. Rejects `http://` URLs. Only specify when secret_type is `cookiefile`, `token`, or `none`.
               "policyDir": "A String", # Optional. The path within the Git repository that represents the top level of the repo to sync. Default: the root directory of the repository.
               "secretType": "A String", # Required. Type of secret configured for access to the Git repo. Must be one of `ssh`, `cookiefile`, `gcenode`, `token`, `gcpserviceaccount`, `githubapp` or `none`. The validation of this is case-sensitive.
               "syncBranch": "A String", # Optional. The branch of the repository to sync from. Default: master.
               "syncRepo": "A String", # Required. The URL of the Git repository to use as the source of truth.
-              "syncRev": "A String", # Optional. Git revision (tag or hash) to check out. Default HEAD.
+              "syncRev": "A String", # Optional. Git revision (tag or hash) or branch to sync from. Default `HEAD`. If not `HEAD`, takes precedence over `sync_branch` field. When using a hash, must be a full hash, and not an abbreviated form.
               "syncWaitSecs": "A String", # Optional. Period in seconds between consecutive syncs. Default: 15.
             },
             "metricsGcpServiceAccountEmail": "A String", # Optional. The Email of the Google Cloud Service Account (GSA) used for exporting Config Sync metrics to Cloud Monitoring and Cloud Monarch when Workload Identity is enabled. The GSA should have the Monitoring Metric Writer (roles/monitoring.metricWriter) IAM role. The Kubernetes ServiceAccount `default` in the namespace `config-management-monitoring` should be bound to the GSA. Deprecated: If Workload Identity Federation for GKE is enabled, Google Cloud Service Account is no longer needed for exporting Config Sync metrics: https://cloud.google.com/kubernetes-engine/enterprise/config-sync/docs/how-to/monitor-config-sync-cloud-monitoring#custom-monitoring.
             "oci": { # OCI repo configuration for a single cluster # Optional. OCI repo configuration for the cluster
-              "gcpServiceAccountEmail": "A String", # Optional. The Google Cloud Service Account Email used for auth when secret_type is `gcpserviceaccount`.
+              "gcpServiceAccountEmail": "A String", # Optional. The Google Cloud Service Account Email used for auth when secret_type is `gcpserviceaccount`. Annotates the `RootSync` or `RepoSync` controller's Kubernetes Service Account.
               "policyDir": "A String", # Optional. The absolute path of the directory that contains the local resources. Default: the root directory of the image.
               "secretType": "A String", # Required. Type of secret configured for access to the OCI repo. Must be one of `gcenode`, `gcpserviceaccount`, `k8sserviceaccount` or `none`. The validation of this is case-sensitive.
               "syncRepo": "A String", # Required. The OCI image repository URL for the package to sync from. e.g. `LOCATION-docker.pkg.dev/PROJECT_ID/REPOSITORY_NAME/PACKAGE_NAME`.
               "syncWaitSecs": "A String", # Optional. Period in seconds between consecutive syncs. Default: 15.
             },
             "preventDrift": True or False, # Optional. Set to true to enable the Config Sync admission webhook to prevent drifts. If set to false, disables the Config Sync admission webhook and does not prevent drifts. Defaults to false. See https://docs.cloud.google.com/kubernetes-engine/config-sync/docs/how-to/prevent-config-drift for details.
-            "sourceFormat": "A String", # Optional. Specifies whether the Config Sync repo is in `hierarchical` or `unstructured` mode. Defaults to `hierarchical`. See https://docs.cloud.google.com/kubernetes-engine/config-sync/docs/concepts/configs#organize-configs for an explanation.
+            "sourceFormat": "A String", # Optional. Specifies whether the Config Sync repo is in `hierarchy` or `unstructured` mode. Defaults to `hierarchy`. See https://docs.cloud.google.com/kubernetes-engine/config-sync/docs/concepts/configs#organize-configs for an explanation.
             "stopSyncing": True or False, # Optional. Set to true to stop syncing configs for a single cluster. Default to false.
           },
           "hierarchyController": { # Configuration for Hierarchy Controller # Optional. Hierarchy Controller configuration for the cluster. Deprecated: Configuring Hierarchy Controller through the configmanagement feature is no longer recommended. Use https://github.com/kubernetes-sigs/hierarchical-namespaces instead.
@@ -2763,25 +2763,25 @@ 
Method Details

               ],
               "enabled": True or False, # Optional. Enables the installation of Config Sync. If set to true, the Feature will manage Config Sync resources, and apply the other ConfigSync fields if they exist. If set to false, the Feature will ignore all other ConfigSync fields and delete the Config Sync resources. If omitted, ConfigSync is considered enabled if the git or oci field is present.
               "git": { # Git repo configuration for a single cluster. # Optional. Git repo configuration for the cluster.
-                "gcpServiceAccountEmail": "A String", # Optional. The Google Cloud Service Account Email used for auth when secret_type is `gcpserviceaccount`.
-                "httpsProxy": "A String", # Optional. URL for the HTTPS proxy to be used when communicating with the Git repo. Only specify when secret_type is `cookiefile`, `token`, or `none`.
+                "gcpServiceAccountEmail": "A String", # Optional. The Google Cloud Service Account Email used for auth when secret_type is `gcpserviceaccount`. Annotates the `RootSync` or `RepoSync` controller's Kubernetes Service Account.
+                "httpsProxy": "A String", # Optional. URL for the HTTPS proxy to be used when communicating with the Git repo. Defines an HTTPS_PROXY environment variable and only accepts `https` or unadorned URLs. For example, `https://proxy.internal.business.co:443` or `proxy.internal.business.co:443`. If using an unadorned URL, make sure the communication between your proxy server and Git host is secure. Rejects `http://` URLs. Only specify when secret_type is `cookiefile`, `token`, or `none`.
                 "policyDir": "A String", # Optional. The path within the Git repository that represents the top level of the repo to sync. Default: the root directory of the repository.
                 "secretType": "A String", # Required. Type of secret configured for access to the Git repo. Must be one of `ssh`, `cookiefile`, `gcenode`, `token`, `gcpserviceaccount`, `githubapp` or `none`. The validation of this is case-sensitive.
                 "syncBranch": "A String", # Optional. The branch of the repository to sync from. Default: master.
                 "syncRepo": "A String", # Required. The URL of the Git repository to use as the source of truth.
-                "syncRev": "A String", # Optional. Git revision (tag or hash) to check out. Default HEAD.
+                "syncRev": "A String", # Optional. Git revision (tag or hash) or branch to sync from. Default `HEAD`. If not `HEAD`, takes precedence over `sync_branch` field. When using a hash, must be a full hash, and not an abbreviated form.
                 "syncWaitSecs": "A String", # Optional. Period in seconds between consecutive syncs. Default: 15.
               },
               "metricsGcpServiceAccountEmail": "A String", # Optional. The Email of the Google Cloud Service Account (GSA) used for exporting Config Sync metrics to Cloud Monitoring and Cloud Monarch when Workload Identity is enabled. The GSA should have the Monitoring Metric Writer (roles/monitoring.metricWriter) IAM role. The Kubernetes ServiceAccount `default` in the namespace `config-management-monitoring` should be bound to the GSA. Deprecated: If Workload Identity Federation for GKE is enabled, Google Cloud Service Account is no longer needed for exporting Config Sync metrics: https://cloud.google.com/kubernetes-engine/enterprise/config-sync/docs/how-to/monitor-config-sync-cloud-monitoring#custom-monitoring.
               "oci": { # OCI repo configuration for a single cluster # Optional. OCI repo configuration for the cluster
-                "gcpServiceAccountEmail": "A String", # Optional. The Google Cloud Service Account Email used for auth when secret_type is `gcpserviceaccount`.
+                "gcpServiceAccountEmail": "A String", # Optional. The Google Cloud Service Account Email used for auth when secret_type is `gcpserviceaccount`. Annotates the `RootSync` or `RepoSync` controller's Kubernetes Service Account.
                 "policyDir": "A String", # Optional. The absolute path of the directory that contains the local resources. Default: the root directory of the image.
                 "secretType": "A String", # Required. Type of secret configured for access to the OCI repo. Must be one of `gcenode`, `gcpserviceaccount`, `k8sserviceaccount` or `none`. The validation of this is case-sensitive.
                 "syncRepo": "A String", # Required. The OCI image repository URL for the package to sync from. e.g. `LOCATION-docker.pkg.dev/PROJECT_ID/REPOSITORY_NAME/PACKAGE_NAME`.
                 "syncWaitSecs": "A String", # Optional. Period in seconds between consecutive syncs. Default: 15.
               },
               "preventDrift": True or False, # Optional. Set to true to enable the Config Sync admission webhook to prevent drifts. If set to false, disables the Config Sync admission webhook and does not prevent drifts. Defaults to false. See https://docs.cloud.google.com/kubernetes-engine/config-sync/docs/how-to/prevent-config-drift for details.
-              "sourceFormat": "A String", # Optional. Specifies whether the Config Sync repo is in `hierarchical` or `unstructured` mode. Defaults to `hierarchical`. See https://docs.cloud.google.com/kubernetes-engine/config-sync/docs/concepts/configs#organize-configs for an explanation.
+              "sourceFormat": "A String", # Optional. Specifies whether the Config Sync repo is in `hierarchy` or `unstructured` mode. Defaults to `hierarchy`. See https://docs.cloud.google.com/kubernetes-engine/config-sync/docs/concepts/configs#organize-configs for an explanation.
               "stopSyncing": True or False, # Optional. Set to true to stop syncing configs for a single cluster. Default to false.
             },
             "hierarchyController": { # Configuration for Hierarchy Controller # Optional. Hierarchy Controller configuration for the cluster. Deprecated: Configuring Hierarchy Controller through the configmanagement feature is no longer recommended. Use https://github.com/kubernetes-sigs/hierarchical-namespaces instead.
@@ -3097,25 +3097,25 @@ 
Method Details

                 ],
                 "enabled": True or False, # Optional. Enables the installation of Config Sync. If set to true, the Feature will manage Config Sync resources, and apply the other ConfigSync fields if they exist. If set to false, the Feature will ignore all other ConfigSync fields and delete the Config Sync resources. If omitted, ConfigSync is considered enabled if the git or oci field is present.
                 "git": { # Git repo configuration for a single cluster. # Optional. Git repo configuration for the cluster.
-                  "gcpServiceAccountEmail": "A String", # Optional. The Google Cloud Service Account Email used for auth when secret_type is `gcpserviceaccount`.
-                  "httpsProxy": "A String", # Optional. URL for the HTTPS proxy to be used when communicating with the Git repo. Only specify when secret_type is `cookiefile`, `token`, or `none`.
+                  "gcpServiceAccountEmail": "A String", # Optional. The Google Cloud Service Account Email used for auth when secret_type is `gcpserviceaccount`. Annotates the `RootSync` or `RepoSync` controller's Kubernetes Service Account.
+                  "httpsProxy": "A String", # Optional. URL for the HTTPS proxy to be used when communicating with the Git repo. Defines an HTTPS_PROXY environment variable and only accepts `https` or unadorned URLs. For example, `https://proxy.internal.business.co:443` or `proxy.internal.business.co:443`. If using an unadorned URL, make sure the communication between your proxy server and Git host is secure. Rejects `http://` URLs. Only specify when secret_type is `cookiefile`, `token`, or `none`.
                   "policyDir": "A String", # Optional. The path within the Git repository that represents the top level of the repo to sync. Default: the root directory of the repository.
                   "secretType": "A String", # Required. Type of secret configured for access to the Git repo. Must be one of `ssh`, `cookiefile`, `gcenode`, `token`, `gcpserviceaccount`, `githubapp` or `none`. The validation of this is case-sensitive.
                   "syncBranch": "A String", # Optional. The branch of the repository to sync from. Default: master.
                   "syncRepo": "A String", # Required. The URL of the Git repository to use as the source of truth.
-                  "syncRev": "A String", # Optional. Git revision (tag or hash) to check out. Default HEAD.
+                  "syncRev": "A String", # Optional. Git revision (tag or hash) or branch to sync from. Default `HEAD`. If not `HEAD`, takes precedence over `sync_branch` field. When using a hash, must be a full hash, and not an abbreviated form.
                   "syncWaitSecs": "A String", # Optional. Period in seconds between consecutive syncs. Default: 15.
                 },
                 "metricsGcpServiceAccountEmail": "A String", # Optional. The Email of the Google Cloud Service Account (GSA) used for exporting Config Sync metrics to Cloud Monitoring and Cloud Monarch when Workload Identity is enabled. The GSA should have the Monitoring Metric Writer (roles/monitoring.metricWriter) IAM role. The Kubernetes ServiceAccount `default` in the namespace `config-management-monitoring` should be bound to the GSA. Deprecated: If Workload Identity Federation for GKE is enabled, Google Cloud Service Account is no longer needed for exporting Config Sync metrics: https://cloud.google.com/kubernetes-engine/enterprise/config-sync/docs/how-to/monitor-config-sync-cloud-monitoring#custom-monitoring.
                 "oci": { # OCI repo configuration for a single cluster # Optional. OCI repo configuration for the cluster
-                  "gcpServiceAccountEmail": "A String", # Optional. The Google Cloud Service Account Email used for auth when secret_type is `gcpserviceaccount`.
+                  "gcpServiceAccountEmail": "A String", # Optional. The Google Cloud Service Account Email used for auth when secret_type is `gcpserviceaccount`. Annotates the `RootSync` or `RepoSync` controller's Kubernetes Service Account.
                   "policyDir": "A String", # Optional. The absolute path of the directory that contains the local resources. Default: the root directory of the image.
                   "secretType": "A String", # Required. Type of secret configured for access to the OCI repo. Must be one of `gcenode`, `gcpserviceaccount`, `k8sserviceaccount` or `none`. The validation of this is case-sensitive.
                   "syncRepo": "A String", # Required. The OCI image repository URL for the package to sync from. e.g. `LOCATION-docker.pkg.dev/PROJECT_ID/REPOSITORY_NAME/PACKAGE_NAME`.
                   "syncWaitSecs": "A String", # Optional. Period in seconds between consecutive syncs. Default: 15.
                 },
                 "preventDrift": True or False, # Optional. Set to true to enable the Config Sync admission webhook to prevent drifts. If set to false, disables the Config Sync admission webhook and does not prevent drifts. Defaults to false. See https://docs.cloud.google.com/kubernetes-engine/config-sync/docs/how-to/prevent-config-drift for details.
-                "sourceFormat": "A String", # Optional. Specifies whether the Config Sync repo is in `hierarchical` or `unstructured` mode. Defaults to `hierarchical`. See https://docs.cloud.google.com/kubernetes-engine/config-sync/docs/concepts/configs#organize-configs for an explanation.
+                "sourceFormat": "A String", # Optional. Specifies whether the Config Sync repo is in `hierarchy` or `unstructured` mode. Defaults to `hierarchy`. See https://docs.cloud.google.com/kubernetes-engine/config-sync/docs/concepts/configs#organize-configs for an explanation.
                 "stopSyncing": True or False, # Optional. Set to true to stop syncing configs for a single cluster. Default to false.
               },
               "hierarchyController": { # Configuration for Hierarchy Controller # Optional. Hierarchy Controller configuration for the cluster. Deprecated: Configuring Hierarchy Controller through the configmanagement feature is no longer recommended. Use https://github.com/kubernetes-sigs/hierarchical-namespaces instead.
@@ -3686,25 +3686,25 @@ 
Method Details

         ],
         "enabled": True or False, # Optional. Enables the installation of Config Sync. If set to true, the Feature will manage Config Sync resources, and apply the other ConfigSync fields if they exist. If set to false, the Feature will ignore all other ConfigSync fields and delete the Config Sync resources. If omitted, ConfigSync is considered enabled if the git or oci field is present.
         "git": { # Git repo configuration for a single cluster. # Optional. Git repo configuration for the cluster.
-          "gcpServiceAccountEmail": "A String", # Optional. The Google Cloud Service Account Email used for auth when secret_type is `gcpserviceaccount`.
-          "httpsProxy": "A String", # Optional. URL for the HTTPS proxy to be used when communicating with the Git repo. Only specify when secret_type is `cookiefile`, `token`, or `none`.
+          "gcpServiceAccountEmail": "A String", # Optional. The Google Cloud Service Account Email used for auth when secret_type is `gcpserviceaccount`. Annotates the `RootSync` or `RepoSync` controller's Kubernetes Service Account.
+          "httpsProxy": "A String", # Optional. URL for the HTTPS proxy to be used when communicating with the Git repo. Defines an HTTPS_PROXY environment variable and only accepts `https` or unadorned URLs. For example, `https://proxy.internal.business.co:443` or `proxy.internal.business.co:443`. If using an unadorned URL, make sure the communication between your proxy server and Git host is secure. Rejects `http://` URLs. Only specify when secret_type is `cookiefile`, `token`, or `none`.
           "policyDir": "A String", # Optional. The path within the Git repository that represents the top level of the repo to sync. Default: the root directory of the repository.
           "secretType": "A String", # Required. Type of secret configured for access to the Git repo. Must be one of `ssh`, `cookiefile`, `gcenode`, `token`, `gcpserviceaccount`, `githubapp` or `none`. The validation of this is case-sensitive.
           "syncBranch": "A String", # Optional. The branch of the repository to sync from. Default: master.
           "syncRepo": "A String", # Required. The URL of the Git repository to use as the source of truth.
-          "syncRev": "A String", # Optional. Git revision (tag or hash) to check out. Default HEAD.
+          "syncRev": "A String", # Optional. Git revision (tag or hash) or branch to sync from. Default `HEAD`. If not `HEAD`, takes precedence over `sync_branch` field. When using a hash, must be a full hash, and not an abbreviated form.
           "syncWaitSecs": "A String", # Optional. Period in seconds between consecutive syncs. Default: 15.
         },
         "metricsGcpServiceAccountEmail": "A String", # Optional. The Email of the Google Cloud Service Account (GSA) used for exporting Config Sync metrics to Cloud Monitoring and Cloud Monarch when Workload Identity is enabled. The GSA should have the Monitoring Metric Writer (roles/monitoring.metricWriter) IAM role. The Kubernetes ServiceAccount `default` in the namespace `config-management-monitoring` should be bound to the GSA. Deprecated: If Workload Identity Federation for GKE is enabled, Google Cloud Service Account is no longer needed for exporting Config Sync metrics: https://cloud.google.com/kubernetes-engine/enterprise/config-sync/docs/how-to/monitor-config-sync-cloud-monitoring#custom-monitoring.
         "oci": { # OCI repo configuration for a single cluster # Optional. OCI repo configuration for the cluster
-          "gcpServiceAccountEmail": "A String", # Optional. The Google Cloud Service Account Email used for auth when secret_type is `gcpserviceaccount`.
+          "gcpServiceAccountEmail": "A String", # Optional. The Google Cloud Service Account Email used for auth when secret_type is `gcpserviceaccount`. Annotates the `RootSync` or `RepoSync` controller's Kubernetes Service Account.
           "policyDir": "A String", # Optional. The absolute path of the directory that contains the local resources. Default: the root directory of the image.
           "secretType": "A String", # Required. Type of secret configured for access to the OCI repo. Must be one of `gcenode`, `gcpserviceaccount`, `k8sserviceaccount` or `none`. The validation of this is case-sensitive.
           "syncRepo": "A String", # Required. The OCI image repository URL for the package to sync from. e.g. `LOCATION-docker.pkg.dev/PROJECT_ID/REPOSITORY_NAME/PACKAGE_NAME`.
           "syncWaitSecs": "A String", # Optional. Period in seconds between consecutive syncs. Default: 15.
         },
         "preventDrift": True or False, # Optional. Set to true to enable the Config Sync admission webhook to prevent drifts. If set to false, disables the Config Sync admission webhook and does not prevent drifts. Defaults to false. See https://docs.cloud.google.com/kubernetes-engine/config-sync/docs/how-to/prevent-config-drift for details.
-        "sourceFormat": "A String", # Optional. Specifies whether the Config Sync repo is in `hierarchical` or `unstructured` mode. Defaults to `hierarchical`. See https://docs.cloud.google.com/kubernetes-engine/config-sync/docs/concepts/configs#organize-configs for an explanation.
+        "sourceFormat": "A String", # Optional. Specifies whether the Config Sync repo is in `hierarchy` or `unstructured` mode. Defaults to `hierarchy`. See https://docs.cloud.google.com/kubernetes-engine/config-sync/docs/concepts/configs#organize-configs for an explanation.
         "stopSyncing": True or False, # Optional. Set to true to stop syncing configs for a single cluster. Default to false.
       },
       "hierarchyController": { # Configuration for Hierarchy Controller # Optional. Hierarchy Controller configuration for the cluster. Deprecated: Configuring Hierarchy Controller through the configmanagement feature is no longer recommended. Use https://github.com/kubernetes-sigs/hierarchical-namespaces instead.
@@ -3909,25 +3909,25 @@ 
Method Details

           ],
           "enabled": True or False, # Optional. Enables the installation of Config Sync. If set to true, the Feature will manage Config Sync resources, and apply the other ConfigSync fields if they exist. If set to false, the Feature will ignore all other ConfigSync fields and delete the Config Sync resources. If omitted, ConfigSync is considered enabled if the git or oci field is present.
           "git": { # Git repo configuration for a single cluster. # Optional. Git repo configuration for the cluster.
-            "gcpServiceAccountEmail": "A String", # Optional. The Google Cloud Service Account Email used for auth when secret_type is `gcpserviceaccount`.
-            "httpsProxy": "A String", # Optional. URL for the HTTPS proxy to be used when communicating with the Git repo. Only specify when secret_type is `cookiefile`, `token`, or `none`.
+            "gcpServiceAccountEmail": "A String", # Optional. The Google Cloud Service Account Email used for auth when secret_type is `gcpserviceaccount`. Annotates the `RootSync` or `RepoSync` controller's Kubernetes Service Account.
+            "httpsProxy": "A String", # Optional. URL for the HTTPS proxy to be used when communicating with the Git repo. Defines an HTTPS_PROXY environment variable and only accepts `https` or unadorned URLs. For example, `https://proxy.internal.business.co:443` or `proxy.internal.business.co:443`. If using an unadorned URL, make sure the communication between your proxy server and Git host is secure. Rejects `http://` URLs. Only specify when secret_type is `cookiefile`, `token`, or `none`.
             "policyDir": "A String", # Optional. The path within the Git repository that represents the top level of the repo to sync. Default: the root directory of the repository.
             "secretType": "A String", # Required. Type of secret configured for access to the Git repo. Must be one of `ssh`, `cookiefile`, `gcenode`, `token`, `gcpserviceaccount`, `githubapp` or `none`. The validation of this is case-sensitive.
             "syncBranch": "A String", # Optional. The branch of the repository to sync from. Default: master.
             "syncRepo": "A String", # Required. The URL of the Git repository to use as the source of truth.
-            "syncRev": "A String", # Optional. Git revision (tag or hash) to check out. Default HEAD.
+            "syncRev": "A String", # Optional. Git revision (tag or hash) or branch to sync from. Default `HEAD`. If not `HEAD`, takes precedence over `sync_branch` field. When using a hash, must be a full hash, and not an abbreviated form.
             "syncWaitSecs": "A String", # Optional. Period in seconds between consecutive syncs. Default: 15.
           },
           "metricsGcpServiceAccountEmail": "A String", # Optional. The Email of the Google Cloud Service Account (GSA) used for exporting Config Sync metrics to Cloud Monitoring and Cloud Monarch when Workload Identity is enabled. The GSA should have the Monitoring Metric Writer (roles/monitoring.metricWriter) IAM role. The Kubernetes ServiceAccount `default` in the namespace `config-management-monitoring` should be bound to the GSA. Deprecated: If Workload Identity Federation for GKE is enabled, Google Cloud Service Account is no longer needed for exporting Config Sync metrics: https://cloud.google.com/kubernetes-engine/enterprise/config-sync/docs/how-to/monitor-config-sync-cloud-monitoring#custom-monitoring.
           "oci": { # OCI repo configuration for a single cluster # Optional. OCI repo configuration for the cluster
-            "gcpServiceAccountEmail": "A String", # Optional. The Google Cloud Service Account Email used for auth when secret_type is `gcpserviceaccount`.
+            "gcpServiceAccountEmail": "A String", # Optional. The Google Cloud Service Account Email used for auth when secret_type is `gcpserviceaccount`. Annotates the `RootSync` or `RepoSync` controller's Kubernetes Service Account.
             "policyDir": "A String", # Optional. The absolute path of the directory that contains the local resources. Default: the root directory of the image.
             "secretType": "A String", # Required. Type of secret configured for access to the OCI repo. Must be one of `gcenode`, `gcpserviceaccount`, `k8sserviceaccount` or `none`. The validation of this is case-sensitive.
             "syncRepo": "A String", # Required. The OCI image repository URL for the package to sync from. e.g. `LOCATION-docker.pkg.dev/PROJECT_ID/REPOSITORY_NAME/PACKAGE_NAME`.
             "syncWaitSecs": "A String", # Optional. Period in seconds between consecutive syncs. Default: 15.
           },
           "preventDrift": True or False, # Optional. Set to true to enable the Config Sync admission webhook to prevent drifts. If set to false, disables the Config Sync admission webhook and does not prevent drifts. Defaults to false. See https://docs.cloud.google.com/kubernetes-engine/config-sync/docs/how-to/prevent-config-drift for details.
-          "sourceFormat": "A String", # Optional. Specifies whether the Config Sync repo is in `hierarchical` or `unstructured` mode. Defaults to `hierarchical`. See https://docs.cloud.google.com/kubernetes-engine/config-sync/docs/concepts/configs#organize-configs for an explanation.
+          "sourceFormat": "A String", # Optional. Specifies whether the Config Sync repo is in `hierarchy` or `unstructured` mode. Defaults to `hierarchy`. See https://docs.cloud.google.com/kubernetes-engine/config-sync/docs/concepts/configs#organize-configs for an explanation.
           "stopSyncing": True or False, # Optional. Set to true to stop syncing configs for a single cluster. Default to false.
         },
         "hierarchyController": { # Configuration for Hierarchy Controller # Optional. Hierarchy Controller configuration for the cluster. Deprecated: Configuring Hierarchy Controller through the configmanagement feature is no longer recommended. Use https://github.com/kubernetes-sigs/hierarchical-namespaces instead.
@@ -4243,25 +4243,25 @@ 
Method Details

             ],
             "enabled": True or False, # Optional. Enables the installation of Config Sync. If set to true, the Feature will manage Config Sync resources, and apply the other ConfigSync fields if they exist. If set to false, the Feature will ignore all other ConfigSync fields and delete the Config Sync resources. If omitted, ConfigSync is considered enabled if the git or oci field is present.
             "git": { # Git repo configuration for a single cluster. # Optional. Git repo configuration for the cluster.
-              "gcpServiceAccountEmail": "A String", # Optional. The Google Cloud Service Account Email used for auth when secret_type is `gcpserviceaccount`.
-              "httpsProxy": "A String", # Optional. URL for the HTTPS proxy to be used when communicating with the Git repo. Only specify when secret_type is `cookiefile`, `token`, or `none`.
+              "gcpServiceAccountEmail": "A String", # Optional. The Google Cloud Service Account Email used for auth when secret_type is `gcpserviceaccount`. Annotates the `RootSync` or `RepoSync` controller's Kubernetes Service Account.
+              "httpsProxy": "A String", # Optional. URL for the HTTPS proxy to be used when communicating with the Git repo. Defines an HTTPS_PROXY environment variable and only accepts `https` or unadorned URLs. For example, `https://proxy.internal.business.co:443` or `proxy.internal.business.co:443`. If using an unadorned URL, make sure the communication between your proxy server and Git host is secure. Rejects `http://` URLs. Only specify when secret_type is `cookiefile`, `token`, or `none`.
               "policyDir": "A String", # Optional. The path within the Git repository that represents the top level of the repo to sync. Default: the root directory of the repository.
               "secretType": "A String", # Required. Type of secret configured for access to the Git repo. Must be one of `ssh`, `cookiefile`, `gcenode`, `token`, `gcpserviceaccount`, `githubapp` or `none`. The validation of this is case-sensitive.
               "syncBranch": "A String", # Optional. The branch of the repository to sync from. Default: master.
               "syncRepo": "A String", # Required. The URL of the Git repository to use as the source of truth.
-              "syncRev": "A String", # Optional. Git revision (tag or hash) to check out. Default HEAD.
+              "syncRev": "A String", # Optional. Git revision (tag or hash) or branch to sync from. Default `HEAD`. If not `HEAD`, takes precedence over `sync_branch` field. When using a hash, must be a full hash, and not an abbreviated form.
               "syncWaitSecs": "A String", # Optional. Period in seconds between consecutive syncs. Default: 15.
             },
             "metricsGcpServiceAccountEmail": "A String", # Optional. The Email of the Google Cloud Service Account (GSA) used for exporting Config Sync metrics to Cloud Monitoring and Cloud Monarch when Workload Identity is enabled. The GSA should have the Monitoring Metric Writer (roles/monitoring.metricWriter) IAM role. The Kubernetes ServiceAccount `default` in the namespace `config-management-monitoring` should be bound to the GSA. Deprecated: If Workload Identity Federation for GKE is enabled, Google Cloud Service Account is no longer needed for exporting Config Sync metrics: https://cloud.google.com/kubernetes-engine/enterprise/config-sync/docs/how-to/monitor-config-sync-cloud-monitoring#custom-monitoring.
             "oci": { # OCI repo configuration for a single cluster # Optional. OCI repo configuration for the cluster
-              "gcpServiceAccountEmail": "A String", # Optional. The Google Cloud Service Account Email used for auth when secret_type is `gcpserviceaccount`.
+              "gcpServiceAccountEmail": "A String", # Optional. The Google Cloud Service Account Email used for auth when secret_type is `gcpserviceaccount`. Annotates the `RootSync` or `RepoSync` controller's Kubernetes Service Account.
               "policyDir": "A String", # Optional. The absolute path of the directory that contains the local resources. Default: the root directory of the image.
               "secretType": "A String", # Required. Type of secret configured for access to the OCI repo. Must be one of `gcenode`, `gcpserviceaccount`, `k8sserviceaccount` or `none`. The validation of this is case-sensitive.
               "syncRepo": "A String", # Required. The OCI image repository URL for the package to sync from. e.g. `LOCATION-docker.pkg.dev/PROJECT_ID/REPOSITORY_NAME/PACKAGE_NAME`.
               "syncWaitSecs": "A String", # Optional. Period in seconds between consecutive syncs. Default: 15.
             },
             "preventDrift": True or False, # Optional. Set to true to enable the Config Sync admission webhook to prevent drifts. If set to false, disables the Config Sync admission webhook and does not prevent drifts. Defaults to false. See https://docs.cloud.google.com/kubernetes-engine/config-sync/docs/how-to/prevent-config-drift for details.
-            "sourceFormat": "A String", # Optional. Specifies whether the Config Sync repo is in `hierarchical` or `unstructured` mode. Defaults to `hierarchical`. See https://docs.cloud.google.com/kubernetes-engine/config-sync/docs/concepts/configs#organize-configs for an explanation.
+            "sourceFormat": "A String", # Optional. Specifies whether the Config Sync repo is in `hierarchy` or `unstructured` mode. Defaults to `hierarchy`. See https://docs.cloud.google.com/kubernetes-engine/config-sync/docs/concepts/configs#organize-configs for an explanation.
             "stopSyncing": True or False, # Optional. Set to true to stop syncing configs for a single cluster. Default to false.
           },
           "hierarchyController": { # Configuration for Hierarchy Controller # Optional. Hierarchy Controller configuration for the cluster. Deprecated: Configuring Hierarchy Controller through the configmanagement feature is no longer recommended. Use https://github.com/kubernetes-sigs/hierarchical-namespaces instead.
diff --git a/docs/dyn/gkehub_v1beta.projects.locations.features.html b/docs/dyn/gkehub_v1beta.projects.locations.features.html
index c2f07bde95..2c337173f2 100644
--- a/docs/dyn/gkehub_v1beta.projects.locations.features.html
+++ b/docs/dyn/gkehub_v1beta.projects.locations.features.html
@@ -146,25 +146,25 @@ 
Method Details

         ],
         "enabled": True or False, # Optional. Enables the installation of Config Sync. If set to true, the Feature will manage Config Sync resources, and apply the other ConfigSync fields if they exist. If set to false, the Feature will ignore all other ConfigSync fields and delete the Config Sync resources. If omitted, ConfigSync is considered enabled if the git or oci field is present.
         "git": { # Git repo configuration for a single cluster. # Optional. Git repo configuration for the cluster.
-          "gcpServiceAccountEmail": "A String", # Optional. The Google Cloud Service Account Email used for auth when secret_type is `gcpserviceaccount`.
-          "httpsProxy": "A String", # Optional. URL for the HTTPS proxy to be used when communicating with the Git repo. Only specify when secret_type is `cookiefile`, `token`, or `none`.
+          "gcpServiceAccountEmail": "A String", # Optional. The Google Cloud Service Account Email used for auth when secret_type is `gcpserviceaccount`. Annotates the `RootSync` or `RepoSync` controller's Kubernetes Service Account.
+          "httpsProxy": "A String", # Optional. URL for the HTTPS proxy to be used when communicating with the Git repo. Defines an HTTPS_PROXY environment variable and only accepts `https` or unadorned URLs. For example, `https://proxy.internal.business.co:443` or `proxy.internal.business.co:443`. If using an unadorned URL, make sure the communication between your proxy server and Git host is secure. Rejects `http://` URLs. Only specify when secret_type is `cookiefile`, `token`, or `none`.
           "policyDir": "A String", # Optional. The path within the Git repository that represents the top level of the repo to sync. Default: the root directory of the repository.
           "secretType": "A String", # Required. Type of secret configured for access to the Git repo. Must be one of `ssh`, `cookiefile`, `gcenode`, `token`, `gcpserviceaccount`, `githubapp` or `none`. The validation of this is case-sensitive.
           "syncBranch": "A String", # Optional. The branch of the repository to sync from. Default: master.
           "syncRepo": "A String", # Required. The URL of the Git repository to use as the source of truth.
-          "syncRev": "A String", # Optional. Git revision (tag or hash) to check out. Default HEAD.
+          "syncRev": "A String", # Optional. Git revision (tag or hash) or branch to sync from. Default `HEAD`. If not `HEAD`, takes precedence over `sync_branch` field. When using a hash, must be a full hash, and not an abbreviated form.
           "syncWaitSecs": "A String", # Optional. Period in seconds between consecutive syncs. Default: 15.
         },
         "metricsGcpServiceAccountEmail": "A String", # Optional. The Email of the Google Cloud Service Account (GSA) used for exporting Config Sync metrics to Cloud Monitoring and Cloud Monarch when Workload Identity is enabled. The GSA should have the Monitoring Metric Writer (roles/monitoring.metricWriter) IAM role. The Kubernetes ServiceAccount `default` in the namespace `config-management-monitoring` should be bound to the GSA. Deprecated: If Workload Identity Federation for GKE is enabled, Google Cloud Service Account is no longer needed for exporting Config Sync metrics: https://cloud.google.com/kubernetes-engine/enterprise/config-sync/docs/how-to/monitor-config-sync-cloud-monitoring#custom-monitoring.
         "oci": { # OCI repo configuration for a single cluster # Optional. OCI repo configuration for the cluster
-          "gcpServiceAccountEmail": "A String", # Optional. The Google Cloud Service Account Email used for auth when secret_type is `gcpserviceaccount`.
+          "gcpServiceAccountEmail": "A String", # Optional. The Google Cloud Service Account Email used for auth when secret_type is `gcpserviceaccount`. Annotates the `RootSync` or `RepoSync` controller's Kubernetes Service Account.
           "policyDir": "A String", # Optional. The absolute path of the directory that contains the local resources. Default: the root directory of the image.
           "secretType": "A String", # Required. Type of secret configured for access to the OCI repo. Must be one of `gcenode`, `gcpserviceaccount`, `k8sserviceaccount` or `none`. The validation of this is case-sensitive.
           "syncRepo": "A String", # Required. The OCI image repository URL for the package to sync from. e.g. `LOCATION-docker.pkg.dev/PROJECT_ID/REPOSITORY_NAME/PACKAGE_NAME`.
           "syncWaitSecs": "A String", # Optional. Period in seconds between consecutive syncs. Default: 15.
         },
         "preventDrift": True or False, # Optional. Set to true to enable the Config Sync admission webhook to prevent drifts. If set to false, disables the Config Sync admission webhook and does not prevent drifts. Defaults to false. See https://docs.cloud.google.com/kubernetes-engine/config-sync/docs/how-to/prevent-config-drift for details.
-        "sourceFormat": "A String", # Optional. Specifies whether the Config Sync repo is in `hierarchical` or `unstructured` mode. Defaults to `hierarchical`. See https://docs.cloud.google.com/kubernetes-engine/config-sync/docs/concepts/configs#organize-configs for an explanation.
+        "sourceFormat": "A String", # Optional. Specifies whether the Config Sync repo is in `hierarchy` or `unstructured` mode. Defaults to `hierarchy`. See https://docs.cloud.google.com/kubernetes-engine/config-sync/docs/concepts/configs#organize-configs for an explanation.
         "stopSyncing": True or False, # Optional. Set to true to stop syncing configs for a single cluster. Default to false.
       },
       "hierarchyController": { # Configuration for Hierarchy Controller # Optional. Hierarchy Controller configuration for the cluster. Deprecated: Configuring Hierarchy Controller through the configmanagement feature is no longer recommended. Use https://github.com/kubernetes-sigs/hierarchical-namespaces instead.
@@ -368,25 +368,25 @@ 
Method Details

           ],
           "enabled": True or False, # Optional. Enables the installation of Config Sync. If set to true, the Feature will manage Config Sync resources, and apply the other ConfigSync fields if they exist. If set to false, the Feature will ignore all other ConfigSync fields and delete the Config Sync resources. If omitted, ConfigSync is considered enabled if the git or oci field is present.
           "git": { # Git repo configuration for a single cluster. # Optional. Git repo configuration for the cluster.
-            "gcpServiceAccountEmail": "A String", # Optional. The Google Cloud Service Account Email used for auth when secret_type is `gcpserviceaccount`.
-            "httpsProxy": "A String", # Optional. URL for the HTTPS proxy to be used when communicating with the Git repo. Only specify when secret_type is `cookiefile`, `token`, or `none`.
+            "gcpServiceAccountEmail": "A String", # Optional. The Google Cloud Service Account Email used for auth when secret_type is `gcpserviceaccount`. Annotates the `RootSync` or `RepoSync` controller's Kubernetes Service Account.
+            "httpsProxy": "A String", # Optional. URL for the HTTPS proxy to be used when communicating with the Git repo. Defines an HTTPS_PROXY environment variable and only accepts `https` or unadorned URLs. For example, `https://proxy.internal.business.co:443` or `proxy.internal.business.co:443`. If using an unadorned URL, make sure the communication between your proxy server and Git host is secure. Rejects `http://` URLs. Only specify when secret_type is `cookiefile`, `token`, or `none`.
             "policyDir": "A String", # Optional. The path within the Git repository that represents the top level of the repo to sync. Default: the root directory of the repository.
             "secretType": "A String", # Required. Type of secret configured for access to the Git repo. Must be one of `ssh`, `cookiefile`, `gcenode`, `token`, `gcpserviceaccount`, `githubapp` or `none`. The validation of this is case-sensitive.
             "syncBranch": "A String", # Optional. The branch of the repository to sync from. Default: master.
             "syncRepo": "A String", # Required. The URL of the Git repository to use as the source of truth.
-            "syncRev": "A String", # Optional. Git revision (tag or hash) to check out. Default HEAD.
+            "syncRev": "A String", # Optional. Git revision (tag or hash) or branch to sync from. Default `HEAD`. If not `HEAD`, takes precedence over `sync_branch` field. When using a hash, must be a full hash, and not an abbreviated form.
             "syncWaitSecs": "A String", # Optional. Period in seconds between consecutive syncs. Default: 15.
           },
           "metricsGcpServiceAccountEmail": "A String", # Optional. The Email of the Google Cloud Service Account (GSA) used for exporting Config Sync metrics to Cloud Monitoring and Cloud Monarch when Workload Identity is enabled. The GSA should have the Monitoring Metric Writer (roles/monitoring.metricWriter) IAM role. The Kubernetes ServiceAccount `default` in the namespace `config-management-monitoring` should be bound to the GSA. Deprecated: If Workload Identity Federation for GKE is enabled, Google Cloud Service Account is no longer needed for exporting Config Sync metrics: https://cloud.google.com/kubernetes-engine/enterprise/config-sync/docs/how-to/monitor-config-sync-cloud-monitoring#custom-monitoring.
           "oci": { # OCI repo configuration for a single cluster # Optional. OCI repo configuration for the cluster
-            "gcpServiceAccountEmail": "A String", # Optional. The Google Cloud Service Account Email used for auth when secret_type is `gcpserviceaccount`.
+            "gcpServiceAccountEmail": "A String", # Optional. The Google Cloud Service Account Email used for auth when secret_type is `gcpserviceaccount`. Annotates the `RootSync` or `RepoSync` controller's Kubernetes Service Account.
             "policyDir": "A String", # Optional. The absolute path of the directory that contains the local resources. Default: the root directory of the image.
             "secretType": "A String", # Required. Type of secret configured for access to the OCI repo. Must be one of `gcenode`, `gcpserviceaccount`, `k8sserviceaccount` or `none`. The validation of this is case-sensitive.
             "syncRepo": "A String", # Required. The OCI image repository URL for the package to sync from. e.g. `LOCATION-docker.pkg.dev/PROJECT_ID/REPOSITORY_NAME/PACKAGE_NAME`.
             "syncWaitSecs": "A String", # Optional. Period in seconds between consecutive syncs. Default: 15.
           },
           "preventDrift": True or False, # Optional. Set to true to enable the Config Sync admission webhook to prevent drifts. If set to false, disables the Config Sync admission webhook and does not prevent drifts. Defaults to false. See https://docs.cloud.google.com/kubernetes-engine/config-sync/docs/how-to/prevent-config-drift for details.
-          "sourceFormat": "A String", # Optional. Specifies whether the Config Sync repo is in `hierarchical` or `unstructured` mode. Defaults to `hierarchical`. See https://docs.cloud.google.com/kubernetes-engine/config-sync/docs/concepts/configs#organize-configs for an explanation.
+          "sourceFormat": "A String", # Optional. Specifies whether the Config Sync repo is in `hierarchy` or `unstructured` mode. Defaults to `hierarchy`. See https://docs.cloud.google.com/kubernetes-engine/config-sync/docs/concepts/configs#organize-configs for an explanation.
           "stopSyncing": True or False, # Optional. Set to true to stop syncing configs for a single cluster. Default to false.
         },
         "hierarchyController": { # Configuration for Hierarchy Controller # Optional. Hierarchy Controller configuration for the cluster. Deprecated: Configuring Hierarchy Controller through the configmanagement feature is no longer recommended. Use https://github.com/kubernetes-sigs/hierarchical-namespaces instead.
@@ -693,25 +693,25 @@ 
Method Details

             ],
             "enabled": True or False, # Optional. Enables the installation of Config Sync. If set to true, the Feature will manage Config Sync resources, and apply the other ConfigSync fields if they exist. If set to false, the Feature will ignore all other ConfigSync fields and delete the Config Sync resources. If omitted, ConfigSync is considered enabled if the git or oci field is present.
             "git": { # Git repo configuration for a single cluster. # Optional. Git repo configuration for the cluster.
-              "gcpServiceAccountEmail": "A String", # Optional. The Google Cloud Service Account Email used for auth when secret_type is `gcpserviceaccount`.
-              "httpsProxy": "A String", # Optional. URL for the HTTPS proxy to be used when communicating with the Git repo. Only specify when secret_type is `cookiefile`, `token`, or `none`.
+              "gcpServiceAccountEmail": "A String", # Optional. The Google Cloud Service Account Email used for auth when secret_type is `gcpserviceaccount`. Annotates the `RootSync` or `RepoSync` controller's Kubernetes Service Account.
+              "httpsProxy": "A String", # Optional. URL for the HTTPS proxy to be used when communicating with the Git repo. Defines an HTTPS_PROXY environment variable and only accepts `https` or unadorned URLs. For example, `https://proxy.internal.business.co:443` or `proxy.internal.business.co:443`. If using an unadorned URL, make sure the communication between your proxy server and Git host is secure. Rejects `http://` URLs. Only specify when secret_type is `cookiefile`, `token`, or `none`.
               "policyDir": "A String", # Optional. The path within the Git repository that represents the top level of the repo to sync. Default: the root directory of the repository.
               "secretType": "A String", # Required. Type of secret configured for access to the Git repo. Must be one of `ssh`, `cookiefile`, `gcenode`, `token`, `gcpserviceaccount`, `githubapp` or `none`. The validation of this is case-sensitive.
               "syncBranch": "A String", # Optional. The branch of the repository to sync from. Default: master.
               "syncRepo": "A String", # Required. The URL of the Git repository to use as the source of truth.
-              "syncRev": "A String", # Optional. Git revision (tag or hash) to check out. Default HEAD.
+              "syncRev": "A String", # Optional. Git revision (tag or hash) or branch to sync from. Default `HEAD`. If not `HEAD`, takes precedence over `sync_branch` field. When using a hash, must be a full hash, and not an abbreviated form.
               "syncWaitSecs": "A String", # Optional. Period in seconds between consecutive syncs. Default: 15.
             },
             "metricsGcpServiceAccountEmail": "A String", # Optional. The Email of the Google Cloud Service Account (GSA) used for exporting Config Sync metrics to Cloud Monitoring and Cloud Monarch when Workload Identity is enabled. The GSA should have the Monitoring Metric Writer (roles/monitoring.metricWriter) IAM role. The Kubernetes ServiceAccount `default` in the namespace `config-management-monitoring` should be bound to the GSA. Deprecated: If Workload Identity Federation for GKE is enabled, Google Cloud Service Account is no longer needed for exporting Config Sync metrics: https://cloud.google.com/kubernetes-engine/enterprise/config-sync/docs/how-to/monitor-config-sync-cloud-monitoring#custom-monitoring.
             "oci": { # OCI repo configuration for a single cluster # Optional. OCI repo configuration for the cluster
-              "gcpServiceAccountEmail": "A String", # Optional. The Google Cloud Service Account Email used for auth when secret_type is `gcpserviceaccount`.
+              "gcpServiceAccountEmail": "A String", # Optional. The Google Cloud Service Account Email used for auth when secret_type is `gcpserviceaccount`. Annotates the `RootSync` or `RepoSync` controller's Kubernetes Service Account.
               "policyDir": "A String", # Optional. The absolute path of the directory that contains the local resources. Default: the root directory of the image.
               "secretType": "A String", # Required. Type of secret configured for access to the OCI repo. Must be one of `gcenode`, `gcpserviceaccount`, `k8sserviceaccount` or `none`. The validation of this is case-sensitive.
               "syncRepo": "A String", # Required. The OCI image repository URL for the package to sync from. e.g. `LOCATION-docker.pkg.dev/PROJECT_ID/REPOSITORY_NAME/PACKAGE_NAME`.
               "syncWaitSecs": "A String", # Optional. Period in seconds between consecutive syncs. Default: 15.
             },
             "preventDrift": True or False, # Optional. Set to true to enable the Config Sync admission webhook to prevent drifts. If set to false, disables the Config Sync admission webhook and does not prevent drifts. Defaults to false. See https://docs.cloud.google.com/kubernetes-engine/config-sync/docs/how-to/prevent-config-drift for details.
-            "sourceFormat": "A String", # Optional. Specifies whether the Config Sync repo is in `hierarchical` or `unstructured` mode. Defaults to `hierarchical`. See https://docs.cloud.google.com/kubernetes-engine/config-sync/docs/concepts/configs#organize-configs for an explanation.
+            "sourceFormat": "A String", # Optional. Specifies whether the Config Sync repo is in `hierarchy` or `unstructured` mode. Defaults to `hierarchy`. See https://docs.cloud.google.com/kubernetes-engine/config-sync/docs/concepts/configs#organize-configs for an explanation.
             "stopSyncing": True or False, # Optional. Set to true to stop syncing configs for a single cluster. Default to false.
           },
           "hierarchyController": { # Configuration for Hierarchy Controller # Optional. Hierarchy Controller configuration for the cluster. Deprecated: Configuring Hierarchy Controller through the configmanagement feature is no longer recommended. Use https://github.com/kubernetes-sigs/hierarchical-namespaces instead.
@@ -1225,25 +1225,25 @@ 
Method Details

         ],
         "enabled": True or False, # Optional. Enables the installation of Config Sync. If set to true, the Feature will manage Config Sync resources, and apply the other ConfigSync fields if they exist. If set to false, the Feature will ignore all other ConfigSync fields and delete the Config Sync resources. If omitted, ConfigSync is considered enabled if the git or oci field is present.
         "git": { # Git repo configuration for a single cluster. # Optional. Git repo configuration for the cluster.
-          "gcpServiceAccountEmail": "A String", # Optional. The Google Cloud Service Account Email used for auth when secret_type is `gcpserviceaccount`.
-          "httpsProxy": "A String", # Optional. URL for the HTTPS proxy to be used when communicating with the Git repo. Only specify when secret_type is `cookiefile`, `token`, or `none`.
+          "gcpServiceAccountEmail": "A String", # Optional. The Google Cloud Service Account Email used for auth when secret_type is `gcpserviceaccount`. Annotates the `RootSync` or `RepoSync` controller's Kubernetes Service Account.
+          "httpsProxy": "A String", # Optional. URL for the HTTPS proxy to be used when communicating with the Git repo. Defines an HTTPS_PROXY environment variable and only accepts `https` or unadorned URLs. For example, `https://proxy.internal.business.co:443` or `proxy.internal.business.co:443`. If using an unadorned URL, make sure the communication between your proxy server and Git host is secure. Rejects `http://` URLs. Only specify when secret_type is `cookiefile`, `token`, or `none`.
           "policyDir": "A String", # Optional. The path within the Git repository that represents the top level of the repo to sync. Default: the root directory of the repository.
           "secretType": "A String", # Required. Type of secret configured for access to the Git repo. Must be one of `ssh`, `cookiefile`, `gcenode`, `token`, `gcpserviceaccount`, `githubapp` or `none`. The validation of this is case-sensitive.
           "syncBranch": "A String", # Optional. The branch of the repository to sync from. Default: master.
           "syncRepo": "A String", # Required. The URL of the Git repository to use as the source of truth.
-          "syncRev": "A String", # Optional. Git revision (tag or hash) to check out. Default HEAD.
+          "syncRev": "A String", # Optional. Git revision (tag or hash) or branch to sync from. Default `HEAD`. If not `HEAD`, takes precedence over `sync_branch` field. When using a hash, must be a full hash, and not an abbreviated form.
           "syncWaitSecs": "A String", # Optional. Period in seconds between consecutive syncs. Default: 15.
         },
         "metricsGcpServiceAccountEmail": "A String", # Optional. The Email of the Google Cloud Service Account (GSA) used for exporting Config Sync metrics to Cloud Monitoring and Cloud Monarch when Workload Identity is enabled. The GSA should have the Monitoring Metric Writer (roles/monitoring.metricWriter) IAM role. The Kubernetes ServiceAccount `default` in the namespace `config-management-monitoring` should be bound to the GSA. Deprecated: If Workload Identity Federation for GKE is enabled, Google Cloud Service Account is no longer needed for exporting Config Sync metrics: https://cloud.google.com/kubernetes-engine/enterprise/config-sync/docs/how-to/monitor-config-sync-cloud-monitoring#custom-monitoring.
         "oci": { # OCI repo configuration for a single cluster # Optional. OCI repo configuration for the cluster
-          "gcpServiceAccountEmail": "A String", # Optional. The Google Cloud Service Account Email used for auth when secret_type is `gcpserviceaccount`.
+          "gcpServiceAccountEmail": "A String", # Optional. The Google Cloud Service Account Email used for auth when secret_type is `gcpserviceaccount`. Annotates the `RootSync` or `RepoSync` controller's Kubernetes Service Account.
           "policyDir": "A String", # Optional. The absolute path of the directory that contains the local resources. Default: the root directory of the image.
           "secretType": "A String", # Required. Type of secret configured for access to the OCI repo. Must be one of `gcenode`, `gcpserviceaccount`, `k8sserviceaccount` or `none`. The validation of this is case-sensitive.
           "syncRepo": "A String", # Required. The OCI image repository URL for the package to sync from. e.g. `LOCATION-docker.pkg.dev/PROJECT_ID/REPOSITORY_NAME/PACKAGE_NAME`.
           "syncWaitSecs": "A String", # Optional. Period in seconds between consecutive syncs. Default: 15.
         },
         "preventDrift": True or False, # Optional. Set to true to enable the Config Sync admission webhook to prevent drifts. If set to false, disables the Config Sync admission webhook and does not prevent drifts. Defaults to false. See https://docs.cloud.google.com/kubernetes-engine/config-sync/docs/how-to/prevent-config-drift for details.
-        "sourceFormat": "A String", # Optional. Specifies whether the Config Sync repo is in `hierarchical` or `unstructured` mode. Defaults to `hierarchical`. See https://docs.cloud.google.com/kubernetes-engine/config-sync/docs/concepts/configs#organize-configs for an explanation.
+        "sourceFormat": "A String", # Optional. Specifies whether the Config Sync repo is in `hierarchy` or `unstructured` mode. Defaults to `hierarchy`. See https://docs.cloud.google.com/kubernetes-engine/config-sync/docs/concepts/configs#organize-configs for an explanation.
         "stopSyncing": True or False, # Optional. Set to true to stop syncing configs for a single cluster. Default to false.
       },
       "hierarchyController": { # Configuration for Hierarchy Controller # Optional. Hierarchy Controller configuration for the cluster. Deprecated: Configuring Hierarchy Controller through the configmanagement feature is no longer recommended. Use https://github.com/kubernetes-sigs/hierarchical-namespaces instead.
@@ -1447,25 +1447,25 @@ 
Method Details

           ],
           "enabled": True or False, # Optional. Enables the installation of Config Sync. If set to true, the Feature will manage Config Sync resources, and apply the other ConfigSync fields if they exist. If set to false, the Feature will ignore all other ConfigSync fields and delete the Config Sync resources. If omitted, ConfigSync is considered enabled if the git or oci field is present.
           "git": { # Git repo configuration for a single cluster. # Optional. Git repo configuration for the cluster.
-            "gcpServiceAccountEmail": "A String", # Optional. The Google Cloud Service Account Email used for auth when secret_type is `gcpserviceaccount`.
-            "httpsProxy": "A String", # Optional. URL for the HTTPS proxy to be used when communicating with the Git repo. Only specify when secret_type is `cookiefile`, `token`, or `none`.
+            "gcpServiceAccountEmail": "A String", # Optional. The Google Cloud Service Account Email used for auth when secret_type is `gcpserviceaccount`. Annotates the `RootSync` or `RepoSync` controller's Kubernetes Service Account.
+            "httpsProxy": "A String", # Optional. URL for the HTTPS proxy to be used when communicating with the Git repo. Defines an HTTPS_PROXY environment variable and only accepts `https` or unadorned URLs. For example, `https://proxy.internal.business.co:443` or `proxy.internal.business.co:443`. If using an unadorned URL, make sure the communication between your proxy server and Git host is secure. Rejects `http://` URLs. Only specify when secret_type is `cookiefile`, `token`, or `none`.
             "policyDir": "A String", # Optional. The path within the Git repository that represents the top level of the repo to sync. Default: the root directory of the repository.
             "secretType": "A String", # Required. Type of secret configured for access to the Git repo. Must be one of `ssh`, `cookiefile`, `gcenode`, `token`, `gcpserviceaccount`, `githubapp` or `none`. The validation of this is case-sensitive.
             "syncBranch": "A String", # Optional. The branch of the repository to sync from. Default: master.
             "syncRepo": "A String", # Required. The URL of the Git repository to use as the source of truth.
-            "syncRev": "A String", # Optional. Git revision (tag or hash) to check out. Default HEAD.
+            "syncRev": "A String", # Optional. Git revision (tag or hash) or branch to sync from. Default `HEAD`. If not `HEAD`, takes precedence over `sync_branch` field. When using a hash, must be a full hash, and not an abbreviated form.
             "syncWaitSecs": "A String", # Optional. Period in seconds between consecutive syncs. Default: 15.
           },
           "metricsGcpServiceAccountEmail": "A String", # Optional. The Email of the Google Cloud Service Account (GSA) used for exporting Config Sync metrics to Cloud Monitoring and Cloud Monarch when Workload Identity is enabled. The GSA should have the Monitoring Metric Writer (roles/monitoring.metricWriter) IAM role. The Kubernetes ServiceAccount `default` in the namespace `config-management-monitoring` should be bound to the GSA. Deprecated: If Workload Identity Federation for GKE is enabled, Google Cloud Service Account is no longer needed for exporting Config Sync metrics: https://cloud.google.com/kubernetes-engine/enterprise/config-sync/docs/how-to/monitor-config-sync-cloud-monitoring#custom-monitoring.
           "oci": { # OCI repo configuration for a single cluster # Optional. OCI repo configuration for the cluster
-            "gcpServiceAccountEmail": "A String", # Optional. The Google Cloud Service Account Email used for auth when secret_type is `gcpserviceaccount`.
+            "gcpServiceAccountEmail": "A String", # Optional. The Google Cloud Service Account Email used for auth when secret_type is `gcpserviceaccount`. Annotates the `RootSync` or `RepoSync` controller's Kubernetes Service Account.
             "policyDir": "A String", # Optional. The absolute path of the directory that contains the local resources. Default: the root directory of the image.
             "secretType": "A String", # Required. Type of secret configured for access to the OCI repo. Must be one of `gcenode`, `gcpserviceaccount`, `k8sserviceaccount` or `none`. The validation of this is case-sensitive.
             "syncRepo": "A String", # Required. The OCI image repository URL for the package to sync from. e.g. `LOCATION-docker.pkg.dev/PROJECT_ID/REPOSITORY_NAME/PACKAGE_NAME`.
             "syncWaitSecs": "A String", # Optional. Period in seconds between consecutive syncs. Default: 15.
           },
           "preventDrift": True or False, # Optional. Set to true to enable the Config Sync admission webhook to prevent drifts. If set to false, disables the Config Sync admission webhook and does not prevent drifts. Defaults to false. See https://docs.cloud.google.com/kubernetes-engine/config-sync/docs/how-to/prevent-config-drift for details.
-          "sourceFormat": "A String", # Optional. Specifies whether the Config Sync repo is in `hierarchical` or `unstructured` mode. Defaults to `hierarchical`. See https://docs.cloud.google.com/kubernetes-engine/config-sync/docs/concepts/configs#organize-configs for an explanation.
+          "sourceFormat": "A String", # Optional. Specifies whether the Config Sync repo is in `hierarchy` or `unstructured` mode. Defaults to `hierarchy`. See https://docs.cloud.google.com/kubernetes-engine/config-sync/docs/concepts/configs#organize-configs for an explanation.
           "stopSyncing": True or False, # Optional. Set to true to stop syncing configs for a single cluster. Default to false.
         },
         "hierarchyController": { # Configuration for Hierarchy Controller # Optional. Hierarchy Controller configuration for the cluster. Deprecated: Configuring Hierarchy Controller through the configmanagement feature is no longer recommended. Use https://github.com/kubernetes-sigs/hierarchical-namespaces instead.
@@ -1772,25 +1772,25 @@ 
Method Details

             ],
             "enabled": True or False, # Optional. Enables the installation of Config Sync. If set to true, the Feature will manage Config Sync resources, and apply the other ConfigSync fields if they exist. If set to false, the Feature will ignore all other ConfigSync fields and delete the Config Sync resources. If omitted, ConfigSync is considered enabled if the git or oci field is present.
             "git": { # Git repo configuration for a single cluster. # Optional. Git repo configuration for the cluster.
-              "gcpServiceAccountEmail": "A String", # Optional. The Google Cloud Service Account Email used for auth when secret_type is `gcpserviceaccount`.
-              "httpsProxy": "A String", # Optional. URL for the HTTPS proxy to be used when communicating with the Git repo. Only specify when secret_type is `cookiefile`, `token`, or `none`.
+              "gcpServiceAccountEmail": "A String", # Optional. The Google Cloud Service Account Email used for auth when secret_type is `gcpserviceaccount`. Annotates the `RootSync` or `RepoSync` controller's Kubernetes Service Account.
+              "httpsProxy": "A String", # Optional. URL for the HTTPS proxy to be used when communicating with the Git repo. Defines an HTTPS_PROXY environment variable and only accepts `https` or unadorned URLs. For example, `https://proxy.internal.business.co:443` or `proxy.internal.business.co:443`. If using an unadorned URL, make sure the communication between your proxy server and Git host is secure. Rejects `http://` URLs. Only specify when secret_type is `cookiefile`, `token`, or `none`.
               "policyDir": "A String", # Optional. The path within the Git repository that represents the top level of the repo to sync. Default: the root directory of the repository.
               "secretType": "A String", # Required. Type of secret configured for access to the Git repo. Must be one of `ssh`, `cookiefile`, `gcenode`, `token`, `gcpserviceaccount`, `githubapp` or `none`. The validation of this is case-sensitive.
               "syncBranch": "A String", # Optional. The branch of the repository to sync from. Default: master.
               "syncRepo": "A String", # Required. The URL of the Git repository to use as the source of truth.
-              "syncRev": "A String", # Optional. Git revision (tag or hash) to check out. Default HEAD.
+              "syncRev": "A String", # Optional. Git revision (tag or hash) or branch to sync from. Default `HEAD`. If not `HEAD`, takes precedence over `sync_branch` field. When using a hash, must be a full hash, and not an abbreviated form.
               "syncWaitSecs": "A String", # Optional. Period in seconds between consecutive syncs. Default: 15.
             },
             "metricsGcpServiceAccountEmail": "A String", # Optional. The Email of the Google Cloud Service Account (GSA) used for exporting Config Sync metrics to Cloud Monitoring and Cloud Monarch when Workload Identity is enabled. The GSA should have the Monitoring Metric Writer (roles/monitoring.metricWriter) IAM role. The Kubernetes ServiceAccount `default` in the namespace `config-management-monitoring` should be bound to the GSA. Deprecated: If Workload Identity Federation for GKE is enabled, Google Cloud Service Account is no longer needed for exporting Config Sync metrics: https://cloud.google.com/kubernetes-engine/enterprise/config-sync/docs/how-to/monitor-config-sync-cloud-monitoring#custom-monitoring.
             "oci": { # OCI repo configuration for a single cluster # Optional. OCI repo configuration for the cluster
-              "gcpServiceAccountEmail": "A String", # Optional. The Google Cloud Service Account Email used for auth when secret_type is `gcpserviceaccount`.
+              "gcpServiceAccountEmail": "A String", # Optional. The Google Cloud Service Account Email used for auth when secret_type is `gcpserviceaccount`. Annotates the `RootSync` or `RepoSync` controller's Kubernetes Service Account.
               "policyDir": "A String", # Optional. The absolute path of the directory that contains the local resources. Default: the root directory of the image.
               "secretType": "A String", # Required. Type of secret configured for access to the OCI repo. Must be one of `gcenode`, `gcpserviceaccount`, `k8sserviceaccount` or `none`. The validation of this is case-sensitive.
               "syncRepo": "A String", # Required. The OCI image repository URL for the package to sync from. e.g. `LOCATION-docker.pkg.dev/PROJECT_ID/REPOSITORY_NAME/PACKAGE_NAME`.
               "syncWaitSecs": "A String", # Optional. Period in seconds between consecutive syncs. Default: 15.
             },
             "preventDrift": True or False, # Optional. Set to true to enable the Config Sync admission webhook to prevent drifts. If set to false, disables the Config Sync admission webhook and does not prevent drifts. Defaults to false. See https://docs.cloud.google.com/kubernetes-engine/config-sync/docs/how-to/prevent-config-drift for details.
-            "sourceFormat": "A String", # Optional. Specifies whether the Config Sync repo is in `hierarchical` or `unstructured` mode. Defaults to `hierarchical`. See https://docs.cloud.google.com/kubernetes-engine/config-sync/docs/concepts/configs#organize-configs for an explanation.
+            "sourceFormat": "A String", # Optional. Specifies whether the Config Sync repo is in `hierarchy` or `unstructured` mode. Defaults to `hierarchy`. See https://docs.cloud.google.com/kubernetes-engine/config-sync/docs/concepts/configs#organize-configs for an explanation.
             "stopSyncing": True or False, # Optional. Set to true to stop syncing configs for a single cluster. Default to false.
           },
           "hierarchyController": { # Configuration for Hierarchy Controller # Optional. Hierarchy Controller configuration for the cluster. Deprecated: Configuring Hierarchy Controller through the configmanagement feature is no longer recommended. Use https://github.com/kubernetes-sigs/hierarchical-namespaces instead.
@@ -2292,25 +2292,25 @@ 
Method Details

             ],
             "enabled": True or False, # Optional. Enables the installation of Config Sync. If set to true, the Feature will manage Config Sync resources, and apply the other ConfigSync fields if they exist. If set to false, the Feature will ignore all other ConfigSync fields and delete the Config Sync resources. If omitted, ConfigSync is considered enabled if the git or oci field is present.
             "git": { # Git repo configuration for a single cluster. # Optional. Git repo configuration for the cluster.
-              "gcpServiceAccountEmail": "A String", # Optional. The Google Cloud Service Account Email used for auth when secret_type is `gcpserviceaccount`.
-              "httpsProxy": "A String", # Optional. URL for the HTTPS proxy to be used when communicating with the Git repo. Only specify when secret_type is `cookiefile`, `token`, or `none`.
+              "gcpServiceAccountEmail": "A String", # Optional. The Google Cloud Service Account Email used for auth when secret_type is `gcpserviceaccount`. Annotates the `RootSync` or `RepoSync` controller's Kubernetes Service Account.
+              "httpsProxy": "A String", # Optional. URL for the HTTPS proxy to be used when communicating with the Git repo. Defines an HTTPS_PROXY environment variable and only accepts `https` or unadorned URLs. For example, `https://proxy.internal.business.co:443` or `proxy.internal.business.co:443`. If using an unadorned URL, make sure the communication between your proxy server and Git host is secure. Rejects `http://` URLs. Only specify when secret_type is `cookiefile`, `token`, or `none`.
               "policyDir": "A String", # Optional. The path within the Git repository that represents the top level of the repo to sync. Default: the root directory of the repository.
               "secretType": "A String", # Required. Type of secret configured for access to the Git repo. Must be one of `ssh`, `cookiefile`, `gcenode`, `token`, `gcpserviceaccount`, `githubapp` or `none`. The validation of this is case-sensitive.
               "syncBranch": "A String", # Optional. The branch of the repository to sync from. Default: master.
               "syncRepo": "A String", # Required. The URL of the Git repository to use as the source of truth.
-              "syncRev": "A String", # Optional. Git revision (tag or hash) to check out. Default HEAD.
+              "syncRev": "A String", # Optional. Git revision (tag or hash) or branch to sync from. Default `HEAD`. If not `HEAD`, takes precedence over `sync_branch` field. When using a hash, must be a full hash, and not an abbreviated form.
               "syncWaitSecs": "A String", # Optional. Period in seconds between consecutive syncs. Default: 15.
             },
             "metricsGcpServiceAccountEmail": "A String", # Optional. The Email of the Google Cloud Service Account (GSA) used for exporting Config Sync metrics to Cloud Monitoring and Cloud Monarch when Workload Identity is enabled. The GSA should have the Monitoring Metric Writer (roles/monitoring.metricWriter) IAM role. The Kubernetes ServiceAccount `default` in the namespace `config-management-monitoring` should be bound to the GSA. Deprecated: If Workload Identity Federation for GKE is enabled, Google Cloud Service Account is no longer needed for exporting Config Sync metrics: https://cloud.google.com/kubernetes-engine/enterprise/config-sync/docs/how-to/monitor-config-sync-cloud-monitoring#custom-monitoring.
             "oci": { # OCI repo configuration for a single cluster # Optional. OCI repo configuration for the cluster
-              "gcpServiceAccountEmail": "A String", # Optional. The Google Cloud Service Account Email used for auth when secret_type is `gcpserviceaccount`.
+              "gcpServiceAccountEmail": "A String", # Optional. The Google Cloud Service Account Email used for auth when secret_type is `gcpserviceaccount`. Annotates the `RootSync` or `RepoSync` controller's Kubernetes Service Account.
               "policyDir": "A String", # Optional. The absolute path of the directory that contains the local resources. Default: the root directory of the image.
               "secretType": "A String", # Required. Type of secret configured for access to the OCI repo. Must be one of `gcenode`, `gcpserviceaccount`, `k8sserviceaccount` or `none`. The validation of this is case-sensitive.
               "syncRepo": "A String", # Required. The OCI image repository URL for the package to sync from. e.g. `LOCATION-docker.pkg.dev/PROJECT_ID/REPOSITORY_NAME/PACKAGE_NAME`.
               "syncWaitSecs": "A String", # Optional. Period in seconds between consecutive syncs. Default: 15.
             },
             "preventDrift": True or False, # Optional. Set to true to enable the Config Sync admission webhook to prevent drifts. If set to false, disables the Config Sync admission webhook and does not prevent drifts. Defaults to false. See https://docs.cloud.google.com/kubernetes-engine/config-sync/docs/how-to/prevent-config-drift for details.
-            "sourceFormat": "A String", # Optional. Specifies whether the Config Sync repo is in `hierarchical` or `unstructured` mode. Defaults to `hierarchical`. See https://docs.cloud.google.com/kubernetes-engine/config-sync/docs/concepts/configs#organize-configs for an explanation.
+            "sourceFormat": "A String", # Optional. Specifies whether the Config Sync repo is in `hierarchy` or `unstructured` mode. Defaults to `hierarchy`. See https://docs.cloud.google.com/kubernetes-engine/config-sync/docs/concepts/configs#organize-configs for an explanation.
             "stopSyncing": True or False, # Optional. Set to true to stop syncing configs for a single cluster. Default to false.
           },
           "hierarchyController": { # Configuration for Hierarchy Controller # Optional. Hierarchy Controller configuration for the cluster. Deprecated: Configuring Hierarchy Controller through the configmanagement feature is no longer recommended. Use https://github.com/kubernetes-sigs/hierarchical-namespaces instead.
@@ -2514,25 +2514,25 @@ 
Method Details

               ],
               "enabled": True or False, # Optional. Enables the installation of Config Sync. If set to true, the Feature will manage Config Sync resources, and apply the other ConfigSync fields if they exist. If set to false, the Feature will ignore all other ConfigSync fields and delete the Config Sync resources. If omitted, ConfigSync is considered enabled if the git or oci field is present.
               "git": { # Git repo configuration for a single cluster. # Optional. Git repo configuration for the cluster.
-                "gcpServiceAccountEmail": "A String", # Optional. The Google Cloud Service Account Email used for auth when secret_type is `gcpserviceaccount`.
-                "httpsProxy": "A String", # Optional. URL for the HTTPS proxy to be used when communicating with the Git repo. Only specify when secret_type is `cookiefile`, `token`, or `none`.
+                "gcpServiceAccountEmail": "A String", # Optional. The Google Cloud Service Account Email used for auth when secret_type is `gcpserviceaccount`. Annotates the `RootSync` or `RepoSync` controller's Kubernetes Service Account.
+                "httpsProxy": "A String", # Optional. URL for the HTTPS proxy to be used when communicating with the Git repo. Defines an HTTPS_PROXY environment variable and only accepts `https` or unadorned URLs. For example, `https://proxy.internal.business.co:443` or `proxy.internal.business.co:443`. If using an unadorned URL, make sure the communication between your proxy server and Git host is secure. Rejects `http://` URLs. Only specify when secret_type is `cookiefile`, `token`, or `none`.
                 "policyDir": "A String", # Optional. The path within the Git repository that represents the top level of the repo to sync. Default: the root directory of the repository.
                 "secretType": "A String", # Required. Type of secret configured for access to the Git repo. Must be one of `ssh`, `cookiefile`, `gcenode`, `token`, `gcpserviceaccount`, `githubapp` or `none`. The validation of this is case-sensitive.
                 "syncBranch": "A String", # Optional. The branch of the repository to sync from. Default: master.
                 "syncRepo": "A String", # Required. The URL of the Git repository to use as the source of truth.
-                "syncRev": "A String", # Optional. Git revision (tag or hash) to check out. Default HEAD.
+                "syncRev": "A String", # Optional. Git revision (tag or hash) or branch to sync from. Default `HEAD`. If not `HEAD`, takes precedence over `sync_branch` field. When using a hash, must be a full hash, and not an abbreviated form.
                 "syncWaitSecs": "A String", # Optional. Period in seconds between consecutive syncs. Default: 15.
               },
               "metricsGcpServiceAccountEmail": "A String", # Optional. The Email of the Google Cloud Service Account (GSA) used for exporting Config Sync metrics to Cloud Monitoring and Cloud Monarch when Workload Identity is enabled. The GSA should have the Monitoring Metric Writer (roles/monitoring.metricWriter) IAM role. The Kubernetes ServiceAccount `default` in the namespace `config-management-monitoring` should be bound to the GSA. Deprecated: If Workload Identity Federation for GKE is enabled, Google Cloud Service Account is no longer needed for exporting Config Sync metrics: https://cloud.google.com/kubernetes-engine/enterprise/config-sync/docs/how-to/monitor-config-sync-cloud-monitoring#custom-monitoring.
               "oci": { # OCI repo configuration for a single cluster # Optional. OCI repo configuration for the cluster
-                "gcpServiceAccountEmail": "A String", # Optional. The Google Cloud Service Account Email used for auth when secret_type is `gcpserviceaccount`.
+                "gcpServiceAccountEmail": "A String", # Optional. The Google Cloud Service Account Email used for auth when secret_type is `gcpserviceaccount`. Annotates the `RootSync` or `RepoSync` controller's Kubernetes Service Account.
                 "policyDir": "A String", # Optional. The absolute path of the directory that contains the local resources. Default: the root directory of the image.
                 "secretType": "A String", # Required. Type of secret configured for access to the OCI repo. Must be one of `gcenode`, `gcpserviceaccount`, `k8sserviceaccount` or `none`. The validation of this is case-sensitive.
                 "syncRepo": "A String", # Required. The OCI image repository URL for the package to sync from. e.g. `LOCATION-docker.pkg.dev/PROJECT_ID/REPOSITORY_NAME/PACKAGE_NAME`.
                 "syncWaitSecs": "A String", # Optional. Period in seconds between consecutive syncs. Default: 15.
               },
               "preventDrift": True or False, # Optional. Set to true to enable the Config Sync admission webhook to prevent drifts. If set to false, disables the Config Sync admission webhook and does not prevent drifts. Defaults to false. See https://docs.cloud.google.com/kubernetes-engine/config-sync/docs/how-to/prevent-config-drift for details.
-              "sourceFormat": "A String", # Optional. Specifies whether the Config Sync repo is in `hierarchical` or `unstructured` mode. Defaults to `hierarchical`. See https://docs.cloud.google.com/kubernetes-engine/config-sync/docs/concepts/configs#organize-configs for an explanation.
+              "sourceFormat": "A String", # Optional. Specifies whether the Config Sync repo is in `hierarchy` or `unstructured` mode. Defaults to `hierarchy`. See https://docs.cloud.google.com/kubernetes-engine/config-sync/docs/concepts/configs#organize-configs for an explanation.
               "stopSyncing": True or False, # Optional. Set to true to stop syncing configs for a single cluster. Default to false.
             },
             "hierarchyController": { # Configuration for Hierarchy Controller # Optional. Hierarchy Controller configuration for the cluster. Deprecated: Configuring Hierarchy Controller through the configmanagement feature is no longer recommended. Use https://github.com/kubernetes-sigs/hierarchical-namespaces instead.
@@ -2839,25 +2839,25 @@ 
Method Details

                 ],
                 "enabled": True or False, # Optional. Enables the installation of Config Sync. If set to true, the Feature will manage Config Sync resources, and apply the other ConfigSync fields if they exist. If set to false, the Feature will ignore all other ConfigSync fields and delete the Config Sync resources. If omitted, ConfigSync is considered enabled if the git or oci field is present.
                 "git": { # Git repo configuration for a single cluster. # Optional. Git repo configuration for the cluster.
-                  "gcpServiceAccountEmail": "A String", # Optional. The Google Cloud Service Account Email used for auth when secret_type is `gcpserviceaccount`.
-                  "httpsProxy": "A String", # Optional. URL for the HTTPS proxy to be used when communicating with the Git repo. Only specify when secret_type is `cookiefile`, `token`, or `none`.
+                  "gcpServiceAccountEmail": "A String", # Optional. The Google Cloud Service Account Email used for auth when secret_type is `gcpserviceaccount`. Annotates the `RootSync` or `RepoSync` controller's Kubernetes Service Account.
+                  "httpsProxy": "A String", # Optional. URL for the HTTPS proxy to be used when communicating with the Git repo. Defines an HTTPS_PROXY environment variable and only accepts `https` or unadorned URLs. For example, `https://proxy.internal.business.co:443` or `proxy.internal.business.co:443`. If using an unadorned URL, make sure the communication between your proxy server and Git host is secure. Rejects `http://` URLs. Only specify when secret_type is `cookiefile`, `token`, or `none`.
                   "policyDir": "A String", # Optional. The path within the Git repository that represents the top level of the repo to sync. Default: the root directory of the repository.
                   "secretType": "A String", # Required. Type of secret configured for access to the Git repo. Must be one of `ssh`, `cookiefile`, `gcenode`, `token`, `gcpserviceaccount`, `githubapp` or `none`. The validation of this is case-sensitive.
                   "syncBranch": "A String", # Optional. The branch of the repository to sync from. Default: master.
                   "syncRepo": "A String", # Required. The URL of the Git repository to use as the source of truth.
-                  "syncRev": "A String", # Optional. Git revision (tag or hash) to check out. Default HEAD.
+                  "syncRev": "A String", # Optional. Git revision (tag or hash) or branch to sync from. Default `HEAD`. If not `HEAD`, takes precedence over `sync_branch` field. When using a hash, must be a full hash, and not an abbreviated form.
                   "syncWaitSecs": "A String", # Optional. Period in seconds between consecutive syncs. Default: 15.
                 },
                 "metricsGcpServiceAccountEmail": "A String", # Optional. The Email of the Google Cloud Service Account (GSA) used for exporting Config Sync metrics to Cloud Monitoring and Cloud Monarch when Workload Identity is enabled. The GSA should have the Monitoring Metric Writer (roles/monitoring.metricWriter) IAM role. The Kubernetes ServiceAccount `default` in the namespace `config-management-monitoring` should be bound to the GSA. Deprecated: If Workload Identity Federation for GKE is enabled, Google Cloud Service Account is no longer needed for exporting Config Sync metrics: https://cloud.google.com/kubernetes-engine/enterprise/config-sync/docs/how-to/monitor-config-sync-cloud-monitoring#custom-monitoring.
                 "oci": { # OCI repo configuration for a single cluster # Optional. OCI repo configuration for the cluster
-                  "gcpServiceAccountEmail": "A String", # Optional. The Google Cloud Service Account Email used for auth when secret_type is `gcpserviceaccount`.
+                  "gcpServiceAccountEmail": "A String", # Optional. The Google Cloud Service Account Email used for auth when secret_type is `gcpserviceaccount`. Annotates the `RootSync` or `RepoSync` controller's Kubernetes Service Account.
                   "policyDir": "A String", # Optional. The absolute path of the directory that contains the local resources. Default: the root directory of the image.
                   "secretType": "A String", # Required. Type of secret configured for access to the OCI repo. Must be one of `gcenode`, `gcpserviceaccount`, `k8sserviceaccount` or `none`. The validation of this is case-sensitive.
                   "syncRepo": "A String", # Required. The OCI image repository URL for the package to sync from. e.g. `LOCATION-docker.pkg.dev/PROJECT_ID/REPOSITORY_NAME/PACKAGE_NAME`.
                   "syncWaitSecs": "A String", # Optional. Period in seconds between consecutive syncs. Default: 15.
                 },
                 "preventDrift": True or False, # Optional. Set to true to enable the Config Sync admission webhook to prevent drifts. If set to false, disables the Config Sync admission webhook and does not prevent drifts. Defaults to false. See https://docs.cloud.google.com/kubernetes-engine/config-sync/docs/how-to/prevent-config-drift for details.
-                "sourceFormat": "A String", # Optional. Specifies whether the Config Sync repo is in `hierarchical` or `unstructured` mode. Defaults to `hierarchical`. See https://docs.cloud.google.com/kubernetes-engine/config-sync/docs/concepts/configs#organize-configs for an explanation.
+                "sourceFormat": "A String", # Optional. Specifies whether the Config Sync repo is in `hierarchy` or `unstructured` mode. Defaults to `hierarchy`. See https://docs.cloud.google.com/kubernetes-engine/config-sync/docs/concepts/configs#organize-configs for an explanation.
                 "stopSyncing": True or False, # Optional. Set to true to stop syncing configs for a single cluster. Default to false.
               },
               "hierarchyController": { # Configuration for Hierarchy Controller # Optional. Hierarchy Controller configuration for the cluster. Deprecated: Configuring Hierarchy Controller through the configmanagement feature is no longer recommended. Use https://github.com/kubernetes-sigs/hierarchical-namespaces instead.
@@ -3314,25 +3314,25 @@ 
Method Details

         ],
         "enabled": True or False, # Optional. Enables the installation of Config Sync. If set to true, the Feature will manage Config Sync resources, and apply the other ConfigSync fields if they exist. If set to false, the Feature will ignore all other ConfigSync fields and delete the Config Sync resources. If omitted, ConfigSync is considered enabled if the git or oci field is present.
         "git": { # Git repo configuration for a single cluster. # Optional. Git repo configuration for the cluster.
-          "gcpServiceAccountEmail": "A String", # Optional. The Google Cloud Service Account Email used for auth when secret_type is `gcpserviceaccount`.
-          "httpsProxy": "A String", # Optional. URL for the HTTPS proxy to be used when communicating with the Git repo. Only specify when secret_type is `cookiefile`, `token`, or `none`.
+          "gcpServiceAccountEmail": "A String", # Optional. The Google Cloud Service Account Email used for auth when secret_type is `gcpserviceaccount`. Annotates the `RootSync` or `RepoSync` controller's Kubernetes Service Account.
+          "httpsProxy": "A String", # Optional. URL for the HTTPS proxy to be used when communicating with the Git repo. Defines an HTTPS_PROXY environment variable and only accepts `https` or unadorned URLs. For example, `https://proxy.internal.business.co:443` or `proxy.internal.business.co:443`. If using an unadorned URL, make sure the communication between your proxy server and Git host is secure. Rejects `http://` URLs. Only specify when secret_type is `cookiefile`, `token`, or `none`.
           "policyDir": "A String", # Optional. The path within the Git repository that represents the top level of the repo to sync. Default: the root directory of the repository.
           "secretType": "A String", # Required. Type of secret configured for access to the Git repo. Must be one of `ssh`, `cookiefile`, `gcenode`, `token`, `gcpserviceaccount`, `githubapp` or `none`. The validation of this is case-sensitive.
           "syncBranch": "A String", # Optional. The branch of the repository to sync from. Default: master.
           "syncRepo": "A String", # Required. The URL of the Git repository to use as the source of truth.
-          "syncRev": "A String", # Optional. Git revision (tag or hash) to check out. Default HEAD.
+          "syncRev": "A String", # Optional. Git revision (tag or hash) or branch to sync from. Default `HEAD`. If not `HEAD`, takes precedence over `sync_branch` field. When using a hash, must be a full hash, and not an abbreviated form.
           "syncWaitSecs": "A String", # Optional. Period in seconds between consecutive syncs. Default: 15.
         },
         "metricsGcpServiceAccountEmail": "A String", # Optional. The Email of the Google Cloud Service Account (GSA) used for exporting Config Sync metrics to Cloud Monitoring and Cloud Monarch when Workload Identity is enabled. The GSA should have the Monitoring Metric Writer (roles/monitoring.metricWriter) IAM role. The Kubernetes ServiceAccount `default` in the namespace `config-management-monitoring` should be bound to the GSA. Deprecated: If Workload Identity Federation for GKE is enabled, Google Cloud Service Account is no longer needed for exporting Config Sync metrics: https://cloud.google.com/kubernetes-engine/enterprise/config-sync/docs/how-to/monitor-config-sync-cloud-monitoring#custom-monitoring.
         "oci": { # OCI repo configuration for a single cluster # Optional. OCI repo configuration for the cluster
-          "gcpServiceAccountEmail": "A String", # Optional. The Google Cloud Service Account Email used for auth when secret_type is `gcpserviceaccount`.
+          "gcpServiceAccountEmail": "A String", # Optional. The Google Cloud Service Account Email used for auth when secret_type is `gcpserviceaccount`. Annotates the `RootSync` or `RepoSync` controller's Kubernetes Service Account.
           "policyDir": "A String", # Optional. The absolute path of the directory that contains the local resources. Default: the root directory of the image.
           "secretType": "A String", # Required. Type of secret configured for access to the OCI repo. Must be one of `gcenode`, `gcpserviceaccount`, `k8sserviceaccount` or `none`. The validation of this is case-sensitive.
           "syncRepo": "A String", # Required. The OCI image repository URL for the package to sync from. e.g. `LOCATION-docker.pkg.dev/PROJECT_ID/REPOSITORY_NAME/PACKAGE_NAME`.
           "syncWaitSecs": "A String", # Optional. Period in seconds between consecutive syncs. Default: 15.
         },
         "preventDrift": True or False, # Optional. Set to true to enable the Config Sync admission webhook to prevent drifts. If set to false, disables the Config Sync admission webhook and does not prevent drifts. Defaults to false. See https://docs.cloud.google.com/kubernetes-engine/config-sync/docs/how-to/prevent-config-drift for details.
-        "sourceFormat": "A String", # Optional. Specifies whether the Config Sync repo is in `hierarchical` or `unstructured` mode. Defaults to `hierarchical`. See https://docs.cloud.google.com/kubernetes-engine/config-sync/docs/concepts/configs#organize-configs for an explanation.
+        "sourceFormat": "A String", # Optional. Specifies whether the Config Sync repo is in `hierarchy` or `unstructured` mode. Defaults to `hierarchy`. See https://docs.cloud.google.com/kubernetes-engine/config-sync/docs/concepts/configs#organize-configs for an explanation.
         "stopSyncing": True or False, # Optional. Set to true to stop syncing configs for a single cluster. Default to false.
       },
       "hierarchyController": { # Configuration for Hierarchy Controller # Optional. Hierarchy Controller configuration for the cluster. Deprecated: Configuring Hierarchy Controller through the configmanagement feature is no longer recommended. Use https://github.com/kubernetes-sigs/hierarchical-namespaces instead.
@@ -3536,25 +3536,25 @@ 
Method Details

           ],
           "enabled": True or False, # Optional. Enables the installation of Config Sync. If set to true, the Feature will manage Config Sync resources, and apply the other ConfigSync fields if they exist. If set to false, the Feature will ignore all other ConfigSync fields and delete the Config Sync resources. If omitted, ConfigSync is considered enabled if the git or oci field is present.
           "git": { # Git repo configuration for a single cluster. # Optional. Git repo configuration for the cluster.
-            "gcpServiceAccountEmail": "A String", # Optional. The Google Cloud Service Account Email used for auth when secret_type is `gcpserviceaccount`.
-            "httpsProxy": "A String", # Optional. URL for the HTTPS proxy to be used when communicating with the Git repo. Only specify when secret_type is `cookiefile`, `token`, or `none`.
+            "gcpServiceAccountEmail": "A String", # Optional. The Google Cloud Service Account Email used for auth when secret_type is `gcpserviceaccount`. Annotates the `RootSync` or `RepoSync` controller's Kubernetes Service Account.
+            "httpsProxy": "A String", # Optional. URL for the HTTPS proxy to be used when communicating with the Git repo. Defines an HTTPS_PROXY environment variable and only accepts `https` or unadorned URLs. For example, `https://proxy.internal.business.co:443` or `proxy.internal.business.co:443`. If using an unadorned URL, make sure the communication between your proxy server and Git host is secure. Rejects `http://` URLs. Only specify when secret_type is `cookiefile`, `token`, or `none`.
             "policyDir": "A String", # Optional. The path within the Git repository that represents the top level of the repo to sync. Default: the root directory of the repository.
             "secretType": "A String", # Required. Type of secret configured for access to the Git repo. Must be one of `ssh`, `cookiefile`, `gcenode`, `token`, `gcpserviceaccount`, `githubapp` or `none`. The validation of this is case-sensitive.
             "syncBranch": "A String", # Optional. The branch of the repository to sync from. Default: master.
             "syncRepo": "A String", # Required. The URL of the Git repository to use as the source of truth.
-            "syncRev": "A String", # Optional. Git revision (tag or hash) to check out. Default HEAD.
+            "syncRev": "A String", # Optional. Git revision (tag or hash) or branch to sync from. Default `HEAD`. If not `HEAD`, takes precedence over `sync_branch` field. When using a hash, must be a full hash, and not an abbreviated form.
             "syncWaitSecs": "A String", # Optional. Period in seconds between consecutive syncs. Default: 15.
           },
           "metricsGcpServiceAccountEmail": "A String", # Optional. The Email of the Google Cloud Service Account (GSA) used for exporting Config Sync metrics to Cloud Monitoring and Cloud Monarch when Workload Identity is enabled. The GSA should have the Monitoring Metric Writer (roles/monitoring.metricWriter) IAM role. The Kubernetes ServiceAccount `default` in the namespace `config-management-monitoring` should be bound to the GSA. Deprecated: If Workload Identity Federation for GKE is enabled, Google Cloud Service Account is no longer needed for exporting Config Sync metrics: https://cloud.google.com/kubernetes-engine/enterprise/config-sync/docs/how-to/monitor-config-sync-cloud-monitoring#custom-monitoring.
           "oci": { # OCI repo configuration for a single cluster # Optional. OCI repo configuration for the cluster
-            "gcpServiceAccountEmail": "A String", # Optional. The Google Cloud Service Account Email used for auth when secret_type is `gcpserviceaccount`.
+            "gcpServiceAccountEmail": "A String", # Optional. The Google Cloud Service Account Email used for auth when secret_type is `gcpserviceaccount`. Annotates the `RootSync` or `RepoSync` controller's Kubernetes Service Account.
             "policyDir": "A String", # Optional. The absolute path of the directory that contains the local resources. Default: the root directory of the image.
             "secretType": "A String", # Required. Type of secret configured for access to the OCI repo. Must be one of `gcenode`, `gcpserviceaccount`, `k8sserviceaccount` or `none`. The validation of this is case-sensitive.
             "syncRepo": "A String", # Required. The OCI image repository URL for the package to sync from. e.g. `LOCATION-docker.pkg.dev/PROJECT_ID/REPOSITORY_NAME/PACKAGE_NAME`.
             "syncWaitSecs": "A String", # Optional. Period in seconds between consecutive syncs. Default: 15.
           },
           "preventDrift": True or False, # Optional. Set to true to enable the Config Sync admission webhook to prevent drifts. If set to false, disables the Config Sync admission webhook and does not prevent drifts. Defaults to false. See https://docs.cloud.google.com/kubernetes-engine/config-sync/docs/how-to/prevent-config-drift for details.
-          "sourceFormat": "A String", # Optional. Specifies whether the Config Sync repo is in `hierarchical` or `unstructured` mode. Defaults to `hierarchical`. See https://docs.cloud.google.com/kubernetes-engine/config-sync/docs/concepts/configs#organize-configs for an explanation.
+          "sourceFormat": "A String", # Optional. Specifies whether the Config Sync repo is in `hierarchy` or `unstructured` mode. Defaults to `hierarchy`. See https://docs.cloud.google.com/kubernetes-engine/config-sync/docs/concepts/configs#organize-configs for an explanation.
           "stopSyncing": True or False, # Optional. Set to true to stop syncing configs for a single cluster. Default to false.
         },
         "hierarchyController": { # Configuration for Hierarchy Controller # Optional. Hierarchy Controller configuration for the cluster. Deprecated: Configuring Hierarchy Controller through the configmanagement feature is no longer recommended. Use https://github.com/kubernetes-sigs/hierarchical-namespaces instead.
@@ -3861,25 +3861,25 @@ 
Method Details

             ],
             "enabled": True or False, # Optional. Enables the installation of Config Sync. If set to true, the Feature will manage Config Sync resources, and apply the other ConfigSync fields if they exist. If set to false, the Feature will ignore all other ConfigSync fields and delete the Config Sync resources. If omitted, ConfigSync is considered enabled if the git or oci field is present.
             "git": { # Git repo configuration for a single cluster. # Optional. Git repo configuration for the cluster.
-              "gcpServiceAccountEmail": "A String", # Optional. The Google Cloud Service Account Email used for auth when secret_type is `gcpserviceaccount`.
-              "httpsProxy": "A String", # Optional. URL for the HTTPS proxy to be used when communicating with the Git repo. Only specify when secret_type is `cookiefile`, `token`, or `none`.
+              "gcpServiceAccountEmail": "A String", # Optional. The Google Cloud Service Account Email used for auth when secret_type is `gcpserviceaccount`. Annotates the `RootSync` or `RepoSync` controller's Kubernetes Service Account.
+              "httpsProxy": "A String", # Optional. URL for the HTTPS proxy to be used when communicating with the Git repo. Defines an HTTPS_PROXY environment variable and only accepts `https` or unadorned URLs. For example, `https://proxy.internal.business.co:443` or `proxy.internal.business.co:443`. If using an unadorned URL, make sure the communication between your proxy server and Git host is secure. Rejects `http://` URLs. Only specify when secret_type is `cookiefile`, `token`, or `none`.
               "policyDir": "A String", # Optional. The path within the Git repository that represents the top level of the repo to sync. Default: the root directory of the repository.
               "secretType": "A String", # Required. Type of secret configured for access to the Git repo. Must be one of `ssh`, `cookiefile`, `gcenode`, `token`, `gcpserviceaccount`, `githubapp` or `none`. The validation of this is case-sensitive.
               "syncBranch": "A String", # Optional. The branch of the repository to sync from. Default: master.
               "syncRepo": "A String", # Required. The URL of the Git repository to use as the source of truth.
-              "syncRev": "A String", # Optional. Git revision (tag or hash) to check out. Default HEAD.
+              "syncRev": "A String", # Optional. Git revision (tag or hash) or branch to sync from. Default `HEAD`. If not `HEAD`, takes precedence over `sync_branch` field. When using a hash, must be a full hash, and not an abbreviated form.
               "syncWaitSecs": "A String", # Optional. Period in seconds between consecutive syncs. Default: 15.
             },
             "metricsGcpServiceAccountEmail": "A String", # Optional. The Email of the Google Cloud Service Account (GSA) used for exporting Config Sync metrics to Cloud Monitoring and Cloud Monarch when Workload Identity is enabled. The GSA should have the Monitoring Metric Writer (roles/monitoring.metricWriter) IAM role. The Kubernetes ServiceAccount `default` in the namespace `config-management-monitoring` should be bound to the GSA. Deprecated: If Workload Identity Federation for GKE is enabled, Google Cloud Service Account is no longer needed for exporting Config Sync metrics: https://cloud.google.com/kubernetes-engine/enterprise/config-sync/docs/how-to/monitor-config-sync-cloud-monitoring#custom-monitoring.
             "oci": { # OCI repo configuration for a single cluster # Optional. OCI repo configuration for the cluster
-              "gcpServiceAccountEmail": "A String", # Optional. The Google Cloud Service Account Email used for auth when secret_type is `gcpserviceaccount`.
+              "gcpServiceAccountEmail": "A String", # Optional. The Google Cloud Service Account Email used for auth when secret_type is `gcpserviceaccount`. Annotates the `RootSync` or `RepoSync` controller's Kubernetes Service Account.
               "policyDir": "A String", # Optional. The absolute path of the directory that contains the local resources. Default: the root directory of the image.
               "secretType": "A String", # Required. Type of secret configured for access to the OCI repo. Must be one of `gcenode`, `gcpserviceaccount`, `k8sserviceaccount` or `none`. The validation of this is case-sensitive.
               "syncRepo": "A String", # Required. The OCI image repository URL for the package to sync from. e.g. `LOCATION-docker.pkg.dev/PROJECT_ID/REPOSITORY_NAME/PACKAGE_NAME`.
               "syncWaitSecs": "A String", # Optional. Period in seconds between consecutive syncs. Default: 15.
             },
             "preventDrift": True or False, # Optional. Set to true to enable the Config Sync admission webhook to prevent drifts. If set to false, disables the Config Sync admission webhook and does not prevent drifts. Defaults to false. See https://docs.cloud.google.com/kubernetes-engine/config-sync/docs/how-to/prevent-config-drift for details.
-            "sourceFormat": "A String", # Optional. Specifies whether the Config Sync repo is in `hierarchical` or `unstructured` mode. Defaults to `hierarchical`. See https://docs.cloud.google.com/kubernetes-engine/config-sync/docs/concepts/configs#organize-configs for an explanation.
+            "sourceFormat": "A String", # Optional. Specifies whether the Config Sync repo is in `hierarchy` or `unstructured` mode. Defaults to `hierarchy`. See https://docs.cloud.google.com/kubernetes-engine/config-sync/docs/concepts/configs#organize-configs for an explanation.
             "stopSyncing": True or False, # Optional. Set to true to stop syncing configs for a single cluster. Default to false.
           },
           "hierarchyController": { # Configuration for Hierarchy Controller # Optional. Hierarchy Controller configuration for the cluster. Deprecated: Configuring Hierarchy Controller through the configmanagement feature is no longer recommended. Use https://github.com/kubernetes-sigs/hierarchical-namespaces instead.
diff --git a/docs/dyn/gkehub_v2.projects.locations.memberships.features.html b/docs/dyn/gkehub_v2.projects.locations.memberships.features.html
index b529e0a19f..81289aff9a 100644
--- a/docs/dyn/gkehub_v2.projects.locations.memberships.features.html
+++ b/docs/dyn/gkehub_v2.projects.locations.memberships.features.html
@@ -148,25 +148,25 @@ 
Method Details

         ],
         "enabled": True or False, # Optional. Enables the installation of Config Sync. If set to true, the Feature will manage Config Sync resources, and apply the other ConfigSync fields if they exist. If set to false, the Feature will ignore all other ConfigSync fields and delete the Config Sync resources. If omitted, ConfigSync is considered enabled if the git or oci field is present.
         "git": { # Git repo configuration for a single cluster. # Optional. Git repo configuration for the cluster.
-          "gcpServiceAccountEmail": "A String", # Optional. The Google Cloud Service Account Email used for auth when secret_type is `gcpserviceaccount`.
-          "httpsProxy": "A String", # Optional. URL for the HTTPS proxy to be used when communicating with the Git repo. Only specify when secret_type is `cookiefile`, `token`, or `none`.
+          "gcpServiceAccountEmail": "A String", # Optional. The Google Cloud Service Account Email used for auth when secret_type is `gcpserviceaccount`. Annotates the `RootSync` or `RepoSync` controller's Kubernetes Service Account.
+          "httpsProxy": "A String", # Optional. URL for the HTTPS proxy to be used when communicating with the Git repo. Defines an HTTPS_PROXY environment variable and only accepts `https` or unadorned URLs. For example, `https://proxy.internal.business.co:443` or `proxy.internal.business.co:443`. If using an unadorned URL, make sure the communication between your proxy server and Git host is secure. Rejects `http://` URLs. Only specify when secret_type is `cookiefile`, `token`, or `none`.
           "policyDir": "A String", # Optional. The path within the Git repository that represents the top level of the repo to sync. Default: the root directory of the repository.
           "secretType": "A String", # Required. Type of secret configured for access to the Git repo. Must be one of `ssh`, `cookiefile`, `gcenode`, `token`, `gcpserviceaccount`, `githubapp` or `none`. The validation of this is case-sensitive.
           "syncBranch": "A String", # Optional. The branch of the repository to sync from. Default: master.
           "syncRepo": "A String", # Required. The URL of the Git repository to use as the source of truth.
-          "syncRev": "A String", # Optional. Git revision (tag or hash) to check out. Default HEAD.
+          "syncRev": "A String", # Optional. Git revision (tag or hash) or branch to sync from. Default `HEAD`. If not `HEAD`, takes precedence over `sync_branch` field. When using a hash, must be a full hash, and not an abbreviated form.
           "syncWaitSecs": "A String", # Optional. Period in seconds between consecutive syncs. Default: 15.
         },
         "metricsGcpServiceAccountEmail": "A String", # Optional. The Email of the Google Cloud Service Account (GSA) used for exporting Config Sync metrics to Cloud Monitoring and Cloud Monarch when Workload Identity is enabled. The GSA should have the Monitoring Metric Writer (roles/monitoring.metricWriter) IAM role. The Kubernetes ServiceAccount `default` in the namespace `config-management-monitoring` should be bound to the GSA. Deprecated: If Workload Identity Federation for GKE is enabled, Google Cloud Service Account is no longer needed for exporting Config Sync metrics: https://cloud.google.com/kubernetes-engine/enterprise/config-sync/docs/how-to/monitor-config-sync-cloud-monitoring#custom-monitoring.
         "oci": { # OCI repo configuration for a single cluster. # Optional. OCI repo configuration for the cluster.
-          "gcpServiceAccountEmail": "A String", # Optional. The Google Cloud Service Account Email used for auth when secret_type is `gcpserviceaccount`.
+          "gcpServiceAccountEmail": "A String", # Optional. The Google Cloud Service Account Email used for auth when secret_type is `gcpserviceaccount`. Annotates the `RootSync` or `RepoSync` controller's Kubernetes Service Account.
           "policyDir": "A String", # Optional. The absolute path of the directory that contains the local resources. Default: the root directory of the image.
           "secretType": "A String", # Required. Type of secret configured for access to the OCI repo. Must be one of `gcenode`, `gcpserviceaccount`, `k8sserviceaccount` or `none`. The validation of this is case-sensitive.
           "syncRepo": "A String", # Required. The OCI image repository URL for the package to sync from. e.g. `LOCATION-docker.pkg.dev/PROJECT_ID/REPOSITORY_NAME/PACKAGE_NAME`.
           "syncWaitSecs": "A String", # Optional. Period in seconds between consecutive syncs. Default: 15.
         },
         "preventDrift": True or False, # Optional. Set to true to enable the Config Sync admission webhook to prevent drifts. If set to false, disables the Config Sync admission webhook and does not prevent drifts. Defaults to false. See https://docs.cloud.google.com/kubernetes-engine/config-sync/docs/how-to/prevent-config-drift for details.
-        "sourceFormat": "A String", # Optional. Specifies whether the Config Sync repo is in `hierarchical` or `unstructured` mode. Defaults to `hierarchical`. See https://docs.cloud.google.com/kubernetes-engine/config-sync/docs/concepts/configs#organize-configs for an explanation.
+        "sourceFormat": "A String", # Optional. Specifies whether the Config Sync repo is in `hierarchy` or `unstructured` mode. Defaults to `hierarchy`. See https://docs.cloud.google.com/kubernetes-engine/config-sync/docs/concepts/configs#organize-configs for an explanation.
         "stopSyncing": True or False, # Optional. Set to true to stop syncing configs for a single cluster. Default to false.
       },
       "hierarchyController": { # Configuration for Hierarchy Controller. # Optional. Hierarchy Controller configuration for the cluster. Deprecated: Configuring Hierarchy Controller through the configmanagement feature is no longer recommended. Use https://github.com/kubernetes-sigs/hierarchical-namespaces instead.
@@ -475,25 +475,25 @@ 
Method Details

           ],
           "enabled": True or False, # Optional. Enables the installation of Config Sync. If set to true, the Feature will manage Config Sync resources, and apply the other ConfigSync fields if they exist. If set to false, the Feature will ignore all other ConfigSync fields and delete the Config Sync resources. If omitted, ConfigSync is considered enabled if the git or oci field is present.
           "git": { # Git repo configuration for a single cluster. # Optional. Git repo configuration for the cluster.
-            "gcpServiceAccountEmail": "A String", # Optional. The Google Cloud Service Account Email used for auth when secret_type is `gcpserviceaccount`.
-            "httpsProxy": "A String", # Optional. URL for the HTTPS proxy to be used when communicating with the Git repo. Only specify when secret_type is `cookiefile`, `token`, or `none`.
+            "gcpServiceAccountEmail": "A String", # Optional. The Google Cloud Service Account Email used for auth when secret_type is `gcpserviceaccount`. Annotates the `RootSync` or `RepoSync` controller's Kubernetes Service Account.
+            "httpsProxy": "A String", # Optional. URL for the HTTPS proxy to be used when communicating with the Git repo. Defines an HTTPS_PROXY environment variable and only accepts `https` or unadorned URLs. For example, `https://proxy.internal.business.co:443` or `proxy.internal.business.co:443`. If using an unadorned URL, make sure the communication between your proxy server and Git host is secure. Rejects `http://` URLs. Only specify when secret_type is `cookiefile`, `token`, or `none`.
             "policyDir": "A String", # Optional. The path within the Git repository that represents the top level of the repo to sync. Default: the root directory of the repository.
             "secretType": "A String", # Required. Type of secret configured for access to the Git repo. Must be one of `ssh`, `cookiefile`, `gcenode`, `token`, `gcpserviceaccount`, `githubapp` or `none`. The validation of this is case-sensitive.
             "syncBranch": "A String", # Optional. The branch of the repository to sync from. Default: master.
             "syncRepo": "A String", # Required. The URL of the Git repository to use as the source of truth.
-            "syncRev": "A String", # Optional. Git revision (tag or hash) to check out. Default HEAD.
+            "syncRev": "A String", # Optional. Git revision (tag or hash) or branch to sync from. Default `HEAD`. If not `HEAD`, takes precedence over `sync_branch` field. When using a hash, must be a full hash, and not an abbreviated form.
             "syncWaitSecs": "A String", # Optional. Period in seconds between consecutive syncs. Default: 15.
           },
           "metricsGcpServiceAccountEmail": "A String", # Optional. The Email of the Google Cloud Service Account (GSA) used for exporting Config Sync metrics to Cloud Monitoring and Cloud Monarch when Workload Identity is enabled. The GSA should have the Monitoring Metric Writer (roles/monitoring.metricWriter) IAM role. The Kubernetes ServiceAccount `default` in the namespace `config-management-monitoring` should be bound to the GSA. Deprecated: If Workload Identity Federation for GKE is enabled, Google Cloud Service Account is no longer needed for exporting Config Sync metrics: https://cloud.google.com/kubernetes-engine/enterprise/config-sync/docs/how-to/monitor-config-sync-cloud-monitoring#custom-monitoring.
           "oci": { # OCI repo configuration for a single cluster. # Optional. OCI repo configuration for the cluster.
-            "gcpServiceAccountEmail": "A String", # Optional. The Google Cloud Service Account Email used for auth when secret_type is `gcpserviceaccount`.
+            "gcpServiceAccountEmail": "A String", # Optional. The Google Cloud Service Account Email used for auth when secret_type is `gcpserviceaccount`. Annotates the `RootSync` or `RepoSync` controller's Kubernetes Service Account.
             "policyDir": "A String", # Optional. The absolute path of the directory that contains the local resources. Default: the root directory of the image.
             "secretType": "A String", # Required. Type of secret configured for access to the OCI repo. Must be one of `gcenode`, `gcpserviceaccount`, `k8sserviceaccount` or `none`. The validation of this is case-sensitive.
             "syncRepo": "A String", # Required. The OCI image repository URL for the package to sync from. e.g. `LOCATION-docker.pkg.dev/PROJECT_ID/REPOSITORY_NAME/PACKAGE_NAME`.
             "syncWaitSecs": "A String", # Optional. Period in seconds between consecutive syncs. Default: 15.
           },
           "preventDrift": True or False, # Optional. Set to true to enable the Config Sync admission webhook to prevent drifts. If set to false, disables the Config Sync admission webhook and does not prevent drifts. Defaults to false. See https://docs.cloud.google.com/kubernetes-engine/config-sync/docs/how-to/prevent-config-drift for details.
-          "sourceFormat": "A String", # Optional. Specifies whether the Config Sync repo is in `hierarchical` or `unstructured` mode. Defaults to `hierarchical`. See https://docs.cloud.google.com/kubernetes-engine/config-sync/docs/concepts/configs#organize-configs for an explanation.
+          "sourceFormat": "A String", # Optional. Specifies whether the Config Sync repo is in `hierarchy` or `unstructured` mode. Defaults to `hierarchy`. See https://docs.cloud.google.com/kubernetes-engine/config-sync/docs/concepts/configs#organize-configs for an explanation.
           "stopSyncing": True or False, # Optional. Set to true to stop syncing configs for a single cluster. Default to false.
         },
         "hierarchyController": { # Configuration for Hierarchy Controller. # Optional. Hierarchy Controller configuration for the cluster. Deprecated: Configuring Hierarchy Controller through the configmanagement feature is no longer recommended. Use https://github.com/kubernetes-sigs/hierarchical-namespaces instead.
@@ -856,25 +856,25 @@ 
Method Details

         ],
         "enabled": True or False, # Optional. Enables the installation of Config Sync. If set to true, the Feature will manage Config Sync resources, and apply the other ConfigSync fields if they exist. If set to false, the Feature will ignore all other ConfigSync fields and delete the Config Sync resources. If omitted, ConfigSync is considered enabled if the git or oci field is present.
         "git": { # Git repo configuration for a single cluster. # Optional. Git repo configuration for the cluster.
-          "gcpServiceAccountEmail": "A String", # Optional. The Google Cloud Service Account Email used for auth when secret_type is `gcpserviceaccount`.
-          "httpsProxy": "A String", # Optional. URL for the HTTPS proxy to be used when communicating with the Git repo. Only specify when secret_type is `cookiefile`, `token`, or `none`.
+          "gcpServiceAccountEmail": "A String", # Optional. The Google Cloud Service Account Email used for auth when secret_type is `gcpserviceaccount`. Annotates the `RootSync` or `RepoSync` controller's Kubernetes Service Account.
+          "httpsProxy": "A String", # Optional. URL for the HTTPS proxy to be used when communicating with the Git repo. Defines an HTTPS_PROXY environment variable and only accepts `https` or unadorned URLs. For example, `https://proxy.internal.business.co:443` or `proxy.internal.business.co:443`. If using an unadorned URL, make sure the communication between your proxy server and Git host is secure. Rejects `http://` URLs. Only specify when secret_type is `cookiefile`, `token`, or `none`.
           "policyDir": "A String", # Optional. The path within the Git repository that represents the top level of the repo to sync. Default: the root directory of the repository.
           "secretType": "A String", # Required. Type of secret configured for access to the Git repo. Must be one of `ssh`, `cookiefile`, `gcenode`, `token`, `gcpserviceaccount`, `githubapp` or `none`. The validation of this is case-sensitive.
           "syncBranch": "A String", # Optional. The branch of the repository to sync from. Default: master.
           "syncRepo": "A String", # Required. The URL of the Git repository to use as the source of truth.
-          "syncRev": "A String", # Optional. Git revision (tag or hash) to check out. Default HEAD.
+          "syncRev": "A String", # Optional. Git revision (tag or hash) or branch to sync from. Default `HEAD`. If not `HEAD`, takes precedence over `sync_branch` field. When using a hash, must be a full hash, and not an abbreviated form.
           "syncWaitSecs": "A String", # Optional. Period in seconds between consecutive syncs. Default: 15.
         },
         "metricsGcpServiceAccountEmail": "A String", # Optional. The Email of the Google Cloud Service Account (GSA) used for exporting Config Sync metrics to Cloud Monitoring and Cloud Monarch when Workload Identity is enabled. The GSA should have the Monitoring Metric Writer (roles/monitoring.metricWriter) IAM role. The Kubernetes ServiceAccount `default` in the namespace `config-management-monitoring` should be bound to the GSA. Deprecated: If Workload Identity Federation for GKE is enabled, Google Cloud Service Account is no longer needed for exporting Config Sync metrics: https://cloud.google.com/kubernetes-engine/enterprise/config-sync/docs/how-to/monitor-config-sync-cloud-monitoring#custom-monitoring.
         "oci": { # OCI repo configuration for a single cluster. # Optional. OCI repo configuration for the cluster.
-          "gcpServiceAccountEmail": "A String", # Optional. The Google Cloud Service Account Email used for auth when secret_type is `gcpserviceaccount`.
+          "gcpServiceAccountEmail": "A String", # Optional. The Google Cloud Service Account Email used for auth when secret_type is `gcpserviceaccount`. Annotates the `RootSync` or `RepoSync` controller's Kubernetes Service Account.
           "policyDir": "A String", # Optional. The absolute path of the directory that contains the local resources. Default: the root directory of the image.
           "secretType": "A String", # Required. Type of secret configured for access to the OCI repo. Must be one of `gcenode`, `gcpserviceaccount`, `k8sserviceaccount` or `none`. The validation of this is case-sensitive.
           "syncRepo": "A String", # Required. The OCI image repository URL for the package to sync from. e.g. `LOCATION-docker.pkg.dev/PROJECT_ID/REPOSITORY_NAME/PACKAGE_NAME`.
           "syncWaitSecs": "A String", # Optional. Period in seconds between consecutive syncs. Default: 15.
         },
         "preventDrift": True or False, # Optional. Set to true to enable the Config Sync admission webhook to prevent drifts. If set to false, disables the Config Sync admission webhook and does not prevent drifts. Defaults to false. See https://docs.cloud.google.com/kubernetes-engine/config-sync/docs/how-to/prevent-config-drift for details.
-        "sourceFormat": "A String", # Optional. Specifies whether the Config Sync repo is in `hierarchical` or `unstructured` mode. Defaults to `hierarchical`. See https://docs.cloud.google.com/kubernetes-engine/config-sync/docs/concepts/configs#organize-configs for an explanation.
+        "sourceFormat": "A String", # Optional. Specifies whether the Config Sync repo is in `hierarchy` or `unstructured` mode. Defaults to `hierarchy`. See https://docs.cloud.google.com/kubernetes-engine/config-sync/docs/concepts/configs#organize-configs for an explanation.
         "stopSyncing": True or False, # Optional. Set to true to stop syncing configs for a single cluster. Default to false.
       },
       "hierarchyController": { # Configuration for Hierarchy Controller. # Optional. Hierarchy Controller configuration for the cluster. Deprecated: Configuring Hierarchy Controller through the configmanagement feature is no longer recommended. Use https://github.com/kubernetes-sigs/hierarchical-namespaces instead.
@@ -1183,25 +1183,25 @@ 
Method Details

           ],
           "enabled": True or False, # Optional. Enables the installation of Config Sync. If set to true, the Feature will manage Config Sync resources, and apply the other ConfigSync fields if they exist. If set to false, the Feature will ignore all other ConfigSync fields and delete the Config Sync resources. If omitted, ConfigSync is considered enabled if the git or oci field is present.
           "git": { # Git repo configuration for a single cluster. # Optional. Git repo configuration for the cluster.
-            "gcpServiceAccountEmail": "A String", # Optional. The Google Cloud Service Account Email used for auth when secret_type is `gcpserviceaccount`.
-            "httpsProxy": "A String", # Optional. URL for the HTTPS proxy to be used when communicating with the Git repo. Only specify when secret_type is `cookiefile`, `token`, or `none`.
+            "gcpServiceAccountEmail": "A String", # Optional. The Google Cloud Service Account Email used for auth when secret_type is `gcpserviceaccount`. Annotates the `RootSync` or `RepoSync` controller's Kubernetes Service Account.
+            "httpsProxy": "A String", # Optional. URL for the HTTPS proxy to be used when communicating with the Git repo. Defines an HTTPS_PROXY environment variable and only accepts `https` or unadorned URLs. For example, `https://proxy.internal.business.co:443` or `proxy.internal.business.co:443`. If using an unadorned URL, make sure the communication between your proxy server and Git host is secure. Rejects `http://` URLs. Only specify when secret_type is `cookiefile`, `token`, or `none`.
             "policyDir": "A String", # Optional. The path within the Git repository that represents the top level of the repo to sync. Default: the root directory of the repository.
             "secretType": "A String", # Required. Type of secret configured for access to the Git repo. Must be one of `ssh`, `cookiefile`, `gcenode`, `token`, `gcpserviceaccount`, `githubapp` or `none`. The validation of this is case-sensitive.
             "syncBranch": "A String", # Optional. The branch of the repository to sync from. Default: master.
             "syncRepo": "A String", # Required. The URL of the Git repository to use as the source of truth.
-            "syncRev": "A String", # Optional. Git revision (tag or hash) to check out. Default HEAD.
+            "syncRev": "A String", # Optional. Git revision (tag or hash) or branch to sync from. Default `HEAD`. If not `HEAD`, takes precedence over `sync_branch` field. When using a hash, must be a full hash, and not an abbreviated form.
             "syncWaitSecs": "A String", # Optional. Period in seconds between consecutive syncs. Default: 15.
           },
           "metricsGcpServiceAccountEmail": "A String", # Optional. The Email of the Google Cloud Service Account (GSA) used for exporting Config Sync metrics to Cloud Monitoring and Cloud Monarch when Workload Identity is enabled. The GSA should have the Monitoring Metric Writer (roles/monitoring.metricWriter) IAM role. The Kubernetes ServiceAccount `default` in the namespace `config-management-monitoring` should be bound to the GSA. Deprecated: If Workload Identity Federation for GKE is enabled, Google Cloud Service Account is no longer needed for exporting Config Sync metrics: https://cloud.google.com/kubernetes-engine/enterprise/config-sync/docs/how-to/monitor-config-sync-cloud-monitoring#custom-monitoring.
           "oci": { # OCI repo configuration for a single cluster. # Optional. OCI repo configuration for the cluster.
-            "gcpServiceAccountEmail": "A String", # Optional. The Google Cloud Service Account Email used for auth when secret_type is `gcpserviceaccount`.
+            "gcpServiceAccountEmail": "A String", # Optional. The Google Cloud Service Account Email used for auth when secret_type is `gcpserviceaccount`. Annotates the `RootSync` or `RepoSync` controller's Kubernetes Service Account.
             "policyDir": "A String", # Optional. The absolute path of the directory that contains the local resources. Default: the root directory of the image.
             "secretType": "A String", # Required. Type of secret configured for access to the OCI repo. Must be one of `gcenode`, `gcpserviceaccount`, `k8sserviceaccount` or `none`. The validation of this is case-sensitive.
             "syncRepo": "A String", # Required. The OCI image repository URL for the package to sync from. e.g. `LOCATION-docker.pkg.dev/PROJECT_ID/REPOSITORY_NAME/PACKAGE_NAME`.
             "syncWaitSecs": "A String", # Optional. Period in seconds between consecutive syncs. Default: 15.
           },
           "preventDrift": True or False, # Optional. Set to true to enable the Config Sync admission webhook to prevent drifts. If set to false, disables the Config Sync admission webhook and does not prevent drifts. Defaults to false. See https://docs.cloud.google.com/kubernetes-engine/config-sync/docs/how-to/prevent-config-drift for details.
-          "sourceFormat": "A String", # Optional. Specifies whether the Config Sync repo is in `hierarchical` or `unstructured` mode. Defaults to `hierarchical`. See https://docs.cloud.google.com/kubernetes-engine/config-sync/docs/concepts/configs#organize-configs for an explanation.
+          "sourceFormat": "A String", # Optional. Specifies whether the Config Sync repo is in `hierarchy` or `unstructured` mode. Defaults to `hierarchy`. See https://docs.cloud.google.com/kubernetes-engine/config-sync/docs/concepts/configs#organize-configs for an explanation.
           "stopSyncing": True or False, # Optional. Set to true to stop syncing configs for a single cluster. Default to false.
         },
         "hierarchyController": { # Configuration for Hierarchy Controller. # Optional. Hierarchy Controller configuration for the cluster. Deprecated: Configuring Hierarchy Controller through the configmanagement feature is no longer recommended. Use https://github.com/kubernetes-sigs/hierarchical-namespaces instead.
@@ -1504,25 +1504,25 @@ 
Method Details

             ],
             "enabled": True or False, # Optional. Enables the installation of Config Sync. If set to true, the Feature will manage Config Sync resources, and apply the other ConfigSync fields if they exist. If set to false, the Feature will ignore all other ConfigSync fields and delete the Config Sync resources. If omitted, ConfigSync is considered enabled if the git or oci field is present.
             "git": { # Git repo configuration for a single cluster. # Optional. Git repo configuration for the cluster.
-              "gcpServiceAccountEmail": "A String", # Optional. The Google Cloud Service Account Email used for auth when secret_type is `gcpserviceaccount`.
-              "httpsProxy": "A String", # Optional. URL for the HTTPS proxy to be used when communicating with the Git repo. Only specify when secret_type is `cookiefile`, `token`, or `none`.
+              "gcpServiceAccountEmail": "A String", # Optional. The Google Cloud Service Account Email used for auth when secret_type is `gcpserviceaccount`. Annotates the `RootSync` or `RepoSync` controller's Kubernetes Service Account.
+              "httpsProxy": "A String", # Optional. URL for the HTTPS proxy to be used when communicating with the Git repo. Defines an HTTPS_PROXY environment variable and only accepts `https` or unadorned URLs. For example, `https://proxy.internal.business.co:443` or `proxy.internal.business.co:443`. If using an unadorned URL, make sure the communication between your proxy server and Git host is secure. Rejects `http://` URLs. Only specify when secret_type is `cookiefile`, `token`, or `none`.
               "policyDir": "A String", # Optional. The path within the Git repository that represents the top level of the repo to sync. Default: the root directory of the repository.
               "secretType": "A String", # Required. Type of secret configured for access to the Git repo. Must be one of `ssh`, `cookiefile`, `gcenode`, `token`, `gcpserviceaccount`, `githubapp` or `none`. The validation of this is case-sensitive.
               "syncBranch": "A String", # Optional. The branch of the repository to sync from. Default: master.
               "syncRepo": "A String", # Required. The URL of the Git repository to use as the source of truth.
-              "syncRev": "A String", # Optional. Git revision (tag or hash) to check out. Default HEAD.
+              "syncRev": "A String", # Optional. Git revision (tag or hash) or branch to sync from. Default `HEAD`. If not `HEAD`, takes precedence over `sync_branch` field. When using a hash, must be a full hash, and not an abbreviated form.
               "syncWaitSecs": "A String", # Optional. Period in seconds between consecutive syncs. Default: 15.
             },
             "metricsGcpServiceAccountEmail": "A String", # Optional. The Email of the Google Cloud Service Account (GSA) used for exporting Config Sync metrics to Cloud Monitoring and Cloud Monarch when Workload Identity is enabled. The GSA should have the Monitoring Metric Writer (roles/monitoring.metricWriter) IAM role. The Kubernetes ServiceAccount `default` in the namespace `config-management-monitoring` should be bound to the GSA. Deprecated: If Workload Identity Federation for GKE is enabled, Google Cloud Service Account is no longer needed for exporting Config Sync metrics: https://cloud.google.com/kubernetes-engine/enterprise/config-sync/docs/how-to/monitor-config-sync-cloud-monitoring#custom-monitoring.
             "oci": { # OCI repo configuration for a single cluster. # Optional. OCI repo configuration for the cluster.
-              "gcpServiceAccountEmail": "A String", # Optional. The Google Cloud Service Account Email used for auth when secret_type is `gcpserviceaccount`.
+              "gcpServiceAccountEmail": "A String", # Optional. The Google Cloud Service Account Email used for auth when secret_type is `gcpserviceaccount`. Annotates the `RootSync` or `RepoSync` controller's Kubernetes Service Account.
               "policyDir": "A String", # Optional. The absolute path of the directory that contains the local resources. Default: the root directory of the image.
               "secretType": "A String", # Required. Type of secret configured for access to the OCI repo. Must be one of `gcenode`, `gcpserviceaccount`, `k8sserviceaccount` or `none`. The validation of this is case-sensitive.
               "syncRepo": "A String", # Required. The OCI image repository URL for the package to sync from. e.g. `LOCATION-docker.pkg.dev/PROJECT_ID/REPOSITORY_NAME/PACKAGE_NAME`.
               "syncWaitSecs": "A String", # Optional. Period in seconds between consecutive syncs. Default: 15.
             },
             "preventDrift": True or False, # Optional. Set to true to enable the Config Sync admission webhook to prevent drifts. If set to false, disables the Config Sync admission webhook and does not prevent drifts. Defaults to false. See https://docs.cloud.google.com/kubernetes-engine/config-sync/docs/how-to/prevent-config-drift for details.
-            "sourceFormat": "A String", # Optional. Specifies whether the Config Sync repo is in `hierarchical` or `unstructured` mode. Defaults to `hierarchical`. See https://docs.cloud.google.com/kubernetes-engine/config-sync/docs/concepts/configs#organize-configs for an explanation.
+            "sourceFormat": "A String", # Optional. Specifies whether the Config Sync repo is in `hierarchy` or `unstructured` mode. Defaults to `hierarchy`. See https://docs.cloud.google.com/kubernetes-engine/config-sync/docs/concepts/configs#organize-configs for an explanation.
             "stopSyncing": True or False, # Optional. Set to true to stop syncing configs for a single cluster. Default to false.
           },
           "hierarchyController": { # Configuration for Hierarchy Controller. # Optional. Hierarchy Controller configuration for the cluster. Deprecated: Configuring Hierarchy Controller through the configmanagement feature is no longer recommended. Use https://github.com/kubernetes-sigs/hierarchical-namespaces instead.
@@ -1831,25 +1831,25 @@ 
Method Details

               ],
               "enabled": True or False, # Optional. Enables the installation of Config Sync. If set to true, the Feature will manage Config Sync resources, and apply the other ConfigSync fields if they exist. If set to false, the Feature will ignore all other ConfigSync fields and delete the Config Sync resources. If omitted, ConfigSync is considered enabled if the git or oci field is present.
               "git": { # Git repo configuration for a single cluster. # Optional. Git repo configuration for the cluster.
-                "gcpServiceAccountEmail": "A String", # Optional. The Google Cloud Service Account Email used for auth when secret_type is `gcpserviceaccount`.
-                "httpsProxy": "A String", # Optional. URL for the HTTPS proxy to be used when communicating with the Git repo. Only specify when secret_type is `cookiefile`, `token`, or `none`.
+                "gcpServiceAccountEmail": "A String", # Optional. The Google Cloud Service Account Email used for auth when secret_type is `gcpserviceaccount`. Annotates the `RootSync` or `RepoSync` controller's Kubernetes Service Account.
+                "httpsProxy": "A String", # Optional. URL for the HTTPS proxy to be used when communicating with the Git repo. Defines an HTTPS_PROXY environment variable and only accepts `https` or unadorned URLs. For example, `https://proxy.internal.business.co:443` or `proxy.internal.business.co:443`. If using an unadorned URL, make sure the communication between your proxy server and Git host is secure. Rejects `http://` URLs. Only specify when secret_type is `cookiefile`, `token`, or `none`.
                 "policyDir": "A String", # Optional. The path within the Git repository that represents the top level of the repo to sync. Default: the root directory of the repository.
                 "secretType": "A String", # Required. Type of secret configured for access to the Git repo. Must be one of `ssh`, `cookiefile`, `gcenode`, `token`, `gcpserviceaccount`, `githubapp` or `none`. The validation of this is case-sensitive.
                 "syncBranch": "A String", # Optional. The branch of the repository to sync from. Default: master.
                 "syncRepo": "A String", # Required. The URL of the Git repository to use as the source of truth.
-                "syncRev": "A String", # Optional. Git revision (tag or hash) to check out. Default HEAD.
+                "syncRev": "A String", # Optional. Git revision (tag or hash) or branch to sync from. Default `HEAD`. If not `HEAD`, takes precedence over `sync_branch` field. When using a hash, must be a full hash, and not an abbreviated form.
                 "syncWaitSecs": "A String", # Optional. Period in seconds between consecutive syncs. Default: 15.
               },
               "metricsGcpServiceAccountEmail": "A String", # Optional. The Email of the Google Cloud Service Account (GSA) used for exporting Config Sync metrics to Cloud Monitoring and Cloud Monarch when Workload Identity is enabled. The GSA should have the Monitoring Metric Writer (roles/monitoring.metricWriter) IAM role. The Kubernetes ServiceAccount `default` in the namespace `config-management-monitoring` should be bound to the GSA. Deprecated: If Workload Identity Federation for GKE is enabled, Google Cloud Service Account is no longer needed for exporting Config Sync metrics: https://cloud.google.com/kubernetes-engine/enterprise/config-sync/docs/how-to/monitor-config-sync-cloud-monitoring#custom-monitoring.
               "oci": { # OCI repo configuration for a single cluster. # Optional. OCI repo configuration for the cluster.
-                "gcpServiceAccountEmail": "A String", # Optional. The Google Cloud Service Account Email used for auth when secret_type is `gcpserviceaccount`.
+                "gcpServiceAccountEmail": "A String", # Optional. The Google Cloud Service Account Email used for auth when secret_type is `gcpserviceaccount`. Annotates the `RootSync` or `RepoSync` controller's Kubernetes Service Account.
                 "policyDir": "A String", # Optional. The absolute path of the directory that contains the local resources. Default: the root directory of the image.
                 "secretType": "A String", # Required. Type of secret configured for access to the OCI repo. Must be one of `gcenode`, `gcpserviceaccount`, `k8sserviceaccount` or `none`. The validation of this is case-sensitive.
                 "syncRepo": "A String", # Required. The OCI image repository URL for the package to sync from. e.g. `LOCATION-docker.pkg.dev/PROJECT_ID/REPOSITORY_NAME/PACKAGE_NAME`.
                 "syncWaitSecs": "A String", # Optional. Period in seconds between consecutive syncs. Default: 15.
               },
               "preventDrift": True or False, # Optional. Set to true to enable the Config Sync admission webhook to prevent drifts. If set to false, disables the Config Sync admission webhook and does not prevent drifts. Defaults to false. See https://docs.cloud.google.com/kubernetes-engine/config-sync/docs/how-to/prevent-config-drift for details.
-              "sourceFormat": "A String", # Optional. Specifies whether the Config Sync repo is in `hierarchical` or `unstructured` mode. Defaults to `hierarchical`. See https://docs.cloud.google.com/kubernetes-engine/config-sync/docs/concepts/configs#organize-configs for an explanation.
+              "sourceFormat": "A String", # Optional. Specifies whether the Config Sync repo is in `hierarchy` or `unstructured` mode. Defaults to `hierarchy`. See https://docs.cloud.google.com/kubernetes-engine/config-sync/docs/concepts/configs#organize-configs for an explanation.
               "stopSyncing": True or False, # Optional. Set to true to stop syncing configs for a single cluster. Default to false.
             },
             "hierarchyController": { # Configuration for Hierarchy Controller. # Optional. Hierarchy Controller configuration for the cluster. Deprecated: Configuring Hierarchy Controller through the configmanagement feature is no longer recommended. Use https://github.com/kubernetes-sigs/hierarchical-namespaces instead.
@@ -2161,25 +2161,25 @@ 
Method Details

         ],
         "enabled": True or False, # Optional. Enables the installation of Config Sync. If set to true, the Feature will manage Config Sync resources, and apply the other ConfigSync fields if they exist. If set to false, the Feature will ignore all other ConfigSync fields and delete the Config Sync resources. If omitted, ConfigSync is considered enabled if the git or oci field is present.
         "git": { # Git repo configuration for a single cluster. # Optional. Git repo configuration for the cluster.
-          "gcpServiceAccountEmail": "A String", # Optional. The Google Cloud Service Account Email used for auth when secret_type is `gcpserviceaccount`.
-          "httpsProxy": "A String", # Optional. URL for the HTTPS proxy to be used when communicating with the Git repo. Only specify when secret_type is `cookiefile`, `token`, or `none`.
+          "gcpServiceAccountEmail": "A String", # Optional. The Google Cloud Service Account Email used for auth when secret_type is `gcpserviceaccount`. Annotates the `RootSync` or `RepoSync` controller's Kubernetes Service Account.
+          "httpsProxy": "A String", # Optional. URL for the HTTPS proxy to be used when communicating with the Git repo. Defines an HTTPS_PROXY environment variable and only accepts `https` or unadorned URLs. For example, `https://proxy.internal.business.co:443` or `proxy.internal.business.co:443`. If using an unadorned URL, make sure the communication between your proxy server and Git host is secure. Rejects `http://` URLs. Only specify when secret_type is `cookiefile`, `token`, or `none`.
           "policyDir": "A String", # Optional. The path within the Git repository that represents the top level of the repo to sync. Default: the root directory of the repository.
           "secretType": "A String", # Required. Type of secret configured for access to the Git repo. Must be one of `ssh`, `cookiefile`, `gcenode`, `token`, `gcpserviceaccount`, `githubapp` or `none`. The validation of this is case-sensitive.
           "syncBranch": "A String", # Optional. The branch of the repository to sync from. Default: master.
           "syncRepo": "A String", # Required. The URL of the Git repository to use as the source of truth.
-          "syncRev": "A String", # Optional. Git revision (tag or hash) to check out. Default HEAD.
+          "syncRev": "A String", # Optional. Git revision (tag or hash) or branch to sync from. Default `HEAD`. If not `HEAD`, takes precedence over `sync_branch` field. When using a hash, must be a full hash, and not an abbreviated form.
           "syncWaitSecs": "A String", # Optional. Period in seconds between consecutive syncs. Default: 15.
         },
         "metricsGcpServiceAccountEmail": "A String", # Optional. The Email of the Google Cloud Service Account (GSA) used for exporting Config Sync metrics to Cloud Monitoring and Cloud Monarch when Workload Identity is enabled. The GSA should have the Monitoring Metric Writer (roles/monitoring.metricWriter) IAM role. The Kubernetes ServiceAccount `default` in the namespace `config-management-monitoring` should be bound to the GSA. Deprecated: If Workload Identity Federation for GKE is enabled, Google Cloud Service Account is no longer needed for exporting Config Sync metrics: https://cloud.google.com/kubernetes-engine/enterprise/config-sync/docs/how-to/monitor-config-sync-cloud-monitoring#custom-monitoring.
         "oci": { # OCI repo configuration for a single cluster. # Optional. OCI repo configuration for the cluster.
-          "gcpServiceAccountEmail": "A String", # Optional. The Google Cloud Service Account Email used for auth when secret_type is `gcpserviceaccount`.
+          "gcpServiceAccountEmail": "A String", # Optional. The Google Cloud Service Account Email used for auth when secret_type is `gcpserviceaccount`. Annotates the `RootSync` or `RepoSync` controller's Kubernetes Service Account.
           "policyDir": "A String", # Optional. The absolute path of the directory that contains the local resources. Default: the root directory of the image.
           "secretType": "A String", # Required. Type of secret configured for access to the OCI repo. Must be one of `gcenode`, `gcpserviceaccount`, `k8sserviceaccount` or `none`. The validation of this is case-sensitive.
           "syncRepo": "A String", # Required. The OCI image repository URL for the package to sync from. e.g. `LOCATION-docker.pkg.dev/PROJECT_ID/REPOSITORY_NAME/PACKAGE_NAME`.
           "syncWaitSecs": "A String", # Optional. Period in seconds between consecutive syncs. Default: 15.
         },
         "preventDrift": True or False, # Optional. Set to true to enable the Config Sync admission webhook to prevent drifts. If set to false, disables the Config Sync admission webhook and does not prevent drifts. Defaults to false. See https://docs.cloud.google.com/kubernetes-engine/config-sync/docs/how-to/prevent-config-drift for details.
-        "sourceFormat": "A String", # Optional. Specifies whether the Config Sync repo is in `hierarchical` or `unstructured` mode. Defaults to `hierarchical`. See https://docs.cloud.google.com/kubernetes-engine/config-sync/docs/concepts/configs#organize-configs for an explanation.
+        "sourceFormat": "A String", # Optional. Specifies whether the Config Sync repo is in `hierarchy` or `unstructured` mode. Defaults to `hierarchy`. See https://docs.cloud.google.com/kubernetes-engine/config-sync/docs/concepts/configs#organize-configs for an explanation.
         "stopSyncing": True or False, # Optional. Set to true to stop syncing configs for a single cluster. Default to false.
       },
       "hierarchyController": { # Configuration for Hierarchy Controller. # Optional. Hierarchy Controller configuration for the cluster. Deprecated: Configuring Hierarchy Controller through the configmanagement feature is no longer recommended. Use https://github.com/kubernetes-sigs/hierarchical-namespaces instead.
@@ -2488,25 +2488,25 @@ 
Method Details

           ],
           "enabled": True or False, # Optional. Enables the installation of Config Sync. If set to true, the Feature will manage Config Sync resources, and apply the other ConfigSync fields if they exist. If set to false, the Feature will ignore all other ConfigSync fields and delete the Config Sync resources. If omitted, ConfigSync is considered enabled if the git or oci field is present.
           "git": { # Git repo configuration for a single cluster. # Optional. Git repo configuration for the cluster.
-            "gcpServiceAccountEmail": "A String", # Optional. The Google Cloud Service Account Email used for auth when secret_type is `gcpserviceaccount`.
-            "httpsProxy": "A String", # Optional. URL for the HTTPS proxy to be used when communicating with the Git repo. Only specify when secret_type is `cookiefile`, `token`, or `none`.
+            "gcpServiceAccountEmail": "A String", # Optional. The Google Cloud Service Account Email used for auth when secret_type is `gcpserviceaccount`. Annotates the `RootSync` or `RepoSync` controller's Kubernetes Service Account.
+            "httpsProxy": "A String", # Optional. URL for the HTTPS proxy to be used when communicating with the Git repo. Defines an HTTPS_PROXY environment variable and only accepts `https` or unadorned URLs. For example, `https://proxy.internal.business.co:443` or `proxy.internal.business.co:443`. If using an unadorned URL, make sure the communication between your proxy server and Git host is secure. Rejects `http://` URLs. Only specify when secret_type is `cookiefile`, `token`, or `none`.
             "policyDir": "A String", # Optional. The path within the Git repository that represents the top level of the repo to sync. Default: the root directory of the repository.
             "secretType": "A String", # Required. Type of secret configured for access to the Git repo. Must be one of `ssh`, `cookiefile`, `gcenode`, `token`, `gcpserviceaccount`, `githubapp` or `none`. The validation of this is case-sensitive.
             "syncBranch": "A String", # Optional. The branch of the repository to sync from. Default: master.
             "syncRepo": "A String", # Required. The URL of the Git repository to use as the source of truth.
-            "syncRev": "A String", # Optional. Git revision (tag or hash) to check out. Default HEAD.
+            "syncRev": "A String", # Optional. Git revision (tag or hash) or branch to sync from. Default `HEAD`. If not `HEAD`, takes precedence over `sync_branch` field. When using a hash, must be a full hash, and not an abbreviated form.
             "syncWaitSecs": "A String", # Optional. Period in seconds between consecutive syncs. Default: 15.
           },
           "metricsGcpServiceAccountEmail": "A String", # Optional. The Email of the Google Cloud Service Account (GSA) used for exporting Config Sync metrics to Cloud Monitoring and Cloud Monarch when Workload Identity is enabled. The GSA should have the Monitoring Metric Writer (roles/monitoring.metricWriter) IAM role. The Kubernetes ServiceAccount `default` in the namespace `config-management-monitoring` should be bound to the GSA. Deprecated: If Workload Identity Federation for GKE is enabled, Google Cloud Service Account is no longer needed for exporting Config Sync metrics: https://cloud.google.com/kubernetes-engine/enterprise/config-sync/docs/how-to/monitor-config-sync-cloud-monitoring#custom-monitoring.
           "oci": { # OCI repo configuration for a single cluster. # Optional. OCI repo configuration for the cluster.
-            "gcpServiceAccountEmail": "A String", # Optional. The Google Cloud Service Account Email used for auth when secret_type is `gcpserviceaccount`.
+            "gcpServiceAccountEmail": "A String", # Optional. The Google Cloud Service Account Email used for auth when secret_type is `gcpserviceaccount`. Annotates the `RootSync` or `RepoSync` controller's Kubernetes Service Account.
             "policyDir": "A String", # Optional. The absolute path of the directory that contains the local resources. Default: the root directory of the image.
             "secretType": "A String", # Required. Type of secret configured for access to the OCI repo. Must be one of `gcenode`, `gcpserviceaccount`, `k8sserviceaccount` or `none`. The validation of this is case-sensitive.
             "syncRepo": "A String", # Required. The OCI image repository URL for the package to sync from. e.g. `LOCATION-docker.pkg.dev/PROJECT_ID/REPOSITORY_NAME/PACKAGE_NAME`.
             "syncWaitSecs": "A String", # Optional. Period in seconds between consecutive syncs. Default: 15.
           },
           "preventDrift": True or False, # Optional. Set to true to enable the Config Sync admission webhook to prevent drifts. If set to false, disables the Config Sync admission webhook and does not prevent drifts. Defaults to false. See https://docs.cloud.google.com/kubernetes-engine/config-sync/docs/how-to/prevent-config-drift for details.
-          "sourceFormat": "A String", # Optional. Specifies whether the Config Sync repo is in `hierarchical` or `unstructured` mode. Defaults to `hierarchical`. See https://docs.cloud.google.com/kubernetes-engine/config-sync/docs/concepts/configs#organize-configs for an explanation.
+          "sourceFormat": "A String", # Optional. Specifies whether the Config Sync repo is in `hierarchy` or `unstructured` mode. Defaults to `hierarchy`. See https://docs.cloud.google.com/kubernetes-engine/config-sync/docs/concepts/configs#organize-configs for an explanation.
           "stopSyncing": True or False, # Optional. Set to true to stop syncing configs for a single cluster. Default to false.
         },
         "hierarchyController": { # Configuration for Hierarchy Controller. # Optional. Hierarchy Controller configuration for the cluster. Deprecated: Configuring Hierarchy Controller through the configmanagement feature is no longer recommended. Use https://github.com/kubernetes-sigs/hierarchical-namespaces instead.
diff --git a/docs/dyn/gkehub_v2alpha.projects.locations.memberships.features.html b/docs/dyn/gkehub_v2alpha.projects.locations.memberships.features.html
index 0b3e8c128a..3ba2d2da85 100644
--- a/docs/dyn/gkehub_v2alpha.projects.locations.memberships.features.html
+++ b/docs/dyn/gkehub_v2alpha.projects.locations.memberships.features.html
@@ -148,25 +148,25 @@ 
Method Details

         ],
         "enabled": True or False, # Optional. Enables the installation of Config Sync. If set to true, the Feature will manage Config Sync resources, and apply the other ConfigSync fields if they exist. If set to false, the Feature will ignore all other ConfigSync fields and delete the Config Sync resources. If omitted, ConfigSync is considered enabled if the git or oci field is present.
         "git": { # Git repo configuration for a single cluster. # Optional. Git repo configuration for the cluster.
-          "gcpServiceAccountEmail": "A String", # Optional. The Google Cloud Service Account Email used for auth when secret_type is `gcpserviceaccount`.
-          "httpsProxy": "A String", # Optional. URL for the HTTPS proxy to be used when communicating with the Git repo. Only specify when secret_type is `cookiefile`, `token`, or `none`.
+          "gcpServiceAccountEmail": "A String", # Optional. The Google Cloud Service Account Email used for auth when secret_type is `gcpserviceaccount`. Annotates the `RootSync` or `RepoSync` controller's Kubernetes Service Account.
+          "httpsProxy": "A String", # Optional. URL for the HTTPS proxy to be used when communicating with the Git repo. Defines an HTTPS_PROXY environment variable and only accepts `https` or unadorned URLs. For example, `https://proxy.internal.business.co:443` or `proxy.internal.business.co:443`. If using an unadorned URL, make sure the communication between your proxy server and Git host is secure. Rejects `http://` URLs. Only specify when secret_type is `cookiefile`, `token`, or `none`.
           "policyDir": "A String", # Optional. The path within the Git repository that represents the top level of the repo to sync. Default: the root directory of the repository.
           "secretType": "A String", # Required. Type of secret configured for access to the Git repo. Must be one of `ssh`, `cookiefile`, `gcenode`, `token`, `gcpserviceaccount`, `githubapp` or `none`. The validation of this is case-sensitive.
           "syncBranch": "A String", # Optional. The branch of the repository to sync from. Default: master.
           "syncRepo": "A String", # Required. The URL of the Git repository to use as the source of truth.
-          "syncRev": "A String", # Optional. Git revision (tag or hash) to check out. Default HEAD.
+          "syncRev": "A String", # Optional. Git revision (tag or hash) or branch to sync from. Default `HEAD`. If not `HEAD`, takes precedence over `sync_branch` field. When using a hash, must be a full hash, and not an abbreviated form.
           "syncWaitSecs": "A String", # Optional. Period in seconds between consecutive syncs. Default: 15.
         },
         "metricsGcpServiceAccountEmail": "A String", # Optional. The Email of the Google Cloud Service Account (GSA) used for exporting Config Sync metrics to Cloud Monitoring and Cloud Monarch when Workload Identity is enabled. The GSA should have the Monitoring Metric Writer (roles/monitoring.metricWriter) IAM role. The Kubernetes ServiceAccount `default` in the namespace `config-management-monitoring` should be bound to the GSA. Deprecated: If Workload Identity Federation for GKE is enabled, Google Cloud Service Account is no longer needed for exporting Config Sync metrics: https://cloud.google.com/kubernetes-engine/enterprise/config-sync/docs/how-to/monitor-config-sync-cloud-monitoring#custom-monitoring.
         "oci": { # OCI repo configuration for a single cluster. # Optional. OCI repo configuration for the cluster.
-          "gcpServiceAccountEmail": "A String", # Optional. The Google Cloud Service Account Email used for auth when secret_type is `gcpserviceaccount`.
+          "gcpServiceAccountEmail": "A String", # Optional. The Google Cloud Service Account Email used for auth when secret_type is `gcpserviceaccount`. Annotates the `RootSync` or `RepoSync` controller's Kubernetes Service Account.
           "policyDir": "A String", # Optional. The absolute path of the directory that contains the local resources. Default: the root directory of the image.
           "secretType": "A String", # Required. Type of secret configured for access to the OCI repo. Must be one of `gcenode`, `gcpserviceaccount`, `k8sserviceaccount` or `none`. The validation of this is case-sensitive.
           "syncRepo": "A String", # Required. The OCI image repository URL for the package to sync from. e.g. `LOCATION-docker.pkg.dev/PROJECT_ID/REPOSITORY_NAME/PACKAGE_NAME`.
           "syncWaitSecs": "A String", # Optional. Period in seconds between consecutive syncs. Default: 15.
         },
         "preventDrift": True or False, # Optional. Set to true to enable the Config Sync admission webhook to prevent drifts. If set to false, disables the Config Sync admission webhook and does not prevent drifts. Defaults to false. See https://docs.cloud.google.com/kubernetes-engine/config-sync/docs/how-to/prevent-config-drift for details.
-        "sourceFormat": "A String", # Optional. Specifies whether the Config Sync repo is in `hierarchical` or `unstructured` mode. Defaults to `hierarchical`. See https://docs.cloud.google.com/kubernetes-engine/config-sync/docs/concepts/configs#organize-configs for an explanation.
+        "sourceFormat": "A String", # Optional. Specifies whether the Config Sync repo is in `hierarchy` or `unstructured` mode. Defaults to `hierarchy`. See https://docs.cloud.google.com/kubernetes-engine/config-sync/docs/concepts/configs#organize-configs for an explanation.
         "stopSyncing": True or False, # Optional. Set to true to stop syncing configs for a single cluster. Default to false.
       },
       "hierarchyController": { # Configuration for Hierarchy Controller. # Optional. Hierarchy Controller configuration for the cluster. Deprecated: Configuring Hierarchy Controller through the configmanagement feature is no longer recommended. Use https://github.com/kubernetes-sigs/hierarchical-namespaces instead.
@@ -475,25 +475,25 @@ 
Method Details

           ],
           "enabled": True or False, # Optional. Enables the installation of Config Sync. If set to true, the Feature will manage Config Sync resources, and apply the other ConfigSync fields if they exist. If set to false, the Feature will ignore all other ConfigSync fields and delete the Config Sync resources. If omitted, ConfigSync is considered enabled if the git or oci field is present.
           "git": { # Git repo configuration for a single cluster. # Optional. Git repo configuration for the cluster.
-            "gcpServiceAccountEmail": "A String", # Optional. The Google Cloud Service Account Email used for auth when secret_type is `gcpserviceaccount`.
-            "httpsProxy": "A String", # Optional. URL for the HTTPS proxy to be used when communicating with the Git repo. Only specify when secret_type is `cookiefile`, `token`, or `none`.
+            "gcpServiceAccountEmail": "A String", # Optional. The Google Cloud Service Account Email used for auth when secret_type is `gcpserviceaccount`. Annotates the `RootSync` or `RepoSync` controller's Kubernetes Service Account.
+            "httpsProxy": "A String", # Optional. URL for the HTTPS proxy to be used when communicating with the Git repo. Defines an HTTPS_PROXY environment variable and only accepts `https` or unadorned URLs. For example, `https://proxy.internal.business.co:443` or `proxy.internal.business.co:443`. If using an unadorned URL, make sure the communication between your proxy server and Git host is secure. Rejects `http://` URLs. Only specify when secret_type is `cookiefile`, `token`, or `none`.
             "policyDir": "A String", # Optional. The path within the Git repository that represents the top level of the repo to sync. Default: the root directory of the repository.
             "secretType": "A String", # Required. Type of secret configured for access to the Git repo. Must be one of `ssh`, `cookiefile`, `gcenode`, `token`, `gcpserviceaccount`, `githubapp` or `none`. The validation of this is case-sensitive.
             "syncBranch": "A String", # Optional. The branch of the repository to sync from. Default: master.
             "syncRepo": "A String", # Required. The URL of the Git repository to use as the source of truth.
-            "syncRev": "A String", # Optional. Git revision (tag or hash) to check out. Default HEAD.
+            "syncRev": "A String", # Optional. Git revision (tag or hash) or branch to sync from. Default `HEAD`. If not `HEAD`, takes precedence over `sync_branch` field. When using a hash, must be a full hash, and not an abbreviated form.
             "syncWaitSecs": "A String", # Optional. Period in seconds between consecutive syncs. Default: 15.
           },
           "metricsGcpServiceAccountEmail": "A String", # Optional. The Email of the Google Cloud Service Account (GSA) used for exporting Config Sync metrics to Cloud Monitoring and Cloud Monarch when Workload Identity is enabled. The GSA should have the Monitoring Metric Writer (roles/monitoring.metricWriter) IAM role. The Kubernetes ServiceAccount `default` in the namespace `config-management-monitoring` should be bound to the GSA. Deprecated: If Workload Identity Federation for GKE is enabled, Google Cloud Service Account is no longer needed for exporting Config Sync metrics: https://cloud.google.com/kubernetes-engine/enterprise/config-sync/docs/how-to/monitor-config-sync-cloud-monitoring#custom-monitoring.
           "oci": { # OCI repo configuration for a single cluster. # Optional. OCI repo configuration for the cluster.
-            "gcpServiceAccountEmail": "A String", # Optional. The Google Cloud Service Account Email used for auth when secret_type is `gcpserviceaccount`.
+            "gcpServiceAccountEmail": "A String", # Optional. The Google Cloud Service Account Email used for auth when secret_type is `gcpserviceaccount`. Annotates the `RootSync` or `RepoSync` controller's Kubernetes Service Account.
             "policyDir": "A String", # Optional. The absolute path of the directory that contains the local resources. Default: the root directory of the image.
             "secretType": "A String", # Required. Type of secret configured for access to the OCI repo. Must be one of `gcenode`, `gcpserviceaccount`, `k8sserviceaccount` or `none`. The validation of this is case-sensitive.
             "syncRepo": "A String", # Required. The OCI image repository URL for the package to sync from. e.g. `LOCATION-docker.pkg.dev/PROJECT_ID/REPOSITORY_NAME/PACKAGE_NAME`.
             "syncWaitSecs": "A String", # Optional. Period in seconds between consecutive syncs. Default: 15.
           },
           "preventDrift": True or False, # Optional. Set to true to enable the Config Sync admission webhook to prevent drifts. If set to false, disables the Config Sync admission webhook and does not prevent drifts. Defaults to false. See https://docs.cloud.google.com/kubernetes-engine/config-sync/docs/how-to/prevent-config-drift for details.
-          "sourceFormat": "A String", # Optional. Specifies whether the Config Sync repo is in `hierarchical` or `unstructured` mode. Defaults to `hierarchical`. See https://docs.cloud.google.com/kubernetes-engine/config-sync/docs/concepts/configs#organize-configs for an explanation.
+          "sourceFormat": "A String", # Optional. Specifies whether the Config Sync repo is in `hierarchy` or `unstructured` mode. Defaults to `hierarchy`. See https://docs.cloud.google.com/kubernetes-engine/config-sync/docs/concepts/configs#organize-configs for an explanation.
           "stopSyncing": True or False, # Optional. Set to true to stop syncing configs for a single cluster. Default to false.
         },
         "hierarchyController": { # Configuration for Hierarchy Controller. # Optional. Hierarchy Controller configuration for the cluster. Deprecated: Configuring Hierarchy Controller through the configmanagement feature is no longer recommended. Use https://github.com/kubernetes-sigs/hierarchical-namespaces instead.
@@ -856,25 +856,25 @@ 
Method Details

         ],
         "enabled": True or False, # Optional. Enables the installation of Config Sync. If set to true, the Feature will manage Config Sync resources, and apply the other ConfigSync fields if they exist. If set to false, the Feature will ignore all other ConfigSync fields and delete the Config Sync resources. If omitted, ConfigSync is considered enabled if the git or oci field is present.
         "git": { # Git repo configuration for a single cluster. # Optional. Git repo configuration for the cluster.
-          "gcpServiceAccountEmail": "A String", # Optional. The Google Cloud Service Account Email used for auth when secret_type is `gcpserviceaccount`.
-          "httpsProxy": "A String", # Optional. URL for the HTTPS proxy to be used when communicating with the Git repo. Only specify when secret_type is `cookiefile`, `token`, or `none`.
+          "gcpServiceAccountEmail": "A String", # Optional. The Google Cloud Service Account Email used for auth when secret_type is `gcpserviceaccount`. Annotates the `RootSync` or `RepoSync` controller's Kubernetes Service Account.
+          "httpsProxy": "A String", # Optional. URL for the HTTPS proxy to be used when communicating with the Git repo. Defines an HTTPS_PROXY environment variable and only accepts `https` or unadorned URLs. For example, `https://proxy.internal.business.co:443` or `proxy.internal.business.co:443`. If using an unadorned URL, make sure the communication between your proxy server and Git host is secure. Rejects `http://` URLs. Only specify when secret_type is `cookiefile`, `token`, or `none`.
           "policyDir": "A String", # Optional. The path within the Git repository that represents the top level of the repo to sync. Default: the root directory of the repository.
           "secretType": "A String", # Required. Type of secret configured for access to the Git repo. Must be one of `ssh`, `cookiefile`, `gcenode`, `token`, `gcpserviceaccount`, `githubapp` or `none`. The validation of this is case-sensitive.
           "syncBranch": "A String", # Optional. The branch of the repository to sync from. Default: master.
           "syncRepo": "A String", # Required. The URL of the Git repository to use as the source of truth.
-          "syncRev": "A String", # Optional. Git revision (tag or hash) to check out. Default HEAD.
+          "syncRev": "A String", # Optional. Git revision (tag or hash) or branch to sync from. Default `HEAD`. If not `HEAD`, takes precedence over `sync_branch` field. When using a hash, must be a full hash, and not an abbreviated form.
           "syncWaitSecs": "A String", # Optional. Period in seconds between consecutive syncs. Default: 15.
         },
         "metricsGcpServiceAccountEmail": "A String", # Optional. The Email of the Google Cloud Service Account (GSA) used for exporting Config Sync metrics to Cloud Monitoring and Cloud Monarch when Workload Identity is enabled. The GSA should have the Monitoring Metric Writer (roles/monitoring.metricWriter) IAM role. The Kubernetes ServiceAccount `default` in the namespace `config-management-monitoring` should be bound to the GSA. Deprecated: If Workload Identity Federation for GKE is enabled, Google Cloud Service Account is no longer needed for exporting Config Sync metrics: https://cloud.google.com/kubernetes-engine/enterprise/config-sync/docs/how-to/monitor-config-sync-cloud-monitoring#custom-monitoring.
         "oci": { # OCI repo configuration for a single cluster. # Optional. OCI repo configuration for the cluster.
-          "gcpServiceAccountEmail": "A String", # Optional. The Google Cloud Service Account Email used for auth when secret_type is `gcpserviceaccount`.
+          "gcpServiceAccountEmail": "A String", # Optional. The Google Cloud Service Account Email used for auth when secret_type is `gcpserviceaccount`. Annotates the `RootSync` or `RepoSync` controller's Kubernetes Service Account.
           "policyDir": "A String", # Optional. The absolute path of the directory that contains the local resources. Default: the root directory of the image.
           "secretType": "A String", # Required. Type of secret configured for access to the OCI repo. Must be one of `gcenode`, `gcpserviceaccount`, `k8sserviceaccount` or `none`. The validation of this is case-sensitive.
           "syncRepo": "A String", # Required. The OCI image repository URL for the package to sync from. e.g. `LOCATION-docker.pkg.dev/PROJECT_ID/REPOSITORY_NAME/PACKAGE_NAME`.
           "syncWaitSecs": "A String", # Optional. Period in seconds between consecutive syncs. Default: 15.
         },
         "preventDrift": True or False, # Optional. Set to true to enable the Config Sync admission webhook to prevent drifts. If set to false, disables the Config Sync admission webhook and does not prevent drifts. Defaults to false. See https://docs.cloud.google.com/kubernetes-engine/config-sync/docs/how-to/prevent-config-drift for details.
-        "sourceFormat": "A String", # Optional. Specifies whether the Config Sync repo is in `hierarchical` or `unstructured` mode. Defaults to `hierarchical`. See https://docs.cloud.google.com/kubernetes-engine/config-sync/docs/concepts/configs#organize-configs for an explanation.
+        "sourceFormat": "A String", # Optional. Specifies whether the Config Sync repo is in `hierarchy` or `unstructured` mode. Defaults to `hierarchy`. See https://docs.cloud.google.com/kubernetes-engine/config-sync/docs/concepts/configs#organize-configs for an explanation.
         "stopSyncing": True or False, # Optional. Set to true to stop syncing configs for a single cluster. Default to false.
       },
       "hierarchyController": { # Configuration for Hierarchy Controller. # Optional. Hierarchy Controller configuration for the cluster. Deprecated: Configuring Hierarchy Controller through the configmanagement feature is no longer recommended. Use https://github.com/kubernetes-sigs/hierarchical-namespaces instead.
@@ -1183,25 +1183,25 @@ 
Method Details

           ],
           "enabled": True or False, # Optional. Enables the installation of Config Sync. If set to true, the Feature will manage Config Sync resources, and apply the other ConfigSync fields if they exist. If set to false, the Feature will ignore all other ConfigSync fields and delete the Config Sync resources. If omitted, ConfigSync is considered enabled if the git or oci field is present.
           "git": { # Git repo configuration for a single cluster. # Optional. Git repo configuration for the cluster.
-            "gcpServiceAccountEmail": "A String", # Optional. The Google Cloud Service Account Email used for auth when secret_type is `gcpserviceaccount`.
-            "httpsProxy": "A String", # Optional. URL for the HTTPS proxy to be used when communicating with the Git repo. Only specify when secret_type is `cookiefile`, `token`, or `none`.
+            "gcpServiceAccountEmail": "A String", # Optional. The Google Cloud Service Account Email used for auth when secret_type is `gcpserviceaccount`. Annotates the `RootSync` or `RepoSync` controller's Kubernetes Service Account.
+            "httpsProxy": "A String", # Optional. URL for the HTTPS proxy to be used when communicating with the Git repo. Defines an HTTPS_PROXY environment variable and only accepts `https` or unadorned URLs. For example, `https://proxy.internal.business.co:443` or `proxy.internal.business.co:443`. If using an unadorned URL, make sure the communication between your proxy server and Git host is secure. Rejects `http://` URLs. Only specify when secret_type is `cookiefile`, `token`, or `none`.
             "policyDir": "A String", # Optional. The path within the Git repository that represents the top level of the repo to sync. Default: the root directory of the repository.
             "secretType": "A String", # Required. Type of secret configured for access to the Git repo. Must be one of `ssh`, `cookiefile`, `gcenode`, `token`, `gcpserviceaccount`, `githubapp` or `none`. The validation of this is case-sensitive.
             "syncBranch": "A String", # Optional. The branch of the repository to sync from. Default: master.
             "syncRepo": "A String", # Required. The URL of the Git repository to use as the source of truth.
-            "syncRev": "A String", # Optional. Git revision (tag or hash) to check out. Default HEAD.
+            "syncRev": "A String", # Optional. Git revision (tag or hash) or branch to sync from. Default `HEAD`. If not `HEAD`, takes precedence over `sync_branch` field. When using a hash, must be a full hash, and not an abbreviated form.
             "syncWaitSecs": "A String", # Optional. Period in seconds between consecutive syncs. Default: 15.
           },
           "metricsGcpServiceAccountEmail": "A String", # Optional. The Email of the Google Cloud Service Account (GSA) used for exporting Config Sync metrics to Cloud Monitoring and Cloud Monarch when Workload Identity is enabled. The GSA should have the Monitoring Metric Writer (roles/monitoring.metricWriter) IAM role. The Kubernetes ServiceAccount `default` in the namespace `config-management-monitoring` should be bound to the GSA. Deprecated: If Workload Identity Federation for GKE is enabled, Google Cloud Service Account is no longer needed for exporting Config Sync metrics: https://cloud.google.com/kubernetes-engine/enterprise/config-sync/docs/how-to/monitor-config-sync-cloud-monitoring#custom-monitoring.
           "oci": { # OCI repo configuration for a single cluster. # Optional. OCI repo configuration for the cluster.
-            "gcpServiceAccountEmail": "A String", # Optional. The Google Cloud Service Account Email used for auth when secret_type is `gcpserviceaccount`.
+            "gcpServiceAccountEmail": "A String", # Optional. The Google Cloud Service Account Email used for auth when secret_type is `gcpserviceaccount`. Annotates the `RootSync` or `RepoSync` controller's Kubernetes Service Account.
             "policyDir": "A String", # Optional. The absolute path of the directory that contains the local resources. Default: the root directory of the image.
             "secretType": "A String", # Required. Type of secret configured for access to the OCI repo. Must be one of `gcenode`, `gcpserviceaccount`, `k8sserviceaccount` or `none`. The validation of this is case-sensitive.
             "syncRepo": "A String", # Required. The OCI image repository URL for the package to sync from. e.g. `LOCATION-docker.pkg.dev/PROJECT_ID/REPOSITORY_NAME/PACKAGE_NAME`.
             "syncWaitSecs": "A String", # Optional. Period in seconds between consecutive syncs. Default: 15.
           },
           "preventDrift": True or False, # Optional. Set to true to enable the Config Sync admission webhook to prevent drifts. If set to false, disables the Config Sync admission webhook and does not prevent drifts. Defaults to false. See https://docs.cloud.google.com/kubernetes-engine/config-sync/docs/how-to/prevent-config-drift for details.
-          "sourceFormat": "A String", # Optional. Specifies whether the Config Sync repo is in `hierarchical` or `unstructured` mode. Defaults to `hierarchical`. See https://docs.cloud.google.com/kubernetes-engine/config-sync/docs/concepts/configs#organize-configs for an explanation.
+          "sourceFormat": "A String", # Optional. Specifies whether the Config Sync repo is in `hierarchy` or `unstructured` mode. Defaults to `hierarchy`. See https://docs.cloud.google.com/kubernetes-engine/config-sync/docs/concepts/configs#organize-configs for an explanation.
           "stopSyncing": True or False, # Optional. Set to true to stop syncing configs for a single cluster. Default to false.
         },
         "hierarchyController": { # Configuration for Hierarchy Controller. # Optional. Hierarchy Controller configuration for the cluster. Deprecated: Configuring Hierarchy Controller through the configmanagement feature is no longer recommended. Use https://github.com/kubernetes-sigs/hierarchical-namespaces instead.
@@ -1504,25 +1504,25 @@ 
Method Details

             ],
             "enabled": True or False, # Optional. Enables the installation of Config Sync. If set to true, the Feature will manage Config Sync resources, and apply the other ConfigSync fields if they exist. If set to false, the Feature will ignore all other ConfigSync fields and delete the Config Sync resources. If omitted, ConfigSync is considered enabled if the git or oci field is present.
             "git": { # Git repo configuration for a single cluster. # Optional. Git repo configuration for the cluster.
-              "gcpServiceAccountEmail": "A String", # Optional. The Google Cloud Service Account Email used for auth when secret_type is `gcpserviceaccount`.
-              "httpsProxy": "A String", # Optional. URL for the HTTPS proxy to be used when communicating with the Git repo. Only specify when secret_type is `cookiefile`, `token`, or `none`.
+              "gcpServiceAccountEmail": "A String", # Optional. The Google Cloud Service Account Email used for auth when secret_type is `gcpserviceaccount`. Annotates the `RootSync` or `RepoSync` controller's Kubernetes Service Account.
+              "httpsProxy": "A String", # Optional. URL for the HTTPS proxy to be used when communicating with the Git repo. Defines an HTTPS_PROXY environment variable and only accepts `https` or unadorned URLs. For example, `https://proxy.internal.business.co:443` or `proxy.internal.business.co:443`. If using an unadorned URL, make sure the communication between your proxy server and Git host is secure. Rejects `http://` URLs. Only specify when secret_type is `cookiefile`, `token`, or `none`.
               "policyDir": "A String", # Optional. The path within the Git repository that represents the top level of the repo to sync. Default: the root directory of the repository.
               "secretType": "A String", # Required. Type of secret configured for access to the Git repo. Must be one of `ssh`, `cookiefile`, `gcenode`, `token`, `gcpserviceaccount`, `githubapp` or `none`. The validation of this is case-sensitive.
               "syncBranch": "A String", # Optional. The branch of the repository to sync from. Default: master.
               "syncRepo": "A String", # Required. The URL of the Git repository to use as the source of truth.
-              "syncRev": "A String", # Optional. Git revision (tag or hash) to check out. Default HEAD.
+              "syncRev": "A String", # Optional. Git revision (tag or hash) or branch to sync from. Default `HEAD`. If not `HEAD`, takes precedence over `sync_branch` field. When using a hash, must be a full hash, and not an abbreviated form.
               "syncWaitSecs": "A String", # Optional. Period in seconds between consecutive syncs. Default: 15.
             },
             "metricsGcpServiceAccountEmail": "A String", # Optional. The Email of the Google Cloud Service Account (GSA) used for exporting Config Sync metrics to Cloud Monitoring and Cloud Monarch when Workload Identity is enabled. The GSA should have the Monitoring Metric Writer (roles/monitoring.metricWriter) IAM role. The Kubernetes ServiceAccount `default` in the namespace `config-management-monitoring` should be bound to the GSA. Deprecated: If Workload Identity Federation for GKE is enabled, Google Cloud Service Account is no longer needed for exporting Config Sync metrics: https://cloud.google.com/kubernetes-engine/enterprise/config-sync/docs/how-to/monitor-config-sync-cloud-monitoring#custom-monitoring.
             "oci": { # OCI repo configuration for a single cluster. # Optional. OCI repo configuration for the cluster.
-              "gcpServiceAccountEmail": "A String", # Optional. The Google Cloud Service Account Email used for auth when secret_type is `gcpserviceaccount`.
+              "gcpServiceAccountEmail": "A String", # Optional. The Google Cloud Service Account Email used for auth when secret_type is `gcpserviceaccount`. Annotates the `RootSync` or `RepoSync` controller's Kubernetes Service Account.
               "policyDir": "A String", # Optional. The absolute path of the directory that contains the local resources. Default: the root directory of the image.
               "secretType": "A String", # Required. Type of secret configured for access to the OCI repo. Must be one of `gcenode`, `gcpserviceaccount`, `k8sserviceaccount` or `none`. The validation of this is case-sensitive.
               "syncRepo": "A String", # Required. The OCI image repository URL for the package to sync from. e.g. `LOCATION-docker.pkg.dev/PROJECT_ID/REPOSITORY_NAME/PACKAGE_NAME`.
               "syncWaitSecs": "A String", # Optional. Period in seconds between consecutive syncs. Default: 15.
             },
             "preventDrift": True or False, # Optional. Set to true to enable the Config Sync admission webhook to prevent drifts. If set to false, disables the Config Sync admission webhook and does not prevent drifts. Defaults to false. See https://docs.cloud.google.com/kubernetes-engine/config-sync/docs/how-to/prevent-config-drift for details.
-            "sourceFormat": "A String", # Optional. Specifies whether the Config Sync repo is in `hierarchical` or `unstructured` mode. Defaults to `hierarchical`. See https://docs.cloud.google.com/kubernetes-engine/config-sync/docs/concepts/configs#organize-configs for an explanation.
+            "sourceFormat": "A String", # Optional. Specifies whether the Config Sync repo is in `hierarchy` or `unstructured` mode. Defaults to `hierarchy`. See https://docs.cloud.google.com/kubernetes-engine/config-sync/docs/concepts/configs#organize-configs for an explanation.
             "stopSyncing": True or False, # Optional. Set to true to stop syncing configs for a single cluster. Default to false.
           },
           "hierarchyController": { # Configuration for Hierarchy Controller. # Optional. Hierarchy Controller configuration for the cluster. Deprecated: Configuring Hierarchy Controller through the configmanagement feature is no longer recommended. Use https://github.com/kubernetes-sigs/hierarchical-namespaces instead.
@@ -1831,25 +1831,25 @@ 
Method Details

               ],
               "enabled": True or False, # Optional. Enables the installation of Config Sync. If set to true, the Feature will manage Config Sync resources, and apply the other ConfigSync fields if they exist. If set to false, the Feature will ignore all other ConfigSync fields and delete the Config Sync resources. If omitted, ConfigSync is considered enabled if the git or oci field is present.
               "git": { # Git repo configuration for a single cluster. # Optional. Git repo configuration for the cluster.
-                "gcpServiceAccountEmail": "A String", # Optional. The Google Cloud Service Account Email used for auth when secret_type is `gcpserviceaccount`.
-                "httpsProxy": "A String", # Optional. URL for the HTTPS proxy to be used when communicating with the Git repo. Only specify when secret_type is `cookiefile`, `token`, or `none`.
+                "gcpServiceAccountEmail": "A String", # Optional. The Google Cloud Service Account Email used for auth when secret_type is `gcpserviceaccount`. Annotates the `RootSync` or `RepoSync` controller's Kubernetes Service Account.
+                "httpsProxy": "A String", # Optional. URL for the HTTPS proxy to be used when communicating with the Git repo. Defines an HTTPS_PROXY environment variable and only accepts `https` or unadorned URLs. For example, `https://proxy.internal.business.co:443` or `proxy.internal.business.co:443`. If using an unadorned URL, make sure the communication between your proxy server and Git host is secure. Rejects `http://` URLs. Only specify when secret_type is `cookiefile`, `token`, or `none`.
                 "policyDir": "A String", # Optional. The path within the Git repository that represents the top level of the repo to sync. Default: the root directory of the repository.
                 "secretType": "A String", # Required. Type of secret configured for access to the Git repo. Must be one of `ssh`, `cookiefile`, `gcenode`, `token`, `gcpserviceaccount`, `githubapp` or `none`. The validation of this is case-sensitive.
                 "syncBranch": "A String", # Optional. The branch of the repository to sync from. Default: master.
                 "syncRepo": "A String", # Required. The URL of the Git repository to use as the source of truth.
-                "syncRev": "A String", # Optional. Git revision (tag or hash) to check out. Default HEAD.
+                "syncRev": "A String", # Optional. Git revision (tag or hash) or branch to sync from. Default `HEAD`. If not `HEAD`, takes precedence over `sync_branch` field. When using a hash, must be a full hash, and not an abbreviated form.
                 "syncWaitSecs": "A String", # Optional. Period in seconds between consecutive syncs. Default: 15.
               },
               "metricsGcpServiceAccountEmail": "A String", # Optional. The Email of the Google Cloud Service Account (GSA) used for exporting Config Sync metrics to Cloud Monitoring and Cloud Monarch when Workload Identity is enabled. The GSA should have the Monitoring Metric Writer (roles/monitoring.metricWriter) IAM role. The Kubernetes ServiceAccount `default` in the namespace `config-management-monitoring` should be bound to the GSA. Deprecated: If Workload Identity Federation for GKE is enabled, Google Cloud Service Account is no longer needed for exporting Config Sync metrics: https://cloud.google.com/kubernetes-engine/enterprise/config-sync/docs/how-to/monitor-config-sync-cloud-monitoring#custom-monitoring.
               "oci": { # OCI repo configuration for a single cluster. # Optional. OCI repo configuration for the cluster.
-                "gcpServiceAccountEmail": "A String", # Optional. The Google Cloud Service Account Email used for auth when secret_type is `gcpserviceaccount`.
+                "gcpServiceAccountEmail": "A String", # Optional. The Google Cloud Service Account Email used for auth when secret_type is `gcpserviceaccount`. Annotates the `RootSync` or `RepoSync` controller's Kubernetes Service Account.
                 "policyDir": "A String", # Optional. The absolute path of the directory that contains the local resources. Default: the root directory of the image.
                 "secretType": "A String", # Required. Type of secret configured for access to the OCI repo. Must be one of `gcenode`, `gcpserviceaccount`, `k8sserviceaccount` or `none`. The validation of this is case-sensitive.
                 "syncRepo": "A String", # Required. The OCI image repository URL for the package to sync from. e.g. `LOCATION-docker.pkg.dev/PROJECT_ID/REPOSITORY_NAME/PACKAGE_NAME`.
                 "syncWaitSecs": "A String", # Optional. Period in seconds between consecutive syncs. Default: 15.
               },
               "preventDrift": True or False, # Optional. Set to true to enable the Config Sync admission webhook to prevent drifts. If set to false, disables the Config Sync admission webhook and does not prevent drifts. Defaults to false. See https://docs.cloud.google.com/kubernetes-engine/config-sync/docs/how-to/prevent-config-drift for details.
-              "sourceFormat": "A String", # Optional. Specifies whether the Config Sync repo is in `hierarchical` or `unstructured` mode. Defaults to `hierarchical`. See https://docs.cloud.google.com/kubernetes-engine/config-sync/docs/concepts/configs#organize-configs for an explanation.
+              "sourceFormat": "A String", # Optional. Specifies whether the Config Sync repo is in `hierarchy` or `unstructured` mode. Defaults to `hierarchy`. See https://docs.cloud.google.com/kubernetes-engine/config-sync/docs/concepts/configs#organize-configs for an explanation.
               "stopSyncing": True or False, # Optional. Set to true to stop syncing configs for a single cluster. Default to false.
             },
             "hierarchyController": { # Configuration for Hierarchy Controller. # Optional. Hierarchy Controller configuration for the cluster. Deprecated: Configuring Hierarchy Controller through the configmanagement feature is no longer recommended. Use https://github.com/kubernetes-sigs/hierarchical-namespaces instead.
@@ -2161,25 +2161,25 @@ 
Method Details

         ],
         "enabled": True or False, # Optional. Enables the installation of Config Sync. If set to true, the Feature will manage Config Sync resources, and apply the other ConfigSync fields if they exist. If set to false, the Feature will ignore all other ConfigSync fields and delete the Config Sync resources. If omitted, ConfigSync is considered enabled if the git or oci field is present.
         "git": { # Git repo configuration for a single cluster. # Optional. Git repo configuration for the cluster.
-          "gcpServiceAccountEmail": "A String", # Optional. The Google Cloud Service Account Email used for auth when secret_type is `gcpserviceaccount`.
-          "httpsProxy": "A String", # Optional. URL for the HTTPS proxy to be used when communicating with the Git repo. Only specify when secret_type is `cookiefile`, `token`, or `none`.
+          "gcpServiceAccountEmail": "A String", # Optional. The Google Cloud Service Account Email used for auth when secret_type is `gcpserviceaccount`. Annotates the `RootSync` or `RepoSync` controller's Kubernetes Service Account.
+          "httpsProxy": "A String", # Optional. URL for the HTTPS proxy to be used when communicating with the Git repo. Defines an HTTPS_PROXY environment variable and only accepts `https` or unadorned URLs. For example, `https://proxy.internal.business.co:443` or `proxy.internal.business.co:443`. If using an unadorned URL, make sure the communication between your proxy server and Git host is secure. Rejects `http://` URLs. Only specify when secret_type is `cookiefile`, `token`, or `none`.
           "policyDir": "A String", # Optional. The path within the Git repository that represents the top level of the repo to sync. Default: the root directory of the repository.
           "secretType": "A String", # Required. Type of secret configured for access to the Git repo. Must be one of `ssh`, `cookiefile`, `gcenode`, `token`, `gcpserviceaccount`, `githubapp` or `none`. The validation of this is case-sensitive.
           "syncBranch": "A String", # Optional. The branch of the repository to sync from. Default: master.
           "syncRepo": "A String", # Required. The URL of the Git repository to use as the source of truth.
-          "syncRev": "A String", # Optional. Git revision (tag or hash) to check out. Default HEAD.
+          "syncRev": "A String", # Optional. Git revision (tag or hash) or branch to sync from. Default `HEAD`. If not `HEAD`, takes precedence over `sync_branch` field. When using a hash, must be a full hash, and not an abbreviated form.
           "syncWaitSecs": "A String", # Optional. Period in seconds between consecutive syncs. Default: 15.
         },
         "metricsGcpServiceAccountEmail": "A String", # Optional. The Email of the Google Cloud Service Account (GSA) used for exporting Config Sync metrics to Cloud Monitoring and Cloud Monarch when Workload Identity is enabled. The GSA should have the Monitoring Metric Writer (roles/monitoring.metricWriter) IAM role. The Kubernetes ServiceAccount `default` in the namespace `config-management-monitoring` should be bound to the GSA. Deprecated: If Workload Identity Federation for GKE is enabled, Google Cloud Service Account is no longer needed for exporting Config Sync metrics: https://cloud.google.com/kubernetes-engine/enterprise/config-sync/docs/how-to/monitor-config-sync-cloud-monitoring#custom-monitoring.
         "oci": { # OCI repo configuration for a single cluster. # Optional. OCI repo configuration for the cluster.
-          "gcpServiceAccountEmail": "A String", # Optional. The Google Cloud Service Account Email used for auth when secret_type is `gcpserviceaccount`.
+          "gcpServiceAccountEmail": "A String", # Optional. The Google Cloud Service Account Email used for auth when secret_type is `gcpserviceaccount`. Annotates the `RootSync` or `RepoSync` controller's Kubernetes Service Account.
           "policyDir": "A String", # Optional. The absolute path of the directory that contains the local resources. Default: the root directory of the image.
           "secretType": "A String", # Required. Type of secret configured for access to the OCI repo. Must be one of `gcenode`, `gcpserviceaccount`, `k8sserviceaccount` or `none`. The validation of this is case-sensitive.
           "syncRepo": "A String", # Required. The OCI image repository URL for the package to sync from. e.g. `LOCATION-docker.pkg.dev/PROJECT_ID/REPOSITORY_NAME/PACKAGE_NAME`.
           "syncWaitSecs": "A String", # Optional. Period in seconds between consecutive syncs. Default: 15.
         },
         "preventDrift": True or False, # Optional. Set to true to enable the Config Sync admission webhook to prevent drifts. If set to false, disables the Config Sync admission webhook and does not prevent drifts. Defaults to false. See https://docs.cloud.google.com/kubernetes-engine/config-sync/docs/how-to/prevent-config-drift for details.
-        "sourceFormat": "A String", # Optional. Specifies whether the Config Sync repo is in `hierarchical` or `unstructured` mode. Defaults to `hierarchical`. See https://docs.cloud.google.com/kubernetes-engine/config-sync/docs/concepts/configs#organize-configs for an explanation.
+        "sourceFormat": "A String", # Optional. Specifies whether the Config Sync repo is in `hierarchy` or `unstructured` mode. Defaults to `hierarchy`. See https://docs.cloud.google.com/kubernetes-engine/config-sync/docs/concepts/configs#organize-configs for an explanation.
         "stopSyncing": True or False, # Optional. Set to true to stop syncing configs for a single cluster. Default to false.
       },
       "hierarchyController": { # Configuration for Hierarchy Controller. # Optional. Hierarchy Controller configuration for the cluster. Deprecated: Configuring Hierarchy Controller through the configmanagement feature is no longer recommended. Use https://github.com/kubernetes-sigs/hierarchical-namespaces instead.
@@ -2488,25 +2488,25 @@ 
Method Details

           ],
           "enabled": True or False, # Optional. Enables the installation of Config Sync. If set to true, the Feature will manage Config Sync resources, and apply the other ConfigSync fields if they exist. If set to false, the Feature will ignore all other ConfigSync fields and delete the Config Sync resources. If omitted, ConfigSync is considered enabled if the git or oci field is present.
           "git": { # Git repo configuration for a single cluster. # Optional. Git repo configuration for the cluster.
-            "gcpServiceAccountEmail": "A String", # Optional. The Google Cloud Service Account Email used for auth when secret_type is `gcpserviceaccount`.
-            "httpsProxy": "A String", # Optional. URL for the HTTPS proxy to be used when communicating with the Git repo. Only specify when secret_type is `cookiefile`, `token`, or `none`.
+            "gcpServiceAccountEmail": "A String", # Optional. The Google Cloud Service Account Email used for auth when secret_type is `gcpserviceaccount`. Annotates the `RootSync` or `RepoSync` controller's Kubernetes Service Account.
+            "httpsProxy": "A String", # Optional. URL for the HTTPS proxy to be used when communicating with the Git repo. Defines an HTTPS_PROXY environment variable and only accepts `https` or unadorned URLs. For example, `https://proxy.internal.business.co:443` or `proxy.internal.business.co:443`. If using an unadorned URL, make sure the communication between your proxy server and Git host is secure. Rejects `http://` URLs. Only specify when secret_type is `cookiefile`, `token`, or `none`.
             "policyDir": "A String", # Optional. The path within the Git repository that represents the top level of the repo to sync. Default: the root directory of the repository.
             "secretType": "A String", # Required. Type of secret configured for access to the Git repo. Must be one of `ssh`, `cookiefile`, `gcenode`, `token`, `gcpserviceaccount`, `githubapp` or `none`. The validation of this is case-sensitive.
             "syncBranch": "A String", # Optional. The branch of the repository to sync from. Default: master.
             "syncRepo": "A String", # Required. The URL of the Git repository to use as the source of truth.
-            "syncRev": "A String", # Optional. Git revision (tag or hash) to check out. Default HEAD.
+            "syncRev": "A String", # Optional. Git revision (tag or hash) or branch to sync from. Default `HEAD`. If not `HEAD`, takes precedence over `sync_branch` field. When using a hash, must be a full hash, and not an abbreviated form.
             "syncWaitSecs": "A String", # Optional. Period in seconds between consecutive syncs. Default: 15.
           },
           "metricsGcpServiceAccountEmail": "A String", # Optional. The Email of the Google Cloud Service Account (GSA) used for exporting Config Sync metrics to Cloud Monitoring and Cloud Monarch when Workload Identity is enabled. The GSA should have the Monitoring Metric Writer (roles/monitoring.metricWriter) IAM role. The Kubernetes ServiceAccount `default` in the namespace `config-management-monitoring` should be bound to the GSA. Deprecated: If Workload Identity Federation for GKE is enabled, Google Cloud Service Account is no longer needed for exporting Config Sync metrics: https://cloud.google.com/kubernetes-engine/enterprise/config-sync/docs/how-to/monitor-config-sync-cloud-monitoring#custom-monitoring.
           "oci": { # OCI repo configuration for a single cluster. # Optional. OCI repo configuration for the cluster.
-            "gcpServiceAccountEmail": "A String", # Optional. The Google Cloud Service Account Email used for auth when secret_type is `gcpserviceaccount`.
+            "gcpServiceAccountEmail": "A String", # Optional. The Google Cloud Service Account Email used for auth when secret_type is `gcpserviceaccount`. Annotates the `RootSync` or `RepoSync` controller's Kubernetes Service Account.
             "policyDir": "A String", # Optional. The absolute path of the directory that contains the local resources. Default: the root directory of the image.
             "secretType": "A String", # Required. Type of secret configured for access to the OCI repo. Must be one of `gcenode`, `gcpserviceaccount`, `k8sserviceaccount` or `none`. The validation of this is case-sensitive.
             "syncRepo": "A String", # Required. The OCI image repository URL for the package to sync from. e.g. `LOCATION-docker.pkg.dev/PROJECT_ID/REPOSITORY_NAME/PACKAGE_NAME`.
             "syncWaitSecs": "A String", # Optional. Period in seconds between consecutive syncs. Default: 15.
           },
           "preventDrift": True or False, # Optional. Set to true to enable the Config Sync admission webhook to prevent drifts. If set to false, disables the Config Sync admission webhook and does not prevent drifts. Defaults to false. See https://docs.cloud.google.com/kubernetes-engine/config-sync/docs/how-to/prevent-config-drift for details.
-          "sourceFormat": "A String", # Optional. Specifies whether the Config Sync repo is in `hierarchical` or `unstructured` mode. Defaults to `hierarchical`. See https://docs.cloud.google.com/kubernetes-engine/config-sync/docs/concepts/configs#organize-configs for an explanation.
+          "sourceFormat": "A String", # Optional. Specifies whether the Config Sync repo is in `hierarchy` or `unstructured` mode. Defaults to `hierarchy`. See https://docs.cloud.google.com/kubernetes-engine/config-sync/docs/concepts/configs#organize-configs for an explanation.
           "stopSyncing": True or False, # Optional. Set to true to stop syncing configs for a single cluster. Default to false.
         },
         "hierarchyController": { # Configuration for Hierarchy Controller. # Optional. Hierarchy Controller configuration for the cluster. Deprecated: Configuring Hierarchy Controller through the configmanagement feature is no longer recommended. Use https://github.com/kubernetes-sigs/hierarchical-namespaces instead.
diff --git a/docs/dyn/gkehub_v2beta.projects.locations.memberships.features.html b/docs/dyn/gkehub_v2beta.projects.locations.memberships.features.html
index 104ed543f3..c50641c90a 100644
--- a/docs/dyn/gkehub_v2beta.projects.locations.memberships.features.html
+++ b/docs/dyn/gkehub_v2beta.projects.locations.memberships.features.html
@@ -148,25 +148,25 @@ 
Method Details

         ],
         "enabled": True or False, # Optional. Enables the installation of Config Sync. If set to true, the Feature will manage Config Sync resources, and apply the other ConfigSync fields if they exist. If set to false, the Feature will ignore all other ConfigSync fields and delete the Config Sync resources. If omitted, ConfigSync is considered enabled if the git or oci field is present.
         "git": { # Git repo configuration for a single cluster. # Optional. Git repo configuration for the cluster.
-          "gcpServiceAccountEmail": "A String", # Optional. The Google Cloud Service Account Email used for auth when secret_type is `gcpserviceaccount`.
-          "httpsProxy": "A String", # Optional. URL for the HTTPS proxy to be used when communicating with the Git repo. Only specify when secret_type is `cookiefile`, `token`, or `none`.
+          "gcpServiceAccountEmail": "A String", # Optional. The Google Cloud Service Account Email used for auth when secret_type is `gcpserviceaccount`. Annotates the `RootSync` or `RepoSync` controller's Kubernetes Service Account.
+          "httpsProxy": "A String", # Optional. URL for the HTTPS proxy to be used when communicating with the Git repo. Defines an HTTPS_PROXY environment variable and only accepts `https` or unadorned URLs. For example, `https://proxy.internal.business.co:443` or `proxy.internal.business.co:443`. If using an unadorned URL, make sure the communication between your proxy server and Git host is secure. Rejects `http://` URLs. Only specify when secret_type is `cookiefile`, `token`, or `none`.
           "policyDir": "A String", # Optional. The path within the Git repository that represents the top level of the repo to sync. Default: the root directory of the repository.
           "secretType": "A String", # Required. Type of secret configured for access to the Git repo. Must be one of `ssh`, `cookiefile`, `gcenode`, `token`, `gcpserviceaccount`, `githubapp` or `none`. The validation of this is case-sensitive.
           "syncBranch": "A String", # Optional. The branch of the repository to sync from. Default: master.
           "syncRepo": "A String", # Required. The URL of the Git repository to use as the source of truth.
-          "syncRev": "A String", # Optional. Git revision (tag or hash) to check out. Default HEAD.
+          "syncRev": "A String", # Optional. Git revision (tag or hash) or branch to sync from. Default `HEAD`. If not `HEAD`, takes precedence over `sync_branch` field. When using a hash, must be a full hash, and not an abbreviated form.
           "syncWaitSecs": "A String", # Optional. Period in seconds between consecutive syncs. Default: 15.
         },
         "metricsGcpServiceAccountEmail": "A String", # Optional. The Email of the Google Cloud Service Account (GSA) used for exporting Config Sync metrics to Cloud Monitoring and Cloud Monarch when Workload Identity is enabled. The GSA should have the Monitoring Metric Writer (roles/monitoring.metricWriter) IAM role. The Kubernetes ServiceAccount `default` in the namespace `config-management-monitoring` should be bound to the GSA. Deprecated: If Workload Identity Federation for GKE is enabled, Google Cloud Service Account is no longer needed for exporting Config Sync metrics: https://cloud.google.com/kubernetes-engine/enterprise/config-sync/docs/how-to/monitor-config-sync-cloud-monitoring#custom-monitoring.
         "oci": { # OCI repo configuration for a single cluster. # Optional. OCI repo configuration for the cluster.
-          "gcpServiceAccountEmail": "A String", # Optional. The Google Cloud Service Account Email used for auth when secret_type is `gcpserviceaccount`.
+          "gcpServiceAccountEmail": "A String", # Optional. The Google Cloud Service Account Email used for auth when secret_type is `gcpserviceaccount`. Annotates the `RootSync` or `RepoSync` controller's Kubernetes Service Account.
           "policyDir": "A String", # Optional. The absolute path of the directory that contains the local resources. Default: the root directory of the image.
           "secretType": "A String", # Required. Type of secret configured for access to the OCI repo. Must be one of `gcenode`, `gcpserviceaccount`, `k8sserviceaccount` or `none`. The validation of this is case-sensitive.
           "syncRepo": "A String", # Required. The OCI image repository URL for the package to sync from. e.g. `LOCATION-docker.pkg.dev/PROJECT_ID/REPOSITORY_NAME/PACKAGE_NAME`.
           "syncWaitSecs": "A String", # Optional. Period in seconds between consecutive syncs. Default: 15.
         },
         "preventDrift": True or False, # Optional. Set to true to enable the Config Sync admission webhook to prevent drifts. If set to false, disables the Config Sync admission webhook and does not prevent drifts. Defaults to false. See https://docs.cloud.google.com/kubernetes-engine/config-sync/docs/how-to/prevent-config-drift for details.
-        "sourceFormat": "A String", # Optional. Specifies whether the Config Sync repo is in `hierarchical` or `unstructured` mode. Defaults to `hierarchical`. See https://docs.cloud.google.com/kubernetes-engine/config-sync/docs/concepts/configs#organize-configs for an explanation.
+        "sourceFormat": "A String", # Optional. Specifies whether the Config Sync repo is in `hierarchy` or `unstructured` mode. Defaults to `hierarchy`. See https://docs.cloud.google.com/kubernetes-engine/config-sync/docs/concepts/configs#organize-configs for an explanation.
         "stopSyncing": True or False, # Optional. Set to true to stop syncing configs for a single cluster. Default to false.
       },
       "hierarchyController": { # Configuration for Hierarchy Controller. # Optional. Hierarchy Controller configuration for the cluster. Deprecated: Configuring Hierarchy Controller through the configmanagement feature is no longer recommended. Use https://github.com/kubernetes-sigs/hierarchical-namespaces instead.
@@ -475,25 +475,25 @@ 
Method Details

           ],
           "enabled": True or False, # Optional. Enables the installation of Config Sync. If set to true, the Feature will manage Config Sync resources, and apply the other ConfigSync fields if they exist. If set to false, the Feature will ignore all other ConfigSync fields and delete the Config Sync resources. If omitted, ConfigSync is considered enabled if the git or oci field is present.
           "git": { # Git repo configuration for a single cluster. # Optional. Git repo configuration for the cluster.
-            "gcpServiceAccountEmail": "A String", # Optional. The Google Cloud Service Account Email used for auth when secret_type is `gcpserviceaccount`.
-            "httpsProxy": "A String", # Optional. URL for the HTTPS proxy to be used when communicating with the Git repo. Only specify when secret_type is `cookiefile`, `token`, or `none`.
+            "gcpServiceAccountEmail": "A String", # Optional. The Google Cloud Service Account Email used for auth when secret_type is `gcpserviceaccount`. Annotates the `RootSync` or `RepoSync` controller's Kubernetes Service Account.
+            "httpsProxy": "A String", # Optional. URL for the HTTPS proxy to be used when communicating with the Git repo. Defines an HTTPS_PROXY environment variable and only accepts `https` or unadorned URLs. For example, `https://proxy.internal.business.co:443` or `proxy.internal.business.co:443`. If using an unadorned URL, make sure the communication between your proxy server and Git host is secure. Rejects `http://` URLs. Only specify when secret_type is `cookiefile`, `token`, or `none`.
             "policyDir": "A String", # Optional. The path within the Git repository that represents the top level of the repo to sync. Default: the root directory of the repository.
             "secretType": "A String", # Required. Type of secret configured for access to the Git repo. Must be one of `ssh`, `cookiefile`, `gcenode`, `token`, `gcpserviceaccount`, `githubapp` or `none`. The validation of this is case-sensitive.
             "syncBranch": "A String", # Optional. The branch of the repository to sync from. Default: master.
             "syncRepo": "A String", # Required. The URL of the Git repository to use as the source of truth.
-            "syncRev": "A String", # Optional. Git revision (tag or hash) to check out. Default HEAD.
+            "syncRev": "A String", # Optional. Git revision (tag or hash) or branch to sync from. Default `HEAD`. If not `HEAD`, takes precedence over `sync_branch` field. When using a hash, must be a full hash, and not an abbreviated form.
             "syncWaitSecs": "A String", # Optional. Period in seconds between consecutive syncs. Default: 15.
           },
           "metricsGcpServiceAccountEmail": "A String", # Optional. The Email of the Google Cloud Service Account (GSA) used for exporting Config Sync metrics to Cloud Monitoring and Cloud Monarch when Workload Identity is enabled. The GSA should have the Monitoring Metric Writer (roles/monitoring.metricWriter) IAM role. The Kubernetes ServiceAccount `default` in the namespace `config-management-monitoring` should be bound to the GSA. Deprecated: If Workload Identity Federation for GKE is enabled, Google Cloud Service Account is no longer needed for exporting Config Sync metrics: https://cloud.google.com/kubernetes-engine/enterprise/config-sync/docs/how-to/monitor-config-sync-cloud-monitoring#custom-monitoring.
           "oci": { # OCI repo configuration for a single cluster. # Optional. OCI repo configuration for the cluster.
-            "gcpServiceAccountEmail": "A String", # Optional. The Google Cloud Service Account Email used for auth when secret_type is `gcpserviceaccount`.
+            "gcpServiceAccountEmail": "A String", # Optional. The Google Cloud Service Account Email used for auth when secret_type is `gcpserviceaccount`. Annotates the `RootSync` or `RepoSync` controller's Kubernetes Service Account.
             "policyDir": "A String", # Optional. The absolute path of the directory that contains the local resources. Default: the root directory of the image.
             "secretType": "A String", # Required. Type of secret configured for access to the OCI repo. Must be one of `gcenode`, `gcpserviceaccount`, `k8sserviceaccount` or `none`. The validation of this is case-sensitive.
             "syncRepo": "A String", # Required. The OCI image repository URL for the package to sync from. e.g. `LOCATION-docker.pkg.dev/PROJECT_ID/REPOSITORY_NAME/PACKAGE_NAME`.
             "syncWaitSecs": "A String", # Optional. Period in seconds between consecutive syncs. Default: 15.
           },
           "preventDrift": True or False, # Optional. Set to true to enable the Config Sync admission webhook to prevent drifts. If set to false, disables the Config Sync admission webhook and does not prevent drifts. Defaults to false. See https://docs.cloud.google.com/kubernetes-engine/config-sync/docs/how-to/prevent-config-drift for details.
-          "sourceFormat": "A String", # Optional. Specifies whether the Config Sync repo is in `hierarchical` or `unstructured` mode. Defaults to `hierarchical`. See https://docs.cloud.google.com/kubernetes-engine/config-sync/docs/concepts/configs#organize-configs for an explanation.
+          "sourceFormat": "A String", # Optional. Specifies whether the Config Sync repo is in `hierarchy` or `unstructured` mode. Defaults to `hierarchy`. See https://docs.cloud.google.com/kubernetes-engine/config-sync/docs/concepts/configs#organize-configs for an explanation.
           "stopSyncing": True or False, # Optional. Set to true to stop syncing configs for a single cluster. Default to false.
         },
         "hierarchyController": { # Configuration for Hierarchy Controller. # Optional. Hierarchy Controller configuration for the cluster. Deprecated: Configuring Hierarchy Controller through the configmanagement feature is no longer recommended. Use https://github.com/kubernetes-sigs/hierarchical-namespaces instead.
@@ -856,25 +856,25 @@ 
Method Details

         ],
         "enabled": True or False, # Optional. Enables the installation of Config Sync. If set to true, the Feature will manage Config Sync resources, and apply the other ConfigSync fields if they exist. If set to false, the Feature will ignore all other ConfigSync fields and delete the Config Sync resources. If omitted, ConfigSync is considered enabled if the git or oci field is present.
         "git": { # Git repo configuration for a single cluster. # Optional. Git repo configuration for the cluster.
-          "gcpServiceAccountEmail": "A String", # Optional. The Google Cloud Service Account Email used for auth when secret_type is `gcpserviceaccount`.
-          "httpsProxy": "A String", # Optional. URL for the HTTPS proxy to be used when communicating with the Git repo. Only specify when secret_type is `cookiefile`, `token`, or `none`.
+          "gcpServiceAccountEmail": "A String", # Optional. The Google Cloud Service Account Email used for auth when secret_type is `gcpserviceaccount`. Annotates the `RootSync` or `RepoSync` controller's Kubernetes Service Account.
+          "httpsProxy": "A String", # Optional. URL for the HTTPS proxy to be used when communicating with the Git repo. Defines an HTTPS_PROXY environment variable and only accepts `https` or unadorned URLs. For example, `https://proxy.internal.business.co:443` or `proxy.internal.business.co:443`. If using an unadorned URL, make sure the communication between your proxy server and Git host is secure. Rejects `http://` URLs. Only specify when secret_type is `cookiefile`, `token`, or `none`.
           "policyDir": "A String", # Optional. The path within the Git repository that represents the top level of the repo to sync. Default: the root directory of the repository.
           "secretType": "A String", # Required. Type of secret configured for access to the Git repo. Must be one of `ssh`, `cookiefile`, `gcenode`, `token`, `gcpserviceaccount`, `githubapp` or `none`. The validation of this is case-sensitive.
           "syncBranch": "A String", # Optional. The branch of the repository to sync from. Default: master.
           "syncRepo": "A String", # Required. The URL of the Git repository to use as the source of truth.
-          "syncRev": "A String", # Optional. Git revision (tag or hash) to check out. Default HEAD.
+          "syncRev": "A String", # Optional. Git revision (tag or hash) or branch to sync from. Default `HEAD`. If not `HEAD`, takes precedence over `sync_branch` field. When using a hash, must be a full hash, and not an abbreviated form.
           "syncWaitSecs": "A String", # Optional. Period in seconds between consecutive syncs. Default: 15.
         },
         "metricsGcpServiceAccountEmail": "A String", # Optional. The Email of the Google Cloud Service Account (GSA) used for exporting Config Sync metrics to Cloud Monitoring and Cloud Monarch when Workload Identity is enabled. The GSA should have the Monitoring Metric Writer (roles/monitoring.metricWriter) IAM role. The Kubernetes ServiceAccount `default` in the namespace `config-management-monitoring` should be bound to the GSA. Deprecated: If Workload Identity Federation for GKE is enabled, Google Cloud Service Account is no longer needed for exporting Config Sync metrics: https://cloud.google.com/kubernetes-engine/enterprise/config-sync/docs/how-to/monitor-config-sync-cloud-monitoring#custom-monitoring.
         "oci": { # OCI repo configuration for a single cluster. # Optional. OCI repo configuration for the cluster.
-          "gcpServiceAccountEmail": "A String", # Optional. The Google Cloud Service Account Email used for auth when secret_type is `gcpserviceaccount`.
+          "gcpServiceAccountEmail": "A String", # Optional. The Google Cloud Service Account Email used for auth when secret_type is `gcpserviceaccount`. Annotates the `RootSync` or `RepoSync` controller's Kubernetes Service Account.
           "policyDir": "A String", # Optional. The absolute path of the directory that contains the local resources. Default: the root directory of the image.
           "secretType": "A String", # Required. Type of secret configured for access to the OCI repo. Must be one of `gcenode`, `gcpserviceaccount`, `k8sserviceaccount` or `none`. The validation of this is case-sensitive.
           "syncRepo": "A String", # Required. The OCI image repository URL for the package to sync from. e.g. `LOCATION-docker.pkg.dev/PROJECT_ID/REPOSITORY_NAME/PACKAGE_NAME`.
           "syncWaitSecs": "A String", # Optional. Period in seconds between consecutive syncs. Default: 15.
         },
         "preventDrift": True or False, # Optional. Set to true to enable the Config Sync admission webhook to prevent drifts. If set to false, disables the Config Sync admission webhook and does not prevent drifts. Defaults to false. See https://docs.cloud.google.com/kubernetes-engine/config-sync/docs/how-to/prevent-config-drift for details.
-        "sourceFormat": "A String", # Optional. Specifies whether the Config Sync repo is in `hierarchical` or `unstructured` mode. Defaults to `hierarchical`. See https://docs.cloud.google.com/kubernetes-engine/config-sync/docs/concepts/configs#organize-configs for an explanation.
+        "sourceFormat": "A String", # Optional. Specifies whether the Config Sync repo is in `hierarchy` or `unstructured` mode. Defaults to `hierarchy`. See https://docs.cloud.google.com/kubernetes-engine/config-sync/docs/concepts/configs#organize-configs for an explanation.
         "stopSyncing": True or False, # Optional. Set to true to stop syncing configs for a single cluster. Default to false.
       },
       "hierarchyController": { # Configuration for Hierarchy Controller. # Optional. Hierarchy Controller configuration for the cluster. Deprecated: Configuring Hierarchy Controller through the configmanagement feature is no longer recommended. Use https://github.com/kubernetes-sigs/hierarchical-namespaces instead.
@@ -1183,25 +1183,25 @@ 
Method Details

           ],
           "enabled": True or False, # Optional. Enables the installation of Config Sync. If set to true, the Feature will manage Config Sync resources, and apply the other ConfigSync fields if they exist. If set to false, the Feature will ignore all other ConfigSync fields and delete the Config Sync resources. If omitted, ConfigSync is considered enabled if the git or oci field is present.
           "git": { # Git repo configuration for a single cluster. # Optional. Git repo configuration for the cluster.
-            "gcpServiceAccountEmail": "A String", # Optional. The Google Cloud Service Account Email used for auth when secret_type is `gcpserviceaccount`.
-            "httpsProxy": "A String", # Optional. URL for the HTTPS proxy to be used when communicating with the Git repo. Only specify when secret_type is `cookiefile`, `token`, or `none`.
+            "gcpServiceAccountEmail": "A String", # Optional. The Google Cloud Service Account Email used for auth when secret_type is `gcpserviceaccount`. Annotates the `RootSync` or `RepoSync` controller's Kubernetes Service Account.
+            "httpsProxy": "A String", # Optional. URL for the HTTPS proxy to be used when communicating with the Git repo. Defines an HTTPS_PROXY environment variable and only accepts `https` or unadorned URLs. For example, `https://proxy.internal.business.co:443` or `proxy.internal.business.co:443`. If using an unadorned URL, make sure the communication between your proxy server and Git host is secure. Rejects `http://` URLs. Only specify when secret_type is `cookiefile`, `token`, or `none`.
             "policyDir": "A String", # Optional. The path within the Git repository that represents the top level of the repo to sync. Default: the root directory of the repository.
             "secretType": "A String", # Required. Type of secret configured for access to the Git repo. Must be one of `ssh`, `cookiefile`, `gcenode`, `token`, `gcpserviceaccount`, `githubapp` or `none`. The validation of this is case-sensitive.
             "syncBranch": "A String", # Optional. The branch of the repository to sync from. Default: master.
             "syncRepo": "A String", # Required. The URL of the Git repository to use as the source of truth.
-            "syncRev": "A String", # Optional. Git revision (tag or hash) to check out. Default HEAD.
+            "syncRev": "A String", # Optional. Git revision (tag or hash) or branch to sync from. Default `HEAD`. If not `HEAD`, takes precedence over `sync_branch` field. When using a hash, must be a full hash, and not an abbreviated form.
             "syncWaitSecs": "A String", # Optional. Period in seconds between consecutive syncs. Default: 15.
           },
           "metricsGcpServiceAccountEmail": "A String", # Optional. The Email of the Google Cloud Service Account (GSA) used for exporting Config Sync metrics to Cloud Monitoring and Cloud Monarch when Workload Identity is enabled. The GSA should have the Monitoring Metric Writer (roles/monitoring.metricWriter) IAM role. The Kubernetes ServiceAccount `default` in the namespace `config-management-monitoring` should be bound to the GSA. Deprecated: If Workload Identity Federation for GKE is enabled, Google Cloud Service Account is no longer needed for exporting Config Sync metrics: https://cloud.google.com/kubernetes-engine/enterprise/config-sync/docs/how-to/monitor-config-sync-cloud-monitoring#custom-monitoring.
           "oci": { # OCI repo configuration for a single cluster. # Optional. OCI repo configuration for the cluster.
-            "gcpServiceAccountEmail": "A String", # Optional. The Google Cloud Service Account Email used for auth when secret_type is `gcpserviceaccount`.
+            "gcpServiceAccountEmail": "A String", # Optional. The Google Cloud Service Account Email used for auth when secret_type is `gcpserviceaccount`. Annotates the `RootSync` or `RepoSync` controller's Kubernetes Service Account.
             "policyDir": "A String", # Optional. The absolute path of the directory that contains the local resources. Default: the root directory of the image.
             "secretType": "A String", # Required. Type of secret configured for access to the OCI repo. Must be one of `gcenode`, `gcpserviceaccount`, `k8sserviceaccount` or `none`. The validation of this is case-sensitive.
             "syncRepo": "A String", # Required. The OCI image repository URL for the package to sync from. e.g. `LOCATION-docker.pkg.dev/PROJECT_ID/REPOSITORY_NAME/PACKAGE_NAME`.
             "syncWaitSecs": "A String", # Optional. Period in seconds between consecutive syncs. Default: 15.
           },
           "preventDrift": True or False, # Optional. Set to true to enable the Config Sync admission webhook to prevent drifts. If set to false, disables the Config Sync admission webhook and does not prevent drifts. Defaults to false. See https://docs.cloud.google.com/kubernetes-engine/config-sync/docs/how-to/prevent-config-drift for details.
-          "sourceFormat": "A String", # Optional. Specifies whether the Config Sync repo is in `hierarchical` or `unstructured` mode. Defaults to `hierarchical`. See https://docs.cloud.google.com/kubernetes-engine/config-sync/docs/concepts/configs#organize-configs for an explanation.
+          "sourceFormat": "A String", # Optional. Specifies whether the Config Sync repo is in `hierarchy` or `unstructured` mode. Defaults to `hierarchy`. See https://docs.cloud.google.com/kubernetes-engine/config-sync/docs/concepts/configs#organize-configs for an explanation.
           "stopSyncing": True or False, # Optional. Set to true to stop syncing configs for a single cluster. Default to false.
         },
         "hierarchyController": { # Configuration for Hierarchy Controller. # Optional. Hierarchy Controller configuration for the cluster. Deprecated: Configuring Hierarchy Controller through the configmanagement feature is no longer recommended. Use https://github.com/kubernetes-sigs/hierarchical-namespaces instead.
@@ -1504,25 +1504,25 @@ 
Method Details

             ],
             "enabled": True or False, # Optional. Enables the installation of Config Sync. If set to true, the Feature will manage Config Sync resources, and apply the other ConfigSync fields if they exist. If set to false, the Feature will ignore all other ConfigSync fields and delete the Config Sync resources. If omitted, ConfigSync is considered enabled if the git or oci field is present.
             "git": { # Git repo configuration for a single cluster. # Optional. Git repo configuration for the cluster.
-              "gcpServiceAccountEmail": "A String", # Optional. The Google Cloud Service Account Email used for auth when secret_type is `gcpserviceaccount`.
-              "httpsProxy": "A String", # Optional. URL for the HTTPS proxy to be used when communicating with the Git repo. Only specify when secret_type is `cookiefile`, `token`, or `none`.
+              "gcpServiceAccountEmail": "A String", # Optional. The Google Cloud Service Account Email used for auth when secret_type is `gcpserviceaccount`. Annotates the `RootSync` or `RepoSync` controller's Kubernetes Service Account.
+              "httpsProxy": "A String", # Optional. URL for the HTTPS proxy to be used when communicating with the Git repo. Defines an HTTPS_PROXY environment variable and only accepts `https` or unadorned URLs. For example, `https://proxy.internal.business.co:443` or `proxy.internal.business.co:443`. If using an unadorned URL, make sure the communication between your proxy server and Git host is secure. Rejects `http://` URLs. Only specify when secret_type is `cookiefile`, `token`, or `none`.
               "policyDir": "A String", # Optional. The path within the Git repository that represents the top level of the repo to sync. Default: the root directory of the repository.
               "secretType": "A String", # Required. Type of secret configured for access to the Git repo. Must be one of `ssh`, `cookiefile`, `gcenode`, `token`, `gcpserviceaccount`, `githubapp` or `none`. The validation of this is case-sensitive.
               "syncBranch": "A String", # Optional. The branch of the repository to sync from. Default: master.
               "syncRepo": "A String", # Required. The URL of the Git repository to use as the source of truth.
-              "syncRev": "A String", # Optional. Git revision (tag or hash) to check out. Default HEAD.
+              "syncRev": "A String", # Optional. Git revision (tag or hash) or branch to sync from. Default `HEAD`. If not `HEAD`, takes precedence over `sync_branch` field. When using a hash, must be a full hash, and not an abbreviated form.
               "syncWaitSecs": "A String", # Optional. Period in seconds between consecutive syncs. Default: 15.
             },
             "metricsGcpServiceAccountEmail": "A String", # Optional. The Email of the Google Cloud Service Account (GSA) used for exporting Config Sync metrics to Cloud Monitoring and Cloud Monarch when Workload Identity is enabled. The GSA should have the Monitoring Metric Writer (roles/monitoring.metricWriter) IAM role. The Kubernetes ServiceAccount `default` in the namespace `config-management-monitoring` should be bound to the GSA. Deprecated: If Workload Identity Federation for GKE is enabled, Google Cloud Service Account is no longer needed for exporting Config Sync metrics: https://cloud.google.com/kubernetes-engine/enterprise/config-sync/docs/how-to/monitor-config-sync-cloud-monitoring#custom-monitoring.
             "oci": { # OCI repo configuration for a single cluster. # Optional. OCI repo configuration for the cluster.
-              "gcpServiceAccountEmail": "A String", # Optional. The Google Cloud Service Account Email used for auth when secret_type is `gcpserviceaccount`.
+              "gcpServiceAccountEmail": "A String", # Optional. The Google Cloud Service Account Email used for auth when secret_type is `gcpserviceaccount`. Annotates the `RootSync` or `RepoSync` controller's Kubernetes Service Account.
               "policyDir": "A String", # Optional. The absolute path of the directory that contains the local resources. Default: the root directory of the image.
               "secretType": "A String", # Required. Type of secret configured for access to the OCI repo. Must be one of `gcenode`, `gcpserviceaccount`, `k8sserviceaccount` or `none`. The validation of this is case-sensitive.
               "syncRepo": "A String", # Required. The OCI image repository URL for the package to sync from. e.g. `LOCATION-docker.pkg.dev/PROJECT_ID/REPOSITORY_NAME/PACKAGE_NAME`.
               "syncWaitSecs": "A String", # Optional. Period in seconds between consecutive syncs. Default: 15.
             },
             "preventDrift": True or False, # Optional. Set to true to enable the Config Sync admission webhook to prevent drifts. If set to false, disables the Config Sync admission webhook and does not prevent drifts. Defaults to false. See https://docs.cloud.google.com/kubernetes-engine/config-sync/docs/how-to/prevent-config-drift for details.
-            "sourceFormat": "A String", # Optional. Specifies whether the Config Sync repo is in `hierarchical` or `unstructured` mode. Defaults to `hierarchical`. See https://docs.cloud.google.com/kubernetes-engine/config-sync/docs/concepts/configs#organize-configs for an explanation.
+            "sourceFormat": "A String", # Optional. Specifies whether the Config Sync repo is in `hierarchy` or `unstructured` mode. Defaults to `hierarchy`. See https://docs.cloud.google.com/kubernetes-engine/config-sync/docs/concepts/configs#organize-configs for an explanation.
             "stopSyncing": True or False, # Optional. Set to true to stop syncing configs for a single cluster. Default to false.
           },
           "hierarchyController": { # Configuration for Hierarchy Controller. # Optional. Hierarchy Controller configuration for the cluster. Deprecated: Configuring Hierarchy Controller through the configmanagement feature is no longer recommended. Use https://github.com/kubernetes-sigs/hierarchical-namespaces instead.
@@ -1831,25 +1831,25 @@ 
Method Details

               ],
               "enabled": True or False, # Optional. Enables the installation of Config Sync. If set to true, the Feature will manage Config Sync resources, and apply the other ConfigSync fields if they exist. If set to false, the Feature will ignore all other ConfigSync fields and delete the Config Sync resources. If omitted, ConfigSync is considered enabled if the git or oci field is present.
               "git": { # Git repo configuration for a single cluster. # Optional. Git repo configuration for the cluster.
-                "gcpServiceAccountEmail": "A String", # Optional. The Google Cloud Service Account Email used for auth when secret_type is `gcpserviceaccount`.
-                "httpsProxy": "A String", # Optional. URL for the HTTPS proxy to be used when communicating with the Git repo. Only specify when secret_type is `cookiefile`, `token`, or `none`.
+                "gcpServiceAccountEmail": "A String", # Optional. The Google Cloud Service Account Email used for auth when secret_type is `gcpserviceaccount`. Annotates the `RootSync` or `RepoSync` controller's Kubernetes Service Account.
+                "httpsProxy": "A String", # Optional. URL for the HTTPS proxy to be used when communicating with the Git repo. Defines an HTTPS_PROXY environment variable and only accepts `https` or unadorned URLs. For example, `https://proxy.internal.business.co:443` or `proxy.internal.business.co:443`. If using an unadorned URL, make sure the communication between your proxy server and Git host is secure. Rejects `http://` URLs. Only specify when secret_type is `cookiefile`, `token`, or `none`.
                 "policyDir": "A String", # Optional. The path within the Git repository that represents the top level of the repo to sync. Default: the root directory of the repository.
                 "secretType": "A String", # Required. Type of secret configured for access to the Git repo. Must be one of `ssh`, `cookiefile`, `gcenode`, `token`, `gcpserviceaccount`, `githubapp` or `none`. The validation of this is case-sensitive.
                 "syncBranch": "A String", # Optional. The branch of the repository to sync from. Default: master.
                 "syncRepo": "A String", # Required. The URL of the Git repository to use as the source of truth.
-                "syncRev": "A String", # Optional. Git revision (tag or hash) to check out. Default HEAD.
+                "syncRev": "A String", # Optional. Git revision (tag or hash) or branch to sync from. Default `HEAD`. If not `HEAD`, takes precedence over `sync_branch` field. When using a hash, must be a full hash, and not an abbreviated form.
                 "syncWaitSecs": "A String", # Optional. Period in seconds between consecutive syncs. Default: 15.
               },
               "metricsGcpServiceAccountEmail": "A String", # Optional. The Email of the Google Cloud Service Account (GSA) used for exporting Config Sync metrics to Cloud Monitoring and Cloud Monarch when Workload Identity is enabled. The GSA should have the Monitoring Metric Writer (roles/monitoring.metricWriter) IAM role. The Kubernetes ServiceAccount `default` in the namespace `config-management-monitoring` should be bound to the GSA. Deprecated: If Workload Identity Federation for GKE is enabled, Google Cloud Service Account is no longer needed for exporting Config Sync metrics: https://cloud.google.com/kubernetes-engine/enterprise/config-sync/docs/how-to/monitor-config-sync-cloud-monitoring#custom-monitoring.
               "oci": { # OCI repo configuration for a single cluster. # Optional. OCI repo configuration for the cluster.
-                "gcpServiceAccountEmail": "A String", # Optional. The Google Cloud Service Account Email used for auth when secret_type is `gcpserviceaccount`.
+                "gcpServiceAccountEmail": "A String", # Optional. The Google Cloud Service Account Email used for auth when secret_type is `gcpserviceaccount`. Annotates the `RootSync` or `RepoSync` controller's Kubernetes Service Account.
                 "policyDir": "A String", # Optional. The absolute path of the directory that contains the local resources. Default: the root directory of the image.
                 "secretType": "A String", # Required. Type of secret configured for access to the OCI repo. Must be one of `gcenode`, `gcpserviceaccount`, `k8sserviceaccount` or `none`. The validation of this is case-sensitive.
                 "syncRepo": "A String", # Required. The OCI image repository URL for the package to sync from. e.g. `LOCATION-docker.pkg.dev/PROJECT_ID/REPOSITORY_NAME/PACKAGE_NAME`.
                 "syncWaitSecs": "A String", # Optional. Period in seconds between consecutive syncs. Default: 15.
               },
               "preventDrift": True or False, # Optional. Set to true to enable the Config Sync admission webhook to prevent drifts. If set to false, disables the Config Sync admission webhook and does not prevent drifts. Defaults to false. See https://docs.cloud.google.com/kubernetes-engine/config-sync/docs/how-to/prevent-config-drift for details.
-              "sourceFormat": "A String", # Optional. Specifies whether the Config Sync repo is in `hierarchical` or `unstructured` mode. Defaults to `hierarchical`. See https://docs.cloud.google.com/kubernetes-engine/config-sync/docs/concepts/configs#organize-configs for an explanation.
+              "sourceFormat": "A String", # Optional. Specifies whether the Config Sync repo is in `hierarchy` or `unstructured` mode. Defaults to `hierarchy`. See https://docs.cloud.google.com/kubernetes-engine/config-sync/docs/concepts/configs#organize-configs for an explanation.
               "stopSyncing": True or False, # Optional. Set to true to stop syncing configs for a single cluster. Default to false.
             },
             "hierarchyController": { # Configuration for Hierarchy Controller. # Optional. Hierarchy Controller configuration for the cluster. Deprecated: Configuring Hierarchy Controller through the configmanagement feature is no longer recommended. Use https://github.com/kubernetes-sigs/hierarchical-namespaces instead.
@@ -2161,25 +2161,25 @@ 
Method Details

         ],
         "enabled": True or False, # Optional. Enables the installation of Config Sync. If set to true, the Feature will manage Config Sync resources, and apply the other ConfigSync fields if they exist. If set to false, the Feature will ignore all other ConfigSync fields and delete the Config Sync resources. If omitted, ConfigSync is considered enabled if the git or oci field is present.
         "git": { # Git repo configuration for a single cluster. # Optional. Git repo configuration for the cluster.
-          "gcpServiceAccountEmail": "A String", # Optional. The Google Cloud Service Account Email used for auth when secret_type is `gcpserviceaccount`.
-          "httpsProxy": "A String", # Optional. URL for the HTTPS proxy to be used when communicating with the Git repo. Only specify when secret_type is `cookiefile`, `token`, or `none`.
+          "gcpServiceAccountEmail": "A String", # Optional. The Google Cloud Service Account Email used for auth when secret_type is `gcpserviceaccount`. Annotates the `RootSync` or `RepoSync` controller's Kubernetes Service Account.
+          "httpsProxy": "A String", # Optional. URL for the HTTPS proxy to be used when communicating with the Git repo. Defines an HTTPS_PROXY environment variable and only accepts `https` or unadorned URLs. For example, `https://proxy.internal.business.co:443` or `proxy.internal.business.co:443`. If using an unadorned URL, make sure the communication between your proxy server and Git host is secure. Rejects `http://` URLs. Only specify when secret_type is `cookiefile`, `token`, or `none`.
           "policyDir": "A String", # Optional. The path within the Git repository that represents the top level of the repo to sync. Default: the root directory of the repository.
           "secretType": "A String", # Required. Type of secret configured for access to the Git repo. Must be one of `ssh`, `cookiefile`, `gcenode`, `token`, `gcpserviceaccount`, `githubapp` or `none`. The validation of this is case-sensitive.
           "syncBranch": "A String", # Optional. The branch of the repository to sync from. Default: master.
           "syncRepo": "A String", # Required. The URL of the Git repository to use as the source of truth.
-          "syncRev": "A String", # Optional. Git revision (tag or hash) to check out. Default HEAD.
+          "syncRev": "A String", # Optional. Git revision (tag or hash) or branch to sync from. Default `HEAD`. If not `HEAD`, takes precedence over `sync_branch` field. When using a hash, must be a full hash, and not an abbreviated form.
           "syncWaitSecs": "A String", # Optional. Period in seconds between consecutive syncs. Default: 15.
         },
         "metricsGcpServiceAccountEmail": "A String", # Optional. The Email of the Google Cloud Service Account (GSA) used for exporting Config Sync metrics to Cloud Monitoring and Cloud Monarch when Workload Identity is enabled. The GSA should have the Monitoring Metric Writer (roles/monitoring.metricWriter) IAM role. The Kubernetes ServiceAccount `default` in the namespace `config-management-monitoring` should be bound to the GSA. Deprecated: If Workload Identity Federation for GKE is enabled, Google Cloud Service Account is no longer needed for exporting Config Sync metrics: https://cloud.google.com/kubernetes-engine/enterprise/config-sync/docs/how-to/monitor-config-sync-cloud-monitoring#custom-monitoring.
         "oci": { # OCI repo configuration for a single cluster. # Optional. OCI repo configuration for the cluster.
-          "gcpServiceAccountEmail": "A String", # Optional. The Google Cloud Service Account Email used for auth when secret_type is `gcpserviceaccount`.
+          "gcpServiceAccountEmail": "A String", # Optional. The Google Cloud Service Account Email used for auth when secret_type is `gcpserviceaccount`. Annotates the `RootSync` or `RepoSync` controller's Kubernetes Service Account.
           "policyDir": "A String", # Optional. The absolute path of the directory that contains the local resources. Default: the root directory of the image.
           "secretType": "A String", # Required. Type of secret configured for access to the OCI repo. Must be one of `gcenode`, `gcpserviceaccount`, `k8sserviceaccount` or `none`. The validation of this is case-sensitive.
           "syncRepo": "A String", # Required. The OCI image repository URL for the package to sync from. e.g. `LOCATION-docker.pkg.dev/PROJECT_ID/REPOSITORY_NAME/PACKAGE_NAME`.
           "syncWaitSecs": "A String", # Optional. Period in seconds between consecutive syncs. Default: 15.
         },
         "preventDrift": True or False, # Optional. Set to true to enable the Config Sync admission webhook to prevent drifts. If set to false, disables the Config Sync admission webhook and does not prevent drifts. Defaults to false. See https://docs.cloud.google.com/kubernetes-engine/config-sync/docs/how-to/prevent-config-drift for details.
-        "sourceFormat": "A String", # Optional. Specifies whether the Config Sync repo is in `hierarchical` or `unstructured` mode. Defaults to `hierarchical`. See https://docs.cloud.google.com/kubernetes-engine/config-sync/docs/concepts/configs#organize-configs for an explanation.
+        "sourceFormat": "A String", # Optional. Specifies whether the Config Sync repo is in `hierarchy` or `unstructured` mode. Defaults to `hierarchy`. See https://docs.cloud.google.com/kubernetes-engine/config-sync/docs/concepts/configs#organize-configs for an explanation.
         "stopSyncing": True or False, # Optional. Set to true to stop syncing configs for a single cluster. Default to false.
       },
       "hierarchyController": { # Configuration for Hierarchy Controller. # Optional. Hierarchy Controller configuration for the cluster. Deprecated: Configuring Hierarchy Controller through the configmanagement feature is no longer recommended. Use https://github.com/kubernetes-sigs/hierarchical-namespaces instead.
@@ -2488,25 +2488,25 @@ 
Method Details

           ],
           "enabled": True or False, # Optional. Enables the installation of Config Sync. If set to true, the Feature will manage Config Sync resources, and apply the other ConfigSync fields if they exist. If set to false, the Feature will ignore all other ConfigSync fields and delete the Config Sync resources. If omitted, ConfigSync is considered enabled if the git or oci field is present.
           "git": { # Git repo configuration for a single cluster. # Optional. Git repo configuration for the cluster.
-            "gcpServiceAccountEmail": "A String", # Optional. The Google Cloud Service Account Email used for auth when secret_type is `gcpserviceaccount`.
-            "httpsProxy": "A String", # Optional. URL for the HTTPS proxy to be used when communicating with the Git repo. Only specify when secret_type is `cookiefile`, `token`, or `none`.
+            "gcpServiceAccountEmail": "A String", # Optional. The Google Cloud Service Account Email used for auth when secret_type is `gcpserviceaccount`. Annotates the `RootSync` or `RepoSync` controller's Kubernetes Service Account.
+            "httpsProxy": "A String", # Optional. URL for the HTTPS proxy to be used when communicating with the Git repo. Defines an HTTPS_PROXY environment variable and only accepts `https` or unadorned URLs. For example, `https://proxy.internal.business.co:443` or `proxy.internal.business.co:443`. If using an unadorned URL, make sure the communication between your proxy server and Git host is secure. Rejects `http://` URLs. Only specify when secret_type is `cookiefile`, `token`, or `none`.
             "policyDir": "A String", # Optional. The path within the Git repository that represents the top level of the repo to sync. Default: the root directory of the repository.
             "secretType": "A String", # Required. Type of secret configured for access to the Git repo. Must be one of `ssh`, `cookiefile`, `gcenode`, `token`, `gcpserviceaccount`, `githubapp` or `none`. The validation of this is case-sensitive.
             "syncBranch": "A String", # Optional. The branch of the repository to sync from. Default: master.
             "syncRepo": "A String", # Required. The URL of the Git repository to use as the source of truth.
-            "syncRev": "A String", # Optional. Git revision (tag or hash) to check out. Default HEAD.
+            "syncRev": "A String", # Optional. Git revision (tag or hash) or branch to sync from. Default `HEAD`. If not `HEAD`, takes precedence over `sync_branch` field. When using a hash, must be a full hash, and not an abbreviated form.
             "syncWaitSecs": "A String", # Optional. Period in seconds between consecutive syncs. Default: 15.
           },
           "metricsGcpServiceAccountEmail": "A String", # Optional. The Email of the Google Cloud Service Account (GSA) used for exporting Config Sync metrics to Cloud Monitoring and Cloud Monarch when Workload Identity is enabled. The GSA should have the Monitoring Metric Writer (roles/monitoring.metricWriter) IAM role. The Kubernetes ServiceAccount `default` in the namespace `config-management-monitoring` should be bound to the GSA. Deprecated: If Workload Identity Federation for GKE is enabled, Google Cloud Service Account is no longer needed for exporting Config Sync metrics: https://cloud.google.com/kubernetes-engine/enterprise/config-sync/docs/how-to/monitor-config-sync-cloud-monitoring#custom-monitoring.
           "oci": { # OCI repo configuration for a single cluster. # Optional. OCI repo configuration for the cluster.
-            "gcpServiceAccountEmail": "A String", # Optional. The Google Cloud Service Account Email used for auth when secret_type is `gcpserviceaccount`.
+            "gcpServiceAccountEmail": "A String", # Optional. The Google Cloud Service Account Email used for auth when secret_type is `gcpserviceaccount`. Annotates the `RootSync` or `RepoSync` controller's Kubernetes Service Account.
             "policyDir": "A String", # Optional. The absolute path of the directory that contains the local resources. Default: the root directory of the image.
             "secretType": "A String", # Required. Type of secret configured for access to the OCI repo. Must be one of `gcenode`, `gcpserviceaccount`, `k8sserviceaccount` or `none`. The validation of this is case-sensitive.
             "syncRepo": "A String", # Required. The OCI image repository URL for the package to sync from. e.g. `LOCATION-docker.pkg.dev/PROJECT_ID/REPOSITORY_NAME/PACKAGE_NAME`.
             "syncWaitSecs": "A String", # Optional. Period in seconds between consecutive syncs. Default: 15.
           },
           "preventDrift": True or False, # Optional. Set to true to enable the Config Sync admission webhook to prevent drifts. If set to false, disables the Config Sync admission webhook and does not prevent drifts. Defaults to false. See https://docs.cloud.google.com/kubernetes-engine/config-sync/docs/how-to/prevent-config-drift for details.
-          "sourceFormat": "A String", # Optional. Specifies whether the Config Sync repo is in `hierarchical` or `unstructured` mode. Defaults to `hierarchical`. See https://docs.cloud.google.com/kubernetes-engine/config-sync/docs/concepts/configs#organize-configs for an explanation.
+          "sourceFormat": "A String", # Optional. Specifies whether the Config Sync repo is in `hierarchy` or `unstructured` mode. Defaults to `hierarchy`. See https://docs.cloud.google.com/kubernetes-engine/config-sync/docs/concepts/configs#organize-configs for an explanation.
           "stopSyncing": True or False, # Optional. Set to true to stop syncing configs for a single cluster. Default to false.
         },
         "hierarchyController": { # Configuration for Hierarchy Controller. # Optional. Hierarchy Controller configuration for the cluster. Deprecated: Configuring Hierarchy Controller through the configmanagement feature is no longer recommended. Use https://github.com/kubernetes-sigs/hierarchical-namespaces instead.
diff --git a/docs/dyn/integrations_v1.projects.locations.integrations.executions.suspensions.html b/docs/dyn/integrations_v1.projects.locations.integrations.executions.suspensions.html
index 7e42de6aeb..8be87bc49f 100644
--- a/docs/dyn/integrations_v1.projects.locations.integrations.executions.suspensions.html
+++ b/docs/dyn/integrations_v1.projects.locations.integrations.executions.suspensions.html
@@ -245,7 +245,7 @@ 
Method Details

                 "testMode": True or False, # Optional. Sets test mode in {@link enterprise/crm/eventbus/event_message.proto}.
                 "triggerId": "A String", # Matched against all {@link TriggerConfig}s across all workflows. i.e. TriggerConfig.trigger_id.equals(trigger_id) Required.
                 "userGeneratedExecutionId": "A String", # This is a unique id provided by the method caller. If provided this will be used as the execution_id when a new execution info is created. This is a string representation of a UUID. Must have no more than 36 characters and contain only alphanumeric characters and hyphens.
-                "workflowId": "A String", # Optional. Pins the enqueue to this exact version rather than the ACTIVE one on the trigger, so an unpublished draft can be tested. Requires client_id, and the version is validated before it is enqueued; see integrationplatform/api/executionsservice/README.md.
+                "workflowId": "A String", # Optional. Pins the enqueue to this exact version. Requires client_id, and only an ACTIVE version is accepted: the drain re-resolves by trigger id, so nothing else could run. Unset by every caller today; draft support is b/570602030. See integrationplatform/api/executionsservice/README.md.
                 "workflowName": "A String", # Optional. If provided, the workflow_name is used to filter all the matched workflows having same trigger_id+client_id. A combination of trigger_id, client_id and workflow_name identifies a unique workflow.
               },
               "suspensionInfoEventParameterKey": "A String", # In the fired event, set the SuspensionInfo message as the value for this key.
@@ -405,7 +405,7 @@ 
Method Details

               "testMode": True or False, # Optional. Sets test mode in {@link enterprise/crm/eventbus/event_message.proto}.
               "triggerId": "A String", # Matched against all {@link TriggerConfig}s across all workflows. i.e. TriggerConfig.trigger_id.equals(trigger_id) Required.
               "userGeneratedExecutionId": "A String", # This is a unique id provided by the method caller. If provided this will be used as the execution_id when a new execution info is created. This is a string representation of a UUID. Must have no more than 36 characters and contain only alphanumeric characters and hyphens.
-              "workflowId": "A String", # Optional. Pins the enqueue to this exact version rather than the ACTIVE one on the trigger, so an unpublished draft can be tested. Requires client_id, and the version is validated before it is enqueued; see integrationplatform/api/executionsservice/README.md.
+              "workflowId": "A String", # Optional. Pins the enqueue to this exact version. Requires client_id, and only an ACTIVE version is accepted: the drain re-resolves by trigger id, so nothing else could run. Unset by every caller today; draft support is b/570602030. See integrationplatform/api/executionsservice/README.md.
               "workflowName": "A String", # Optional. If provided, the workflow_name is used to filter all the matched workflows having same trigger_id+client_id. A combination of trigger_id, client_id and workflow_name identifies a unique workflow.
             },
             "suspensionInfoEventParameterKey": "A String", # In the fired event, set the SuspensionInfo message as the value for this key.
diff --git a/docs/dyn/integrations_v1.projects.locations.products.integrations.executions.suspensions.html b/docs/dyn/integrations_v1.projects.locations.products.integrations.executions.suspensions.html
index 528c81e6c1..9029b8158f 100644
--- a/docs/dyn/integrations_v1.projects.locations.products.integrations.executions.suspensions.html
+++ b/docs/dyn/integrations_v1.projects.locations.products.integrations.executions.suspensions.html
@@ -245,7 +245,7 @@ 
Method Details

                 "testMode": True or False, # Optional. Sets test mode in {@link enterprise/crm/eventbus/event_message.proto}.
                 "triggerId": "A String", # Matched against all {@link TriggerConfig}s across all workflows. i.e. TriggerConfig.trigger_id.equals(trigger_id) Required.
                 "userGeneratedExecutionId": "A String", # This is a unique id provided by the method caller. If provided this will be used as the execution_id when a new execution info is created. This is a string representation of a UUID. Must have no more than 36 characters and contain only alphanumeric characters and hyphens.
-                "workflowId": "A String", # Optional. Pins the enqueue to this exact version rather than the ACTIVE one on the trigger, so an unpublished draft can be tested. Requires client_id, and the version is validated before it is enqueued; see integrationplatform/api/executionsservice/README.md.
+                "workflowId": "A String", # Optional. Pins the enqueue to this exact version. Requires client_id, and only an ACTIVE version is accepted: the drain re-resolves by trigger id, so nothing else could run. Unset by every caller today; draft support is b/570602030. See integrationplatform/api/executionsservice/README.md.
                 "workflowName": "A String", # Optional. If provided, the workflow_name is used to filter all the matched workflows having same trigger_id+client_id. A combination of trigger_id, client_id and workflow_name identifies a unique workflow.
               },
               "suspensionInfoEventParameterKey": "A String", # In the fired event, set the SuspensionInfo message as the value for this key.
@@ -405,7 +405,7 @@ 
Method Details

               "testMode": True or False, # Optional. Sets test mode in {@link enterprise/crm/eventbus/event_message.proto}.
               "triggerId": "A String", # Matched against all {@link TriggerConfig}s across all workflows. i.e. TriggerConfig.trigger_id.equals(trigger_id) Required.
               "userGeneratedExecutionId": "A String", # This is a unique id provided by the method caller. If provided this will be used as the execution_id when a new execution info is created. This is a string representation of a UUID. Must have no more than 36 characters and contain only alphanumeric characters and hyphens.
-              "workflowId": "A String", # Optional. Pins the enqueue to this exact version rather than the ACTIVE one on the trigger, so an unpublished draft can be tested. Requires client_id, and the version is validated before it is enqueued; see integrationplatform/api/executionsservice/README.md.
+              "workflowId": "A String", # Optional. Pins the enqueue to this exact version. Requires client_id, and only an ACTIVE version is accepted: the drain re-resolves by trigger id, so nothing else could run. Unset by every caller today; draft support is b/570602030. See integrationplatform/api/executionsservice/README.md.
               "workflowName": "A String", # Optional. If provided, the workflow_name is used to filter all the matched workflows having same trigger_id+client_id. A combination of trigger_id, client_id and workflow_name identifies a unique workflow.
             },
             "suspensionInfoEventParameterKey": "A String", # In the fired event, set the SuspensionInfo message as the value for this key.
diff --git a/docs/dyn/merchantapi_products_v1.accounts.productInputs.html b/docs/dyn/merchantapi_products_v1.accounts.productInputs.html
index b244c099c4..31c108ae00 100644
--- a/docs/dyn/merchantapi_products_v1.accounts.productInputs.html
+++ b/docs/dyn/merchantapi_products_v1.accounts.productInputs.html
@@ -643,7 +643,7 @@ 
Method Details

     ],
     "vin": "A String", # The [Vehicle Identification Number (VIN)](https://support.google.com/google-ads/answer/14154510) of the vehicle.
     "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.
-    "warranty": { # The warranty of the vehicle. # The [warranty](https://support.google.com/merchants/answer/15957626) of the product.
+    "warranty": { # The warranty of the product. # The [`warranty`](https://support.google.com/merchants/answer/18562485) of the product.
       "duration": "A String", # The warranty duration in units. Default is in months, can be overridden by the `duration_unit` field.
       "durationUnit": "A String", # The unit for the warranty duration. Assumed to be `MONTH` if equal to `WARRANTY_DURATION_UNIT_UNSPECIFIED`.
       "mileage": { # The mileage of the vehicle. # The warranty mileage (only applies to vehicles).
@@ -1188,7 +1188,7 @@ 
Method Details

     ],
     "vin": "A String", # The [Vehicle Identification Number (VIN)](https://support.google.com/google-ads/answer/14154510) of the vehicle.
     "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.
-    "warranty": { # The warranty of the vehicle. # The [warranty](https://support.google.com/merchants/answer/15957626) of the product.
+    "warranty": { # The warranty of the product. # The [`warranty`](https://support.google.com/merchants/answer/18562485) of the product.
       "duration": "A String", # The warranty duration in units. Default is in months, can be overridden by the `duration_unit` field.
       "durationUnit": "A String", # The unit for the warranty duration. Assumed to be `MONTH` if equal to `WARRANTY_DURATION_UNIT_UNSPECIFIED`.
       "mileage": { # The mileage of the vehicle. # The warranty mileage (only applies to vehicles).
@@ -1734,7 +1734,7 @@ 
Method Details

     ],
     "vin": "A String", # The [Vehicle Identification Number (VIN)](https://support.google.com/google-ads/answer/14154510) of the vehicle.
     "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.
-    "warranty": { # The warranty of the vehicle. # The [warranty](https://support.google.com/merchants/answer/15957626) of the product.
+    "warranty": { # The warranty of the product. # The [`warranty`](https://support.google.com/merchants/answer/18562485) of the product.
       "duration": "A String", # The warranty duration in units. Default is in months, can be overridden by the `duration_unit` field.
       "durationUnit": "A String", # The unit for the warranty duration. Assumed to be `MONTH` if equal to `WARRANTY_DURATION_UNIT_UNSPECIFIED`.
       "mileage": { # The mileage of the vehicle. # The warranty mileage (only applies to vehicles).
@@ -2280,7 +2280,7 @@ 
Method Details

     ],
     "vin": "A String", # The [Vehicle Identification Number (VIN)](https://support.google.com/google-ads/answer/14154510) of the vehicle.
     "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.
-    "warranty": { # The warranty of the vehicle. # The [warranty](https://support.google.com/merchants/answer/15957626) of the product.
+    "warranty": { # The warranty of the product. # The [`warranty`](https://support.google.com/merchants/answer/18562485) of the product.
       "duration": "A String", # The warranty duration in units. Default is in months, can be overridden by the `duration_unit` field.
       "durationUnit": "A String", # The unit for the warranty duration. Assumed to be `MONTH` if equal to `WARRANTY_DURATION_UNIT_UNSPECIFIED`.
       "mileage": { # The mileage of the vehicle. # The warranty mileage (only applies to vehicles).
diff --git a/docs/dyn/merchantapi_products_v1.accounts.products.html b/docs/dyn/merchantapi_products_v1.accounts.products.html
index 49b1d2c1ea..bef7d10fe4 100644
--- a/docs/dyn/merchantapi_products_v1.accounts.products.html
+++ b/docs/dyn/merchantapi_products_v1.accounts.products.html
@@ -643,7 +643,7 @@ 
Method Details

     ],
     "vin": "A String", # The [Vehicle Identification Number (VIN)](https://support.google.com/google-ads/answer/14154510) of the vehicle.
     "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.
-    "warranty": { # The warranty of the vehicle. # The [warranty](https://support.google.com/merchants/answer/15957626) of the product.
+    "warranty": { # The warranty of the product. # The [`warranty`](https://support.google.com/merchants/answer/18562485) of the product.
       "duration": "A String", # The warranty duration in units. Default is in months, can be overridden by the `duration_unit` field.
       "durationUnit": "A String", # The unit for the warranty duration. Assumed to be `MONTH` if equal to `WARRANTY_DURATION_UNIT_UNSPECIFIED`.
       "mileage": { # The mileage of the vehicle. # The warranty mileage (only applies to vehicles).
@@ -1247,7 +1247,7 @@ 
Method Details

         ],
         "vin": "A String", # The [Vehicle Identification Number (VIN)](https://support.google.com/google-ads/answer/14154510) of the vehicle.
         "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.
-        "warranty": { # The warranty of the vehicle. # The [warranty](https://support.google.com/merchants/answer/15957626) of the product.
+        "warranty": { # The warranty of the product. # The [`warranty`](https://support.google.com/merchants/answer/18562485) of the product.
           "duration": "A String", # The warranty duration in units. Default is in months, can be overridden by the `duration_unit` field.
           "durationUnit": "A String", # The unit for the warranty duration. Assumed to be `MONTH` if equal to `WARRANTY_DURATION_UNIT_UNSPECIFIED`.
           "mileage": { # The mileage of the vehicle. # The warranty mileage (only applies to vehicles).
diff --git a/docs/dyn/networkmanagement_v1.projects.locations.global_.connectivityTests.html b/docs/dyn/networkmanagement_v1.projects.locations.global_.connectivityTests.html
index 4781a12253..c927c91bd5 100644
--- a/docs/dyn/networkmanagement_v1.projects.locations.global_.connectivityTests.html
+++ b/docs/dyn/networkmanagement_v1.projects.locations.global_.connectivityTests.html
@@ -137,7 +137,6 @@ 
Method Details

     "cloudRunRevision": { # Wrapper for Cloud Run revision attributes. # A [Cloud Run](https://cloud.google.com/run) [revision](https://cloud.google.com/run/docs/reference/rest/v1/namespaces.revisions/get) Applicable only to source endpoint.
       "serviceUri": "A String", # Output only. The URI of the Cloud Run service that the revision belongs to. The format is: projects/{project}/locations/{location}/services/{service}. Mutually exclusive with worker_pool_uri.
       "uri": "A String", # A [Cloud Run](https://cloud.google.com/run) [revision](https://cloud.google.com/run/docs/reference/rest/v1/namespaces.revisions/get) URI. The format is: projects/{project}/locations/{location}/revisions/{revision}
-      "workerPoolUri": "A String", # Output only. The URI of the worker pool that the revision belongs to. The format is: projects/{project}/locations/{location}/workerPools/{workerPool}. Mutually exclusive with service_uri.
     },
     "cloudSqlInstance": "A String", # A [Cloud SQL](https://cloud.google.com/sql) instance URI.
     "dmsPrivateConnection": "A String", # A [DMS Private Connection](https://docs.cloud.google.com/database-migration/docs/reference/rest/v1/projects.locations.privateConnections) name format: projects/{project}/locations/{location}/privateConnections/{privateConnection}.
@@ -979,7 +978,6 @@ 
Method Details

     "cloudRunRevision": { # Wrapper for Cloud Run revision attributes. # A [Cloud Run](https://cloud.google.com/run) [revision](https://cloud.google.com/run/docs/reference/rest/v1/namespaces.revisions/get) Applicable only to source endpoint.
       "serviceUri": "A String", # Output only. The URI of the Cloud Run service that the revision belongs to. The format is: projects/{project}/locations/{location}/services/{service}. Mutually exclusive with worker_pool_uri.
       "uri": "A String", # A [Cloud Run](https://cloud.google.com/run) [revision](https://cloud.google.com/run/docs/reference/rest/v1/namespaces.revisions/get) URI. The format is: projects/{project}/locations/{location}/revisions/{revision}
-      "workerPoolUri": "A String", # Output only. The URI of the worker pool that the revision belongs to. The format is: projects/{project}/locations/{location}/workerPools/{workerPool}. Mutually exclusive with service_uri.
     },
     "cloudSqlInstance": "A String", # A [Cloud SQL](https://cloud.google.com/sql) instance URI.
     "dmsPrivateConnection": "A String", # A [DMS Private Connection](https://docs.cloud.google.com/database-migration/docs/reference/rest/v1/projects.locations.privateConnections) name format: projects/{project}/locations/{location}/privateConnections/{privateConnection}.
@@ -1096,7 +1094,6 @@ 
Method Details

     "cloudRunRevision": { # Wrapper for Cloud Run revision attributes. # A [Cloud Run](https://cloud.google.com/run) [revision](https://cloud.google.com/run/docs/reference/rest/v1/namespaces.revisions/get) Applicable only to source endpoint.
       "serviceUri": "A String", # Output only. The URI of the Cloud Run service that the revision belongs to. The format is: projects/{project}/locations/{location}/services/{service}. Mutually exclusive with worker_pool_uri.
       "uri": "A String", # A [Cloud Run](https://cloud.google.com/run) [revision](https://cloud.google.com/run/docs/reference/rest/v1/namespaces.revisions/get) URI. The format is: projects/{project}/locations/{location}/revisions/{revision}
-      "workerPoolUri": "A String", # Output only. The URI of the worker pool that the revision belongs to. The format is: projects/{project}/locations/{location}/workerPools/{workerPool}. Mutually exclusive with service_uri.
     },
     "cloudSqlInstance": "A String", # A [Cloud SQL](https://cloud.google.com/sql) instance URI.
     "dmsPrivateConnection": "A String", # A [DMS Private Connection](https://docs.cloud.google.com/database-migration/docs/reference/rest/v1/projects.locations.privateConnections) name format: projects/{project}/locations/{location}/privateConnections/{privateConnection}.
@@ -1938,7 +1935,6 @@ 
Method Details

     "cloudRunRevision": { # Wrapper for Cloud Run revision attributes. # A [Cloud Run](https://cloud.google.com/run) [revision](https://cloud.google.com/run/docs/reference/rest/v1/namespaces.revisions/get) Applicable only to source endpoint.
       "serviceUri": "A String", # Output only. The URI of the Cloud Run service that the revision belongs to. The format is: projects/{project}/locations/{location}/services/{service}. Mutually exclusive with worker_pool_uri.
       "uri": "A String", # A [Cloud Run](https://cloud.google.com/run) [revision](https://cloud.google.com/run/docs/reference/rest/v1/namespaces.revisions/get) URI. The format is: projects/{project}/locations/{location}/revisions/{revision}
-      "workerPoolUri": "A String", # Output only. The URI of the worker pool that the revision belongs to. The format is: projects/{project}/locations/{location}/workerPools/{workerPool}. Mutually exclusive with service_uri.
     },
     "cloudSqlInstance": "A String", # A [Cloud SQL](https://cloud.google.com/sql) instance URI.
     "dmsPrivateConnection": "A String", # A [DMS Private Connection](https://docs.cloud.google.com/database-migration/docs/reference/rest/v1/projects.locations.privateConnections) name format: projects/{project}/locations/{location}/privateConnections/{privateConnection}.
@@ -2046,7 +2042,6 @@ 
Method Details

         "cloudRunRevision": { # Wrapper for Cloud Run revision attributes. # A [Cloud Run](https://cloud.google.com/run) [revision](https://cloud.google.com/run/docs/reference/rest/v1/namespaces.revisions/get) Applicable only to source endpoint.
           "serviceUri": "A String", # Output only. The URI of the Cloud Run service that the revision belongs to. The format is: projects/{project}/locations/{location}/services/{service}. Mutually exclusive with worker_pool_uri.
           "uri": "A String", # A [Cloud Run](https://cloud.google.com/run) [revision](https://cloud.google.com/run/docs/reference/rest/v1/namespaces.revisions/get) URI. The format is: projects/{project}/locations/{location}/revisions/{revision}
-          "workerPoolUri": "A String", # Output only. The URI of the worker pool that the revision belongs to. The format is: projects/{project}/locations/{location}/workerPools/{workerPool}. Mutually exclusive with service_uri.
         },
         "cloudSqlInstance": "A String", # A [Cloud SQL](https://cloud.google.com/sql) instance URI.
         "dmsPrivateConnection": "A String", # A [DMS Private Connection](https://docs.cloud.google.com/database-migration/docs/reference/rest/v1/projects.locations.privateConnections) name format: projects/{project}/locations/{location}/privateConnections/{privateConnection}.
@@ -2888,7 +2883,6 @@ 
Method Details

         "cloudRunRevision": { # Wrapper for Cloud Run revision attributes. # A [Cloud Run](https://cloud.google.com/run) [revision](https://cloud.google.com/run/docs/reference/rest/v1/namespaces.revisions/get) Applicable only to source endpoint.
           "serviceUri": "A String", # Output only. The URI of the Cloud Run service that the revision belongs to. The format is: projects/{project}/locations/{location}/services/{service}. Mutually exclusive with worker_pool_uri.
           "uri": "A String", # A [Cloud Run](https://cloud.google.com/run) [revision](https://cloud.google.com/run/docs/reference/rest/v1/namespaces.revisions/get) URI. The format is: projects/{project}/locations/{location}/revisions/{revision}
-          "workerPoolUri": "A String", # Output only. The URI of the worker pool that the revision belongs to. The format is: projects/{project}/locations/{location}/workerPools/{workerPool}. Mutually exclusive with service_uri.
         },
         "cloudSqlInstance": "A String", # A [Cloud SQL](https://cloud.google.com/sql) instance URI.
         "dmsPrivateConnection": "A String", # A [DMS Private Connection](https://docs.cloud.google.com/database-migration/docs/reference/rest/v1/projects.locations.privateConnections) name format: projects/{project}/locations/{location}/privateConnections/{privateConnection}.
@@ -2955,7 +2949,6 @@ 
Method Details

     "cloudRunRevision": { # Wrapper for Cloud Run revision attributes. # A [Cloud Run](https://cloud.google.com/run) [revision](https://cloud.google.com/run/docs/reference/rest/v1/namespaces.revisions/get) Applicable only to source endpoint.
       "serviceUri": "A String", # Output only. The URI of the Cloud Run service that the revision belongs to. The format is: projects/{project}/locations/{location}/services/{service}. Mutually exclusive with worker_pool_uri.
       "uri": "A String", # A [Cloud Run](https://cloud.google.com/run) [revision](https://cloud.google.com/run/docs/reference/rest/v1/namespaces.revisions/get) URI. The format is: projects/{project}/locations/{location}/revisions/{revision}
-      "workerPoolUri": "A String", # Output only. The URI of the worker pool that the revision belongs to. The format is: projects/{project}/locations/{location}/workerPools/{workerPool}. Mutually exclusive with service_uri.
     },
     "cloudSqlInstance": "A String", # A [Cloud SQL](https://cloud.google.com/sql) instance URI.
     "dmsPrivateConnection": "A String", # A [DMS Private Connection](https://docs.cloud.google.com/database-migration/docs/reference/rest/v1/projects.locations.privateConnections) name format: projects/{project}/locations/{location}/privateConnections/{privateConnection}.
@@ -3797,7 +3790,6 @@ 
Method Details

     "cloudRunRevision": { # Wrapper for Cloud Run revision attributes. # A [Cloud Run](https://cloud.google.com/run) [revision](https://cloud.google.com/run/docs/reference/rest/v1/namespaces.revisions/get) Applicable only to source endpoint.
       "serviceUri": "A String", # Output only. The URI of the Cloud Run service that the revision belongs to. The format is: projects/{project}/locations/{location}/services/{service}. Mutually exclusive with worker_pool_uri.
       "uri": "A String", # A [Cloud Run](https://cloud.google.com/run) [revision](https://cloud.google.com/run/docs/reference/rest/v1/namespaces.revisions/get) URI. The format is: projects/{project}/locations/{location}/revisions/{revision}
-      "workerPoolUri": "A String", # Output only. The URI of the worker pool that the revision belongs to. The format is: projects/{project}/locations/{location}/workerPools/{workerPool}. Mutually exclusive with service_uri.
     },
     "cloudSqlInstance": "A String", # A [Cloud SQL](https://cloud.google.com/sql) instance URI.
     "dmsPrivateConnection": "A String", # A [DMS Private Connection](https://docs.cloud.google.com/database-migration/docs/reference/rest/v1/projects.locations.privateConnections) name format: projects/{project}/locations/{location}/privateConnections/{privateConnection}.
diff --git a/docs/dyn/networkmanagement_v1beta1.projects.locations.global_.connectivityTests.html b/docs/dyn/networkmanagement_v1beta1.projects.locations.global_.connectivityTests.html
index 8b97ee2687..539caea368 100644
--- a/docs/dyn/networkmanagement_v1beta1.projects.locations.global_.connectivityTests.html
+++ b/docs/dyn/networkmanagement_v1beta1.projects.locations.global_.connectivityTests.html
@@ -137,7 +137,6 @@ 
Method Details

     "cloudRunRevision": { # Wrapper for Cloud Run revision attributes. # A [Cloud Run](https://cloud.google.com/run) [revision](https://cloud.google.com/run/docs/reference/rest/v1/namespaces.revisions/get) Applicable only to source endpoint.
       "serviceUri": "A String", # Output only. The URI of the Cloud Run service that the revision belongs to. The format is: projects/{project}/locations/{location}/services/{service}. Mutually exclusive with worker_pool_uri.
       "uri": "A String", # A [Cloud Run](https://cloud.google.com/run) [revision](https://cloud.google.com/run/docs/reference/rest/v1/namespaces.revisions/get) URI. The format is: projects/{project}/locations/{location}/revisions/{revision}
-      "workerPoolUri": "A String", # Output only. The URI of the worker pool that the revision belongs to. The format is: projects/{project}/locations/{location}/workerPools/{workerPool}. Mutually exclusive with service_uri.
     },
     "cloudSqlInstance": "A String", # A [Cloud SQL](https://cloud.google.com/sql) instance URI.
     "datastreamPrivateConnection": "A String", # A [Datastream Private Connection](https://docs.cloud.google.com/datastream/docs/reference/rest/v1/projects.locations.privateConnections) name format: projects/{project}/locations/{location}/privateConnections/{privateConnection}.
@@ -980,7 +979,6 @@ 
Method Details

     "cloudRunRevision": { # Wrapper for Cloud Run revision attributes. # A [Cloud Run](https://cloud.google.com/run) [revision](https://cloud.google.com/run/docs/reference/rest/v1/namespaces.revisions/get) Applicable only to source endpoint.
       "serviceUri": "A String", # Output only. The URI of the Cloud Run service that the revision belongs to. The format is: projects/{project}/locations/{location}/services/{service}. Mutually exclusive with worker_pool_uri.
       "uri": "A String", # A [Cloud Run](https://cloud.google.com/run) [revision](https://cloud.google.com/run/docs/reference/rest/v1/namespaces.revisions/get) URI. The format is: projects/{project}/locations/{location}/revisions/{revision}
-      "workerPoolUri": "A String", # Output only. The URI of the worker pool that the revision belongs to. The format is: projects/{project}/locations/{location}/workerPools/{workerPool}. Mutually exclusive with service_uri.
     },
     "cloudSqlInstance": "A String", # A [Cloud SQL](https://cloud.google.com/sql) instance URI.
     "datastreamPrivateConnection": "A String", # A [Datastream Private Connection](https://docs.cloud.google.com/datastream/docs/reference/rest/v1/projects.locations.privateConnections) name format: projects/{project}/locations/{location}/privateConnections/{privateConnection}.
@@ -1098,7 +1096,6 @@ 
Method Details

     "cloudRunRevision": { # Wrapper for Cloud Run revision attributes. # A [Cloud Run](https://cloud.google.com/run) [revision](https://cloud.google.com/run/docs/reference/rest/v1/namespaces.revisions/get) Applicable only to source endpoint.
       "serviceUri": "A String", # Output only. The URI of the Cloud Run service that the revision belongs to. The format is: projects/{project}/locations/{location}/services/{service}. Mutually exclusive with worker_pool_uri.
       "uri": "A String", # A [Cloud Run](https://cloud.google.com/run) [revision](https://cloud.google.com/run/docs/reference/rest/v1/namespaces.revisions/get) URI. The format is: projects/{project}/locations/{location}/revisions/{revision}
-      "workerPoolUri": "A String", # Output only. The URI of the worker pool that the revision belongs to. The format is: projects/{project}/locations/{location}/workerPools/{workerPool}. Mutually exclusive with service_uri.
     },
     "cloudSqlInstance": "A String", # A [Cloud SQL](https://cloud.google.com/sql) instance URI.
     "datastreamPrivateConnection": "A String", # A [Datastream Private Connection](https://docs.cloud.google.com/datastream/docs/reference/rest/v1/projects.locations.privateConnections) name format: projects/{project}/locations/{location}/privateConnections/{privateConnection}.
@@ -1941,7 +1938,6 @@ 
Method Details

     "cloudRunRevision": { # Wrapper for Cloud Run revision attributes. # A [Cloud Run](https://cloud.google.com/run) [revision](https://cloud.google.com/run/docs/reference/rest/v1/namespaces.revisions/get) Applicable only to source endpoint.
       "serviceUri": "A String", # Output only. The URI of the Cloud Run service that the revision belongs to. The format is: projects/{project}/locations/{location}/services/{service}. Mutually exclusive with worker_pool_uri.
       "uri": "A String", # A [Cloud Run](https://cloud.google.com/run) [revision](https://cloud.google.com/run/docs/reference/rest/v1/namespaces.revisions/get) URI. The format is: projects/{project}/locations/{location}/revisions/{revision}
-      "workerPoolUri": "A String", # Output only. The URI of the worker pool that the revision belongs to. The format is: projects/{project}/locations/{location}/workerPools/{workerPool}. Mutually exclusive with service_uri.
     },
     "cloudSqlInstance": "A String", # A [Cloud SQL](https://cloud.google.com/sql) instance URI.
     "datastreamPrivateConnection": "A String", # A [Datastream Private Connection](https://docs.cloud.google.com/datastream/docs/reference/rest/v1/projects.locations.privateConnections) name format: projects/{project}/locations/{location}/privateConnections/{privateConnection}.
@@ -2050,7 +2046,6 @@ 
Method Details

         "cloudRunRevision": { # Wrapper for Cloud Run revision attributes. # A [Cloud Run](https://cloud.google.com/run) [revision](https://cloud.google.com/run/docs/reference/rest/v1/namespaces.revisions/get) Applicable only to source endpoint.
           "serviceUri": "A String", # Output only. The URI of the Cloud Run service that the revision belongs to. The format is: projects/{project}/locations/{location}/services/{service}. Mutually exclusive with worker_pool_uri.
           "uri": "A String", # A [Cloud Run](https://cloud.google.com/run) [revision](https://cloud.google.com/run/docs/reference/rest/v1/namespaces.revisions/get) URI. The format is: projects/{project}/locations/{location}/revisions/{revision}
-          "workerPoolUri": "A String", # Output only. The URI of the worker pool that the revision belongs to. The format is: projects/{project}/locations/{location}/workerPools/{workerPool}. Mutually exclusive with service_uri.
         },
         "cloudSqlInstance": "A String", # A [Cloud SQL](https://cloud.google.com/sql) instance URI.
         "datastreamPrivateConnection": "A String", # A [Datastream Private Connection](https://docs.cloud.google.com/datastream/docs/reference/rest/v1/projects.locations.privateConnections) name format: projects/{project}/locations/{location}/privateConnections/{privateConnection}.
@@ -2893,7 +2888,6 @@ 
Method Details

         "cloudRunRevision": { # Wrapper for Cloud Run revision attributes. # A [Cloud Run](https://cloud.google.com/run) [revision](https://cloud.google.com/run/docs/reference/rest/v1/namespaces.revisions/get) Applicable only to source endpoint.
           "serviceUri": "A String", # Output only. The URI of the Cloud Run service that the revision belongs to. The format is: projects/{project}/locations/{location}/services/{service}. Mutually exclusive with worker_pool_uri.
           "uri": "A String", # A [Cloud Run](https://cloud.google.com/run) [revision](https://cloud.google.com/run/docs/reference/rest/v1/namespaces.revisions/get) URI. The format is: projects/{project}/locations/{location}/revisions/{revision}
-          "workerPoolUri": "A String", # Output only. The URI of the worker pool that the revision belongs to. The format is: projects/{project}/locations/{location}/workerPools/{workerPool}. Mutually exclusive with service_uri.
         },
         "cloudSqlInstance": "A String", # A [Cloud SQL](https://cloud.google.com/sql) instance URI.
         "datastreamPrivateConnection": "A String", # A [Datastream Private Connection](https://docs.cloud.google.com/datastream/docs/reference/rest/v1/projects.locations.privateConnections) name format: projects/{project}/locations/{location}/privateConnections/{privateConnection}.
@@ -2961,7 +2955,6 @@ 
Method Details

     "cloudRunRevision": { # Wrapper for Cloud Run revision attributes. # A [Cloud Run](https://cloud.google.com/run) [revision](https://cloud.google.com/run/docs/reference/rest/v1/namespaces.revisions/get) Applicable only to source endpoint.
       "serviceUri": "A String", # Output only. The URI of the Cloud Run service that the revision belongs to. The format is: projects/{project}/locations/{location}/services/{service}. Mutually exclusive with worker_pool_uri.
       "uri": "A String", # A [Cloud Run](https://cloud.google.com/run) [revision](https://cloud.google.com/run/docs/reference/rest/v1/namespaces.revisions/get) URI. The format is: projects/{project}/locations/{location}/revisions/{revision}
-      "workerPoolUri": "A String", # Output only. The URI of the worker pool that the revision belongs to. The format is: projects/{project}/locations/{location}/workerPools/{workerPool}. Mutually exclusive with service_uri.
     },
     "cloudSqlInstance": "A String", # A [Cloud SQL](https://cloud.google.com/sql) instance URI.
     "datastreamPrivateConnection": "A String", # A [Datastream Private Connection](https://docs.cloud.google.com/datastream/docs/reference/rest/v1/projects.locations.privateConnections) name format: projects/{project}/locations/{location}/privateConnections/{privateConnection}.
@@ -3804,7 +3797,6 @@ 
Method Details

     "cloudRunRevision": { # Wrapper for Cloud Run revision attributes. # A [Cloud Run](https://cloud.google.com/run) [revision](https://cloud.google.com/run/docs/reference/rest/v1/namespaces.revisions/get) Applicable only to source endpoint.
       "serviceUri": "A String", # Output only. The URI of the Cloud Run service that the revision belongs to. The format is: projects/{project}/locations/{location}/services/{service}. Mutually exclusive with worker_pool_uri.
       "uri": "A String", # A [Cloud Run](https://cloud.google.com/run) [revision](https://cloud.google.com/run/docs/reference/rest/v1/namespaces.revisions/get) URI. The format is: projects/{project}/locations/{location}/revisions/{revision}
-      "workerPoolUri": "A String", # Output only. The URI of the worker pool that the revision belongs to. The format is: projects/{project}/locations/{location}/workerPools/{workerPool}. Mutually exclusive with service_uri.
     },
     "cloudSqlInstance": "A String", # A [Cloud SQL](https://cloud.google.com/sql) instance URI.
     "datastreamPrivateConnection": "A String", # A [Datastream Private Connection](https://docs.cloud.google.com/datastream/docs/reference/rest/v1/projects.locations.privateConnections) name format: projects/{project}/locations/{location}/privateConnections/{privateConnection}.
diff --git a/docs/dyn/policytroubleshooter_v3beta.iam.html b/docs/dyn/policytroubleshooter_v3beta.iam.html
index 7ee9966398..3658ec3ecd 100644
--- a/docs/dyn/policytroubleshooter_v3beta.iam.html
+++ b/docs/dyn/policytroubleshooter_v3beta.iam.html
@@ -511,7 +511,7 @@ 
Method Details

             "annotations": { # Optional. User-defined annotations. See https://google.aip.dev/148#annotations for more details such as format and size limitations
               "a_key": "A String",
             },
-            "condition": { # Represents a textual expression in the Common Expression Language (CEL) syntax. CEL is a C-like expression language. The syntax and semantics of CEL are documented at https://github.com/google/cel-spec. Example (Comparison): title: "Summary size limit" description: "Determines if a summary is less than 100 chars" expression: "document.summary.size() < 100" Example (Equality): title: "Requestor is owner" description: "Determines if requestor is the document owner" expression: "document.owner == request.auth.claims.email" Example (Logic): title: "Public documents" description: "Determine whether the document should be publicly visible" expression: "document.type != 'private' && document.type != 'internal'" Example (Data Manipulation): title: "Notification string" description: "Create a notification string with a timestamp." expression: "'New message received at ' + string(document.create_time)" The exact variables and functions that may be referenced within an expression are determined by the service that evaluates it. See the service documentation for additional information. # Optional. The condition to apply to the policy binding. When set, the `expression` field in the `Expr` must include from 1 to 10 subexpressions, joined by the "||"(Logical OR), "&&"(Logical AND) or "!"(Logical NOT) operators and cannot contain more than 250 characters. The condition is currently only supported when bound to policies of kind principal access boundary. When the bound policy is a principal access boundary policy, the only supported attributes in any subexpression are `principal.type` and `principal.subject`. An example expression is: "principal.type == 'iam.googleapis.com/ServiceAccount'" or "principal.subject == 'bob@example.com'". Allowed operations for `principal.subject`: - `principal.subject == ` - `principal.subject != ` - `principal.subject in []` - `principal.subject.startsWith()` - `principal.subject.endsWith()` Allowed operations for `principal.type`: - `principal.type == ` - `principal.type != ` - `principal.type in []` Supported principal types are workspace, workforce pool, workload pool, service account, and agent identity. Allowed string must be one of: - `iam.googleapis.com/WorkspaceIdentity` - `iam.googleapis.com/WorkforcePoolIdentity` - `iam.googleapis.com/WorkloadPoolIdentity` - `iam.googleapis.com/ServiceAccount` - `iam.googleapis.com/AgentPoolIdentity` (available in Preview)
+            "condition": { # Represents a textual expression in the Common Expression Language (CEL) syntax. CEL is a C-like expression language. The syntax and semantics of CEL are documented at https://github.com/google/cel-spec. Example (Comparison): title: "Summary size limit" description: "Determines if a summary is less than 100 chars" expression: "document.summary.size() < 100" Example (Equality): title: "Requestor is owner" description: "Determines if requestor is the document owner" expression: "document.owner == request.auth.claims.email" Example (Logic): title: "Public documents" description: "Determine whether the document should be publicly visible" expression: "document.type != 'private' && document.type != 'internal'" Example (Data Manipulation): title: "Notification string" description: "Create a notification string with a timestamp." expression: "'New message received at ' + string(document.create_time)" The exact variables and functions that may be referenced within an expression are determined by the service that evaluates it. See the service documentation for additional information. # Optional. The condition to apply to the policy binding. When set, the `expression` field in the `Expr` must include from 1 to 10 subexpressions, joined by the "||"(Logical OR), "&&"(Logical AND) or "!"(Logical NOT) operators and cannot contain more than 250 characters. The condition is currently only supported when bound to policies of kind principal access boundary. When the bound policy is a principal access boundary policy, the only supported attributes in any subexpression are `principal.type` and `principal.subject`. An example expression is: "principal.type == 'iam.googleapis.com/ServiceAccount'" or "principal.subject == 'bob@example.com'". Allowed operations for `principal.subject`: - `principal.subject == ` - `principal.subject != ` - `principal.subject in []` - `principal.subject.startsWith()` - `principal.subject.endsWith()` Allowed operations for `principal.type`: - `principal.type == ` - `principal.type != ` - `principal.type in []` Supported principal types are workspace, workforce pool, workload pool, service account, and agent identity. Allowed string must be one of: - `iam.googleapis.com/WorkspaceIdentity` - `iam.googleapis.com/WorkforcePoolIdentity` - `iam.googleapis.com/WorkloadPoolIdentity` - `iam.googleapis.com/ServiceAccount` - `iam.googleapis.com/AgentPoolIdentity`
               "description": "A String", # Optional. Description of the expression. This is a longer text which describes the expression, e.g. when hovered over it in a UI.
               "expression": "A String", # Textual representation of an expression in Common Expression Language syntax.
               "location": "A String", # Optional. String indicating the location of the expression for error reporting, e.g. a file name and a position in the file.
@@ -912,7 +912,7 @@ 
Method Details

             "annotations": { # Optional. User-defined annotations. See https://google.aip.dev/148#annotations for more details such as format and size limitations
               "a_key": "A String",
             },
-            "condition": { # Represents a textual expression in the Common Expression Language (CEL) syntax. CEL is a C-like expression language. The syntax and semantics of CEL are documented at https://github.com/google/cel-spec. Example (Comparison): title: "Summary size limit" description: "Determines if a summary is less than 100 chars" expression: "document.summary.size() < 100" Example (Equality): title: "Requestor is owner" description: "Determines if requestor is the document owner" expression: "document.owner == request.auth.claims.email" Example (Logic): title: "Public documents" description: "Determine whether the document should be publicly visible" expression: "document.type != 'private' && document.type != 'internal'" Example (Data Manipulation): title: "Notification string" description: "Create a notification string with a timestamp." expression: "'New message received at ' + string(document.create_time)" The exact variables and functions that may be referenced within an expression are determined by the service that evaluates it. See the service documentation for additional information. # Optional. The condition to apply to the policy binding. When set, the `expression` field in the `Expr` must include from 1 to 10 subexpressions, joined by the "||"(Logical OR), "&&"(Logical AND) or "!"(Logical NOT) operators and cannot contain more than 250 characters. The condition is currently only supported when bound to policies of kind principal access boundary. When the bound policy is a principal access boundary policy, the only supported attributes in any subexpression are `principal.type` and `principal.subject`. An example expression is: "principal.type == 'iam.googleapis.com/ServiceAccount'" or "principal.subject == 'bob@example.com'". Allowed operations for `principal.subject`: - `principal.subject == ` - `principal.subject != ` - `principal.subject in []` - `principal.subject.startsWith()` - `principal.subject.endsWith()` Allowed operations for `principal.type`: - `principal.type == ` - `principal.type != ` - `principal.type in []` Supported principal types are workspace, workforce pool, workload pool, service account, and agent identity. Allowed string must be one of: - `iam.googleapis.com/WorkspaceIdentity` - `iam.googleapis.com/WorkforcePoolIdentity` - `iam.googleapis.com/WorkloadPoolIdentity` - `iam.googleapis.com/ServiceAccount` - `iam.googleapis.com/AgentPoolIdentity` (available in Preview)
+            "condition": { # Represents a textual expression in the Common Expression Language (CEL) syntax. CEL is a C-like expression language. The syntax and semantics of CEL are documented at https://github.com/google/cel-spec. Example (Comparison): title: "Summary size limit" description: "Determines if a summary is less than 100 chars" expression: "document.summary.size() < 100" Example (Equality): title: "Requestor is owner" description: "Determines if requestor is the document owner" expression: "document.owner == request.auth.claims.email" Example (Logic): title: "Public documents" description: "Determine whether the document should be publicly visible" expression: "document.type != 'private' && document.type != 'internal'" Example (Data Manipulation): title: "Notification string" description: "Create a notification string with a timestamp." expression: "'New message received at ' + string(document.create_time)" The exact variables and functions that may be referenced within an expression are determined by the service that evaluates it. See the service documentation for additional information. # Optional. The condition to apply to the policy binding. When set, the `expression` field in the `Expr` must include from 1 to 10 subexpressions, joined by the "||"(Logical OR), "&&"(Logical AND) or "!"(Logical NOT) operators and cannot contain more than 250 characters. The condition is currently only supported when bound to policies of kind principal access boundary. When the bound policy is a principal access boundary policy, the only supported attributes in any subexpression are `principal.type` and `principal.subject`. An example expression is: "principal.type == 'iam.googleapis.com/ServiceAccount'" or "principal.subject == 'bob@example.com'". Allowed operations for `principal.subject`: - `principal.subject == ` - `principal.subject != ` - `principal.subject in []` - `principal.subject.startsWith()` - `principal.subject.endsWith()` Allowed operations for `principal.type`: - `principal.type == ` - `principal.type != ` - `principal.type in []` Supported principal types are workspace, workforce pool, workload pool, service account, and agent identity. Allowed string must be one of: - `iam.googleapis.com/WorkspaceIdentity` - `iam.googleapis.com/WorkforcePoolIdentity` - `iam.googleapis.com/WorkloadPoolIdentity` - `iam.googleapis.com/ServiceAccount` - `iam.googleapis.com/AgentPoolIdentity`
               "description": "A String", # Optional. Description of the expression. This is a longer text which describes the expression, e.g. when hovered over it in a UI.
               "expression": "A String", # Textual representation of an expression in Common Expression Language syntax.
               "location": "A String", # Optional. String indicating the location of the expression for error reporting, e.g. a file name and a position in the file.
diff --git a/docs/dyn/pubsub_v1.projects.subscriptions.html b/docs/dyn/pubsub_v1.projects.subscriptions.html
index 4aea87b2b2..f8076ded49 100644
--- a/docs/dyn/pubsub_v1.projects.subscriptions.html
+++ b/docs/dyn/pubsub_v1.projects.subscriptions.html
@@ -184,7 +184,7 @@ 
Method Details

     "columnFamilyMapping": { # Configuration for writing a Pub/Sub message to a Bigtable row with a user-defined key and writing to column families. If this field is set: - The subscription messages must be formatted as JSON. - The row key mapping is configured in the `key_definition` section. - The top-level fields will be written either: - By default, they will be written to the `data` column family with the field name as the column qualifier. - But if the field name matches an existing column family (except for the default `data` column), then that field will be written to that column family, either as a scalar or its next level nested fields if it's a JSON object. - The cell timestamp will be the message publish timestamp. If the field is not set, the default behavior is to write: - row key: subscription name, message ID hash, and message ID delimited by `#`. - columns: message bytes written to a single column family `data` with an empty-string column qualifier. - cell timestamp: the message publish timestamp. # Optional. Configuration that allows writing row keys and/or columns based on fields in the input message. The input message format must be JSON if this field is set.
       "delimitedKey": { # Row key definition based on fields from the message. # Optional. If set, the row key is constructed from the given key fields and delimiter. All key fields must be present in the message; otherwise, the message remains in the subscription backlog.
         "delimiter": "A String", # Optional. Byte sequence used to delimit concatenated fields. Must be specified if multiple key fields are used. The delimiter must contain at least 1 character and at most 50 characters.
-        "keyFields": [ # Optional. The key fields to construct from the row key. The fields must be present in the message as a top-level field, i.e. JSON path expressions will not traverse into nested objects.
+        "keyFields": [ # Required. The key fields to construct from the row key. The fields must be present in the message as a top-level field, i.e. JSON path expressions will not traverse into nested objects.
           "A String",
         ],
       },
@@ -308,7 +308,7 @@ 
Method Details

     "columnFamilyMapping": { # Configuration for writing a Pub/Sub message to a Bigtable row with a user-defined key and writing to column families. If this field is set: - The subscription messages must be formatted as JSON. - The row key mapping is configured in the `key_definition` section. - The top-level fields will be written either: - By default, they will be written to the `data` column family with the field name as the column qualifier. - But if the field name matches an existing column family (except for the default `data` column), then that field will be written to that column family, either as a scalar or its next level nested fields if it's a JSON object. - The cell timestamp will be the message publish timestamp. If the field is not set, the default behavior is to write: - row key: subscription name, message ID hash, and message ID delimited by `#`. - columns: message bytes written to a single column family `data` with an empty-string column qualifier. - cell timestamp: the message publish timestamp. # Optional. Configuration that allows writing row keys and/or columns based on fields in the input message. The input message format must be JSON if this field is set.
       "delimitedKey": { # Row key definition based on fields from the message. # Optional. If set, the row key is constructed from the given key fields and delimiter. All key fields must be present in the message; otherwise, the message remains in the subscription backlog.
         "delimiter": "A String", # Optional. Byte sequence used to delimit concatenated fields. Must be specified if multiple key fields are used. The delimiter must contain at least 1 character and at most 50 characters.
-        "keyFields": [ # Optional. The key fields to construct from the row key. The fields must be present in the message as a top-level field, i.e. JSON path expressions will not traverse into nested objects.
+        "keyFields": [ # Required. The key fields to construct from the row key. The fields must be present in the message as a top-level field, i.e. JSON path expressions will not traverse into nested objects.
           "A String",
         ],
       },
@@ -475,7 +475,7 @@ 
Method Details

     "columnFamilyMapping": { # Configuration for writing a Pub/Sub message to a Bigtable row with a user-defined key and writing to column families. If this field is set: - The subscription messages must be formatted as JSON. - The row key mapping is configured in the `key_definition` section. - The top-level fields will be written either: - By default, they will be written to the `data` column family with the field name as the column qualifier. - But if the field name matches an existing column family (except for the default `data` column), then that field will be written to that column family, either as a scalar or its next level nested fields if it's a JSON object. - The cell timestamp will be the message publish timestamp. If the field is not set, the default behavior is to write: - row key: subscription name, message ID hash, and message ID delimited by `#`. - columns: message bytes written to a single column family `data` with an empty-string column qualifier. - cell timestamp: the message publish timestamp. # Optional. Configuration that allows writing row keys and/or columns based on fields in the input message. The input message format must be JSON if this field is set.
       "delimitedKey": { # Row key definition based on fields from the message. # Optional. If set, the row key is constructed from the given key fields and delimiter. All key fields must be present in the message; otherwise, the message remains in the subscription backlog.
         "delimiter": "A String", # Optional. Byte sequence used to delimit concatenated fields. Must be specified if multiple key fields are used. The delimiter must contain at least 1 character and at most 50 characters.
-        "keyFields": [ # Optional. The key fields to construct from the row key. The fields must be present in the message as a top-level field, i.e. JSON path expressions will not traverse into nested objects.
+        "keyFields": [ # Required. The key fields to construct from the row key. The fields must be present in the message as a top-level field, i.e. JSON path expressions will not traverse into nested objects.
           "A String",
         ],
       },
@@ -646,7 +646,7 @@ 
Method Details

         "columnFamilyMapping": { # Configuration for writing a Pub/Sub message to a Bigtable row with a user-defined key and writing to column families. If this field is set: - The subscription messages must be formatted as JSON. - The row key mapping is configured in the `key_definition` section. - The top-level fields will be written either: - By default, they will be written to the `data` column family with the field name as the column qualifier. - But if the field name matches an existing column family (except for the default `data` column), then that field will be written to that column family, either as a scalar or its next level nested fields if it's a JSON object. - The cell timestamp will be the message publish timestamp. If the field is not set, the default behavior is to write: - row key: subscription name, message ID hash, and message ID delimited by `#`. - columns: message bytes written to a single column family `data` with an empty-string column qualifier. - cell timestamp: the message publish timestamp. # Optional. Configuration that allows writing row keys and/or columns based on fields in the input message. The input message format must be JSON if this field is set.
           "delimitedKey": { # Row key definition based on fields from the message. # Optional. If set, the row key is constructed from the given key fields and delimiter. All key fields must be present in the message; otherwise, the message remains in the subscription backlog.
             "delimiter": "A String", # Optional. Byte sequence used to delimit concatenated fields. Must be specified if multiple key fields are used. The delimiter must contain at least 1 character and at most 50 characters.
-            "keyFields": [ # Optional. The key fields to construct from the row key. The fields must be present in the message as a top-level field, i.e. JSON path expressions will not traverse into nested objects.
+            "keyFields": [ # Required. The key fields to construct from the row key. The fields must be present in the message as a top-level field, i.e. JSON path expressions will not traverse into nested objects.
               "A String",
             ],
           },
@@ -856,7 +856,7 @@ 
Method Details

       "columnFamilyMapping": { # Configuration for writing a Pub/Sub message to a Bigtable row with a user-defined key and writing to column families. If this field is set: - The subscription messages must be formatted as JSON. - The row key mapping is configured in the `key_definition` section. - The top-level fields will be written either: - By default, they will be written to the `data` column family with the field name as the column qualifier. - But if the field name matches an existing column family (except for the default `data` column), then that field will be written to that column family, either as a scalar or its next level nested fields if it's a JSON object. - The cell timestamp will be the message publish timestamp. If the field is not set, the default behavior is to write: - row key: subscription name, message ID hash, and message ID delimited by `#`. - columns: message bytes written to a single column family `data` with an empty-string column qualifier. - cell timestamp: the message publish timestamp. # Optional. Configuration that allows writing row keys and/or columns based on fields in the input message. The input message format must be JSON if this field is set.
         "delimitedKey": { # Row key definition based on fields from the message. # Optional. If set, the row key is constructed from the given key fields and delimiter. All key fields must be present in the message; otherwise, the message remains in the subscription backlog.
           "delimiter": "A String", # Optional. Byte sequence used to delimit concatenated fields. Must be specified if multiple key fields are used. The delimiter must contain at least 1 character and at most 50 characters.
-          "keyFields": [ # Optional. The key fields to construct from the row key. The fields must be present in the message as a top-level field, i.e. JSON path expressions will not traverse into nested objects.
+          "keyFields": [ # Required. The key fields to construct from the row key. The fields must be present in the message as a top-level field, i.e. JSON path expressions will not traverse into nested objects.
             "A String",
           ],
         },
@@ -982,7 +982,7 @@ 
Method Details

     "columnFamilyMapping": { # Configuration for writing a Pub/Sub message to a Bigtable row with a user-defined key and writing to column families. If this field is set: - The subscription messages must be formatted as JSON. - The row key mapping is configured in the `key_definition` section. - The top-level fields will be written either: - By default, they will be written to the `data` column family with the field name as the column qualifier. - But if the field name matches an existing column family (except for the default `data` column), then that field will be written to that column family, either as a scalar or its next level nested fields if it's a JSON object. - The cell timestamp will be the message publish timestamp. If the field is not set, the default behavior is to write: - row key: subscription name, message ID hash, and message ID delimited by `#`. - columns: message bytes written to a single column family `data` with an empty-string column qualifier. - cell timestamp: the message publish timestamp. # Optional. Configuration that allows writing row keys and/or columns based on fields in the input message. The input message format must be JSON if this field is set.
       "delimitedKey": { # Row key definition based on fields from the message. # Optional. If set, the row key is constructed from the given key fields and delimiter. All key fields must be present in the message; otherwise, the message remains in the subscription backlog.
         "delimiter": "A String", # Optional. Byte sequence used to delimit concatenated fields. Must be specified if multiple key fields are used. The delimiter must contain at least 1 character and at most 50 characters.
-        "keyFields": [ # Optional. The key fields to construct from the row key. The fields must be present in the message as a top-level field, i.e. JSON path expressions will not traverse into nested objects.
+        "keyFields": [ # Required. The key fields to construct from the row key. The fields must be present in the message as a top-level field, i.e. JSON path expressions will not traverse into nested objects.
           "A String",
         ],
       },
diff --git a/docs/dyn/retail_v2.projects.locations.catalogs.branches.products.html b/docs/dyn/retail_v2.projects.locations.catalogs.branches.products.html
index 1b0f6af62e..4b59afabcd 100644
--- a/docs/dyn/retail_v2.projects.locations.catalogs.branches.products.html
+++ b/docs/dyn/retail_v2.projects.locations.catalogs.branches.products.html
@@ -309,7 +309,7 @@ 
Method Details

     "A String",
   ],
   "description": "A String", # Product description. This field must be a UTF-8 encoded string with a length limit of 5,000 characters. Otherwise, an INVALID_ARGUMENT error is returned. Corresponding properties: Google Merchant Center property [description](https://support.google.com/merchants/answer/6324468). Schema.org property [Product.description](https://schema.org/description).
-  "expireTime": "A String", # Note that this field is applied in the following ways: * If the Product is already expired when it is uploaded, this product is not indexed for search. * If the Product is not expired when it is uploaded, only the Type.PRIMARY's and Type.COLLECTION's expireTime is respected, and Type.VARIANT's expireTime is not used. In general, we suggest the users to delete the stale products explicitly, instead of using this field to determine staleness. expire_time must be later than available_time and publish_time, otherwise an INVALID_ARGUMENT error is thrown. Corresponding properties: Google Merchant Center property [expiration_date](https://support.google.com/merchants/answer/6324499).
+  "expireTime": "A String", # The timestamp when this product becomes unavailable for SearchService.Search. If it is set, the Product is not available for SearchService.Search after expire_time. However, the product can still be retrieved by ProductService.GetProduct and ProductService.ListProducts. Note that this field is applied in the following ways: * If the Product is already expired when it is uploaded, this product is not indexed for search. * If the Product is not expired when it is uploaded, only the Type.PRIMARY's and Type.COLLECTION's expireTime is respected, and Type.VARIANT's expireTime is not used. In general, we suggest the users to delete the stale products explicitly, instead of using this field to determine staleness. expire_time must be later than available_time and publish_time, otherwise an INVALID_ARGUMENT error is thrown. Corresponding properties: Google Merchant Center property [expiration_date](https://support.google.com/merchants/answer/6324499).
   "fulfillmentInfo": [ # Fulfillment information, such as the store IDs for in-store pickup or region IDs for different shipping methods. All the elements must have distinct FulfillmentInfo.type. Otherwise, an INVALID_ARGUMENT error is returned.
     { # Fulfillment information, such as the store IDs for in-store pickup or region IDs for different shipping methods.
       "placeIds": [ # The IDs for this type, such as the store IDs for FulfillmentInfo.type.pickup-in-store or the region IDs for FulfillmentInfo.type.same-day-delivery. A maximum of 3000 values are allowed. Each value must be a string with a length limit of 30 characters, matching the pattern `[a-zA-Z0-9_-]+`, such as "store1" or "REGION-2". Otherwise, an INVALID_ARGUMENT error is returned.
@@ -483,7 +483,7 @@ 
Method Details

     "A String",
   ],
   "description": "A String", # Product description. This field must be a UTF-8 encoded string with a length limit of 5,000 characters. Otherwise, an INVALID_ARGUMENT error is returned. Corresponding properties: Google Merchant Center property [description](https://support.google.com/merchants/answer/6324468). Schema.org property [Product.description](https://schema.org/description).
-  "expireTime": "A String", # Note that this field is applied in the following ways: * If the Product is already expired when it is uploaded, this product is not indexed for search. * If the Product is not expired when it is uploaded, only the Type.PRIMARY's and Type.COLLECTION's expireTime is respected, and Type.VARIANT's expireTime is not used. In general, we suggest the users to delete the stale products explicitly, instead of using this field to determine staleness. expire_time must be later than available_time and publish_time, otherwise an INVALID_ARGUMENT error is thrown. Corresponding properties: Google Merchant Center property [expiration_date](https://support.google.com/merchants/answer/6324499).
+  "expireTime": "A String", # The timestamp when this product becomes unavailable for SearchService.Search. If it is set, the Product is not available for SearchService.Search after expire_time. However, the product can still be retrieved by ProductService.GetProduct and ProductService.ListProducts. Note that this field is applied in the following ways: * If the Product is already expired when it is uploaded, this product is not indexed for search. * If the Product is not expired when it is uploaded, only the Type.PRIMARY's and Type.COLLECTION's expireTime is respected, and Type.VARIANT's expireTime is not used. In general, we suggest the users to delete the stale products explicitly, instead of using this field to determine staleness. expire_time must be later than available_time and publish_time, otherwise an INVALID_ARGUMENT error is thrown. Corresponding properties: Google Merchant Center property [expiration_date](https://support.google.com/merchants/answer/6324499).
   "fulfillmentInfo": [ # Fulfillment information, such as the store IDs for in-store pickup or region IDs for different shipping methods. All the elements must have distinct FulfillmentInfo.type. Otherwise, an INVALID_ARGUMENT error is returned.
     { # Fulfillment information, such as the store IDs for in-store pickup or region IDs for different shipping methods.
       "placeIds": [ # The IDs for this type, such as the store IDs for FulfillmentInfo.type.pickup-in-store or the region IDs for FulfillmentInfo.type.same-day-delivery. A maximum of 3000 values are allowed. Each value must be a string with a length limit of 30 characters, matching the pattern `[a-zA-Z0-9_-]+`, such as "store1" or "REGION-2". Otherwise, an INVALID_ARGUMENT error is returned.
@@ -681,7 +681,7 @@ 
Method Details

     "A String",
   ],
   "description": "A String", # Product description. This field must be a UTF-8 encoded string with a length limit of 5,000 characters. Otherwise, an INVALID_ARGUMENT error is returned. Corresponding properties: Google Merchant Center property [description](https://support.google.com/merchants/answer/6324468). Schema.org property [Product.description](https://schema.org/description).
-  "expireTime": "A String", # Note that this field is applied in the following ways: * If the Product is already expired when it is uploaded, this product is not indexed for search. * If the Product is not expired when it is uploaded, only the Type.PRIMARY's and Type.COLLECTION's expireTime is respected, and Type.VARIANT's expireTime is not used. In general, we suggest the users to delete the stale products explicitly, instead of using this field to determine staleness. expire_time must be later than available_time and publish_time, otherwise an INVALID_ARGUMENT error is thrown. Corresponding properties: Google Merchant Center property [expiration_date](https://support.google.com/merchants/answer/6324499).
+  "expireTime": "A String", # The timestamp when this product becomes unavailable for SearchService.Search. If it is set, the Product is not available for SearchService.Search after expire_time. However, the product can still be retrieved by ProductService.GetProduct and ProductService.ListProducts. Note that this field is applied in the following ways: * If the Product is already expired when it is uploaded, this product is not indexed for search. * If the Product is not expired when it is uploaded, only the Type.PRIMARY's and Type.COLLECTION's expireTime is respected, and Type.VARIANT's expireTime is not used. In general, we suggest the users to delete the stale products explicitly, instead of using this field to determine staleness. expire_time must be later than available_time and publish_time, otherwise an INVALID_ARGUMENT error is thrown. Corresponding properties: Google Merchant Center property [expiration_date](https://support.google.com/merchants/answer/6324499).
   "fulfillmentInfo": [ # Fulfillment information, such as the store IDs for in-store pickup or region IDs for different shipping methods. All the elements must have distinct FulfillmentInfo.type. Otherwise, an INVALID_ARGUMENT error is returned.
     { # Fulfillment information, such as the store IDs for in-store pickup or region IDs for different shipping methods.
       "placeIds": [ # The IDs for this type, such as the store IDs for FulfillmentInfo.type.pickup-in-store or the region IDs for FulfillmentInfo.type.same-day-delivery. A maximum of 3000 values are allowed. Each value must be a string with a length limit of 30 characters, matching the pattern `[a-zA-Z0-9_-]+`, such as "store1" or "REGION-2". Otherwise, an INVALID_ARGUMENT error is returned.
@@ -881,7 +881,7 @@ 
Method Details

             "A String",
           ],
           "description": "A String", # Product description. This field must be a UTF-8 encoded string with a length limit of 5,000 characters. Otherwise, an INVALID_ARGUMENT error is returned. Corresponding properties: Google Merchant Center property [description](https://support.google.com/merchants/answer/6324468). Schema.org property [Product.description](https://schema.org/description).
-          "expireTime": "A String", # Note that this field is applied in the following ways: * If the Product is already expired when it is uploaded, this product is not indexed for search. * If the Product is not expired when it is uploaded, only the Type.PRIMARY's and Type.COLLECTION's expireTime is respected, and Type.VARIANT's expireTime is not used. In general, we suggest the users to delete the stale products explicitly, instead of using this field to determine staleness. expire_time must be later than available_time and publish_time, otherwise an INVALID_ARGUMENT error is thrown. Corresponding properties: Google Merchant Center property [expiration_date](https://support.google.com/merchants/answer/6324499).
+          "expireTime": "A String", # The timestamp when this product becomes unavailable for SearchService.Search. If it is set, the Product is not available for SearchService.Search after expire_time. However, the product can still be retrieved by ProductService.GetProduct and ProductService.ListProducts. Note that this field is applied in the following ways: * If the Product is already expired when it is uploaded, this product is not indexed for search. * If the Product is not expired when it is uploaded, only the Type.PRIMARY's and Type.COLLECTION's expireTime is respected, and Type.VARIANT's expireTime is not used. In general, we suggest the users to delete the stale products explicitly, instead of using this field to determine staleness. expire_time must be later than available_time and publish_time, otherwise an INVALID_ARGUMENT error is thrown. Corresponding properties: Google Merchant Center property [expiration_date](https://support.google.com/merchants/answer/6324499).
           "fulfillmentInfo": [ # Fulfillment information, such as the store IDs for in-store pickup or region IDs for different shipping methods. All the elements must have distinct FulfillmentInfo.type. Otherwise, an INVALID_ARGUMENT error is returned.
             { # Fulfillment information, such as the store IDs for in-store pickup or region IDs for different shipping methods.
               "placeIds": [ # The IDs for this type, such as the store IDs for FulfillmentInfo.type.pickup-in-store or the region IDs for FulfillmentInfo.type.same-day-delivery. A maximum of 3000 values are allowed. Each value must be a string with a length limit of 30 characters, matching the pattern `[a-zA-Z0-9_-]+`, such as "store1" or "REGION-2". Otherwise, an INVALID_ARGUMENT error is returned.
@@ -1104,7 +1104,7 @@ 
Method Details

         "A String",
       ],
       "description": "A String", # Product description. This field must be a UTF-8 encoded string with a length limit of 5,000 characters. Otherwise, an INVALID_ARGUMENT error is returned. Corresponding properties: Google Merchant Center property [description](https://support.google.com/merchants/answer/6324468). Schema.org property [Product.description](https://schema.org/description).
-      "expireTime": "A String", # Note that this field is applied in the following ways: * If the Product is already expired when it is uploaded, this product is not indexed for search. * If the Product is not expired when it is uploaded, only the Type.PRIMARY's and Type.COLLECTION's expireTime is respected, and Type.VARIANT's expireTime is not used. In general, we suggest the users to delete the stale products explicitly, instead of using this field to determine staleness. expire_time must be later than available_time and publish_time, otherwise an INVALID_ARGUMENT error is thrown. Corresponding properties: Google Merchant Center property [expiration_date](https://support.google.com/merchants/answer/6324499).
+      "expireTime": "A String", # The timestamp when this product becomes unavailable for SearchService.Search. If it is set, the Product is not available for SearchService.Search after expire_time. However, the product can still be retrieved by ProductService.GetProduct and ProductService.ListProducts. Note that this field is applied in the following ways: * If the Product is already expired when it is uploaded, this product is not indexed for search. * If the Product is not expired when it is uploaded, only the Type.PRIMARY's and Type.COLLECTION's expireTime is respected, and Type.VARIANT's expireTime is not used. In general, we suggest the users to delete the stale products explicitly, instead of using this field to determine staleness. expire_time must be later than available_time and publish_time, otherwise an INVALID_ARGUMENT error is thrown. Corresponding properties: Google Merchant Center property [expiration_date](https://support.google.com/merchants/answer/6324499).
       "fulfillmentInfo": [ # Fulfillment information, such as the store IDs for in-store pickup or region IDs for different shipping methods. All the elements must have distinct FulfillmentInfo.type. Otherwise, an INVALID_ARGUMENT error is returned.
         { # Fulfillment information, such as the store IDs for in-store pickup or region IDs for different shipping methods.
           "placeIds": [ # The IDs for this type, such as the store IDs for FulfillmentInfo.type.pickup-in-store or the region IDs for FulfillmentInfo.type.same-day-delivery. A maximum of 3000 values are allowed. Each value must be a string with a length limit of 30 characters, matching the pattern `[a-zA-Z0-9_-]+`, such as "store1" or "REGION-2". Otherwise, an INVALID_ARGUMENT error is returned.
@@ -1295,7 +1295,7 @@ 
Method Details

     "A String",
   ],
   "description": "A String", # Product description. This field must be a UTF-8 encoded string with a length limit of 5,000 characters. Otherwise, an INVALID_ARGUMENT error is returned. Corresponding properties: Google Merchant Center property [description](https://support.google.com/merchants/answer/6324468). Schema.org property [Product.description](https://schema.org/description).
-  "expireTime": "A String", # Note that this field is applied in the following ways: * If the Product is already expired when it is uploaded, this product is not indexed for search. * If the Product is not expired when it is uploaded, only the Type.PRIMARY's and Type.COLLECTION's expireTime is respected, and Type.VARIANT's expireTime is not used. In general, we suggest the users to delete the stale products explicitly, instead of using this field to determine staleness. expire_time must be later than available_time and publish_time, otherwise an INVALID_ARGUMENT error is thrown. Corresponding properties: Google Merchant Center property [expiration_date](https://support.google.com/merchants/answer/6324499).
+  "expireTime": "A String", # The timestamp when this product becomes unavailable for SearchService.Search. If it is set, the Product is not available for SearchService.Search after expire_time. However, the product can still be retrieved by ProductService.GetProduct and ProductService.ListProducts. Note that this field is applied in the following ways: * If the Product is already expired when it is uploaded, this product is not indexed for search. * If the Product is not expired when it is uploaded, only the Type.PRIMARY's and Type.COLLECTION's expireTime is respected, and Type.VARIANT's expireTime is not used. In general, we suggest the users to delete the stale products explicitly, instead of using this field to determine staleness. expire_time must be later than available_time and publish_time, otherwise an INVALID_ARGUMENT error is thrown. Corresponding properties: Google Merchant Center property [expiration_date](https://support.google.com/merchants/answer/6324499).
   "fulfillmentInfo": [ # Fulfillment information, such as the store IDs for in-store pickup or region IDs for different shipping methods. All the elements must have distinct FulfillmentInfo.type. Otherwise, an INVALID_ARGUMENT error is returned.
     { # Fulfillment information, such as the store IDs for in-store pickup or region IDs for different shipping methods.
       "placeIds": [ # The IDs for this type, such as the store IDs for FulfillmentInfo.type.pickup-in-store or the region IDs for FulfillmentInfo.type.same-day-delivery. A maximum of 3000 values are allowed. Each value must be a string with a length limit of 30 characters, matching the pattern `[a-zA-Z0-9_-]+`, such as "store1" or "REGION-2". Otherwise, an INVALID_ARGUMENT error is returned.
@@ -1470,7 +1470,7 @@ 
Method Details

     "A String",
   ],
   "description": "A String", # Product description. This field must be a UTF-8 encoded string with a length limit of 5,000 characters. Otherwise, an INVALID_ARGUMENT error is returned. Corresponding properties: Google Merchant Center property [description](https://support.google.com/merchants/answer/6324468). Schema.org property [Product.description](https://schema.org/description).
-  "expireTime": "A String", # Note that this field is applied in the following ways: * If the Product is already expired when it is uploaded, this product is not indexed for search. * If the Product is not expired when it is uploaded, only the Type.PRIMARY's and Type.COLLECTION's expireTime is respected, and Type.VARIANT's expireTime is not used. In general, we suggest the users to delete the stale products explicitly, instead of using this field to determine staleness. expire_time must be later than available_time and publish_time, otherwise an INVALID_ARGUMENT error is thrown. Corresponding properties: Google Merchant Center property [expiration_date](https://support.google.com/merchants/answer/6324499).
+  "expireTime": "A String", # The timestamp when this product becomes unavailable for SearchService.Search. If it is set, the Product is not available for SearchService.Search after expire_time. However, the product can still be retrieved by ProductService.GetProduct and ProductService.ListProducts. Note that this field is applied in the following ways: * If the Product is already expired when it is uploaded, this product is not indexed for search. * If the Product is not expired when it is uploaded, only the Type.PRIMARY's and Type.COLLECTION's expireTime is respected, and Type.VARIANT's expireTime is not used. In general, we suggest the users to delete the stale products explicitly, instead of using this field to determine staleness. expire_time must be later than available_time and publish_time, otherwise an INVALID_ARGUMENT error is thrown. Corresponding properties: Google Merchant Center property [expiration_date](https://support.google.com/merchants/answer/6324499).
   "fulfillmentInfo": [ # Fulfillment information, such as the store IDs for in-store pickup or region IDs for different shipping methods. All the elements must have distinct FulfillmentInfo.type. Otherwise, an INVALID_ARGUMENT error is returned.
     { # Fulfillment information, such as the store IDs for in-store pickup or region IDs for different shipping methods.
       "placeIds": [ # The IDs for this type, such as the store IDs for FulfillmentInfo.type.pickup-in-store or the region IDs for FulfillmentInfo.type.same-day-delivery. A maximum of 3000 values are allowed. Each value must be a string with a length limit of 30 characters, matching the pattern `[a-zA-Z0-9_-]+`, such as "store1" or "REGION-2". Otherwise, an INVALID_ARGUMENT error is returned.
@@ -1783,7 +1783,7 @@ 
Method Details

       "A String",
     ],
     "description": "A String", # Product description. This field must be a UTF-8 encoded string with a length limit of 5,000 characters. Otherwise, an INVALID_ARGUMENT error is returned. Corresponding properties: Google Merchant Center property [description](https://support.google.com/merchants/answer/6324468). Schema.org property [Product.description](https://schema.org/description).
-    "expireTime": "A String", # Note that this field is applied in the following ways: * If the Product is already expired when it is uploaded, this product is not indexed for search. * If the Product is not expired when it is uploaded, only the Type.PRIMARY's and Type.COLLECTION's expireTime is respected, and Type.VARIANT's expireTime is not used. In general, we suggest the users to delete the stale products explicitly, instead of using this field to determine staleness. expire_time must be later than available_time and publish_time, otherwise an INVALID_ARGUMENT error is thrown. Corresponding properties: Google Merchant Center property [expiration_date](https://support.google.com/merchants/answer/6324499).
+    "expireTime": "A String", # The timestamp when this product becomes unavailable for SearchService.Search. If it is set, the Product is not available for SearchService.Search after expire_time. However, the product can still be retrieved by ProductService.GetProduct and ProductService.ListProducts. Note that this field is applied in the following ways: * If the Product is already expired when it is uploaded, this product is not indexed for search. * If the Product is not expired when it is uploaded, only the Type.PRIMARY's and Type.COLLECTION's expireTime is respected, and Type.VARIANT's expireTime is not used. In general, we suggest the users to delete the stale products explicitly, instead of using this field to determine staleness. expire_time must be later than available_time and publish_time, otherwise an INVALID_ARGUMENT error is thrown. Corresponding properties: Google Merchant Center property [expiration_date](https://support.google.com/merchants/answer/6324499).
     "fulfillmentInfo": [ # Fulfillment information, such as the store IDs for in-store pickup or region IDs for different shipping methods. All the elements must have distinct FulfillmentInfo.type. Otherwise, an INVALID_ARGUMENT error is returned.
       { # Fulfillment information, such as the store IDs for in-store pickup or region IDs for different shipping methods.
         "placeIds": [ # The IDs for this type, such as the store IDs for FulfillmentInfo.type.pickup-in-store or the region IDs for FulfillmentInfo.type.same-day-delivery. A maximum of 3000 values are allowed. Each value must be a string with a length limit of 30 characters, matching the pattern `[a-zA-Z0-9_-]+`, such as "store1" or "REGION-2". Otherwise, an INVALID_ARGUMENT error is returned.
diff --git a/docs/dyn/retail_v2.projects.locations.catalogs.placements.html b/docs/dyn/retail_v2.projects.locations.catalogs.placements.html
index 90b6227c00..89e97c420f 100644
--- a/docs/dyn/retail_v2.projects.locations.catalogs.placements.html
+++ b/docs/dyn/retail_v2.projects.locations.catalogs.placements.html
@@ -315,7 +315,7 @@ 
Method Details

                 "A String",
               ],
               "description": "A String", # Product description. This field must be a UTF-8 encoded string with a length limit of 5,000 characters. Otherwise, an INVALID_ARGUMENT error is returned. Corresponding properties: Google Merchant Center property [description](https://support.google.com/merchants/answer/6324468). Schema.org property [Product.description](https://schema.org/description).
-              "expireTime": "A String", # Note that this field is applied in the following ways: * If the Product is already expired when it is uploaded, this product is not indexed for search. * If the Product is not expired when it is uploaded, only the Type.PRIMARY's and Type.COLLECTION's expireTime is respected, and Type.VARIANT's expireTime is not used. In general, we suggest the users to delete the stale products explicitly, instead of using this field to determine staleness. expire_time must be later than available_time and publish_time, otherwise an INVALID_ARGUMENT error is thrown. Corresponding properties: Google Merchant Center property [expiration_date](https://support.google.com/merchants/answer/6324499).
+              "expireTime": "A String", # The timestamp when this product becomes unavailable for SearchService.Search. If it is set, the Product is not available for SearchService.Search after expire_time. However, the product can still be retrieved by ProductService.GetProduct and ProductService.ListProducts. Note that this field is applied in the following ways: * If the Product is already expired when it is uploaded, this product is not indexed for search. * If the Product is not expired when it is uploaded, only the Type.PRIMARY's and Type.COLLECTION's expireTime is respected, and Type.VARIANT's expireTime is not used. In general, we suggest the users to delete the stale products explicitly, instead of using this field to determine staleness. expire_time must be later than available_time and publish_time, otherwise an INVALID_ARGUMENT error is thrown. Corresponding properties: Google Merchant Center property [expiration_date](https://support.google.com/merchants/answer/6324499).
               "fulfillmentInfo": [ # Fulfillment information, such as the store IDs for in-store pickup or region IDs for different shipping methods. All the elements must have distinct FulfillmentInfo.type. Otherwise, an INVALID_ARGUMENT error is returned.
                 { # Fulfillment information, such as the store IDs for in-store pickup or region IDs for different shipping methods.
                   "placeIds": [ # The IDs for this type, such as the store IDs for FulfillmentInfo.type.pickup-in-store or the region IDs for FulfillmentInfo.type.same-day-delivery. A maximum of 3000 values are allowed. Each value must be a string with a length limit of 30 characters, matching the pattern `[a-zA-Z0-9_-]+`, such as "store1" or "REGION-2". Otherwise, an INVALID_ARGUMENT error is returned.
@@ -487,7 +487,7 @@ 
Method Details

             "A String",
           ],
           "description": "A String", # Product description. This field must be a UTF-8 encoded string with a length limit of 5,000 characters. Otherwise, an INVALID_ARGUMENT error is returned. Corresponding properties: Google Merchant Center property [description](https://support.google.com/merchants/answer/6324468). Schema.org property [Product.description](https://schema.org/description).
-          "expireTime": "A String", # Note that this field is applied in the following ways: * If the Product is already expired when it is uploaded, this product is not indexed for search. * If the Product is not expired when it is uploaded, only the Type.PRIMARY's and Type.COLLECTION's expireTime is respected, and Type.VARIANT's expireTime is not used. In general, we suggest the users to delete the stale products explicitly, instead of using this field to determine staleness. expire_time must be later than available_time and publish_time, otherwise an INVALID_ARGUMENT error is thrown. Corresponding properties: Google Merchant Center property [expiration_date](https://support.google.com/merchants/answer/6324499).
+          "expireTime": "A String", # The timestamp when this product becomes unavailable for SearchService.Search. If it is set, the Product is not available for SearchService.Search after expire_time. However, the product can still be retrieved by ProductService.GetProduct and ProductService.ListProducts. Note that this field is applied in the following ways: * If the Product is already expired when it is uploaded, this product is not indexed for search. * If the Product is not expired when it is uploaded, only the Type.PRIMARY's and Type.COLLECTION's expireTime is respected, and Type.VARIANT's expireTime is not used. In general, we suggest the users to delete the stale products explicitly, instead of using this field to determine staleness. expire_time must be later than available_time and publish_time, otherwise an INVALID_ARGUMENT error is thrown. Corresponding properties: Google Merchant Center property [expiration_date](https://support.google.com/merchants/answer/6324499).
           "fulfillmentInfo": [ # Fulfillment information, such as the store IDs for in-store pickup or region IDs for different shipping methods. All the elements must have distinct FulfillmentInfo.type. Otherwise, an INVALID_ARGUMENT error is returned.
             { # Fulfillment information, such as the store IDs for in-store pickup or region IDs for different shipping methods.
               "placeIds": [ # The IDs for this type, such as the store IDs for FulfillmentInfo.type.pickup-in-store or the region IDs for FulfillmentInfo.type.same-day-delivery. A maximum of 3000 values are allowed. Each value must be a string with a length limit of 30 characters, matching the pattern `[a-zA-Z0-9_-]+`, such as "store1" or "REGION-2". Otherwise, an INVALID_ARGUMENT error is returned.
@@ -959,7 +959,7 @@ 
Method Details

           "A String",
         ],
         "description": "A String", # Product description. This field must be a UTF-8 encoded string with a length limit of 5,000 characters. Otherwise, an INVALID_ARGUMENT error is returned. Corresponding properties: Google Merchant Center property [description](https://support.google.com/merchants/answer/6324468). Schema.org property [Product.description](https://schema.org/description).
-        "expireTime": "A String", # Note that this field is applied in the following ways: * If the Product is already expired when it is uploaded, this product is not indexed for search. * If the Product is not expired when it is uploaded, only the Type.PRIMARY's and Type.COLLECTION's expireTime is respected, and Type.VARIANT's expireTime is not used. In general, we suggest the users to delete the stale products explicitly, instead of using this field to determine staleness. expire_time must be later than available_time and publish_time, otherwise an INVALID_ARGUMENT error is thrown. Corresponding properties: Google Merchant Center property [expiration_date](https://support.google.com/merchants/answer/6324499).
+        "expireTime": "A String", # The timestamp when this product becomes unavailable for SearchService.Search. If it is set, the Product is not available for SearchService.Search after expire_time. However, the product can still be retrieved by ProductService.GetProduct and ProductService.ListProducts. Note that this field is applied in the following ways: * If the Product is already expired when it is uploaded, this product is not indexed for search. * If the Product is not expired when it is uploaded, only the Type.PRIMARY's and Type.COLLECTION's expireTime is respected, and Type.VARIANT's expireTime is not used. In general, we suggest the users to delete the stale products explicitly, instead of using this field to determine staleness. expire_time must be later than available_time and publish_time, otherwise an INVALID_ARGUMENT error is thrown. Corresponding properties: Google Merchant Center property [expiration_date](https://support.google.com/merchants/answer/6324499).
         "fulfillmentInfo": [ # Fulfillment information, such as the store IDs for in-store pickup or region IDs for different shipping methods. All the elements must have distinct FulfillmentInfo.type. Otherwise, an INVALID_ARGUMENT error is returned.
           { # Fulfillment information, such as the store IDs for in-store pickup or region IDs for different shipping methods.
             "placeIds": [ # The IDs for this type, such as the store IDs for FulfillmentInfo.type.pickup-in-store or the region IDs for FulfillmentInfo.type.same-day-delivery. A maximum of 3000 values are allowed. Each value must be a string with a length limit of 30 characters, matching the pattern `[a-zA-Z0-9_-]+`, such as "store1" or "REGION-2". Otherwise, an INVALID_ARGUMENT error is returned.
diff --git a/docs/dyn/retail_v2.projects.locations.catalogs.servingConfigs.html b/docs/dyn/retail_v2.projects.locations.catalogs.servingConfigs.html
index fdc85d0d27..54f9a067fc 100644
--- a/docs/dyn/retail_v2.projects.locations.catalogs.servingConfigs.html
+++ b/docs/dyn/retail_v2.projects.locations.catalogs.servingConfigs.html
@@ -797,7 +797,7 @@ 
Method Details

                 "A String",
               ],
               "description": "A String", # Product description. This field must be a UTF-8 encoded string with a length limit of 5,000 characters. Otherwise, an INVALID_ARGUMENT error is returned. Corresponding properties: Google Merchant Center property [description](https://support.google.com/merchants/answer/6324468). Schema.org property [Product.description](https://schema.org/description).
-              "expireTime": "A String", # Note that this field is applied in the following ways: * If the Product is already expired when it is uploaded, this product is not indexed for search. * If the Product is not expired when it is uploaded, only the Type.PRIMARY's and Type.COLLECTION's expireTime is respected, and Type.VARIANT's expireTime is not used. In general, we suggest the users to delete the stale products explicitly, instead of using this field to determine staleness. expire_time must be later than available_time and publish_time, otherwise an INVALID_ARGUMENT error is thrown. Corresponding properties: Google Merchant Center property [expiration_date](https://support.google.com/merchants/answer/6324499).
+              "expireTime": "A String", # The timestamp when this product becomes unavailable for SearchService.Search. If it is set, the Product is not available for SearchService.Search after expire_time. However, the product can still be retrieved by ProductService.GetProduct and ProductService.ListProducts. Note that this field is applied in the following ways: * If the Product is already expired when it is uploaded, this product is not indexed for search. * If the Product is not expired when it is uploaded, only the Type.PRIMARY's and Type.COLLECTION's expireTime is respected, and Type.VARIANT's expireTime is not used. In general, we suggest the users to delete the stale products explicitly, instead of using this field to determine staleness. expire_time must be later than available_time and publish_time, otherwise an INVALID_ARGUMENT error is thrown. Corresponding properties: Google Merchant Center property [expiration_date](https://support.google.com/merchants/answer/6324499).
               "fulfillmentInfo": [ # Fulfillment information, such as the store IDs for in-store pickup or region IDs for different shipping methods. All the elements must have distinct FulfillmentInfo.type. Otherwise, an INVALID_ARGUMENT error is returned.
                 { # Fulfillment information, such as the store IDs for in-store pickup or region IDs for different shipping methods.
                   "placeIds": [ # The IDs for this type, such as the store IDs for FulfillmentInfo.type.pickup-in-store or the region IDs for FulfillmentInfo.type.same-day-delivery. A maximum of 3000 values are allowed. Each value must be a string with a length limit of 30 characters, matching the pattern `[a-zA-Z0-9_-]+`, such as "store1" or "REGION-2". Otherwise, an INVALID_ARGUMENT error is returned.
@@ -969,7 +969,7 @@ 
Method Details

             "A String",
           ],
           "description": "A String", # Product description. This field must be a UTF-8 encoded string with a length limit of 5,000 characters. Otherwise, an INVALID_ARGUMENT error is returned. Corresponding properties: Google Merchant Center property [description](https://support.google.com/merchants/answer/6324468). Schema.org property [Product.description](https://schema.org/description).
-          "expireTime": "A String", # Note that this field is applied in the following ways: * If the Product is already expired when it is uploaded, this product is not indexed for search. * If the Product is not expired when it is uploaded, only the Type.PRIMARY's and Type.COLLECTION's expireTime is respected, and Type.VARIANT's expireTime is not used. In general, we suggest the users to delete the stale products explicitly, instead of using this field to determine staleness. expire_time must be later than available_time and publish_time, otherwise an INVALID_ARGUMENT error is thrown. Corresponding properties: Google Merchant Center property [expiration_date](https://support.google.com/merchants/answer/6324499).
+          "expireTime": "A String", # The timestamp when this product becomes unavailable for SearchService.Search. If it is set, the Product is not available for SearchService.Search after expire_time. However, the product can still be retrieved by ProductService.GetProduct and ProductService.ListProducts. Note that this field is applied in the following ways: * If the Product is already expired when it is uploaded, this product is not indexed for search. * If the Product is not expired when it is uploaded, only the Type.PRIMARY's and Type.COLLECTION's expireTime is respected, and Type.VARIANT's expireTime is not used. In general, we suggest the users to delete the stale products explicitly, instead of using this field to determine staleness. expire_time must be later than available_time and publish_time, otherwise an INVALID_ARGUMENT error is thrown. Corresponding properties: Google Merchant Center property [expiration_date](https://support.google.com/merchants/answer/6324499).
           "fulfillmentInfo": [ # Fulfillment information, such as the store IDs for in-store pickup or region IDs for different shipping methods. All the elements must have distinct FulfillmentInfo.type. Otherwise, an INVALID_ARGUMENT error is returned.
             { # Fulfillment information, such as the store IDs for in-store pickup or region IDs for different shipping methods.
               "placeIds": [ # The IDs for this type, such as the store IDs for FulfillmentInfo.type.pickup-in-store or the region IDs for FulfillmentInfo.type.same-day-delivery. A maximum of 3000 values are allowed. Each value must be a string with a length limit of 30 characters, matching the pattern `[a-zA-Z0-9_-]+`, such as "store1" or "REGION-2". Otherwise, an INVALID_ARGUMENT error is returned.
@@ -1510,7 +1510,7 @@ 
Method Details

           "A String",
         ],
         "description": "A String", # Product description. This field must be a UTF-8 encoded string with a length limit of 5,000 characters. Otherwise, an INVALID_ARGUMENT error is returned. Corresponding properties: Google Merchant Center property [description](https://support.google.com/merchants/answer/6324468). Schema.org property [Product.description](https://schema.org/description).
-        "expireTime": "A String", # Note that this field is applied in the following ways: * If the Product is already expired when it is uploaded, this product is not indexed for search. * If the Product is not expired when it is uploaded, only the Type.PRIMARY's and Type.COLLECTION's expireTime is respected, and Type.VARIANT's expireTime is not used. In general, we suggest the users to delete the stale products explicitly, instead of using this field to determine staleness. expire_time must be later than available_time and publish_time, otherwise an INVALID_ARGUMENT error is thrown. Corresponding properties: Google Merchant Center property [expiration_date](https://support.google.com/merchants/answer/6324499).
+        "expireTime": "A String", # The timestamp when this product becomes unavailable for SearchService.Search. If it is set, the Product is not available for SearchService.Search after expire_time. However, the product can still be retrieved by ProductService.GetProduct and ProductService.ListProducts. Note that this field is applied in the following ways: * If the Product is already expired when it is uploaded, this product is not indexed for search. * If the Product is not expired when it is uploaded, only the Type.PRIMARY's and Type.COLLECTION's expireTime is respected, and Type.VARIANT's expireTime is not used. In general, we suggest the users to delete the stale products explicitly, instead of using this field to determine staleness. expire_time must be later than available_time and publish_time, otherwise an INVALID_ARGUMENT error is thrown. Corresponding properties: Google Merchant Center property [expiration_date](https://support.google.com/merchants/answer/6324499).
         "fulfillmentInfo": [ # Fulfillment information, such as the store IDs for in-store pickup or region IDs for different shipping methods. All the elements must have distinct FulfillmentInfo.type. Otherwise, an INVALID_ARGUMENT error is returned.
           { # Fulfillment information, such as the store IDs for in-store pickup or region IDs for different shipping methods.
             "placeIds": [ # The IDs for this type, such as the store IDs for FulfillmentInfo.type.pickup-in-store or the region IDs for FulfillmentInfo.type.same-day-delivery. A maximum of 3000 values are allowed. Each value must be a string with a length limit of 30 characters, matching the pattern `[a-zA-Z0-9_-]+`, such as "store1" or "REGION-2". Otherwise, an INVALID_ARGUMENT error is returned.
diff --git a/docs/dyn/retail_v2.projects.locations.catalogs.userEvents.html b/docs/dyn/retail_v2.projects.locations.catalogs.userEvents.html
index 5efd5f8b11..fe5d71983e 100644
--- a/docs/dyn/retail_v2.projects.locations.catalogs.userEvents.html
+++ b/docs/dyn/retail_v2.projects.locations.catalogs.userEvents.html
@@ -254,7 +254,7 @@ 
Method Details

                       "A String",
                     ],
                     "description": "A String", # Product description. This field must be a UTF-8 encoded string with a length limit of 5,000 characters. Otherwise, an INVALID_ARGUMENT error is returned. Corresponding properties: Google Merchant Center property [description](https://support.google.com/merchants/answer/6324468). Schema.org property [Product.description](https://schema.org/description).
-                    "expireTime": "A String", # Note that this field is applied in the following ways: * If the Product is already expired when it is uploaded, this product is not indexed for search. * If the Product is not expired when it is uploaded, only the Type.PRIMARY's and Type.COLLECTION's expireTime is respected, and Type.VARIANT's expireTime is not used. In general, we suggest the users to delete the stale products explicitly, instead of using this field to determine staleness. expire_time must be later than available_time and publish_time, otherwise an INVALID_ARGUMENT error is thrown. Corresponding properties: Google Merchant Center property [expiration_date](https://support.google.com/merchants/answer/6324499).
+                    "expireTime": "A String", # The timestamp when this product becomes unavailable for SearchService.Search. If it is set, the Product is not available for SearchService.Search after expire_time. However, the product can still be retrieved by ProductService.GetProduct and ProductService.ListProducts. Note that this field is applied in the following ways: * If the Product is already expired when it is uploaded, this product is not indexed for search. * If the Product is not expired when it is uploaded, only the Type.PRIMARY's and Type.COLLECTION's expireTime is respected, and Type.VARIANT's expireTime is not used. In general, we suggest the users to delete the stale products explicitly, instead of using this field to determine staleness. expire_time must be later than available_time and publish_time, otherwise an INVALID_ARGUMENT error is thrown. Corresponding properties: Google Merchant Center property [expiration_date](https://support.google.com/merchants/answer/6324499).
                     "fulfillmentInfo": [ # Fulfillment information, such as the store IDs for in-store pickup or region IDs for different shipping methods. All the elements must have distinct FulfillmentInfo.type. Otherwise, an INVALID_ARGUMENT error is returned.
                       { # Fulfillment information, such as the store IDs for in-store pickup or region IDs for different shipping methods.
                         "placeIds": [ # The IDs for this type, such as the store IDs for FulfillmentInfo.type.pickup-in-store or the region IDs for FulfillmentInfo.type.same-day-delivery. A maximum of 3000 values are allowed. Each value must be a string with a length limit of 30 characters, matching the pattern `[a-zA-Z0-9_-]+`, such as "store1" or "REGION-2". Otherwise, an INVALID_ARGUMENT error is returned.
@@ -426,7 +426,7 @@ 
Method Details

                   "A String",
                 ],
                 "description": "A String", # Product description. This field must be a UTF-8 encoded string with a length limit of 5,000 characters. Otherwise, an INVALID_ARGUMENT error is returned. Corresponding properties: Google Merchant Center property [description](https://support.google.com/merchants/answer/6324468). Schema.org property [Product.description](https://schema.org/description).
-                "expireTime": "A String", # Note that this field is applied in the following ways: * If the Product is already expired when it is uploaded, this product is not indexed for search. * If the Product is not expired when it is uploaded, only the Type.PRIMARY's and Type.COLLECTION's expireTime is respected, and Type.VARIANT's expireTime is not used. In general, we suggest the users to delete the stale products explicitly, instead of using this field to determine staleness. expire_time must be later than available_time and publish_time, otherwise an INVALID_ARGUMENT error is thrown. Corresponding properties: Google Merchant Center property [expiration_date](https://support.google.com/merchants/answer/6324499).
+                "expireTime": "A String", # The timestamp when this product becomes unavailable for SearchService.Search. If it is set, the Product is not available for SearchService.Search after expire_time. However, the product can still be retrieved by ProductService.GetProduct and ProductService.ListProducts. Note that this field is applied in the following ways: * If the Product is already expired when it is uploaded, this product is not indexed for search. * If the Product is not expired when it is uploaded, only the Type.PRIMARY's and Type.COLLECTION's expireTime is respected, and Type.VARIANT's expireTime is not used. In general, we suggest the users to delete the stale products explicitly, instead of using this field to determine staleness. expire_time must be later than available_time and publish_time, otherwise an INVALID_ARGUMENT error is thrown. Corresponding properties: Google Merchant Center property [expiration_date](https://support.google.com/merchants/answer/6324499).
                 "fulfillmentInfo": [ # Fulfillment information, such as the store IDs for in-store pickup or region IDs for different shipping methods. All the elements must have distinct FulfillmentInfo.type. Otherwise, an INVALID_ARGUMENT error is returned.
                   { # Fulfillment information, such as the store IDs for in-store pickup or region IDs for different shipping methods.
                     "placeIds": [ # The IDs for this type, such as the store IDs for FulfillmentInfo.type.pickup-in-store or the region IDs for FulfillmentInfo.type.same-day-delivery. A maximum of 3000 values are allowed. Each value must be a string with a length limit of 30 characters, matching the pattern `[a-zA-Z0-9_-]+`, such as "store1" or "REGION-2". Otherwise, an INVALID_ARGUMENT error is returned.
@@ -781,7 +781,7 @@ 
Method Details

               "A String",
             ],
             "description": "A String", # Product description. This field must be a UTF-8 encoded string with a length limit of 5,000 characters. Otherwise, an INVALID_ARGUMENT error is returned. Corresponding properties: Google Merchant Center property [description](https://support.google.com/merchants/answer/6324468). Schema.org property [Product.description](https://schema.org/description).
-            "expireTime": "A String", # Note that this field is applied in the following ways: * If the Product is already expired when it is uploaded, this product is not indexed for search. * If the Product is not expired when it is uploaded, only the Type.PRIMARY's and Type.COLLECTION's expireTime is respected, and Type.VARIANT's expireTime is not used. In general, we suggest the users to delete the stale products explicitly, instead of using this field to determine staleness. expire_time must be later than available_time and publish_time, otherwise an INVALID_ARGUMENT error is thrown. Corresponding properties: Google Merchant Center property [expiration_date](https://support.google.com/merchants/answer/6324499).
+            "expireTime": "A String", # The timestamp when this product becomes unavailable for SearchService.Search. If it is set, the Product is not available for SearchService.Search after expire_time. However, the product can still be retrieved by ProductService.GetProduct and ProductService.ListProducts. Note that this field is applied in the following ways: * If the Product is already expired when it is uploaded, this product is not indexed for search. * If the Product is not expired when it is uploaded, only the Type.PRIMARY's and Type.COLLECTION's expireTime is respected, and Type.VARIANT's expireTime is not used. In general, we suggest the users to delete the stale products explicitly, instead of using this field to determine staleness. expire_time must be later than available_time and publish_time, otherwise an INVALID_ARGUMENT error is thrown. Corresponding properties: Google Merchant Center property [expiration_date](https://support.google.com/merchants/answer/6324499).
             "fulfillmentInfo": [ # Fulfillment information, such as the store IDs for in-store pickup or region IDs for different shipping methods. All the elements must have distinct FulfillmentInfo.type. Otherwise, an INVALID_ARGUMENT error is returned.
               { # Fulfillment information, such as the store IDs for in-store pickup or region IDs for different shipping methods.
                 "placeIds": [ # The IDs for this type, such as the store IDs for FulfillmentInfo.type.pickup-in-store or the region IDs for FulfillmentInfo.type.same-day-delivery. A maximum of 3000 values are allowed. Each value must be a string with a length limit of 30 characters, matching the pattern `[a-zA-Z0-9_-]+`, such as "store1" or "REGION-2". Otherwise, an INVALID_ARGUMENT error is returned.
@@ -953,7 +953,7 @@ 
Method Details

           "A String",
         ],
         "description": "A String", # Product description. This field must be a UTF-8 encoded string with a length limit of 5,000 characters. Otherwise, an INVALID_ARGUMENT error is returned. Corresponding properties: Google Merchant Center property [description](https://support.google.com/merchants/answer/6324468). Schema.org property [Product.description](https://schema.org/description).
-        "expireTime": "A String", # Note that this field is applied in the following ways: * If the Product is already expired when it is uploaded, this product is not indexed for search. * If the Product is not expired when it is uploaded, only the Type.PRIMARY's and Type.COLLECTION's expireTime is respected, and Type.VARIANT's expireTime is not used. In general, we suggest the users to delete the stale products explicitly, instead of using this field to determine staleness. expire_time must be later than available_time and publish_time, otherwise an INVALID_ARGUMENT error is thrown. Corresponding properties: Google Merchant Center property [expiration_date](https://support.google.com/merchants/answer/6324499).
+        "expireTime": "A String", # The timestamp when this product becomes unavailable for SearchService.Search. If it is set, the Product is not available for SearchService.Search after expire_time. However, the product can still be retrieved by ProductService.GetProduct and ProductService.ListProducts. Note that this field is applied in the following ways: * If the Product is already expired when it is uploaded, this product is not indexed for search. * If the Product is not expired when it is uploaded, only the Type.PRIMARY's and Type.COLLECTION's expireTime is respected, and Type.VARIANT's expireTime is not used. In general, we suggest the users to delete the stale products explicitly, instead of using this field to determine staleness. expire_time must be later than available_time and publish_time, otherwise an INVALID_ARGUMENT error is thrown. Corresponding properties: Google Merchant Center property [expiration_date](https://support.google.com/merchants/answer/6324499).
         "fulfillmentInfo": [ # Fulfillment information, such as the store IDs for in-store pickup or region IDs for different shipping methods. All the elements must have distinct FulfillmentInfo.type. Otherwise, an INVALID_ARGUMENT error is returned.
           { # Fulfillment information, such as the store IDs for in-store pickup or region IDs for different shipping methods.
             "placeIds": [ # The IDs for this type, such as the store IDs for FulfillmentInfo.type.pickup-in-store or the region IDs for FulfillmentInfo.type.same-day-delivery. A maximum of 3000 values are allowed. Each value must be a string with a length limit of 30 characters, matching the pattern `[a-zA-Z0-9_-]+`, such as "store1" or "REGION-2". Otherwise, an INVALID_ARGUMENT error is returned.
@@ -1190,7 +1190,7 @@ 
Method Details

               "A String",
             ],
             "description": "A String", # Product description. This field must be a UTF-8 encoded string with a length limit of 5,000 characters. Otherwise, an INVALID_ARGUMENT error is returned. Corresponding properties: Google Merchant Center property [description](https://support.google.com/merchants/answer/6324468). Schema.org property [Product.description](https://schema.org/description).
-            "expireTime": "A String", # Note that this field is applied in the following ways: * If the Product is already expired when it is uploaded, this product is not indexed for search. * If the Product is not expired when it is uploaded, only the Type.PRIMARY's and Type.COLLECTION's expireTime is respected, and Type.VARIANT's expireTime is not used. In general, we suggest the users to delete the stale products explicitly, instead of using this field to determine staleness. expire_time must be later than available_time and publish_time, otherwise an INVALID_ARGUMENT error is thrown. Corresponding properties: Google Merchant Center property [expiration_date](https://support.google.com/merchants/answer/6324499).
+            "expireTime": "A String", # The timestamp when this product becomes unavailable for SearchService.Search. If it is set, the Product is not available for SearchService.Search after expire_time. However, the product can still be retrieved by ProductService.GetProduct and ProductService.ListProducts. Note that this field is applied in the following ways: * If the Product is already expired when it is uploaded, this product is not indexed for search. * If the Product is not expired when it is uploaded, only the Type.PRIMARY's and Type.COLLECTION's expireTime is respected, and Type.VARIANT's expireTime is not used. In general, we suggest the users to delete the stale products explicitly, instead of using this field to determine staleness. expire_time must be later than available_time and publish_time, otherwise an INVALID_ARGUMENT error is thrown. Corresponding properties: Google Merchant Center property [expiration_date](https://support.google.com/merchants/answer/6324499).
             "fulfillmentInfo": [ # Fulfillment information, such as the store IDs for in-store pickup or region IDs for different shipping methods. All the elements must have distinct FulfillmentInfo.type. Otherwise, an INVALID_ARGUMENT error is returned.
               { # Fulfillment information, such as the store IDs for in-store pickup or region IDs for different shipping methods.
                 "placeIds": [ # The IDs for this type, such as the store IDs for FulfillmentInfo.type.pickup-in-store or the region IDs for FulfillmentInfo.type.same-day-delivery. A maximum of 3000 values are allowed. Each value must be a string with a length limit of 30 characters, matching the pattern `[a-zA-Z0-9_-]+`, such as "store1" or "REGION-2". Otherwise, an INVALID_ARGUMENT error is returned.
@@ -1362,7 +1362,7 @@ 
Method Details

           "A String",
         ],
         "description": "A String", # Product description. This field must be a UTF-8 encoded string with a length limit of 5,000 characters. Otherwise, an INVALID_ARGUMENT error is returned. Corresponding properties: Google Merchant Center property [description](https://support.google.com/merchants/answer/6324468). Schema.org property [Product.description](https://schema.org/description).
-        "expireTime": "A String", # Note that this field is applied in the following ways: * If the Product is already expired when it is uploaded, this product is not indexed for search. * If the Product is not expired when it is uploaded, only the Type.PRIMARY's and Type.COLLECTION's expireTime is respected, and Type.VARIANT's expireTime is not used. In general, we suggest the users to delete the stale products explicitly, instead of using this field to determine staleness. expire_time must be later than available_time and publish_time, otherwise an INVALID_ARGUMENT error is thrown. Corresponding properties: Google Merchant Center property [expiration_date](https://support.google.com/merchants/answer/6324499).
+        "expireTime": "A String", # The timestamp when this product becomes unavailable for SearchService.Search. If it is set, the Product is not available for SearchService.Search after expire_time. However, the product can still be retrieved by ProductService.GetProduct and ProductService.ListProducts. Note that this field is applied in the following ways: * If the Product is already expired when it is uploaded, this product is not indexed for search. * If the Product is not expired when it is uploaded, only the Type.PRIMARY's and Type.COLLECTION's expireTime is respected, and Type.VARIANT's expireTime is not used. In general, we suggest the users to delete the stale products explicitly, instead of using this field to determine staleness. expire_time must be later than available_time and publish_time, otherwise an INVALID_ARGUMENT error is thrown. Corresponding properties: Google Merchant Center property [expiration_date](https://support.google.com/merchants/answer/6324499).
         "fulfillmentInfo": [ # Fulfillment information, such as the store IDs for in-store pickup or region IDs for different shipping methods. All the elements must have distinct FulfillmentInfo.type. Otherwise, an INVALID_ARGUMENT error is returned.
           { # Fulfillment information, such as the store IDs for in-store pickup or region IDs for different shipping methods.
             "placeIds": [ # The IDs for this type, such as the store IDs for FulfillmentInfo.type.pickup-in-store or the region IDs for FulfillmentInfo.type.same-day-delivery. A maximum of 3000 values are allowed. Each value must be a string with a length limit of 30 characters, matching the pattern `[a-zA-Z0-9_-]+`, such as "store1" or "REGION-2". Otherwise, an INVALID_ARGUMENT error is returned.
diff --git a/docs/dyn/retail_v2alpha.projects.locations.catalogs.branches.html b/docs/dyn/retail_v2alpha.projects.locations.catalogs.branches.html
index ae1ca3104a..3a25bc1712 100644
--- a/docs/dyn/retail_v2alpha.projects.locations.catalogs.branches.html
+++ b/docs/dyn/retail_v2alpha.projects.locations.catalogs.branches.html
@@ -188,7 +188,7 @@ 
Method Details

             "A String",
           ],
           "description": "A String", # Product description. This field must be a UTF-8 encoded string with a length limit of 5,000 characters. Otherwise, an INVALID_ARGUMENT error is returned. Corresponding properties: Google Merchant Center property [description](https://support.google.com/merchants/answer/6324468). Schema.org property [Product.description](https://schema.org/description).
-          "expireTime": "A String", # Note that this field is applied in the following ways: * If the Product is already expired when it is uploaded, this product is not indexed for search. * If the Product is not expired when it is uploaded, only the Type.PRIMARY's and Type.COLLECTION's expireTime is respected, and Type.VARIANT's expireTime is not used. In general, we suggest the users to delete the stale products explicitly, instead of using this field to determine staleness. expire_time must be later than available_time and publish_time, otherwise an INVALID_ARGUMENT error is thrown. Corresponding properties: Google Merchant Center property [expiration_date](https://support.google.com/merchants/answer/6324499).
+          "expireTime": "A String", # The timestamp when this product becomes unavailable for SearchService.Search. If it is set, the Product is not available for SearchService.Search after expire_time. However, the product can still be retrieved by ProductService.GetProduct and ProductService.ListProducts. Note that this field is applied in the following ways: * If the Product is already expired when it is uploaded, this product is not indexed for search. * If the Product is not expired when it is uploaded, only the Type.PRIMARY's and Type.COLLECTION's expireTime is respected, and Type.VARIANT's expireTime is not used. In general, we suggest the users to delete the stale products explicitly, instead of using this field to determine staleness. expire_time must be later than available_time and publish_time, otherwise an INVALID_ARGUMENT error is thrown. Corresponding properties: Google Merchant Center property [expiration_date](https://support.google.com/merchants/answer/6324499).
           "fulfillmentInfo": [ # Fulfillment information, such as the store IDs for in-store pickup or region IDs for different shipping methods. All the elements must have distinct FulfillmentInfo.type. Otherwise, an INVALID_ARGUMENT error is returned.
             { # Fulfillment information, such as the store IDs for in-store pickup or region IDs for different shipping methods.
               "placeIds": [ # The IDs for this type, such as the store IDs for FulfillmentInfo.type.pickup-in-store or the region IDs for FulfillmentInfo.type.same-day-delivery. A maximum of 3000 values are allowed. Each value must be a string with a length limit of 30 characters, matching the pattern `[a-zA-Z0-9_-]+`, such as "store1" or "REGION-2". Otherwise, an INVALID_ARGUMENT error is returned.
@@ -400,7 +400,7 @@ 
Method Details

                 "A String",
               ],
               "description": "A String", # Product description. This field must be a UTF-8 encoded string with a length limit of 5,000 characters. Otherwise, an INVALID_ARGUMENT error is returned. Corresponding properties: Google Merchant Center property [description](https://support.google.com/merchants/answer/6324468). Schema.org property [Product.description](https://schema.org/description).
-              "expireTime": "A String", # Note that this field is applied in the following ways: * If the Product is already expired when it is uploaded, this product is not indexed for search. * If the Product is not expired when it is uploaded, only the Type.PRIMARY's and Type.COLLECTION's expireTime is respected, and Type.VARIANT's expireTime is not used. In general, we suggest the users to delete the stale products explicitly, instead of using this field to determine staleness. expire_time must be later than available_time and publish_time, otherwise an INVALID_ARGUMENT error is thrown. Corresponding properties: Google Merchant Center property [expiration_date](https://support.google.com/merchants/answer/6324499).
+              "expireTime": "A String", # The timestamp when this product becomes unavailable for SearchService.Search. If it is set, the Product is not available for SearchService.Search after expire_time. However, the product can still be retrieved by ProductService.GetProduct and ProductService.ListProducts. Note that this field is applied in the following ways: * If the Product is already expired when it is uploaded, this product is not indexed for search. * If the Product is not expired when it is uploaded, only the Type.PRIMARY's and Type.COLLECTION's expireTime is respected, and Type.VARIANT's expireTime is not used. In general, we suggest the users to delete the stale products explicitly, instead of using this field to determine staleness. expire_time must be later than available_time and publish_time, otherwise an INVALID_ARGUMENT error is thrown. Corresponding properties: Google Merchant Center property [expiration_date](https://support.google.com/merchants/answer/6324499).
               "fulfillmentInfo": [ # Fulfillment information, such as the store IDs for in-store pickup or region IDs for different shipping methods. All the elements must have distinct FulfillmentInfo.type. Otherwise, an INVALID_ARGUMENT error is returned.
                 { # Fulfillment information, such as the store IDs for in-store pickup or region IDs for different shipping methods.
                   "placeIds": [ # The IDs for this type, such as the store IDs for FulfillmentInfo.type.pickup-in-store or the region IDs for FulfillmentInfo.type.same-day-delivery. A maximum of 3000 values are allowed. Each value must be a string with a length limit of 30 characters, matching the pattern `[a-zA-Z0-9_-]+`, such as "store1" or "REGION-2". Otherwise, an INVALID_ARGUMENT error is returned.
diff --git a/docs/dyn/retail_v2alpha.projects.locations.catalogs.branches.products.html b/docs/dyn/retail_v2alpha.projects.locations.catalogs.branches.products.html
index 4ba0df2fa1..53a8a3433e 100644
--- a/docs/dyn/retail_v2alpha.projects.locations.catalogs.branches.products.html
+++ b/docs/dyn/retail_v2alpha.projects.locations.catalogs.branches.products.html
@@ -313,7 +313,7 @@ 
Method Details

     "A String",
   ],
   "description": "A String", # Product description. This field must be a UTF-8 encoded string with a length limit of 5,000 characters. Otherwise, an INVALID_ARGUMENT error is returned. Corresponding properties: Google Merchant Center property [description](https://support.google.com/merchants/answer/6324468). Schema.org property [Product.description](https://schema.org/description).
-  "expireTime": "A String", # Note that this field is applied in the following ways: * If the Product is already expired when it is uploaded, this product is not indexed for search. * If the Product is not expired when it is uploaded, only the Type.PRIMARY's and Type.COLLECTION's expireTime is respected, and Type.VARIANT's expireTime is not used. In general, we suggest the users to delete the stale products explicitly, instead of using this field to determine staleness. expire_time must be later than available_time and publish_time, otherwise an INVALID_ARGUMENT error is thrown. Corresponding properties: Google Merchant Center property [expiration_date](https://support.google.com/merchants/answer/6324499).
+  "expireTime": "A String", # The timestamp when this product becomes unavailable for SearchService.Search. If it is set, the Product is not available for SearchService.Search after expire_time. However, the product can still be retrieved by ProductService.GetProduct and ProductService.ListProducts. Note that this field is applied in the following ways: * If the Product is already expired when it is uploaded, this product is not indexed for search. * If the Product is not expired when it is uploaded, only the Type.PRIMARY's and Type.COLLECTION's expireTime is respected, and Type.VARIANT's expireTime is not used. In general, we suggest the users to delete the stale products explicitly, instead of using this field to determine staleness. expire_time must be later than available_time and publish_time, otherwise an INVALID_ARGUMENT error is thrown. Corresponding properties: Google Merchant Center property [expiration_date](https://support.google.com/merchants/answer/6324499).
   "fulfillmentInfo": [ # Fulfillment information, such as the store IDs for in-store pickup or region IDs for different shipping methods. All the elements must have distinct FulfillmentInfo.type. Otherwise, an INVALID_ARGUMENT error is returned.
     { # Fulfillment information, such as the store IDs for in-store pickup or region IDs for different shipping methods.
       "placeIds": [ # The IDs for this type, such as the store IDs for FulfillmentInfo.type.pickup-in-store or the region IDs for FulfillmentInfo.type.same-day-delivery. A maximum of 3000 values are allowed. Each value must be a string with a length limit of 30 characters, matching the pattern `[a-zA-Z0-9_-]+`, such as "store1" or "REGION-2". Otherwise, an INVALID_ARGUMENT error is returned.
@@ -488,7 +488,7 @@ 
Method Details

     "A String",
   ],
   "description": "A String", # Product description. This field must be a UTF-8 encoded string with a length limit of 5,000 characters. Otherwise, an INVALID_ARGUMENT error is returned. Corresponding properties: Google Merchant Center property [description](https://support.google.com/merchants/answer/6324468). Schema.org property [Product.description](https://schema.org/description).
-  "expireTime": "A String", # Note that this field is applied in the following ways: * If the Product is already expired when it is uploaded, this product is not indexed for search. * If the Product is not expired when it is uploaded, only the Type.PRIMARY's and Type.COLLECTION's expireTime is respected, and Type.VARIANT's expireTime is not used. In general, we suggest the users to delete the stale products explicitly, instead of using this field to determine staleness. expire_time must be later than available_time and publish_time, otherwise an INVALID_ARGUMENT error is thrown. Corresponding properties: Google Merchant Center property [expiration_date](https://support.google.com/merchants/answer/6324499).
+  "expireTime": "A String", # The timestamp when this product becomes unavailable for SearchService.Search. If it is set, the Product is not available for SearchService.Search after expire_time. However, the product can still be retrieved by ProductService.GetProduct and ProductService.ListProducts. Note that this field is applied in the following ways: * If the Product is already expired when it is uploaded, this product is not indexed for search. * If the Product is not expired when it is uploaded, only the Type.PRIMARY's and Type.COLLECTION's expireTime is respected, and Type.VARIANT's expireTime is not used. In general, we suggest the users to delete the stale products explicitly, instead of using this field to determine staleness. expire_time must be later than available_time and publish_time, otherwise an INVALID_ARGUMENT error is thrown. Corresponding properties: Google Merchant Center property [expiration_date](https://support.google.com/merchants/answer/6324499).
   "fulfillmentInfo": [ # Fulfillment information, such as the store IDs for in-store pickup or region IDs for different shipping methods. All the elements must have distinct FulfillmentInfo.type. Otherwise, an INVALID_ARGUMENT error is returned.
     { # Fulfillment information, such as the store IDs for in-store pickup or region IDs for different shipping methods.
       "placeIds": [ # The IDs for this type, such as the store IDs for FulfillmentInfo.type.pickup-in-store or the region IDs for FulfillmentInfo.type.same-day-delivery. A maximum of 3000 values are allowed. Each value must be a string with a length limit of 30 characters, matching the pattern `[a-zA-Z0-9_-]+`, such as "store1" or "REGION-2". Otherwise, an INVALID_ARGUMENT error is returned.
@@ -740,7 +740,7 @@ 
Method Details

     "A String",
   ],
   "description": "A String", # Product description. This field must be a UTF-8 encoded string with a length limit of 5,000 characters. Otherwise, an INVALID_ARGUMENT error is returned. Corresponding properties: Google Merchant Center property [description](https://support.google.com/merchants/answer/6324468). Schema.org property [Product.description](https://schema.org/description).
-  "expireTime": "A String", # Note that this field is applied in the following ways: * If the Product is already expired when it is uploaded, this product is not indexed for search. * If the Product is not expired when it is uploaded, only the Type.PRIMARY's and Type.COLLECTION's expireTime is respected, and Type.VARIANT's expireTime is not used. In general, we suggest the users to delete the stale products explicitly, instead of using this field to determine staleness. expire_time must be later than available_time and publish_time, otherwise an INVALID_ARGUMENT error is thrown. Corresponding properties: Google Merchant Center property [expiration_date](https://support.google.com/merchants/answer/6324499).
+  "expireTime": "A String", # The timestamp when this product becomes unavailable for SearchService.Search. If it is set, the Product is not available for SearchService.Search after expire_time. However, the product can still be retrieved by ProductService.GetProduct and ProductService.ListProducts. Note that this field is applied in the following ways: * If the Product is already expired when it is uploaded, this product is not indexed for search. * If the Product is not expired when it is uploaded, only the Type.PRIMARY's and Type.COLLECTION's expireTime is respected, and Type.VARIANT's expireTime is not used. In general, we suggest the users to delete the stale products explicitly, instead of using this field to determine staleness. expire_time must be later than available_time and publish_time, otherwise an INVALID_ARGUMENT error is thrown. Corresponding properties: Google Merchant Center property [expiration_date](https://support.google.com/merchants/answer/6324499).
   "fulfillmentInfo": [ # Fulfillment information, such as the store IDs for in-store pickup or region IDs for different shipping methods. All the elements must have distinct FulfillmentInfo.type. Otherwise, an INVALID_ARGUMENT error is returned.
     { # Fulfillment information, such as the store IDs for in-store pickup or region IDs for different shipping methods.
       "placeIds": [ # The IDs for this type, such as the store IDs for FulfillmentInfo.type.pickup-in-store or the region IDs for FulfillmentInfo.type.same-day-delivery. A maximum of 3000 values are allowed. Each value must be a string with a length limit of 30 characters, matching the pattern `[a-zA-Z0-9_-]+`, such as "store1" or "REGION-2". Otherwise, an INVALID_ARGUMENT error is returned.
@@ -941,7 +941,7 @@ 
Method Details

             "A String",
           ],
           "description": "A String", # Product description. This field must be a UTF-8 encoded string with a length limit of 5,000 characters. Otherwise, an INVALID_ARGUMENT error is returned. Corresponding properties: Google Merchant Center property [description](https://support.google.com/merchants/answer/6324468). Schema.org property [Product.description](https://schema.org/description).
-          "expireTime": "A String", # Note that this field is applied in the following ways: * If the Product is already expired when it is uploaded, this product is not indexed for search. * If the Product is not expired when it is uploaded, only the Type.PRIMARY's and Type.COLLECTION's expireTime is respected, and Type.VARIANT's expireTime is not used. In general, we suggest the users to delete the stale products explicitly, instead of using this field to determine staleness. expire_time must be later than available_time and publish_time, otherwise an INVALID_ARGUMENT error is thrown. Corresponding properties: Google Merchant Center property [expiration_date](https://support.google.com/merchants/answer/6324499).
+          "expireTime": "A String", # The timestamp when this product becomes unavailable for SearchService.Search. If it is set, the Product is not available for SearchService.Search after expire_time. However, the product can still be retrieved by ProductService.GetProduct and ProductService.ListProducts. Note that this field is applied in the following ways: * If the Product is already expired when it is uploaded, this product is not indexed for search. * If the Product is not expired when it is uploaded, only the Type.PRIMARY's and Type.COLLECTION's expireTime is respected, and Type.VARIANT's expireTime is not used. In general, we suggest the users to delete the stale products explicitly, instead of using this field to determine staleness. expire_time must be later than available_time and publish_time, otherwise an INVALID_ARGUMENT error is thrown. Corresponding properties: Google Merchant Center property [expiration_date](https://support.google.com/merchants/answer/6324499).
           "fulfillmentInfo": [ # Fulfillment information, such as the store IDs for in-store pickup or region IDs for different shipping methods. All the elements must have distinct FulfillmentInfo.type. Otherwise, an INVALID_ARGUMENT error is returned.
             { # Fulfillment information, such as the store IDs for in-store pickup or region IDs for different shipping methods.
               "placeIds": [ # The IDs for this type, such as the store IDs for FulfillmentInfo.type.pickup-in-store or the region IDs for FulfillmentInfo.type.same-day-delivery. A maximum of 3000 values are allowed. Each value must be a string with a length limit of 30 characters, matching the pattern `[a-zA-Z0-9_-]+`, such as "store1" or "REGION-2". Otherwise, an INVALID_ARGUMENT error is returned.
@@ -1167,7 +1167,7 @@ 
Method Details

         "A String",
       ],
       "description": "A String", # Product description. This field must be a UTF-8 encoded string with a length limit of 5,000 characters. Otherwise, an INVALID_ARGUMENT error is returned. Corresponding properties: Google Merchant Center property [description](https://support.google.com/merchants/answer/6324468). Schema.org property [Product.description](https://schema.org/description).
-      "expireTime": "A String", # Note that this field is applied in the following ways: * If the Product is already expired when it is uploaded, this product is not indexed for search. * If the Product is not expired when it is uploaded, only the Type.PRIMARY's and Type.COLLECTION's expireTime is respected, and Type.VARIANT's expireTime is not used. In general, we suggest the users to delete the stale products explicitly, instead of using this field to determine staleness. expire_time must be later than available_time and publish_time, otherwise an INVALID_ARGUMENT error is thrown. Corresponding properties: Google Merchant Center property [expiration_date](https://support.google.com/merchants/answer/6324499).
+      "expireTime": "A String", # The timestamp when this product becomes unavailable for SearchService.Search. If it is set, the Product is not available for SearchService.Search after expire_time. However, the product can still be retrieved by ProductService.GetProduct and ProductService.ListProducts. Note that this field is applied in the following ways: * If the Product is already expired when it is uploaded, this product is not indexed for search. * If the Product is not expired when it is uploaded, only the Type.PRIMARY's and Type.COLLECTION's expireTime is respected, and Type.VARIANT's expireTime is not used. In general, we suggest the users to delete the stale products explicitly, instead of using this field to determine staleness. expire_time must be later than available_time and publish_time, otherwise an INVALID_ARGUMENT error is thrown. Corresponding properties: Google Merchant Center property [expiration_date](https://support.google.com/merchants/answer/6324499).
       "fulfillmentInfo": [ # Fulfillment information, such as the store IDs for in-store pickup or region IDs for different shipping methods. All the elements must have distinct FulfillmentInfo.type. Otherwise, an INVALID_ARGUMENT error is returned.
         { # Fulfillment information, such as the store IDs for in-store pickup or region IDs for different shipping methods.
           "placeIds": [ # The IDs for this type, such as the store IDs for FulfillmentInfo.type.pickup-in-store or the region IDs for FulfillmentInfo.type.same-day-delivery. A maximum of 3000 values are allowed. Each value must be a string with a length limit of 30 characters, matching the pattern `[a-zA-Z0-9_-]+`, such as "store1" or "REGION-2". Otherwise, an INVALID_ARGUMENT error is returned.
@@ -1360,7 +1360,7 @@ 
Method Details

     "A String",
   ],
   "description": "A String", # Product description. This field must be a UTF-8 encoded string with a length limit of 5,000 characters. Otherwise, an INVALID_ARGUMENT error is returned. Corresponding properties: Google Merchant Center property [description](https://support.google.com/merchants/answer/6324468). Schema.org property [Product.description](https://schema.org/description).
-  "expireTime": "A String", # Note that this field is applied in the following ways: * If the Product is already expired when it is uploaded, this product is not indexed for search. * If the Product is not expired when it is uploaded, only the Type.PRIMARY's and Type.COLLECTION's expireTime is respected, and Type.VARIANT's expireTime is not used. In general, we suggest the users to delete the stale products explicitly, instead of using this field to determine staleness. expire_time must be later than available_time and publish_time, otherwise an INVALID_ARGUMENT error is thrown. Corresponding properties: Google Merchant Center property [expiration_date](https://support.google.com/merchants/answer/6324499).
+  "expireTime": "A String", # The timestamp when this product becomes unavailable for SearchService.Search. If it is set, the Product is not available for SearchService.Search after expire_time. However, the product can still be retrieved by ProductService.GetProduct and ProductService.ListProducts. Note that this field is applied in the following ways: * If the Product is already expired when it is uploaded, this product is not indexed for search. * If the Product is not expired when it is uploaded, only the Type.PRIMARY's and Type.COLLECTION's expireTime is respected, and Type.VARIANT's expireTime is not used. In general, we suggest the users to delete the stale products explicitly, instead of using this field to determine staleness. expire_time must be later than available_time and publish_time, otherwise an INVALID_ARGUMENT error is thrown. Corresponding properties: Google Merchant Center property [expiration_date](https://support.google.com/merchants/answer/6324499).
   "fulfillmentInfo": [ # Fulfillment information, such as the store IDs for in-store pickup or region IDs for different shipping methods. All the elements must have distinct FulfillmentInfo.type. Otherwise, an INVALID_ARGUMENT error is returned.
     { # Fulfillment information, such as the store IDs for in-store pickup or region IDs for different shipping methods.
       "placeIds": [ # The IDs for this type, such as the store IDs for FulfillmentInfo.type.pickup-in-store or the region IDs for FulfillmentInfo.type.same-day-delivery. A maximum of 3000 values are allowed. Each value must be a string with a length limit of 30 characters, matching the pattern `[a-zA-Z0-9_-]+`, such as "store1" or "REGION-2". Otherwise, an INVALID_ARGUMENT error is returned.
@@ -1536,7 +1536,7 @@ 
Method Details

     "A String",
   ],
   "description": "A String", # Product description. This field must be a UTF-8 encoded string with a length limit of 5,000 characters. Otherwise, an INVALID_ARGUMENT error is returned. Corresponding properties: Google Merchant Center property [description](https://support.google.com/merchants/answer/6324468). Schema.org property [Product.description](https://schema.org/description).
-  "expireTime": "A String", # Note that this field is applied in the following ways: * If the Product is already expired when it is uploaded, this product is not indexed for search. * If the Product is not expired when it is uploaded, only the Type.PRIMARY's and Type.COLLECTION's expireTime is respected, and Type.VARIANT's expireTime is not used. In general, we suggest the users to delete the stale products explicitly, instead of using this field to determine staleness. expire_time must be later than available_time and publish_time, otherwise an INVALID_ARGUMENT error is thrown. Corresponding properties: Google Merchant Center property [expiration_date](https://support.google.com/merchants/answer/6324499).
+  "expireTime": "A String", # The timestamp when this product becomes unavailable for SearchService.Search. If it is set, the Product is not available for SearchService.Search after expire_time. However, the product can still be retrieved by ProductService.GetProduct and ProductService.ListProducts. Note that this field is applied in the following ways: * If the Product is already expired when it is uploaded, this product is not indexed for search. * If the Product is not expired when it is uploaded, only the Type.PRIMARY's and Type.COLLECTION's expireTime is respected, and Type.VARIANT's expireTime is not used. In general, we suggest the users to delete the stale products explicitly, instead of using this field to determine staleness. expire_time must be later than available_time and publish_time, otherwise an INVALID_ARGUMENT error is thrown. Corresponding properties: Google Merchant Center property [expiration_date](https://support.google.com/merchants/answer/6324499).
   "fulfillmentInfo": [ # Fulfillment information, such as the store IDs for in-store pickup or region IDs for different shipping methods. All the elements must have distinct FulfillmentInfo.type. Otherwise, an INVALID_ARGUMENT error is returned.
     { # Fulfillment information, such as the store IDs for in-store pickup or region IDs for different shipping methods.
       "placeIds": [ # The IDs for this type, such as the store IDs for FulfillmentInfo.type.pickup-in-store or the region IDs for FulfillmentInfo.type.same-day-delivery. A maximum of 3000 values are allowed. Each value must be a string with a length limit of 30 characters, matching the pattern `[a-zA-Z0-9_-]+`, such as "store1" or "REGION-2". Otherwise, an INVALID_ARGUMENT error is returned.
@@ -1850,7 +1850,7 @@ 
Method Details

       "A String",
     ],
     "description": "A String", # Product description. This field must be a UTF-8 encoded string with a length limit of 5,000 characters. Otherwise, an INVALID_ARGUMENT error is returned. Corresponding properties: Google Merchant Center property [description](https://support.google.com/merchants/answer/6324468). Schema.org property [Product.description](https://schema.org/description).
-    "expireTime": "A String", # Note that this field is applied in the following ways: * If the Product is already expired when it is uploaded, this product is not indexed for search. * If the Product is not expired when it is uploaded, only the Type.PRIMARY's and Type.COLLECTION's expireTime is respected, and Type.VARIANT's expireTime is not used. In general, we suggest the users to delete the stale products explicitly, instead of using this field to determine staleness. expire_time must be later than available_time and publish_time, otherwise an INVALID_ARGUMENT error is thrown. Corresponding properties: Google Merchant Center property [expiration_date](https://support.google.com/merchants/answer/6324499).
+    "expireTime": "A String", # The timestamp when this product becomes unavailable for SearchService.Search. If it is set, the Product is not available for SearchService.Search after expire_time. However, the product can still be retrieved by ProductService.GetProduct and ProductService.ListProducts. Note that this field is applied in the following ways: * If the Product is already expired when it is uploaded, this product is not indexed for search. * If the Product is not expired when it is uploaded, only the Type.PRIMARY's and Type.COLLECTION's expireTime is respected, and Type.VARIANT's expireTime is not used. In general, we suggest the users to delete the stale products explicitly, instead of using this field to determine staleness. expire_time must be later than available_time and publish_time, otherwise an INVALID_ARGUMENT error is thrown. Corresponding properties: Google Merchant Center property [expiration_date](https://support.google.com/merchants/answer/6324499).
     "fulfillmentInfo": [ # Fulfillment information, such as the store IDs for in-store pickup or region IDs for different shipping methods. All the elements must have distinct FulfillmentInfo.type. Otherwise, an INVALID_ARGUMENT error is returned.
       { # Fulfillment information, such as the store IDs for in-store pickup or region IDs for different shipping methods.
         "placeIds": [ # The IDs for this type, such as the store IDs for FulfillmentInfo.type.pickup-in-store or the region IDs for FulfillmentInfo.type.same-day-delivery. A maximum of 3000 values are allowed. Each value must be a string with a length limit of 30 characters, matching the pattern `[a-zA-Z0-9_-]+`, such as "store1" or "REGION-2". Otherwise, an INVALID_ARGUMENT error is returned.
diff --git a/docs/dyn/retail_v2alpha.projects.locations.catalogs.placements.html b/docs/dyn/retail_v2alpha.projects.locations.catalogs.placements.html
index 99248bad22..6d515637c7 100644
--- a/docs/dyn/retail_v2alpha.projects.locations.catalogs.placements.html
+++ b/docs/dyn/retail_v2alpha.projects.locations.catalogs.placements.html
@@ -315,7 +315,7 @@ 
Method Details

                 "A String",
               ],
               "description": "A String", # Product description. This field must be a UTF-8 encoded string with a length limit of 5,000 characters. Otherwise, an INVALID_ARGUMENT error is returned. Corresponding properties: Google Merchant Center property [description](https://support.google.com/merchants/answer/6324468). Schema.org property [Product.description](https://schema.org/description).
-              "expireTime": "A String", # Note that this field is applied in the following ways: * If the Product is already expired when it is uploaded, this product is not indexed for search. * If the Product is not expired when it is uploaded, only the Type.PRIMARY's and Type.COLLECTION's expireTime is respected, and Type.VARIANT's expireTime is not used. In general, we suggest the users to delete the stale products explicitly, instead of using this field to determine staleness. expire_time must be later than available_time and publish_time, otherwise an INVALID_ARGUMENT error is thrown. Corresponding properties: Google Merchant Center property [expiration_date](https://support.google.com/merchants/answer/6324499).
+              "expireTime": "A String", # The timestamp when this product becomes unavailable for SearchService.Search. If it is set, the Product is not available for SearchService.Search after expire_time. However, the product can still be retrieved by ProductService.GetProduct and ProductService.ListProducts. Note that this field is applied in the following ways: * If the Product is already expired when it is uploaded, this product is not indexed for search. * If the Product is not expired when it is uploaded, only the Type.PRIMARY's and Type.COLLECTION's expireTime is respected, and Type.VARIANT's expireTime is not used. In general, we suggest the users to delete the stale products explicitly, instead of using this field to determine staleness. expire_time must be later than available_time and publish_time, otherwise an INVALID_ARGUMENT error is thrown. Corresponding properties: Google Merchant Center property [expiration_date](https://support.google.com/merchants/answer/6324499).
               "fulfillmentInfo": [ # Fulfillment information, such as the store IDs for in-store pickup or region IDs for different shipping methods. All the elements must have distinct FulfillmentInfo.type. Otherwise, an INVALID_ARGUMENT error is returned.
                 { # Fulfillment information, such as the store IDs for in-store pickup or region IDs for different shipping methods.
                   "placeIds": [ # The IDs for this type, such as the store IDs for FulfillmentInfo.type.pickup-in-store or the region IDs for FulfillmentInfo.type.same-day-delivery. A maximum of 3000 values are allowed. Each value must be a string with a length limit of 30 characters, matching the pattern `[a-zA-Z0-9_-]+`, such as "store1" or "REGION-2". Otherwise, an INVALID_ARGUMENT error is returned.
@@ -488,7 +488,7 @@ 
Method Details

             "A String",
           ],
           "description": "A String", # Product description. This field must be a UTF-8 encoded string with a length limit of 5,000 characters. Otherwise, an INVALID_ARGUMENT error is returned. Corresponding properties: Google Merchant Center property [description](https://support.google.com/merchants/answer/6324468). Schema.org property [Product.description](https://schema.org/description).
-          "expireTime": "A String", # Note that this field is applied in the following ways: * If the Product is already expired when it is uploaded, this product is not indexed for search. * If the Product is not expired when it is uploaded, only the Type.PRIMARY's and Type.COLLECTION's expireTime is respected, and Type.VARIANT's expireTime is not used. In general, we suggest the users to delete the stale products explicitly, instead of using this field to determine staleness. expire_time must be later than available_time and publish_time, otherwise an INVALID_ARGUMENT error is thrown. Corresponding properties: Google Merchant Center property [expiration_date](https://support.google.com/merchants/answer/6324499).
+          "expireTime": "A String", # The timestamp when this product becomes unavailable for SearchService.Search. If it is set, the Product is not available for SearchService.Search after expire_time. However, the product can still be retrieved by ProductService.GetProduct and ProductService.ListProducts. Note that this field is applied in the following ways: * If the Product is already expired when it is uploaded, this product is not indexed for search. * If the Product is not expired when it is uploaded, only the Type.PRIMARY's and Type.COLLECTION's expireTime is respected, and Type.VARIANT's expireTime is not used. In general, we suggest the users to delete the stale products explicitly, instead of using this field to determine staleness. expire_time must be later than available_time and publish_time, otherwise an INVALID_ARGUMENT error is thrown. Corresponding properties: Google Merchant Center property [expiration_date](https://support.google.com/merchants/answer/6324499).
           "fulfillmentInfo": [ # Fulfillment information, such as the store IDs for in-store pickup or region IDs for different shipping methods. All the elements must have distinct FulfillmentInfo.type. Otherwise, an INVALID_ARGUMENT error is returned.
             { # Fulfillment information, such as the store IDs for in-store pickup or region IDs for different shipping methods.
               "placeIds": [ # The IDs for this type, such as the store IDs for FulfillmentInfo.type.pickup-in-store or the region IDs for FulfillmentInfo.type.same-day-delivery. A maximum of 3000 values are allowed. Each value must be a string with a length limit of 30 characters, matching the pattern `[a-zA-Z0-9_-]+`, such as "store1" or "REGION-2". Otherwise, an INVALID_ARGUMENT error is returned.
@@ -1067,7 +1067,7 @@ 
Method Details

           "A String",
         ],
         "description": "A String", # Product description. This field must be a UTF-8 encoded string with a length limit of 5,000 characters. Otherwise, an INVALID_ARGUMENT error is returned. Corresponding properties: Google Merchant Center property [description](https://support.google.com/merchants/answer/6324468). Schema.org property [Product.description](https://schema.org/description).
-        "expireTime": "A String", # Note that this field is applied in the following ways: * If the Product is already expired when it is uploaded, this product is not indexed for search. * If the Product is not expired when it is uploaded, only the Type.PRIMARY's and Type.COLLECTION's expireTime is respected, and Type.VARIANT's expireTime is not used. In general, we suggest the users to delete the stale products explicitly, instead of using this field to determine staleness. expire_time must be later than available_time and publish_time, otherwise an INVALID_ARGUMENT error is thrown. Corresponding properties: Google Merchant Center property [expiration_date](https://support.google.com/merchants/answer/6324499).
+        "expireTime": "A String", # The timestamp when this product becomes unavailable for SearchService.Search. If it is set, the Product is not available for SearchService.Search after expire_time. However, the product can still be retrieved by ProductService.GetProduct and ProductService.ListProducts. Note that this field is applied in the following ways: * If the Product is already expired when it is uploaded, this product is not indexed for search. * If the Product is not expired when it is uploaded, only the Type.PRIMARY's and Type.COLLECTION's expireTime is respected, and Type.VARIANT's expireTime is not used. In general, we suggest the users to delete the stale products explicitly, instead of using this field to determine staleness. expire_time must be later than available_time and publish_time, otherwise an INVALID_ARGUMENT error is thrown. Corresponding properties: Google Merchant Center property [expiration_date](https://support.google.com/merchants/answer/6324499).
         "fulfillmentInfo": [ # Fulfillment information, such as the store IDs for in-store pickup or region IDs for different shipping methods. All the elements must have distinct FulfillmentInfo.type. Otherwise, an INVALID_ARGUMENT error is returned.
           { # Fulfillment information, such as the store IDs for in-store pickup or region IDs for different shipping methods.
             "placeIds": [ # The IDs for this type, such as the store IDs for FulfillmentInfo.type.pickup-in-store or the region IDs for FulfillmentInfo.type.same-day-delivery. A maximum of 3000 values are allowed. Each value must be a string with a length limit of 30 characters, matching the pattern `[a-zA-Z0-9_-]+`, such as "store1" or "REGION-2". Otherwise, an INVALID_ARGUMENT error is returned.
diff --git a/docs/dyn/retail_v2alpha.projects.locations.catalogs.servingConfigs.html b/docs/dyn/retail_v2alpha.projects.locations.catalogs.servingConfigs.html
index 6a21cbb946..d9302c7ca6 100644
--- a/docs/dyn/retail_v2alpha.projects.locations.catalogs.servingConfigs.html
+++ b/docs/dyn/retail_v2alpha.projects.locations.catalogs.servingConfigs.html
@@ -797,7 +797,7 @@ 
Method Details

                 "A String",
               ],
               "description": "A String", # Product description. This field must be a UTF-8 encoded string with a length limit of 5,000 characters. Otherwise, an INVALID_ARGUMENT error is returned. Corresponding properties: Google Merchant Center property [description](https://support.google.com/merchants/answer/6324468). Schema.org property [Product.description](https://schema.org/description).
-              "expireTime": "A String", # Note that this field is applied in the following ways: * If the Product is already expired when it is uploaded, this product is not indexed for search. * If the Product is not expired when it is uploaded, only the Type.PRIMARY's and Type.COLLECTION's expireTime is respected, and Type.VARIANT's expireTime is not used. In general, we suggest the users to delete the stale products explicitly, instead of using this field to determine staleness. expire_time must be later than available_time and publish_time, otherwise an INVALID_ARGUMENT error is thrown. Corresponding properties: Google Merchant Center property [expiration_date](https://support.google.com/merchants/answer/6324499).
+              "expireTime": "A String", # The timestamp when this product becomes unavailable for SearchService.Search. If it is set, the Product is not available for SearchService.Search after expire_time. However, the product can still be retrieved by ProductService.GetProduct and ProductService.ListProducts. Note that this field is applied in the following ways: * If the Product is already expired when it is uploaded, this product is not indexed for search. * If the Product is not expired when it is uploaded, only the Type.PRIMARY's and Type.COLLECTION's expireTime is respected, and Type.VARIANT's expireTime is not used. In general, we suggest the users to delete the stale products explicitly, instead of using this field to determine staleness. expire_time must be later than available_time and publish_time, otherwise an INVALID_ARGUMENT error is thrown. Corresponding properties: Google Merchant Center property [expiration_date](https://support.google.com/merchants/answer/6324499).
               "fulfillmentInfo": [ # Fulfillment information, such as the store IDs for in-store pickup or region IDs for different shipping methods. All the elements must have distinct FulfillmentInfo.type. Otherwise, an INVALID_ARGUMENT error is returned.
                 { # Fulfillment information, such as the store IDs for in-store pickup or region IDs for different shipping methods.
                   "placeIds": [ # The IDs for this type, such as the store IDs for FulfillmentInfo.type.pickup-in-store or the region IDs for FulfillmentInfo.type.same-day-delivery. A maximum of 3000 values are allowed. Each value must be a string with a length limit of 30 characters, matching the pattern `[a-zA-Z0-9_-]+`, such as "store1" or "REGION-2". Otherwise, an INVALID_ARGUMENT error is returned.
@@ -970,7 +970,7 @@ 
Method Details

             "A String",
           ],
           "description": "A String", # Product description. This field must be a UTF-8 encoded string with a length limit of 5,000 characters. Otherwise, an INVALID_ARGUMENT error is returned. Corresponding properties: Google Merchant Center property [description](https://support.google.com/merchants/answer/6324468). Schema.org property [Product.description](https://schema.org/description).
-          "expireTime": "A String", # Note that this field is applied in the following ways: * If the Product is already expired when it is uploaded, this product is not indexed for search. * If the Product is not expired when it is uploaded, only the Type.PRIMARY's and Type.COLLECTION's expireTime is respected, and Type.VARIANT's expireTime is not used. In general, we suggest the users to delete the stale products explicitly, instead of using this field to determine staleness. expire_time must be later than available_time and publish_time, otherwise an INVALID_ARGUMENT error is thrown. Corresponding properties: Google Merchant Center property [expiration_date](https://support.google.com/merchants/answer/6324499).
+          "expireTime": "A String", # The timestamp when this product becomes unavailable for SearchService.Search. If it is set, the Product is not available for SearchService.Search after expire_time. However, the product can still be retrieved by ProductService.GetProduct and ProductService.ListProducts. Note that this field is applied in the following ways: * If the Product is already expired when it is uploaded, this product is not indexed for search. * If the Product is not expired when it is uploaded, only the Type.PRIMARY's and Type.COLLECTION's expireTime is respected, and Type.VARIANT's expireTime is not used. In general, we suggest the users to delete the stale products explicitly, instead of using this field to determine staleness. expire_time must be later than available_time and publish_time, otherwise an INVALID_ARGUMENT error is thrown. Corresponding properties: Google Merchant Center property [expiration_date](https://support.google.com/merchants/answer/6324499).
           "fulfillmentInfo": [ # Fulfillment information, such as the store IDs for in-store pickup or region IDs for different shipping methods. All the elements must have distinct FulfillmentInfo.type. Otherwise, an INVALID_ARGUMENT error is returned.
             { # Fulfillment information, such as the store IDs for in-store pickup or region IDs for different shipping methods.
               "placeIds": [ # The IDs for this type, such as the store IDs for FulfillmentInfo.type.pickup-in-store or the region IDs for FulfillmentInfo.type.same-day-delivery. A maximum of 3000 values are allowed. Each value must be a string with a length limit of 30 characters, matching the pattern `[a-zA-Z0-9_-]+`, such as "store1" or "REGION-2". Otherwise, an INVALID_ARGUMENT error is returned.
@@ -1618,7 +1618,7 @@ 
Method Details

           "A String",
         ],
         "description": "A String", # Product description. This field must be a UTF-8 encoded string with a length limit of 5,000 characters. Otherwise, an INVALID_ARGUMENT error is returned. Corresponding properties: Google Merchant Center property [description](https://support.google.com/merchants/answer/6324468). Schema.org property [Product.description](https://schema.org/description).
-        "expireTime": "A String", # Note that this field is applied in the following ways: * If the Product is already expired when it is uploaded, this product is not indexed for search. * If the Product is not expired when it is uploaded, only the Type.PRIMARY's and Type.COLLECTION's expireTime is respected, and Type.VARIANT's expireTime is not used. In general, we suggest the users to delete the stale products explicitly, instead of using this field to determine staleness. expire_time must be later than available_time and publish_time, otherwise an INVALID_ARGUMENT error is thrown. Corresponding properties: Google Merchant Center property [expiration_date](https://support.google.com/merchants/answer/6324499).
+        "expireTime": "A String", # The timestamp when this product becomes unavailable for SearchService.Search. If it is set, the Product is not available for SearchService.Search after expire_time. However, the product can still be retrieved by ProductService.GetProduct and ProductService.ListProducts. Note that this field is applied in the following ways: * If the Product is already expired when it is uploaded, this product is not indexed for search. * If the Product is not expired when it is uploaded, only the Type.PRIMARY's and Type.COLLECTION's expireTime is respected, and Type.VARIANT's expireTime is not used. In general, we suggest the users to delete the stale products explicitly, instead of using this field to determine staleness. expire_time must be later than available_time and publish_time, otherwise an INVALID_ARGUMENT error is thrown. Corresponding properties: Google Merchant Center property [expiration_date](https://support.google.com/merchants/answer/6324499).
         "fulfillmentInfo": [ # Fulfillment information, such as the store IDs for in-store pickup or region IDs for different shipping methods. All the elements must have distinct FulfillmentInfo.type. Otherwise, an INVALID_ARGUMENT error is returned.
           { # Fulfillment information, such as the store IDs for in-store pickup or region IDs for different shipping methods.
             "placeIds": [ # The IDs for this type, such as the store IDs for FulfillmentInfo.type.pickup-in-store or the region IDs for FulfillmentInfo.type.same-day-delivery. A maximum of 3000 values are allowed. Each value must be a string with a length limit of 30 characters, matching the pattern `[a-zA-Z0-9_-]+`, such as "store1" or "REGION-2". Otherwise, an INVALID_ARGUMENT error is returned.
diff --git a/docs/dyn/retail_v2alpha.projects.locations.catalogs.userEvents.html b/docs/dyn/retail_v2alpha.projects.locations.catalogs.userEvents.html
index 9d0b0d00b7..0f7d724965 100644
--- a/docs/dyn/retail_v2alpha.projects.locations.catalogs.userEvents.html
+++ b/docs/dyn/retail_v2alpha.projects.locations.catalogs.userEvents.html
@@ -309,7 +309,7 @@ 
Method Details

                       "A String",
                     ],
                     "description": "A String", # Product description. This field must be a UTF-8 encoded string with a length limit of 5,000 characters. Otherwise, an INVALID_ARGUMENT error is returned. Corresponding properties: Google Merchant Center property [description](https://support.google.com/merchants/answer/6324468). Schema.org property [Product.description](https://schema.org/description).
-                    "expireTime": "A String", # Note that this field is applied in the following ways: * If the Product is already expired when it is uploaded, this product is not indexed for search. * If the Product is not expired when it is uploaded, only the Type.PRIMARY's and Type.COLLECTION's expireTime is respected, and Type.VARIANT's expireTime is not used. In general, we suggest the users to delete the stale products explicitly, instead of using this field to determine staleness. expire_time must be later than available_time and publish_time, otherwise an INVALID_ARGUMENT error is thrown. Corresponding properties: Google Merchant Center property [expiration_date](https://support.google.com/merchants/answer/6324499).
+                    "expireTime": "A String", # The timestamp when this product becomes unavailable for SearchService.Search. If it is set, the Product is not available for SearchService.Search after expire_time. However, the product can still be retrieved by ProductService.GetProduct and ProductService.ListProducts. Note that this field is applied in the following ways: * If the Product is already expired when it is uploaded, this product is not indexed for search. * If the Product is not expired when it is uploaded, only the Type.PRIMARY's and Type.COLLECTION's expireTime is respected, and Type.VARIANT's expireTime is not used. In general, we suggest the users to delete the stale products explicitly, instead of using this field to determine staleness. expire_time must be later than available_time and publish_time, otherwise an INVALID_ARGUMENT error is thrown. Corresponding properties: Google Merchant Center property [expiration_date](https://support.google.com/merchants/answer/6324499).
                     "fulfillmentInfo": [ # Fulfillment information, such as the store IDs for in-store pickup or region IDs for different shipping methods. All the elements must have distinct FulfillmentInfo.type. Otherwise, an INVALID_ARGUMENT error is returned.
                       { # Fulfillment information, such as the store IDs for in-store pickup or region IDs for different shipping methods.
                         "placeIds": [ # The IDs for this type, such as the store IDs for FulfillmentInfo.type.pickup-in-store or the region IDs for FulfillmentInfo.type.same-day-delivery. A maximum of 3000 values are allowed. Each value must be a string with a length limit of 30 characters, matching the pattern `[a-zA-Z0-9_-]+`, such as "store1" or "REGION-2". Otherwise, an INVALID_ARGUMENT error is returned.
@@ -482,7 +482,7 @@ 
Method Details

                   "A String",
                 ],
                 "description": "A String", # Product description. This field must be a UTF-8 encoded string with a length limit of 5,000 characters. Otherwise, an INVALID_ARGUMENT error is returned. Corresponding properties: Google Merchant Center property [description](https://support.google.com/merchants/answer/6324468). Schema.org property [Product.description](https://schema.org/description).
-                "expireTime": "A String", # Note that this field is applied in the following ways: * If the Product is already expired when it is uploaded, this product is not indexed for search. * If the Product is not expired when it is uploaded, only the Type.PRIMARY's and Type.COLLECTION's expireTime is respected, and Type.VARIANT's expireTime is not used. In general, we suggest the users to delete the stale products explicitly, instead of using this field to determine staleness. expire_time must be later than available_time and publish_time, otherwise an INVALID_ARGUMENT error is thrown. Corresponding properties: Google Merchant Center property [expiration_date](https://support.google.com/merchants/answer/6324499).
+                "expireTime": "A String", # The timestamp when this product becomes unavailable for SearchService.Search. If it is set, the Product is not available for SearchService.Search after expire_time. However, the product can still be retrieved by ProductService.GetProduct and ProductService.ListProducts. Note that this field is applied in the following ways: * If the Product is already expired when it is uploaded, this product is not indexed for search. * If the Product is not expired when it is uploaded, only the Type.PRIMARY's and Type.COLLECTION's expireTime is respected, and Type.VARIANT's expireTime is not used. In general, we suggest the users to delete the stale products explicitly, instead of using this field to determine staleness. expire_time must be later than available_time and publish_time, otherwise an INVALID_ARGUMENT error is thrown. Corresponding properties: Google Merchant Center property [expiration_date](https://support.google.com/merchants/answer/6324499).
                 "fulfillmentInfo": [ # Fulfillment information, such as the store IDs for in-store pickup or region IDs for different shipping methods. All the elements must have distinct FulfillmentInfo.type. Otherwise, an INVALID_ARGUMENT error is returned.
                   { # Fulfillment information, such as the store IDs for in-store pickup or region IDs for different shipping methods.
                     "placeIds": [ # The IDs for this type, such as the store IDs for FulfillmentInfo.type.pickup-in-store or the region IDs for FulfillmentInfo.type.same-day-delivery. A maximum of 3000 values are allowed. Each value must be a string with a length limit of 30 characters, matching the pattern `[a-zA-Z0-9_-]+`, such as "store1" or "REGION-2". Otherwise, an INVALID_ARGUMENT error is returned.
@@ -838,7 +838,7 @@ 
Method Details

               "A String",
             ],
             "description": "A String", # Product description. This field must be a UTF-8 encoded string with a length limit of 5,000 characters. Otherwise, an INVALID_ARGUMENT error is returned. Corresponding properties: Google Merchant Center property [description](https://support.google.com/merchants/answer/6324468). Schema.org property [Product.description](https://schema.org/description).
-            "expireTime": "A String", # Note that this field is applied in the following ways: * If the Product is already expired when it is uploaded, this product is not indexed for search. * If the Product is not expired when it is uploaded, only the Type.PRIMARY's and Type.COLLECTION's expireTime is respected, and Type.VARIANT's expireTime is not used. In general, we suggest the users to delete the stale products explicitly, instead of using this field to determine staleness. expire_time must be later than available_time and publish_time, otherwise an INVALID_ARGUMENT error is thrown. Corresponding properties: Google Merchant Center property [expiration_date](https://support.google.com/merchants/answer/6324499).
+            "expireTime": "A String", # The timestamp when this product becomes unavailable for SearchService.Search. If it is set, the Product is not available for SearchService.Search after expire_time. However, the product can still be retrieved by ProductService.GetProduct and ProductService.ListProducts. Note that this field is applied in the following ways: * If the Product is already expired when it is uploaded, this product is not indexed for search. * If the Product is not expired when it is uploaded, only the Type.PRIMARY's and Type.COLLECTION's expireTime is respected, and Type.VARIANT's expireTime is not used. In general, we suggest the users to delete the stale products explicitly, instead of using this field to determine staleness. expire_time must be later than available_time and publish_time, otherwise an INVALID_ARGUMENT error is thrown. Corresponding properties: Google Merchant Center property [expiration_date](https://support.google.com/merchants/answer/6324499).
             "fulfillmentInfo": [ # Fulfillment information, such as the store IDs for in-store pickup or region IDs for different shipping methods. All the elements must have distinct FulfillmentInfo.type. Otherwise, an INVALID_ARGUMENT error is returned.
               { # Fulfillment information, such as the store IDs for in-store pickup or region IDs for different shipping methods.
                 "placeIds": [ # The IDs for this type, such as the store IDs for FulfillmentInfo.type.pickup-in-store or the region IDs for FulfillmentInfo.type.same-day-delivery. A maximum of 3000 values are allowed. Each value must be a string with a length limit of 30 characters, matching the pattern `[a-zA-Z0-9_-]+`, such as "store1" or "REGION-2". Otherwise, an INVALID_ARGUMENT error is returned.
@@ -1011,7 +1011,7 @@ 
Method Details

           "A String",
         ],
         "description": "A String", # Product description. This field must be a UTF-8 encoded string with a length limit of 5,000 characters. Otherwise, an INVALID_ARGUMENT error is returned. Corresponding properties: Google Merchant Center property [description](https://support.google.com/merchants/answer/6324468). Schema.org property [Product.description](https://schema.org/description).
-        "expireTime": "A String", # Note that this field is applied in the following ways: * If the Product is already expired when it is uploaded, this product is not indexed for search. * If the Product is not expired when it is uploaded, only the Type.PRIMARY's and Type.COLLECTION's expireTime is respected, and Type.VARIANT's expireTime is not used. In general, we suggest the users to delete the stale products explicitly, instead of using this field to determine staleness. expire_time must be later than available_time and publish_time, otherwise an INVALID_ARGUMENT error is thrown. Corresponding properties: Google Merchant Center property [expiration_date](https://support.google.com/merchants/answer/6324499).
+        "expireTime": "A String", # The timestamp when this product becomes unavailable for SearchService.Search. If it is set, the Product is not available for SearchService.Search after expire_time. However, the product can still be retrieved by ProductService.GetProduct and ProductService.ListProducts. Note that this field is applied in the following ways: * If the Product is already expired when it is uploaded, this product is not indexed for search. * If the Product is not expired when it is uploaded, only the Type.PRIMARY's and Type.COLLECTION's expireTime is respected, and Type.VARIANT's expireTime is not used. In general, we suggest the users to delete the stale products explicitly, instead of using this field to determine staleness. expire_time must be later than available_time and publish_time, otherwise an INVALID_ARGUMENT error is thrown. Corresponding properties: Google Merchant Center property [expiration_date](https://support.google.com/merchants/answer/6324499).
         "fulfillmentInfo": [ # Fulfillment information, such as the store IDs for in-store pickup or region IDs for different shipping methods. All the elements must have distinct FulfillmentInfo.type. Otherwise, an INVALID_ARGUMENT error is returned.
           { # Fulfillment information, such as the store IDs for in-store pickup or region IDs for different shipping methods.
             "placeIds": [ # The IDs for this type, such as the store IDs for FulfillmentInfo.type.pickup-in-store or the region IDs for FulfillmentInfo.type.same-day-delivery. A maximum of 3000 values are allowed. Each value must be a string with a length limit of 30 characters, matching the pattern `[a-zA-Z0-9_-]+`, such as "store1" or "REGION-2". Otherwise, an INVALID_ARGUMENT error is returned.
@@ -1249,7 +1249,7 @@ 
Method Details

               "A String",
             ],
             "description": "A String", # Product description. This field must be a UTF-8 encoded string with a length limit of 5,000 characters. Otherwise, an INVALID_ARGUMENT error is returned. Corresponding properties: Google Merchant Center property [description](https://support.google.com/merchants/answer/6324468). Schema.org property [Product.description](https://schema.org/description).
-            "expireTime": "A String", # Note that this field is applied in the following ways: * If the Product is already expired when it is uploaded, this product is not indexed for search. * If the Product is not expired when it is uploaded, only the Type.PRIMARY's and Type.COLLECTION's expireTime is respected, and Type.VARIANT's expireTime is not used. In general, we suggest the users to delete the stale products explicitly, instead of using this field to determine staleness. expire_time must be later than available_time and publish_time, otherwise an INVALID_ARGUMENT error is thrown. Corresponding properties: Google Merchant Center property [expiration_date](https://support.google.com/merchants/answer/6324499).
+            "expireTime": "A String", # The timestamp when this product becomes unavailable for SearchService.Search. If it is set, the Product is not available for SearchService.Search after expire_time. However, the product can still be retrieved by ProductService.GetProduct and ProductService.ListProducts. Note that this field is applied in the following ways: * If the Product is already expired when it is uploaded, this product is not indexed for search. * If the Product is not expired when it is uploaded, only the Type.PRIMARY's and Type.COLLECTION's expireTime is respected, and Type.VARIANT's expireTime is not used. In general, we suggest the users to delete the stale products explicitly, instead of using this field to determine staleness. expire_time must be later than available_time and publish_time, otherwise an INVALID_ARGUMENT error is thrown. Corresponding properties: Google Merchant Center property [expiration_date](https://support.google.com/merchants/answer/6324499).
             "fulfillmentInfo": [ # Fulfillment information, such as the store IDs for in-store pickup or region IDs for different shipping methods. All the elements must have distinct FulfillmentInfo.type. Otherwise, an INVALID_ARGUMENT error is returned.
               { # Fulfillment information, such as the store IDs for in-store pickup or region IDs for different shipping methods.
                 "placeIds": [ # The IDs for this type, such as the store IDs for FulfillmentInfo.type.pickup-in-store or the region IDs for FulfillmentInfo.type.same-day-delivery. A maximum of 3000 values are allowed. Each value must be a string with a length limit of 30 characters, matching the pattern `[a-zA-Z0-9_-]+`, such as "store1" or "REGION-2". Otherwise, an INVALID_ARGUMENT error is returned.
@@ -1422,7 +1422,7 @@ 
Method Details

           "A String",
         ],
         "description": "A String", # Product description. This field must be a UTF-8 encoded string with a length limit of 5,000 characters. Otherwise, an INVALID_ARGUMENT error is returned. Corresponding properties: Google Merchant Center property [description](https://support.google.com/merchants/answer/6324468). Schema.org property [Product.description](https://schema.org/description).
-        "expireTime": "A String", # Note that this field is applied in the following ways: * If the Product is already expired when it is uploaded, this product is not indexed for search. * If the Product is not expired when it is uploaded, only the Type.PRIMARY's and Type.COLLECTION's expireTime is respected, and Type.VARIANT's expireTime is not used. In general, we suggest the users to delete the stale products explicitly, instead of using this field to determine staleness. expire_time must be later than available_time and publish_time, otherwise an INVALID_ARGUMENT error is thrown. Corresponding properties: Google Merchant Center property [expiration_date](https://support.google.com/merchants/answer/6324499).
+        "expireTime": "A String", # The timestamp when this product becomes unavailable for SearchService.Search. If it is set, the Product is not available for SearchService.Search after expire_time. However, the product can still be retrieved by ProductService.GetProduct and ProductService.ListProducts. Note that this field is applied in the following ways: * If the Product is already expired when it is uploaded, this product is not indexed for search. * If the Product is not expired when it is uploaded, only the Type.PRIMARY's and Type.COLLECTION's expireTime is respected, and Type.VARIANT's expireTime is not used. In general, we suggest the users to delete the stale products explicitly, instead of using this field to determine staleness. expire_time must be later than available_time and publish_time, otherwise an INVALID_ARGUMENT error is thrown. Corresponding properties: Google Merchant Center property [expiration_date](https://support.google.com/merchants/answer/6324499).
         "fulfillmentInfo": [ # Fulfillment information, such as the store IDs for in-store pickup or region IDs for different shipping methods. All the elements must have distinct FulfillmentInfo.type. Otherwise, an INVALID_ARGUMENT error is returned.
           { # Fulfillment information, such as the store IDs for in-store pickup or region IDs for different shipping methods.
             "placeIds": [ # The IDs for this type, such as the store IDs for FulfillmentInfo.type.pickup-in-store or the region IDs for FulfillmentInfo.type.same-day-delivery. A maximum of 3000 values are allowed. Each value must be a string with a length limit of 30 characters, matching the pattern `[a-zA-Z0-9_-]+`, such as "store1" or "REGION-2". Otherwise, an INVALID_ARGUMENT error is returned.
diff --git a/docs/dyn/retail_v2beta.projects.locations.catalogs.branches.products.html b/docs/dyn/retail_v2beta.projects.locations.catalogs.branches.products.html
index 69eb0acd5a..045d3f4115 100644
--- a/docs/dyn/retail_v2beta.projects.locations.catalogs.branches.products.html
+++ b/docs/dyn/retail_v2beta.projects.locations.catalogs.branches.products.html
@@ -312,7 +312,7 @@ 
Method Details

     "A String",
   ],
   "description": "A String", # Product description. This field must be a UTF-8 encoded string with a length limit of 5,000 characters. Otherwise, an INVALID_ARGUMENT error is returned. Corresponding properties: Google Merchant Center property [description](https://support.google.com/merchants/answer/6324468). Schema.org property [Product.description](https://schema.org/description).
-  "expireTime": "A String", # Note that this field is applied in the following ways: * If the Product is already expired when it is uploaded, this product is not indexed for search. * If the Product is not expired when it is uploaded, only the Type.PRIMARY's and Type.COLLECTION's expireTime is respected, and Type.VARIANT's expireTime is not used. In general, we suggest the users to delete the stale products explicitly, instead of using this field to determine staleness. expire_time must be later than available_time and publish_time, otherwise an INVALID_ARGUMENT error is thrown. Corresponding properties: Google Merchant Center property [expiration_date](https://support.google.com/merchants/answer/6324499).
+  "expireTime": "A String", # The timestamp when this product becomes unavailable for SearchService.Search. If it is set, the Product is not available for SearchService.Search after expire_time. However, the product can still be retrieved by ProductService.GetProduct and ProductService.ListProducts. Note that this field is applied in the following ways: * If the Product is already expired when it is uploaded, this product is not indexed for search. * If the Product is not expired when it is uploaded, only the Type.PRIMARY's and Type.COLLECTION's expireTime is respected, and Type.VARIANT's expireTime is not used. In general, we suggest the users to delete the stale products explicitly, instead of using this field to determine staleness. expire_time must be later than available_time and publish_time, otherwise an INVALID_ARGUMENT error is thrown. Corresponding properties: Google Merchant Center property [expiration_date](https://support.google.com/merchants/answer/6324499).
   "fulfillmentInfo": [ # Fulfillment information, such as the store IDs for in-store pickup or region IDs for different shipping methods. All the elements must have distinct FulfillmentInfo.type. Otherwise, an INVALID_ARGUMENT error is returned.
     { # Fulfillment information, such as the store IDs for in-store pickup or region IDs for different shipping methods.
       "placeIds": [ # The IDs for this type, such as the store IDs for FulfillmentInfo.type.pickup-in-store or the region IDs for FulfillmentInfo.type.same-day-delivery. A maximum of 3000 values are allowed. Each value must be a string with a length limit of 30 characters, matching the pattern `[a-zA-Z0-9_-]+`, such as "store1" or "REGION-2". Otherwise, an INVALID_ARGUMENT error is returned.
@@ -486,7 +486,7 @@ 
Method Details

     "A String",
   ],
   "description": "A String", # Product description. This field must be a UTF-8 encoded string with a length limit of 5,000 characters. Otherwise, an INVALID_ARGUMENT error is returned. Corresponding properties: Google Merchant Center property [description](https://support.google.com/merchants/answer/6324468). Schema.org property [Product.description](https://schema.org/description).
-  "expireTime": "A String", # Note that this field is applied in the following ways: * If the Product is already expired when it is uploaded, this product is not indexed for search. * If the Product is not expired when it is uploaded, only the Type.PRIMARY's and Type.COLLECTION's expireTime is respected, and Type.VARIANT's expireTime is not used. In general, we suggest the users to delete the stale products explicitly, instead of using this field to determine staleness. expire_time must be later than available_time and publish_time, otherwise an INVALID_ARGUMENT error is thrown. Corresponding properties: Google Merchant Center property [expiration_date](https://support.google.com/merchants/answer/6324499).
+  "expireTime": "A String", # The timestamp when this product becomes unavailable for SearchService.Search. If it is set, the Product is not available for SearchService.Search after expire_time. However, the product can still be retrieved by ProductService.GetProduct and ProductService.ListProducts. Note that this field is applied in the following ways: * If the Product is already expired when it is uploaded, this product is not indexed for search. * If the Product is not expired when it is uploaded, only the Type.PRIMARY's and Type.COLLECTION's expireTime is respected, and Type.VARIANT's expireTime is not used. In general, we suggest the users to delete the stale products explicitly, instead of using this field to determine staleness. expire_time must be later than available_time and publish_time, otherwise an INVALID_ARGUMENT error is thrown. Corresponding properties: Google Merchant Center property [expiration_date](https://support.google.com/merchants/answer/6324499).
   "fulfillmentInfo": [ # Fulfillment information, such as the store IDs for in-store pickup or region IDs for different shipping methods. All the elements must have distinct FulfillmentInfo.type. Otherwise, an INVALID_ARGUMENT error is returned.
     { # Fulfillment information, such as the store IDs for in-store pickup or region IDs for different shipping methods.
       "placeIds": [ # The IDs for this type, such as the store IDs for FulfillmentInfo.type.pickup-in-store or the region IDs for FulfillmentInfo.type.same-day-delivery. A maximum of 3000 values are allowed. Each value must be a string with a length limit of 30 characters, matching the pattern `[a-zA-Z0-9_-]+`, such as "store1" or "REGION-2". Otherwise, an INVALID_ARGUMENT error is returned.
@@ -736,7 +736,7 @@ 
Method Details

     "A String",
   ],
   "description": "A String", # Product description. This field must be a UTF-8 encoded string with a length limit of 5,000 characters. Otherwise, an INVALID_ARGUMENT error is returned. Corresponding properties: Google Merchant Center property [description](https://support.google.com/merchants/answer/6324468). Schema.org property [Product.description](https://schema.org/description).
-  "expireTime": "A String", # Note that this field is applied in the following ways: * If the Product is already expired when it is uploaded, this product is not indexed for search. * If the Product is not expired when it is uploaded, only the Type.PRIMARY's and Type.COLLECTION's expireTime is respected, and Type.VARIANT's expireTime is not used. In general, we suggest the users to delete the stale products explicitly, instead of using this field to determine staleness. expire_time must be later than available_time and publish_time, otherwise an INVALID_ARGUMENT error is thrown. Corresponding properties: Google Merchant Center property [expiration_date](https://support.google.com/merchants/answer/6324499).
+  "expireTime": "A String", # The timestamp when this product becomes unavailable for SearchService.Search. If it is set, the Product is not available for SearchService.Search after expire_time. However, the product can still be retrieved by ProductService.GetProduct and ProductService.ListProducts. Note that this field is applied in the following ways: * If the Product is already expired when it is uploaded, this product is not indexed for search. * If the Product is not expired when it is uploaded, only the Type.PRIMARY's and Type.COLLECTION's expireTime is respected, and Type.VARIANT's expireTime is not used. In general, we suggest the users to delete the stale products explicitly, instead of using this field to determine staleness. expire_time must be later than available_time and publish_time, otherwise an INVALID_ARGUMENT error is thrown. Corresponding properties: Google Merchant Center property [expiration_date](https://support.google.com/merchants/answer/6324499).
   "fulfillmentInfo": [ # Fulfillment information, such as the store IDs for in-store pickup or region IDs for different shipping methods. All the elements must have distinct FulfillmentInfo.type. Otherwise, an INVALID_ARGUMENT error is returned.
     { # Fulfillment information, such as the store IDs for in-store pickup or region IDs for different shipping methods.
       "placeIds": [ # The IDs for this type, such as the store IDs for FulfillmentInfo.type.pickup-in-store or the region IDs for FulfillmentInfo.type.same-day-delivery. A maximum of 3000 values are allowed. Each value must be a string with a length limit of 30 characters, matching the pattern `[a-zA-Z0-9_-]+`, such as "store1" or "REGION-2". Otherwise, an INVALID_ARGUMENT error is returned.
@@ -936,7 +936,7 @@ 
Method Details

             "A String",
           ],
           "description": "A String", # Product description. This field must be a UTF-8 encoded string with a length limit of 5,000 characters. Otherwise, an INVALID_ARGUMENT error is returned. Corresponding properties: Google Merchant Center property [description](https://support.google.com/merchants/answer/6324468). Schema.org property [Product.description](https://schema.org/description).
-          "expireTime": "A String", # Note that this field is applied in the following ways: * If the Product is already expired when it is uploaded, this product is not indexed for search. * If the Product is not expired when it is uploaded, only the Type.PRIMARY's and Type.COLLECTION's expireTime is respected, and Type.VARIANT's expireTime is not used. In general, we suggest the users to delete the stale products explicitly, instead of using this field to determine staleness. expire_time must be later than available_time and publish_time, otherwise an INVALID_ARGUMENT error is thrown. Corresponding properties: Google Merchant Center property [expiration_date](https://support.google.com/merchants/answer/6324499).
+          "expireTime": "A String", # The timestamp when this product becomes unavailable for SearchService.Search. If it is set, the Product is not available for SearchService.Search after expire_time. However, the product can still be retrieved by ProductService.GetProduct and ProductService.ListProducts. Note that this field is applied in the following ways: * If the Product is already expired when it is uploaded, this product is not indexed for search. * If the Product is not expired when it is uploaded, only the Type.PRIMARY's and Type.COLLECTION's expireTime is respected, and Type.VARIANT's expireTime is not used. In general, we suggest the users to delete the stale products explicitly, instead of using this field to determine staleness. expire_time must be later than available_time and publish_time, otherwise an INVALID_ARGUMENT error is thrown. Corresponding properties: Google Merchant Center property [expiration_date](https://support.google.com/merchants/answer/6324499).
           "fulfillmentInfo": [ # Fulfillment information, such as the store IDs for in-store pickup or region IDs for different shipping methods. All the elements must have distinct FulfillmentInfo.type. Otherwise, an INVALID_ARGUMENT error is returned.
             { # Fulfillment information, such as the store IDs for in-store pickup or region IDs for different shipping methods.
               "placeIds": [ # The IDs for this type, such as the store IDs for FulfillmentInfo.type.pickup-in-store or the region IDs for FulfillmentInfo.type.same-day-delivery. A maximum of 3000 values are allowed. Each value must be a string with a length limit of 30 characters, matching the pattern `[a-zA-Z0-9_-]+`, such as "store1" or "REGION-2". Otherwise, an INVALID_ARGUMENT error is returned.
@@ -1159,7 +1159,7 @@ 
Method Details

         "A String",
       ],
       "description": "A String", # Product description. This field must be a UTF-8 encoded string with a length limit of 5,000 characters. Otherwise, an INVALID_ARGUMENT error is returned. Corresponding properties: Google Merchant Center property [description](https://support.google.com/merchants/answer/6324468). Schema.org property [Product.description](https://schema.org/description).
-      "expireTime": "A String", # Note that this field is applied in the following ways: * If the Product is already expired when it is uploaded, this product is not indexed for search. * If the Product is not expired when it is uploaded, only the Type.PRIMARY's and Type.COLLECTION's expireTime is respected, and Type.VARIANT's expireTime is not used. In general, we suggest the users to delete the stale products explicitly, instead of using this field to determine staleness. expire_time must be later than available_time and publish_time, otherwise an INVALID_ARGUMENT error is thrown. Corresponding properties: Google Merchant Center property [expiration_date](https://support.google.com/merchants/answer/6324499).
+      "expireTime": "A String", # The timestamp when this product becomes unavailable for SearchService.Search. If it is set, the Product is not available for SearchService.Search after expire_time. However, the product can still be retrieved by ProductService.GetProduct and ProductService.ListProducts. Note that this field is applied in the following ways: * If the Product is already expired when it is uploaded, this product is not indexed for search. * If the Product is not expired when it is uploaded, only the Type.PRIMARY's and Type.COLLECTION's expireTime is respected, and Type.VARIANT's expireTime is not used. In general, we suggest the users to delete the stale products explicitly, instead of using this field to determine staleness. expire_time must be later than available_time and publish_time, otherwise an INVALID_ARGUMENT error is thrown. Corresponding properties: Google Merchant Center property [expiration_date](https://support.google.com/merchants/answer/6324499).
       "fulfillmentInfo": [ # Fulfillment information, such as the store IDs for in-store pickup or region IDs for different shipping methods. All the elements must have distinct FulfillmentInfo.type. Otherwise, an INVALID_ARGUMENT error is returned.
         { # Fulfillment information, such as the store IDs for in-store pickup or region IDs for different shipping methods.
           "placeIds": [ # The IDs for this type, such as the store IDs for FulfillmentInfo.type.pickup-in-store or the region IDs for FulfillmentInfo.type.same-day-delivery. A maximum of 3000 values are allowed. Each value must be a string with a length limit of 30 characters, matching the pattern `[a-zA-Z0-9_-]+`, such as "store1" or "REGION-2". Otherwise, an INVALID_ARGUMENT error is returned.
@@ -1350,7 +1350,7 @@ 
Method Details

     "A String",
   ],
   "description": "A String", # Product description. This field must be a UTF-8 encoded string with a length limit of 5,000 characters. Otherwise, an INVALID_ARGUMENT error is returned. Corresponding properties: Google Merchant Center property [description](https://support.google.com/merchants/answer/6324468). Schema.org property [Product.description](https://schema.org/description).
-  "expireTime": "A String", # Note that this field is applied in the following ways: * If the Product is already expired when it is uploaded, this product is not indexed for search. * If the Product is not expired when it is uploaded, only the Type.PRIMARY's and Type.COLLECTION's expireTime is respected, and Type.VARIANT's expireTime is not used. In general, we suggest the users to delete the stale products explicitly, instead of using this field to determine staleness. expire_time must be later than available_time and publish_time, otherwise an INVALID_ARGUMENT error is thrown. Corresponding properties: Google Merchant Center property [expiration_date](https://support.google.com/merchants/answer/6324499).
+  "expireTime": "A String", # The timestamp when this product becomes unavailable for SearchService.Search. If it is set, the Product is not available for SearchService.Search after expire_time. However, the product can still be retrieved by ProductService.GetProduct and ProductService.ListProducts. Note that this field is applied in the following ways: * If the Product is already expired when it is uploaded, this product is not indexed for search. * If the Product is not expired when it is uploaded, only the Type.PRIMARY's and Type.COLLECTION's expireTime is respected, and Type.VARIANT's expireTime is not used. In general, we suggest the users to delete the stale products explicitly, instead of using this field to determine staleness. expire_time must be later than available_time and publish_time, otherwise an INVALID_ARGUMENT error is thrown. Corresponding properties: Google Merchant Center property [expiration_date](https://support.google.com/merchants/answer/6324499).
   "fulfillmentInfo": [ # Fulfillment information, such as the store IDs for in-store pickup or region IDs for different shipping methods. All the elements must have distinct FulfillmentInfo.type. Otherwise, an INVALID_ARGUMENT error is returned.
     { # Fulfillment information, such as the store IDs for in-store pickup or region IDs for different shipping methods.
       "placeIds": [ # The IDs for this type, such as the store IDs for FulfillmentInfo.type.pickup-in-store or the region IDs for FulfillmentInfo.type.same-day-delivery. A maximum of 3000 values are allowed. Each value must be a string with a length limit of 30 characters, matching the pattern `[a-zA-Z0-9_-]+`, such as "store1" or "REGION-2". Otherwise, an INVALID_ARGUMENT error is returned.
@@ -1525,7 +1525,7 @@ 
Method Details

     "A String",
   ],
   "description": "A String", # Product description. This field must be a UTF-8 encoded string with a length limit of 5,000 characters. Otherwise, an INVALID_ARGUMENT error is returned. Corresponding properties: Google Merchant Center property [description](https://support.google.com/merchants/answer/6324468). Schema.org property [Product.description](https://schema.org/description).
-  "expireTime": "A String", # Note that this field is applied in the following ways: * If the Product is already expired when it is uploaded, this product is not indexed for search. * If the Product is not expired when it is uploaded, only the Type.PRIMARY's and Type.COLLECTION's expireTime is respected, and Type.VARIANT's expireTime is not used. In general, we suggest the users to delete the stale products explicitly, instead of using this field to determine staleness. expire_time must be later than available_time and publish_time, otherwise an INVALID_ARGUMENT error is thrown. Corresponding properties: Google Merchant Center property [expiration_date](https://support.google.com/merchants/answer/6324499).
+  "expireTime": "A String", # The timestamp when this product becomes unavailable for SearchService.Search. If it is set, the Product is not available for SearchService.Search after expire_time. However, the product can still be retrieved by ProductService.GetProduct and ProductService.ListProducts. Note that this field is applied in the following ways: * If the Product is already expired when it is uploaded, this product is not indexed for search. * If the Product is not expired when it is uploaded, only the Type.PRIMARY's and Type.COLLECTION's expireTime is respected, and Type.VARIANT's expireTime is not used. In general, we suggest the users to delete the stale products explicitly, instead of using this field to determine staleness. expire_time must be later than available_time and publish_time, otherwise an INVALID_ARGUMENT error is thrown. Corresponding properties: Google Merchant Center property [expiration_date](https://support.google.com/merchants/answer/6324499).
   "fulfillmentInfo": [ # Fulfillment information, such as the store IDs for in-store pickup or region IDs for different shipping methods. All the elements must have distinct FulfillmentInfo.type. Otherwise, an INVALID_ARGUMENT error is returned.
     { # Fulfillment information, such as the store IDs for in-store pickup or region IDs for different shipping methods.
       "placeIds": [ # The IDs for this type, such as the store IDs for FulfillmentInfo.type.pickup-in-store or the region IDs for FulfillmentInfo.type.same-day-delivery. A maximum of 3000 values are allowed. Each value must be a string with a length limit of 30 characters, matching the pattern `[a-zA-Z0-9_-]+`, such as "store1" or "REGION-2". Otherwise, an INVALID_ARGUMENT error is returned.
@@ -1838,7 +1838,7 @@ 
Method Details

       "A String",
     ],
     "description": "A String", # Product description. This field must be a UTF-8 encoded string with a length limit of 5,000 characters. Otherwise, an INVALID_ARGUMENT error is returned. Corresponding properties: Google Merchant Center property [description](https://support.google.com/merchants/answer/6324468). Schema.org property [Product.description](https://schema.org/description).
-    "expireTime": "A String", # Note that this field is applied in the following ways: * If the Product is already expired when it is uploaded, this product is not indexed for search. * If the Product is not expired when it is uploaded, only the Type.PRIMARY's and Type.COLLECTION's expireTime is respected, and Type.VARIANT's expireTime is not used. In general, we suggest the users to delete the stale products explicitly, instead of using this field to determine staleness. expire_time must be later than available_time and publish_time, otherwise an INVALID_ARGUMENT error is thrown. Corresponding properties: Google Merchant Center property [expiration_date](https://support.google.com/merchants/answer/6324499).
+    "expireTime": "A String", # The timestamp when this product becomes unavailable for SearchService.Search. If it is set, the Product is not available for SearchService.Search after expire_time. However, the product can still be retrieved by ProductService.GetProduct and ProductService.ListProducts. Note that this field is applied in the following ways: * If the Product is already expired when it is uploaded, this product is not indexed for search. * If the Product is not expired when it is uploaded, only the Type.PRIMARY's and Type.COLLECTION's expireTime is respected, and Type.VARIANT's expireTime is not used. In general, we suggest the users to delete the stale products explicitly, instead of using this field to determine staleness. expire_time must be later than available_time and publish_time, otherwise an INVALID_ARGUMENT error is thrown. Corresponding properties: Google Merchant Center property [expiration_date](https://support.google.com/merchants/answer/6324499).
     "fulfillmentInfo": [ # Fulfillment information, such as the store IDs for in-store pickup or region IDs for different shipping methods. All the elements must have distinct FulfillmentInfo.type. Otherwise, an INVALID_ARGUMENT error is returned.
       { # Fulfillment information, such as the store IDs for in-store pickup or region IDs for different shipping methods.
         "placeIds": [ # The IDs for this type, such as the store IDs for FulfillmentInfo.type.pickup-in-store or the region IDs for FulfillmentInfo.type.same-day-delivery. A maximum of 3000 values are allowed. Each value must be a string with a length limit of 30 characters, matching the pattern `[a-zA-Z0-9_-]+`, such as "store1" or "REGION-2". Otherwise, an INVALID_ARGUMENT error is returned.
diff --git a/docs/dyn/retail_v2beta.projects.locations.catalogs.placements.html b/docs/dyn/retail_v2beta.projects.locations.catalogs.placements.html
index 38b2d87be2..fdf655b10c 100644
--- a/docs/dyn/retail_v2beta.projects.locations.catalogs.placements.html
+++ b/docs/dyn/retail_v2beta.projects.locations.catalogs.placements.html
@@ -315,7 +315,7 @@ 
Method Details

                 "A String",
               ],
               "description": "A String", # Product description. This field must be a UTF-8 encoded string with a length limit of 5,000 characters. Otherwise, an INVALID_ARGUMENT error is returned. Corresponding properties: Google Merchant Center property [description](https://support.google.com/merchants/answer/6324468). Schema.org property [Product.description](https://schema.org/description).
-              "expireTime": "A String", # Note that this field is applied in the following ways: * If the Product is already expired when it is uploaded, this product is not indexed for search. * If the Product is not expired when it is uploaded, only the Type.PRIMARY's and Type.COLLECTION's expireTime is respected, and Type.VARIANT's expireTime is not used. In general, we suggest the users to delete the stale products explicitly, instead of using this field to determine staleness. expire_time must be later than available_time and publish_time, otherwise an INVALID_ARGUMENT error is thrown. Corresponding properties: Google Merchant Center property [expiration_date](https://support.google.com/merchants/answer/6324499).
+              "expireTime": "A String", # The timestamp when this product becomes unavailable for SearchService.Search. If it is set, the Product is not available for SearchService.Search after expire_time. However, the product can still be retrieved by ProductService.GetProduct and ProductService.ListProducts. Note that this field is applied in the following ways: * If the Product is already expired when it is uploaded, this product is not indexed for search. * If the Product is not expired when it is uploaded, only the Type.PRIMARY's and Type.COLLECTION's expireTime is respected, and Type.VARIANT's expireTime is not used. In general, we suggest the users to delete the stale products explicitly, instead of using this field to determine staleness. expire_time must be later than available_time and publish_time, otherwise an INVALID_ARGUMENT error is thrown. Corresponding properties: Google Merchant Center property [expiration_date](https://support.google.com/merchants/answer/6324499).
               "fulfillmentInfo": [ # Fulfillment information, such as the store IDs for in-store pickup or region IDs for different shipping methods. All the elements must have distinct FulfillmentInfo.type. Otherwise, an INVALID_ARGUMENT error is returned.
                 { # Fulfillment information, such as the store IDs for in-store pickup or region IDs for different shipping methods.
                   "placeIds": [ # The IDs for this type, such as the store IDs for FulfillmentInfo.type.pickup-in-store or the region IDs for FulfillmentInfo.type.same-day-delivery. A maximum of 3000 values are allowed. Each value must be a string with a length limit of 30 characters, matching the pattern `[a-zA-Z0-9_-]+`, such as "store1" or "REGION-2". Otherwise, an INVALID_ARGUMENT error is returned.
@@ -487,7 +487,7 @@ 
Method Details

             "A String",
           ],
           "description": "A String", # Product description. This field must be a UTF-8 encoded string with a length limit of 5,000 characters. Otherwise, an INVALID_ARGUMENT error is returned. Corresponding properties: Google Merchant Center property [description](https://support.google.com/merchants/answer/6324468). Schema.org property [Product.description](https://schema.org/description).
-          "expireTime": "A String", # Note that this field is applied in the following ways: * If the Product is already expired when it is uploaded, this product is not indexed for search. * If the Product is not expired when it is uploaded, only the Type.PRIMARY's and Type.COLLECTION's expireTime is respected, and Type.VARIANT's expireTime is not used. In general, we suggest the users to delete the stale products explicitly, instead of using this field to determine staleness. expire_time must be later than available_time and publish_time, otherwise an INVALID_ARGUMENT error is thrown. Corresponding properties: Google Merchant Center property [expiration_date](https://support.google.com/merchants/answer/6324499).
+          "expireTime": "A String", # The timestamp when this product becomes unavailable for SearchService.Search. If it is set, the Product is not available for SearchService.Search after expire_time. However, the product can still be retrieved by ProductService.GetProduct and ProductService.ListProducts. Note that this field is applied in the following ways: * If the Product is already expired when it is uploaded, this product is not indexed for search. * If the Product is not expired when it is uploaded, only the Type.PRIMARY's and Type.COLLECTION's expireTime is respected, and Type.VARIANT's expireTime is not used. In general, we suggest the users to delete the stale products explicitly, instead of using this field to determine staleness. expire_time must be later than available_time and publish_time, otherwise an INVALID_ARGUMENT error is thrown. Corresponding properties: Google Merchant Center property [expiration_date](https://support.google.com/merchants/answer/6324499).
           "fulfillmentInfo": [ # Fulfillment information, such as the store IDs for in-store pickup or region IDs for different shipping methods. All the elements must have distinct FulfillmentInfo.type. Otherwise, an INVALID_ARGUMENT error is returned.
             { # Fulfillment information, such as the store IDs for in-store pickup or region IDs for different shipping methods.
               "placeIds": [ # The IDs for this type, such as the store IDs for FulfillmentInfo.type.pickup-in-store or the region IDs for FulfillmentInfo.type.same-day-delivery. A maximum of 3000 values are allowed. Each value must be a string with a length limit of 30 characters, matching the pattern `[a-zA-Z0-9_-]+`, such as "store1" or "REGION-2". Otherwise, an INVALID_ARGUMENT error is returned.
@@ -959,7 +959,7 @@ 
Method Details

           "A String",
         ],
         "description": "A String", # Product description. This field must be a UTF-8 encoded string with a length limit of 5,000 characters. Otherwise, an INVALID_ARGUMENT error is returned. Corresponding properties: Google Merchant Center property [description](https://support.google.com/merchants/answer/6324468). Schema.org property [Product.description](https://schema.org/description).
-        "expireTime": "A String", # Note that this field is applied in the following ways: * If the Product is already expired when it is uploaded, this product is not indexed for search. * If the Product is not expired when it is uploaded, only the Type.PRIMARY's and Type.COLLECTION's expireTime is respected, and Type.VARIANT's expireTime is not used. In general, we suggest the users to delete the stale products explicitly, instead of using this field to determine staleness. expire_time must be later than available_time and publish_time, otherwise an INVALID_ARGUMENT error is thrown. Corresponding properties: Google Merchant Center property [expiration_date](https://support.google.com/merchants/answer/6324499).
+        "expireTime": "A String", # The timestamp when this product becomes unavailable for SearchService.Search. If it is set, the Product is not available for SearchService.Search after expire_time. However, the product can still be retrieved by ProductService.GetProduct and ProductService.ListProducts. Note that this field is applied in the following ways: * If the Product is already expired when it is uploaded, this product is not indexed for search. * If the Product is not expired when it is uploaded, only the Type.PRIMARY's and Type.COLLECTION's expireTime is respected, and Type.VARIANT's expireTime is not used. In general, we suggest the users to delete the stale products explicitly, instead of using this field to determine staleness. expire_time must be later than available_time and publish_time, otherwise an INVALID_ARGUMENT error is thrown. Corresponding properties: Google Merchant Center property [expiration_date](https://support.google.com/merchants/answer/6324499).
         "fulfillmentInfo": [ # Fulfillment information, such as the store IDs for in-store pickup or region IDs for different shipping methods. All the elements must have distinct FulfillmentInfo.type. Otherwise, an INVALID_ARGUMENT error is returned.
           { # Fulfillment information, such as the store IDs for in-store pickup or region IDs for different shipping methods.
             "placeIds": [ # The IDs for this type, such as the store IDs for FulfillmentInfo.type.pickup-in-store or the region IDs for FulfillmentInfo.type.same-day-delivery. A maximum of 3000 values are allowed. Each value must be a string with a length limit of 30 characters, matching the pattern `[a-zA-Z0-9_-]+`, such as "store1" or "REGION-2". Otherwise, an INVALID_ARGUMENT error is returned.
diff --git a/docs/dyn/retail_v2beta.projects.locations.catalogs.servingConfigs.html b/docs/dyn/retail_v2beta.projects.locations.catalogs.servingConfigs.html
index 41999ad107..51087514ef 100644
--- a/docs/dyn/retail_v2beta.projects.locations.catalogs.servingConfigs.html
+++ b/docs/dyn/retail_v2beta.projects.locations.catalogs.servingConfigs.html
@@ -797,7 +797,7 @@ 
Method Details

                 "A String",
               ],
               "description": "A String", # Product description. This field must be a UTF-8 encoded string with a length limit of 5,000 characters. Otherwise, an INVALID_ARGUMENT error is returned. Corresponding properties: Google Merchant Center property [description](https://support.google.com/merchants/answer/6324468). Schema.org property [Product.description](https://schema.org/description).
-              "expireTime": "A String", # Note that this field is applied in the following ways: * If the Product is already expired when it is uploaded, this product is not indexed for search. * If the Product is not expired when it is uploaded, only the Type.PRIMARY's and Type.COLLECTION's expireTime is respected, and Type.VARIANT's expireTime is not used. In general, we suggest the users to delete the stale products explicitly, instead of using this field to determine staleness. expire_time must be later than available_time and publish_time, otherwise an INVALID_ARGUMENT error is thrown. Corresponding properties: Google Merchant Center property [expiration_date](https://support.google.com/merchants/answer/6324499).
+              "expireTime": "A String", # The timestamp when this product becomes unavailable for SearchService.Search. If it is set, the Product is not available for SearchService.Search after expire_time. However, the product can still be retrieved by ProductService.GetProduct and ProductService.ListProducts. Note that this field is applied in the following ways: * If the Product is already expired when it is uploaded, this product is not indexed for search. * If the Product is not expired when it is uploaded, only the Type.PRIMARY's and Type.COLLECTION's expireTime is respected, and Type.VARIANT's expireTime is not used. In general, we suggest the users to delete the stale products explicitly, instead of using this field to determine staleness. expire_time must be later than available_time and publish_time, otherwise an INVALID_ARGUMENT error is thrown. Corresponding properties: Google Merchant Center property [expiration_date](https://support.google.com/merchants/answer/6324499).
               "fulfillmentInfo": [ # Fulfillment information, such as the store IDs for in-store pickup or region IDs for different shipping methods. All the elements must have distinct FulfillmentInfo.type. Otherwise, an INVALID_ARGUMENT error is returned.
                 { # Fulfillment information, such as the store IDs for in-store pickup or region IDs for different shipping methods.
                   "placeIds": [ # The IDs for this type, such as the store IDs for FulfillmentInfo.type.pickup-in-store or the region IDs for FulfillmentInfo.type.same-day-delivery. A maximum of 3000 values are allowed. Each value must be a string with a length limit of 30 characters, matching the pattern `[a-zA-Z0-9_-]+`, such as "store1" or "REGION-2". Otherwise, an INVALID_ARGUMENT error is returned.
@@ -969,7 +969,7 @@ 
Method Details

             "A String",
           ],
           "description": "A String", # Product description. This field must be a UTF-8 encoded string with a length limit of 5,000 characters. Otherwise, an INVALID_ARGUMENT error is returned. Corresponding properties: Google Merchant Center property [description](https://support.google.com/merchants/answer/6324468). Schema.org property [Product.description](https://schema.org/description).
-          "expireTime": "A String", # Note that this field is applied in the following ways: * If the Product is already expired when it is uploaded, this product is not indexed for search. * If the Product is not expired when it is uploaded, only the Type.PRIMARY's and Type.COLLECTION's expireTime is respected, and Type.VARIANT's expireTime is not used. In general, we suggest the users to delete the stale products explicitly, instead of using this field to determine staleness. expire_time must be later than available_time and publish_time, otherwise an INVALID_ARGUMENT error is thrown. Corresponding properties: Google Merchant Center property [expiration_date](https://support.google.com/merchants/answer/6324499).
+          "expireTime": "A String", # The timestamp when this product becomes unavailable for SearchService.Search. If it is set, the Product is not available for SearchService.Search after expire_time. However, the product can still be retrieved by ProductService.GetProduct and ProductService.ListProducts. Note that this field is applied in the following ways: * If the Product is already expired when it is uploaded, this product is not indexed for search. * If the Product is not expired when it is uploaded, only the Type.PRIMARY's and Type.COLLECTION's expireTime is respected, and Type.VARIANT's expireTime is not used. In general, we suggest the users to delete the stale products explicitly, instead of using this field to determine staleness. expire_time must be later than available_time and publish_time, otherwise an INVALID_ARGUMENT error is thrown. Corresponding properties: Google Merchant Center property [expiration_date](https://support.google.com/merchants/answer/6324499).
           "fulfillmentInfo": [ # Fulfillment information, such as the store IDs for in-store pickup or region IDs for different shipping methods. All the elements must have distinct FulfillmentInfo.type. Otherwise, an INVALID_ARGUMENT error is returned.
             { # Fulfillment information, such as the store IDs for in-store pickup or region IDs for different shipping methods.
               "placeIds": [ # The IDs for this type, such as the store IDs for FulfillmentInfo.type.pickup-in-store or the region IDs for FulfillmentInfo.type.same-day-delivery. A maximum of 3000 values are allowed. Each value must be a string with a length limit of 30 characters, matching the pattern `[a-zA-Z0-9_-]+`, such as "store1" or "REGION-2". Otherwise, an INVALID_ARGUMENT error is returned.
@@ -1510,7 +1510,7 @@ 
Method Details

           "A String",
         ],
         "description": "A String", # Product description. This field must be a UTF-8 encoded string with a length limit of 5,000 characters. Otherwise, an INVALID_ARGUMENT error is returned. Corresponding properties: Google Merchant Center property [description](https://support.google.com/merchants/answer/6324468). Schema.org property [Product.description](https://schema.org/description).
-        "expireTime": "A String", # Note that this field is applied in the following ways: * If the Product is already expired when it is uploaded, this product is not indexed for search. * If the Product is not expired when it is uploaded, only the Type.PRIMARY's and Type.COLLECTION's expireTime is respected, and Type.VARIANT's expireTime is not used. In general, we suggest the users to delete the stale products explicitly, instead of using this field to determine staleness. expire_time must be later than available_time and publish_time, otherwise an INVALID_ARGUMENT error is thrown. Corresponding properties: Google Merchant Center property [expiration_date](https://support.google.com/merchants/answer/6324499).
+        "expireTime": "A String", # The timestamp when this product becomes unavailable for SearchService.Search. If it is set, the Product is not available for SearchService.Search after expire_time. However, the product can still be retrieved by ProductService.GetProduct and ProductService.ListProducts. Note that this field is applied in the following ways: * If the Product is already expired when it is uploaded, this product is not indexed for search. * If the Product is not expired when it is uploaded, only the Type.PRIMARY's and Type.COLLECTION's expireTime is respected, and Type.VARIANT's expireTime is not used. In general, we suggest the users to delete the stale products explicitly, instead of using this field to determine staleness. expire_time must be later than available_time and publish_time, otherwise an INVALID_ARGUMENT error is thrown. Corresponding properties: Google Merchant Center property [expiration_date](https://support.google.com/merchants/answer/6324499).
         "fulfillmentInfo": [ # Fulfillment information, such as the store IDs for in-store pickup or region IDs for different shipping methods. All the elements must have distinct FulfillmentInfo.type. Otherwise, an INVALID_ARGUMENT error is returned.
           { # Fulfillment information, such as the store IDs for in-store pickup or region IDs for different shipping methods.
             "placeIds": [ # The IDs for this type, such as the store IDs for FulfillmentInfo.type.pickup-in-store or the region IDs for FulfillmentInfo.type.same-day-delivery. A maximum of 3000 values are allowed. Each value must be a string with a length limit of 30 characters, matching the pattern `[a-zA-Z0-9_-]+`, such as "store1" or "REGION-2". Otherwise, an INVALID_ARGUMENT error is returned.
diff --git a/docs/dyn/retail_v2beta.projects.locations.catalogs.userEvents.html b/docs/dyn/retail_v2beta.projects.locations.catalogs.userEvents.html
index 6016702636..a86b3a67ce 100644
--- a/docs/dyn/retail_v2beta.projects.locations.catalogs.userEvents.html
+++ b/docs/dyn/retail_v2beta.projects.locations.catalogs.userEvents.html
@@ -309,7 +309,7 @@ 
Method Details

                       "A String",
                     ],
                     "description": "A String", # Product description. This field must be a UTF-8 encoded string with a length limit of 5,000 characters. Otherwise, an INVALID_ARGUMENT error is returned. Corresponding properties: Google Merchant Center property [description](https://support.google.com/merchants/answer/6324468). Schema.org property [Product.description](https://schema.org/description).
-                    "expireTime": "A String", # Note that this field is applied in the following ways: * If the Product is already expired when it is uploaded, this product is not indexed for search. * If the Product is not expired when it is uploaded, only the Type.PRIMARY's and Type.COLLECTION's expireTime is respected, and Type.VARIANT's expireTime is not used. In general, we suggest the users to delete the stale products explicitly, instead of using this field to determine staleness. expire_time must be later than available_time and publish_time, otherwise an INVALID_ARGUMENT error is thrown. Corresponding properties: Google Merchant Center property [expiration_date](https://support.google.com/merchants/answer/6324499).
+                    "expireTime": "A String", # The timestamp when this product becomes unavailable for SearchService.Search. If it is set, the Product is not available for SearchService.Search after expire_time. However, the product can still be retrieved by ProductService.GetProduct and ProductService.ListProducts. Note that this field is applied in the following ways: * If the Product is already expired when it is uploaded, this product is not indexed for search. * If the Product is not expired when it is uploaded, only the Type.PRIMARY's and Type.COLLECTION's expireTime is respected, and Type.VARIANT's expireTime is not used. In general, we suggest the users to delete the stale products explicitly, instead of using this field to determine staleness. expire_time must be later than available_time and publish_time, otherwise an INVALID_ARGUMENT error is thrown. Corresponding properties: Google Merchant Center property [expiration_date](https://support.google.com/merchants/answer/6324499).
                     "fulfillmentInfo": [ # Fulfillment information, such as the store IDs for in-store pickup or region IDs for different shipping methods. All the elements must have distinct FulfillmentInfo.type. Otherwise, an INVALID_ARGUMENT error is returned.
                       { # Fulfillment information, such as the store IDs for in-store pickup or region IDs for different shipping methods.
                         "placeIds": [ # The IDs for this type, such as the store IDs for FulfillmentInfo.type.pickup-in-store or the region IDs for FulfillmentInfo.type.same-day-delivery. A maximum of 3000 values are allowed. Each value must be a string with a length limit of 30 characters, matching the pattern `[a-zA-Z0-9_-]+`, such as "store1" or "REGION-2". Otherwise, an INVALID_ARGUMENT error is returned.
@@ -481,7 +481,7 @@ 
Method Details

                   "A String",
                 ],
                 "description": "A String", # Product description. This field must be a UTF-8 encoded string with a length limit of 5,000 characters. Otherwise, an INVALID_ARGUMENT error is returned. Corresponding properties: Google Merchant Center property [description](https://support.google.com/merchants/answer/6324468). Schema.org property [Product.description](https://schema.org/description).
-                "expireTime": "A String", # Note that this field is applied in the following ways: * If the Product is already expired when it is uploaded, this product is not indexed for search. * If the Product is not expired when it is uploaded, only the Type.PRIMARY's and Type.COLLECTION's expireTime is respected, and Type.VARIANT's expireTime is not used. In general, we suggest the users to delete the stale products explicitly, instead of using this field to determine staleness. expire_time must be later than available_time and publish_time, otherwise an INVALID_ARGUMENT error is thrown. Corresponding properties: Google Merchant Center property [expiration_date](https://support.google.com/merchants/answer/6324499).
+                "expireTime": "A String", # The timestamp when this product becomes unavailable for SearchService.Search. If it is set, the Product is not available for SearchService.Search after expire_time. However, the product can still be retrieved by ProductService.GetProduct and ProductService.ListProducts. Note that this field is applied in the following ways: * If the Product is already expired when it is uploaded, this product is not indexed for search. * If the Product is not expired when it is uploaded, only the Type.PRIMARY's and Type.COLLECTION's expireTime is respected, and Type.VARIANT's expireTime is not used. In general, we suggest the users to delete the stale products explicitly, instead of using this field to determine staleness. expire_time must be later than available_time and publish_time, otherwise an INVALID_ARGUMENT error is thrown. Corresponding properties: Google Merchant Center property [expiration_date](https://support.google.com/merchants/answer/6324499).
                 "fulfillmentInfo": [ # Fulfillment information, such as the store IDs for in-store pickup or region IDs for different shipping methods. All the elements must have distinct FulfillmentInfo.type. Otherwise, an INVALID_ARGUMENT error is returned.
                   { # Fulfillment information, such as the store IDs for in-store pickup or region IDs for different shipping methods.
                     "placeIds": [ # The IDs for this type, such as the store IDs for FulfillmentInfo.type.pickup-in-store or the region IDs for FulfillmentInfo.type.same-day-delivery. A maximum of 3000 values are allowed. Each value must be a string with a length limit of 30 characters, matching the pattern `[a-zA-Z0-9_-]+`, such as "store1" or "REGION-2". Otherwise, an INVALID_ARGUMENT error is returned.
@@ -836,7 +836,7 @@ 
Method Details

               "A String",
             ],
             "description": "A String", # Product description. This field must be a UTF-8 encoded string with a length limit of 5,000 characters. Otherwise, an INVALID_ARGUMENT error is returned. Corresponding properties: Google Merchant Center property [description](https://support.google.com/merchants/answer/6324468). Schema.org property [Product.description](https://schema.org/description).
-            "expireTime": "A String", # Note that this field is applied in the following ways: * If the Product is already expired when it is uploaded, this product is not indexed for search. * If the Product is not expired when it is uploaded, only the Type.PRIMARY's and Type.COLLECTION's expireTime is respected, and Type.VARIANT's expireTime is not used. In general, we suggest the users to delete the stale products explicitly, instead of using this field to determine staleness. expire_time must be later than available_time and publish_time, otherwise an INVALID_ARGUMENT error is thrown. Corresponding properties: Google Merchant Center property [expiration_date](https://support.google.com/merchants/answer/6324499).
+            "expireTime": "A String", # The timestamp when this product becomes unavailable for SearchService.Search. If it is set, the Product is not available for SearchService.Search after expire_time. However, the product can still be retrieved by ProductService.GetProduct and ProductService.ListProducts. Note that this field is applied in the following ways: * If the Product is already expired when it is uploaded, this product is not indexed for search. * If the Product is not expired when it is uploaded, only the Type.PRIMARY's and Type.COLLECTION's expireTime is respected, and Type.VARIANT's expireTime is not used. In general, we suggest the users to delete the stale products explicitly, instead of using this field to determine staleness. expire_time must be later than available_time and publish_time, otherwise an INVALID_ARGUMENT error is thrown. Corresponding properties: Google Merchant Center property [expiration_date](https://support.google.com/merchants/answer/6324499).
             "fulfillmentInfo": [ # Fulfillment information, such as the store IDs for in-store pickup or region IDs for different shipping methods. All the elements must have distinct FulfillmentInfo.type. Otherwise, an INVALID_ARGUMENT error is returned.
               { # Fulfillment information, such as the store IDs for in-store pickup or region IDs for different shipping methods.
                 "placeIds": [ # The IDs for this type, such as the store IDs for FulfillmentInfo.type.pickup-in-store or the region IDs for FulfillmentInfo.type.same-day-delivery. A maximum of 3000 values are allowed. Each value must be a string with a length limit of 30 characters, matching the pattern `[a-zA-Z0-9_-]+`, such as "store1" or "REGION-2". Otherwise, an INVALID_ARGUMENT error is returned.
@@ -1008,7 +1008,7 @@ 
Method Details

           "A String",
         ],
         "description": "A String", # Product description. This field must be a UTF-8 encoded string with a length limit of 5,000 characters. Otherwise, an INVALID_ARGUMENT error is returned. Corresponding properties: Google Merchant Center property [description](https://support.google.com/merchants/answer/6324468). Schema.org property [Product.description](https://schema.org/description).
-        "expireTime": "A String", # Note that this field is applied in the following ways: * If the Product is already expired when it is uploaded, this product is not indexed for search. * If the Product is not expired when it is uploaded, only the Type.PRIMARY's and Type.COLLECTION's expireTime is respected, and Type.VARIANT's expireTime is not used. In general, we suggest the users to delete the stale products explicitly, instead of using this field to determine staleness. expire_time must be later than available_time and publish_time, otherwise an INVALID_ARGUMENT error is thrown. Corresponding properties: Google Merchant Center property [expiration_date](https://support.google.com/merchants/answer/6324499).
+        "expireTime": "A String", # The timestamp when this product becomes unavailable for SearchService.Search. If it is set, the Product is not available for SearchService.Search after expire_time. However, the product can still be retrieved by ProductService.GetProduct and ProductService.ListProducts. Note that this field is applied in the following ways: * If the Product is already expired when it is uploaded, this product is not indexed for search. * If the Product is not expired when it is uploaded, only the Type.PRIMARY's and Type.COLLECTION's expireTime is respected, and Type.VARIANT's expireTime is not used. In general, we suggest the users to delete the stale products explicitly, instead of using this field to determine staleness. expire_time must be later than available_time and publish_time, otherwise an INVALID_ARGUMENT error is thrown. Corresponding properties: Google Merchant Center property [expiration_date](https://support.google.com/merchants/answer/6324499).
         "fulfillmentInfo": [ # Fulfillment information, such as the store IDs for in-store pickup or region IDs for different shipping methods. All the elements must have distinct FulfillmentInfo.type. Otherwise, an INVALID_ARGUMENT error is returned.
           { # Fulfillment information, such as the store IDs for in-store pickup or region IDs for different shipping methods.
             "placeIds": [ # The IDs for this type, such as the store IDs for FulfillmentInfo.type.pickup-in-store or the region IDs for FulfillmentInfo.type.same-day-delivery. A maximum of 3000 values are allowed. Each value must be a string with a length limit of 30 characters, matching the pattern `[a-zA-Z0-9_-]+`, such as "store1" or "REGION-2". Otherwise, an INVALID_ARGUMENT error is returned.
@@ -1245,7 +1245,7 @@ 
Method Details

               "A String",
             ],
             "description": "A String", # Product description. This field must be a UTF-8 encoded string with a length limit of 5,000 characters. Otherwise, an INVALID_ARGUMENT error is returned. Corresponding properties: Google Merchant Center property [description](https://support.google.com/merchants/answer/6324468). Schema.org property [Product.description](https://schema.org/description).
-            "expireTime": "A String", # Note that this field is applied in the following ways: * If the Product is already expired when it is uploaded, this product is not indexed for search. * If the Product is not expired when it is uploaded, only the Type.PRIMARY's and Type.COLLECTION's expireTime is respected, and Type.VARIANT's expireTime is not used. In general, we suggest the users to delete the stale products explicitly, instead of using this field to determine staleness. expire_time must be later than available_time and publish_time, otherwise an INVALID_ARGUMENT error is thrown. Corresponding properties: Google Merchant Center property [expiration_date](https://support.google.com/merchants/answer/6324499).
+            "expireTime": "A String", # The timestamp when this product becomes unavailable for SearchService.Search. If it is set, the Product is not available for SearchService.Search after expire_time. However, the product can still be retrieved by ProductService.GetProduct and ProductService.ListProducts. Note that this field is applied in the following ways: * If the Product is already expired when it is uploaded, this product is not indexed for search. * If the Product is not expired when it is uploaded, only the Type.PRIMARY's and Type.COLLECTION's expireTime is respected, and Type.VARIANT's expireTime is not used. In general, we suggest the users to delete the stale products explicitly, instead of using this field to determine staleness. expire_time must be later than available_time and publish_time, otherwise an INVALID_ARGUMENT error is thrown. Corresponding properties: Google Merchant Center property [expiration_date](https://support.google.com/merchants/answer/6324499).
             "fulfillmentInfo": [ # Fulfillment information, such as the store IDs for in-store pickup or region IDs for different shipping methods. All the elements must have distinct FulfillmentInfo.type. Otherwise, an INVALID_ARGUMENT error is returned.
               { # Fulfillment information, such as the store IDs for in-store pickup or region IDs for different shipping methods.
                 "placeIds": [ # The IDs for this type, such as the store IDs for FulfillmentInfo.type.pickup-in-store or the region IDs for FulfillmentInfo.type.same-day-delivery. A maximum of 3000 values are allowed. Each value must be a string with a length limit of 30 characters, matching the pattern `[a-zA-Z0-9_-]+`, such as "store1" or "REGION-2". Otherwise, an INVALID_ARGUMENT error is returned.
@@ -1417,7 +1417,7 @@ 
Method Details

           "A String",
         ],
         "description": "A String", # Product description. This field must be a UTF-8 encoded string with a length limit of 5,000 characters. Otherwise, an INVALID_ARGUMENT error is returned. Corresponding properties: Google Merchant Center property [description](https://support.google.com/merchants/answer/6324468). Schema.org property [Product.description](https://schema.org/description).
-        "expireTime": "A String", # Note that this field is applied in the following ways: * If the Product is already expired when it is uploaded, this product is not indexed for search. * If the Product is not expired when it is uploaded, only the Type.PRIMARY's and Type.COLLECTION's expireTime is respected, and Type.VARIANT's expireTime is not used. In general, we suggest the users to delete the stale products explicitly, instead of using this field to determine staleness. expire_time must be later than available_time and publish_time, otherwise an INVALID_ARGUMENT error is thrown. Corresponding properties: Google Merchant Center property [expiration_date](https://support.google.com/merchants/answer/6324499).
+        "expireTime": "A String", # The timestamp when this product becomes unavailable for SearchService.Search. If it is set, the Product is not available for SearchService.Search after expire_time. However, the product can still be retrieved by ProductService.GetProduct and ProductService.ListProducts. Note that this field is applied in the following ways: * If the Product is already expired when it is uploaded, this product is not indexed for search. * If the Product is not expired when it is uploaded, only the Type.PRIMARY's and Type.COLLECTION's expireTime is respected, and Type.VARIANT's expireTime is not used. In general, we suggest the users to delete the stale products explicitly, instead of using this field to determine staleness. expire_time must be later than available_time and publish_time, otherwise an INVALID_ARGUMENT error is thrown. Corresponding properties: Google Merchant Center property [expiration_date](https://support.google.com/merchants/answer/6324499).
         "fulfillmentInfo": [ # Fulfillment information, such as the store IDs for in-store pickup or region IDs for different shipping methods. All the elements must have distinct FulfillmentInfo.type. Otherwise, an INVALID_ARGUMENT error is returned.
           { # Fulfillment information, such as the store IDs for in-store pickup or region IDs for different shipping methods.
             "placeIds": [ # The IDs for this type, such as the store IDs for FulfillmentInfo.type.pickup-in-store or the region IDs for FulfillmentInfo.type.same-day-delivery. A maximum of 3000 values are allowed. Each value must be a string with a length limit of 30 characters, matching the pattern `[a-zA-Z0-9_-]+`, such as "store1" or "REGION-2". Otherwise, an INVALID_ARGUMENT error is returned.
diff --git a/docs/dyn/youtube_v3.liveChatMessages.html b/docs/dyn/youtube_v3.liveChatMessages.html
index 0d3b45520c..05aa90fdeb 100644
--- a/docs/dyn/youtube_v3.liveChatMessages.html
+++ b/docs/dyn/youtube_v3.liveChatMessages.html
@@ -79,19 +79,19 @@ 
Instance Methods

 
Close httplib2 connections.

 

   delete(id, x__xgafv=None)

-
Deletes a chat message.

+
Deletes a chat message. A call to this method has a quota cost of 20 units.

 

   insert(part, body=None, x__xgafv=None)

-
Inserts a new resource into this collection.

+
Inserts a new resource into this collection. A call to this method has a quota cost of 20 units.

 

   list(liveChatId, part, hl=None, maxResults=None, pageToken=None, profileImageSize=None, x__xgafv=None)

-
Retrieves a list of resources, possibly filtered.

+
Retrieves a list of resources, possibly filtered. A call to this method has a quota cost of 5 units.

 

   list_next(previous_request, previous_response)

 
Retrieves the next page of results.

 

   transition(id=None, status=None, x__xgafv=None)

-
Transition a durable chat event.

+
Transitions a durable chat event. A call to this method has a quota cost of 20 units.

 
Method Details

 

     close()
@@ -100,7 +100,7 @@ 
Method Details

 
 

     delete(id, x__xgafv=None)
-  
Deletes a chat message.
+  
Deletes a chat message. A call to this method has a quota cost of 20 units.
 
 Args:
   id: string, A parameter (required)
@@ -113,10 +113,10 @@ 
Method Details

 
 

     insert(part, body=None, x__xgafv=None)
-  
Inserts a new resource into this collection.
+  
Inserts a new resource into this collection. A call to this method has a quota cost of 20 units.
 
 Args:
-  part: string, The *part* parameter serves two purposes. It identifies the properties that the write operation will set as well as the properties that the API response will include. Set the parameter value to snippet. (required) (repeated)
+  part: string, The `part` parameter serves two purposes. It identifies the properties that the write operation sets as well as the properties that the API response includes. Set the parameter value to `snippet`. (required) (repeated)
   body: object, The request body.
     The object takes the form of:
 
@@ -137,13 +137,13 @@ 
Method Details

   "snippet": { # Next ID: 35 # The snippet object contains basic details about the message.
     "authorChannelId": "A String", # The ID of the user that authored this message, this field is not always filled. textMessageEvent - the user that wrote the message fanFundingEvent - the user that funded the broadcast newSponsorEvent - the user that just became a sponsor memberMilestoneChatEvent - the member that sent the message membershipGiftingEvent - the user that made the purchase giftMembershipReceivedEvent - the user that received the gift membership messageDeletedEvent - the moderator that took the action. Unused. messageRetractedEvent - the author that retracted their message. Unused. userBannedEvent - the moderator that took the action superChatEvent - the user that made the purchase superStickerEvent - the user that made the purchase pollEvent - the user that created the poll
     "displayMessage": "A String", # Contains a string that can be displayed to the user. If this field is not present the message is silent, at the moment only messages of type TOMBSTONE and CHAT_ENDED_EVENT are silent.
-    "fanFundingEventDetails": { # Details about the funding event, this is only set if the type is 'fanFundingEvent'.
+    "fanFundingEventDetails": { # Details about the funding event, this is only set if the type is `fanFundingEvent`.
       "amountDisplayString": "A String", # A rendered string that displays the fund amount and currency to the user.
       "amountMicros": "A String", # The amount of the fund.
       "currency": "A String", # The currency in which the fund was made.
       "userComment": "A String", # The comment added by the user to this fan funding event.
     },
-    "giftDetails": { # Details about the gift event, this is only set if the type is 'giftEvent'. # Details about the gift event, this is only set if the type is 'giftEvent'.
+    "giftDetails": { # Details about the gift event, this is only set if the type is `giftEvent`. # Details about the gift event, this is only set if the type is `giftEvent`.
       "altText": "A String", # The alternative text to be used for accessibility.
       "comboCount": 42, # The number of times the gift has been sent in a row.
       "giftDuration": "A String", # The duration of the gift.
@@ -153,19 +153,19 @@ 
Method Details

       "jewelsAmount": 42, # The value of the gift in jewels.
       "language": "A String", # The BCP-47 language code of the gift.
     },
-    "giftMembershipReceivedDetails": { # Details about the Gift Membership Received event, this is only set if the type is 'giftMembershipReceivedEvent'.
-      "associatedMembershipGiftingMessageId": "A String", # The ID of the membership gifting message that is related to this gift membership. This ID will always refer to a message whose type is 'membershipGiftingEvent'.
+    "giftMembershipReceivedDetails": { # Details about the Gift Membership Received event, this is only set if the type is `giftMembershipReceivedEvent`.
+      "associatedMembershipGiftingMessageId": "A String", # The ID of the membership gifting message that is related to this gift membership. This ID will always refer to a message whose type is `membershipGiftingEvent`.
       "gifterChannelId": "A String", # The ID of the user that made the membership gifting purchase. This matches the `snippet.authorChannelId` of the associated membership gifting message.
       "memberLevelName": "A String", # The name of the Level at which the viewer is a member. This matches the `snippet.membershipGiftingDetails.giftMembershipsLevelName` of the associated membership gifting message. The Level names are defined by the YouTube channel offering the Membership. In some situations this field isn't filled.
     },
     "hasDisplayContent": True or False, # Whether the message has display content that should be displayed to users.
     "liveChatId": "A String",
-    "memberMilestoneChatDetails": { # Details about the Member Milestone Chat event, this is only set if the type is 'memberMilestoneChatEvent'.
+    "memberMilestoneChatDetails": { # Details about the Member Milestone Chat event, this is only set if the type is `memberMilestoneChatEvent`.
       "memberLevelName": "A String", # The name of the Level at which the viever is a member. The Level names are defined by the YouTube channel offering the Membership. In some situations this field isn't filled.
       "memberMonth": 42, # The total amount of months (rounded up) the viewer has been a member that granted them this Member Milestone Chat. This is the same number of months as is being displayed to YouTube users.
       "userComment": "A String", # The comment added by the member to this Member Milestone Chat. This field is empty for messages without a comment from the member.
     },
-    "membershipGiftingDetails": { # Details about the Membership Gifting event, this is only set if the type is 'membershipGiftingEvent'.
+    "membershipGiftingDetails": { # Details about the Membership Gifting event, this is only set if the type is `membershipGiftingEvent`.
       "giftMembershipsCount": 42, # The number of gift memberships purchased by the user.
       "giftMembershipsLevelName": "A String", # The name of the level of the gift memberships purchased by the user. The Level names are defined by the YouTube channel offering the Membership. In some situations this field isn't filled.
     },
@@ -175,11 +175,11 @@ 
Method Details

     "messageRetractedDetails": {
       "retractedMessageId": "A String",
     },
-    "newSponsorDetails": { # Details about the New Member Announcement event, this is only set if the type is 'newSponsorEvent'. Please note that "member" is the new term for "sponsor".
+    "newSponsorDetails": { # Details about the New Member Announcement event, this is only set if the type is `newSponsorEvent`. The term "member" replaces "sponsor".
       "isUpgrade": True or False, # If the viewer just had upgraded from a lower level. For viewers that were not members at the time of purchase, this field is false.
       "memberLevelName": "A String", # The name of the Level that the viewer just had joined. The Level names are defined by the YouTube channel offering the Membership. In some situations this field isn't filled.
     },
-    "pollDetails": { # Details about the poll event, this is only set if the type is 'pollEvent'.
+    "pollDetails": { # Details about the poll event, this is only set if the type is `pollEvent`.
       "metadata": {
         "options": [ # The options will be returned in the order that is displayed in 1P
           {
@@ -192,14 +192,14 @@ 
Method Details

       "status": "A String",
     },
     "publishedAt": "A String", # The date and time when the message was orignally published.
-    "superChatDetails": { # Details about the Super Chat event, this is only set if the type is 'superChatEvent'.
+    "superChatDetails": { # Details about the Super Chat event, this is only set if the type is `superChatEvent`.
       "amountDisplayString": "A String", # A rendered string that displays the fund amount and currency to the user.
       "amountMicros": "A String", # The amount purchased by the user, in micros (1,750,000 micros = 1.75).
       "currency": "A String", # The currency in which the purchase was made.
-      "tier": 42, # The tier in which the amount belongs. Lower amounts belong to lower tiers. The lowest tier is 1.
+      "tier": 42, # The tier in which the amount belongs. Lower amounts belong to lower tiers. The lowest tier is `1`.
       "userComment": "A String", # The comment added by the user to this Super Chat event.
     },
-    "superStickerDetails": { # Details about the Super Sticker event, this is only set if the type is 'superStickerEvent'.
+    "superStickerDetails": { # Details about the Super Sticker event, this is only set if the type is `superStickerEvent`.
       "amountDisplayString": "A String", # A rendered string that displays the fund amount and currency to the user.
       "amountMicros": "A String", # The amount purchased by the user, in micros (1,750,000 micros = 1.75).
       "currency": "A String", # The currency in which the purchase was made.
@@ -208,14 +208,14 @@ 
Method Details

         "altTextLanguage": "A String", # Specifies the localization language in which the alt text is returned.
         "stickerId": "A String", # Unique identifier of the Super Sticker. This is a shorter form of the alt_text that includes pack name and a recognizable characteristic of the sticker.
       },
-      "tier": 42, # The tier in which the amount belongs. Lower amounts belong to lower tiers. The lowest tier is 1.
+      "tier": 42, # The tier in which the amount belongs. Lower amounts belong to lower tiers. The lowest tier is `1`.
     },
-    "textMessageDetails": { # Details about the text message, this is only set if the type is 'textMessageEvent'.
+    "textMessageDetails": { # Details about the text message, this is only set if the type is `textMessageEvent`.
       "messageText": "A String", # The user's message.
     },
     "type": "A String", # The type of message, this will always be present, it determines the contents of the message as well as which fields will be present.
     "userBannedDetails": {
-      "banDurationSeconds": "A String", # The duration of the ban. This property is only present if the banType is temporary.
+      "banDurationSeconds": "A String", # The duration of the ban. This property is only present if the `banType` is `temporary`.
       "banType": "A String", # The type of ban.
       "bannedUserDetails": { # The details of the user that was banned.
         "channelId": "A String", # The YouTube channel ID.
@@ -252,13 +252,13 @@ 
Method Details

   "snippet": { # Next ID: 35 # The snippet object contains basic details about the message.
     "authorChannelId": "A String", # The ID of the user that authored this message, this field is not always filled. textMessageEvent - the user that wrote the message fanFundingEvent - the user that funded the broadcast newSponsorEvent - the user that just became a sponsor memberMilestoneChatEvent - the member that sent the message membershipGiftingEvent - the user that made the purchase giftMembershipReceivedEvent - the user that received the gift membership messageDeletedEvent - the moderator that took the action. Unused. messageRetractedEvent - the author that retracted their message. Unused. userBannedEvent - the moderator that took the action superChatEvent - the user that made the purchase superStickerEvent - the user that made the purchase pollEvent - the user that created the poll
     "displayMessage": "A String", # Contains a string that can be displayed to the user. If this field is not present the message is silent, at the moment only messages of type TOMBSTONE and CHAT_ENDED_EVENT are silent.
-    "fanFundingEventDetails": { # Details about the funding event, this is only set if the type is 'fanFundingEvent'.
+    "fanFundingEventDetails": { # Details about the funding event, this is only set if the type is `fanFundingEvent`.
       "amountDisplayString": "A String", # A rendered string that displays the fund amount and currency to the user.
       "amountMicros": "A String", # The amount of the fund.
       "currency": "A String", # The currency in which the fund was made.
       "userComment": "A String", # The comment added by the user to this fan funding event.
     },
-    "giftDetails": { # Details about the gift event, this is only set if the type is 'giftEvent'. # Details about the gift event, this is only set if the type is 'giftEvent'.
+    "giftDetails": { # Details about the gift event, this is only set if the type is `giftEvent`. # Details about the gift event, this is only set if the type is `giftEvent`.
       "altText": "A String", # The alternative text to be used for accessibility.
       "comboCount": 42, # The number of times the gift has been sent in a row.
       "giftDuration": "A String", # The duration of the gift.
@@ -268,19 +268,19 @@ 
Method Details

       "jewelsAmount": 42, # The value of the gift in jewels.
       "language": "A String", # The BCP-47 language code of the gift.
     },
-    "giftMembershipReceivedDetails": { # Details about the Gift Membership Received event, this is only set if the type is 'giftMembershipReceivedEvent'.
-      "associatedMembershipGiftingMessageId": "A String", # The ID of the membership gifting message that is related to this gift membership. This ID will always refer to a message whose type is 'membershipGiftingEvent'.
+    "giftMembershipReceivedDetails": { # Details about the Gift Membership Received event, this is only set if the type is `giftMembershipReceivedEvent`.
+      "associatedMembershipGiftingMessageId": "A String", # The ID of the membership gifting message that is related to this gift membership. This ID will always refer to a message whose type is `membershipGiftingEvent`.
       "gifterChannelId": "A String", # The ID of the user that made the membership gifting purchase. This matches the `snippet.authorChannelId` of the associated membership gifting message.
       "memberLevelName": "A String", # The name of the Level at which the viewer is a member. This matches the `snippet.membershipGiftingDetails.giftMembershipsLevelName` of the associated membership gifting message. The Level names are defined by the YouTube channel offering the Membership. In some situations this field isn't filled.
     },
     "hasDisplayContent": True or False, # Whether the message has display content that should be displayed to users.
     "liveChatId": "A String",
-    "memberMilestoneChatDetails": { # Details about the Member Milestone Chat event, this is only set if the type is 'memberMilestoneChatEvent'.
+    "memberMilestoneChatDetails": { # Details about the Member Milestone Chat event, this is only set if the type is `memberMilestoneChatEvent`.
       "memberLevelName": "A String", # The name of the Level at which the viever is a member. The Level names are defined by the YouTube channel offering the Membership. In some situations this field isn't filled.
       "memberMonth": 42, # The total amount of months (rounded up) the viewer has been a member that granted them this Member Milestone Chat. This is the same number of months as is being displayed to YouTube users.
       "userComment": "A String", # The comment added by the member to this Member Milestone Chat. This field is empty for messages without a comment from the member.
     },
-    "membershipGiftingDetails": { # Details about the Membership Gifting event, this is only set if the type is 'membershipGiftingEvent'.
+    "membershipGiftingDetails": { # Details about the Membership Gifting event, this is only set if the type is `membershipGiftingEvent`.
       "giftMembershipsCount": 42, # The number of gift memberships purchased by the user.
       "giftMembershipsLevelName": "A String", # The name of the level of the gift memberships purchased by the user. The Level names are defined by the YouTube channel offering the Membership. In some situations this field isn't filled.
     },
@@ -290,11 +290,11 @@ 
Method Details

     "messageRetractedDetails": {
       "retractedMessageId": "A String",
     },
-    "newSponsorDetails": { # Details about the New Member Announcement event, this is only set if the type is 'newSponsorEvent'. Please note that "member" is the new term for "sponsor".
+    "newSponsorDetails": { # Details about the New Member Announcement event, this is only set if the type is `newSponsorEvent`. The term "member" replaces "sponsor".
       "isUpgrade": True or False, # If the viewer just had upgraded from a lower level. For viewers that were not members at the time of purchase, this field is false.
       "memberLevelName": "A String", # The name of the Level that the viewer just had joined. The Level names are defined by the YouTube channel offering the Membership. In some situations this field isn't filled.
     },
-    "pollDetails": { # Details about the poll event, this is only set if the type is 'pollEvent'.
+    "pollDetails": { # Details about the poll event, this is only set if the type is `pollEvent`.
       "metadata": {
         "options": [ # The options will be returned in the order that is displayed in 1P
           {
@@ -307,14 +307,14 @@ 
Method Details

       "status": "A String",
     },
     "publishedAt": "A String", # The date and time when the message was orignally published.
-    "superChatDetails": { # Details about the Super Chat event, this is only set if the type is 'superChatEvent'.
+    "superChatDetails": { # Details about the Super Chat event, this is only set if the type is `superChatEvent`.
       "amountDisplayString": "A String", # A rendered string that displays the fund amount and currency to the user.
       "amountMicros": "A String", # The amount purchased by the user, in micros (1,750,000 micros = 1.75).
       "currency": "A String", # The currency in which the purchase was made.
-      "tier": 42, # The tier in which the amount belongs. Lower amounts belong to lower tiers. The lowest tier is 1.
+      "tier": 42, # The tier in which the amount belongs. Lower amounts belong to lower tiers. The lowest tier is `1`.
       "userComment": "A String", # The comment added by the user to this Super Chat event.
     },
-    "superStickerDetails": { # Details about the Super Sticker event, this is only set if the type is 'superStickerEvent'.
+    "superStickerDetails": { # Details about the Super Sticker event, this is only set if the type is `superStickerEvent`.
       "amountDisplayString": "A String", # A rendered string that displays the fund amount and currency to the user.
       "amountMicros": "A String", # The amount purchased by the user, in micros (1,750,000 micros = 1.75).
       "currency": "A String", # The currency in which the purchase was made.
@@ -323,14 +323,14 @@ 
Method Details

         "altTextLanguage": "A String", # Specifies the localization language in which the alt text is returned.
         "stickerId": "A String", # Unique identifier of the Super Sticker. This is a shorter form of the alt_text that includes pack name and a recognizable characteristic of the sticker.
       },
-      "tier": 42, # The tier in which the amount belongs. Lower amounts belong to lower tiers. The lowest tier is 1.
+      "tier": 42, # The tier in which the amount belongs. Lower amounts belong to lower tiers. The lowest tier is `1`.
     },
-    "textMessageDetails": { # Details about the text message, this is only set if the type is 'textMessageEvent'.
+    "textMessageDetails": { # Details about the text message, this is only set if the type is `textMessageEvent`.
       "messageText": "A String", # The user's message.
     },
     "type": "A String", # The type of message, this will always be present, it determines the contents of the message as well as which fields will be present.
     "userBannedDetails": {
-      "banDurationSeconds": "A String", # The duration of the ban. This property is only present if the banType is temporary.
+      "banDurationSeconds": "A String", # The duration of the ban. This property is only present if the `banType` is `temporary`.
       "banType": "A String", # The type of ban.
       "bannedUserDetails": { # The details of the user that was banned.
         "channelId": "A String", # The YouTube channel ID.
@@ -345,14 +345,14 @@ 
Method Details

 
 

     list(liveChatId, part, hl=None, maxResults=None, pageToken=None, profileImageSize=None, x__xgafv=None)
-  
Retrieves a list of resources, possibly filtered.
+  
Retrieves a list of resources, possibly filtered. A call to this method has a quota cost of 5 units.
 
 Args:
-  liveChatId: string, The id of the live chat for which comments should be returned. (required)
-  part: string, The *part* parameter specifies the liveChatComment resource parts that the API response will include. Supported values are id, snippet, and authorDetails. (required) (repeated)
+  liveChatId: string, The ID of the live chat for which messages should be returned. (required)
+  part: string, The `part` parameter specifies the `liveChatMessage` resource parts that the API response includes. Supported values are `id`, `snippet`, and `authorDetails`. (required) (repeated)
   hl: string, Specifies the localization language in which the system messages should be returned.
-  maxResults: integer, The *maxResults* parameter specifies the maximum number of items that should be returned in the result set. Not used in the streaming RPC.
-  pageToken: string, The *pageToken* parameter identifies a specific page in the result set that should be returned. In an API response, the nextPageToken property identify other pages that could be retrieved.
+  maxResults: integer, The `maxResults` parameter specifies the maximum number of items that should be returned in the result set. Not used in the streaming RPC.
+  pageToken: string, The `pageToken` parameter identifies a specific page in the result set that should be returned. In an API response, the `nextPageToken` property identifies other pages that could be retrieved.
   profileImageSize: integer, Specifies the size of the profile image that should be returned for each user.
   x__xgafv: string, V1 error format.
     Allowed values
@@ -380,13 +380,13 @@ 
Method Details

     "snippet": { # Next ID: 35 # The snippet object contains basic details about the message.
       "authorChannelId": "A String", # The ID of the user that authored this message, this field is not always filled. textMessageEvent - the user that wrote the message fanFundingEvent - the user that funded the broadcast newSponsorEvent - the user that just became a sponsor memberMilestoneChatEvent - the member that sent the message membershipGiftingEvent - the user that made the purchase giftMembershipReceivedEvent - the user that received the gift membership messageDeletedEvent - the moderator that took the action. Unused. messageRetractedEvent - the author that retracted their message. Unused. userBannedEvent - the moderator that took the action superChatEvent - the user that made the purchase superStickerEvent - the user that made the purchase pollEvent - the user that created the poll
       "displayMessage": "A String", # Contains a string that can be displayed to the user. If this field is not present the message is silent, at the moment only messages of type TOMBSTONE and CHAT_ENDED_EVENT are silent.
-      "fanFundingEventDetails": { # Details about the funding event, this is only set if the type is 'fanFundingEvent'.
+      "fanFundingEventDetails": { # Details about the funding event, this is only set if the type is `fanFundingEvent`.
         "amountDisplayString": "A String", # A rendered string that displays the fund amount and currency to the user.
         "amountMicros": "A String", # The amount of the fund.
         "currency": "A String", # The currency in which the fund was made.
         "userComment": "A String", # The comment added by the user to this fan funding event.
       },
-      "giftDetails": { # Details about the gift event, this is only set if the type is 'giftEvent'. # Details about the gift event, this is only set if the type is 'giftEvent'.
+      "giftDetails": { # Details about the gift event, this is only set if the type is `giftEvent`. # Details about the gift event, this is only set if the type is `giftEvent`.
         "altText": "A String", # The alternative text to be used for accessibility.
         "comboCount": 42, # The number of times the gift has been sent in a row.
         "giftDuration": "A String", # The duration of the gift.
@@ -396,19 +396,19 @@ 
Method Details

         "jewelsAmount": 42, # The value of the gift in jewels.
         "language": "A String", # The BCP-47 language code of the gift.
       },
-      "giftMembershipReceivedDetails": { # Details about the Gift Membership Received event, this is only set if the type is 'giftMembershipReceivedEvent'.
-        "associatedMembershipGiftingMessageId": "A String", # The ID of the membership gifting message that is related to this gift membership. This ID will always refer to a message whose type is 'membershipGiftingEvent'.
+      "giftMembershipReceivedDetails": { # Details about the Gift Membership Received event, this is only set if the type is `giftMembershipReceivedEvent`.
+        "associatedMembershipGiftingMessageId": "A String", # The ID of the membership gifting message that is related to this gift membership. This ID will always refer to a message whose type is `membershipGiftingEvent`.
         "gifterChannelId": "A String", # The ID of the user that made the membership gifting purchase. This matches the `snippet.authorChannelId` of the associated membership gifting message.
         "memberLevelName": "A String", # The name of the Level at which the viewer is a member. This matches the `snippet.membershipGiftingDetails.giftMembershipsLevelName` of the associated membership gifting message. The Level names are defined by the YouTube channel offering the Membership. In some situations this field isn't filled.
       },
       "hasDisplayContent": True or False, # Whether the message has display content that should be displayed to users.
       "liveChatId": "A String",
-      "memberMilestoneChatDetails": { # Details about the Member Milestone Chat event, this is only set if the type is 'memberMilestoneChatEvent'.
+      "memberMilestoneChatDetails": { # Details about the Member Milestone Chat event, this is only set if the type is `memberMilestoneChatEvent`.
         "memberLevelName": "A String", # The name of the Level at which the viever is a member. The Level names are defined by the YouTube channel offering the Membership. In some situations this field isn't filled.
         "memberMonth": 42, # The total amount of months (rounded up) the viewer has been a member that granted them this Member Milestone Chat. This is the same number of months as is being displayed to YouTube users.
         "userComment": "A String", # The comment added by the member to this Member Milestone Chat. This field is empty for messages without a comment from the member.
       },
-      "membershipGiftingDetails": { # Details about the Membership Gifting event, this is only set if the type is 'membershipGiftingEvent'.
+      "membershipGiftingDetails": { # Details about the Membership Gifting event, this is only set if the type is `membershipGiftingEvent`.
         "giftMembershipsCount": 42, # The number of gift memberships purchased by the user.
         "giftMembershipsLevelName": "A String", # The name of the level of the gift memberships purchased by the user. The Level names are defined by the YouTube channel offering the Membership. In some situations this field isn't filled.
       },
@@ -418,11 +418,11 @@ 
Method Details

       "messageRetractedDetails": {
         "retractedMessageId": "A String",
       },
-      "newSponsorDetails": { # Details about the New Member Announcement event, this is only set if the type is 'newSponsorEvent'. Please note that "member" is the new term for "sponsor".
+      "newSponsorDetails": { # Details about the New Member Announcement event, this is only set if the type is `newSponsorEvent`. The term "member" replaces "sponsor".
         "isUpgrade": True or False, # If the viewer just had upgraded from a lower level. For viewers that were not members at the time of purchase, this field is false.
         "memberLevelName": "A String", # The name of the Level that the viewer just had joined. The Level names are defined by the YouTube channel offering the Membership. In some situations this field isn't filled.
       },
-      "pollDetails": { # Details about the poll event, this is only set if the type is 'pollEvent'.
+      "pollDetails": { # Details about the poll event, this is only set if the type is `pollEvent`.
         "metadata": {
           "options": [ # The options will be returned in the order that is displayed in 1P
             {
@@ -435,14 +435,14 @@ 
Method Details

         "status": "A String",
       },
       "publishedAt": "A String", # The date and time when the message was orignally published.
-      "superChatDetails": { # Details about the Super Chat event, this is only set if the type is 'superChatEvent'.
+      "superChatDetails": { # Details about the Super Chat event, this is only set if the type is `superChatEvent`.
         "amountDisplayString": "A String", # A rendered string that displays the fund amount and currency to the user.
         "amountMicros": "A String", # The amount purchased by the user, in micros (1,750,000 micros = 1.75).
         "currency": "A String", # The currency in which the purchase was made.
-        "tier": 42, # The tier in which the amount belongs. Lower amounts belong to lower tiers. The lowest tier is 1.
+        "tier": 42, # The tier in which the amount belongs. Lower amounts belong to lower tiers. The lowest tier is `1`.
         "userComment": "A String", # The comment added by the user to this Super Chat event.
       },
-      "superStickerDetails": { # Details about the Super Sticker event, this is only set if the type is 'superStickerEvent'.
+      "superStickerDetails": { # Details about the Super Sticker event, this is only set if the type is `superStickerEvent`.
         "amountDisplayString": "A String", # A rendered string that displays the fund amount and currency to the user.
         "amountMicros": "A String", # The amount purchased by the user, in micros (1,750,000 micros = 1.75).
         "currency": "A String", # The currency in which the purchase was made.
@@ -451,14 +451,14 @@ 
Method Details

           "altTextLanguage": "A String", # Specifies the localization language in which the alt text is returned.
           "stickerId": "A String", # Unique identifier of the Super Sticker. This is a shorter form of the alt_text that includes pack name and a recognizable characteristic of the sticker.
         },
-        "tier": 42, # The tier in which the amount belongs. Lower amounts belong to lower tiers. The lowest tier is 1.
+        "tier": 42, # The tier in which the amount belongs. Lower amounts belong to lower tiers. The lowest tier is `1`.
       },
-      "textMessageDetails": { # Details about the text message, this is only set if the type is 'textMessageEvent'.
+      "textMessageDetails": { # Details about the text message, this is only set if the type is `textMessageEvent`.
         "messageText": "A String", # The user's message.
       },
       "type": "A String", # The type of message, this will always be present, it determines the contents of the message as well as which fields will be present.
       "userBannedDetails": {
-        "banDurationSeconds": "A String", # The duration of the ban. This property is only present if the banType is temporary.
+        "banDurationSeconds": "A String", # The duration of the ban. This property is only present if the `banType` is `temporary`.
         "banType": "A String", # The type of ban.
         "bannedUserDetails": { # The details of the user that was banned.
           "channelId": "A String", # The YouTube channel ID.
@@ -489,13 +489,13 @@ 
Method Details

       "snippet": { # Next ID: 35 # The snippet object contains basic details about the message.
         "authorChannelId": "A String", # The ID of the user that authored this message, this field is not always filled. textMessageEvent - the user that wrote the message fanFundingEvent - the user that funded the broadcast newSponsorEvent - the user that just became a sponsor memberMilestoneChatEvent - the member that sent the message membershipGiftingEvent - the user that made the purchase giftMembershipReceivedEvent - the user that received the gift membership messageDeletedEvent - the moderator that took the action. Unused. messageRetractedEvent - the author that retracted their message. Unused. userBannedEvent - the moderator that took the action superChatEvent - the user that made the purchase superStickerEvent - the user that made the purchase pollEvent - the user that created the poll
         "displayMessage": "A String", # Contains a string that can be displayed to the user. If this field is not present the message is silent, at the moment only messages of type TOMBSTONE and CHAT_ENDED_EVENT are silent.
-        "fanFundingEventDetails": { # Details about the funding event, this is only set if the type is 'fanFundingEvent'.
+        "fanFundingEventDetails": { # Details about the funding event, this is only set if the type is `fanFundingEvent`.
           "amountDisplayString": "A String", # A rendered string that displays the fund amount and currency to the user.
           "amountMicros": "A String", # The amount of the fund.
           "currency": "A String", # The currency in which the fund was made.
           "userComment": "A String", # The comment added by the user to this fan funding event.
         },
-        "giftDetails": { # Details about the gift event, this is only set if the type is 'giftEvent'. # Details about the gift event, this is only set if the type is 'giftEvent'.
+        "giftDetails": { # Details about the gift event, this is only set if the type is `giftEvent`. # Details about the gift event, this is only set if the type is `giftEvent`.
           "altText": "A String", # The alternative text to be used for accessibility.
           "comboCount": 42, # The number of times the gift has been sent in a row.
           "giftDuration": "A String", # The duration of the gift.
@@ -505,19 +505,19 @@ 
Method Details

           "jewelsAmount": 42, # The value of the gift in jewels.
           "language": "A String", # The BCP-47 language code of the gift.
         },
-        "giftMembershipReceivedDetails": { # Details about the Gift Membership Received event, this is only set if the type is 'giftMembershipReceivedEvent'.
-          "associatedMembershipGiftingMessageId": "A String", # The ID of the membership gifting message that is related to this gift membership. This ID will always refer to a message whose type is 'membershipGiftingEvent'.
+        "giftMembershipReceivedDetails": { # Details about the Gift Membership Received event, this is only set if the type is `giftMembershipReceivedEvent`.
+          "associatedMembershipGiftingMessageId": "A String", # The ID of the membership gifting message that is related to this gift membership. This ID will always refer to a message whose type is `membershipGiftingEvent`.
           "gifterChannelId": "A String", # The ID of the user that made the membership gifting purchase. This matches the `snippet.authorChannelId` of the associated membership gifting message.
           "memberLevelName": "A String", # The name of the Level at which the viewer is a member. This matches the `snippet.membershipGiftingDetails.giftMembershipsLevelName` of the associated membership gifting message. The Level names are defined by the YouTube channel offering the Membership. In some situations this field isn't filled.
         },
         "hasDisplayContent": True or False, # Whether the message has display content that should be displayed to users.
         "liveChatId": "A String",
-        "memberMilestoneChatDetails": { # Details about the Member Milestone Chat event, this is only set if the type is 'memberMilestoneChatEvent'.
+        "memberMilestoneChatDetails": { # Details about the Member Milestone Chat event, this is only set if the type is `memberMilestoneChatEvent`.
           "memberLevelName": "A String", # The name of the Level at which the viever is a member. The Level names are defined by the YouTube channel offering the Membership. In some situations this field isn't filled.
           "memberMonth": 42, # The total amount of months (rounded up) the viewer has been a member that granted them this Member Milestone Chat. This is the same number of months as is being displayed to YouTube users.
           "userComment": "A String", # The comment added by the member to this Member Milestone Chat. This field is empty for messages without a comment from the member.
         },
-        "membershipGiftingDetails": { # Details about the Membership Gifting event, this is only set if the type is 'membershipGiftingEvent'.
+        "membershipGiftingDetails": { # Details about the Membership Gifting event, this is only set if the type is `membershipGiftingEvent`.
           "giftMembershipsCount": 42, # The number of gift memberships purchased by the user.
           "giftMembershipsLevelName": "A String", # The name of the level of the gift memberships purchased by the user. The Level names are defined by the YouTube channel offering the Membership. In some situations this field isn't filled.
         },
@@ -527,11 +527,11 @@ 
Method Details

         "messageRetractedDetails": {
           "retractedMessageId": "A String",
         },
-        "newSponsorDetails": { # Details about the New Member Announcement event, this is only set if the type is 'newSponsorEvent'. Please note that "member" is the new term for "sponsor".
+        "newSponsorDetails": { # Details about the New Member Announcement event, this is only set if the type is `newSponsorEvent`. The term "member" replaces "sponsor".
           "isUpgrade": True or False, # If the viewer just had upgraded from a lower level. For viewers that were not members at the time of purchase, this field is false.
           "memberLevelName": "A String", # The name of the Level that the viewer just had joined. The Level names are defined by the YouTube channel offering the Membership. In some situations this field isn't filled.
         },
-        "pollDetails": { # Details about the poll event, this is only set if the type is 'pollEvent'.
+        "pollDetails": { # Details about the poll event, this is only set if the type is `pollEvent`.
           "metadata": {
             "options": [ # The options will be returned in the order that is displayed in 1P
               {
@@ -544,14 +544,14 @@ 
Method Details

           "status": "A String",
         },
         "publishedAt": "A String", # The date and time when the message was orignally published.
-        "superChatDetails": { # Details about the Super Chat event, this is only set if the type is 'superChatEvent'.
+        "superChatDetails": { # Details about the Super Chat event, this is only set if the type is `superChatEvent`.
           "amountDisplayString": "A String", # A rendered string that displays the fund amount and currency to the user.
           "amountMicros": "A String", # The amount purchased by the user, in micros (1,750,000 micros = 1.75).
           "currency": "A String", # The currency in which the purchase was made.
-          "tier": 42, # The tier in which the amount belongs. Lower amounts belong to lower tiers. The lowest tier is 1.
+          "tier": 42, # The tier in which the amount belongs. Lower amounts belong to lower tiers. The lowest tier is `1`.
           "userComment": "A String", # The comment added by the user to this Super Chat event.
         },
-        "superStickerDetails": { # Details about the Super Sticker event, this is only set if the type is 'superStickerEvent'.
+        "superStickerDetails": { # Details about the Super Sticker event, this is only set if the type is `superStickerEvent`.
           "amountDisplayString": "A String", # A rendered string that displays the fund amount and currency to the user.
           "amountMicros": "A String", # The amount purchased by the user, in micros (1,750,000 micros = 1.75).
           "currency": "A String", # The currency in which the purchase was made.
@@ -560,14 +560,14 @@ 
Method Details

             "altTextLanguage": "A String", # Specifies the localization language in which the alt text is returned.
             "stickerId": "A String", # Unique identifier of the Super Sticker. This is a shorter form of the alt_text that includes pack name and a recognizable characteristic of the sticker.
           },
-          "tier": 42, # The tier in which the amount belongs. Lower amounts belong to lower tiers. The lowest tier is 1.
+          "tier": 42, # The tier in which the amount belongs. Lower amounts belong to lower tiers. The lowest tier is `1`.
         },
-        "textMessageDetails": { # Details about the text message, this is only set if the type is 'textMessageEvent'.
+        "textMessageDetails": { # Details about the text message, this is only set if the type is `textMessageEvent`.
           "messageText": "A String", # The user's message.
         },
         "type": "A String", # The type of message, this will always be present, it determines the contents of the message as well as which fields will be present.
         "userBannedDetails": {
-          "banDurationSeconds": "A String", # The duration of the ban. This property is only present if the banType is temporary.
+          "banDurationSeconds": "A String", # The duration of the ban. This property is only present if the `banType` is `temporary`.
           "banType": "A String", # The type of ban.
           "bannedUserDetails": { # The details of the user that was banned.
             "channelId": "A String", # The YouTube channel ID.
@@ -579,7 +579,7 @@ 
Method Details

       },
     },
   ],
-  "kind": "youtube#liveChatMessageListResponse", # Identifies what kind of resource this is. Value: the fixed string "youtube#liveChatMessageListResponse".
+  "kind": "youtube#liveChatMessageListResponse", # Identifies what kind of resource this is. Value: the fixed string `"youtube#liveChatMessageListResponse"`.
   "nextPageToken": "A String",
   "offlineAt": "A String", # The date and time when the underlying stream went offline.
   "pageInfo": { # Paging details for lists of resources, including total number of items available and number of resources returned in a single page. # General pagination information.
@@ -589,7 +589,7 @@ 
Method Details

   "pollingIntervalMillis": 42, # The amount of time the client should wait before polling again.
   "tokenPagination": { # Stub token pagination template to suppress results.
   },
-  "visitorId": "A String", # The visitorId identifies the visitor.
+  "visitorId": "A String", # Identifies the visitor.
 }

 

 
@@ -609,10 +609,10 @@ 
Method Details

 
 

     transition(id=None, status=None, x__xgafv=None)
-  
Transition a durable chat event.
+  
Transitions a durable chat event. A call to this method has a quota cost of 20 units.
 
 Args:
-  id: string, The ID that uniquely identify the chat message event to transition.
+  id: string, The ID that uniquely identifies the chat message event to transition.
   status: string, The status to which the chat event is going to transition.
     Allowed values
       statusUnspecified - Default unknown enum value.
@@ -642,13 +642,13 @@ 
Method Details

   "snippet": { # Next ID: 35 # The snippet object contains basic details about the message.
     "authorChannelId": "A String", # The ID of the user that authored this message, this field is not always filled. textMessageEvent - the user that wrote the message fanFundingEvent - the user that funded the broadcast newSponsorEvent - the user that just became a sponsor memberMilestoneChatEvent - the member that sent the message membershipGiftingEvent - the user that made the purchase giftMembershipReceivedEvent - the user that received the gift membership messageDeletedEvent - the moderator that took the action. Unused. messageRetractedEvent - the author that retracted their message. Unused. userBannedEvent - the moderator that took the action superChatEvent - the user that made the purchase superStickerEvent - the user that made the purchase pollEvent - the user that created the poll
     "displayMessage": "A String", # Contains a string that can be displayed to the user. If this field is not present the message is silent, at the moment only messages of type TOMBSTONE and CHAT_ENDED_EVENT are silent.
-    "fanFundingEventDetails": { # Details about the funding event, this is only set if the type is 'fanFundingEvent'.
+    "fanFundingEventDetails": { # Details about the funding event, this is only set if the type is `fanFundingEvent`.
       "amountDisplayString": "A String", # A rendered string that displays the fund amount and currency to the user.
       "amountMicros": "A String", # The amount of the fund.
       "currency": "A String", # The currency in which the fund was made.
       "userComment": "A String", # The comment added by the user to this fan funding event.
     },
-    "giftDetails": { # Details about the gift event, this is only set if the type is 'giftEvent'. # Details about the gift event, this is only set if the type is 'giftEvent'.
+    "giftDetails": { # Details about the gift event, this is only set if the type is `giftEvent`. # Details about the gift event, this is only set if the type is `giftEvent`.
       "altText": "A String", # The alternative text to be used for accessibility.
       "comboCount": 42, # The number of times the gift has been sent in a row.
       "giftDuration": "A String", # The duration of the gift.
@@ -658,19 +658,19 @@ 
Method Details

       "jewelsAmount": 42, # The value of the gift in jewels.
       "language": "A String", # The BCP-47 language code of the gift.
     },
-    "giftMembershipReceivedDetails": { # Details about the Gift Membership Received event, this is only set if the type is 'giftMembershipReceivedEvent'.
-      "associatedMembershipGiftingMessageId": "A String", # The ID of the membership gifting message that is related to this gift membership. This ID will always refer to a message whose type is 'membershipGiftingEvent'.
+    "giftMembershipReceivedDetails": { # Details about the Gift Membership Received event, this is only set if the type is `giftMembershipReceivedEvent`.
+      "associatedMembershipGiftingMessageId": "A String", # The ID of the membership gifting message that is related to this gift membership. This ID will always refer to a message whose type is `membershipGiftingEvent`.
       "gifterChannelId": "A String", # The ID of the user that made the membership gifting purchase. This matches the `snippet.authorChannelId` of the associated membership gifting message.
       "memberLevelName": "A String", # The name of the Level at which the viewer is a member. This matches the `snippet.membershipGiftingDetails.giftMembershipsLevelName` of the associated membership gifting message. The Level names are defined by the YouTube channel offering the Membership. In some situations this field isn't filled.
     },
     "hasDisplayContent": True or False, # Whether the message has display content that should be displayed to users.
     "liveChatId": "A String",
-    "memberMilestoneChatDetails": { # Details about the Member Milestone Chat event, this is only set if the type is 'memberMilestoneChatEvent'.
+    "memberMilestoneChatDetails": { # Details about the Member Milestone Chat event, this is only set if the type is `memberMilestoneChatEvent`.
       "memberLevelName": "A String", # The name of the Level at which the viever is a member. The Level names are defined by the YouTube channel offering the Membership. In some situations this field isn't filled.
       "memberMonth": 42, # The total amount of months (rounded up) the viewer has been a member that granted them this Member Milestone Chat. This is the same number of months as is being displayed to YouTube users.
       "userComment": "A String", # The comment added by the member to this Member Milestone Chat. This field is empty for messages without a comment from the member.
     },
-    "membershipGiftingDetails": { # Details about the Membership Gifting event, this is only set if the type is 'membershipGiftingEvent'.
+    "membershipGiftingDetails": { # Details about the Membership Gifting event, this is only set if the type is `membershipGiftingEvent`.
       "giftMembershipsCount": 42, # The number of gift memberships purchased by the user.
       "giftMembershipsLevelName": "A String", # The name of the level of the gift memberships purchased by the user. The Level names are defined by the YouTube channel offering the Membership. In some situations this field isn't filled.
     },
@@ -680,11 +680,11 @@ 
Method Details

     "messageRetractedDetails": {
       "retractedMessageId": "A String",
     },
-    "newSponsorDetails": { # Details about the New Member Announcement event, this is only set if the type is 'newSponsorEvent'. Please note that "member" is the new term for "sponsor".
+    "newSponsorDetails": { # Details about the New Member Announcement event, this is only set if the type is `newSponsorEvent`. The term "member" replaces "sponsor".
       "isUpgrade": True or False, # If the viewer just had upgraded from a lower level. For viewers that were not members at the time of purchase, this field is false.
       "memberLevelName": "A String", # The name of the Level that the viewer just had joined. The Level names are defined by the YouTube channel offering the Membership. In some situations this field isn't filled.
     },
-    "pollDetails": { # Details about the poll event, this is only set if the type is 'pollEvent'.
+    "pollDetails": { # Details about the poll event, this is only set if the type is `pollEvent`.
       "metadata": {
         "options": [ # The options will be returned in the order that is displayed in 1P
           {
@@ -697,14 +697,14 @@ 
Method Details

       "status": "A String",
     },
     "publishedAt": "A String", # The date and time when the message was orignally published.
-    "superChatDetails": { # Details about the Super Chat event, this is only set if the type is 'superChatEvent'.
+    "superChatDetails": { # Details about the Super Chat event, this is only set if the type is `superChatEvent`.
       "amountDisplayString": "A String", # A rendered string that displays the fund amount and currency to the user.
       "amountMicros": "A String", # The amount purchased by the user, in micros (1,750,000 micros = 1.75).
       "currency": "A String", # The currency in which the purchase was made.
-      "tier": 42, # The tier in which the amount belongs. Lower amounts belong to lower tiers. The lowest tier is 1.
+      "tier": 42, # The tier in which the amount belongs. Lower amounts belong to lower tiers. The lowest tier is `1`.
       "userComment": "A String", # The comment added by the user to this Super Chat event.
     },
-    "superStickerDetails": { # Details about the Super Sticker event, this is only set if the type is 'superStickerEvent'.
+    "superStickerDetails": { # Details about the Super Sticker event, this is only set if the type is `superStickerEvent`.
       "amountDisplayString": "A String", # A rendered string that displays the fund amount and currency to the user.
       "amountMicros": "A String", # The amount purchased by the user, in micros (1,750,000 micros = 1.75).
       "currency": "A String", # The currency in which the purchase was made.
@@ -713,14 +713,14 @@ 
Method Details

         "altTextLanguage": "A String", # Specifies the localization language in which the alt text is returned.
         "stickerId": "A String", # Unique identifier of the Super Sticker. This is a shorter form of the alt_text that includes pack name and a recognizable characteristic of the sticker.
       },
-      "tier": 42, # The tier in which the amount belongs. Lower amounts belong to lower tiers. The lowest tier is 1.
+      "tier": 42, # The tier in which the amount belongs. Lower amounts belong to lower tiers. The lowest tier is `1`.
     },
-    "textMessageDetails": { # Details about the text message, this is only set if the type is 'textMessageEvent'.
+    "textMessageDetails": { # Details about the text message, this is only set if the type is `textMessageEvent`.
       "messageText": "A String", # The user's message.
     },
     "type": "A String", # The type of message, this will always be present, it determines the contents of the message as well as which fields will be present.
     "userBannedDetails": {
-      "banDurationSeconds": "A String", # The duration of the ban. This property is only present if the banType is temporary.
+      "banDurationSeconds": "A String", # The duration of the ban. This property is only present if the `banType` is `temporary`.
       "banType": "A String", # The type of ban.
       "bannedUserDetails": { # The details of the user that was banned.
         "channelId": "A String", # The YouTube channel ID.
diff --git a/docs/dyn/youtube_v3.videos.html b/docs/dyn/youtube_v3.videos.html
index 5810e76918..1fe0afc601 100644
--- a/docs/dyn/youtube_v3.videos.html
+++ b/docs/dyn/youtube_v3.videos.html
@@ -469,13 +469,13 @@ 
Method Details

   "status": { # Basic details about a video category, such as its localized title. Next Id: 20 # The status object contains information about the video's uploading, processing, and privacy statuses.
     "containsSyntheticMedia": True or False, # Indicates if the video contains altered or synthetic media.
     "embeddable": True or False, # This value indicates if the video can be embedded on another website. @mutable youtube.videos.insert youtube.videos.update
-    "failureReason": "A String", # This value explains why a video failed to upload. This property is only present if the uploadStatus property indicates that the upload failed.
+    "failureReason": "A String", # This value explains why a video failed to upload. This property is only present if the `uploadStatus` property indicates that the upload failed.
     "license": "A String", # The video's license. @mutable youtube.videos.insert youtube.videos.update
     "madeForKids": True or False,
-    "privacyStatus": "A String", # The video's privacy status.
+    "privacyStatus": "A String", # The video's privacy status. In a `videos.insert` request, if you don't specify a value for this property, the uploaded video's privacy status defaults to `public`. Certain uploads might default to `private` based on creator account settings, as explained in the [YouTube Help Center](https://support.google.com/youtube/answer/157177). Videos uploaded from unverified API projects are not restricted to private viewing mode.
     "publicStatsViewable": True or False, # This value indicates if the extended video statistics on the watch page can be viewed by everyone. Note that the view count, likes, etc will still be visible if this is disabled. @mutable youtube.videos.insert youtube.videos.update
     "publishAt": "A String", # The date and time when the video is scheduled to publish. It can be set only if the privacy status of the video is private..
-    "rejectionReason": "A String", # This value explains why YouTube rejected an uploaded video. This property is only present if the uploadStatus property indicates that the upload was rejected.
+    "rejectionReason": "A String", # This value explains why YouTube rejected an uploaded video. This property is only present if the `uploadStatus` property indicates that the upload was rejected.
     "selfDeclaredMadeForKids": True or False,
     "uploadStatus": "A String", # The status of the uploaded video.
   },
@@ -796,13 +796,13 @@ 
Method Details

   "status": { # Basic details about a video category, such as its localized title. Next Id: 20 # The status object contains information about the video's uploading, processing, and privacy statuses.
     "containsSyntheticMedia": True or False, # Indicates if the video contains altered or synthetic media.
     "embeddable": True or False, # This value indicates if the video can be embedded on another website. @mutable youtube.videos.insert youtube.videos.update
-    "failureReason": "A String", # This value explains why a video failed to upload. This property is only present if the uploadStatus property indicates that the upload failed.
+    "failureReason": "A String", # This value explains why a video failed to upload. This property is only present if the `uploadStatus` property indicates that the upload failed.
     "license": "A String", # The video's license. @mutable youtube.videos.insert youtube.videos.update
     "madeForKids": True or False,
-    "privacyStatus": "A String", # The video's privacy status.
+    "privacyStatus": "A String", # The video's privacy status. In a `videos.insert` request, if you don't specify a value for this property, the uploaded video's privacy status defaults to `public`. Certain uploads might default to `private` based on creator account settings, as explained in the [YouTube Help Center](https://support.google.com/youtube/answer/157177). Videos uploaded from unverified API projects are not restricted to private viewing mode.
     "publicStatsViewable": True or False, # This value indicates if the extended video statistics on the watch page can be viewed by everyone. Note that the view count, likes, etc will still be visible if this is disabled. @mutable youtube.videos.insert youtube.videos.update
     "publishAt": "A String", # The date and time when the video is scheduled to publish. It can be set only if the privacy status of the video is private..
-    "rejectionReason": "A String", # This value explains why YouTube rejected an uploaded video. This property is only present if the uploadStatus property indicates that the upload was rejected.
+    "rejectionReason": "A String", # This value explains why YouTube rejected an uploaded video. This property is only present if the `uploadStatus` property indicates that the upload was rejected.
     "selfDeclaredMadeForKids": True or False,
     "uploadStatus": "A String", # The status of the uploaded video.
   },
@@ -1146,13 +1146,13 @@ 
Method Details

       "status": { # Basic details about a video category, such as its localized title. Next Id: 20 # The status object contains information about the video's uploading, processing, and privacy statuses.
         "containsSyntheticMedia": True or False, # Indicates if the video contains altered or synthetic media.
         "embeddable": True or False, # This value indicates if the video can be embedded on another website. @mutable youtube.videos.insert youtube.videos.update
-        "failureReason": "A String", # This value explains why a video failed to upload. This property is only present if the uploadStatus property indicates that the upload failed.
+        "failureReason": "A String", # This value explains why a video failed to upload. This property is only present if the `uploadStatus` property indicates that the upload failed.
         "license": "A String", # The video's license. @mutable youtube.videos.insert youtube.videos.update
         "madeForKids": True or False,
-        "privacyStatus": "A String", # The video's privacy status.
+        "privacyStatus": "A String", # The video's privacy status. In a `videos.insert` request, if you don't specify a value for this property, the uploaded video's privacy status defaults to `public`. Certain uploads might default to `private` based on creator account settings, as explained in the [YouTube Help Center](https://support.google.com/youtube/answer/157177). Videos uploaded from unverified API projects are not restricted to private viewing mode.
         "publicStatsViewable": True or False, # This value indicates if the extended video statistics on the watch page can be viewed by everyone. Note that the view count, likes, etc will still be visible if this is disabled. @mutable youtube.videos.insert youtube.videos.update
         "publishAt": "A String", # The date and time when the video is scheduled to publish. It can be set only if the privacy status of the video is private..
-        "rejectionReason": "A String", # This value explains why YouTube rejected an uploaded video. This property is only present if the uploadStatus property indicates that the upload was rejected.
+        "rejectionReason": "A String", # This value explains why YouTube rejected an uploaded video. This property is only present if the `uploadStatus` property indicates that the upload was rejected.
         "selfDeclaredMadeForKids": True or False,
         "uploadStatus": "A String", # The status of the uploaded video.
       },
@@ -1536,13 +1536,13 @@ 
Method Details

   "status": { # Basic details about a video category, such as its localized title. Next Id: 20 # The status object contains information about the video's uploading, processing, and privacy statuses.
     "containsSyntheticMedia": True or False, # Indicates if the video contains altered or synthetic media.
     "embeddable": True or False, # This value indicates if the video can be embedded on another website. @mutable youtube.videos.insert youtube.videos.update
-    "failureReason": "A String", # This value explains why a video failed to upload. This property is only present if the uploadStatus property indicates that the upload failed.
+    "failureReason": "A String", # This value explains why a video failed to upload. This property is only present if the `uploadStatus` property indicates that the upload failed.
     "license": "A String", # The video's license. @mutable youtube.videos.insert youtube.videos.update
     "madeForKids": True or False,
-    "privacyStatus": "A String", # The video's privacy status.
+    "privacyStatus": "A String", # The video's privacy status. In a `videos.insert` request, if you don't specify a value for this property, the uploaded video's privacy status defaults to `public`. Certain uploads might default to `private` based on creator account settings, as explained in the [YouTube Help Center](https://support.google.com/youtube/answer/157177). Videos uploaded from unverified API projects are not restricted to private viewing mode.
     "publicStatsViewable": True or False, # This value indicates if the extended video statistics on the watch page can be viewed by everyone. Note that the view count, likes, etc will still be visible if this is disabled. @mutable youtube.videos.insert youtube.videos.update
     "publishAt": "A String", # The date and time when the video is scheduled to publish. It can be set only if the privacy status of the video is private..
-    "rejectionReason": "A String", # This value explains why YouTube rejected an uploaded video. This property is only present if the uploadStatus property indicates that the upload was rejected.
+    "rejectionReason": "A String", # This value explains why YouTube rejected an uploaded video. This property is only present if the `uploadStatus` property indicates that the upload was rejected.
     "selfDeclaredMadeForKids": True or False,
     "uploadStatus": "A String", # The status of the uploaded video.
   },
@@ -1857,13 +1857,13 @@ 
Method Details

   "status": { # Basic details about a video category, such as its localized title. Next Id: 20 # The status object contains information about the video's uploading, processing, and privacy statuses.
     "containsSyntheticMedia": True or False, # Indicates if the video contains altered or synthetic media.
     "embeddable": True or False, # This value indicates if the video can be embedded on another website. @mutable youtube.videos.insert youtube.videos.update
-    "failureReason": "A String", # This value explains why a video failed to upload. This property is only present if the uploadStatus property indicates that the upload failed.
+    "failureReason": "A String", # This value explains why a video failed to upload. This property is only present if the `uploadStatus` property indicates that the upload failed.
     "license": "A String", # The video's license. @mutable youtube.videos.insert youtube.videos.update
     "madeForKids": True or False,
-    "privacyStatus": "A String", # The video's privacy status.
+    "privacyStatus": "A String", # The video's privacy status. In a `videos.insert` request, if you don't specify a value for this property, the uploaded video's privacy status defaults to `public`. Certain uploads might default to `private` based on creator account settings, as explained in the [YouTube Help Center](https://support.google.com/youtube/answer/157177). Videos uploaded from unverified API projects are not restricted to private viewing mode.
     "publicStatsViewable": True or False, # This value indicates if the extended video statistics on the watch page can be viewed by everyone. Note that the view count, likes, etc will still be visible if this is disabled. @mutable youtube.videos.insert youtube.videos.update
     "publishAt": "A String", # The date and time when the video is scheduled to publish. It can be set only if the privacy status of the video is private..
-    "rejectionReason": "A String", # This value explains why YouTube rejected an uploaded video. This property is only present if the uploadStatus property indicates that the upload was rejected.
+    "rejectionReason": "A String", # This value explains why YouTube rejected an uploaded video. This property is only present if the `uploadStatus` property indicates that the upload was rejected.
     "selfDeclaredMadeForKids": True or False,
     "uploadStatus": "A String", # The status of the uploaded video.
   },
diff --git a/docs/dyn/youtube_v3.youtube.v3.liveChat.messages.html b/docs/dyn/youtube_v3.youtube.v3.liveChat.messages.html
index 940b273bae..a8c74ebb0b 100644
--- a/docs/dyn/youtube_v3.youtube.v3.liveChat.messages.html
+++ b/docs/dyn/youtube_v3.youtube.v3.liveChat.messages.html
@@ -79,7 +79,7 @@ 
Instance Methods

 
Close httplib2 connections.

 

   stream(hl=None, liveChatId=None, maxResults=None, pageToken=None, part=None, profileImageSize=None, x__xgafv=None)

-
Allows a user to load live chat through a server-streamed RPC.

+
Allows a user to load live chat through a server-streamed RPC. A call to this method has a quota cost of 5 units.

 

   stream_next(previous_request, previous_response)

 
Retrieves the next page of results.

@@ -91,14 +91,14 @@ 
Method Details

 
 

     stream(hl=None, liveChatId=None, maxResults=None, pageToken=None, part=None, profileImageSize=None, x__xgafv=None)
-  
Allows a user to load live chat through a server-streamed RPC.
+  
Allows a user to load live chat through a server-streamed RPC. A call to this method has a quota cost of 5 units.
 
 Args:
   hl: string, Specifies the localization language in which the system messages should be returned.
-  liveChatId: string, The id of the live chat for which comments should be returned.
-  maxResults: integer, The *maxResults* parameter specifies the maximum number of items that should be returned in the result set. Not used in the streaming RPC.
-  pageToken: string, The *pageToken* parameter identifies a specific page in the result set that should be returned. In an API response, the nextPageToken property identify other pages that could be retrieved.
-  part: string, The *part* parameter specifies the liveChatComment resource parts that the API response will include. Supported values are id, snippet, and authorDetails. (repeated)
+  liveChatId: string, The ID of the live chat for which messages should be returned.
+  maxResults: integer, The `maxResults` parameter specifies the maximum number of items that should be returned in the result set. Not used in the streaming RPC.
+  pageToken: string, The `pageToken` parameter identifies a specific page in the result set that should be returned. In an API response, the `nextPageToken` property identifies other pages that could be retrieved.
+  part: string, The `part` parameter specifies the `liveChatMessage` resource parts that the API response includes. Supported values are `id`, `snippet`, and `authorDetails`. (repeated)
   profileImageSize: integer, Specifies the size of the profile image that should be returned for each user.
   x__xgafv: string, V1 error format.
     Allowed values
@@ -126,13 +126,13 @@ 
Method Details

     "snippet": { # Next ID: 35 # The snippet object contains basic details about the message.
       "authorChannelId": "A String", # The ID of the user that authored this message, this field is not always filled. textMessageEvent - the user that wrote the message fanFundingEvent - the user that funded the broadcast newSponsorEvent - the user that just became a sponsor memberMilestoneChatEvent - the member that sent the message membershipGiftingEvent - the user that made the purchase giftMembershipReceivedEvent - the user that received the gift membership messageDeletedEvent - the moderator that took the action. Unused. messageRetractedEvent - the author that retracted their message. Unused. userBannedEvent - the moderator that took the action superChatEvent - the user that made the purchase superStickerEvent - the user that made the purchase pollEvent - the user that created the poll
       "displayMessage": "A String", # Contains a string that can be displayed to the user. If this field is not present the message is silent, at the moment only messages of type TOMBSTONE and CHAT_ENDED_EVENT are silent.
-      "fanFundingEventDetails": { # Details about the funding event, this is only set if the type is 'fanFundingEvent'.
+      "fanFundingEventDetails": { # Details about the funding event, this is only set if the type is `fanFundingEvent`.
         "amountDisplayString": "A String", # A rendered string that displays the fund amount and currency to the user.
         "amountMicros": "A String", # The amount of the fund.
         "currency": "A String", # The currency in which the fund was made.
         "userComment": "A String", # The comment added by the user to this fan funding event.
       },
-      "giftDetails": { # Details about the gift event, this is only set if the type is 'giftEvent'. # Details about the gift event, this is only set if the type is 'giftEvent'.
+      "giftDetails": { # Details about the gift event, this is only set if the type is `giftEvent`. # Details about the gift event, this is only set if the type is `giftEvent`.
         "altText": "A String", # The alternative text to be used for accessibility.
         "comboCount": 42, # The number of times the gift has been sent in a row.
         "giftDuration": "A String", # The duration of the gift.
@@ -142,19 +142,19 @@ 
Method Details

         "jewelsAmount": 42, # The value of the gift in jewels.
         "language": "A String", # The BCP-47 language code of the gift.
       },
-      "giftMembershipReceivedDetails": { # Details about the Gift Membership Received event, this is only set if the type is 'giftMembershipReceivedEvent'.
-        "associatedMembershipGiftingMessageId": "A String", # The ID of the membership gifting message that is related to this gift membership. This ID will always refer to a message whose type is 'membershipGiftingEvent'.
+      "giftMembershipReceivedDetails": { # Details about the Gift Membership Received event, this is only set if the type is `giftMembershipReceivedEvent`.
+        "associatedMembershipGiftingMessageId": "A String", # The ID of the membership gifting message that is related to this gift membership. This ID will always refer to a message whose type is `membershipGiftingEvent`.
         "gifterChannelId": "A String", # The ID of the user that made the membership gifting purchase. This matches the `snippet.authorChannelId` of the associated membership gifting message.
         "memberLevelName": "A String", # The name of the Level at which the viewer is a member. This matches the `snippet.membershipGiftingDetails.giftMembershipsLevelName` of the associated membership gifting message. The Level names are defined by the YouTube channel offering the Membership. In some situations this field isn't filled.
       },
       "hasDisplayContent": True or False, # Whether the message has display content that should be displayed to users.
       "liveChatId": "A String",
-      "memberMilestoneChatDetails": { # Details about the Member Milestone Chat event, this is only set if the type is 'memberMilestoneChatEvent'.
+      "memberMilestoneChatDetails": { # Details about the Member Milestone Chat event, this is only set if the type is `memberMilestoneChatEvent`.
         "memberLevelName": "A String", # The name of the Level at which the viever is a member. The Level names are defined by the YouTube channel offering the Membership. In some situations this field isn't filled.
         "memberMonth": 42, # The total amount of months (rounded up) the viewer has been a member that granted them this Member Milestone Chat. This is the same number of months as is being displayed to YouTube users.
         "userComment": "A String", # The comment added by the member to this Member Milestone Chat. This field is empty for messages without a comment from the member.
       },
-      "membershipGiftingDetails": { # Details about the Membership Gifting event, this is only set if the type is 'membershipGiftingEvent'.
+      "membershipGiftingDetails": { # Details about the Membership Gifting event, this is only set if the type is `membershipGiftingEvent`.
         "giftMembershipsCount": 42, # The number of gift memberships purchased by the user.
         "giftMembershipsLevelName": "A String", # The name of the level of the gift memberships purchased by the user. The Level names are defined by the YouTube channel offering the Membership. In some situations this field isn't filled.
       },
@@ -164,11 +164,11 @@ 
Method Details

       "messageRetractedDetails": {
         "retractedMessageId": "A String",
       },
-      "newSponsorDetails": { # Details about the New Member Announcement event, this is only set if the type is 'newSponsorEvent'. Please note that "member" is the new term for "sponsor".
+      "newSponsorDetails": { # Details about the New Member Announcement event, this is only set if the type is `newSponsorEvent`. The term "member" replaces "sponsor".
         "isUpgrade": True or False, # If the viewer just had upgraded from a lower level. For viewers that were not members at the time of purchase, this field is false.
         "memberLevelName": "A String", # The name of the Level that the viewer just had joined. The Level names are defined by the YouTube channel offering the Membership. In some situations this field isn't filled.
       },
-      "pollDetails": { # Details about the poll event, this is only set if the type is 'pollEvent'.
+      "pollDetails": { # Details about the poll event, this is only set if the type is `pollEvent`.
         "metadata": {
           "options": [ # The options will be returned in the order that is displayed in 1P
             {
@@ -181,14 +181,14 @@ 
Method Details

         "status": "A String",
       },
       "publishedAt": "A String", # The date and time when the message was orignally published.
-      "superChatDetails": { # Details about the Super Chat event, this is only set if the type is 'superChatEvent'.
+      "superChatDetails": { # Details about the Super Chat event, this is only set if the type is `superChatEvent`.
         "amountDisplayString": "A String", # A rendered string that displays the fund amount and currency to the user.
         "amountMicros": "A String", # The amount purchased by the user, in micros (1,750,000 micros = 1.75).
         "currency": "A String", # The currency in which the purchase was made.
-        "tier": 42, # The tier in which the amount belongs. Lower amounts belong to lower tiers. The lowest tier is 1.
+        "tier": 42, # The tier in which the amount belongs. Lower amounts belong to lower tiers. The lowest tier is `1`.
         "userComment": "A String", # The comment added by the user to this Super Chat event.
       },
-      "superStickerDetails": { # Details about the Super Sticker event, this is only set if the type is 'superStickerEvent'.
+      "superStickerDetails": { # Details about the Super Sticker event, this is only set if the type is `superStickerEvent`.
         "amountDisplayString": "A String", # A rendered string that displays the fund amount and currency to the user.
         "amountMicros": "A String", # The amount purchased by the user, in micros (1,750,000 micros = 1.75).
         "currency": "A String", # The currency in which the purchase was made.
@@ -197,14 +197,14 @@ 
Method Details

           "altTextLanguage": "A String", # Specifies the localization language in which the alt text is returned.
           "stickerId": "A String", # Unique identifier of the Super Sticker. This is a shorter form of the alt_text that includes pack name and a recognizable characteristic of the sticker.
         },
-        "tier": 42, # The tier in which the amount belongs. Lower amounts belong to lower tiers. The lowest tier is 1.
+        "tier": 42, # The tier in which the amount belongs. Lower amounts belong to lower tiers. The lowest tier is `1`.
       },
-      "textMessageDetails": { # Details about the text message, this is only set if the type is 'textMessageEvent'.
+      "textMessageDetails": { # Details about the text message, this is only set if the type is `textMessageEvent`.
         "messageText": "A String", # The user's message.
       },
       "type": "A String", # The type of message, this will always be present, it determines the contents of the message as well as which fields will be present.
       "userBannedDetails": {
-        "banDurationSeconds": "A String", # The duration of the ban. This property is only present if the banType is temporary.
+        "banDurationSeconds": "A String", # The duration of the ban. This property is only present if the `banType` is `temporary`.
         "banType": "A String", # The type of ban.
         "bannedUserDetails": { # The details of the user that was banned.
           "channelId": "A String", # The YouTube channel ID.
@@ -235,13 +235,13 @@ 
Method Details

       "snippet": { # Next ID: 35 # The snippet object contains basic details about the message.
         "authorChannelId": "A String", # The ID of the user that authored this message, this field is not always filled. textMessageEvent - the user that wrote the message fanFundingEvent - the user that funded the broadcast newSponsorEvent - the user that just became a sponsor memberMilestoneChatEvent - the member that sent the message membershipGiftingEvent - the user that made the purchase giftMembershipReceivedEvent - the user that received the gift membership messageDeletedEvent - the moderator that took the action. Unused. messageRetractedEvent - the author that retracted their message. Unused. userBannedEvent - the moderator that took the action superChatEvent - the user that made the purchase superStickerEvent - the user that made the purchase pollEvent - the user that created the poll
         "displayMessage": "A String", # Contains a string that can be displayed to the user. If this field is not present the message is silent, at the moment only messages of type TOMBSTONE and CHAT_ENDED_EVENT are silent.
-        "fanFundingEventDetails": { # Details about the funding event, this is only set if the type is 'fanFundingEvent'.
+        "fanFundingEventDetails": { # Details about the funding event, this is only set if the type is `fanFundingEvent`.
           "amountDisplayString": "A String", # A rendered string that displays the fund amount and currency to the user.
           "amountMicros": "A String", # The amount of the fund.
           "currency": "A String", # The currency in which the fund was made.
           "userComment": "A String", # The comment added by the user to this fan funding event.
         },
-        "giftDetails": { # Details about the gift event, this is only set if the type is 'giftEvent'. # Details about the gift event, this is only set if the type is 'giftEvent'.
+        "giftDetails": { # Details about the gift event, this is only set if the type is `giftEvent`. # Details about the gift event, this is only set if the type is `giftEvent`.
           "altText": "A String", # The alternative text to be used for accessibility.
           "comboCount": 42, # The number of times the gift has been sent in a row.
           "giftDuration": "A String", # The duration of the gift.
@@ -251,19 +251,19 @@ 
Method Details

           "jewelsAmount": 42, # The value of the gift in jewels.
           "language": "A String", # The BCP-47 language code of the gift.
         },
-        "giftMembershipReceivedDetails": { # Details about the Gift Membership Received event, this is only set if the type is 'giftMembershipReceivedEvent'.
-          "associatedMembershipGiftingMessageId": "A String", # The ID of the membership gifting message that is related to this gift membership. This ID will always refer to a message whose type is 'membershipGiftingEvent'.
+        "giftMembershipReceivedDetails": { # Details about the Gift Membership Received event, this is only set if the type is `giftMembershipReceivedEvent`.
+          "associatedMembershipGiftingMessageId": "A String", # The ID of the membership gifting message that is related to this gift membership. This ID will always refer to a message whose type is `membershipGiftingEvent`.
           "gifterChannelId": "A String", # The ID of the user that made the membership gifting purchase. This matches the `snippet.authorChannelId` of the associated membership gifting message.
           "memberLevelName": "A String", # The name of the Level at which the viewer is a member. This matches the `snippet.membershipGiftingDetails.giftMembershipsLevelName` of the associated membership gifting message. The Level names are defined by the YouTube channel offering the Membership. In some situations this field isn't filled.
         },
         "hasDisplayContent": True or False, # Whether the message has display content that should be displayed to users.
         "liveChatId": "A String",
-        "memberMilestoneChatDetails": { # Details about the Member Milestone Chat event, this is only set if the type is 'memberMilestoneChatEvent'.
+        "memberMilestoneChatDetails": { # Details about the Member Milestone Chat event, this is only set if the type is `memberMilestoneChatEvent`.
           "memberLevelName": "A String", # The name of the Level at which the viever is a member. The Level names are defined by the YouTube channel offering the Membership. In some situations this field isn't filled.
           "memberMonth": 42, # The total amount of months (rounded up) the viewer has been a member that granted them this Member Milestone Chat. This is the same number of months as is being displayed to YouTube users.
           "userComment": "A String", # The comment added by the member to this Member Milestone Chat. This field is empty for messages without a comment from the member.
         },
-        "membershipGiftingDetails": { # Details about the Membership Gifting event, this is only set if the type is 'membershipGiftingEvent'.
+        "membershipGiftingDetails": { # Details about the Membership Gifting event, this is only set if the type is `membershipGiftingEvent`.
           "giftMembershipsCount": 42, # The number of gift memberships purchased by the user.
           "giftMembershipsLevelName": "A String", # The name of the level of the gift memberships purchased by the user. The Level names are defined by the YouTube channel offering the Membership. In some situations this field isn't filled.
         },
@@ -273,11 +273,11 @@ 
Method Details

         "messageRetractedDetails": {
           "retractedMessageId": "A String",
         },
-        "newSponsorDetails": { # Details about the New Member Announcement event, this is only set if the type is 'newSponsorEvent'. Please note that "member" is the new term for "sponsor".
+        "newSponsorDetails": { # Details about the New Member Announcement event, this is only set if the type is `newSponsorEvent`. The term "member" replaces "sponsor".
           "isUpgrade": True or False, # If the viewer just had upgraded from a lower level. For viewers that were not members at the time of purchase, this field is false.
           "memberLevelName": "A String", # The name of the Level that the viewer just had joined. The Level names are defined by the YouTube channel offering the Membership. In some situations this field isn't filled.
         },
-        "pollDetails": { # Details about the poll event, this is only set if the type is 'pollEvent'.
+        "pollDetails": { # Details about the poll event, this is only set if the type is `pollEvent`.
           "metadata": {
             "options": [ # The options will be returned in the order that is displayed in 1P
               {
@@ -290,14 +290,14 @@ 
Method Details

           "status": "A String",
         },
         "publishedAt": "A String", # The date and time when the message was orignally published.
-        "superChatDetails": { # Details about the Super Chat event, this is only set if the type is 'superChatEvent'.
+        "superChatDetails": { # Details about the Super Chat event, this is only set if the type is `superChatEvent`.
           "amountDisplayString": "A String", # A rendered string that displays the fund amount and currency to the user.
           "amountMicros": "A String", # The amount purchased by the user, in micros (1,750,000 micros = 1.75).
           "currency": "A String", # The currency in which the purchase was made.
-          "tier": 42, # The tier in which the amount belongs. Lower amounts belong to lower tiers. The lowest tier is 1.
+          "tier": 42, # The tier in which the amount belongs. Lower amounts belong to lower tiers. The lowest tier is `1`.
           "userComment": "A String", # The comment added by the user to this Super Chat event.
         },
-        "superStickerDetails": { # Details about the Super Sticker event, this is only set if the type is 'superStickerEvent'.
+        "superStickerDetails": { # Details about the Super Sticker event, this is only set if the type is `superStickerEvent`.
           "amountDisplayString": "A String", # A rendered string that displays the fund amount and currency to the user.
           "amountMicros": "A String", # The amount purchased by the user, in micros (1,750,000 micros = 1.75).
           "currency": "A String", # The currency in which the purchase was made.
@@ -306,14 +306,14 @@ 
Method Details

             "altTextLanguage": "A String", # Specifies the localization language in which the alt text is returned.
             "stickerId": "A String", # Unique identifier of the Super Sticker. This is a shorter form of the alt_text that includes pack name and a recognizable characteristic of the sticker.
           },
-          "tier": 42, # The tier in which the amount belongs. Lower amounts belong to lower tiers. The lowest tier is 1.
+          "tier": 42, # The tier in which the amount belongs. Lower amounts belong to lower tiers. The lowest tier is `1`.
         },
-        "textMessageDetails": { # Details about the text message, this is only set if the type is 'textMessageEvent'.
+        "textMessageDetails": { # Details about the text message, this is only set if the type is `textMessageEvent`.
           "messageText": "A String", # The user's message.
         },
         "type": "A String", # The type of message, this will always be present, it determines the contents of the message as well as which fields will be present.
         "userBannedDetails": {
-          "banDurationSeconds": "A String", # The duration of the ban. This property is only present if the banType is temporary.
+          "banDurationSeconds": "A String", # The duration of the ban. This property is only present if the `banType` is `temporary`.
           "banType": "A String", # The type of ban.
           "bannedUserDetails": { # The details of the user that was banned.
             "channelId": "A String", # The YouTube channel ID.
@@ -325,7 +325,7 @@ 
Method Details

       },
     },
   ],
-  "kind": "youtube#liveChatMessageListResponse", # Identifies what kind of resource this is. Value: the fixed string "youtube#liveChatMessageListResponse".
+  "kind": "youtube#liveChatMessageListResponse", # Identifies what kind of resource this is. Value: the fixed string `"youtube#liveChatMessageListResponse"`.
   "nextPageToken": "A String",
   "offlineAt": "A String", # The date and time when the underlying stream went offline.
   "pageInfo": { # Paging details for lists of resources, including total number of items available and number of resources returned in a single page. # General pagination information.
@@ -335,7 +335,7 @@ 
Method Details

   "pollingIntervalMillis": 42, # The amount of time the client should wait before polling again.
   "tokenPagination": { # Stub token pagination template to suppress results.
   },
-  "visitorId": "A String", # The visitorId identifies the visitor.
+  "visitorId": "A String", # Identifies the visitor.
 }

 

 
diff --git a/googleapiclient/discovery_cache/documents/accesscontextmanager.v1.json b/googleapiclient/discovery_cache/documents/accesscontextmanager.v1.json
index 4a4672cc49..a92b2cd59a 100644
--- a/googleapiclient/discovery_cache/documents/accesscontextmanager.v1.json
+++ b/googleapiclient/discovery_cache/documents/accesscontextmanager.v1.json
@@ -1439,7 +1439,7 @@
 }
 }
 },
-"revision": "20260827",
+"revision": "20261011",
 "rootUrl": "https://accesscontextmanager.googleapis.com/",
 "schemas": {
 "AccessContextManagerOperationMetadata": {
@@ -1991,7 +1991,7 @@
 "description": "A PrivateServiceConnectEndpoint that is allowed to access data outside the perimeter. The Private Service Connect endpoint may be in any organization, not just the organization that the perimeter is defined in."
 },
 "resource": {
-"description": "A Google Cloud resource from the service perimeter that you want to allow to access data outside the perimeter. This field supports only projects. The project format is `projects/{project_number}`. You can't use `*` in this field to allow all Google Cloud resources.",
+"description": "A Google Cloud resource from the service perimeter that you want to allow to access data outside the perimeter. This field supports projects, folders, and organizations in the form `projects/`, `folders/`, and `organizations/`. You can't use `*` in this field to allow all Google Cloud resources.",
 "type": "string"
 }
 },
@@ -2016,7 +2016,7 @@
 "type": "array"
 },
 "resources": {
-"description": "A list of resources, currently only projects in the form `projects/`, that are allowed to be accessed by sources defined in the corresponding EgressFrom. A request matches if it contains a resource in this list. If `*` is specified for `resources`, then this EgressTo rule will authorize access to all resources outside the perimeter.",
+"description": "A list of resources, currently projects, folders, and organizations in the form `projects/`, `folders/`, and `organizations/`, that are allowed to be accessed by sources defined in the corresponding EgressFrom. A request matches if it contains a resource in this list. If `*` is specified for `resources`, then this EgressTo rule will authorize access to all resources outside the perimeter.",
 "items": {
 "type": "string"
 },
@@ -2203,7 +2203,7 @@
 "description": "A PrivateServiceConnectEndpoint that is allowed to access the perimeter. The Private Service Connect endpoint may be in any organization, not just the organization that the perimeter is defined in."
 },
 "resource": {
-"description": "A Google Cloud resource that is allowed to ingress the perimeter. Requests from these resources will be allowed to access perimeter data. Currently only projects and VPCs are allowed. Project format: `projects/{project_number}` VPC network format: `//compute.googleapis.com/projects/{PROJECT_ID}/global/networks/{NAME}`. The project may be in any Google Cloud organization, not just the organization that the perimeter is defined in. `*` is not allowed, the case of allowing all Google Cloud resources only is not supported.",
+"description": "A Google Cloud resource that is allowed to ingress the perimeter. Requests from these resources will be allowed to access perimeter data. Currently projects, folders, organizations, and VPCs are allowed. Project format: `projects/{project_number}` Folder format: `folders/{folder_id}` Organization format: `organizations/{organization_id}` VPC network format: `//compute.googleapis.com/projects/{PROJECT_ID}/global/networks/{NAME}`. The project may be in any Google Cloud organization, not just the organization that the perimeter is defined in. `*` is not allowed, the case of allowing all Google Cloud resources only is not supported.",
 "type": "string"
 }
 },
@@ -2221,7 +2221,7 @@
 "type": "array"
 },
 "resources": {
-"description": "A list of resources, currently only projects in the form `projects/`, protected by this ServicePerimeter that are allowed to be accessed by sources defined in the corresponding IngressFrom. If a single `*` is specified, then access to all resources inside the perimeter are allowed.",
+"description": "A list of resources, currently projects, folders, and organizations in the form `projects/{project_number}`, `folders/{folder_id}`, and `organizations/{organization_id}`, protected by this ServicePerimeter that are allowed to be accessed by sources defined in the corresponding IngressFrom. If a single `*` is specified, then access to all resources inside the perimeter are allowed.",
 "items": {
 "type": "string"
 },
@@ -2488,6 +2488,7 @@
 "DESKTOP_WINDOWS",
 "DESKTOP_LINUX",
 "DESKTOP_CHROME_OS",
+"GOOGLEBOOK_OS",
 "ANDROID",
 "IOS"
 ],
@@ -2497,6 +2498,7 @@
 "A desktop Windows operating system.",
 "A desktop Linux operating system.",
 "A desktop ChromeOS operating system.",
+"A Googlebook operating system.",
 "An Android operating system.",
 "An iOS operating system."
 ],
@@ -2759,7 +2761,7 @@
 "type": "array"
 },
 "resources": {
-"description": "A list of Google Cloud resources that are inside of the service perimeter. Currently only projects and VPCs are allowed. Project format: `projects/{project_number}` VPC network format: `//compute.googleapis.com/projects/{PROJECT_ID}/global/networks/{NAME}`.",
+"description": "A list of Google Cloud resources that are inside of the service perimeter. Currently projects, folders, and VPCs are allowed. Project format: `projects/{project_number}` Folder format: `folders/{folder_id}` VPC network format: `//compute.googleapis.com/projects/{PROJECT_ID}/global/networks/{NAME}`.",
 "items": {
 "type": "string"
 },
diff --git a/googleapiclient/discovery_cache/documents/analyticshub.v1.json b/googleapiclient/discovery_cache/documents/analyticshub.v1.json
index 39c143ed70..7bc7a73601 100644
--- a/googleapiclient/discovery_cache/documents/analyticshub.v1.json
+++ b/googleapiclient/discovery_cache/documents/analyticshub.v1.json
@@ -1247,7 +1247,7 @@
 }
 }
 },
-"revision": "20260926",
+"revision": "20261011",
 "rootUrl": "https://analyticshub.googleapis.com/",
 "schemas": {
 "AIInference": {
@@ -1678,7 +1678,7 @@
 "type": "string"
 },
 "keyFields": {
-"description": "Optional. The key fields to construct from the row key. The fields must be present in the message as a top-level field, i.e. JSON path expressions will not traverse into nested objects.",
+"description": "Required. The key fields to construct from the row key. The fields must be present in the message as a top-level field, i.e. JSON path expressions will not traverse into nested objects.",
 "items": {
 "type": "string"
 },
diff --git a/googleapiclient/discovery_cache/documents/androidmanagement.v1.json b/googleapiclient/discovery_cache/documents/androidmanagement.v1.json
index a114285a27..ab9f7e0a71 100644
--- a/googleapiclient/discovery_cache/documents/androidmanagement.v1.json
+++ b/googleapiclient/discovery_cache/documents/androidmanagement.v1.json
@@ -1265,7 +1265,7 @@
 }
 }
 },
-"revision": "20261008",
+"revision": "20261014",
 "rootUrl": "https://androidmanagement.googleapis.com/",
 "schemas": {
 "AdbShellCommandEvent": {
@@ -3722,7 +3722,7 @@ false
 "enumDescriptions": [
 "Unspecified. Defaults to USER_INITIATED_ADD_ESIM_ALLOWED.",
 "The user is allowed to add eSIM profiles.",
-"Supported only on company-owned devices. A NonComplianceDetail with MANAGEMENT_MODE is reported for personally-owned devices."
+"Prevents the user from adding any new eSIM profiles. Note the following behaviors: * Admin-provisioned eSIMs: This setting does not block adding or managing eSIMs programmatically using commands like ADD_ESIM. * Existing eSIMs: Any eSIM profiles already present on the device before this restriction is applied, will remain and are not removed. To view existing eSIMs, refer to the data reported in TelephonyInfo.Supported on Android 15 and higher. A NonComplianceDetail with API_LEVEL is reported if the Android version is less than 15.Supported only on company-owned devices. A NonComplianceDetail with MANAGEMENT_MODE is reported for personally-owned devices."
 ],
 "type": "string"
 },
diff --git a/googleapiclient/discovery_cache/documents/billingbudgets.v1.json b/googleapiclient/discovery_cache/documents/billingbudgets.v1.json
index 11a805ed19..42e8112a64 100644
--- a/googleapiclient/discovery_cache/documents/billingbudgets.v1.json
+++ b/googleapiclient/discovery_cache/documents/billingbudgets.v1.json
@@ -275,7 +275,7 @@
 }
 }
 },
-"revision": "20260928",
+"revision": "20261011",
 "rootUrl": "https://billingbudgets.googleapis.com/",
 "schemas": {
 "GoogleCloudBillingBudgetsV1Budget": {
@@ -323,7 +323,7 @@
 },
 "spendCap": {
 "$ref": "GoogleCloudBillingBudgetsV1SpendCap",
-"description": "Optional. The spend cap configured for this budget. When `spend_cap` is set, strict field restrictions apply to the budget (see field-level comments on `ownership_scope`, `budget_filter`, `amount`, `threshold_rules`, and `notifications_rule`). When `spend_cap.output_state` is `ENFORCED`, only `spend_cap.input_state` can be modified in an `UpdateBudget` request (e.g., setting `input_state` to `AWAITING_NEXT_PERIOD` to lift the cap); modifying any other budget field while enforced will fail with `FAILED_PRECONDITION`."
+"description": "Optional. The spend cap configured for this budget. When `spend_cap` is set, strict field restrictions apply to the budget (see field-level comments on `ownership_scope`, `budget_filter`, `amount`, `threshold_rules`, and `notifications_rule`). When `spend_cap.output_state` is `ENFORCED`, only `spend_cap.input_state` can be modified in an `UpdateBudget` request (e.g., setting `input_state` to `AWAITING_NEXT_PERIOD` to lift the cap); modifying any other budget field while enforced will fail with `FAILED_PRECONDITION`. If the existing resource is a spend cap and an `update_mask` is supplied in an `UpdateBudget` request, `spend_cap` or `spend_cap.input_state` must be specified in the update mask. To convert a spend cap budget to a regular budget, specify `spend_cap` in the `update_mask` and omit `spend_cap` from the budget in the request."
 },
 "thresholdRules": {
 "description": "Optional. Rules that trigger alerts (notifications of thresholds being crossed) when spend exceeds the specified percentages of the budget. Optional for `pubsubTopic` notifications. Required if using email notifications. Must be set when `spend_cap` is set. Spend caps must have exactly three `CURRENT_SPEND` threshold rules with `threshold_percent` values of `0.5`, `0.8`, and `1.0` (50%, 80%, and 100%). `FORECASTED_SPEND` threshold rules are not supported for spend caps.",
@@ -512,7 +512,7 @@
 "id": "GoogleCloudBillingBudgetsV1SpendCap",
 "properties": {
 "inputState": {
-"description": "Required. The desired state specified by the user. Valid values for mutation: - `CONFIGURED`: Must be set when creating a spend cap (`CreateBudget`). Also valid when updating (`UpdateBudget`) to activate the spend cap. - `AWAITING_NEXT_PERIOD`: Valid only when updating (`UpdateBudget`) to explicitly lift an enforced cap. Supplying any other value will result in an INVALID_ARGUMENT error.",
+"description": "Required. The desired state specified by the user. Valid values for mutation: - `CONFIGURED`: Must be set when creating a spend cap (`CreateBudget`). Also valid when updating (`UpdateBudget`) to activate the spend cap. If the spend cap is in state `AWAITING_NEXT_PERIOD`, `input_state` must be set to `CONFIGURED`. - `AWAITING_NEXT_PERIOD`: Valid only when updating (`UpdateBudget`) to explicitly lift an enforced cap. Not allowed if the spend cap is in state `AWAITING_NEXT_PERIOD`. Supplying any other value will result in an INVALID_ARGUMENT error.",
 "enum": [
 "STATE_UNSPECIFIED",
 "CONFIGURED",
diff --git a/googleapiclient/discovery_cache/documents/businessprofileperformance.v1.json b/googleapiclient/discovery_cache/documents/businessprofileperformance.v1.json
index e4ce34a0e4..8f54f161bd 100644
--- a/googleapiclient/discovery_cache/documents/businessprofileperformance.v1.json
+++ b/googleapiclient/discovery_cache/documents/businessprofileperformance.v1.json
@@ -119,6 +119,7 @@
 "BUSINESS_DIRECTION_REQUESTS",
 "CALL_CLICKS",
 "WEBSITE_CLICKS",
+"MESSAGING_CLICKS",
 "BUSINESS_BOOKINGS",
 "BUSINESS_FOOD_ORDERS",
 "BUSINESS_FOOD_MENU_CLICKS"
@@ -134,6 +135,7 @@ false,
 false,
 false,
 false,
+false,
 true,
 false
 ],
@@ -147,6 +149,7 @@ false
 "The number of times a direction request was requested to the business location.",
 "The number of times the business profile call button was clicked.",
 "The number of times the business profile website was clicked.",
+"The number of times the business profile messaging (e.g. Whatsapp) button was clicked.",
 "The number of bookings made from the business profile via Reserve with Google.",
 "The number of food orders received from the business profile.",
 "The number of clicks to view or interact with the menu content on the business profile. Multiple clicks by a unique user within a single day are counted as 1."
@@ -225,6 +228,7 @@ false
 "BUSINESS_DIRECTION_REQUESTS",
 "CALL_CLICKS",
 "WEBSITE_CLICKS",
+"MESSAGING_CLICKS",
 "BUSINESS_BOOKINGS",
 "BUSINESS_FOOD_ORDERS",
 "BUSINESS_FOOD_MENU_CLICKS"
@@ -240,6 +244,7 @@ false,
 false,
 false,
 false,
+false,
 true,
 false
 ],
@@ -253,6 +258,7 @@ false
 "The number of times a direction request was requested to the business location.",
 "The number of times the business profile call button was clicked.",
 "The number of times the business profile website was clicked.",
+"The number of times the business profile messaging (e.g. Whatsapp) button was clicked.",
 "The number of bookings made from the business profile via Reserve with Google.",
 "The number of food orders received from the business profile.",
 "The number of clicks to view or interact with the menu content on the business profile. Multiple clicks by a unique user within a single day are counted as 1."
@@ -445,7 +451,7 @@ false
 }
 }
 },
-"revision": "20261004",
+"revision": "20261014",
 "rootUrl": "https://businessprofileperformance.googleapis.com/",
 "schemas": {
 "DailyMetricTimeSeries": {
@@ -464,6 +470,7 @@ false
 "BUSINESS_DIRECTION_REQUESTS",
 "CALL_CLICKS",
 "WEBSITE_CLICKS",
+"MESSAGING_CLICKS",
 "BUSINESS_BOOKINGS",
 "BUSINESS_FOOD_ORDERS",
 "BUSINESS_FOOD_MENU_CLICKS"
@@ -479,6 +486,7 @@ false,
 false,
 false,
 false,
+false,
 true,
 false
 ],
@@ -492,6 +500,7 @@ false
 "The number of times a direction request was requested to the business location.",
 "The number of times the business profile call button was clicked.",
 "The number of times the business profile website was clicked.",
+"The number of times the business profile messaging (e.g. Whatsapp) button was clicked.",
 "The number of bookings made from the business profile via Reserve with Google.",
 "The number of food orders received from the business profile.",
 "The number of clicks to view or interact with the menu content on the business profile. Multiple clicks by a unique user within a single day are counted as 1."
diff --git a/googleapiclient/discovery_cache/documents/chromemanagement.v1.json b/googleapiclient/discovery_cache/documents/chromemanagement.v1.json
index be46c87b8b..9e999be4b1 100644
--- a/googleapiclient/discovery_cache/documents/chromemanagement.v1.json
+++ b/googleapiclient/discovery_cache/documents/chromemanagement.v1.json
@@ -566,7 +566,7 @@
 ],
 "parameters": {
 "filter": {
-"description": "Optional. The filter used to filter browsers. The following fields can be used in the filter: * `browser_permanent_id` * `last_policy_fetch_time` * `os_platform` * `os_architecture` * `os_version` * `machine_name` * `annotated_location` * `annotated_user` * `annotated_asset_id` * `annotated_note` * `org_unit_path` * `org_unit_id` * `last_registration_time` * `os_platform_version` * `browser_version` * `last_status_report_time` * `extension_count` * `policy_count` * `last_device_user` * `last_activity_time` * `device_id_collision` The following functions can be used in the filter: * `in_group(string)`: Filters browsers that belong to the specified Cloud Identity group resource name (e.g. `in_group(\"groups/{group_id}\")`). Any of the above fields or functions can be used to specify a filter, and filtering by multiple fields or functions is supported with AND operator. String type, Integer type fields and enum type fields support `=` and `:` operators. The timestamp type fields support `=`, `<=` and `>=` operators. Timestamps expect an RFC-3339 formatted string (e.g. 2012-04-21T11:30:00-04:00). Wildcard `*` is only supported for `machine_name`, `annotated_asset_id`, and `browser_version`. In addition, global string literal filtering without a field name is supported: a single term (e.g., `ABC`) matches if any indexed string field contains `ABC`, and multiple terms joined by `AND` or whitespace (e.g., `machine AND 73` or `machine 73`) match browsers where every term appears in at least one indexed string field (whereas a single quoted phrase like `\"machine 73\"` matches the contiguous phrase within a single field).",
+"description": "Optional. The filter used to filter browsers. The following fields can be used in the filter: * `browser_permanent_id` * `last_policy_fetch_time` * `os_platform` * `os_architecture` * `os_version` * `machine_name` * `annotated_location` * `annotated_user` * `annotated_asset_id` * `annotated_note` * `org_unit_path` * `org_unit_id` * `last_registration_time` * `os_platform_version` * `browser_version` * `last_status_report_time` * `extension_count` * `policy_count` * `last_device_user` * `last_activity_time` * `device_id_collision` The following functions can be used in the filter: * `in_group(string)`: Filters browsers that belong to the specified Cloud Identity group resource name (e.g. `in_group(\"groups/{group_id}\")`). Any of the above fields or functions can be used to specify a filter, and filtering by multiple fields or functions is supported with AND operator. String type, Integer type fields and enum type fields support `=` and `:` operators. The timestamp type fields support `=`, `<=` and `>=` operators. Timestamps expect an RFC-3339 formatted string enclosed in double quotes (e.g., `\"2012-04-21T11:30:00-04:00\"`). Wildcard `*` is only supported for `machine_name`, `annotated_asset_id`, and `browser_version`. In addition, global string literal filtering without a field name is supported: a single term (e.g., `ABC`) matches if any indexed string field contains `ABC`, and multiple terms joined by `AND` or whitespace (e.g., `machine AND 73` or `machine 73`) match browsers where every term appears in at least one indexed string field (whereas a single quoted phrase like `\"machine 73\"` matches the contiguous phrase within a single field).",
 "location": "query",
 "type": "string"
 },
@@ -2823,7 +2823,7 @@
 }
 }
 },
-"revision": "20261008",
+"revision": "20261015",
 "rootUrl": "https://chromemanagement.googleapis.com/",
 "schemas": {
 "GoogleChromeManagementV1AndroidAppInfo": {
diff --git a/googleapiclient/discovery_cache/documents/cloudasset.v1.json b/googleapiclient/discovery_cache/documents/cloudasset.v1.json
index 7d071bb0f1..1e70eb8ec8 100644
--- a/googleapiclient/discovery_cache/documents/cloudasset.v1.json
+++ b/googleapiclient/discovery_cache/documents/cloudasset.v1.json
@@ -1102,7 +1102,7 @@
 }
 }
 },
-"revision": "20260801",
+"revision": "20261010",
 "rootUrl": "https://cloudasset.googleapis.com/",
 "schemas": {
 "AccessSelector": {
@@ -2944,7 +2944,7 @@
 "description": "A PrivateServiceConnectEndpoint that is allowed to access data outside the perimeter. The Private Service Connect endpoint may be in any organization, not just the organization that the perimeter is defined in."
 },
 "resource": {
-"description": "A Google Cloud resource from the service perimeter that you want to allow to access data outside the perimeter. This field supports only projects. The project format is `projects/{project_number}`. You can't use `*` in this field to allow all Google Cloud resources.",
+"description": "A Google Cloud resource from the service perimeter that you want to allow to access data outside the perimeter. This field supports projects, folders, and organizations in the form `projects/`, `folders/`, and `organizations/`. You can't use `*` in this field to allow all Google Cloud resources.",
 "type": "string"
 }
 },
@@ -2969,7 +2969,7 @@
 "type": "array"
 },
 "resources": {
-"description": "A list of resources, currently only projects in the form `projects/`, that are allowed to be accessed by sources defined in the corresponding EgressFrom. A request matches if it contains a resource in this list. If `*` is specified for `resources`, then this EgressTo rule will authorize access to all resources outside the perimeter.",
+"description": "A list of resources, currently projects, folders, and organizations in the form `projects/`, `folders/`, and `organizations/`, that are allowed to be accessed by sources defined in the corresponding EgressFrom. A request matches if it contains a resource in this list. If `*` is specified for `resources`, then this EgressTo rule will authorize access to all resources outside the perimeter.",
 "items": {
 "type": "string"
 },
@@ -3054,7 +3054,7 @@
 "description": "A PrivateServiceConnectEndpoint that is allowed to access the perimeter. The Private Service Connect endpoint may be in any organization, not just the organization that the perimeter is defined in."
 },
 "resource": {
-"description": "A Google Cloud resource that is allowed to ingress the perimeter. Requests from these resources will be allowed to access perimeter data. Currently only projects and VPCs are allowed. Project format: `projects/{project_number}` VPC network format: `//compute.googleapis.com/projects/{PROJECT_ID}/global/networks/{NAME}`. The project may be in any Google Cloud organization, not just the organization that the perimeter is defined in. `*` is not allowed, the case of allowing all Google Cloud resources only is not supported.",
+"description": "A Google Cloud resource that is allowed to ingress the perimeter. Requests from these resources will be allowed to access perimeter data. Currently projects, folders, organizations, and VPCs are allowed. Project format: `projects/{project_number}` Folder format: `folders/{folder_id}` Organization format: `organizations/{organization_id}` VPC network format: `//compute.googleapis.com/projects/{PROJECT_ID}/global/networks/{NAME}`. The project may be in any Google Cloud organization, not just the organization that the perimeter is defined in. `*` is not allowed, the case of allowing all Google Cloud resources only is not supported.",
 "type": "string"
 }
 },
@@ -3072,7 +3072,7 @@
 "type": "array"
 },
 "resources": {
-"description": "A list of resources, currently only projects in the form `projects/`, protected by this ServicePerimeter that are allowed to be accessed by sources defined in the corresponding IngressFrom. If a single `*` is specified, then access to all resources inside the perimeter are allowed.",
+"description": "A list of resources, currently projects, folders, and organizations in the form `projects/{project_number}`, `folders/{folder_id}`, and `organizations/{organization_id}`, protected by this ServicePerimeter that are allowed to be accessed by sources defined in the corresponding IngressFrom. If a single `*` is specified, then access to all resources inside the perimeter are allowed.",
 "items": {
 "type": "string"
 },
@@ -3130,6 +3130,7 @@
 "DESKTOP_WINDOWS",
 "DESKTOP_LINUX",
 "DESKTOP_CHROME_OS",
+"GOOGLEBOOK_OS",
 "ANDROID",
 "IOS"
 ],
@@ -3139,6 +3140,7 @@
 "A desktop Windows operating system.",
 "A desktop Linux operating system.",
 "A desktop ChromeOS operating system.",
+"A Googlebook operating system.",
 "An Android operating system.",
 "An iOS operating system."
 ],
@@ -3257,7 +3259,7 @@
 "type": "array"
 },
 "resources": {
-"description": "A list of Google Cloud resources that are inside of the service perimeter. Currently only projects and VPCs are allowed. Project format: `projects/{project_number}` VPC network format: `//compute.googleapis.com/projects/{PROJECT_ID}/global/networks/{NAME}`.",
+"description": "A list of Google Cloud resources that are inside of the service perimeter. Currently projects, folders, and VPCs are allowed. Project format: `projects/{project_number}` Folder format: `folders/{folder_id}` VPC network format: `//compute.googleapis.com/projects/{PROJECT_ID}/global/networks/{NAME}`.",
 "items": {
 "type": "string"
 },
diff --git a/googleapiclient/discovery_cache/documents/cloudasset.v1beta1.json b/googleapiclient/discovery_cache/documents/cloudasset.v1beta1.json
index 16812c9798..67468310c4 100644
--- a/googleapiclient/discovery_cache/documents/cloudasset.v1beta1.json
+++ b/googleapiclient/discovery_cache/documents/cloudasset.v1beta1.json
@@ -417,7 +417,7 @@
 }
 }
 },
-"revision": "20260801",
+"revision": "20261010",
 "rootUrl": "https://cloudasset.googleapis.com/",
 "schemas": {
 "AnalyzeIamPolicyLongrunningMetadata": {
@@ -1223,7 +1223,7 @@
 "description": "A PrivateServiceConnectEndpoint that is allowed to access data outside the perimeter. The Private Service Connect endpoint may be in any organization, not just the organization that the perimeter is defined in."
 },
 "resource": {
-"description": "A Google Cloud resource from the service perimeter that you want to allow to access data outside the perimeter. This field supports only projects. The project format is `projects/{project_number}`. You can't use `*` in this field to allow all Google Cloud resources.",
+"description": "A Google Cloud resource from the service perimeter that you want to allow to access data outside the perimeter. This field supports projects, folders, and organizations in the form `projects/`, `folders/`, and `organizations/`. You can't use `*` in this field to allow all Google Cloud resources.",
 "type": "string"
 }
 },
@@ -1248,7 +1248,7 @@
 "type": "array"
 },
 "resources": {
-"description": "A list of resources, currently only projects in the form `projects/`, that are allowed to be accessed by sources defined in the corresponding EgressFrom. A request matches if it contains a resource in this list. If `*` is specified for `resources`, then this EgressTo rule will authorize access to all resources outside the perimeter.",
+"description": "A list of resources, currently projects, folders, and organizations in the form `projects/`, `folders/`, and `organizations/`, that are allowed to be accessed by sources defined in the corresponding EgressFrom. A request matches if it contains a resource in this list. If `*` is specified for `resources`, then this EgressTo rule will authorize access to all resources outside the perimeter.",
 "items": {
 "type": "string"
 },
@@ -1333,7 +1333,7 @@
 "description": "A PrivateServiceConnectEndpoint that is allowed to access the perimeter. The Private Service Connect endpoint may be in any organization, not just the organization that the perimeter is defined in."
 },
 "resource": {
-"description": "A Google Cloud resource that is allowed to ingress the perimeter. Requests from these resources will be allowed to access perimeter data. Currently only projects and VPCs are allowed. Project format: `projects/{project_number}` VPC network format: `//compute.googleapis.com/projects/{PROJECT_ID}/global/networks/{NAME}`. The project may be in any Google Cloud organization, not just the organization that the perimeter is defined in. `*` is not allowed, the case of allowing all Google Cloud resources only is not supported.",
+"description": "A Google Cloud resource that is allowed to ingress the perimeter. Requests from these resources will be allowed to access perimeter data. Currently projects, folders, organizations, and VPCs are allowed. Project format: `projects/{project_number}` Folder format: `folders/{folder_id}` Organization format: `organizations/{organization_id}` VPC network format: `//compute.googleapis.com/projects/{PROJECT_ID}/global/networks/{NAME}`. The project may be in any Google Cloud organization, not just the organization that the perimeter is defined in. `*` is not allowed, the case of allowing all Google Cloud resources only is not supported.",
 "type": "string"
 }
 },
@@ -1351,7 +1351,7 @@
 "type": "array"
 },
 "resources": {
-"description": "A list of resources, currently only projects in the form `projects/`, protected by this ServicePerimeter that are allowed to be accessed by sources defined in the corresponding IngressFrom. If a single `*` is specified, then access to all resources inside the perimeter are allowed.",
+"description": "A list of resources, currently projects, folders, and organizations in the form `projects/{project_number}`, `folders/{folder_id}`, and `organizations/{organization_id}`, protected by this ServicePerimeter that are allowed to be accessed by sources defined in the corresponding IngressFrom. If a single `*` is specified, then access to all resources inside the perimeter are allowed.",
 "items": {
 "type": "string"
 },
@@ -1409,6 +1409,7 @@
 "DESKTOP_WINDOWS",
 "DESKTOP_LINUX",
 "DESKTOP_CHROME_OS",
+"GOOGLEBOOK_OS",
 "ANDROID",
 "IOS"
 ],
@@ -1418,6 +1419,7 @@
 "A desktop Windows operating system.",
 "A desktop Linux operating system.",
 "A desktop ChromeOS operating system.",
+"A Googlebook operating system.",
 "An Android operating system.",
 "An iOS operating system."
 ],
@@ -1536,7 +1538,7 @@
 "type": "array"
 },
 "resources": {
-"description": "A list of Google Cloud resources that are inside of the service perimeter. Currently only projects and VPCs are allowed. Project format: `projects/{project_number}` VPC network format: `//compute.googleapis.com/projects/{PROJECT_ID}/global/networks/{NAME}`.",
+"description": "A list of Google Cloud resources that are inside of the service perimeter. Currently projects, folders, and VPCs are allowed. Project format: `projects/{project_number}` Folder format: `folders/{folder_id}` VPC network format: `//compute.googleapis.com/projects/{PROJECT_ID}/global/networks/{NAME}`.",
 "items": {
 "type": "string"
 },
diff --git a/googleapiclient/discovery_cache/documents/cloudasset.v1p1beta1.json b/googleapiclient/discovery_cache/documents/cloudasset.v1p1beta1.json
index e0a7b3959e..f2dec256b3 100644
--- a/googleapiclient/discovery_cache/documents/cloudasset.v1p1beta1.json
+++ b/googleapiclient/discovery_cache/documents/cloudasset.v1p1beta1.json
@@ -207,7 +207,7 @@
 }
 }
 },
-"revision": "20260801",
+"revision": "20261010",
 "rootUrl": "https://cloudasset.googleapis.com/",
 "schemas": {
 "AnalyzeIamPolicyLongrunningMetadata": {
@@ -919,7 +919,7 @@
 "description": "A PrivateServiceConnectEndpoint that is allowed to access data outside the perimeter. The Private Service Connect endpoint may be in any organization, not just the organization that the perimeter is defined in."
 },
 "resource": {
-"description": "A Google Cloud resource from the service perimeter that you want to allow to access data outside the perimeter. This field supports only projects. The project format is `projects/{project_number}`. You can't use `*` in this field to allow all Google Cloud resources.",
+"description": "A Google Cloud resource from the service perimeter that you want to allow to access data outside the perimeter. This field supports projects, folders, and organizations in the form `projects/`, `folders/`, and `organizations/`. You can't use `*` in this field to allow all Google Cloud resources.",
 "type": "string"
 }
 },
@@ -944,7 +944,7 @@
 "type": "array"
 },
 "resources": {
-"description": "A list of resources, currently only projects in the form `projects/`, that are allowed to be accessed by sources defined in the corresponding EgressFrom. A request matches if it contains a resource in this list. If `*` is specified for `resources`, then this EgressTo rule will authorize access to all resources outside the perimeter.",
+"description": "A list of resources, currently projects, folders, and organizations in the form `projects/`, `folders/`, and `organizations/`, that are allowed to be accessed by sources defined in the corresponding EgressFrom. A request matches if it contains a resource in this list. If `*` is specified for `resources`, then this EgressTo rule will authorize access to all resources outside the perimeter.",
 "items": {
 "type": "string"
 },
@@ -1029,7 +1029,7 @@
 "description": "A PrivateServiceConnectEndpoint that is allowed to access the perimeter. The Private Service Connect endpoint may be in any organization, not just the organization that the perimeter is defined in."
 },
 "resource": {
-"description": "A Google Cloud resource that is allowed to ingress the perimeter. Requests from these resources will be allowed to access perimeter data. Currently only projects and VPCs are allowed. Project format: `projects/{project_number}` VPC network format: `//compute.googleapis.com/projects/{PROJECT_ID}/global/networks/{NAME}`. The project may be in any Google Cloud organization, not just the organization that the perimeter is defined in. `*` is not allowed, the case of allowing all Google Cloud resources only is not supported.",
+"description": "A Google Cloud resource that is allowed to ingress the perimeter. Requests from these resources will be allowed to access perimeter data. Currently projects, folders, organizations, and VPCs are allowed. Project format: `projects/{project_number}` Folder format: `folders/{folder_id}` Organization format: `organizations/{organization_id}` VPC network format: `//compute.googleapis.com/projects/{PROJECT_ID}/global/networks/{NAME}`. The project may be in any Google Cloud organization, not just the organization that the perimeter is defined in. `*` is not allowed, the case of allowing all Google Cloud resources only is not supported.",
 "type": "string"
 }
 },
@@ -1047,7 +1047,7 @@
 "type": "array"
 },
 "resources": {
-"description": "A list of resources, currently only projects in the form `projects/`, protected by this ServicePerimeter that are allowed to be accessed by sources defined in the corresponding IngressFrom. If a single `*` is specified, then access to all resources inside the perimeter are allowed.",
+"description": "A list of resources, currently projects, folders, and organizations in the form `projects/{project_number}`, `folders/{folder_id}`, and `organizations/{organization_id}`, protected by this ServicePerimeter that are allowed to be accessed by sources defined in the corresponding IngressFrom. If a single `*` is specified, then access to all resources inside the perimeter are allowed.",
 "items": {
 "type": "string"
 },
@@ -1105,6 +1105,7 @@
 "DESKTOP_WINDOWS",
 "DESKTOP_LINUX",
 "DESKTOP_CHROME_OS",
+"GOOGLEBOOK_OS",
 "ANDROID",
 "IOS"
 ],
@@ -1114,6 +1115,7 @@
 "A desktop Windows operating system.",
 "A desktop Linux operating system.",
 "A desktop ChromeOS operating system.",
+"A Googlebook operating system.",
 "An Android operating system.",
 "An iOS operating system."
 ],
@@ -1232,7 +1234,7 @@
 "type": "array"
 },
 "resources": {
-"description": "A list of Google Cloud resources that are inside of the service perimeter. Currently only projects and VPCs are allowed. Project format: `projects/{project_number}` VPC network format: `//compute.googleapis.com/projects/{PROJECT_ID}/global/networks/{NAME}`.",
+"description": "A list of Google Cloud resources that are inside of the service perimeter. Currently projects, folders, and VPCs are allowed. Project format: `projects/{project_number}` Folder format: `folders/{folder_id}` VPC network format: `//compute.googleapis.com/projects/{PROJECT_ID}/global/networks/{NAME}`.",
 "items": {
 "type": "string"
 },
diff --git a/googleapiclient/discovery_cache/documents/cloudasset.v1p5beta1.json b/googleapiclient/discovery_cache/documents/cloudasset.v1p5beta1.json
index 5a634b1d7d..1659282cc3 100644
--- a/googleapiclient/discovery_cache/documents/cloudasset.v1p5beta1.json
+++ b/googleapiclient/discovery_cache/documents/cloudasset.v1p5beta1.json
@@ -177,7 +177,7 @@
 }
 }
 },
-"revision": "20260801",
+"revision": "20261010",
 "rootUrl": "https://cloudasset.googleapis.com/",
 "schemas": {
 "AnalyzeIamPolicyLongrunningMetadata": {
@@ -924,7 +924,7 @@
 "description": "A PrivateServiceConnectEndpoint that is allowed to access data outside the perimeter. The Private Service Connect endpoint may be in any organization, not just the organization that the perimeter is defined in."
 },
 "resource": {
-"description": "A Google Cloud resource from the service perimeter that you want to allow to access data outside the perimeter. This field supports only projects. The project format is `projects/{project_number}`. You can't use `*` in this field to allow all Google Cloud resources.",
+"description": "A Google Cloud resource from the service perimeter that you want to allow to access data outside the perimeter. This field supports projects, folders, and organizations in the form `projects/`, `folders/`, and `organizations/`. You can't use `*` in this field to allow all Google Cloud resources.",
 "type": "string"
 }
 },
@@ -949,7 +949,7 @@
 "type": "array"
 },
 "resources": {
-"description": "A list of resources, currently only projects in the form `projects/`, that are allowed to be accessed by sources defined in the corresponding EgressFrom. A request matches if it contains a resource in this list. If `*` is specified for `resources`, then this EgressTo rule will authorize access to all resources outside the perimeter.",
+"description": "A list of resources, currently projects, folders, and organizations in the form `projects/`, `folders/`, and `organizations/`, that are allowed to be accessed by sources defined in the corresponding EgressFrom. A request matches if it contains a resource in this list. If `*` is specified for `resources`, then this EgressTo rule will authorize access to all resources outside the perimeter.",
 "items": {
 "type": "string"
 },
@@ -1034,7 +1034,7 @@
 "description": "A PrivateServiceConnectEndpoint that is allowed to access the perimeter. The Private Service Connect endpoint may be in any organization, not just the organization that the perimeter is defined in."
 },
 "resource": {
-"description": "A Google Cloud resource that is allowed to ingress the perimeter. Requests from these resources will be allowed to access perimeter data. Currently only projects and VPCs are allowed. Project format: `projects/{project_number}` VPC network format: `//compute.googleapis.com/projects/{PROJECT_ID}/global/networks/{NAME}`. The project may be in any Google Cloud organization, not just the organization that the perimeter is defined in. `*` is not allowed, the case of allowing all Google Cloud resources only is not supported.",
+"description": "A Google Cloud resource that is allowed to ingress the perimeter. Requests from these resources will be allowed to access perimeter data. Currently projects, folders, organizations, and VPCs are allowed. Project format: `projects/{project_number}` Folder format: `folders/{folder_id}` Organization format: `organizations/{organization_id}` VPC network format: `//compute.googleapis.com/projects/{PROJECT_ID}/global/networks/{NAME}`. The project may be in any Google Cloud organization, not just the organization that the perimeter is defined in. `*` is not allowed, the case of allowing all Google Cloud resources only is not supported.",
 "type": "string"
 }
 },
@@ -1052,7 +1052,7 @@
 "type": "array"
 },
 "resources": {
-"description": "A list of resources, currently only projects in the form `projects/`, protected by this ServicePerimeter that are allowed to be accessed by sources defined in the corresponding IngressFrom. If a single `*` is specified, then access to all resources inside the perimeter are allowed.",
+"description": "A list of resources, currently projects, folders, and organizations in the form `projects/{project_number}`, `folders/{folder_id}`, and `organizations/{organization_id}`, protected by this ServicePerimeter that are allowed to be accessed by sources defined in the corresponding IngressFrom. If a single `*` is specified, then access to all resources inside the perimeter are allowed.",
 "items": {
 "type": "string"
 },
@@ -1110,6 +1110,7 @@
 "DESKTOP_WINDOWS",
 "DESKTOP_LINUX",
 "DESKTOP_CHROME_OS",
+"GOOGLEBOOK_OS",
 "ANDROID",
 "IOS"
 ],
@@ -1119,6 +1120,7 @@
 "A desktop Windows operating system.",
 "A desktop Linux operating system.",
 "A desktop ChromeOS operating system.",
+"A Googlebook operating system.",
 "An Android operating system.",
 "An iOS operating system."
 ],
@@ -1237,7 +1239,7 @@
 "type": "array"
 },
 "resources": {
-"description": "A list of Google Cloud resources that are inside of the service perimeter. Currently only projects and VPCs are allowed. Project format: `projects/{project_number}` VPC network format: `//compute.googleapis.com/projects/{PROJECT_ID}/global/networks/{NAME}`.",
+"description": "A list of Google Cloud resources that are inside of the service perimeter. Currently projects, folders, and VPCs are allowed. Project format: `projects/{project_number}` Folder format: `folders/{folder_id}` VPC network format: `//compute.googleapis.com/projects/{PROJECT_ID}/global/networks/{NAME}`.",
 "items": {
 "type": "string"
 },
diff --git a/googleapiclient/discovery_cache/documents/cloudasset.v1p7beta1.json b/googleapiclient/discovery_cache/documents/cloudasset.v1p7beta1.json
index 5f77f6cb56..998c1698aa 100644
--- a/googleapiclient/discovery_cache/documents/cloudasset.v1p7beta1.json
+++ b/googleapiclient/discovery_cache/documents/cloudasset.v1p7beta1.json
@@ -171,7 +171,7 @@
 }
 }
 },
-"revision": "20260801",
+"revision": "20261010",
 "rootUrl": "https://cloudasset.googleapis.com/",
 "schemas": {
 "AnalyzeIamPolicyLongrunningMetadata": {
@@ -997,7 +997,7 @@
 "description": "A PrivateServiceConnectEndpoint that is allowed to access data outside the perimeter. The Private Service Connect endpoint may be in any organization, not just the organization that the perimeter is defined in."
 },
 "resource": {
-"description": "A Google Cloud resource from the service perimeter that you want to allow to access data outside the perimeter. This field supports only projects. The project format is `projects/{project_number}`. You can't use `*` in this field to allow all Google Cloud resources.",
+"description": "A Google Cloud resource from the service perimeter that you want to allow to access data outside the perimeter. This field supports projects, folders, and organizations in the form `projects/`, `folders/`, and `organizations/`. You can't use `*` in this field to allow all Google Cloud resources.",
 "type": "string"
 }
 },
@@ -1022,7 +1022,7 @@
 "type": "array"
 },
 "resources": {
-"description": "A list of resources, currently only projects in the form `projects/`, that are allowed to be accessed by sources defined in the corresponding EgressFrom. A request matches if it contains a resource in this list. If `*` is specified for `resources`, then this EgressTo rule will authorize access to all resources outside the perimeter.",
+"description": "A list of resources, currently projects, folders, and organizations in the form `projects/`, `folders/`, and `organizations/`, that are allowed to be accessed by sources defined in the corresponding EgressFrom. A request matches if it contains a resource in this list. If `*` is specified for `resources`, then this EgressTo rule will authorize access to all resources outside the perimeter.",
 "items": {
 "type": "string"
 },
@@ -1107,7 +1107,7 @@
 "description": "A PrivateServiceConnectEndpoint that is allowed to access the perimeter. The Private Service Connect endpoint may be in any organization, not just the organization that the perimeter is defined in."
 },
 "resource": {
-"description": "A Google Cloud resource that is allowed to ingress the perimeter. Requests from these resources will be allowed to access perimeter data. Currently only projects and VPCs are allowed. Project format: `projects/{project_number}` VPC network format: `//compute.googleapis.com/projects/{PROJECT_ID}/global/networks/{NAME}`. The project may be in any Google Cloud organization, not just the organization that the perimeter is defined in. `*` is not allowed, the case of allowing all Google Cloud resources only is not supported.",
+"description": "A Google Cloud resource that is allowed to ingress the perimeter. Requests from these resources will be allowed to access perimeter data. Currently projects, folders, organizations, and VPCs are allowed. Project format: `projects/{project_number}` Folder format: `folders/{folder_id}` Organization format: `organizations/{organization_id}` VPC network format: `//compute.googleapis.com/projects/{PROJECT_ID}/global/networks/{NAME}`. The project may be in any Google Cloud organization, not just the organization that the perimeter is defined in. `*` is not allowed, the case of allowing all Google Cloud resources only is not supported.",
 "type": "string"
 }
 },
@@ -1125,7 +1125,7 @@
 "type": "array"
 },
 "resources": {
-"description": "A list of resources, currently only projects in the form `projects/`, protected by this ServicePerimeter that are allowed to be accessed by sources defined in the corresponding IngressFrom. If a single `*` is specified, then access to all resources inside the perimeter are allowed.",
+"description": "A list of resources, currently projects, folders, and organizations in the form `projects/{project_number}`, `folders/{folder_id}`, and `organizations/{organization_id}`, protected by this ServicePerimeter that are allowed to be accessed by sources defined in the corresponding IngressFrom. If a single `*` is specified, then access to all resources inside the perimeter are allowed.",
 "items": {
 "type": "string"
 },
@@ -1183,6 +1183,7 @@
 "DESKTOP_WINDOWS",
 "DESKTOP_LINUX",
 "DESKTOP_CHROME_OS",
+"GOOGLEBOOK_OS",
 "ANDROID",
 "IOS"
 ],
@@ -1192,6 +1193,7 @@
 "A desktop Windows operating system.",
 "A desktop Linux operating system.",
 "A desktop ChromeOS operating system.",
+"A Googlebook operating system.",
 "An Android operating system.",
 "An iOS operating system."
 ],
@@ -1310,7 +1312,7 @@
 "type": "array"
 },
 "resources": {
-"description": "A list of Google Cloud resources that are inside of the service perimeter. Currently only projects and VPCs are allowed. Project format: `projects/{project_number}` VPC network format: `//compute.googleapis.com/projects/{PROJECT_ID}/global/networks/{NAME}`.",
+"description": "A list of Google Cloud resources that are inside of the service perimeter. Currently projects, folders, and VPCs are allowed. Project format: `projects/{project_number}` Folder format: `folders/{folder_id}` VPC network format: `//compute.googleapis.com/projects/{PROJECT_ID}/global/networks/{NAME}`.",
 "items": {
 "type": "string"
 },
diff --git a/googleapiclient/discovery_cache/documents/cloudtasks.v2.json b/googleapiclient/discovery_cache/documents/cloudtasks.v2.json
index bd7973937a..8ed13c3406 100644
--- a/googleapiclient/discovery_cache/documents/cloudtasks.v2.json
+++ b/googleapiclient/discovery_cache/documents/cloudtasks.v2.json
@@ -135,7 +135,7 @@
 ]
 },
 "getCmekConfig": {
-"description": "Gets the CMEK config. Gets the Customer Managed Encryption Key configured with the Cloud Tasks lcoation. By default there is no kms_key configured.",
+"description": "Gets the CMEK config. Gets the Customer Managed Encryption Key configured with the Cloud Tasks location. By default there is no `kms_key` configured.",
 "flatPath": "v2/projects/{projectsId}/locations/{locationsId}/cmekConfig",
 "httpMethod": "GET",
 "id": "cloudtasks.projects.locations.getCmekConfig",
@@ -144,7 +144,7 @@
 ],
 "parameters": {
 "name": {
-"description": "Required. The config. For example: projects/PROJECT_ID/locations/LOCATION_ID/CmekConfig`",
+"description": "Required. The config. For example: `projects/PROJECT_ID/locations/LOCATION_ID/cmekConfig`",
 "location": "path",
 "pattern": "^projects/[^/]+/locations/[^/]+/cmekConfig$",
 "required": true,
@@ -216,7 +216,7 @@
 ],
 "parameters": {
 "name": {
-"description": "Output only. The config resource name which includes the project and location and must end in 'cmekConfig', in the format projects/PROJECT_ID/locations/LOCATION_ID/cmekConfig`",
+"description": "Output only. The config resource name which includes the project and location and must end in 'cmekConfig', in the format `projects/PROJECT_ID/locations/LOCATION_ID/cmekConfig`",
 "location": "path",
 "pattern": "^projects/[^/]+/locations/[^/]+/cmekConfig$",
 "required": true,
@@ -870,7 +870,7 @@
 }
 }
 },
-"revision": "20260916",
+"revision": "20261005",
 "rootUrl": "https://cloudtasks.googleapis.com/",
 "schemas": {
 "AppEngineHttpRequest": {
@@ -982,7 +982,7 @@
 "type": "string"
 },
 "requests": {
-"description": "Required. The list of requests to create tasks. The queue specified in parent field of each CreateTaskRequest will be the same. This validation happens on the client side as well as in the handler. BatchCreateTasksRequest.parent will also be the same value as the individual CreateTaskRequest.parent . The maximum number of requests is 100.",
+"description": "Required. The list of requests to create tasks. The queue specified in parent field of each CreateTaskRequest will be the same. This validation happens on the client side as well as in the handler. BatchCreateTasksRequest.parent will also be the same value as the individual `CreateTaskRequest.parent`. The maximum number of requests is 100.",
 "items": {
 "$ref": "CreateTaskRequest"
 },
@@ -1062,7 +1062,7 @@
 "type": "string"
 },
 "name": {
-"description": "Output only. The config resource name which includes the project and location and must end in 'cmekConfig', in the format projects/PROJECT_ID/locations/LOCATION_ID/cmekConfig`",
+"description": "Output only. The config resource name which includes the project and location and must end in 'cmekConfig', in the format `projects/PROJECT_ID/locations/LOCATION_ID/cmekConfig`",
 "readOnly": true,
 "type": "string"
 }
@@ -1263,7 +1263,7 @@
 "id": "HttpTarget",
 "properties": {
 "headerOverrides": {
-"description": "HTTP target headers. This map contains the header field names and values. Headers will be set when running the CreateTask and/or BufferTask. These headers represent a subset of the headers that will be configured for the task's HTTP request. Some HTTP request headers will be ignored or replaced. A partial list of headers that will be ignored or replaced is: * Several predefined headers, prefixed with \"X-CloudTasks-\", can be used to define properties of the task. * Host: This will be computed by Cloud Tasks and derived from HttpRequest.url. * Content-Length: This will be computed by Cloud Tasks. `Content-Type` won't be set by Cloud Tasks. You can explicitly set `Content-Type` to a media type when the task is created. For example,`Content-Type` can be set to `\"application/octet-stream\"` or `\"application/json\"`. The default value is set to \"application/json\"`. * User-Agent: This will be set to `\"Google-Cloud-Tasks\"`. Headers which can have multiple values (according to RFC2616) can be specified using comma-separated values. The size of the headers must be less than 80KB. Queue-level headers to override headers of all the tasks in the queue. Do not put business sensitive or personally identifying data in the HTTP Header Override Configuration or other similar fields in accordance with Section 12 (Resource Fields) of the [Service Specific Terms](https://cloud.google.com/terms/service-terms).",
+"description": "HTTP target headers. This map contains the header field names and values. Headers will be set when running the CreateTask and/or BufferTask. These headers represent a subset of the headers that will be configured for the task's HTTP request. Some HTTP request headers will be ignored or replaced. A partial list of headers that will be ignored or replaced is: * Several predefined headers, prefixed with \"X-CloudTasks-\", can be used to define properties of the task. * Host: This will be computed by Cloud Tasks and derived from HttpRequest.url. * Content-Length: This will be computed by Cloud Tasks. `Content-Type` won't be set by Cloud Tasks. You can explicitly set `Content-Type` to a media type when the task is created. For example, `Content-Type` can be set to `\"application/octet-stream\"` or `\"application/json\"`. The default value is set to `\"application/json\"`. * User-Agent: This will be set to `\"Google-Cloud-Tasks\"`. Headers which can have multiple values (according to RFC2616) can be specified using comma-separated values. The size of the headers must be less than 80KB. Queue-level headers to override headers of all the tasks in the queue. Do not put business sensitive or personally identifying data in the HTTP Header Override Configuration or other similar fields in accordance with Section 12 (Resource Fields) of the [Service Specific Terms](https://cloud.google.com/terms/service-terms).",
 "items": {
 "$ref": "HeaderOverride"
 },
diff --git a/googleapiclient/discovery_cache/documents/compute.v1.json b/googleapiclient/discovery_cache/documents/compute.v1.json
index c0dfcaa9bf..3c1a8cf7e1 100644
--- a/googleapiclient/discovery_cache/documents/compute.v1.json
+++ b/googleapiclient/discovery_cache/documents/compute.v1.json
@@ -49255,7 +49255,7 @@
 }
 }
 },
-"revision": "20260922",
+"revision": "20261007",
 "rootUrl": "https://compute.googleapis.com/",
 "schemas": {
 "AWSV4Signature": {
@@ -55977,6 +55977,7 @@ false
 "COMPUTE_OPTIMIZED_C3D",
 "COMPUTE_OPTIMIZED_H3",
 "COMPUTE_OPTIMIZED_H4D",
+"COMPUTE_OPTIMIZED_H4D_3TB",
 "GENERAL_PURPOSE",
 "GENERAL_PURPOSE_C4",
 "GENERAL_PURPOSE_C4A",
@@ -56027,6 +56028,7 @@ false
 "",
 "",
 "",
+"CUD bucket for COMPUTE_OPTIMIZED_H4D_3TB machines.",
 "",
 "",
 "",
diff --git a/googleapiclient/discovery_cache/documents/dataflow.v1b3.json b/googleapiclient/discovery_cache/documents/dataflow.v1b3.json
index 085dfdd9b1..9817903914 100644
--- a/googleapiclient/discovery_cache/documents/dataflow.v1b3.json
+++ b/googleapiclient/discovery_cache/documents/dataflow.v1b3.json
@@ -2899,7 +2899,7 @@
 }
 }
 },
-"revision": "20260825",
+"revision": "20261011",
 "rootUrl": "https://dataflow.googleapis.com/",
 "schemas": {
 "ApproximateProgress": {
@@ -3041,7 +3041,7 @@
 "description": "Optional. The parameters to use for autoscaling when this schedule is active."
 },
 "priority": {
-"description": "Optional. Specifies the priority of the schedule. If two schedules overlap, the one with the higher priority will be used. The higher the value, the higher the priority of the schedule.",
+"description": "Optional. Specifies the priority of the schedule. If two schedules overlap, the one with the higher priority will be used. The higher the value, the higher the priority of the schedule. The value must be non-negative; the lowest priority is `0`, which is the default.",
 "format": "int64",
 "type": "string"
 },
diff --git a/googleapiclient/discovery_cache/documents/displayvideo.v2.json b/googleapiclient/discovery_cache/documents/displayvideo.v2.json
index ccc05374ed..d044ec15b4 100644
--- a/googleapiclient/discovery_cache/documents/displayvideo.v2.json
+++ b/googleapiclient/discovery_cache/documents/displayvideo.v2.json
@@ -1915,7 +1915,6 @@
 "TARGETING_TYPE_ON_SCREEN_POSITION",
 "TARGETING_TYPE_THIRD_PARTY_VERIFIER",
 "TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION",
-"TARGETING_TYPE_SENSITIVE_CATEGORY_EXCLUSION",
 "TARGETING_TYPE_ENVIRONMENT",
 "TARGETING_TYPE_CARRIER_AND_ISP",
 "TARGETING_TYPE_OPERATING_SYSTEM",
@@ -1966,7 +1965,6 @@
 "Target ads in a specific on screen position.",
 "Filter web sites through third party verification (for example, IAS or DoubleVerify).",
 "Filter web sites by specific digital content label ratings (for example, DL-MA: suitable only for mature audiences).",
-"Filter website content by sensitive categories (for example, adult).",
 "Target ads to a specific environment (for example, web or app).",
 "Target ads to a specific network carrier or internet service provider (ISP) (for example, Comcast or Orange).",
 "Target ads to a specific operating system (for example, macOS).",
@@ -2071,7 +2069,6 @@
 "TARGETING_TYPE_ON_SCREEN_POSITION",
 "TARGETING_TYPE_THIRD_PARTY_VERIFIER",
 "TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION",
-"TARGETING_TYPE_SENSITIVE_CATEGORY_EXCLUSION",
 "TARGETING_TYPE_ENVIRONMENT",
 "TARGETING_TYPE_CARRIER_AND_ISP",
 "TARGETING_TYPE_OPERATING_SYSTEM",
@@ -2122,7 +2119,6 @@
 "Target ads in a specific on screen position.",
 "Filter web sites through third party verification (for example, IAS or DoubleVerify).",
 "Filter web sites by specific digital content label ratings (for example, DL-MA: suitable only for mature audiences).",
-"Filter website content by sensitive categories (for example, adult).",
 "Target ads to a specific environment (for example, web or app).",
 "Target ads to a specific network carrier or internet service provider (ISP) (for example, Comcast or Orange).",
 "Target ads to a specific operating system (for example, macOS).",
@@ -2224,7 +2220,6 @@
 "TARGETING_TYPE_ON_SCREEN_POSITION",
 "TARGETING_TYPE_THIRD_PARTY_VERIFIER",
 "TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION",
-"TARGETING_TYPE_SENSITIVE_CATEGORY_EXCLUSION",
 "TARGETING_TYPE_ENVIRONMENT",
 "TARGETING_TYPE_CARRIER_AND_ISP",
 "TARGETING_TYPE_OPERATING_SYSTEM",
@@ -2275,7 +2270,6 @@
 "Target ads in a specific on screen position.",
 "Filter web sites through third party verification (for example, IAS or DoubleVerify).",
 "Filter web sites by specific digital content label ratings (for example, DL-MA: suitable only for mature audiences).",
-"Filter website content by sensitive categories (for example, adult).",
 "Target ads to a specific environment (for example, web or app).",
 "Target ads to a specific network carrier or internet service provider (ISP) (for example, Comcast or Orange).",
 "Target ads to a specific operating system (for example, macOS).",
@@ -2390,7 +2384,6 @@
 "TARGETING_TYPE_ON_SCREEN_POSITION",
 "TARGETING_TYPE_THIRD_PARTY_VERIFIER",
 "TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION",
-"TARGETING_TYPE_SENSITIVE_CATEGORY_EXCLUSION",
 "TARGETING_TYPE_ENVIRONMENT",
 "TARGETING_TYPE_CARRIER_AND_ISP",
 "TARGETING_TYPE_OPERATING_SYSTEM",
@@ -2441,7 +2434,6 @@
 "Target ads in a specific on screen position.",
 "Filter web sites through third party verification (for example, IAS or DoubleVerify).",
 "Filter web sites by specific digital content label ratings (for example, DL-MA: suitable only for mature audiences).",
-"Filter website content by sensitive categories (for example, adult).",
 "Target ads to a specific environment (for example, web or app).",
 "Target ads to a specific network carrier or internet service provider (ISP) (for example, Comcast or Orange).",
 "Target ads to a specific operating system (for example, macOS).",
@@ -3502,7 +3494,6 @@
 "TARGETING_TYPE_ON_SCREEN_POSITION",
 "TARGETING_TYPE_THIRD_PARTY_VERIFIER",
 "TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION",
-"TARGETING_TYPE_SENSITIVE_CATEGORY_EXCLUSION",
 "TARGETING_TYPE_ENVIRONMENT",
 "TARGETING_TYPE_CARRIER_AND_ISP",
 "TARGETING_TYPE_OPERATING_SYSTEM",
@@ -3553,7 +3544,6 @@
 "Target ads in a specific on screen position.",
 "Filter web sites through third party verification (for example, IAS or DoubleVerify).",
 "Filter web sites by specific digital content label ratings (for example, DL-MA: suitable only for mature audiences).",
-"Filter website content by sensitive categories (for example, adult).",
 "Target ads to a specific environment (for example, web or app).",
 "Target ads to a specific network carrier or internet service provider (ISP) (for example, Comcast or Orange).",
 "Target ads to a specific operating system (for example, macOS).",
@@ -3649,7 +3639,6 @@
 "TARGETING_TYPE_ON_SCREEN_POSITION",
 "TARGETING_TYPE_THIRD_PARTY_VERIFIER",
 "TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION",
-"TARGETING_TYPE_SENSITIVE_CATEGORY_EXCLUSION",
 "TARGETING_TYPE_ENVIRONMENT",
 "TARGETING_TYPE_CARRIER_AND_ISP",
 "TARGETING_TYPE_OPERATING_SYSTEM",
@@ -3700,7 +3689,6 @@
 "Target ads in a specific on screen position.",
 "Filter web sites through third party verification (for example, IAS or DoubleVerify).",
 "Filter web sites by specific digital content label ratings (for example, DL-MA: suitable only for mature audiences).",
-"Filter website content by sensitive categories (for example, adult).",
 "Target ads to a specific environment (for example, web or app).",
 "Target ads to a specific network carrier or internet service provider (ISP) (for example, Comcast or Orange).",
 "Target ads to a specific operating system (for example, macOS).",
@@ -3793,7 +3781,6 @@
 "TARGETING_TYPE_ON_SCREEN_POSITION",
 "TARGETING_TYPE_THIRD_PARTY_VERIFIER",
 "TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION",
-"TARGETING_TYPE_SENSITIVE_CATEGORY_EXCLUSION",
 "TARGETING_TYPE_ENVIRONMENT",
 "TARGETING_TYPE_CARRIER_AND_ISP",
 "TARGETING_TYPE_OPERATING_SYSTEM",
@@ -3844,7 +3831,6 @@
 "Target ads in a specific on screen position.",
 "Filter web sites through third party verification (for example, IAS or DoubleVerify).",
 "Filter web sites by specific digital content label ratings (for example, DL-MA: suitable only for mature audiences).",
-"Filter website content by sensitive categories (for example, adult).",
 "Target ads to a specific environment (for example, web or app).",
 "Target ads to a specific network carrier or internet service provider (ISP) (for example, Comcast or Orange).",
 "Target ads to a specific operating system (for example, macOS).",
@@ -3950,7 +3936,6 @@
 "TARGETING_TYPE_ON_SCREEN_POSITION",
 "TARGETING_TYPE_THIRD_PARTY_VERIFIER",
 "TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION",
-"TARGETING_TYPE_SENSITIVE_CATEGORY_EXCLUSION",
 "TARGETING_TYPE_ENVIRONMENT",
 "TARGETING_TYPE_CARRIER_AND_ISP",
 "TARGETING_TYPE_OPERATING_SYSTEM",
@@ -4001,7 +3986,6 @@
 "Target ads in a specific on screen position.",
 "Filter web sites through third party verification (for example, IAS or DoubleVerify).",
 "Filter web sites by specific digital content label ratings (for example, DL-MA: suitable only for mature audiences).",
-"Filter website content by sensitive categories (for example, adult).",
 "Target ads to a specific environment (for example, web or app).",
 "Target ads to a specific network carrier or internet service provider (ISP) (for example, Comcast or Orange).",
 "Target ads to a specific operating system (for example, macOS).",
@@ -4329,7 +4313,6 @@
 "TARGETING_TYPE_ON_SCREEN_POSITION",
 "TARGETING_TYPE_THIRD_PARTY_VERIFIER",
 "TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION",
-"TARGETING_TYPE_SENSITIVE_CATEGORY_EXCLUSION",
 "TARGETING_TYPE_ENVIRONMENT",
 "TARGETING_TYPE_CARRIER_AND_ISP",
 "TARGETING_TYPE_OPERATING_SYSTEM",
@@ -4380,7 +4363,6 @@
 "Target ads in a specific on screen position.",
 "Filter web sites through third party verification (for example, IAS or DoubleVerify).",
 "Filter web sites by specific digital content label ratings (for example, DL-MA: suitable only for mature audiences).",
-"Filter website content by sensitive categories (for example, adult).",
 "Target ads to a specific environment (for example, web or app).",
 "Target ads to a specific network carrier or internet service provider (ISP) (for example, Comcast or Orange).",
 "Target ads to a specific operating system (for example, macOS).",
@@ -4495,7 +4477,6 @@
 "TARGETING_TYPE_ON_SCREEN_POSITION",
 "TARGETING_TYPE_THIRD_PARTY_VERIFIER",
 "TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION",
-"TARGETING_TYPE_SENSITIVE_CATEGORY_EXCLUSION",
 "TARGETING_TYPE_ENVIRONMENT",
 "TARGETING_TYPE_CARRIER_AND_ISP",
 "TARGETING_TYPE_OPERATING_SYSTEM",
@@ -4546,7 +4527,6 @@
 "Target ads in a specific on screen position.",
 "Filter web sites through third party verification (for example, IAS or DoubleVerify).",
 "Filter web sites by specific digital content label ratings (for example, DL-MA: suitable only for mature audiences).",
-"Filter website content by sensitive categories (for example, adult).",
 "Target ads to a specific environment (for example, web or app).",
 "Target ads to a specific network carrier or internet service provider (ISP) (for example, Comcast or Orange).",
 "Target ads to a specific operating system (for example, macOS).",
@@ -6579,7 +6559,6 @@
 "TARGETING_TYPE_ON_SCREEN_POSITION",
 "TARGETING_TYPE_THIRD_PARTY_VERIFIER",
 "TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION",
-"TARGETING_TYPE_SENSITIVE_CATEGORY_EXCLUSION",
 "TARGETING_TYPE_ENVIRONMENT",
 "TARGETING_TYPE_CARRIER_AND_ISP",
 "TARGETING_TYPE_OPERATING_SYSTEM",
@@ -6630,7 +6609,6 @@
 "Target ads in a specific on screen position.",
 "Filter web sites through third party verification (for example, IAS or DoubleVerify).",
 "Filter web sites by specific digital content label ratings (for example, DL-MA: suitable only for mature audiences).",
-"Filter website content by sensitive categories (for example, adult).",
 "Target ads to a specific environment (for example, web or app).",
 "Target ads to a specific network carrier or internet service provider (ISP) (for example, Comcast or Orange).",
 "Target ads to a specific operating system (for example, macOS).",
@@ -6726,7 +6704,6 @@
 "TARGETING_TYPE_ON_SCREEN_POSITION",
 "TARGETING_TYPE_THIRD_PARTY_VERIFIER",
 "TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION",
-"TARGETING_TYPE_SENSITIVE_CATEGORY_EXCLUSION",
 "TARGETING_TYPE_ENVIRONMENT",
 "TARGETING_TYPE_CARRIER_AND_ISP",
 "TARGETING_TYPE_OPERATING_SYSTEM",
@@ -6777,7 +6754,6 @@
 "Target ads in a specific on screen position.",
 "Filter web sites through third party verification (for example, IAS or DoubleVerify).",
 "Filter web sites by specific digital content label ratings (for example, DL-MA: suitable only for mature audiences).",
-"Filter website content by sensitive categories (for example, adult).",
 "Target ads to a specific environment (for example, web or app).",
 "Target ads to a specific network carrier or internet service provider (ISP) (for example, Comcast or Orange).",
 "Target ads to a specific operating system (for example, macOS).",
@@ -6870,7 +6846,6 @@
 "TARGETING_TYPE_ON_SCREEN_POSITION",
 "TARGETING_TYPE_THIRD_PARTY_VERIFIER",
 "TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION",
-"TARGETING_TYPE_SENSITIVE_CATEGORY_EXCLUSION",
 "TARGETING_TYPE_ENVIRONMENT",
 "TARGETING_TYPE_CARRIER_AND_ISP",
 "TARGETING_TYPE_OPERATING_SYSTEM",
@@ -6921,7 +6896,6 @@
 "Target ads in a specific on screen position.",
 "Filter web sites through third party verification (for example, IAS or DoubleVerify).",
 "Filter web sites by specific digital content label ratings (for example, DL-MA: suitable only for mature audiences).",
-"Filter website content by sensitive categories (for example, adult).",
 "Target ads to a specific environment (for example, web or app).",
 "Target ads to a specific network carrier or internet service provider (ISP) (for example, Comcast or Orange).",
 "Target ads to a specific operating system (for example, macOS).",
@@ -7027,7 +7001,6 @@
 "TARGETING_TYPE_ON_SCREEN_POSITION",
 "TARGETING_TYPE_THIRD_PARTY_VERIFIER",
 "TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION",
-"TARGETING_TYPE_SENSITIVE_CATEGORY_EXCLUSION",
 "TARGETING_TYPE_ENVIRONMENT",
 "TARGETING_TYPE_CARRIER_AND_ISP",
 "TARGETING_TYPE_OPERATING_SYSTEM",
@@ -7078,7 +7051,6 @@
 "Target ads in a specific on screen position.",
 "Filter web sites through third party verification (for example, IAS or DoubleVerify).",
 "Filter web sites by specific digital content label ratings (for example, DL-MA: suitable only for mature audiences).",
-"Filter website content by sensitive categories (for example, adult).",
 "Target ads to a specific environment (for example, web or app).",
 "Target ads to a specific network carrier or internet service provider (ISP) (for example, Comcast or Orange).",
 "Target ads to a specific operating system (for example, macOS).",
@@ -7232,7 +7204,6 @@
 "TARGETING_TYPE_ON_SCREEN_POSITION",
 "TARGETING_TYPE_THIRD_PARTY_VERIFIER",
 "TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION",
-"TARGETING_TYPE_SENSITIVE_CATEGORY_EXCLUSION",
 "TARGETING_TYPE_ENVIRONMENT",
 "TARGETING_TYPE_CARRIER_AND_ISP",
 "TARGETING_TYPE_OPERATING_SYSTEM",
@@ -7283,7 +7254,6 @@
 "Target ads in a specific on screen position.",
 "Filter web sites through third party verification (for example, IAS or DoubleVerify).",
 "Filter web sites by specific digital content label ratings (for example, DL-MA: suitable only for mature audiences).",
-"Filter website content by sensitive categories (for example, adult).",
 "Target ads to a specific environment (for example, web or app).",
 "Target ads to a specific network carrier or internet service provider (ISP) (for example, Comcast or Orange).",
 "Target ads to a specific operating system (for example, macOS).",
@@ -7386,7 +7356,6 @@
 "TARGETING_TYPE_ON_SCREEN_POSITION",
 "TARGETING_TYPE_THIRD_PARTY_VERIFIER",
 "TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION",
-"TARGETING_TYPE_SENSITIVE_CATEGORY_EXCLUSION",
 "TARGETING_TYPE_ENVIRONMENT",
 "TARGETING_TYPE_CARRIER_AND_ISP",
 "TARGETING_TYPE_OPERATING_SYSTEM",
@@ -7437,7 +7406,6 @@
 "Target ads in a specific on screen position.",
 "Filter web sites through third party verification (for example, IAS or DoubleVerify).",
 "Filter web sites by specific digital content label ratings (for example, DL-MA: suitable only for mature audiences).",
-"Filter website content by sensitive categories (for example, adult).",
 "Target ads to a specific environment (for example, web or app).",
 "Target ads to a specific network carrier or internet service provider (ISP) (for example, Comcast or Orange).",
 "Target ads to a specific operating system (for example, macOS).",
@@ -7513,7 +7481,6 @@
 "TARGETING_TYPE_ON_SCREEN_POSITION",
 "TARGETING_TYPE_THIRD_PARTY_VERIFIER",
 "TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION",
-"TARGETING_TYPE_SENSITIVE_CATEGORY_EXCLUSION",
 "TARGETING_TYPE_ENVIRONMENT",
 "TARGETING_TYPE_CARRIER_AND_ISP",
 "TARGETING_TYPE_OPERATING_SYSTEM",
@@ -7564,7 +7531,6 @@
 "Target ads in a specific on screen position.",
 "Filter web sites through third party verification (for example, IAS or DoubleVerify).",
 "Filter web sites by specific digital content label ratings (for example, DL-MA: suitable only for mature audiences).",
-"Filter website content by sensitive categories (for example, adult).",
 "Target ads to a specific environment (for example, web or app).",
 "Target ads to a specific network carrier or internet service provider (ISP) (for example, Comcast or Orange).",
 "Target ads to a specific operating system (for example, macOS).",
@@ -7789,7 +7755,7 @@
 }
 }
 },
-"revision": "20261006",
+"revision": "20261012",
 "rootUrl": "https://displayvideo.googleapis.com/",
 "schemas": {
 "ActivateManualTriggerRequest": {
@@ -8717,7 +8683,6 @@
 "TARGETING_TYPE_ON_SCREEN_POSITION",
 "TARGETING_TYPE_THIRD_PARTY_VERIFIER",
 "TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION",
-"TARGETING_TYPE_SENSITIVE_CATEGORY_EXCLUSION",
 "TARGETING_TYPE_ENVIRONMENT",
 "TARGETING_TYPE_CARRIER_AND_ISP",
 "TARGETING_TYPE_OPERATING_SYSTEM",
@@ -8768,7 +8733,6 @@
 "Target ads in a specific on screen position.",
 "Filter web sites through third party verification (for example, IAS or DoubleVerify).",
 "Filter web sites by specific digital content label ratings (for example, DL-MA: suitable only for mature audiences).",
-"Filter website content by sensitive categories (for example, adult).",
 "Target ads to a specific environment (for example, web or app).",
 "Target ads to a specific network carrier or internet service provider (ISP) (for example, Comcast or Orange).",
 "Target ads to a specific operating system (for example, macOS).",
@@ -8924,7 +8888,7 @@
 "type": "string"
 },
 "trackingUrl": {
-"description": "The URL address loaded in the background for tracking purposes.",
+"description": "The URL address loaded in the background for tracking purposes. In v4 and earlier, this field represents the tracking URL specified by the user manually. This can be found at userSpecifiedTrackingUrl in v5.",
 "type": "string"
 },
 "video": {
@@ -10249,7 +10213,7 @@
 "id": "CommonInStreamAttribute",
 "properties": {
 "actionButtonLabel": {
-"description": "Optional. The text on the call-to-action button.",
+"description": "Optional. The text on the call-to-action button. Must be set if actionHeadline is set.",
 "type": "string"
 },
 "actionHeadline": {
@@ -10269,7 +10233,7 @@
 "type": "string"
 },
 "trackingUrl": {
-"description": "Output only. The URL address loaded in the background for tracking purposes.",
+"description": "Output only. The URL address loaded in the background for tracking purposes. In v4 and earlier, this field represents the tracking URL specified by the user manually. This can be found at userSpecifiedTrackingUrl in v5.",
 "readOnly": true,
 "type": "string"
 },
@@ -10665,7 +10629,6 @@
 "TARGETING_TYPE_ON_SCREEN_POSITION",
 "TARGETING_TYPE_THIRD_PARTY_VERIFIER",
 "TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION",
-"TARGETING_TYPE_SENSITIVE_CATEGORY_EXCLUSION",
 "TARGETING_TYPE_ENVIRONMENT",
 "TARGETING_TYPE_CARRIER_AND_ISP",
 "TARGETING_TYPE_OPERATING_SYSTEM",
@@ -10716,7 +10679,6 @@
 "Target ads in a specific on screen position.",
 "Filter web sites through third party verification (for example, IAS or DoubleVerify).",
 "Filter web sites by specific digital content label ratings (for example, DL-MA: suitable only for mature audiences).",
-"Filter website content by sensitive categories (for example, adult).",
 "Target ads to a specific environment (for example, web or app).",
 "Target ads to a specific network carrier or internet service provider (ISP) (for example, Comcast or Orange).",
 "Target ads to a specific operating system (for example, macOS).",
@@ -11641,7 +11603,6 @@ false
 "TARGETING_TYPE_ON_SCREEN_POSITION",
 "TARGETING_TYPE_THIRD_PARTY_VERIFIER",
 "TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION",
-"TARGETING_TYPE_SENSITIVE_CATEGORY_EXCLUSION",
 "TARGETING_TYPE_ENVIRONMENT",
 "TARGETING_TYPE_CARRIER_AND_ISP",
 "TARGETING_TYPE_OPERATING_SYSTEM",
@@ -11692,7 +11653,6 @@ false
 "Target ads in a specific on screen position.",
 "Filter web sites through third party verification (for example, IAS or DoubleVerify).",
 "Filter web sites by specific digital content label ratings (for example, DL-MA: suitable only for mature audiences).",
-"Filter website content by sensitive categories (for example, adult).",
 "Target ads to a specific environment (for example, web or app).",
 "Target ads to a specific network carrier or internet service provider (ISP) (for example, Comcast or Orange).",
 "Target ads to a specific operating system (for example, macOS).",
@@ -18243,7 +18203,6 @@ true
 "TARGETING_TYPE_ON_SCREEN_POSITION",
 "TARGETING_TYPE_THIRD_PARTY_VERIFIER",
 "TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION",
-"TARGETING_TYPE_SENSITIVE_CATEGORY_EXCLUSION",
 "TARGETING_TYPE_ENVIRONMENT",
 "TARGETING_TYPE_CARRIER_AND_ISP",
 "TARGETING_TYPE_OPERATING_SYSTEM",
@@ -18294,7 +18253,6 @@ true
 "Target ads in a specific on screen position.",
 "Filter web sites through third party verification (for example, IAS or DoubleVerify).",
 "Filter web sites by specific digital content label ratings (for example, DL-MA: suitable only for mature audiences).",
-"Filter website content by sensitive categories (for example, adult).",
 "Target ads to a specific environment (for example, web or app).",
 "Target ads to a specific network carrier or internet service provider (ISP) (for example, Comcast or Orange).",
 "Target ads to a specific operating system (for example, macOS).",
@@ -18874,7 +18832,7 @@ true
 "id": "VideoPerformanceAd",
 "properties": {
 "actionButtonLabels": {
-"description": "Optional. The list of text assets shown on the call-to-action button.",
+"description": "Optional. The list of text assets shown on the call-to-action button. Must be set if headlines is set.",
 "items": {
 "type": "string"
 },
@@ -18895,7 +18853,7 @@ true
 "type": "object"
 },
 "descriptions": {
-"description": "Optional. The list of descriptions shown on the call-to-action banner.",
+"description": "Optional. The list of descriptions shown on the call-to-action banner. Must be set unless the parent line item's lineItemType is `LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_NON_SKIPPABLE`, in which case this field cannot be set.",
 "items": {
 "type": "string"
 },
@@ -18906,7 +18864,7 @@ true
 "type": "string"
 },
 "displayUrlBreadcrumb2": {
-"description": "Optional. The second piece after the domain in the display URL.",
+"description": "Optional. The second piece after the domain in the display URL. Can only be set if displayUrlBreadcrumb1 is also set.",
 "type": "string"
 },
 "domain": {
@@ -18926,14 +18884,14 @@ true
 "type": "array"
 },
 "longHeadlines": {
-"description": "Optional. The list of long headlines shown on the call-to-action banner.",
+"description": "Optional. The list of long headlines shown on the call-to-action banner. Must be set unless the parent line item's lineItemType is `LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_NON_SKIPPABLE`, in which case this field cannot be set.",
 "items": {
 "type": "string"
 },
 "type": "array"
 },
 "trackingUrl": {
-"description": "Output only. The URL address loaded in the background for tracking purposes.",
+"description": "Output only. The URL address loaded in the background for tracking purposes. In v4 and earlier, this field represents the tracking URL specified by the user manually. This can be found at userSpecifiedTrackingUrl in v5.",
 "readOnly": true,
 "type": "string"
 },
diff --git a/googleapiclient/discovery_cache/documents/displayvideo.v3.json b/googleapiclient/discovery_cache/documents/displayvideo.v3.json
index a5efebf5e7..88b4a1c58b 100644
--- a/googleapiclient/discovery_cache/documents/displayvideo.v3.json
+++ b/googleapiclient/discovery_cache/documents/displayvideo.v3.json
@@ -377,7 +377,7 @@
 "adGroupAds": {
 "methods": {
 "create": {
-"description": "Creates an ad group ad. This method is only supported for Demand Gen ads.",
+"description": "Creates an ad group ad.",
 "flatPath": "v3/advertisers/{advertisersId}/adGroupAds",
 "httpMethod": "POST",
 "id": "displayvideo.advertisers.adGroupAds.create",
@@ -406,7 +406,7 @@
 ]
 },
 "delete": {
-"description": "Deletes an ad group ad. This method is only supported for Demand Gen ads.",
+"description": "Deletes an ad group ad.",
 "flatPath": "v3/advertisers/{advertisersId}/adGroupAds/{adGroupAdsId}",
 "httpMethod": "DELETE",
 "id": "displayvideo.advertisers.adGroupAds.delete",
@@ -416,7 +416,7 @@
 ],
 "parameters": {
 "adGroupAdId": {
-"description": "Required. The ID of the ad to delete. Only Demand Gen ads are supported.",
+"description": "Required. The ID of the ad to delete.",
 "format": "int64",
 "location": "path",
 "pattern": "^[^/]+$",
@@ -523,7 +523,7 @@
 ]
 },
 "patch": {
-"description": "Updates an ad group ad. This method is only supported for Demand Gen ads.",
+"description": "Updates an ad group ad.",
 "flatPath": "v3/advertisers/{advertisersId}/adGroupAds/{adGroupAdsId}",
 "httpMethod": "PATCH",
 "id": "displayvideo.advertisers.adGroupAds.patch",
@@ -901,7 +901,6 @@
 "TARGETING_TYPE_ON_SCREEN_POSITION",
 "TARGETING_TYPE_THIRD_PARTY_VERIFIER",
 "TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION",
-"TARGETING_TYPE_SENSITIVE_CATEGORY_EXCLUSION",
 "TARGETING_TYPE_ENVIRONMENT",
 "TARGETING_TYPE_CARRIER_AND_ISP",
 "TARGETING_TYPE_OPERATING_SYSTEM",
@@ -953,7 +952,6 @@
 "Target ads in a specific on screen position.",
 "Filter web sites through third party verification (for example, IAS or DoubleVerify).",
 "Filter web sites by specific digital content label ratings (for example, DL-MA: suitable only for mature audiences).",
-"Filter website content by sensitive categories (for example, adult).",
 "Target ads to a specific environment (for example, web or app).",
 "Target ads to a specific network carrier or internet service provider (ISP) (for example, Comcast or Orange).",
 "Target ads to a specific operating system (for example, macOS).",
@@ -1059,7 +1057,6 @@
 "TARGETING_TYPE_ON_SCREEN_POSITION",
 "TARGETING_TYPE_THIRD_PARTY_VERIFIER",
 "TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION",
-"TARGETING_TYPE_SENSITIVE_CATEGORY_EXCLUSION",
 "TARGETING_TYPE_ENVIRONMENT",
 "TARGETING_TYPE_CARRIER_AND_ISP",
 "TARGETING_TYPE_OPERATING_SYSTEM",
@@ -1111,7 +1108,6 @@
 "Target ads in a specific on screen position.",
 "Filter web sites through third party verification (for example, IAS or DoubleVerify).",
 "Filter web sites by specific digital content label ratings (for example, DL-MA: suitable only for mature audiences).",
-"Filter website content by sensitive categories (for example, adult).",
 "Target ads to a specific environment (for example, web or app).",
 "Target ads to a specific network carrier or internet service provider (ISP) (for example, Comcast or Orange).",
 "Target ads to a specific operating system (for example, macOS).",
@@ -1214,7 +1210,6 @@
 "TARGETING_TYPE_ON_SCREEN_POSITION",
 "TARGETING_TYPE_THIRD_PARTY_VERIFIER",
 "TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION",
-"TARGETING_TYPE_SENSITIVE_CATEGORY_EXCLUSION",
 "TARGETING_TYPE_ENVIRONMENT",
 "TARGETING_TYPE_CARRIER_AND_ISP",
 "TARGETING_TYPE_OPERATING_SYSTEM",
@@ -1266,7 +1261,6 @@
 "Target ads in a specific on screen position.",
 "Filter web sites through third party verification (for example, IAS or DoubleVerify).",
 "Filter web sites by specific digital content label ratings (for example, DL-MA: suitable only for mature audiences).",
-"Filter website content by sensitive categories (for example, adult).",
 "Target ads to a specific environment (for example, web or app).",
 "Target ads to a specific network carrier or internet service provider (ISP) (for example, Comcast or Orange).",
 "Target ads to a specific operating system (for example, macOS).",
@@ -1382,7 +1376,6 @@
 "TARGETING_TYPE_ON_SCREEN_POSITION",
 "TARGETING_TYPE_THIRD_PARTY_VERIFIER",
 "TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION",
-"TARGETING_TYPE_SENSITIVE_CATEGORY_EXCLUSION",
 "TARGETING_TYPE_ENVIRONMENT",
 "TARGETING_TYPE_CARRIER_AND_ISP",
 "TARGETING_TYPE_OPERATING_SYSTEM",
@@ -1434,7 +1427,6 @@
 "Target ads in a specific on screen position.",
 "Filter web sites through third party verification (for example, IAS or DoubleVerify).",
 "Filter web sites by specific digital content label ratings (for example, DL-MA: suitable only for mature audiences).",
-"Filter website content by sensitive categories (for example, adult).",
 "Target ads to a specific environment (for example, web or app).",
 "Target ads to a specific network carrier or internet service provider (ISP) (for example, Comcast or Orange).",
 "Target ads to a specific operating system (for example, macOS).",
@@ -3024,7 +3016,6 @@
 "TARGETING_TYPE_ON_SCREEN_POSITION",
 "TARGETING_TYPE_THIRD_PARTY_VERIFIER",
 "TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION",
-"TARGETING_TYPE_SENSITIVE_CATEGORY_EXCLUSION",
 "TARGETING_TYPE_ENVIRONMENT",
 "TARGETING_TYPE_CARRIER_AND_ISP",
 "TARGETING_TYPE_OPERATING_SYSTEM",
@@ -3076,7 +3067,6 @@
 "Target ads in a specific on screen position.",
 "Filter web sites through third party verification (for example, IAS or DoubleVerify).",
 "Filter web sites by specific digital content label ratings (for example, DL-MA: suitable only for mature audiences).",
-"Filter website content by sensitive categories (for example, adult).",
 "Target ads to a specific environment (for example, web or app).",
 "Target ads to a specific network carrier or internet service provider (ISP) (for example, Comcast or Orange).",
 "Target ads to a specific operating system (for example, macOS).",
@@ -3182,7 +3172,6 @@
 "TARGETING_TYPE_ON_SCREEN_POSITION",
 "TARGETING_TYPE_THIRD_PARTY_VERIFIER",
 "TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION",
-"TARGETING_TYPE_SENSITIVE_CATEGORY_EXCLUSION",
 "TARGETING_TYPE_ENVIRONMENT",
 "TARGETING_TYPE_CARRIER_AND_ISP",
 "TARGETING_TYPE_OPERATING_SYSTEM",
@@ -3234,7 +3223,6 @@
 "Target ads in a specific on screen position.",
 "Filter web sites through third party verification (for example, IAS or DoubleVerify).",
 "Filter web sites by specific digital content label ratings (for example, DL-MA: suitable only for mature audiences).",
-"Filter website content by sensitive categories (for example, adult).",
 "Target ads to a specific environment (for example, web or app).",
 "Target ads to a specific network carrier or internet service provider (ISP) (for example, Comcast or Orange).",
 "Target ads to a specific operating system (for example, macOS).",
@@ -3337,7 +3325,6 @@
 "TARGETING_TYPE_ON_SCREEN_POSITION",
 "TARGETING_TYPE_THIRD_PARTY_VERIFIER",
 "TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION",
-"TARGETING_TYPE_SENSITIVE_CATEGORY_EXCLUSION",
 "TARGETING_TYPE_ENVIRONMENT",
 "TARGETING_TYPE_CARRIER_AND_ISP",
 "TARGETING_TYPE_OPERATING_SYSTEM",
@@ -3389,7 +3376,6 @@
 "Target ads in a specific on screen position.",
 "Filter web sites through third party verification (for example, IAS or DoubleVerify).",
 "Filter web sites by specific digital content label ratings (for example, DL-MA: suitable only for mature audiences).",
-"Filter website content by sensitive categories (for example, adult).",
 "Target ads to a specific environment (for example, web or app).",
 "Target ads to a specific network carrier or internet service provider (ISP) (for example, Comcast or Orange).",
 "Target ads to a specific operating system (for example, macOS).",
@@ -3505,7 +3491,6 @@
 "TARGETING_TYPE_ON_SCREEN_POSITION",
 "TARGETING_TYPE_THIRD_PARTY_VERIFIER",
 "TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION",
-"TARGETING_TYPE_SENSITIVE_CATEGORY_EXCLUSION",
 "TARGETING_TYPE_ENVIRONMENT",
 "TARGETING_TYPE_CARRIER_AND_ISP",
 "TARGETING_TYPE_OPERATING_SYSTEM",
@@ -3557,7 +3542,6 @@
 "Target ads in a specific on screen position.",
 "Filter web sites through third party verification (for example, IAS or DoubleVerify).",
 "Filter web sites by specific digital content label ratings (for example, DL-MA: suitable only for mature audiences).",
-"Filter website content by sensitive categories (for example, adult).",
 "Target ads to a specific environment (for example, web or app).",
 "Target ads to a specific network carrier or internet service provider (ISP) (for example, Comcast or Orange).",
 "Target ads to a specific operating system (for example, macOS).",
@@ -4384,7 +4368,6 @@
 "TARGETING_TYPE_ON_SCREEN_POSITION",
 "TARGETING_TYPE_THIRD_PARTY_VERIFIER",
 "TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION",
-"TARGETING_TYPE_SENSITIVE_CATEGORY_EXCLUSION",
 "TARGETING_TYPE_ENVIRONMENT",
 "TARGETING_TYPE_CARRIER_AND_ISP",
 "TARGETING_TYPE_OPERATING_SYSTEM",
@@ -4436,7 +4419,6 @@
 "Target ads in a specific on screen position.",
 "Filter web sites through third party verification (for example, IAS or DoubleVerify).",
 "Filter web sites by specific digital content label ratings (for example, DL-MA: suitable only for mature audiences).",
-"Filter website content by sensitive categories (for example, adult).",
 "Target ads to a specific environment (for example, web or app).",
 "Target ads to a specific network carrier or internet service provider (ISP) (for example, Comcast or Orange).",
 "Target ads to a specific operating system (for example, macOS).",
@@ -4533,7 +4515,6 @@
 "TARGETING_TYPE_ON_SCREEN_POSITION",
 "TARGETING_TYPE_THIRD_PARTY_VERIFIER",
 "TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION",
-"TARGETING_TYPE_SENSITIVE_CATEGORY_EXCLUSION",
 "TARGETING_TYPE_ENVIRONMENT",
 "TARGETING_TYPE_CARRIER_AND_ISP",
 "TARGETING_TYPE_OPERATING_SYSTEM",
@@ -4585,7 +4566,6 @@
 "Target ads in a specific on screen position.",
 "Filter web sites through third party verification (for example, IAS or DoubleVerify).",
 "Filter web sites by specific digital content label ratings (for example, DL-MA: suitable only for mature audiences).",
-"Filter website content by sensitive categories (for example, adult).",
 "Target ads to a specific environment (for example, web or app).",
 "Target ads to a specific network carrier or internet service provider (ISP) (for example, Comcast or Orange).",
 "Target ads to a specific operating system (for example, macOS).",
@@ -4679,7 +4659,6 @@
 "TARGETING_TYPE_ON_SCREEN_POSITION",
 "TARGETING_TYPE_THIRD_PARTY_VERIFIER",
 "TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION",
-"TARGETING_TYPE_SENSITIVE_CATEGORY_EXCLUSION",
 "TARGETING_TYPE_ENVIRONMENT",
 "TARGETING_TYPE_CARRIER_AND_ISP",
 "TARGETING_TYPE_OPERATING_SYSTEM",
@@ -4731,7 +4710,6 @@
 "Target ads in a specific on screen position.",
 "Filter web sites through third party verification (for example, IAS or DoubleVerify).",
 "Filter web sites by specific digital content label ratings (for example, DL-MA: suitable only for mature audiences).",
-"Filter website content by sensitive categories (for example, adult).",
 "Target ads to a specific environment (for example, web or app).",
 "Target ads to a specific network carrier or internet service provider (ISP) (for example, Comcast or Orange).",
 "Target ads to a specific operating system (for example, macOS).",
@@ -4838,7 +4816,6 @@
 "TARGETING_TYPE_ON_SCREEN_POSITION",
 "TARGETING_TYPE_THIRD_PARTY_VERIFIER",
 "TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION",
-"TARGETING_TYPE_SENSITIVE_CATEGORY_EXCLUSION",
 "TARGETING_TYPE_ENVIRONMENT",
 "TARGETING_TYPE_CARRIER_AND_ISP",
 "TARGETING_TYPE_OPERATING_SYSTEM",
@@ -4890,7 +4867,6 @@
 "Target ads in a specific on screen position.",
 "Filter web sites through third party verification (for example, IAS or DoubleVerify).",
 "Filter web sites by specific digital content label ratings (for example, DL-MA: suitable only for mature audiences).",
-"Filter website content by sensitive categories (for example, adult).",
 "Target ads to a specific environment (for example, web or app).",
 "Target ads to a specific network carrier or internet service provider (ISP) (for example, Comcast or Orange).",
 "Target ads to a specific operating system (for example, macOS).",
@@ -7098,7 +7074,6 @@
 "TARGETING_TYPE_ON_SCREEN_POSITION",
 "TARGETING_TYPE_THIRD_PARTY_VERIFIER",
 "TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION",
-"TARGETING_TYPE_SENSITIVE_CATEGORY_EXCLUSION",
 "TARGETING_TYPE_ENVIRONMENT",
 "TARGETING_TYPE_CARRIER_AND_ISP",
 "TARGETING_TYPE_OPERATING_SYSTEM",
@@ -7150,7 +7125,6 @@
 "Target ads in a specific on screen position.",
 "Filter web sites through third party verification (for example, IAS or DoubleVerify).",
 "Filter web sites by specific digital content label ratings (for example, DL-MA: suitable only for mature audiences).",
-"Filter website content by sensitive categories (for example, adult).",
 "Target ads to a specific environment (for example, web or app).",
 "Target ads to a specific network carrier or internet service provider (ISP) (for example, Comcast or Orange).",
 "Target ads to a specific operating system (for example, macOS).",
@@ -7247,7 +7221,6 @@
 "TARGETING_TYPE_ON_SCREEN_POSITION",
 "TARGETING_TYPE_THIRD_PARTY_VERIFIER",
 "TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION",
-"TARGETING_TYPE_SENSITIVE_CATEGORY_EXCLUSION",
 "TARGETING_TYPE_ENVIRONMENT",
 "TARGETING_TYPE_CARRIER_AND_ISP",
 "TARGETING_TYPE_OPERATING_SYSTEM",
@@ -7299,7 +7272,6 @@
 "Target ads in a specific on screen position.",
 "Filter web sites through third party verification (for example, IAS or DoubleVerify).",
 "Filter web sites by specific digital content label ratings (for example, DL-MA: suitable only for mature audiences).",
-"Filter website content by sensitive categories (for example, adult).",
 "Target ads to a specific environment (for example, web or app).",
 "Target ads to a specific network carrier or internet service provider (ISP) (for example, Comcast or Orange).",
 "Target ads to a specific operating system (for example, macOS).",
@@ -7393,7 +7365,6 @@
 "TARGETING_TYPE_ON_SCREEN_POSITION",
 "TARGETING_TYPE_THIRD_PARTY_VERIFIER",
 "TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION",
-"TARGETING_TYPE_SENSITIVE_CATEGORY_EXCLUSION",
 "TARGETING_TYPE_ENVIRONMENT",
 "TARGETING_TYPE_CARRIER_AND_ISP",
 "TARGETING_TYPE_OPERATING_SYSTEM",
@@ -7445,7 +7416,6 @@
 "Target ads in a specific on screen position.",
 "Filter web sites through third party verification (for example, IAS or DoubleVerify).",
 "Filter web sites by specific digital content label ratings (for example, DL-MA: suitable only for mature audiences).",
-"Filter website content by sensitive categories (for example, adult).",
 "Target ads to a specific environment (for example, web or app).",
 "Target ads to a specific network carrier or internet service provider (ISP) (for example, Comcast or Orange).",
 "Target ads to a specific operating system (for example, macOS).",
@@ -7552,7 +7522,6 @@
 "TARGETING_TYPE_ON_SCREEN_POSITION",
 "TARGETING_TYPE_THIRD_PARTY_VERIFIER",
 "TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION",
-"TARGETING_TYPE_SENSITIVE_CATEGORY_EXCLUSION",
 "TARGETING_TYPE_ENVIRONMENT",
 "TARGETING_TYPE_CARRIER_AND_ISP",
 "TARGETING_TYPE_OPERATING_SYSTEM",
@@ -7604,7 +7573,6 @@
 "Target ads in a specific on screen position.",
 "Filter web sites through third party verification (for example, IAS or DoubleVerify).",
 "Filter web sites by specific digital content label ratings (for example, DL-MA: suitable only for mature audiences).",
-"Filter website content by sensitive categories (for example, adult).",
 "Target ads to a specific environment (for example, web or app).",
 "Target ads to a specific network carrier or internet service provider (ISP) (for example, Comcast or Orange).",
 "Target ads to a specific operating system (for example, macOS).",
@@ -7759,7 +7727,6 @@
 "TARGETING_TYPE_ON_SCREEN_POSITION",
 "TARGETING_TYPE_THIRD_PARTY_VERIFIER",
 "TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION",
-"TARGETING_TYPE_SENSITIVE_CATEGORY_EXCLUSION",
 "TARGETING_TYPE_ENVIRONMENT",
 "TARGETING_TYPE_CARRIER_AND_ISP",
 "TARGETING_TYPE_OPERATING_SYSTEM",
@@ -7811,7 +7778,6 @@
 "Target ads in a specific on screen position.",
 "Filter web sites through third party verification (for example, IAS or DoubleVerify).",
 "Filter web sites by specific digital content label ratings (for example, DL-MA: suitable only for mature audiences).",
-"Filter website content by sensitive categories (for example, adult).",
 "Target ads to a specific environment (for example, web or app).",
 "Target ads to a specific network carrier or internet service provider (ISP) (for example, Comcast or Orange).",
 "Target ads to a specific operating system (for example, macOS).",
@@ -7915,7 +7881,6 @@
 "TARGETING_TYPE_ON_SCREEN_POSITION",
 "TARGETING_TYPE_THIRD_PARTY_VERIFIER",
 "TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION",
-"TARGETING_TYPE_SENSITIVE_CATEGORY_EXCLUSION",
 "TARGETING_TYPE_ENVIRONMENT",
 "TARGETING_TYPE_CARRIER_AND_ISP",
 "TARGETING_TYPE_OPERATING_SYSTEM",
@@ -7967,7 +7932,6 @@
 "Target ads in a specific on screen position.",
 "Filter web sites through third party verification (for example, IAS or DoubleVerify).",
 "Filter web sites by specific digital content label ratings (for example, DL-MA: suitable only for mature audiences).",
-"Filter website content by sensitive categories (for example, adult).",
 "Target ads to a specific environment (for example, web or app).",
 "Target ads to a specific network carrier or internet service provider (ISP) (for example, Comcast or Orange).",
 "Target ads to a specific operating system (for example, macOS).",
@@ -8044,7 +8008,6 @@
 "TARGETING_TYPE_ON_SCREEN_POSITION",
 "TARGETING_TYPE_THIRD_PARTY_VERIFIER",
 "TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION",
-"TARGETING_TYPE_SENSITIVE_CATEGORY_EXCLUSION",
 "TARGETING_TYPE_ENVIRONMENT",
 "TARGETING_TYPE_CARRIER_AND_ISP",
 "TARGETING_TYPE_OPERATING_SYSTEM",
@@ -8096,7 +8059,6 @@
 "Target ads in a specific on screen position.",
 "Filter web sites through third party verification (for example, IAS or DoubleVerify).",
 "Filter web sites by specific digital content label ratings (for example, DL-MA: suitable only for mature audiences).",
-"Filter website content by sensitive categories (for example, adult).",
 "Target ads to a specific environment (for example, web or app).",
 "Target ads to a specific network carrier or internet service provider (ISP) (for example, Comcast or Orange).",
 "Target ads to a specific operating system (for example, macOS).",
@@ -8322,7 +8284,7 @@
 }
 }
 },
-"revision": "20261006",
+"revision": "20261012",
 "rootUrl": "https://displayvideo.googleapis.com/",
 "schemas": {
 "ActiveViewVideoViewabilityMetricConfig": {
@@ -8441,7 +8403,7 @@
 "type": "object"
 },
 "AdGroup": {
-"description": "A single ad group associated with a line item.",
+"description": "LINT: LEGACY_NAMES A single ad group associated with a line item.",
 "id": "AdGroup",
 "properties": {
 "adGroupFormat": {
@@ -8538,7 +8500,7 @@
 "type": "object"
 },
 "AdGroupAd": {
-"description": "LINT: LEGACY_NAMES A single ad associated with an ad group.",
+"description": "A single ad associated with an ad group.",
 "id": "AdGroupAd",
 "properties": {
 "adGroupAdId": {
@@ -8582,7 +8544,7 @@
 },
 "dcmTrackingInfo": {
 "$ref": "DcmTrackingInfo",
-"description": "Optional. The DCM tracking ad info. Only valid for Demand Gen ads. To remove the DCM tracking ad info, please leave this field empty."
+"description": "Optional. The DCM tracking ad info. To remove the DCM tracking ad info, please leave this field empty."
 },
 "demandGenCarouselAd": {
 "$ref": "DemandGenCarouselAd",
@@ -10985,7 +10947,6 @@
 "TARGETING_TYPE_ON_SCREEN_POSITION",
 "TARGETING_TYPE_THIRD_PARTY_VERIFIER",
 "TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION",
-"TARGETING_TYPE_SENSITIVE_CATEGORY_EXCLUSION",
 "TARGETING_TYPE_ENVIRONMENT",
 "TARGETING_TYPE_CARRIER_AND_ISP",
 "TARGETING_TYPE_OPERATING_SYSTEM",
@@ -11037,7 +10998,6 @@
 "Target ads in a specific on screen position.",
 "Filter web sites through third party verification (for example, IAS or DoubleVerify).",
 "Filter web sites by specific digital content label ratings (for example, DL-MA: suitable only for mature audiences).",
-"Filter website content by sensitive categories (for example, adult).",
 "Target ads to a specific environment (for example, web or app).",
 "Target ads to a specific network carrier or internet service provider (ISP) (for example, Comcast or Orange).",
 "Target ads to a specific operating system (for example, macOS).",
@@ -11205,7 +11165,7 @@
 "type": "string"
 },
 "trackingUrl": {
-"description": "The URL address loaded in the background for tracking purposes.",
+"description": "The URL address loaded in the background for tracking purposes. In v4 and earlier, this field represents the tracking URL specified by the user manually. This can be found at userSpecifiedTrackingUrl in v5.",
 "type": "string"
 },
 "video": {
@@ -12627,7 +12587,7 @@
 "id": "CommonInStreamAttribute",
 "properties": {
 "actionButtonLabel": {
-"description": "Optional. The text on the call-to-action button.",
+"description": "Optional. The text on the call-to-action button. Must be set if actionHeadline is set.",
 "type": "string"
 },
 "actionHeadline": {
@@ -12647,7 +12607,7 @@
 "type": "string"
 },
 "trackingUrl": {
-"description": "Output only. The URL address loaded in the background for tracking purposes.",
+"description": "Output only. The URL address loaded in the background for tracking purposes. In v4 and earlier, this field represents the tracking URL specified by the user manually. This can be found at userSpecifiedTrackingUrl in v5.",
 "readOnly": true,
 "type": "string"
 },
@@ -13147,7 +13107,6 @@
 "TARGETING_TYPE_ON_SCREEN_POSITION",
 "TARGETING_TYPE_THIRD_PARTY_VERIFIER",
 "TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION",
-"TARGETING_TYPE_SENSITIVE_CATEGORY_EXCLUSION",
 "TARGETING_TYPE_ENVIRONMENT",
 "TARGETING_TYPE_CARRIER_AND_ISP",
 "TARGETING_TYPE_OPERATING_SYSTEM",
@@ -13199,7 +13158,6 @@
 "Target ads in a specific on screen position.",
 "Filter web sites through third party verification (for example, IAS or DoubleVerify).",
 "Filter web sites by specific digital content label ratings (for example, DL-MA: suitable only for mature audiences).",
-"Filter website content by sensitive categories (for example, adult).",
 "Target ads to a specific environment (for example, web or app).",
 "Target ads to a specific network carrier or internet service provider (ISP) (for example, Comcast or Orange).",
 "Target ads to a specific operating system (for example, macOS).",
@@ -14299,7 +14257,6 @@ false
 "TARGETING_TYPE_ON_SCREEN_POSITION",
 "TARGETING_TYPE_THIRD_PARTY_VERIFIER",
 "TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION",
-"TARGETING_TYPE_SENSITIVE_CATEGORY_EXCLUSION",
 "TARGETING_TYPE_ENVIRONMENT",
 "TARGETING_TYPE_CARRIER_AND_ISP",
 "TARGETING_TYPE_OPERATING_SYSTEM",
@@ -14351,7 +14308,6 @@ false
 "Target ads in a specific on screen position.",
 "Filter web sites through third party verification (for example, IAS or DoubleVerify).",
 "Filter web sites by specific digital content label ratings (for example, DL-MA: suitable only for mature audiences).",
-"Filter website content by sensitive categories (for example, adult).",
 "Target ads to a specific environment (for example, web or app).",
 "Target ads to a specific network carrier or internet service provider (ISP) (for example, Comcast or Orange).",
 "Target ads to a specific operating system (for example, macOS).",
@@ -21467,7 +21423,6 @@ false
 "TARGETING_TYPE_ON_SCREEN_POSITION",
 "TARGETING_TYPE_THIRD_PARTY_VERIFIER",
 "TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION",
-"TARGETING_TYPE_SENSITIVE_CATEGORY_EXCLUSION",
 "TARGETING_TYPE_ENVIRONMENT",
 "TARGETING_TYPE_CARRIER_AND_ISP",
 "TARGETING_TYPE_OPERATING_SYSTEM",
@@ -21519,7 +21474,6 @@ false
 "Target ads in a specific on screen position.",
 "Filter web sites through third party verification (for example, IAS or DoubleVerify).",
 "Filter web sites by specific digital content label ratings (for example, DL-MA: suitable only for mature audiences).",
-"Filter website content by sensitive categories (for example, adult).",
 "Target ads to a specific environment (for example, web or app).",
 "Target ads to a specific network carrier or internet service provider (ISP) (for example, Comcast or Orange).",
 "Target ads to a specific operating system (for example, macOS).",
@@ -22100,7 +22054,7 @@ false
 "id": "VideoPerformanceAd",
 "properties": {
 "actionButtonLabels": {
-"description": "Optional. The list of text assets shown on the call-to-action button.",
+"description": "Optional. The list of text assets shown on the call-to-action button. Must be set if headlines is set.",
 "items": {
 "type": "string"
 },
@@ -22121,7 +22075,7 @@ false
 "type": "object"
 },
 "descriptions": {
-"description": "Optional. The list of descriptions shown on the call-to-action banner.",
+"description": "Optional. The list of descriptions shown on the call-to-action banner. Must be set unless the parent line item's lineItemType is `LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_NON_SKIPPABLE`, in which case this field cannot be set.",
 "items": {
 "type": "string"
 },
@@ -22132,7 +22086,7 @@ false
 "type": "string"
 },
 "displayUrlBreadcrumb2": {
-"description": "Optional. The second piece after the domain in the display URL.",
+"description": "Optional. The second piece after the domain in the display URL. Can only be set if displayUrlBreadcrumb1 is also set.",
 "type": "string"
 },
 "domain": {
@@ -22152,14 +22106,14 @@ false
 "type": "array"
 },
 "longHeadlines": {
-"description": "Optional. The list of long headlines shown on the call-to-action banner.",
+"description": "Optional. The list of long headlines shown on the call-to-action banner. Must be set unless the parent line item's lineItemType is `LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_NON_SKIPPABLE`, in which case this field cannot be set.",
 "items": {
 "type": "string"
 },
 "type": "array"
 },
 "trackingUrl": {
-"description": "Output only. The URL address loaded in the background for tracking purposes.",
+"description": "Output only. The URL address loaded in the background for tracking purposes. In v4 and earlier, this field represents the tracking URL specified by the user manually. This can be found at userSpecifiedTrackingUrl in v5.",
 "readOnly": true,
 "type": "string"
 },
diff --git a/googleapiclient/discovery_cache/documents/displayvideo.v4.json b/googleapiclient/discovery_cache/documents/displayvideo.v4.json
index 705a25fe3d..546c1e0987 100644
--- a/googleapiclient/discovery_cache/documents/displayvideo.v4.json
+++ b/googleapiclient/discovery_cache/documents/displayvideo.v4.json
@@ -606,7 +606,7 @@
 "adGroupAds": {
 "methods": {
 "create": {
-"description": "Creates an ad group ad. This method is only supported for Demand Gen ads.",
+"description": "Creates an ad group ad.",
 "flatPath": "v4/advertisers/{advertisersId}/adGroupAds",
 "httpMethod": "POST",
 "id": "displayvideo.advertisers.adGroupAds.create",
@@ -635,7 +635,7 @@
 ]
 },
 "delete": {
-"description": "Deletes an ad group ad. This method is only supported for Demand Gen ads.",
+"description": "Deletes an ad group ad.",
 "flatPath": "v4/advertisers/{advertisersId}/adGroupAds/{adGroupAdsId}",
 "httpMethod": "DELETE",
 "id": "displayvideo.advertisers.adGroupAds.delete",
@@ -645,7 +645,7 @@
 ],
 "parameters": {
 "adGroupAdId": {
-"description": "Required. The ID of the ad to delete. Only Demand Gen ads are supported.",
+"description": "Required. The ID of the ad to delete.",
 "format": "int64",
 "location": "path",
 "pattern": "^[^/]+$",
@@ -752,7 +752,7 @@
 ]
 },
 "patch": {
-"description": "Updates an ad group ad. This method is only supported for Demand Gen ads.",
+"description": "Updates an ad group ad.",
 "flatPath": "v4/advertisers/{advertisersId}/adGroupAds/{adGroupAdsId}",
 "httpMethod": "PATCH",
 "id": "displayvideo.advertisers.adGroupAds.patch",
@@ -9618,7 +9618,7 @@
 }
 }
 },
-"revision": "20261006",
+"revision": "20261012",
 "rootUrl": "https://displayvideo.googleapis.com/",
 "schemas": {
 "ActiveViewVideoViewabilityMetricConfig": {
@@ -9807,7 +9807,7 @@
 "type": "object"
 },
 "AdGroup": {
-"description": "A single ad group associated with a line item.",
+"description": "LINT: LEGACY_NAMES A single ad group associated with a line item.",
 "id": "AdGroup",
 "properties": {
 "adGroupFormat": {
@@ -9904,7 +9904,7 @@
 "type": "object"
 },
 "AdGroupAd": {
-"description": "LINT: LEGACY_NAMES A single ad associated with an ad group.",
+"description": "A single ad associated with an ad group.",
 "id": "AdGroupAd",
 "properties": {
 "adGroupAdId": {
@@ -9948,7 +9948,7 @@
 },
 "dcmTrackingInfo": {
 "$ref": "DcmTrackingInfo",
-"description": "Optional. The DCM tracking ad info. Only valid for Demand Gen ads. To remove the DCM tracking ad info, please leave this field empty."
+"description": "Optional. The DCM tracking ad info. To remove the DCM tracking ad info, please leave this field empty."
 },
 "demandGenCarouselAd": {
 "$ref": "DemandGenCarouselAd",
@@ -12752,7 +12752,7 @@
 "type": "string"
 },
 "trackingUrl": {
-"description": "The URL address loaded in the background for tracking purposes.",
+"description": "The URL address loaded in the background for tracking purposes. In v4 and earlier, this field represents the tracking URL specified by the user manually. This can be found at userSpecifiedTrackingUrl in v5.",
 "type": "string"
 },
 "video": {
@@ -14218,7 +14218,7 @@
 "id": "CommonInStreamAttribute",
 "properties": {
 "actionButtonLabel": {
-"description": "Optional. The text on the call-to-action button.",
+"description": "Optional. The text on the call-to-action button. Must be set if actionHeadline is set.",
 "type": "string"
 },
 "actionHeadline": {
@@ -14238,7 +14238,7 @@
 "type": "string"
 },
 "trackingUrl": {
-"description": "Output only. The URL address loaded in the background for tracking purposes.",
+"description": "Output only. The URL address loaded in the background for tracking purposes. In v4 and earlier, this field represents the tracking URL specified by the user manually. This can be found at userSpecifiedTrackingUrl in v5.",
 "readOnly": true,
 "type": "string"
 },
@@ -25775,7 +25775,7 @@ false
 "id": "VideoPerformanceAd",
 "properties": {
 "actionButtonLabels": {
-"description": "Optional. The list of text assets shown on the call-to-action button.",
+"description": "Optional. The list of text assets shown on the call-to-action button. Must be set if headlines is set.",
 "items": {
 "type": "string"
 },
@@ -25796,7 +25796,7 @@ false
 "type": "object"
 },
 "descriptions": {
-"description": "Optional. The list of descriptions shown on the call-to-action banner.",
+"description": "Optional. The list of descriptions shown on the call-to-action banner. Must be set unless the parent line item's lineItemType is `LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_NON_SKIPPABLE`, in which case this field cannot be set.",
 "items": {
 "type": "string"
 },
@@ -25807,7 +25807,7 @@ false
 "type": "string"
 },
 "displayUrlBreadcrumb2": {
-"description": "Optional. The second piece after the domain in the display URL.",
+"description": "Optional. The second piece after the domain in the display URL. Can only be set if displayUrlBreadcrumb1 is also set.",
 "type": "string"
 },
 "domain": {
@@ -25827,14 +25827,14 @@ false
 "type": "array"
 },
 "longHeadlines": {
-"description": "Optional. The list of long headlines shown on the call-to-action banner.",
+"description": "Optional. The list of long headlines shown on the call-to-action banner. Must be set unless the parent line item's lineItemType is `LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_NON_SKIPPABLE`, in which case this field cannot be set.",
 "items": {
 "type": "string"
 },
 "type": "array"
 },
 "trackingUrl": {
-"description": "Output only. The URL address loaded in the background for tracking purposes.",
+"description": "Output only. The URL address loaded in the background for tracking purposes. In v4 and earlier, this field represents the tracking URL specified by the user manually. This can be found at userSpecifiedTrackingUrl in v5.",
 "readOnly": true,
 "type": "string"
 },
diff --git a/googleapiclient/discovery_cache/documents/dns.v1.json b/googleapiclient/discovery_cache/documents/dns.v1.json
index b39946b777..10cfcdfa86 100644
--- a/googleapiclient/discovery_cache/documents/dns.v1.json
+++ b/googleapiclient/discovery_cache/documents/dns.v1.json
@@ -2240,7 +2240,7 @@
 }
 }
 },
-"revision": "20261002",
+"revision": "20261009",
 "rootUrl": "https://dns.googleapis.com/",
 "schemas": {
 "Change": {
@@ -3376,7 +3376,7 @@
 "type": "string"
 },
 "endpointIp": {
-"description": "Required. Immutable. User provided IP address to use for outbound DNS forwarding. This address must be a free address on the subnetwork.",
+"description": "Optional. Immutable. User provided IP address to use for outbound DNS forwarding. This address must be a free address on the subnetwork. If omitted, a free IP address from the subnetwork is automatically allocated.",
 "type": "string"
 },
 "labels": {
diff --git a/googleapiclient/discovery_cache/documents/dns.v1beta2.json b/googleapiclient/discovery_cache/documents/dns.v1beta2.json
index a77ffb7c6a..5e8bff9cc6 100644
--- a/googleapiclient/discovery_cache/documents/dns.v1beta2.json
+++ b/googleapiclient/discovery_cache/documents/dns.v1beta2.json
@@ -2237,7 +2237,7 @@
 }
 }
 },
-"revision": "20261002",
+"revision": "20261009",
 "rootUrl": "https://dns.googleapis.com/",
 "schemas": {
 "Change": {
@@ -3373,7 +3373,7 @@
 "type": "string"
 },
 "endpointIp": {
-"description": "Required. Immutable. User provided IP address to use for outbound DNS forwarding. This address must be a free address on the subnetwork.",
+"description": "Optional. Immutable. User provided IP address to use for outbound DNS forwarding. This address must be a free address on the subnetwork. If omitted, a free IP address from the subnetwork is automatically allocated.",
 "type": "string"
 },
 "labels": {
diff --git a/googleapiclient/discovery_cache/documents/firebaseml.v2beta.json b/googleapiclient/discovery_cache/documents/firebaseml.v2beta.json
index e8ac1b939d..c3f671a251 100644
--- a/googleapiclient/discovery_cache/documents/firebaseml.v2beta.json
+++ b/googleapiclient/discovery_cache/documents/firebaseml.v2beta.json
@@ -206,7 +206,7 @@
 }
 }
 },
-"revision": "20261004",
+"revision": "20261011",
 "rootUrl": "https://firebaseml.googleapis.com/",
 "schemas": {
 "Date": {
@@ -648,6 +648,7 @@
 "IMAGE_OTHER",
 "UNEXPECTED_TOOL_CALL",
 "NO_IMAGE",
+"MALFORMED_RESPONSE",
 "CONTINUATION"
 ],
 "enumDescriptions": [
@@ -668,6 +669,7 @@
 "The image generation stopped for a reason not otherwise specified.",
 "The model generated a function call that is semantically invalid. This can happen, for example, if function calling is not enabled or the generated function is not in the function declaration.",
 "The model was expected to generate an image, but didn't.",
+"Finishes due to malformed response.",
 "Token generation was stopped because the response reached the per-request token limit, but generation is not yet complete. The model response can be continued via a subsequent request using the returned `continuation_token`."
 ],
 "readOnly": true,
@@ -2386,7 +2388,7 @@
 "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`. For media types that are not text, `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.",
+"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` must contain one of the accepted types in `Part.data`. For media types that are not text, `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",
 "properties": {
 "audioTranscription": {
diff --git a/googleapiclient/discovery_cache/documents/gkehub.v1.json b/googleapiclient/discovery_cache/documents/gkehub.v1.json
index 9fcddc0567..dca8a766f1 100644
--- a/googleapiclient/discovery_cache/documents/gkehub.v1.json
+++ b/googleapiclient/discovery_cache/documents/gkehub.v1.json
@@ -2596,7 +2596,7 @@
 }
 }
 },
-"revision": "20260927",
+"revision": "20261008",
 "rootUrl": "https://gkehub.googleapis.com/",
 "schemas": {
 "AppDevExperienceFeatureSpec": {
@@ -3220,7 +3220,7 @@
 "type": "boolean"
 },
 "sourceFormat": {
-"description": "Optional. Specifies whether the Config Sync repo is in `hierarchical` or `unstructured` mode. Defaults to `hierarchical`. See https://docs.cloud.google.com/kubernetes-engine/config-sync/docs/concepts/configs#organize-configs for an explanation.",
+"description": "Optional. Specifies whether the Config Sync repo is in `hierarchy` or `unstructured` mode. Defaults to `hierarchy`. See https://docs.cloud.google.com/kubernetes-engine/config-sync/docs/concepts/configs#organize-configs for an explanation.",
 "type": "string"
 },
 "stopSyncing": {
@@ -3701,11 +3701,11 @@
 "id": "ConfigManagementGitConfig",
 "properties": {
 "gcpServiceAccountEmail": {
-"description": "Optional. The Google Cloud Service Account Email used for auth when secret_type is `gcpserviceaccount`.",
+"description": "Optional. The Google Cloud Service Account Email used for auth when secret_type is `gcpserviceaccount`. Annotates the `RootSync` or `RepoSync` controller's Kubernetes Service Account.",
 "type": "string"
 },
 "httpsProxy": {
-"description": "Optional. URL for the HTTPS proxy to be used when communicating with the Git repo. Only specify when secret_type is `cookiefile`, `token`, or `none`.",
+"description": "Optional. URL for the HTTPS proxy to be used when communicating with the Git repo. Defines an HTTPS_PROXY environment variable and only accepts `https` or unadorned URLs. For example, `https://proxy.internal.business.co:443` or `proxy.internal.business.co:443`. If using an unadorned URL, make sure the communication between your proxy server and Git host is secure. Rejects `http://` URLs. Only specify when secret_type is `cookiefile`, `token`, or `none`.",
 "type": "string"
 },
 "policyDir": {
@@ -3725,7 +3725,7 @@
 "type": "string"
 },
 "syncRev": {
-"description": "Optional. Git revision (tag or hash) to check out. Default HEAD.",
+"description": "Optional. Git revision (tag or hash) or branch to sync from. Default `HEAD`. If not `HEAD`, takes precedence over `sync_branch` field. When using a hash, must be a full hash, and not an abbreviated form.",
 "type": "string"
 },
 "syncWaitSecs": {
@@ -3949,7 +3949,7 @@
 "id": "ConfigManagementOciConfig",
 "properties": {
 "gcpServiceAccountEmail": {
-"description": "Optional. The Google Cloud Service Account Email used for auth when secret_type is `gcpserviceaccount`.",
+"description": "Optional. The Google Cloud Service Account Email used for auth when secret_type is `gcpserviceaccount`. Annotates the `RootSync` or `RepoSync` controller's Kubernetes Service Account.",
 "type": "string"
 },
 "policyDir": {
diff --git a/googleapiclient/discovery_cache/documents/gkehub.v1alpha.json b/googleapiclient/discovery_cache/documents/gkehub.v1alpha.json
index 4ea70a03f5..f27ffa6b09 100644
--- a/googleapiclient/discovery_cache/documents/gkehub.v1alpha.json
+++ b/googleapiclient/discovery_cache/documents/gkehub.v1alpha.json
@@ -2740,7 +2740,7 @@
 }
 }
 },
-"revision": "20260927",
+"revision": "20261008",
 "rootUrl": "https://gkehub.googleapis.com/",
 "schemas": {
 "AppDevExperienceFeatureSpec": {
@@ -3542,7 +3542,7 @@
 "type": "boolean"
 },
 "sourceFormat": {
-"description": "Optional. Specifies whether the Config Sync repo is in `hierarchical` or `unstructured` mode. Defaults to `hierarchical`. See https://docs.cloud.google.com/kubernetes-engine/config-sync/docs/concepts/configs#organize-configs for an explanation.",
+"description": "Optional. Specifies whether the Config Sync repo is in `hierarchy` or `unstructured` mode. Defaults to `hierarchy`. See https://docs.cloud.google.com/kubernetes-engine/config-sync/docs/concepts/configs#organize-configs for an explanation.",
 "type": "string"
 },
 "stopSyncing": {
@@ -4023,11 +4023,11 @@
 "id": "ConfigManagementGitConfig",
 "properties": {
 "gcpServiceAccountEmail": {
-"description": "Optional. The Google Cloud Service Account Email used for auth when secret_type is `gcpserviceaccount`.",
+"description": "Optional. The Google Cloud Service Account Email used for auth when secret_type is `gcpserviceaccount`. Annotates the `RootSync` or `RepoSync` controller's Kubernetes Service Account.",
 "type": "string"
 },
 "httpsProxy": {
-"description": "Optional. URL for the HTTPS proxy to be used when communicating with the Git repo. Only specify when secret_type is `cookiefile`, `token`, or `none`.",
+"description": "Optional. URL for the HTTPS proxy to be used when communicating with the Git repo. Defines an HTTPS_PROXY environment variable and only accepts `https` or unadorned URLs. For example, `https://proxy.internal.business.co:443` or `proxy.internal.business.co:443`. If using an unadorned URL, make sure the communication between your proxy server and Git host is secure. Rejects `http://` URLs. Only specify when secret_type is `cookiefile`, `token`, or `none`.",
 "type": "string"
 },
 "policyDir": {
@@ -4047,7 +4047,7 @@
 "type": "string"
 },
 "syncRev": {
-"description": "Optional. Git revision (tag or hash) to check out. Default HEAD.",
+"description": "Optional. Git revision (tag or hash) or branch to sync from. Default `HEAD`. If not `HEAD`, takes precedence over `sync_branch` field. When using a hash, must be a full hash, and not an abbreviated form.",
 "type": "string"
 },
 "syncWaitSecs": {
@@ -4281,7 +4281,7 @@
 "id": "ConfigManagementOciConfig",
 "properties": {
 "gcpServiceAccountEmail": {
-"description": "Optional. The Google Cloud Service Account Email used for auth when secret_type is `gcpserviceaccount`.",
+"description": "Optional. The Google Cloud Service Account Email used for auth when secret_type is `gcpserviceaccount`. Annotates the `RootSync` or `RepoSync` controller's Kubernetes Service Account.",
 "type": "string"
 },
 "policyDir": {
diff --git a/googleapiclient/discovery_cache/documents/gkehub.v1beta.json b/googleapiclient/discovery_cache/documents/gkehub.v1beta.json
index bb56ba805b..1c9acef7c5 100644
--- a/googleapiclient/discovery_cache/documents/gkehub.v1beta.json
+++ b/googleapiclient/discovery_cache/documents/gkehub.v1beta.json
@@ -2596,7 +2596,7 @@
 }
 }
 },
-"revision": "20260927",
+"revision": "20261008",
 "rootUrl": "https://gkehub.googleapis.com/",
 "schemas": {
 "AppDevExperienceFeatureSpec": {
@@ -3271,7 +3271,7 @@
 "type": "boolean"
 },
 "sourceFormat": {
-"description": "Optional. Specifies whether the Config Sync repo is in `hierarchical` or `unstructured` mode. Defaults to `hierarchical`. See https://docs.cloud.google.com/kubernetes-engine/config-sync/docs/concepts/configs#organize-configs for an explanation.",
+"description": "Optional. Specifies whether the Config Sync repo is in `hierarchy` or `unstructured` mode. Defaults to `hierarchy`. See https://docs.cloud.google.com/kubernetes-engine/config-sync/docs/concepts/configs#organize-configs for an explanation.",
 "type": "string"
 },
 "stopSyncing": {
@@ -3752,11 +3752,11 @@
 "id": "ConfigManagementGitConfig",
 "properties": {
 "gcpServiceAccountEmail": {
-"description": "Optional. The Google Cloud Service Account Email used for auth when secret_type is `gcpserviceaccount`.",
+"description": "Optional. The Google Cloud Service Account Email used for auth when secret_type is `gcpserviceaccount`. Annotates the `RootSync` or `RepoSync` controller's Kubernetes Service Account.",
 "type": "string"
 },
 "httpsProxy": {
-"description": "Optional. URL for the HTTPS proxy to be used when communicating with the Git repo. Only specify when secret_type is `cookiefile`, `token`, or `none`.",
+"description": "Optional. URL for the HTTPS proxy to be used when communicating with the Git repo. Defines an HTTPS_PROXY environment variable and only accepts `https` or unadorned URLs. For example, `https://proxy.internal.business.co:443` or `proxy.internal.business.co:443`. If using an unadorned URL, make sure the communication between your proxy server and Git host is secure. Rejects `http://` URLs. Only specify when secret_type is `cookiefile`, `token`, or `none`.",
 "type": "string"
 },
 "policyDir": {
@@ -3776,7 +3776,7 @@
 "type": "string"
 },
 "syncRev": {
-"description": "Optional. Git revision (tag or hash) to check out. Default HEAD.",
+"description": "Optional. Git revision (tag or hash) or branch to sync from. Default `HEAD`. If not `HEAD`, takes precedence over `sync_branch` field. When using a hash, must be a full hash, and not an abbreviated form.",
 "type": "string"
 },
 "syncWaitSecs": {
@@ -4010,7 +4010,7 @@
 "id": "ConfigManagementOciConfig",
 "properties": {
 "gcpServiceAccountEmail": {
-"description": "Optional. The Google Cloud Service Account Email used for auth when secret_type is `gcpserviceaccount`.",
+"description": "Optional. The Google Cloud Service Account Email used for auth when secret_type is `gcpserviceaccount`. Annotates the `RootSync` or `RepoSync` controller's Kubernetes Service Account.",
 "type": "string"
 },
 "policyDir": {
diff --git a/googleapiclient/discovery_cache/documents/gkehub.v2.json b/googleapiclient/discovery_cache/documents/gkehub.v2.json
index 051710b49c..a9adeebe01 100644
--- a/googleapiclient/discovery_cache/documents/gkehub.v2.json
+++ b/googleapiclient/discovery_cache/documents/gkehub.v2.json
@@ -554,7 +554,7 @@
 }
 }
 },
-"revision": "20260719",
+"revision": "20261008",
 "rootUrl": "https://gkehub.googleapis.com/",
 "schemas": {
 "AppDevExperienceState": {
@@ -812,7 +812,7 @@
 "type": "boolean"
 },
 "sourceFormat": {
-"description": "Optional. Specifies whether the Config Sync repo is in `hierarchical` or `unstructured` mode. Defaults to `hierarchical`. See https://docs.cloud.google.com/kubernetes-engine/config-sync/docs/concepts/configs#organize-configs for an explanation.",
+"description": "Optional. Specifies whether the Config Sync repo is in `hierarchy` or `unstructured` mode. Defaults to `hierarchy`. See https://docs.cloud.google.com/kubernetes-engine/config-sync/docs/concepts/configs#organize-configs for an explanation.",
 "type": "string"
 },
 "stopSyncing": {
@@ -1293,11 +1293,11 @@
 "id": "ConfigManagementGitConfig",
 "properties": {
 "gcpServiceAccountEmail": {
-"description": "Optional. The Google Cloud Service Account Email used for auth when secret_type is `gcpserviceaccount`.",
+"description": "Optional. The Google Cloud Service Account Email used for auth when secret_type is `gcpserviceaccount`. Annotates the `RootSync` or `RepoSync` controller's Kubernetes Service Account.",
 "type": "string"
 },
 "httpsProxy": {
-"description": "Optional. URL for the HTTPS proxy to be used when communicating with the Git repo. Only specify when secret_type is `cookiefile`, `token`, or `none`.",
+"description": "Optional. URL for the HTTPS proxy to be used when communicating with the Git repo. Defines an HTTPS_PROXY environment variable and only accepts `https` or unadorned URLs. For example, `https://proxy.internal.business.co:443` or `proxy.internal.business.co:443`. If using an unadorned URL, make sure the communication between your proxy server and Git host is secure. Rejects `http://` URLs. Only specify when secret_type is `cookiefile`, `token`, or `none`.",
 "type": "string"
 },
 "policyDir": {
@@ -1317,7 +1317,7 @@
 "type": "string"
 },
 "syncRev": {
-"description": "Optional. Git revision (tag or hash) to check out. Default HEAD.",
+"description": "Optional. Git revision (tag or hash) or branch to sync from. Default `HEAD`. If not `HEAD`, takes precedence over `sync_branch` field. When using a hash, must be a full hash, and not an abbreviated form.",
 "type": "string"
 },
 "syncWaitSecs": {
@@ -1455,7 +1455,7 @@
 "id": "ConfigManagementOciConfig",
 "properties": {
 "gcpServiceAccountEmail": {
-"description": "Optional. The Google Cloud Service Account Email used for auth when secret_type is `gcpserviceaccount`.",
+"description": "Optional. The Google Cloud Service Account Email used for auth when secret_type is `gcpserviceaccount`. Annotates the `RootSync` or `RepoSync` controller's Kubernetes Service Account.",
 "type": "string"
 },
 "policyDir": {
diff --git a/googleapiclient/discovery_cache/documents/gkehub.v2alpha.json b/googleapiclient/discovery_cache/documents/gkehub.v2alpha.json
index 330f46814e..3fa5a7ed7d 100644
--- a/googleapiclient/discovery_cache/documents/gkehub.v2alpha.json
+++ b/googleapiclient/discovery_cache/documents/gkehub.v2alpha.json
@@ -554,7 +554,7 @@
 }
 }
 },
-"revision": "20260719",
+"revision": "20261008",
 "rootUrl": "https://gkehub.googleapis.com/",
 "schemas": {
 "AppDevExperienceState": {
@@ -812,7 +812,7 @@
 "type": "boolean"
 },
 "sourceFormat": {
-"description": "Optional. Specifies whether the Config Sync repo is in `hierarchical` or `unstructured` mode. Defaults to `hierarchical`. See https://docs.cloud.google.com/kubernetes-engine/config-sync/docs/concepts/configs#organize-configs for an explanation.",
+"description": "Optional. Specifies whether the Config Sync repo is in `hierarchy` or `unstructured` mode. Defaults to `hierarchy`. See https://docs.cloud.google.com/kubernetes-engine/config-sync/docs/concepts/configs#organize-configs for an explanation.",
 "type": "string"
 },
 "stopSyncing": {
@@ -1293,11 +1293,11 @@
 "id": "ConfigManagementGitConfig",
 "properties": {
 "gcpServiceAccountEmail": {
-"description": "Optional. The Google Cloud Service Account Email used for auth when secret_type is `gcpserviceaccount`.",
+"description": "Optional. The Google Cloud Service Account Email used for auth when secret_type is `gcpserviceaccount`. Annotates the `RootSync` or `RepoSync` controller's Kubernetes Service Account.",
 "type": "string"
 },
 "httpsProxy": {
-"description": "Optional. URL for the HTTPS proxy to be used when communicating with the Git repo. Only specify when secret_type is `cookiefile`, `token`, or `none`.",
+"description": "Optional. URL for the HTTPS proxy to be used when communicating with the Git repo. Defines an HTTPS_PROXY environment variable and only accepts `https` or unadorned URLs. For example, `https://proxy.internal.business.co:443` or `proxy.internal.business.co:443`. If using an unadorned URL, make sure the communication between your proxy server and Git host is secure. Rejects `http://` URLs. Only specify when secret_type is `cookiefile`, `token`, or `none`.",
 "type": "string"
 },
 "policyDir": {
@@ -1317,7 +1317,7 @@
 "type": "string"
 },
 "syncRev": {
-"description": "Optional. Git revision (tag or hash) to check out. Default HEAD.",
+"description": "Optional. Git revision (tag or hash) or branch to sync from. Default `HEAD`. If not `HEAD`, takes precedence over `sync_branch` field. When using a hash, must be a full hash, and not an abbreviated form.",
 "type": "string"
 },
 "syncWaitSecs": {
@@ -1455,7 +1455,7 @@
 "id": "ConfigManagementOciConfig",
 "properties": {
 "gcpServiceAccountEmail": {
-"description": "Optional. The Google Cloud Service Account Email used for auth when secret_type is `gcpserviceaccount`.",
+"description": "Optional. The Google Cloud Service Account Email used for auth when secret_type is `gcpserviceaccount`. Annotates the `RootSync` or `RepoSync` controller's Kubernetes Service Account.",
 "type": "string"
 },
 "policyDir": {
diff --git a/googleapiclient/discovery_cache/documents/gkehub.v2beta.json b/googleapiclient/discovery_cache/documents/gkehub.v2beta.json
index b6a37ad8b8..f550a31758 100644
--- a/googleapiclient/discovery_cache/documents/gkehub.v2beta.json
+++ b/googleapiclient/discovery_cache/documents/gkehub.v2beta.json
@@ -554,7 +554,7 @@
 }
 }
 },
-"revision": "20260719",
+"revision": "20261008",
 "rootUrl": "https://gkehub.googleapis.com/",
 "schemas": {
 "AppDevExperienceState": {
@@ -812,7 +812,7 @@
 "type": "boolean"
 },
 "sourceFormat": {
-"description": "Optional. Specifies whether the Config Sync repo is in `hierarchical` or `unstructured` mode. Defaults to `hierarchical`. See https://docs.cloud.google.com/kubernetes-engine/config-sync/docs/concepts/configs#organize-configs for an explanation.",
+"description": "Optional. Specifies whether the Config Sync repo is in `hierarchy` or `unstructured` mode. Defaults to `hierarchy`. See https://docs.cloud.google.com/kubernetes-engine/config-sync/docs/concepts/configs#organize-configs for an explanation.",
 "type": "string"
 },
 "stopSyncing": {
@@ -1293,11 +1293,11 @@
 "id": "ConfigManagementGitConfig",
 "properties": {
 "gcpServiceAccountEmail": {
-"description": "Optional. The Google Cloud Service Account Email used for auth when secret_type is `gcpserviceaccount`.",
+"description": "Optional. The Google Cloud Service Account Email used for auth when secret_type is `gcpserviceaccount`. Annotates the `RootSync` or `RepoSync` controller's Kubernetes Service Account.",
 "type": "string"
 },
 "httpsProxy": {
-"description": "Optional. URL for the HTTPS proxy to be used when communicating with the Git repo. Only specify when secret_type is `cookiefile`, `token`, or `none`.",
+"description": "Optional. URL for the HTTPS proxy to be used when communicating with the Git repo. Defines an HTTPS_PROXY environment variable and only accepts `https` or unadorned URLs. For example, `https://proxy.internal.business.co:443` or `proxy.internal.business.co:443`. If using an unadorned URL, make sure the communication between your proxy server and Git host is secure. Rejects `http://` URLs. Only specify when secret_type is `cookiefile`, `token`, or `none`.",
 "type": "string"
 },
 "policyDir": {
@@ -1317,7 +1317,7 @@
 "type": "string"
 },
 "syncRev": {
-"description": "Optional. Git revision (tag or hash) to check out. Default HEAD.",
+"description": "Optional. Git revision (tag or hash) or branch to sync from. Default `HEAD`. If not `HEAD`, takes precedence over `sync_branch` field. When using a hash, must be a full hash, and not an abbreviated form.",
 "type": "string"
 },
 "syncWaitSecs": {
@@ -1455,7 +1455,7 @@
 "id": "ConfigManagementOciConfig",
 "properties": {
 "gcpServiceAccountEmail": {
-"description": "Optional. The Google Cloud Service Account Email used for auth when secret_type is `gcpserviceaccount`.",
+"description": "Optional. The Google Cloud Service Account Email used for auth when secret_type is `gcpserviceaccount`. Annotates the `RootSync` or `RepoSync` controller's Kubernetes Service Account.",
 "type": "string"
 },
 "policyDir": {
diff --git a/googleapiclient/discovery_cache/documents/integrations.v1.json b/googleapiclient/discovery_cache/documents/integrations.v1.json
index 3e870d3b8d..11b75c31e6 100644
--- a/googleapiclient/discovery_cache/documents/integrations.v1.json
+++ b/googleapiclient/discovery_cache/documents/integrations.v1.json
@@ -4668,7 +4668,7 @@
 }
 }
 },
-"revision": "20261004",
+"revision": "20261008",
 "rootUrl": "https://integrations.googleapis.com/",
 "schemas": {
 "CrmlogErrorCode": {
@@ -15214,7 +15214,7 @@ false
 "type": "string"
 },
 "workflowId": {
-"description": "Optional. Pins the enqueue to this exact version rather than the ACTIVE one on the trigger, so an unpublished draft can be tested. Requires client_id, and the version is validated before it is enqueued; see integrationplatform/api/executionsservice/README.md.",
+"description": "Optional. Pins the enqueue to this exact version. Requires client_id, and only an ACTIVE version is accepted: the drain re-resolves by trigger id, so nothing else could run. Unset by every caller today; draft support is b/570602030. See integrationplatform/api/executionsservice/README.md.",
 "type": "string"
 },
 "workflowName": {
diff --git a/googleapiclient/discovery_cache/documents/integrations.v2.json b/googleapiclient/discovery_cache/documents/integrations.v2.json
index 0a5eacfb56..934a094861 100644
--- a/googleapiclient/discovery_cache/documents/integrations.v2.json
+++ b/googleapiclient/discovery_cache/documents/integrations.v2.json
@@ -459,7 +459,7 @@
 }
 }
 },
-"revision": "20261004",
+"revision": "20261008",
 "rootUrl": "https://integrations.googleapis.com/",
 "schemas": {
 "EnterpriseCrmEventbusAuthconfigAuthConfigTaskParam": {
@@ -3572,7 +3572,7 @@
 "type": "string"
 },
 "workflowId": {
-"description": "Optional. Pins the enqueue to this exact version rather than the ACTIVE one on the trigger, so an unpublished draft can be tested. Requires client_id, and the version is validated before it is enqueued; see integrationplatform/api/executionsservice/README.md.",
+"description": "Optional. Pins the enqueue to this exact version. Requires client_id, and only an ACTIVE version is accepted: the drain re-resolves by trigger id, so nothing else could run. Unset by every caller today; draft support is b/570602030. See integrationplatform/api/executionsservice/README.md.",
 "type": "string"
 },
 "workflowName": {
diff --git a/googleapiclient/discovery_cache/documents/merchantapi.products_v1.json b/googleapiclient/discovery_cache/documents/merchantapi.products_v1.json
index 08c4beea89..6232047db8 100644
--- a/googleapiclient/discovery_cache/documents/merchantapi.products_v1.json
+++ b/googleapiclient/discovery_cache/documents/merchantapi.products_v1.json
@@ -281,7 +281,7 @@
 }
 }
 },
-"revision": "20261002",
+"revision": "20261012",
 "rootUrl": "https://merchantapi.googleapis.com/",
 "schemas": {
 "AutomatedDiscounts": {
@@ -2569,7 +2569,7 @@ false
 },
 "warranty": {
 "$ref": "Warranty",
-"description": "The [warranty](https://support.google.com/merchants/answer/15957626) of the product."
+"description": "The [`warranty`](https://support.google.com/merchants/answer/18562485) of the product."
 },
 "year": {
 "description": "The [Year](https://support.google.com/google-ads/answer/14152816) of the vehicle model.",
@@ -3552,7 +3552,7 @@ false
 "type": "object"
 },
 "Warranty": {
-"description": "The warranty of the vehicle.",
+"description": "The warranty of the product.",
 "id": "Warranty",
 "properties": {
 "duration": {
diff --git a/googleapiclient/discovery_cache/documents/networkconnectivity.v1.json b/googleapiclient/discovery_cache/documents/networkconnectivity.v1.json
index ebccce968b..b853b8a1be 100644
--- a/googleapiclient/discovery_cache/documents/networkconnectivity.v1.json
+++ b/googleapiclient/discovery_cache/documents/networkconnectivity.v1.json
@@ -4046,7 +4046,7 @@
 }
 }
 },
-"revision": "20260929",
+"revision": "20261008",
 "rootUrl": "https://networkconnectivity.googleapis.com/",
 "schemas": {
 "AcceptHubSpokeRequest": {
@@ -8338,7 +8338,8 @@
 "PENDING_KEY",
 "ACTIVE",
 "DELETING",
-"DEPROVISIONED"
+"DEPROVISIONED",
+"SUSPENDED"
 ],
 "enumDescriptions": [
 "Unspecified state.",
@@ -8347,7 +8348,8 @@
 "The Transport was created in GCP. Depending on the profile\u2019s key provisioning flow, this is either waiting for an activation key to be input (the key will be validated that it uses remote resources that match the Transport), or for the generated key to be input to the provider for finalizing. The configured bandwidth is not yet guaranteed.",
 "The Transport is configured and the underlying connectivity is considered operational.",
 "The Transport is being deleted from GCP. The underlying connectivity is no longer operational.",
-"The Transport was deleted on the remote provider's end and is no longer operational. GCP has insufficient information to move the resource back to PENDING_KEY state."
+"The Transport was deleted on the remote provider's end and is no longer operational. GCP has insufficient information to move the resource back to PENDING_KEY state.",
+"The Transport is suspended due to an Abuse suspension or Wipeout Hide event. Underlying connectivity is administratively disabled."
 ],
 "readOnly": true,
 "type": "string"
diff --git a/googleapiclient/discovery_cache/documents/networkmanagement.v1.json b/googleapiclient/discovery_cache/documents/networkmanagement.v1.json
index 78d2bfe991..eb196a7dc5 100644
--- a/googleapiclient/discovery_cache/documents/networkmanagement.v1.json
+++ b/googleapiclient/discovery_cache/documents/networkmanagement.v1.json
@@ -1797,7 +1797,7 @@
 }
 }
 },
-"revision": "20260930",
+"revision": "20261007",
 "rootUrl": "https://networkmanagement.googleapis.com/",
 "schemas": {
 "AbortInfo": {
@@ -2152,11 +2152,6 @@ false
 "uri": {
 "description": "A [Cloud Run](https://cloud.google.com/run) [revision](https://cloud.google.com/run/docs/reference/rest/v1/namespaces.revisions/get) URI. The format is: projects/{project}/locations/{location}/revisions/{revision}",
 "type": "string"
-},
-"workerPoolUri": {
-"description": "Output only. The URI of the worker pool that the revision belongs to. The format is: projects/{project}/locations/{location}/workerPools/{workerPool}. Mutually exclusive with service_uri.",
-"readOnly": true,
-"type": "string"
 }
 },
 "type": "object"
diff --git a/googleapiclient/discovery_cache/documents/networkmanagement.v1beta1.json b/googleapiclient/discovery_cache/documents/networkmanagement.v1beta1.json
index 0de8da38ec..5985010336 100644
--- a/googleapiclient/discovery_cache/documents/networkmanagement.v1beta1.json
+++ b/googleapiclient/discovery_cache/documents/networkmanagement.v1beta1.json
@@ -1237,7 +1237,7 @@
 }
 }
 },
-"revision": "20260930",
+"revision": "20261007",
 "rootUrl": "https://networkmanagement.googleapis.com/",
 "schemas": {
 "AbortInfo": {
@@ -1592,11 +1592,6 @@ false
 "uri": {
 "description": "A [Cloud Run](https://cloud.google.com/run) [revision](https://cloud.google.com/run/docs/reference/rest/v1/namespaces.revisions/get) URI. The format is: projects/{project}/locations/{location}/revisions/{revision}",
 "type": "string"
-},
-"workerPoolUri": {
-"description": "Output only. The URI of the worker pool that the revision belongs to. The format is: projects/{project}/locations/{location}/workerPools/{workerPool}. Mutually exclusive with service_uri.",
-"readOnly": true,
-"type": "string"
 }
 },
 "type": "object"
diff --git a/googleapiclient/discovery_cache/documents/policytroubleshooter.v3beta.json b/googleapiclient/discovery_cache/documents/policytroubleshooter.v3beta.json
index b9479cfa5c..ffe128c92e 100644
--- a/googleapiclient/discovery_cache/documents/policytroubleshooter.v3beta.json
+++ b/googleapiclient/discovery_cache/documents/policytroubleshooter.v3beta.json
@@ -146,7 +146,7 @@
 }
 }
 },
-"revision": "20260628",
+"revision": "20261018",
 "rootUrl": "https://policytroubleshooter.googleapis.com/",
 "schemas": {
 "GoogleCloudPolicytroubleshooterIamV3betaAccessContext": {
@@ -1610,7 +1610,7 @@
 },
 "condition": {
 "$ref": "GoogleTypeExpr",
-"description": "Optional. The condition to apply to the policy binding. When set, the `expression` field in the `Expr` must include from 1 to 10 subexpressions, joined by the \"||\"(Logical OR), \"&&\"(Logical AND) or \"!\"(Logical NOT) operators and cannot contain more than 250 characters. The condition is currently only supported when bound to policies of kind principal access boundary. When the bound policy is a principal access boundary policy, the only supported attributes in any subexpression are `principal.type` and `principal.subject`. An example expression is: \"principal.type == 'iam.googleapis.com/ServiceAccount'\" or \"principal.subject == 'bob@example.com'\". Allowed operations for `principal.subject`: - `principal.subject == ` - `principal.subject != ` - `principal.subject in []` - `principal.subject.startsWith()` - `principal.subject.endsWith()` Allowed operations for `principal.type`: - `principal.type == ` - `principal.type != ` - `principal.type in []` Supported principal types are workspace, workforce pool, workload pool, service account, and agent identity. Allowed string must be one of: - `iam.googleapis.com/WorkspaceIdentity` - `iam.googleapis.com/WorkforcePoolIdentity` - `iam.googleapis.com/WorkloadPoolIdentity` - `iam.googleapis.com/ServiceAccount` - `iam.googleapis.com/AgentPoolIdentity` (available in Preview)"
+"description": "Optional. The condition to apply to the policy binding. When set, the `expression` field in the `Expr` must include from 1 to 10 subexpressions, joined by the \"||\"(Logical OR), \"&&\"(Logical AND) or \"!\"(Logical NOT) operators and cannot contain more than 250 characters. The condition is currently only supported when bound to policies of kind principal access boundary. When the bound policy is a principal access boundary policy, the only supported attributes in any subexpression are `principal.type` and `principal.subject`. An example expression is: \"principal.type == 'iam.googleapis.com/ServiceAccount'\" or \"principal.subject == 'bob@example.com'\". Allowed operations for `principal.subject`: - `principal.subject == ` - `principal.subject != ` - `principal.subject in []` - `principal.subject.startsWith()` - `principal.subject.endsWith()` Allowed operations for `principal.type`: - `principal.type == ` - `principal.type != ` - `principal.type in []` Supported principal types are workspace, workforce pool, workload pool, service account, and agent identity. Allowed string must be one of: - `iam.googleapis.com/WorkspaceIdentity` - `iam.googleapis.com/WorkforcePoolIdentity` - `iam.googleapis.com/WorkloadPoolIdentity` - `iam.googleapis.com/ServiceAccount` - `iam.googleapis.com/AgentPoolIdentity`"
 },
 "createTime": {
 "description": "Output only. The time when the policy binding was created.",
diff --git a/googleapiclient/discovery_cache/documents/pubsub.v1.json b/googleapiclient/discovery_cache/documents/pubsub.v1.json
index 6e80f6d3a9..79ca529486 100644
--- a/googleapiclient/discovery_cache/documents/pubsub.v1.json
+++ b/googleapiclient/discovery_cache/documents/pubsub.v1.json
@@ -1798,7 +1798,7 @@
 }
 }
 },
-"revision": "20260924",
+"revision": "20261006",
 "rootUrl": "https://pubsub.googleapis.com/",
 "schemas": {
 "AIInference": {
@@ -2458,7 +2458,7 @@
 "type": "string"
 },
 "keyFields": {
-"description": "Optional. The key fields to construct from the row key. The fields must be present in the message as a top-level field, i.e. JSON path expressions will not traverse into nested objects.",
+"description": "Required. The key fields to construct from the row key. The fields must be present in the message as a top-level field, i.e. JSON path expressions will not traverse into nested objects.",
 "items": {
 "type": "string"
 },
diff --git a/googleapiclient/discovery_cache/documents/readerrevenuesubscriptionlinking.v1.json b/googleapiclient/discovery_cache/documents/readerrevenuesubscriptionlinking.v1.json
index 24d41a2c7d..1d58d11bfc 100644
--- a/googleapiclient/discovery_cache/documents/readerrevenuesubscriptionlinking.v1.json
+++ b/googleapiclient/discovery_cache/documents/readerrevenuesubscriptionlinking.v1.json
@@ -98,51 +98,6 @@
 "resources": {
 "publications": {
 "resources": {
-"-": {
-"resources": {
-"readers": {
-"resources": {
-"entitlements": {
-"methods": {
-"list": {
-"description": "Lists reader entitlements across parent publications via wildcard. - Returns PERMISSION_DENIED if the caller does not have access. - Returns NOT_FOUND if the reader does not exist.",
-"flatPath": "v1/publications/-/readers/{readersId}/entitlements",
-"httpMethod": "GET",
-"id": "readerrevenuesubscriptionlinking.publications.-.readers.entitlements.list",
-"parameterOrder": [
-"parent"
-],
-"parameters": {
-"pageSize": {
-"description": "Optional. The maximum number of entitlements to return. The service may return fewer than this value. If unspecified, at most 50 entitlements 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 `ListReaderEntitlements` call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to `ListReaderEntitlements` must match the call that provided the page token.",
-"location": "query",
-"type": "string"
-},
-"parent": {
-"description": "Required. The parent reader scope. Format: \"publications/-/readers/{reader_id}\"",
-"location": "path",
-"pattern": "^publications/-/readers/[^/]+$",
-"required": true,
-"type": "string"
-}
-},
-"path": "v1/{+parent}/entitlements",
-"response": {
-"$ref": "ListReaderEntitlementsResponse"
-}
-}
-}
-}
-}
-}
-}
-},
 "readers": {
 "methods": {
 "delete": {
@@ -252,7 +207,7 @@
 }
 }
 },
-"revision": "20260915",
+"revision": "20261011",
 "rootUrl": "https://readerrevenuesubscriptionlinking.googleapis.com/",
 "schemas": {
 "DeleteReaderResponse": {
@@ -285,24 +240,6 @@
 },
 "type": "object"
 },
-"ListReaderEntitlementsResponse": {
-"description": "Response containing the aggregated collection of matching ReaderEntitlements objects.",
-"id": "ListReaderEntitlementsResponse",
-"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"
-},
-"readerEntitlements": {
-"description": "The collection of ReaderEntitlements found across the scoped child publications. Every element's `name` field will contain the canonical sub-publication path, never the wildcard dash.",
-"items": {
-"$ref": "ReaderEntitlements"
-},
-"type": "array"
-}
-},
-"type": "object"
-},
 "Reader": {
 "description": "A reader of a publication.",
 "id": "Reader",
diff --git a/googleapiclient/discovery_cache/documents/retail.v2.json b/googleapiclient/discovery_cache/documents/retail.v2.json
index 7ee88faec3..637060aa5c 100644
--- a/googleapiclient/discovery_cache/documents/retail.v2.json
+++ b/googleapiclient/discovery_cache/documents/retail.v2.json
@@ -2353,7 +2353,7 @@
 }
 }
 },
-"revision": "20260813",
+"revision": "20261011",
 "rootUrl": "https://retail.googleapis.com/",
 "schemas": {
 "GoogleApiHttpBody": {
@@ -4865,7 +4865,7 @@
 "type": "string"
 },
 "expireTime": {
-"description": "Note that this field is applied in the following ways: * If the Product is already expired when it is uploaded, this product is not indexed for search. * If the Product is not expired when it is uploaded, only the Type.PRIMARY's and Type.COLLECTION's expireTime is respected, and Type.VARIANT's expireTime is not used. In general, we suggest the users to delete the stale products explicitly, instead of using this field to determine staleness. expire_time must be later than available_time and publish_time, otherwise an INVALID_ARGUMENT error is thrown. Corresponding properties: Google Merchant Center property [expiration_date](https://support.google.com/merchants/answer/6324499).",
+"description": "The timestamp when this product becomes unavailable for SearchService.Search. If it is set, the Product is not available for SearchService.Search after expire_time. However, the product can still be retrieved by ProductService.GetProduct and ProductService.ListProducts. Note that this field is applied in the following ways: * If the Product is already expired when it is uploaded, this product is not indexed for search. * If the Product is not expired when it is uploaded, only the Type.PRIMARY's and Type.COLLECTION's expireTime is respected, and Type.VARIANT's expireTime is not used. In general, we suggest the users to delete the stale products explicitly, instead of using this field to determine staleness. expire_time must be later than available_time and publish_time, otherwise an INVALID_ARGUMENT error is thrown. Corresponding properties: Google Merchant Center property [expiration_date](https://support.google.com/merchants/answer/6324499).",
 "format": "google-datetime",
 "type": "string"
 },
diff --git a/googleapiclient/discovery_cache/documents/retail.v2alpha.json b/googleapiclient/discovery_cache/documents/retail.v2alpha.json
index 4410e98ab0..c0a83cabed 100644
--- a/googleapiclient/discovery_cache/documents/retail.v2alpha.json
+++ b/googleapiclient/discovery_cache/documents/retail.v2alpha.json
@@ -2874,7 +2874,7 @@
 }
 }
 },
-"revision": "20260920",
+"revision": "20261011",
 "rootUrl": "https://retail.googleapis.com/",
 "schemas": {
 "GoogleApiHttpBody": {
@@ -6745,7 +6745,7 @@
 "type": "string"
 },
 "expireTime": {
-"description": "Note that this field is applied in the following ways: * If the Product is already expired when it is uploaded, this product is not indexed for search. * If the Product is not expired when it is uploaded, only the Type.PRIMARY's and Type.COLLECTION's expireTime is respected, and Type.VARIANT's expireTime is not used. In general, we suggest the users to delete the stale products explicitly, instead of using this field to determine staleness. expire_time must be later than available_time and publish_time, otherwise an INVALID_ARGUMENT error is thrown. Corresponding properties: Google Merchant Center property [expiration_date](https://support.google.com/merchants/answer/6324499).",
+"description": "The timestamp when this product becomes unavailable for SearchService.Search. If it is set, the Product is not available for SearchService.Search after expire_time. However, the product can still be retrieved by ProductService.GetProduct and ProductService.ListProducts. Note that this field is applied in the following ways: * If the Product is already expired when it is uploaded, this product is not indexed for search. * If the Product is not expired when it is uploaded, only the Type.PRIMARY's and Type.COLLECTION's expireTime is respected, and Type.VARIANT's expireTime is not used. In general, we suggest the users to delete the stale products explicitly, instead of using this field to determine staleness. expire_time must be later than available_time and publish_time, otherwise an INVALID_ARGUMENT error is thrown. Corresponding properties: Google Merchant Center property [expiration_date](https://support.google.com/merchants/answer/6324499).",
 "format": "google-datetime",
 "type": "string"
 },
diff --git a/googleapiclient/discovery_cache/documents/retail.v2beta.json b/googleapiclient/discovery_cache/documents/retail.v2beta.json
index d43d7286f7..c8eeaadc3d 100644
--- a/googleapiclient/discovery_cache/documents/retail.v2beta.json
+++ b/googleapiclient/discovery_cache/documents/retail.v2beta.json
@@ -2498,7 +2498,7 @@
 }
 }
 },
-"revision": "20260813",
+"revision": "20261011",
 "rootUrl": "https://retail.googleapis.com/",
 "schemas": {
 "GoogleApiHttpBody": {
@@ -6675,7 +6675,7 @@
 "type": "string"
 },
 "expireTime": {
-"description": "Note that this field is applied in the following ways: * If the Product is already expired when it is uploaded, this product is not indexed for search. * If the Product is not expired when it is uploaded, only the Type.PRIMARY's and Type.COLLECTION's expireTime is respected, and Type.VARIANT's expireTime is not used. In general, we suggest the users to delete the stale products explicitly, instead of using this field to determine staleness. expire_time must be later than available_time and publish_time, otherwise an INVALID_ARGUMENT error is thrown. Corresponding properties: Google Merchant Center property [expiration_date](https://support.google.com/merchants/answer/6324499).",
+"description": "The timestamp when this product becomes unavailable for SearchService.Search. If it is set, the Product is not available for SearchService.Search after expire_time. However, the product can still be retrieved by ProductService.GetProduct and ProductService.ListProducts. Note that this field is applied in the following ways: * If the Product is already expired when it is uploaded, this product is not indexed for search. * If the Product is not expired when it is uploaded, only the Type.PRIMARY's and Type.COLLECTION's expireTime is respected, and Type.VARIANT's expireTime is not used. In general, we suggest the users to delete the stale products explicitly, instead of using this field to determine staleness. expire_time must be later than available_time and publish_time, otherwise an INVALID_ARGUMENT error is thrown. Corresponding properties: Google Merchant Center property [expiration_date](https://support.google.com/merchants/answer/6324499).",
 "format": "google-datetime",
 "type": "string"
 },
diff --git a/googleapiclient/discovery_cache/documents/youtube.v3.json b/googleapiclient/discovery_cache/documents/youtube.v3.json
index 19f8ac1304..f8cfc62379 100644
--- a/googleapiclient/discovery_cache/documents/youtube.v3.json
+++ b/googleapiclient/discovery_cache/documents/youtube.v3.json
@@ -1686,7 +1686,7 @@
 "liveChatMessages": {
 "methods": {
 "delete": {
-"description": "Deletes a chat message.",
+"description": "Deletes a chat message. A call to this method has a quota cost of 20 units.",
 "flatPath": "youtube/v3/liveChat/messages",
 "httpMethod": "DELETE",
 "id": "youtube.liveChatMessages.delete",
@@ -1707,7 +1707,7 @@
 ]
 },
 "insert": {
-"description": "Inserts a new resource into this collection.",
+"description": "Inserts a new resource into this collection. A call to this method has a quota cost of 20 units.",
 "flatPath": "youtube/v3/liveChat/messages",
 "httpMethod": "POST",
 "id": "youtube.liveChatMessages.insert",
@@ -1716,7 +1716,7 @@
 ],
 "parameters": {
 "part": {
-"description": "The *part* parameter serves two purposes. It identifies the properties that the write operation will set as well as the properties that the API response will include. Set the parameter value to snippet.",
+"description": "The `part` parameter serves two purposes. It identifies the properties that the write operation sets as well as the properties that the API response includes. Set the parameter value to `snippet`.",
 "location": "query",
 "repeated": true,
 "required": true,
@@ -1736,7 +1736,7 @@
 ]
 },
 "list": {
-"description": "Retrieves a list of resources, possibly filtered.",
+"description": "Retrieves a list of resources, possibly filtered. A call to this method has a quota cost of 5 units.",
 "flatPath": "youtube/v3/liveChat/messages",
 "httpMethod": "GET",
 "id": "youtube.liveChatMessages.list",
@@ -1751,14 +1751,14 @@
 "type": "string"
 },
 "liveChatId": {
-"description": "The id of the live chat for which comments should be returned.",
+"description": "The ID of the live chat for which messages should be returned.",
 "location": "query",
 "required": true,
 "type": "string"
 },
 "maxResults": {
 "default": "500",
-"description": "The *maxResults* parameter specifies the maximum number of items that should be returned in the result set. Not used in the streaming RPC.",
+"description": "The `maxResults` parameter specifies the maximum number of items that should be returned in the result set. Not used in the streaming RPC.",
 "format": "uint32",
 "location": "query",
 "maximum": "2000",
@@ -1766,12 +1766,12 @@
 "type": "integer"
 },
 "pageToken": {
-"description": "The *pageToken* parameter identifies a specific page in the result set that should be returned. In an API response, the nextPageToken property identify other pages that could be retrieved.",
+"description": "The `pageToken` parameter identifies a specific page in the result set that should be returned. In an API response, the `nextPageToken` property identifies other pages that could be retrieved.",
 "location": "query",
 "type": "string"
 },
 "part": {
-"description": "The *part* parameter specifies the liveChatComment resource parts that the API response will include. Supported values are id, snippet, and authorDetails.",
+"description": "The `part` parameter specifies the `liveChatMessage` resource parts that the API response includes. Supported values are `id`, `snippet`, and `authorDetails`.",
 "location": "query",
 "repeated": true,
 "required": true,
@@ -1797,14 +1797,14 @@
 ]
 },
 "transition": {
-"description": "Transition a durable chat event.",
+"description": "Transitions a durable chat event. A call to this method has a quota cost of 20 units.",
 "flatPath": "youtube/v3/liveChat/messages/transition",
 "httpMethod": "POST",
 "id": "youtube.liveChatMessages.transition",
 "parameterOrder": [],
 "parameters": {
 "id": {
-"description": "The ID that uniquely identify the chat message event to transition.",
+"description": "The ID that uniquely identifies the chat message event to transition.",
 "location": "query",
 "type": "string"
 },
@@ -4124,7 +4124,7 @@
 "messages": {
 "methods": {
 "stream": {
-"description": "Allows a user to load live chat through a server-streamed RPC.",
+"description": "Allows a user to load live chat through a server-streamed RPC. A call to this method has a quota cost of 5 units.",
 "flatPath": "youtube/v3/liveChat/messages/stream",
 "httpMethod": "GET",
 "id": "youtube.youtube.v3.liveChat.messages.stream",
@@ -4136,13 +4136,13 @@
 "type": "string"
 },
 "liveChatId": {
-"description": "The id of the live chat for which comments should be returned.",
+"description": "The ID of the live chat for which messages should be returned.",
 "location": "query",
 "type": "string"
 },
 "maxResults": {
 "default": "500",
-"description": "The *maxResults* parameter specifies the maximum number of items that should be returned in the result set. Not used in the streaming RPC.",
+"description": "The `maxResults` parameter specifies the maximum number of items that should be returned in the result set. Not used in the streaming RPC.",
 "format": "uint32",
 "location": "query",
 "maximum": "2000",
@@ -4150,12 +4150,12 @@
 "type": "integer"
 },
 "pageToken": {
-"description": "The *pageToken* parameter identifies a specific page in the result set that should be returned. In an API response, the nextPageToken property identify other pages that could be retrieved.",
+"description": "The `pageToken` parameter identifies a specific page in the result set that should be returned. In an API response, the `nextPageToken` property identifies other pages that could be retrieved.",
 "location": "query",
 "type": "string"
 },
 "part": {
-"description": "The *part* parameter specifies the liveChatComment resource parts that the API response will include. Supported values are id, snippet, and authorDetails.",
+"description": "The `part` parameter specifies the `liveChatMessage` resource parts that the API response includes. Supported values are `id`, `snippet`, and `authorDetails`.",
 "location": "query",
 "repeated": true,
 "type": "string"
@@ -4188,7 +4188,7 @@
 }
 }
 },
-"revision": "20261001",
+"revision": "20261012",
 "rootUrl": "https://youtube.googleapis.com/",
 "schemas": {
 "AbuseReport": {
@@ -8938,7 +8938,7 @@ true
 "type": "object"
 },
 "LiveChatGiftDetails": {
-"description": "Details about the gift event, this is only set if the type is 'giftEvent'.",
+"description": "Details about the gift event, this is only set if the type is `giftEvent`.",
 "id": "LiveChatGiftDetails",
 "properties": {
 "altText": {
@@ -8983,7 +8983,7 @@ true
 "id": "LiveChatGiftMembershipReceivedDetails",
 "properties": {
 "associatedMembershipGiftingMessageId": {
-"description": "The ID of the membership gifting message that is related to this gift membership. This ID will always refer to a message whose type is 'membershipGiftingEvent'.",
+"description": "The ID of the membership gifting message that is related to this gift membership. This ID will always refer to a message whose type is `membershipGiftingEvent`.",
 "type": "string"
 },
 "gifterChannelId": {
@@ -9131,7 +9131,7 @@ true
 },
 "kind": {
 "default": "youtube#liveChatMessageListResponse",
-"description": "Identifies what kind of resource this is. Value: the fixed string \"youtube#liveChatMessageListResponse\".",
+"description": "Identifies what kind of resource this is. Value: the fixed string `\"youtube#liveChatMessageListResponse\"`.",
 "type": "string"
 },
 "nextPageToken": {
@@ -9157,7 +9157,7 @@ true
 },
 "visitorId": {
 "deprecated": true,
-"description": "The visitorId identifies the visitor.",
+"description": "Identifies the visitor.",
 "type": "string"
 }
 },
@@ -9188,15 +9188,15 @@ true
 "fanFundingEventDetails": {
 "$ref": "LiveChatFanFundingEventDetails",
 "deprecated": true,
-"description": "Details about the funding event, this is only set if the type is 'fanFundingEvent'."
+"description": "Details about the funding event, this is only set if the type is `fanFundingEvent`."
 },
 "giftDetails": {
 "$ref": "LiveChatGiftDetails",
-"description": "Details about the gift event, this is only set if the type is 'giftEvent'."
+"description": "Details about the gift event, this is only set if the type is `giftEvent`."
 },
 "giftMembershipReceivedDetails": {
 "$ref": "LiveChatGiftMembershipReceivedDetails",
-"description": "Details about the Gift Membership Received event, this is only set if the type is 'giftMembershipReceivedEvent'."
+"description": "Details about the Gift Membership Received event, this is only set if the type is `giftMembershipReceivedEvent`."
 },
 "hasDisplayContent": {
 "description": "Whether the message has display content that should be displayed to users.",
@@ -9207,11 +9207,11 @@ true
 },
 "memberMilestoneChatDetails": {
 "$ref": "LiveChatMemberMilestoneChatDetails",
-"description": "Details about the Member Milestone Chat event, this is only set if the type is 'memberMilestoneChatEvent'."
+"description": "Details about the Member Milestone Chat event, this is only set if the type is `memberMilestoneChatEvent`."
 },
 "membershipGiftingDetails": {
 "$ref": "LiveChatMembershipGiftingDetails",
-"description": "Details about the Membership Gifting event, this is only set if the type is 'membershipGiftingEvent'."
+"description": "Details about the Membership Gifting event, this is only set if the type is `membershipGiftingEvent`."
 },
 "messageDeletedDetails": {
 "$ref": "LiveChatMessageDeletedDetails",
@@ -9223,11 +9223,11 @@ true
 },
 "newSponsorDetails": {
 "$ref": "LiveChatNewSponsorDetails",
-"description": "Details about the New Member Announcement event, this is only set if the type is 'newSponsorEvent'. Please note that \"member\" is the new term for \"sponsor\"."
+"description": "Details about the New Member Announcement event, this is only set if the type is `newSponsorEvent`. The term \"member\" replaces \"sponsor\"."
 },
 "pollDetails": {
 "$ref": "LiveChatPollDetails",
-"description": "Details about the poll event, this is only set if the type is 'pollEvent'."
+"description": "Details about the poll event, this is only set if the type is `pollEvent`."
 },
 "publishedAt": {
 "description": "The date and time when the message was orignally published.",
@@ -9236,15 +9236,15 @@ true
 },
 "superChatDetails": {
 "$ref": "LiveChatSuperChatDetails",
-"description": "Details about the Super Chat event, this is only set if the type is 'superChatEvent'."
+"description": "Details about the Super Chat event, this is only set if the type is `superChatEvent`."
 },
 "superStickerDetails": {
 "$ref": "LiveChatSuperStickerDetails",
-"description": "Details about the Super Sticker event, this is only set if the type is 'superStickerEvent'."
+"description": "Details about the Super Sticker event, this is only set if the type is `superStickerEvent`."
 },
 "textMessageDetails": {
 "$ref": "LiveChatTextMessageDetails",
-"description": "Details about the text message, this is only set if the type is 'textMessageEvent'."
+"description": "Details about the text message, this is only set if the type is `textMessageEvent`."
 },
 "type": {
 "description": "The type of message, this will always be present, it determines the contents of the message as well as which fields will be present.",
@@ -9484,7 +9484,7 @@ false
 "type": "string"
 },
 "tier": {
-"description": "The tier in which the amount belongs. Lower amounts belong to lower tiers. The lowest tier is 1.",
+"description": "The tier in which the amount belongs. Lower amounts belong to lower tiers. The lowest tier is `1`.",
 "format": "uint32",
 "type": "integer"
 },
@@ -9516,7 +9516,7 @@ false
 "description": "Information about the Super Sticker."
 },
 "tier": {
-"description": "The tier in which the amount belongs. Lower amounts belong to lower tiers. The lowest tier is 1.",
+"description": "The tier in which the amount belongs. Lower amounts belong to lower tiers. The lowest tier is `1`.",
 "format": "uint32",
 "type": "integer"
 }
@@ -9537,7 +9537,7 @@ false
 "id": "LiveChatUserBannedMessageDetails",
 "properties": {
 "banDurationSeconds": {
-"description": "The duration of the ban. This property is only present if the banType is temporary.",
+"description": "The duration of the ban. This property is only present if the `banType` is `temporary`.",
 "format": "uint64",
 "type": "string"
 },
@@ -12430,7 +12430,7 @@ false
 "type": "boolean"
 },
 "failureReason": {
-"description": "This value explains why a video failed to upload. This property is only present if the uploadStatus property indicates that the upload failed.",
+"description": "This value explains why a video failed to upload. This property is only present if the `uploadStatus` property indicates that the upload failed.",
 "enum": [
 "conversion",
 "invalidFile",
@@ -12465,7 +12465,7 @@ false
 "type": "boolean"
 },
 "privacyStatus": {
-"description": "The video's privacy status.",
+"description": "The video's privacy status. In a `videos.insert` request, if you don't specify a value for this property, the uploaded video's privacy status defaults to `public`. Certain uploads might default to `private` based on creator account settings, as explained in the [YouTube Help Center](https://support.google.com/youtube/answer/157177). Videos uploaded from unverified API projects are not restricted to private viewing mode.",
 "enum": [
 "public",
 "unlisted",
@@ -12488,7 +12488,7 @@ false
 "type": "string"
 },
 "rejectionReason": {
-"description": "This value explains why YouTube rejected an uploaded video. This property is only present if the uploadStatus property indicates that the upload was rejected.",
+"description": "This value explains why YouTube rejected an uploaded video. This property is only present if the `uploadStatus` property indicates that the upload was rejected.",
 "enum": [
 "copyright",
 "inappropriate",